Differences

This shows you the differences between two versions of the page.

--- oak:tutorials:arduino [2016/02/26 03:20]
emardee Note about 0.9.4 release.
+++ oak:tutorials:arduino [2016/07/19 18:12]
pfeerick Removed r2 reference in 1.6.5 Arduino IDE recommendation as no longer readily available
@@ Line 1: / Line 1: @@
 ======Connecting and Programming Your Oak======
-========**BETA WARNING**=========
-The Oak firmware is currently an early Beta release. At this time we ask you to only install it if you are confident in your ability to recover a Bricked unit or be very careful not to Brick your unit. We suggest you only install the firmware if you have a serial programmer on hand that is 3.3V capable, so that you can recover a bricked unit (https://github.com/digistump/OakRestore). **This warning is very temporary, as we continue to test and get feedback from the first group of users - we expect to have a full first release and remove this warning approx Feb 18th**
-Thank you all for your continued patience!
+====== Installation Instructions: ======
 ----
-====== Installation Instructions: ======
-======= If you previously used an earlier Beta please do a factory reset. =======
-[[http://github.com/digistump/OakRestore|Details to perform a factory reset]]
-=======!! YOU MUST ENSURE ARDUINO OAK PACKAGE IS UP TO DATE AT 0.9.4 BEFORE PROCEEDING !!========
-[[https://github.com/digistump/OakCore/releases/tag/0.9.4|Details of latest beta 0.9.4 available here]]
-===== SoftAP =====
-  * Setup your Oak and allow it to download the system firmware using the SoftAP Config App:<code>http://rawgit.com/digistump/OakSoftAP/master/config.html</code> Please force your browser to refresh to ensure you are using the newest copy of this page.
-  * Follow the wizard which is guiding you through the whole process. You need your credentials for [[https://www.particle.io/|Particle]] or create an account.
-{{ :oak:tutorials:softap-config01.png?nolink&500 |}}
-  * Connect your system to the Oak. The SSID is **ACORN-XXXXXX** where the Xs are part of the MAC address.
-{{ :oak:tutorials:softap-config02.png?nolink&500 |}}
-  * Choose your network to let the Oak connect to the internet.
-{{ :oak:tutorials:softap-config03.png?nolink&500 |}}
-  * Let your Oak perform the update.
-{{ :oak:tutorials:softap-config04.png?nolink&500 |}}
+===== First Time Usage: =====
+If you are using a new Oak that has never received its initial update you must complete this tutorial first: [[oak:tutorials:connecting|Connecting your Oak for the first time]]
 ===== Arduino IDE =====
 The Oak on Arduino uses the Arduino IDE 1.6.5 or higher.
+(1.6.5 is strongly recommended as 1.6.6 and 1.6.7 have some bugs that can cause install issues with third party boards like the Oak)
@@ Line 65: / Line 34: @@
     * With the install complete, close the "**Boards Manager**" window and select the **Oak by Digistump** from the **Tools**->**Boards** menu.
-  *  The first time you upload a sketch to the Oak you will see an error message like this "//Config file not found at: /path/to/config.json - please run the oak tool from the command line with no arguments to configure.//"
+  * You now must set up your Particle Cloud login so you can upload to your device. Download the OakCLI tool from here:
-    * Download and run the OakCLI tool from here: https://github.com/digistump/OakCLI and run it (from any directory), enter your [[https://www.particle.io/|Particle]] login data and select your device, then re-run the upload. You only have to do this once.
+     * Windows: https://github.com/digistump/OakCLI/releases/download/1.0.2/oakcli-1.0.2-win32.zip
-  * **BE SURE TO READ** the release notes here: https://github.com/digistump/OakCore/releases for important tips on how to use and not to use the early beta release.
+     * Mac OSX: https://github.com/digistump/OakCLI/releases/download/1.0.2/oakcli-1.0.2-osx.tar.gz
+     * Linux 32bit: https://github.com/digistump/OakCLI/releases/download/1.0.2/oakcli-1.0.2-linux32.tar.gz
+     * Linux 64bit: https://github.com/digistump/OakCLI/releases/download/1.0.2/oakcli-1.0.2-linux64.tar.gz
+  * Run the OakCLI (eg. ''./oak'') tool you just downloaded (from any directory), enter your [[https://www.particle.io/|Particle]] login data and select your device.
+<code>
+[1] Unnamed Device (Device ID: d9xxxxxxxxxxxxxxxxxxxxxx)
+[2] ------------------------
+[3] Switch Particle Accounts
+[0] Exit
+Which device would you like to use? [1, 2, 3, 0] : 1
+Configuration saved at /home/user/.oak/config.json
+You can now upload files to this device.
+Currently selected device: Unnamed Device (Device ID: d9xxxxxxxxxxxxxxxxxxxxxx)
+</code>
+  * If you are done, select exit. You only have to do this once or when you want to change devices.
   * The install is now complete!
@@ Line 73: / Line 60: @@
 For troubleshooting tips see here: http://digistump.com/wiki/oak/tutorials/troubleshooting
-**Note:** You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin 0 low during boot.
+**Note:** You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin 1 low during boot.
 ==== Sources ====

Digistump Wiki

User Tools

Site Tools

Differences

Page Tools