Blinks Developers

Logo

Resources for Blinks developers

Quickstart Guide

Functionality Guide

API Reference

Glossary

Games Primer

Blinks Quick Start Guide

What’s Included

Needed Software

*If you want to have the latest and contribute to the development of Blinks, here’s our Github Repo

After you have installed the Arduino IDE (> 1.8.5) and launched the application, you will notice that Arduino has created a folder in your Documents folder, aptly named, Arduino. Follow these next 5 steps to have the Blinks library installed:

  1. Create a folder called hardware inside of the Arduino folder ~/Documents/Arduino/hardware (it will be next to ‘libraries’, not nested inside) and one more called Move38-Blinks-Library inside of the hardware folder you just created. ~/Documents/Arduino/hardware/Move38-Blinks-Library
  2. Download the Blinks Library if you haven’t already done so
  3. Unzip the Blinks Library into a folder called avr
  4. Move the Blinks Library into the Move38-Blinks-Library folder (the path will be ~/Documents/Arduino/hardware/Move38-Blinks-Library/avr/)
  5. Restart Arduino (quit and relaunch)

If you click on Tools in your menu bar, and navigate down to Board: you should now see Move38: Blinks Tile at the bottom. Select it.

Next, click on Tools in your menu bar, and navigate down to Programmer: select the programmer USBTinyISP or see below for faster upload time with Blinks Programmer

Now if you go to File/Examples, you should see Examples for Blinks Tiles at the bottom of that list as well. Open the first one up and see if it compiles.

Image of Transferring Blink Code

  1. Connect the USB programmer
  2. Place the magnetic programming jig on top of the Blink
  3. Press Upload to transfer

Not successfully transferring to your Blinks? try these troubleshooting tips from the forum

Windows Troubleshooting

No programmer detected? Check to make sure you have the correct driver installed, relaunch the Ardunio IDE and then you should be able to select USBTinyISP from the Tools > Programmer drop-down in Arduino.

For the extra curious, here is the source code for that driver.

*Faster Upload Time

  1. Download this file (right click and save link as)
  2. Move file to /Applications/Arduino.app/Contents/Java/hardware/arduino/avr (it will replace the existing file here)
  3. Restart Arduino if it was open
  4. Now select the Blinks Programmer when programming and it should be roughly 4x faster upload speeds ⚡

Not seeing Blinks Programmer? Try out these steps, found by Alpha Blinks Dev, Ken 🙂

The Service Port is by no means necessary, but is a phenomenal tool for debugging code and refining early sketches into robust games. The following steps show you how to use your Blinks Service Port.

  1. Put together the components of your Blinks Service port so they look like this
  2. USB Cable → FTDI → Blinks Serial Adapter → Molex Cable → Blink (w/ Serial port)
  3. Open Arduino
  4. click on Tools in your menu bar, and navigate down to Port: you should now see COM3 on a PC and /dev/cu... on a Mac. Select it.
  5. press the magnifying glass in the top right corner of the Arduino IDE to open the Serial Monitor

Note: The serial port is at a fixed 500k baud rate (set it in the drop-down).

To write to the Serial port from a sketch,

  1. Add “#include Serial.h”
  2. Instantiate a ServicePortSerial class, like this ServicePortSerial sp
  3. Call the begin method within setup(), like this sp.begin()

Here is the simplest of ServicePort sketches:

Unboxing And Walkthrough Video

And last but not least, here’s a handy little unboxing video that will walk you through some basics!