BrickPi Tutorials & Documentation

BrickPi Tutorials & Documentation

If you’re looking for the BrickPi3 instructions, go here.

BrickPi3 is our latest version of the BrickPi.  If you have recently purchased your BrickPi, it most likely is a BrickPi3.  If you are in doubt, check the following:

If you have an older version of the BrickPi, such as the BrickPi+, please click below to open.

Getting Started

If you’re looking for the BrickPi3 instructions, go here.

If you have an older version of the BrickPi, such as the BrickPi+, please click below to open.

BrickPi+ Documentation

Welcome to the BrickPi+ Getting Started guide!  We’ll walk you through getting it setup and started with these step-by-step instructions. We recommend you go through each step below, in the following order:

  1. Assemble the Case
  2. Set up the SD Card
  3. Power up
  4. Set up your BrickPi
  5. Build your robot: Attach LEGO MINDSTORMS (NXT/EV3) sensors, motors & TECHNIC parts
  6. Control the BrickPi
  7. Program your Robot
  8. Troubleshoot Common Issues With the BrickPi.

You can also watch the video tutorial on Youtube:



This section has information about programming the BrickPi.  At this point, we assume you’ve gotten your BrickPi setup, the case built, and you’re ready to program the BrickPi to tell some sensors and motors what to do! If not, please start with the Getting Started guide above.

Before moving forward, please be sure to enable BrickPi communications over serial.  We have a guide on how to do this with Raspbian for Robots here.


Programming Options

Choose one of the languages below:

General Points About Programming the BrickPi

  • All of our examples and drivers are on Github.  If you think your version is out of date, update with the latest version via Github. If you’re ahead of us, please send us a pull request! (If you don’t know what that means, don’t worry, you will eventually!)
  • The BrickPi uses serial communications from the Raspberry Pi to communicate with the BrickPi.  Again, unless you’re an advanced user, this isn’t very important to understand.  However, you should make sure that your serial is enabled on the Raspberry Pi (we have a guide here).
  • If you need help learning how to use Github, check out our tutorial on Github and the Raspberry Pi here.
  • BrickPi does not use USB.  We have some examples that control or use USB devices, but these are programmed and accessed through the Raspberry Pi.
  • Sensors and motors need to be initialized.  You can see how that’s done in our examples.

How the BrickPi Works

  • The Raspberry Pi (which is where you’re writing and executing these programs) sends orders to the BrickPi.  The BrickPi processes these orders, and sends commands to the motors and sensors, and sends back information to the Raspberry Pi.  (See the diagram below)