Metro RP2040
Overview
The Adafruit Metro RP2040 [1] board is based on the RP2040 microcontroller from Raspberry Pi Ltd. The board has a MicroSD-card socket for storing data, and a Stemma QT connector for easy sensor usage. It is compatible with the Arduino board form factor, and has 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
16 Mbyte QSPI flash
20 GPIO pins
4 ADC pins
I2C
SPI
UART
USB type C connector
Barrel power supply connector for 6-12 Volt DC
On/off switch
Reset and boot buttons
Red LED
RGB LED (Neopixel)
Stemma QT I2C connector
MicroSD-card holder
Debug connectors (3-pin and 10-pin)
Default Zephyr Peripheral Mapping
A0 ADC0 : GPIO26
A1 ADC1 : GPIO27
A2 ADC2 : GPIO28
A3 ADC3 : GPIO29
D24 : GPIO24
D25 : GPIO25
RX UART0: GPIO1
TX UART0: GPIO0
D2 : GPIO2
D3 : GPIO3
D4 : GPIO4
D5 : GPIO5
D6 : GPIO6
D7 : GPIO7
D8 : GPIO8
D9 : GPIO9
D10 : GPIO10
D11 : GPIO11
D12 : GPIO12
D13 Red LED : GPIO13
SDA I2C0: GPIO16
SCL I2C0: GPIO17
RGB LED (Neopixel) : GPIO14
SD-card CARD_DET : GPIO15
SD-card SPI0 SCK/SDIO_CLK : GPIO18
SD-card SPI0 MOSI/SDIO_CMD : GPIO19
SD-card SPI0 MISO/SDIO_DAT0 : GPIO20
SD-card SPI0 SDCS/SDIO_DAT3 : GPIO23
SD-card SDIO_DAT1 : GPIO21
SD-card SDIO_DAT2 : GPIO22
The SD-card SPI signals (MOSI, MISO and SCK) are available on the 6-pin male header.
There is a switch for swapping the RX and TX position on the Arduino header. The devicetree file is using the switch position RX=1 TX=0, as the RP2040 UART0 TX is connected to GPIO0.
Normally an Arduino header has SPI functionality on the pins D10, D11, D12 and D13. However the SPI chip select and SPI clock pin positions are swapped on the Adafruit Metro RP2040 board.
Supported Features
The adafruit_metro_rp2040 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.
adafruit_metro_rp2040/rp2040 target
Type |
Location |
Description |
Compatible |
|---|---|---|---|
CPU |
on-chip |
ARM Cortex-M0+ CPU2 |
|
ADC |
on-chip |
Raspberry Pi Pico ADC1 |
|
Clock control |
on-chip |
Raspberry Pi Pico clock controller node1 |
|
on-chip |
|||
on-chip |
The representation of Raspberry Pi Pico’s PLL2 |
||
on-chip |
The representation of Raspberry Pi Pico ring oscillator1 |
||
on-chip |
The representation of Raspberry Pi Pico external oscillator1 |
||
Counter |
on-chip |
Raspberry Pi Pico timer1 |
|
DMA |
on-chip |
Raspberry Pi Pico DMA1 |
|
Flash controller |
on-chip |
Raspberry Pi Pico flash controller1 |
|
GPIO & Headers |
on-chip |
Raspberry Pi Pico GPIO1 |
|
on-chip |
Raspberry Pi Pico GPIO Port1 |
||
on-board |
GPIO pins exposed on Arduino Uno (R3) headers1 |
||
on-board |
STEMMA QT is a 4-pin JST-SH connector for I2C devices1 |
||
I2C |
on-chip |
||
Interrupt controller |
on-chip |
ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1 |
|
LED |
on-board |
Group of GPIO-controlled LEDs1 |
|
LED strip |
on-board |
The pio node configured for ws28121 |
|
Miscellaneous |
on-chip |
||
MTD |
on-chip |
Flash node1 |
|
on-board |
Fixed partitions of a flash (or other non-volatile storage) memory1 |
||
Pin control |
on-chip |
Raspberry Pi Pico Pin Controller1 |
|
PWM |
on-chip |
Raspberry Pi Pico PWM1 |
|
Regulator |
on-chip |
Raspberry Pi Pico core supply regurator1 |
|
Reset controller |
on-chip |
Raspberry Pi Pico Reset Controller1 |
|
RTC |
on-chip |
Raspberry Pi Pico RTC1 |
|
Sensors |
on-chip |
Raspberry Pi Pico family temperature sensor node1 |
|
Serial controller |
on-chip |
||
SPI |
on-chip |
||
SRAM |
on-chip |
Generic on-chip SRAM1 |
|
Timer |
on-chip |
ARMv6-M System Tick1 |
|
USB |
on-chip |
Raspberry Pi Pico USB Device Controller1 |
|
Watchdog |
on-chip |
Raspberry Pi Pico Watchdog1 |
Programming and Debugging
The adafruit_metro_rp2040 board supports the runners and associated west commands listed below.
| flash | debug | rtt | attach | debugserver | |
|---|---|---|---|---|---|
| blackmagicprobe | ✅ | ✅ | ✅ | ||
| jlink | ✅ | ✅ | ✅ | ✅ | ✅ |
| openocd | ✅ | ✅ (default) | ✅ | ✅ | ✅ |
| pyocd | ✅ | ✅ | ✅ | ✅ | ✅ |
| uf2 | ✅ (default) |
By default programming is done via the USB connector.
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.
It is also possible to program and debug the board via the 3-pin or 10-pin
debug connectors. Then a separate programming hardware tool is required, and
for example the openocd software is used. Typically the
OPENOCD and OPENOCD_DEFAULT_PATH
values should be set when building, and the --runner openocd
argument should be used when flashing.
For more details on programming RP2040-based boards, see
Programming and Debugging.
Flashing
To run the Blinky sample:
# From the root of the zephyr repository
west build -b adafruit_metro_rp2040 samples/basic/blinky/
west flash
Try also the Hello World, LED strip, File system manipulation, Console over USB CDC ACM and Analog-to-Digital Converter (ADC) with devicetree samples.
The Stemma QT connector can be used to read sensor data via I2C, for example the Generic 3-Axis accelerometer polling sample:
# From the root of the zephyr repository
west build -b adafruit_metro_rp2040 --shield adafruit_lis3dh samples/sensor/accel_polling
west flash