Learning to Program the Arduboy
This guide will teach you how to setup your computer to upload software and games to your Arduboy.
The tiny square black chip in the bottom right corner of the Arduboy is called a microcontroller and it is the brains of the device.
We can reprogram the Arduboy, and change the game on it, using a micro-USB cable and some software called Arduino.
Before we can reprogram the Arduboy we need to setup a few things first. We will download some libraries that are necessary to compile code for the Arduboy.
In order for the chip to work with the OLED Display, buttons and speaker we need to download some libraries.
Use Arduino’s menu to select the Library Manager:
Sketch > Include Library > Manage Libraries…
There are a few libraries that are helpful to download to get started, the easiest way to find them is to search for “Arduboy”.
Here is a list of libraries we recommend installing:
More information on installing and managing Arduino Libraries can be found on the Arduino website
The primary development library for the Arduboy is the “Arduboy2” library (the original library was superseded by community development). Click here for documentation on the Arduboy 2 library.
We are almost ready to try and try to upload some code to the Arduboy! We now need to select the correct Board and Port.
- Plug the Micro-USB cable into the Arduboy and connect it to your PC.
- Turn on the Arduboy using the power switch at the top.
- Select the Arduino Leonardo board type (Arduboy is based on the Leonardo)
Tools > Board > Arduino Leonardo
- Select the correct Port number
- The Port number can be different for each computer
- Take note of which Port becomes available when you turn on the Arduboy
Tools > Port > COM# (Arduino Leonardo)
Optional: Load custom board files
- Select File > Preferences.
- Settings Tab > Additional Boards Manager URLs:
- Click on OK to save the preferences.
- Select Tools > Board: > Boards Manager..
- Enter “arduboy” in the search feild.
- Click on the box containing: Arduboy by Arduboy Team
- Click on the Install button that appears at the bottom right of the box.
- There should now be items Arduboy and Arduboy DevKit available for selection in the menu that you get using Tools > Board:
Ok! Let’s select an example sketch to upload from the Arduboy2 library. Most libraries include a few examples sketches that demonstrate the functions you are able to perform with it.
- You may have to scroll down pretty far past the default libraries.
File > Examples > Arduboy2 > Hello World
Upload the sketch using the upload button
Arduino will attempt to compile the code and transfer it to the Arduboy over the USB cable.
How did it go?
Let us know if you had success with uploading the code or if you’ve hit some speed bumps and need assistance.
Not so great… It didn’t work for me.
I followed the instructions carefully but I’m getting an error message or some of the menu items are not available.
Awesome! I’m ready to start coding!
I was able to successfully upload the example code. Now I would like to learn to write some of my own code!
Great! I’m ready to download some games!
I was able to install Arduino and Libraries, connect the Arduboy and successfully uploaded the example code.