RP2040 Prop-Maker Feather

Overview

The Adafruit RP2040 Prop-Maker Feather [1] board is based on the RP2040 microcontroller from Raspberry Pi Ltd. It has an output for external RGB LEDs (Neopixels), an external button input and an I2S-based speaker output. There is a Stemma QT connector for easy sensor usage. It is compatible with the Feather 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
8 Mbyte QSPI flash
18 GPIO pins
4 ADC pins
I2C
SPI
UART
USB type C connector
Reset and boot buttons
On-board Red LED
On-board RGB LED (Neopixel)
Stemma QT I2C connector (also known as Qwiic)
LIS3DH accelerometer
Servo port
Built-in lithium ion battery charger
I2S amplifier and speaker output
External button input
External neopixel output

Default Zephyr Peripheral Mapping

Description	Pin	Default pin mux	Comment
Boot button	GPIO7		Alias sw0
I2S DIN	GPIO16
I2S BCLK	GPIO17
I2S LRCLK	GPIO18
Servo output	GPIO20	PWM_2A	PWM name 4
Accel. interrupt	GPIO22

Feather header:

Label	Pin	Default pin mux	Also used by
A0	GPIO26	ADC0
A1	GPIO27	ADC1
A2	GPIO28	ADC2
A3	GPIO29	ADC3
24	GPIO24
25	GPIO25
SCK	GPIO14	SPI1 SCK
MO	GPIO15	SPI1 MOSI
MI	GPIO8	SPI1 MISO
RX	GPIO1	UART0 RX
TX	GPIO0	UART0 TX
4	GPIO4	PIO0	On-board RGB LED
SDA	GPIO2	I2C1 SDA	Stemma QT
SCL	GPIO3	I2C1 SCL	Stemma QT
5	GPIO5
6	GPIO6
9	GPIO9
10	GPIO10
11	GPIO11
12	GPIO12
13	GPIO13		Red user LED

Stemma QT I2C connector (pins also available in the Feather header):

Label	Pin	Default pin mux
SDA	GPIO2	I2C1 SDA
SCL	GPIO3	I2C1 SCL

The LIS3DH accelerometer is connected to the I2C bus, and has the 7-bit address 0x18.

Output screw terminal:

Pin	Description	Default pin mux
1	RGB LED from GPIO21	PIO1
2	GND
3	+5 Volt power output controlled by GPIO23	gpio-hog always enabled
4	Button input to GPIO19
5	Speaker -
6	Speaker +

The +5V output is always enabled via a gpio-hog in the devicetree file. Remove the node servo-power-enable to avoid powering the output on startup.

Supported Features

Note that the I2S-based speaker output is not yet supported.

The adafruit_feather_propmaker_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_feather_propmaker_rp2040/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`
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`
	on-chip	Raspberry Pi Pico GPIO Port1	`raspberrypi,pico-gpio-port`
	on-board	GPIO pins exposed on Adafruit Feather headers1	`adafruit-feather-header`
	on-board	STEMMA QT is a 4-pin JST-SH connector for I2C devices1	`stemma-qt-connector`
I2C	on-chip	Raspberry Pi Pico I2C1 1	`raspberrypi,pico-i2c`
Input	on-board	Group of GPIO-bound input keys1	`gpio-keys`
Interrupt controller	on-chip	ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1	`arm,v6m-nvic`
LED	on-board	Group of GPIO-controlled LEDs1	`gpio-leds`
LED strip	on-board	The pio node configured for ws28122	`worldsemi,ws2812-rpi_pico-pio`
Miscellaneous	on-chip	Raspberry Pi Pico PIO2	`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-board	STMicroelectronics LIS3DH 3-axis accelerometer1	`st,lis3dh`
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 adafruit_feather_propmaker_rp2040 board supports the runners and associated west commands listed below.

	flash	debug
uf2	✅ (default)

The Adafruit RP2040 Prop-Maker Feather 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 Blinky sample:

# From the root of the zephyr repository
west build -b adafruit_feather_propmaker_rp2040 samples/basic/blinky/
west flash

Try also the LED strip, Input dump, Button, Generic 3-Axis accelerometer polling, Hello World and Analog-to-Digital Converter (ADC) with devicetree samples.

The use of the Stemma QT I2C connector is demonstrated using the Generic Light Sensor Polling sample and a separate shield:

# From the root of the zephyr repository
west build -b adafruit_feather_propmaker_rp2040 --shield adafruit_veml7700 samples/sensor/light_polling/
west flash

Servo motor control is done via PWM outputs. The Servomotor sample sets servo position timing via an overlay file.

# From the root of the zephyr repository
west build -b adafruit_feather_propmaker_rp2040 samples/basic/servo_motor/
west flash

It is also possible to control the servo via the PWM shell:

# From the root of the zephyr repository
west build -b adafruit_feather_propmaker_rp2040 samples/sensor/sensor_shell/ -- -DCONFIG_PWM=y -DCONFIG_PWM_SHELL=y
west flash

Control the position via the pulse length. Most servos can handle pulse lengths between 0.8 and 2 milliseconds:

pwm usec pwm@40050000 4 20000 800
pwm usec pwm@40050000 4 20000 2000

In order to use external neopixels connected via the screw terminal, you need to adapt the devicetree file to the number of pixels in your external light-strip. See the external_ws2812 node. You must also change the aliases attribute from led-strip = &onboard_ws2812; to led-strip = &external_ws2812;. Then use the LED strip sample.

Read the external button via GPIO.

# From the root of the zephyr repository
west build -b adafruit_feather_propmaker_rp2040 samples/sensor/sensor_shell/ -- -DCONFIG_GPIO_SHELL=y
west flash

Use these shell commands to read the external button:

gpio conf gpio0 19 iul
gpio get gpio0 19

If you wish to map the external button to the Zephyr input subsystem, see how it is done for the on-board button in the devicetree file.