Welcome to your brand-new Arduboy!
This guide will introduce you to the features of the Arduboy and get you started with software you need to upload new games and develop your own software.
There are two versions of the Arduboy:
- The "production" Arduboy which was developed as result of a Kickstarter campaign. This is sometimes referred to as the Arduboy 1.0
- The Developer Kit or DevKit which is an earlier prototype. This was also available as a Kickstarter reward and also previously sold on Tindie.
This guide is applicable to both versions.
The tiny square black chip in the bottom right corner of the production Arduboy, or near the center of the DevKit, is called a microcontroller and it is the brains of the device. This tiny 8-bit computer contains all of the instructions, graphics, and sound to produce the game played on the device. We can reprogram the Arduboy, and change the game on it, using a micro-USB cable and some software called Arduino.
Step 1: Download and Install Arduino Software
Click here to go to the Arduino Download Page
Use the links on the Arduino website to download the install file. Run the installer executable and follow the instructions to install the Arduino software onto your computer.
The Arduino IDE is an Integrated Development Environment (IDE). This means that you can create software for Arduino compatible devices within one piece of software. The same program that you use to edit the code will be used for compiling (turning source code into machine language) and uploading to the device.
We are working on some future solutions that will allow you to upload software without Arduino. Stay Tuned!
Step 2: Install the Arduboy Libraries and Board Support
Install the Arduboy, Arduboy2 and other libraries
The Arduboy and Arduboy2 libraries are used by most sketches to access the features and functions of the Arduboy. Also, other Arduino libraries intended for the Arduboy have been written to provide additional features.
Arduboy, Arduboy2 and many other libraries are easy to install using the Arduino IDE's Library Manager. To add the these libraries to the Arduino IDE, from the Arduino IDE's menu bar select the
Library Manager found under the
Sketch > Include Library > Manage Libraries...
This will open the Library Manager. Search for Arduboy related libraries by entering arduboy in the Filter your search... field. After selecting the Arduboy, Arduboy2 or other library from the list press Install.
It's best to install all the Arduboy related libraries, to make them available to sketches that need to use them. Otherwise, you may get errors and be unable to upload a sketch that relies on a particular library having been installed.
Arduboy specific libraries include:
More information on installing and managing Arduino Libraries can be found here.
Note for sketch developers: The Arduboy library is no longer being developed. It is recommended that new sketches use the Arduboy2 library.
Install Support for the Arduboy and DevKit (optional)
By installing support for the Arduboy and DevKit in the IDE you will be able to select Arduboy or Arduboy DevKit as the device (board) that you are using.
If you have a production Arduboy, this step is optional. You can just select the built in device Arduino Leonardo, but it's probably easier to remember Arduboy than Arduino Leonardo.
If you have a DevKit, it is recommended that you install this support. Otherwise, you will have to edit some lines in the Arduboy library which you previously installed, in order to make many of the programs work properly.
Here's how to add the boards:
- In the Arduino IDE select
File > Preferences. In the Settings tab there will be a field titled Additional Boards Manager URLs:
Put the following text in this field:
If the field already has had other URL(s) added, you can click on the edit icon at the end of the field to allow you to add the new URL on a separate line.
In the search field at the top right of the Boards Manager window, enter arduboy.
Click on the box containing: Arduboy by Arduboy Team
and then click on the Install button that appears at the bottom right of the box.
The word INSTALLED should appear in the box.
Step 3: Try Opening and Uploading an Example Sketch
In the Arduino IDE, a game or other program is called a sketch. A sketch is opened in the IDE and then uploaded into your Arduboy so you can run it. It's a good idea to use one of the example sketches included with the Arduboy library as the first sketch that you upload, in order to verify that you have followed the previous steps correctly and everything is working.
The example sketches will have been tested to work with the currently installed Arduboy library, so will eliminate one possible source of problems.
Open an Example Sketch
Select from the IDE menus:
File > Examples > Arduboy2
and click on one of the examples offered.
This should open the chosen sketch in a new IDE window.
Connect your Arduboy and Set the Board Type and Port
Note: In order for a production Arduboy to be seen as a USB device on your computer, to allow uploading a sketch, the power switch must be on. For a DevKit, the power switch should be off.
The first time you plug the Arduboy into your Windows computer after installing the Arduino software you will be notified that a new USB device was detected. The Arduboy will appear to your computer as an Arduino Leonardo.
Set the type of Arduboy that you have by selecting from the IDE menus:
Tools > Board:
From the offered devices, choose Arduboy (or Arduino Leonardo if you didn't install the board support in Step 2 above) if you have a production Arduboy.
If you have a DevKit, choose Arduboy DevKit.
Set the port that your Arduboy is connected to by selecting from the IDE menus:
Tools > Port
The correct port to choose will likely be identified as an Arduino Leonardo. This is fine. The Arduboy uses the Arduino Leonardo bootloader so is detected as such.
The board type and port that is currently selected can be seen on the status bar at the bottom of the IDE window. Always check that they are correct before uploading a sketch to your Arduboy.
Upload the sketch
To upload the opened sketch to your Arduboy, select from the IDE menus:
Sketch > Upload
or just click on the Upload button near the top left of the IDE.
If all goes well, the sketch will compile without errors and then be uploaded to your Arduboy. After the upload completes, the sketch will run immediately. Hurray!
Just a note: If at any time you wish to check if the opened sketch will compile properly but not have it uploaded to your Arduboy (even if the Arduboy isn't connected), you can click on the Verify button or select from the IDE menus:
Sketch > Verify/Compile
Another note: Once you become familiar with using the Arduino IDE, you may wish to use keyboard shortcuts to perform many operations, instead of using menu selections or mouse clicks. If a shortcut is available, it will be shown at the right of the menu item for the operation that it will perform.
Step 4: Install more Games and other Sketches and Start to Play!
Click Here to View the "Official" Game List
Click Here to Visit the Games Category
Adding games and other sketches to the IDE isn't very difficult, once you get the hang of it.
Use the detailed guide on how to install sketches, which can be viewed by clicking here.
Installed sketches that aren't library examples can be opened by selecting from the IDE menus:
File > Sketchbook
You can also open any installed sketch by clicking on the Open button near the top left of the IDE.
We are currently working on a web interface for a more simple one-click upload. The goal is for users to navigate to arduboy.com and be able to immediately play new games. An offline hex uploader is also in development.
Browse around in the community for games other users have posted! The best thing about the Arduboy community is the ability to communicate directly with the developers! Join in on the fun!
If at some point your Arduboy appears to be dead, or you're having trouble uploading a new sketch to it, don't panic . You may just have to use flashlight mode or follow a reset procedure.
Click here for instructions on using flashlight mode
Click here for production Arduboy reset instructions
Click here for DevKit reset instructions
If you run into problems at this stage there are guides elsewhere on the community site that can help out.
Click Here to Visit Team A.R.G.
Team A.R.G. is a game development studio that already has created some awesome content for the Arduboy. The game that came preinstalled on the Kickstarter production Arduboys is by Team A.R.G. And, we are partnering together to deliver more soon!
And there you have it! You're ready! If you are just learning about Arduino for the first time this link is probably as good a place as any to get started. Get curious! Start Google searching and watching other peoples tutorials! Participate in this forum! Before long you will be posting content of your own! Start to Play!
Discuss this topic
If you would like to talk about this Guide, you can do so in your own topic OR go to this one: