RP2040-Matrix

Overview

The Waveshare RP2040-Matrix [1] board is based on the RP2040 microcontroller from Raspberry Pi Ltd. The board has a 5x5 RGB LED matrix and a USB type C connector.

Hardware

Microcontroller Raspberry Pi RP2040, with a max frequency of 133 MHz
Dual ARM Cortex M0+ cores
264 kByte SRAM
2 Mbyte QSPI flash
16 GPIO pins
4 ADC pins
I2C
SPI
UART
USB type C connector
Reset and boot buttons
5x5 RGB LED matrix (Neopixels)

Default Zephyr Peripheral Mapping

0 UART0 TX : GPIO0
1 UART0 RX : GPIO1
2 : GPIO2
3 SPI0 MOSI : GPIO3
4 SPI0 MISO : GPIO4
5 : GPIO5
6 SPI0 SCK : GPIO6
7 : GPIO7
8 : GPIO8
9 : GPIO9
10 : GPIO10
11 : GPIO11
12 : GPIO12
13 : GPIO13
14 : GPIO14
15 : GPIO15
26 ADC0 : GPIO26
27 ADC1 : GPIO27
28 ADC2 : GPIO28
29 ADC3 : GPIO29
RGB LEDs (Neopixels): GPIO16

See also schematic [3]. The default pin-muxing of UART, SPI and ADC pins is the same as for the RP2040-Zero board.

Warning

Do not use too many LEDs simultaneously, as the board might get too hot. See Waveshare RP2040-Matrix wiki [2] for details.

Supported Features

The rp2040_matrix board supports the hardware features listed below.

on-chip / on-board: Feature integrated in the SoC / present on the board.
2 / 2: Number of instances that are enabled / disabled.
Click on the label to see the first instance of this feature in the board/SoC DTS files.
vnd,foo: Compatible string for the Devicetree binding matching the feature.
Click on the link to view the binding documentation.

`rp2040_matrix/rp2040` target

Type	Location	Description	Compatible
CPU	on-chip	ARM Cortex-M0+ CPU2	`arm,cortex-m0+`
ADC	on-chip	Raspberry Pi Pico ADC1	`raspberrypi,pico-adc`
Clock control	on-chip	Raspberry Pi Pico clock controller node1	`raspberrypi,pico-clock-controller`
	on-chip	The representation of Raspberry Pi Pico’s clock11 2	`raspberrypi,pico-clock`
	on-chip	The representation of Raspberry Pi Pico’s PLL2	`raspberrypi,pico-pll`
	on-chip	The representation of Raspberry Pi Pico ring oscillator1	`raspberrypi,pico-rosc`
	on-chip	The representation of Raspberry Pi Pico external oscillator1	`raspberrypi,pico-xosc`
Counter	on-chip	Raspberry Pi Pico timer1	`raspberrypi,pico-timer`
Display	on-board	Generic LED strip matrix (LED strip arranged in a grid pattern)1	`led-strip-matrix`
DMA	on-chip	Raspberry Pi Pico DMA1	`raspberrypi,pico-dma`
Flash controller	on-chip	Raspberry Pi Pico flash controller1	`raspberrypi,pico-flash-controller`
GPIO & Headers	on-chip	Raspberry Pi Pico GPIO1	`raspberrypi,pico-gpio`
GPIO & Headers	on-chip	Raspberry Pi Pico GPIO Port1	`raspberrypi,pico-gpio-port`
I2C	on-chip	Raspberry Pi Pico I2C2	`raspberrypi,pico-i2c`
Interrupt controller	on-chip	ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1	`arm,v6m-nvic`
LED strip	on-board	The pio node configured for ws28121	`worldsemi,ws2812-rpi_pico-pio`
Miscellaneous	on-chip	Raspberry Pi Pico PIO1 1	`raspberrypi,pico-pio`
MTD	on-chip	Flash node1	`soc-nv-flash`
MTD	on-board	Fixed partitions of a flash (or other non-volatile storage) memory1	`fixed-partitions`
Pin control	on-chip	Raspberry Pi Pico Pin Controller1	`raspberrypi,pico-pinctrl`
PWM	on-chip	Raspberry Pi Pico PWM1	`raspberrypi,pico-pwm`
Regulator	on-chip	Raspberry Pi Pico core supply regurator1	`raspberrypi,core-supply-regulator`
Reset controller	on-chip	Raspberry Pi Pico Reset Controller1	`raspberrypi,pico-reset`
RTC	on-chip	Raspberry Pi Pico RTC1	`raspberrypi,pico-rtc`
Sensors	on-chip	Raspberry Pi Pico family temperature sensor node1	`raspberrypi,pico-temp`
Serial controller	on-chip	Raspberry Pi Pico UART1 1	`raspberrypi,pico-uart`
SPI	on-chip	Raspberry Pi Pico SPI1 1	`raspberrypi,pico-spi`
SRAM	on-chip	Generic on-chip SRAM1	`mmio-sram`
Timer	on-chip	ARMv6-M System Tick1	`arm,armv6m-systick`
USB	on-chip	Raspberry Pi Pico USB Device Controller1	`raspberrypi,pico-usbd`
Watchdog	on-chip	Raspberry Pi Pico Watchdog1	`raspberrypi,pico-watchdog`

Programming and Debugging

The rp2040_matrix board supports the runners and associated west commands listed below.

	flash	debug
uf2	✅ (default)

The Waveshare RP2040-Matrix board does not expose the SWDIO and SWCLK pins, so programming must be done via the USB port. Press and hold the BOOT button, and then press the RST button, and the device will appear as a USB mass storage unit. Building your application will result in a build/zephyr/zephyr.uf2 file. Drag and drop the file to the USB mass storage unit, and the board will be reprogrammed.

For more details on programming RP2040-based boards, see Programming and Debugging.

Flashing

To run the LED strip sample:

# From the root of the zephyr repository
west build -b rp2040_matrix samples/drivers/led/led_strip/
west flash

Try also the Hello World, Display, Console over USB CDC ACM and Analog-to-Digital Converter (ADC) with devicetree samples.