Add .. zephyr:board-supported-runners:: to the Programming and Debugging section of the documentation for each board that has one such section, as this is the most natural place to put it. Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
67 lines
1.9 KiB
ReStructuredText
67 lines
1.9 KiB
ReStructuredText
.. zephyr:board:: adafruit_macropad_rp2040
|
|
|
|
Adafruit MacroPad RP2040
|
|
########################
|
|
|
|
Overview
|
|
********
|
|
|
|
The Adafruit MacroPad RP2040 is a 3x4 mechanical keyboard development board featuring
|
|
the Raspberry Pi RP2040 microcontroller. It includes 12 mechanical key switches with
|
|
individual RGB NeoPixels, a rotary encoder with push button, a 128x64 OLED display,
|
|
and a small speaker for audio feedback.
|
|
|
|
Hardware
|
|
********
|
|
|
|
- Dual core Cortex-M0+ at up to 133MHz
|
|
- 264KB of SRAM
|
|
- 8MB of QSPI flash memory
|
|
- 12 mechanical key switches (Cherry MX compatible)
|
|
- 12 RGB NeoPixel LEDs (one per key)
|
|
- 128x64 monochrome OLED display (SH1106)
|
|
- Rotary encoder with push button
|
|
- Small speaker with Class D amplifier
|
|
- STEMMA QT / Qwiic I2C connector
|
|
- USB Type-C connector
|
|
- Reset button
|
|
- 4x M3 mounting holes
|
|
|
|
Supported Features
|
|
******************
|
|
|
|
.. zephyr:board-supported-hw::
|
|
|
|
Programming and Debugging
|
|
*************************
|
|
|
|
.. zephyr:board-supported-runners::
|
|
|
|
Applications for the ``adafruit_macropad_rp2040`` board target can be built and
|
|
flashed in the usual way (see :ref:`build_an_application` and
|
|
:ref:`application_run` for more details).
|
|
|
|
Building and Flashing
|
|
*********************
|
|
|
|
The MacroPad RP2040 has a built-in UF2 bootloader which can be entered by holding down the rotary
|
|
encoder button (BOOT) and, while continuing to hold it, pressing and releasing the reset button.
|
|
A "RPI-RP2" drive should appear on your host machine.
|
|
|
|
Here is an example for building and flashing the :zephyr:code-sample:`blinky` sample application
|
|
using UF2.
|
|
|
|
.. zephyr-app-commands::
|
|
:zephyr-app: samples/basic/blinky
|
|
:board: adafruit_macropad_rp2040
|
|
:goals: build flash
|
|
:flash-args: --runner uf2
|
|
|
|
References
|
|
**********
|
|
|
|
.. target-notes::
|
|
|
|
- `Adafruit MacroPad RP2040 Product Page <https://www.adafruit.com/product/5128>`_
|
|
- `Adafruit MacroPad RP2040 Learn Guide <https://learn.adafruit.com/adafruit-macropad-rp2040>`_
|