Building
As of v0.1.4, we do not recommend building using the Wiring-based Arduino IDE. Although it is possible, you will only be able to compile a baseline build (no options). See below for how to build using options or deploying using a pre-compiled .hex file.
You will need to download PlatformIO for your platform. If you don't already have it, you will need Python to install PlatformIO.
If you would like to use a minor build (Ex: 4.1.x), then you will need to build it yourself. If you would like to build a major version (x.x.0), we have pre-built .hex files you can just burn to your Arduino. (This only applies to versions where the major version is greater than 0).
Make sure that both PlatformIO and Python are in your system %PATH%. We have included a Visual Studio project file. Simply open the file and build the project.
Still working on it...
First make sure you have installed PlatformIO and Python 2.7. Run ~/build.sh in the root of the project directory. The script will walk you through the build process and give you suggestions for a baseline build. You may need to chmod the file first.
If you need help, see the documentation or talk to us on our Gitter channel.
Follow these instructions once you flash over the Octoduino bootloader in the step above.
Now take your SD/microSD card and format it to FAT32. Then copy everything IN the ~/boot folder to the card. Now you may add your own code files in the root of the SD card (see the documentation on how to name your files). Due to a limitation of the SDFAT library, your file names must conform to the 8.3 standard. This means that the name of the file may only be 8 characters long, and the extension may only be 3 characters long.
Lastly, create a file at the root of the card called lang.oct and inside of it, put pb. This tells Octoduino to use the ParseBasic interpreter (the only one available right now).
Now you get to run your program. Insert your SD card into your shield, then attach it to your Arduino. Make sure you have a serial console open and it is set to your Arduinos COM/tty port. Apply power and you should see your program execute. If you hit a bug, be sure to file an issue on GitHub with your system details.
