ContextQMD
Back to Zephyr

Overview

boards/waveshare/rp2040_matrix/doc/index.rst

4.4.02.6 KB
Original Source

.. zephyr:board:: rp2040_matrix

Overview

The Waveshare RP2040-Matrix_ 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

.. rst-class:: rst-columns

- 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_. The default pin-muxing of UART, SPI and ADC pins is the same as for the :zephyr:board:rp2040_zero board.

.. warning::

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

Supported Features

.. zephyr:board-supported-hw::

Programming and Debugging

.. zephyr:board-supported-runners::

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 :file: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 :ref:rpi_pico_programming_and_debugging.

Flashing

To run the :zephyr:code-sample:led-strip sample:

.. zephyr-app-commands:: :zephyr-app: samples/drivers/led/led_strip/ :board: rp2040_matrix :goals: build flash

Try also the :zephyr:code-sample:hello_world, :zephyr:code-sample:display, :zephyr:code-sample:usb-cdc-acm-console and :zephyr:code-sample:adc_dt samples.

References

.. target-notes::

.. _Waveshare RP2040-Matrix: https://www.waveshare.com/rp2040-matrix.htm

.. _Waveshare RP2040-Matrix wiki: https://www.waveshare.com/wiki/RP2040-Matrix

.. _schematic: https://files.waveshare.com/upload/4/49/RP2040-Matrix.pdf