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.

Programming and Debugging

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

flash debug

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.

References