Raspberry Pi - Getting Started

This page includes information on how to get started with your Raspberry Pi. It is perfect for getting going with our XK03 Raspberry Pi Kit.


  1. General information
  2. Libraries
  3. Projects and sample code

1. General Information

The Raspberry Pi natively provides 3.3 volt to xChips connected via our BR01 bridge, along with I2C and UART. The RPi interface also allows connectivity to the SPI/JTAG/SWD portion of the xPDI connection, but not the USB portion.

The bridge or interface installation on the Raspberry Pi can be verified with:
i2cdetect -y 0 # Rev 1
i2cdetect -y 1 # Rev 2

I2C Interface:

  • sudo raspi-config → activate I2C
  • i2cdetect -r -y 1

UART Interface:

  • Configured as DTE (default)
  • sudo apt install minicom
  • Add dtoverlay=pi3-disable-bt to /boot/config.txt
  • Disable bluetooth: sudo systemctl disable hciuart
  • sudo raspi-config → disable console → enable hardware serial
  • sudo minicom -b 115200 -o -D /dev/ttyAMA0

The Raspberry Pi Zero and Zero Wireless can be powered from the BR03 interface allowing the various Power xChips (Pxxx) to be used to power the circuit. Some xChips also have alternative power input, such as the OC05 - Servo Driver, which allows a battery used in traditional servo setups to be used not only to drive the servo, but the whole circuit including the RPi Zero.

BR01 installed on standard Raspberry Pi
IR01 installed on standard Raspberry Pi
BR03 installed on Raspberry Pi Zero
Please see our Getting Started blog for additional detailed instructions. 


2. Libraries


3. Projects and sample code

  • Build a weather station in less than 5 minutes (see Raspberry Pi Weather Station to get you started)
    • first using only your RasPi, BR01SW01 and a single XC10 connector. Adding an MD01 Spacer xChip allows you to move the sensor further away from the RasPi CPU, and the heat that generates. The SW01 measures temperature, humidity and pressure, from which altitude, cloud base can also be estimated.
    • next, you can add the OD01 mini-OLED display to show the Bosch sensor's output on the device
    • and then the SH01 as a mini keyboard, and you have yourself a unit with input and output not exceeding the size of the RasPi. You could log temperature data to the cloud on the press of a button, or change the displayed data using the same mini-keyboard
  • Add xChip SG33 to your weather station to get sophisticated air quality readings, which could be used to control ventilation, heating and emergency warnings.
  • Revisit your childhood and play the classic Space Invaders game on your Pi mini OLED display, together with the mini keyboard
  • Create an amazing Servo Controlled Time-Lapse Camera which records images on your untethered device for later retrieval - we've used this in amazing balloon missions!
  • Show live video from your Pi camera on our mini-OLED display - here's the project to follow
  • Control apps on your Pi using hand gestures. The SL06 Gesture Sensor recognises hand gestures including up/down and left/right swipes, as well as your hand's proximity, allowing you to create a control interface for your Pi software.
  • Create an M&Ms sorter, using the SL06 Gesture sensor to identify M&M color, and the servo to steer M&Ms into colour coded piles
  • Make a tracker with the SI02 to show how smooth your driving is! The mini OLED can also display live data on how much you accelerate, brake and take sharp turns
  • Or make a mobile tracker to measure how much G-force and shocks you take on your bike at the weekend. How fast can you accelerate (or brake)?

Short videos of the projects above: 

(The full projects on how to program the above examples are available on Hackster)