User Tools

Site Tools


This is an old revision of the document!

Connecting and Programming Your Oak


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 ( This warning is very temporary, as we continue to test and get feedback from the first group of users - we fully expect to remove this warning within 1-2 days

Thank you all for your continued patience!


The Oak on Arduino uses the Arduino IDE 1.6.5 or higher.

Installation Instructions:


  • In the box labeled “Additional Boards Manager URLs” enter:

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.

  • Go to the “Tools” menu and then the “Board” submenu - select “Boards Manager” and then from the type drop down select “Contributed”:
  • Select the “Digistump Oak and Acorn” 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.
  • 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: 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.
  • BE SURE TO READ the release notes here: for important tips on how to use and not to use the early beta release.
  • The install is now complete!

NOTE: You can force the Oak into safe mode to receive uploads even if something is failing by holding Pin 10 low during boot.


Your first upload:

If you're just getting started try the above procedure with the example you can find by going to File→Examples→Oak→Start

Here is the code it will load:

// the setup routine runs once when you press reset:
void setup() {                
  // initialize the digital pin as an output.
  pinMode(1, OUTPUT); //LED on Model A   

// the loop routine runs over and over again forever:
void loop() {
  digitalWrite(1, HIGH);   // turn the LED on (HIGH is the voltage level)
  Particle.delay(1000);               // wait for a second
  digitalWrite(1, LOW);    // turn the LED off by making the voltage LOW
  Particle.delay(1000);               // wait for a second

This code will blink the BUILTIN LED on Pin 1.

When you click upload it will be sent to the Particle Cloud, you will then see the LED on your Oak blink rapidly as it is uploaded to the device. As soon as it has uploaded you should see the LED start to blink!

Support requests are best posted to the forum, so everyone can benefit and we can help each other through any issues -

oak/tutorials/arduino.1454048141.txt.gz · Last modified: 2016/01/28 22:15 by digistump