Trinkey QT2040
Overview
The Adafruit Trinkey QT2040 [1] board is based on the RP2040 microcontroller from Raspberry Pi Ltd. The board has a Stemma QT connector for easy sensor usage, and has a USB type A connector. The board outline is similar to many Adafruit Stemma QT shields.
Hardware
Microcontroller Raspberry Pi RP2040, with a max frequency of 133 MHz
Dual ARM Cortex M0+ cores
264 kByte SRAM
8 Mbyte QSPI flash
USB type A connector
Reset and boot buttons
RGB LED (Neopixel)
Stemma QT I2C connector
Default Zephyr Peripheral Mapping
Boot/User button: GPIO12
RGB LED: GPIO27
I2C0_SDA : GPIO16
I2C0_SCL : GPIO17
Note that no serial port pins (RX or TX) are exposed. By default this board uses USB for terminal output.
The Boot/User button will pull down the QSPI chip-select line (via a diode) for entering the built-in USB bootloader at startup. The devicetree file enables an in-chip pull-up resistor for the Boot/User button so it can be used during runtime, for example via the Input dump or the Button sample. However these samples are somewhat unreliable, as there might be lots of interrupts. This can be solved by using a stronger external pull-up via the TP4 test point on the back of the PCB, for example 10 kOhm to +3.3 Volt.
Supported Features
The adafruit_trinkey_qt2040 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_trinkey_qt2040/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 |
STEMMA QT is a 4-pin JST-SH connector for I2C devices1 |
||
I2C |
on-chip |
||
Input |
on-board |
Group of GPIO-bound input keys1 |
|
Interrupt controller |
on-chip |
ARMv6-M NVIC (Nested Vectored Interrupt Controller) controller1 |
|
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 |
Raspberry Pi Pico UART2 |
|
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 adafruit_trinkey_qt2040 board supports the runners and associated west commands listed below.
| flash | debug | |
|---|---|---|
| uf2 | ✅ (default) |
The Adafruit Trinkey QT2040 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 build and flash the LED strip application, which will blink the on-board RGB LED in different colors, use this command:
# From the root of the zephyr repository
west build -b adafruit_trinkey_qt2040 samples/drivers/led/led_strip
west flash
Try also the Dining Philosophers sample to verify USB console output. 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 Stemma QT 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 adafruit_trinkey_qt2040 --shield adafruit_lis3dh samples/sensor/accel_polling/
west flash
or the Sensor shell sample:
# From the root of the zephyr repository
west build -b adafruit_trinkey_qt2040 --shield adafruit_lis3dh samples/sensor/sensor_shell/
west flash
Read the values from the accelerometer via the shell:
uart:~$ sensor get lis3dh@18
channel type=0(accel_x) index=0 shift=4 num_samples=1 value=22974328296ns (0.000000)
channel type=1(accel_y) index=0 shift=4 num_samples=1 value=22974328296ns (-0.114912)
channel type=2(accel_z) index=0 shift=4 num_samples=1 value=22974328296ns (9.882431)
channel type=3(accel_xyz) index=0 shift=4 num_samples=1 value=22974328296ns, (0.000000, -0.114912, 9.882431)