Skip to content

Bricktronics Downloads

Software :: Hardware

Software Downloads


Quit the Arduino application.

Uncompress the file containing the library. There should be a directory called Bricktronics, and inside that directory should be a bunch of files and directories, including this one,

Copy the Bricktronics folder.

Find your sketchbook directory. On Windows, this is usually My Documents\Arduino. On Mac, it is usually Documents/Arduino. On Linux, it is usually ~/Arduino.

If there isn’t a libraries directory in your sketchbook directory, create one.
Paste the Bricktronics library inside the libraries directory in your sketchbook.

After all of this, you should be able to open your sketchbook directory, open your libraries directory, open your Bricktronics directory, and see a few directories and files, including this one,

Restart the Arduino application. The Bricktronics library should appear in the Sketch->Import Library menu, and there should be Bricktronics examples in File->Examples->Bricktronics.


v1.0: Initial release.


The Adafruit MCP23017 is BSD licensed. The Bricktronics library itself is GPL, except for the ColorSensor part, which is MPL 1.0.

If you need alternative licensing, let us know.

The Bricktronics library is open source software, and you’re free to use it without Bricktronics products–but purchasing our products is the best way to make sure we’re able to spend time making more open source software and hardware in the future. The second best way is to tell all your friends how much you like our stuff!


There were a lot of other libraries used in the creation of the Bricktronics library. Special thanks to Adafruit, William Grieman, jrraines, the leJOS team, LEGO team!

Adafruit MCP23017 Library

The Bricktronics library contains the Adafruit MCP23017 library. It’s used to control the MCP23017 port expander used for slower IO.

Adafruit invests time and resources providing this open source code, please support Adafruit and open-source hardware by purchasing products from Adafruit!

Written by Limor Fried/Ladyada for Adafruit Industries. BSD license, check license.txt for more information All text above must be included in any redistribution.

SoftI2cMaster Library

The LEGO Ultrasonic sensor has some quirks that we need to work around in firmware. We need repeated start/restart support, and we need to tweak the clock bit after a read. We modified the SoftI2CLibrary by William Greiman to do this.


We used the leJOS firmware, and looked at the source for the NXT firmware to get the Color Sensor working with Arduino.


We need a little faster performance than digitalWrite for the Color Sensor. Normally we’d just twiddle PORT and DDR directly, but as we’re playing around with alternative Arduino architectures like the ChipKit, we decided to try out a set of macros (digitalWriteFast) that are almost as fast as twiddling the PORT registers directly. jrraines implemented these for Arduino, based on some work by Paul Stoffregen.

Hardware Downloads

The Bricktronics kits were developed with Kicad, an open source electronic design suite. It is available for Windows, Linux, and OS X.

Licensing – We consider the Bricktronics kits to be open source hardware. All files are licensed Creative Commons Attribution-Share Alike 3.0, except the firmware which is licensed under the GNU Public License (GPL).

For the Creative Commons files, this means you may copy, distribute, and display them (and any modifications or “derivative works” you make) if you give credit to Wayne and Layne, LLC, link back to this website, and you must also license any modifications or derivative works under this exact same Creative Commons Attribution-Share Alike 3.0 License.

There are similar rights granted by the GPL, but attribution is not required. It’s appreciated, though!

This software is licensed under the CC-GNU GPL version 2.0 or later
Creative Commons BY-SA 3.0
Bricktronics Shield by Wayne and Layne, LLC, is licensed under a Creative Commons Attribution-Share Alike 3.0 License.

Different licensing may be available. Contact us for more information.

Note: Wayne and Layne, LLC and our products are not connected to or endorsed by the LEGO Group. LEGO, Mindstorms, and NXT are trademarks of the LEGO Group.