QT Py RP2040

Board Overview

QT Py RP2040

Name:

adafruit_qt_py_rp2040

Vendor:

Adafruit Industries, LLC

Architecture:

arm

SoC:

rp2040

Browse board sources

Overview

The Adafruit QT Py RP2040 is a small, low-cost, versatile board from Adafruit. It is equipped with an RP2040 SoC, an on-board RGB Neopixel, a USB connector, and a STEMMA QT connector. The USB bootloader allows it to be flashed without any adapter, in a drag-and-drop manner.

Hardware

• Dual core Arm Cortex-M0+ processor running up to 133MHz

• 264KB on-chip SRAM

• 8MB on-board QSPI flash with XIP capabilities

• 11 GPIO pins

• 4 Analog inputs

• 2 UART peripherals

• 2 SPI controllers

• 2 I2C controllers (one via STEMMA QT connector)

• 16 PWM channels

• USB 1.1 controller (host/device)

• 8 Programmable I/O (PIO) for custom peripherals

• On-board RGB LED

• 1 Watchdog timer peripheral

Supported Features

The adafruit_qt_py_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_qt_py_rp2040/rp2040 target

Type	Location	Description	Compatible
CPU	on-chip	ARM Cortex-M0+ CPU2	arm,cortex-m0+
ADC	on-chip	RaspberryPi 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	RaspberryPi 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 Seeeduino Xiao (and compatible devices) headers1	seeed,xiao-gpio
	on-board	STEMMA QT is a 4-pin JST-SH connector for I2C devices1	stemma-qt-connector
I2C	on-chip	Raspberry Pi Pico I2C2	raspberrypi,pico-i2c
Interrupt controller	on-chip	ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1	arm,v6m-nvic
LED strip	on-board	The pio node configured for ws28121	worldsemi,ws2812-rpi_pico-pio
Miscellaneous	on-chip	Raspberry Pi Pico PIO2	raspberrypi,pico-pio
MTD	on-chip	Flash node1	soc-nv-flash
	on-board	Fixed partitions of a flash (or other non-volatile storage) memory1	fixed-partitions
Pin control	on-chip	The RPi Pico pin controller is a node responsible for controlling pin function selection and pin properties, such as routing a UART0 Rx to pin 1 and enabling the pullup resistor on that pin1	raspberrypi,pico-pinctrl
PWM	on-chip	Raspberry Pi Pico PWM1	raspberrypi,pico-pwm
Regulator	on-chip	RaspberryPi Pico core supply regurator1	raspberrypi,core-supply-regulator
Reset controller	on-chip	Raspberry Pi Pico Reset Controller1	raspberrypi,pico-reset
RTC	on-chip	RaspberryPi Pico RTC1	raspberrypi,pico-rtc
Sensors	on-chip	RaspberryPi 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 SRAM description1	mmio-sram
Timer	on-chip	ARMv6-M System Tick1	arm,armv6m-systick
USB	on-chip	RaspberryPi Pico USB Device Controller1	raspberrypi,pico-usbd
Watchdog	on-chip	Raspberry Pi Pico Watchdog1	raspberrypi,pico-watchdog

Pin Mapping

The peripherals of the RP2040 SoC can be routed to various pins on the board. The configuration of these routes can be modified through DTS. Please refer to the datasheet to see the possible routings for each peripheral.

Default Zephyr Peripheral Mapping:

• UART1_TX : P20

• UART1_RX : P5

• I2C0_SDA : P24

• I2C0_SCL : P25

• I2C1_SDA : P22

• I2C1_SCL : P23

• SPI0_RX : P4

• SPI0_SCK : P6

• SPI0_TX : P3

Programming and Debugging

Flashing

Using UF2

Since it doesn’t expose the SWD pins, you must flash the Adafruit QT Py RP2040 with a UF2 file. By default, building an app for this board will generate a build/zephyr/zephyr.uf2 file. If the QT Py RP2040 is powered on with the BOOTSEL button pressed, it will appear on the host as a mass storage device. The UF2 file should be drag-and-dropped to the device, which will flash the QT Py RP2040.