Differences

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

--- oak:tutorials:arduino [2016/02/13 15:29]
kh Updated safe/config mode pin number to zero to match the code change in commit eec7414
+++ oak:tutorials:arduino [2016/07/19 18:12] (current)
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: ======
 ----
-=====Software:=====
+===== First Time Usage: =====
-The Oak on Arduino uses the Arduino IDE 1.6.5 or higher.
+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]]
-====== Installation Instructions: ======
+===== 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)
-======= If you previously used an earlier Beta please do a factory reset here: http://github.com/digistump/OakRestore =======
-========**YOU MUST ENSURE ARDUINO OAK PACKAGE IS UP TO DATE AT 0.9.3 BEFORE PROCEEDING**=========
-  * **Setup your Oak and allow it to download the system firmware using the SoftAP Config App:** http://rawgit.com/digistump/OakSoftAP/master/config.html **Please force your browser to refresh to ensure you are using the newest copy of this**
+  *  Download the appropriate Arduino package at the Arduino.cc website: https://www.arduino.cc/en/Main/Software
-  *  **Download the appropriate Arduino package at the Arduino.cc website: https://www.arduino.cc/en/Main/Software**
+  *  Install or unzip the Arduino application.
-  *  **Install or Unzip the Arduino application.**
+  *  In the Arduino application go to the "**File**" menu and select "**Preferences**".
-  *  **In the Arduino application go to the "File" menu and select "Preferences"**
 {{ :digispark:tutorials:preferences.gif?nolink |}}
-  *  **In the box labeled "Additional Boards Manager URLs" enter:** <code>http://digistump.com/package_digistump_index.json</code>
+  *  In the box labeled "**Additional Boards Manager URLs**" enter: <code>http://digistump.com/package_digistump_index.json</code> and click OK.
-**and click OK**
-Note: If you already have additional URLs entered in that box, then click the button on the right of the box and enter this URL on a new line.
+**Note**: If you already have additional URLs entered in that box, then click the button on the right of the box and enter this URL on a new line.
 {{ :digispark:tutorials:entry.jpg?nolink |}}
-  *  **Go to the "Tools" menu and then the "Board" submenu - select "Boards Manager" and then from the type drop down select "Contributed":**
+  *  Go to the "**Tools**" menu, then to the "**Board**" submenu, and select "**Boards Manager**". Choose "**Contributed**" from the drop down select.
-  * **Select the "Oak by Digistump" package and click the "Install" button.**
+  * Select the "**Oak by Digistump**" package and click the "Install" button.
-    *  **You'll see the download progress on the bottom bar of the "Boards Manager" window, when complete it will show "Installed" next to that item on the list.**
+    *  You'll see the download progress on the bottom bar of the "**Boards Manager**" window, when complete it will show "**Installed**" next to that item on the list.
-    * **With the install complete, close the "Boards Manager" window and select the Oak by Digistump from the Tools->Boards menu. **
+    * 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." Download and run the OakCLI tool from here: https://github.com/digistump/OakCLI and run it (from any directory), enter your Particle login and select your device, then re-run the upload. You only have to do this once.**
+  * You now must set up your Particle Cloud login so you can upload to your device. Download the OakCLI tool from here:
-  * 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.
+     * Windows: https://github.com/digistump/OakCLI/releases/download/1.0.2/oakcli-1.0.2-win32.zip
+     * 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.
-  *  **The install is now complete!**
+<code>
+[1] Unnamed Device (Device ID: d9xxxxxxxxxxxxxxxxxxxxxx)
+[2] ------------------------
+[3] Switch Particle Accounts
+[0] Exit
-For troubleshooting tips see here: http://digistump.com/wiki/oak/tutorials/troubleshooting
+Which device would you like to use? [1, 2, 3, 0] : 1
-**NOTE:** You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin 0 low during boot.
+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>
-==== Sources ====
+  * If you are done, select exit. You only have to do this once or when you want to change devices.
-**Oak Arduino Core: ** https://github.com/digistump/OakCore
+  * The install is now complete!
-**Oak System/Config Firmware: ** https://github.com/digistump/OakSystem
+For troubleshooting tips see here: http://digistump.com/wiki/oak/tutorials/troubleshooting
-**Oak Fallback Updater Firmware: ** https://github.com/digistump/OakSystem
+**Note:** You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin 1 low during boot.
-**Oak SoftAP Config App: ** https://github.com/digistump/OakSoftAP
+==== Sources ====
-**Oak CLI Tool: ** https://github.com/digistump/OakOTA
+  * **Oak Arduino Core: ** https://github.com/digistump/OakCore
+  * **Oak System/Config Firmware: ** https://github.com/digistump/OakSystem
+  * **Oak Fallback Updater Firmware: ** https://github.com/digistump/OakSystem
+  * **Oak SoftAP Config App: ** https://github.com/digistump/OakSoftAP
+  * **Oak CLI Tool: ** https://github.com/digistump/OakOTA
 =====Your first upload:=====

Digistump Wiki

User Tools

Site Tools

Differences

Page Tools