This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
oak:tutorials:connecting [2016/03/18 22:35] digistump |
oak:tutorials:connecting [2017/02/18 14:10] (current) NotNot Added Safari browser limitations |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| ====== Connecting a New Oak ====== | ====== Connecting a New Oak ====== | ||
| - | **IMPORTANT NOTE:** If you previously used a Beta release please first do a factory reset and ensure your Arduino Oak package is up to date at version 1.0.0: [[http://github.com/digistump/OakRestore|Details to perform a factory reset]] | + | **IMPORTANT NOTE:** If you previously used a Beta release please first do a factory reset and ensure your Arduino Oak package is up to date at version 1.0.0+: [[http://github.com/digistump/OakRestore|Details to perform a factory reset]] |
| + | **IMPORTANT NOTE:** Don't use Safari browser, Chrome works fine on Mac OS X. | ||
| ====== Powering your Oak ====== | ====== Powering your Oak ====== | ||
| - | You can power your Oak a variety of ways. The easiest is to connect a good quality micro-usb cable to the on-board USB port and connect that to a computer or powered USB hub/charger. The port and cable should be able to provide 500ma (burst/80ma continous), some older computers may not provide enough power. | + | You can power your Oak a variety of ways. The easiest is to connect a good quality micro-usb cable to the on-board USB port and connect that to a computer or powered USB hub/charger. The port and cable should be able to provide 500 mA (burst/80 mA continous), some older computers may not provide enough power. |
| - | You can also power your Oak from a REGULATED 3.3V DC power source capable of supplying at least 500ma of clean power - connect this to one of the two VCC and one of the three GND pins. | + | You can also power your Oak from a REGULATED 3.3 V DC power source capable of supplying at least 500 mA of clean power - connect this to one of the two VCC and one of the three GND pins. |
| - | You can also power your Oak from a 3.7-7V DC power source capable of supplying at least 500ma of clean power - connect this to one of the two VIN (NOT VCC) and one of the three GND pins. (A 1-cell lipoly battery may work as well). | + | You can also power your Oak from a 3.7-7 V DC power source capable of supplying at least 500ma of clean power - connect this to one of the two VIN (NOT VCC) and one of the three GND pins. (A 1-cell lipoly battery may work as well). |
| ====== First Power ====== | ====== First Power ====== | ||
| Line 19: | Line 20: | ||
| ====== Particle Account ====== | ====== Particle Account ====== | ||
| - | The Oak uses the Particle Cloud to receive code uploads when you program it from the Arduino IDE or the Particle IDE. When your Oak is set up it will add itself to your Particle account. You must have a Particle account to setup your Oak. If you do not have one already you can register for one as part of the next step. | + | The Oak uses the Particle Cloud to receive code uploads when you program it from the Arduino IDE or the Particle IDE. When your Oak is set up it will add itself to your [[https://www.particle.io/|Particle]] account. You must have a Particle account to setup your Oak. If you do not have one already you can register for one as part of the next step. |
| ====== WiFi Configuration ====== | ====== WiFi Configuration ====== | ||
| + | **TROUBLESHOOTING NOTE:** If the device you are using to configure the Oak has both an Ethernet and WiFi connection please disable or unplug the Ethernet connection before starting this setup. This will ensure it will not interfere with the setup procedure regardless of your network setup. | ||
| - | * Using a WiFi enabled computer or smart device, open a browser and go to: <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.) | + | Using a WiFi enabled computer or smart device, open a browser and go to: [[http://digistu.mp/oakconfig]] |
| - | * Follow the wizard and ensure you complete the steps in the order stated. | + | Please force your browser to refresh to ensure you are using the newest copy of this page. Follow the wizard and ensure you complete the steps in the order stated. |
| * Step 1: You will need to login with your credentials for [[https://www.particle.io/|Particle]] or register for a Particle account. | * Step 1: You will need to login with your credentials for [[https://www.particle.io/|Particle]] or register for a Particle account. | ||
| Line 32: | Line 34: | ||
| {{ :oak:tutorials:softap-config01.png?nolink&500 |}} | {{ :oak:tutorials:softap-config01.png?nolink&500 |}} | ||
| - | * Step 2: Connect your system to the Oak. The SSID is **ACORN-XXXXXX** where the Xs are part of the MAC address. | + | * Step 2: Connect your system to the Oak. The SSID is **ACORN-XXXXXX** where the Xs are part of the MAC address. Do not be concerned if your computer or device says that the Oak has a 'Limited connection' or 'No Internet', as this simply means that there is no internet access via the Oaks wireless, and is expected behaviour. |
| {{ :oak:tutorials:softap-config02.png?nolink&500 |}} | {{ :oak:tutorials:softap-config02.png?nolink&500 |}} | ||
| Line 45: | Line 47: | ||
| {{ :oak:tutorials:softap-config04.png?nolink&500 |}} | {{ :oak:tutorials:softap-config04.png?nolink&500 |}} | ||
| + | * Step 5: Connect back to your normal network. | ||
| - | * Step 5: If the update fails the wizard will instruct you to try again against our slower but more reliable update server, if it fails against that server twice you will then be provided with a link to the troubleshooting page. | + | {{ :oak:tutorials:softap-config05.png?nolink&500 |}} |
| + | |||
| + | * Step 6: If the update fails the wizard will instruct you to try again against our slower but more reliable update server, if it fails against that server twice it will then direct you to the first update troubleshooting page (Troubleshooting the first update: [[oak:tutorials:local_update|Oak first update troubleshooting]]). | ||
| OR | OR | ||
| - | * Step 5: If the update is a success the wizard will let you know this, and the Oak will begin to blink it bursts of 3 blinks. This mean the Oak is updated and in config mode ready for your first code upload. | + | * Step 6: If the update is a success the wizard will let you know this, and the Oak will begin to blink in bursts of 3 blinks. This mean the Oak is updated and in config mode ready for your first code upload. |
| - | * You can now proceed to setting up the Arduino IDE to use with your Oak: [[oak:tutorials:arduino|Getting started with the Arduino environment for the Oak]] | + | {{ :oak:tutorials:softap-config06.png?nolink&500 |}} |
| + | * If you visit the [[https://build.particle.io/|Particle]] page your Oak should show up. | ||
| + | |||
| + | {{ :oak:tutorials:particle-cloud.png?nolink&500 |}} | ||
| + | |||
| + | * You can now proceed to setting up the Arduino IDE to use with your Oak: [[oak:tutorials:arduino|Getting started with the Arduino environment for the Oak]] | ||