Skip to content

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.

Installing the rpiboot tool#

In order to re-flash the boot disk on the pi (commonly called eMMC), you will need to install a utility called rpiboot.

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#

  1. 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)
  2. Disconnect the PiBox’s Carrier board from the Backplane.
  3. Switch the “Boot Mode” switch on the Carrier to rpiboot.
  4. Connect a USB-C cable to the USB-C port on the backplane, and to your PC.
  5. Run RPiBoot.exe (Windows) or sudo ./rpiboot (Mac / Linux). This will turn your Pi’s eMMC into a mass storage device, enabling your
  6. Open the Raspberry Pi Imager
    • Select an OS (we do most testing on Ubuntu 21.04, 64-bit).
    • Choose RPi-MSD- 0001 as your storage location.
    • Click Write.
  7. Flip the “Boot Mode” switch on the Carrier back to normal
  8. 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 rpiboot mode 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.

After these changes, you will need to sudo reboot.