Legacy firmware. This guide covers the original HealthyPi 5 firmware. For new builds, use the current guide. Go to the equivalent page →

Welcome

Legacy guide — no longer updated

HealthyPi 5 is an open-source biosignals-acquisition platform built around the dual-core RP2040 + ESP32 and three medical-grade analog front-ends: MAX30001 (ECG and bio-impedance), AFE4400 (PPG / SpO₂), and MAX30205 (temperature). It works as a Raspberry Pi HAT, as a standalone wearable, or as a desktop biosignals platform.

HealthyPi 5 Complete Kit in enclosure
Open Hardware. Open Source. Your Data.

Both the firmware and hardware design files are fully open source. All recorded data stays on your device or your computer — no cloud, no accounts.

Where to start

I just got my kit
Flash the right pre-built firmware and start streaming in a few minutes.

→ Download firmware

I want to write code
Build the firmware yourself using Arduino IDE or Zephyr RTOS.

→ Program with Arduino

I want to understand the hardware
Get to know the main board, carrier board, display, and sensor stack.

→ Hardware overview

Download pre-built firmware

These pre-compiled .uf2 images are ready to drag-and-drop onto the device — no toolchain required. Pick the firmware that matches the display variant in your kit (or the Basic build if you have no display).

Variant Display USB stream BLE SD logging Download
Basic + ILI9488 (white display) Vitals only ✓ ✓ ✓ Download
Basic + ST7796 (black display) Vitals only ✓ ✓ ✓ Download
Display + ILI9488 (white display) Full plots — — — Download
Display + ST7796 (black display) Full plots — — — Download

The Basic image is the most versatile — it streams vitals over USB and BLE, logs to SD, and shows numeric vitals on the display. The Display image is purpose-built for the visual plot mode (see Display Configuration).

Flash the firmware

The HealthyPi 5 ships with the RP2040’s UF2 bootloader. Programming is drag-and-drop — no Arduino IDE or toolchain needed.

Complete Kit (with enclosure / display)
  1. Connect the kit to your computer with a USB-C cable.

  2. Power it on. A fresh device boots into a welcome screen.

    HealthyPi 5 Complete Kit welcome screen

  3. Power off the device.

  4. Hold the RP2040 boot button (on the side of the kit, near the SpO₂ port).

    RP2040 boot button location on the Complete Kit
    Pressing the RP2040 boot button

  5. While still holding the button, power on the device. It will reboot in programming mode and mount on your computer as a USB drive named RPI-RP2.

    HealthyPi 5 ready to receive firmware
    RPI-RP2 mass storage device visible on the host computer

  6. Drag the .uf2 file onto the RPI-RP2 drive. The device flashes itself and reboots into the new firmware automatically.

    Drag and drop UF2 file onto RPI-RP2 drive

Basic Kit (bare board)
  1. Connect the board to your computer via USB-C.

  2. Power on — the red LED below the main board lights up.

    Power LED on the HealthyPi 5 Basic Kit

  3. Power off the device.

  4. Hold the RP2040 boot button on the side of the main board.

    RP2040 boot button on the Basic Kit

  5. While still holding the button, power on the device. It mounts as a USB drive named RPI-RP2.

    Holding the boot button while powering on
    RPI-RP2 mass storage device on the computer

  6. Drag the .uf2 file onto the RPI-RP2 drive. The device flashes and reboots.

    UF2 file dropped onto the RPI-RP2 drive

The device is now ready to stream. See the Operating Modes section for what each mode does.

Resources