User Tools

Site Tools


oak:tutorials:arduino

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
oak:tutorials:arduino [2016/02/27 13:12]
emardee [!! YOU MUST ENSURE ARDUINO OAK PACKAGE IS UP TO DATE AT 0.9.4 BEFORE PROCEEDING !!]
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====== ======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]] ** Warning 0.9.4 has been rolled back to fix issues. ** 
-===== 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 ===== ===== Arduino IDE =====
  
-The Oak on Arduino uses the Arduino IDE 1.6.5 or higher.+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 64: Line 34:
     * 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.//" +  * 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 herehttps://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 deviceUnnamed Device (Device IDd9xxxxxxxxxxxxxxxxxxxxxx) 
 +</code> 
 + 
 +  * If you are done, select exitYou only have to do this once or when you want to change devices
  
   * The install is now complete!   * The install is now complete!
Line 72: Line 60:
 For troubleshooting tips see here: http://​digistump.com/​wiki/​oak/​tutorials/​troubleshooting 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 low during boot. +**Note:** You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin low during boot. 
  
 ==== Sources ==== ==== Sources ====
oak/tutorials/arduino.1456607534.txt.gz · Last modified: 2016/02/27 13:12 by emardee