This is the documentation for the latest (main) development branch of Zephyr. If you are looking for the documentation of previous releases, use the drop-down menu on the left and select the desired version.

Raspberry Pi 5 (Cortex-A76)

Overview

Raspberry Pi 5 product-brief

Hardware

  • Broadcom BCM2712 2.4GHz quad-core 64-bit Arm Cortex-A76 CPU, with cryptography extensions, 512KB per-core L2 caches and a 2MB shared L3 cache

  • VideoCore VII GPU, supporting OpenGL ES 3.1, Vulkan 1.2

  • Dual 4Kp60 HDMI® display output with HDR support

  • 4Kp60 HEVC decoder

  • LPDDR4X-4267 SDRAM (4GB and 8GB SKUs available at launch)

  • Dual-band 802.11ac Wi-Fi®

  • Bluetooth 5.0 / Bluetooth Low Energy (BLE)

  • microSD card slot, with support for high-speed SDR104 mode

  • 2 x USB 3.0 ports, supporting simultaneous 5Gbps operation

  • 2 x USB 2.0 ports

  • Gigabit Ethernet, with PoE+ support (requires separate PoE+ HAT)

  • 2 x 4-lane MIPI camera/display transceivers

  • PCIe 2.0 x1 interface for fast peripherals (requires separate M.2 HAT or other adapter)

  • 5V/5A DC power via USB-C, with Power Delivery support

  • Raspberry Pi standard 40-pin header

  • Real-time clock (RTC), powered from external battery

  • Power button

Supported Features

The Raspberry Pi 5 board configuration supports the following hardware features:

Peripheral

Kconfig option

Devicetree compatible

GIC-400

N/A

arm,gic-v2

GPIO

CONFIG_GPIO

brcm,brcmstb-gpio

UART

CONFIG_SERIAL

arm,pl011

Not all hardware features are supported yet. See Raspberry Pi hardware for the complete list of hardware features.

The default configuration can be found in boards/raspberrypi/rpi_5/rpi_5_defconfig.

Programming and Debugging

Blinky

In brief,
  1. Format your Micro SD card with MBR and FAT32.

  2. Save three files below in the root directory.
  3. Insert the Micro SD card and power on the Raspberry Pi 5.

then, You will see the Raspberry Pi 5 running the zephyr.bin.

config.txt

kernel=zephyr.bin
arm_64bit=1

zephyr.bin

Build an app samples/basic/blinky

# From the root of the zephyr repository
west build -b rpi_5 samples/basic/blinky

Copy zephyr.bin from build/zephyr directory to the root directory of the Micro SD card.

Insert the Micro SD card and power on the Raspberry Pi 5. And then, the STAT LED will start to blink.

Serial Communication

wiring

You will need the following items:
  • Raspberry Pi Debug Probe

  • JST cable: 3-pin JST connector to 3-pin JST connector cable

  • USB cable: USB A male - Micro USB B male

Use the JST cable to connect the Raspberry Pi Debug Probe UART port to the Raspberry Pi 5 UART port between the HDMI ports.

Then connect the Raspberry Pi Debug Probe to your computer with a USB cable.

config.txt

kernel=zephyr.bin
arm_64bit=1
enable_uart=1
uart_2ndstage=1

zephyr.bin

Build an app samples/hello_world

# From the root of the zephyr repository
west build -b rpi_5 samples/hello_world

Copy zephyr.bin from build/zephyr directory to the root directory of the Micro SD card.

Insert the Micro SD card into your Raspberry Pi 5.

serial terminal emulator

When you power on the Raspberry Pi 5, you will see the following output in the serial console:

*** Booting Zephyr OS build XXXXXXXXXXXX  ***
Hello World! rpi_5/bcm2712