Skip to content
Switch branches/tags
This branch is 259 commits behind dhiltonp/hexbright:master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


This is the easiest way to get started with programming your hexbright.

Key Features

  • Automatic overheat protection (adjustable in hexbright.h OVERHEAT_TEMPERATURE)

  • Automatic low-battery detection (no spontaneous power-offs if too much power is drawn)

  • All hardware management is done internal to the library; you can focus on firmware features, not implementation.

  • Multiple debug modes to help diagnose problems (DEBUG in hexbright.h)

Video Instructions

Setting up your development environment (development environment setup, minus driver install).

How to share your code on github.

Writing a program.

Text Instructions

  1. Download and install arduino and the CP210x driver (Use a VCP Driver Kit from here).

    • For linux: Most kernels come with the driver pre-built (it's been in the kernel since 2005 or so). However, many repositories do not yet have arduino 1.0.1 or higher, which is (currently) required. The tarballs available at are very easy to work with; I've been able to just extract the files and run arduino. You will probably have to fiddle with user groups, which vary by distro.
  2. Download this folder/repository using one of the following methods, accessible at the top of the project page.

    1. Read-Only (no integrated sharing mechanism)
      • ZIP Extremely easy to get started, but you will need to manually update the library for new features.
      • git clone Command line, read-only access.
    2. Share your code
      • Fork Click fork to generate your own copy of the project (requires a free account on github).
        • Clone in Windows/Mac Great for first-time git users. Provides a graphical interface in
          addition to the command line interface with an easy install process.
        • git clone Command line, read-write access.
  3. Open the arduino ide, and click on 'File'->'Preferences' in the menu.

  4. Set your sketchbook location to the location of this folder (where this README file is found).

  5. Restart arduino.

  6. In arduino, click on 'Tools'->'Board'->'Hexbright' as your device type.

  7. With your hexbright unplugged, go to 'Tools'->'Serial Port' and look at the options.

  8. Now plug in your hexbright and go to 'Tools'->'Serial Port'. Select the new option. (On linux, there may be a delay of over a minute before the device appears.)

  9. Underneath the 'Sketch' and 'Tools' menu options, there is an up arrow (to open a program). Click on it, go to 'programs', and select a program.

    • I recommend tactical as your first program, as it is very straightforward.
    • All firmwares in the programs directory have a readme describing their operation. Arduino doesn't have an integrated method of viewing associated files, so you will need to open in the corresponding folder for notes on operation.
  10. Under 'Edit', there is a right arrow. Click it to upload the program.


I have translated most of the original sample programs to the library here:

Be aware that this library is a work in progress. In particular, the accelerometer api will change, and power consumption has not been optimized.



The easiest way to start programming your hexbright.






No releases published


No packages published