RP2040-GEEK
Overview
The Waveshare RP2040-GEEK Development Board [1] is based on the RP2040 microcontroller from Raspberry Pi Ltd. It has an USB A connector, a color screen, a microSD card slot and several expansion connectors.
Hardware
Microcontroller Raspberry Pi RP2040, with a max frequency of 133 MHz
Dual ARM Cortex M0+ cores
264 kByte SRAM
4 Mbyte QSPI flash
USB type A connector
BOOT button
135x240 pixels 1.14 inch color LCD screen
microSD card slot
4-pin I2C connector (Quiic / Stemma QT compatible)
3-pin UART connector
3-pin GPIO connector
Default Zephyr Peripheral Mapping
Connector “UART” pin GP4, UART1 TX : GPIO4
Connector “UART” pin GP5, UART1 RX : GPIO5
Connector “DEBUG” pin GP2 : GPIO2
Connector “DEBUG” pin GP3 : GPIO3
Connector “I2C/ADC” pin GP28, I2C0 SDA : GPIO28
Connector “I2C/ADC” pin GP29, I2C0 SCL : GPIO29
microSD SCK, SPI0 SCK : GPIO18
microSD CMD, SPI0 MOSI : GPIO19
microSD DO, SPI0 MISO : GPIO20
microSD D1 : GPIO21
microSD D2 : GPIO22
microSD D3 (CS) : GPIO23
LCD DC (data/command): GPIO8
LCD SPI1 CS : GPIO9
LCD SPI1 SCK : GPIO10
LCD SPI1 MOSI : GPIO11
LCD RST (reset) : GPIO12
LCD BL (backlight): GPIO25
This board is intended to be used with a host computer via the USB A connector, why this board by default uses USB for terminal output.
See also Waveshare P2040-GEEK wiki [2] and schematic [3].
Supported Features
The rp2040_geek
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_geek/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 |
|
Display |
on-board |
Sitronix ST7789V display controller1 |
|
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 |
||
I2C |
on-chip |
||
Interrupt controller |
on-chip |
ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1 |
|
Miscellaneous |
on-chip |
Raspberry Pi Pico PIO2 |
|
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 |
Raspberry Pi Pico SPI2 |
|
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 rp2040_geek
board supports the runners and associated west commands listed below.
flash | debug | |
---|---|---|
uf2 | ✅ (default) |
The board does not expose the SWDIO and SWCLK pins, so programming must be done via the
USB port. Press and hold the BOOT button when connecting the RP2040-GEEK to your host computer,
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 RP2040-GEEK will be reprogrammed.
For more details on programming RP2040-based boards, see Raspberry Pi Pico and especially Programming and Debugging.
Flashing
To run the Dining Philosophers sample to verify output on the USB console:
# From the root of the zephyr repository
west build -b rp2040_geek samples/philosophers/
west flash
Try also the File system manipulation, Display, LVGL basic sample and UART Passthrough samples.
Samples where text is printed only just at startup, for example Hello World, are difficult to use as the text is already printed once you connect to the newly created USB console endpoint.
It is easy to connect a sensor shield via the I2C connector, for example
the adafruit_lis3dh
shield. Run the Generic 3-Axis accelerometer polling sample:
# From the root of the zephyr repository
west build -b rp2040_geek --shield adafruit_lis3dh samples/sensor/accel_polling/
west flash
To use the GPIO pins on the “DEBUG” connector:
# From the root of the zephyr repository
west build -b rp2040_geek samples/sensor/sensor_shell -- -DCONFIG_GPIO=y -DCONFIG_GPIO_SHELL=y
west flash
and then in the device console:
uart:~$ gpio conf gpio0 2 o
uart:~$ gpio set gpio0 2 1