Flashing your PiBox#
The PiBox is built around the Raspberry Pi 4 Compute Module. The Compute Module has two options for boot storage: SD card or onboard flash (eMMC). You can use this guide to flash your Pi’s eMMC.
Note: Unless you ordered your PiBox with no Compute Module (advanced users), then you received a PiBox with eMMC, and will need to use this guide to re-flash it. We only ship modules with onboard flash due to its substantially faster performance.
In order to re-flash the boot disk on the pi (commonly called eMMC), you will need to install a utility called
- For Windows users, simply install the
- For Mac & Linux users, follow the build instructions and return to this page.
Installing the Raspberry Pi Imager#
Raspberry Pi maintains an excellent utility for flashing devices on every OS. Download and install it here: https://www.raspberrypi.org/software/
Flashing the Image#
- Open the PiBox using the two screws on the back. The top clamshell case slides back and lifts up to reveal the Carrier board (large horizontal PCB) and the Backplane (small vertical PCB in front)
- Disconnect the PiBox’s Carrier board from the Backplane.
- Switch the “Boot Mode” switch on the Carrier to
- Connect a USB-C cable to the USB-C port on the backplane, and to your PC.
sudo ./rpiboot(Mac / Linux). This will turn your Pi’s eMMC into a mass storage device, enabling your
- Open the Raspberry Pi Imager
- Select an OS (we do most testing on Ubuntu 21.04, 64-bit).
RPi-MSD- 0001as your storage location.
- Flip the “Boot Mode” switch on the Carrier back to
- Unplug the carrier from your PC and re-assemble the PiBox.
Warning: The USB port and / or cable you use are using may affect the ability to boot into
rpibootmode successfully. If rpiboot stalls or you seen an error code like
Failed to write correct length, returned -9, then try plugging into a different port on your PC, or swapping out the cable you are using.
Enabling USB, SATA, and Display support#
If you aren’t using one of our pre-built images, you will need to make some modifications to your installation to get full use out of the PiBox hardware.
To enable the USB 2.0 ports on the Compute Module 4, you need to edit the boot config file at
Enabling the SATA ports requires compiling the SATA modules into the kernel. Instructions for this can be found on Jeff Geerling’s PCI device guide on GitHub
To enable the 1.3-inch display, the SPI interface needs to be turned on. Edit the boot config file at
You can then use a Python library or install the kernel module in order to draw images to the display. Adafruit has a guide which is compatible with the display used in PiBox. https://learn.adafruit.com/adafruit-mini-pitft-135x240-color-tft-add-on-for-raspberry-pi/1-3-240x240-kernel-module-install
After these changes, you will need to