RIOT OS 在 Raspberry Pi Pico（RP2040）上的板级支持：硬件特性、烧录方式与调试实战

RIOT OS 在 Raspberry Pi PicoRP2040上的板级支持硬件特性、烧录方式与调试实战【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOTRaspberry Pi Pico 是树莓派基金会推出的低成本约 4 美元微控制器开发板搭载自研的双核 ARM Cortex-M0 芯片 RP2040。本文以 RIOT 仓库中的 boards/rpi-pico/doc.md 为主线结合 板级配置、构建系统文件 与 CPU 底层实现完整讲解这块板卡在 RIOT 中的硬件资源映射、三种烧录方式UF2 引导、OpenOCD、J-Link、shell 串口访问、片上调试流程以及当前实现阶段的已知限制帮助你直接用BOARDrpi-pico跑通 RIOT 应用。板卡与 MCU 概览Raspberry Pi Pico 之所以在 RIOT 中被单列为一块板卡核心原因在于其主控 RP2040 的独特性这是一颗双核 ARM Cortex-M0芯片主频最高 133 MHz配备 264 KiB RAM并且内部没有 Flash——程序存储在外部 QSPI Flash 中通过SSI/QSPI 外设支持 XIPExecute In Place从 Flash 直接取指执行。此外 RP2040 还提供了 RIOT 与社区都颇为关注的Programmable IOPIO可编程 IO 外设boards/rpi-pico/doc.md 将其与 XIP 并列为 MCU 最具区分度的两大特性。板卡在 RIOT 中的位置由 boards/rpi-pico/Kconfig 定义BOARD_RPI_PICO默认选中CPU_MODEL_RP2040并映射到rpi-pico板名boards/rpi-pico/Makefile.include 中进一步声明CPU_MODEL : RP2040Linux 下默认串口端口为/dev/ttyUSB0。核心硬件参数以下表格完整摘录自板级文档并可与 RP2040 数据手册 对应项目参数MCURP2040内核2× ARM Cortex-M0厂商Raspberry PiRAM264 KiBFlash2 MiB板上最大支持 16 MiB频率最高 133 MHzFPU无PIO8 个状态机定时器1 × 64-bitADC1 × 12-bit4 通道 温度传感器UART2SPI2I2C2RTC1USB1USB 2.0看门狗1SSI/QSPI1连接 Flash支持 XIP供电1.62V – 3.63V需要特别注意的是FPU 为无、以及Flash 完全依赖外部 QSPI这两点前者意味着浮点运算依赖软件实现后者意味着所有固件的存放与启动都绕不开 XIP 与烧录环节。RIOT 中已提供的外设能力板级文档以早期实现定性当前状态但从仓库的构建元数据看已有相当数量的外设被声明为可用。boards/rpi-pico/Makefile.features 按字母序声明了以下FEATURES_PROVIDEDperiph_adcperiph_i2cperiph_spiperiph_pwmperiph_timerperiph_uart这些声明与 boards/rpi-pico/include/periph_conf.h 中的具体引脚映射一一对应下面按外设逐一展开。UART默认调试与控制台通道periph_conf.h注册了两路 UART设备TXRX中断UART0GPIO0物理引脚 1GPIO1物理引脚 2UART0_IRQ_IRQnUART1GPIO8物理引脚 8GPIO9物理引脚 9UART1_IRQ_IRQn其中UART0 即为板级默认的 RIOT shell 通道下文详述。中断服务函数通过UART_0_ISR/UART_1_ISR宏分别绑定到isr_uart0/isr_uart1。SPI两路标准 SPI设备MISOMOSICLKSPI0GPIO4GPIO3GPIO2SPI1GPIO12GPIO11GPIO10定时器一个 64 位定时器的 4 个通道timer_config中注册了单个TIMER设备包含 4 个通道分别使用TIMER_IRQ_0_IRQn至TIMER_IRQ_3_IRQn对应的 ISR 宏依次为isr_timer0…isr_timer3。这对应文档参数表中的 1 × 64-bit Timers。ADC3 个外部通道adc_config注册了 3 个外部 ADC 通道引脚通道GPIO260GPIO271GPIO282第 4 个通道温度传感器由 RP2040 硬件提供未在板级数组中注册。PWM板载 LED 复用pwm_config使用pwm_slice 4其通道 1 直接映射到GPIO25板载 LED通道 0 为未定义引脚。这意味着你可以直接通过 PWM 驱动板载 LED 实现呼吸灯等效果而无需外接器件。I2C通过 PIO 实现板级文档明确说明I2C 外设是通过 PIO 实现的这一点在源码中得到双重印证boards/rpi-pico/include/periph_conf.h 中I2C_NUMOF被定义为 0通过_periph_numof_is_unsigned_0()辅助函数并声明只要在构建时定义PIO_I2C_CONFIG就会生成pio_i2c_config[]数组含pio、sda、scl、irq字段drivers/include/periph/pio/i2c.h 提供了pio_i2c_get()、pio_i2c_numof()、pio_i2c_init_program()等接口将 I2C 总线用 PIO 状态机模拟并用互斥锁保护总线并发访问——该接口目前标注为experimental实验性 API可能变动cpu/rpx0xx/periph/i2c.c 目前是一个dummy 实现仅用于测试 PIO I2C 接口当启用MODULE_PIO_I2C且dev I2C_NUMOF时会把 PIO 配置实例化出来。PIO 的板级配置在periph_conf.h中注册了两个实例PIO0 / PIO1各自带有两组 IRQPIO0_IRQ_0_IRQn、PIO0_IRQ_1_IRQn等对应文档参数表中的 8 PIOs。用户接口1 个按键 1 个 LED板卡提供 1 个按键兼作启动模式选择和 1 个 LED设备引脚LED0GPIO25SW0QSPI_SS_N*关于 SW0文档特别说明由于该按键直接连接 QSPI 接口的片选引脚即 RIOT 通过 XIP 运行的 Flash 芯片的片选软件难以稳定读取其状态当前不支持从软件读取该按键。LED 的驱动定义位于 boards/rpi-pico/include/board.hLED0_PIN为GPIO_PIN(0, 25)并通过 SIO 寄存器位操作实现LED0_ONSIO-GPIO_OUT_SET 1UL 25LED0_OFFSIO-GPIO_OUT_CLR 1UL 25LED0_TOGGLESIO-GPIO_OUT_XOR 1UL 25这种直接写 SIO 寄存器的方式比通用 GPIO 驱动更轻量。此外boards/rpi-pico/Makefile.dep 表明当启用saul_default模块时板卡会自动追加saul_gpio把 LED 注册为 SAUL 设备见 gpio_params.h 中名为LED(Green)的 GPIO 输出条目方便通过统一传感器/执行器抽象直接控制板载 LED。烧录固件的三种方式由于 RP2040 没有内部 Flash烧录流程是使用本板卡的第一道关卡。RIOT 支持三种烧录方式均通过make flash触发。方式一UF2 引导程序默认picotool PROGRAMMER按住板卡丝印标注的BOOTSEL按键插入 Micro-USB 线Pico 会以可移动存储设备的形式出现在系统中把 UF2 格式的固件文件拷贝进去即可完成烧录。在 RIOT 中这一过程已被自动化BOARDrpi-pico make flash这是默认烧录方式底层使用picotool作为 PROGRAMMER。方式二OpenOCD软硬件两种适配器文档截至 2026 年 5 月指出OpenOCD 调试路径目前仅支持两种适配器低层 bit-banging 适配器例如通过树莓派 4B 的 GPIO 直接引出调试线虚拟 CMSIS-DAP 适配器由 Pico 的第二个 CPU 内核通过 pico-debug 提供。方式二不需要额外硬件但需要先用 UF2 引导程序把 pico-debug 的gimme-cache 变体烧入 RAM按住 BOOTSEL 插入 USB将pico-debug-gimmecache.uf2来自 pico-debug 最新 release拷贝到引导程序提供的虚拟 FAT 磁盘卸载该磁盘后Pico 会以 CMSIS-DAP 调试器形态出现。随后执行BOARDrpi-pico PROGRAMMERopenocd make flash两点重要提醒文档原文强调rpi-pico虚拟调试器不持久每次冷启动后都需要重新烧入 RAMRP2040 自 OpenOCD 0.12.0 起才被支持请确认你的 OpenOCD 版本不低于此。方式三J-Link将板卡连接 Segger J-Link 调试器文档举例 EDU mini 相对便宜但仅限教育用途然后运行BOARDrpi-pico PROGRAMMERjlink make flash对应地boards/rpi-pico/Makefile.include 中为 J-Link 指定了调试目标设备名JLINK_DEVICE RP2040_M0_0选择 Cortex-M0 的核 0。访问 RIOT Shellmake term板卡的默认 RIOT shell 通道是UART0TX物理引脚 1GPIO0RX物理引脚 2GPIO1默认波特率115200与 periph_conf.h 中 UART0 的tx_pin GPIO_PIN(0, 0)、rx_pin GPIO_PIN(0, 1)完全对应。最简单的连接方式是BOARDrpi-pico make termmake term会使用 Makefile.include 中默认的/dev/ttyUSB0端口打开串口终端。警告文档原文强调Raspberry Pi Pico 板卡不兼容 5V 电平当连接 5V UART 时务必使用分压电路或逻辑电平转换器否则可能损坏芯片。片上调试On-Chip Debugging截至 2026 年 5 月调试 Pico 的硬件选项有J-Link使用 Segger 系列调试器OpenOCD 低层 bit-banging 调试器例如将树莓派 4B 的 GPIO 通过跳线连接 PicoBlack Magic Probe使用近期更新的 Black Magic Probe 调试器。此外还有纯软件方案pico-debug。默认链接脚本为它预留了16 KiB RAM因此只需通过 UF2 引导把 gimme-cache 版本烧进 RAM然后即可直接调试BOARDrpi-pico make debug使用注意文档原文警告虚拟调试器不持久每次冷启动需重新烧入RIOT 的初始化代码目前与调试器配合良好因此软复位后调试器仍保持连接若在重启时遇到与调试器失去连接的问题可在 GDB 中改用monitor reset init执行软复位。已知问题与实现状态板级文档明确指出该板卡处于早期实现阶段Early State Implementation以下外设当前尚未实现USBRTC看门狗WatchdogSMP 支持RIOT 尚未实现多核支持RP2040 的第二核目前未被利用而I2C 外设则通过 PIO 实现见上文PIO I2C小节这既是 RP2040 的特色应用也属于实验性功能。从 cpu/rpx0xx 的代码结构看PIO 相关支持已具备完整的目录组织cpu/rpx0xx/periph/pio.c负责 PIO 底层驱动cpu/rpx0xx/pio/i2c/i2c.c提供 PIO 上的 I2C 程序实现cpu/rpx0xx/periph/i2c.c则是面向 RIOTperiph_i2c接口的对接层。可以推断后续一旦板级PIO_I2C_CONFIG正式落地periph_i2c便能通过 PIO 状态机为用户提供可用的 I2C 总线。快速上手小结综合以上内容在 RIOT 中使用 Raspberry Pi Pico 的最小路径是# 1. 编译任意支持该板的应用以 hello-world 类应用为例 cd examples/hello-world BOARDrpi-pico make # 2. 按住 BOOTSEL 插入 USB默认走 UF2/picotool 烧录 BOARDrpi-pico make flash # 3. 通过 UART0GPIO0/GPIO1115200 baud进入 RIOT shell BOARDrpi-pico make term调试场景下按需选择PROGRAMMERopenocd配合 pico-debug 或 bit-banging 适配器或PROGRAMMERjlink配合 Segger 调试器随后执行make debug进入 GDB。需要留意 PIO I2C、USB、RTC、看门狗等尚未完善的功能边界避免在早期阶段踩坑。相关资源索引板级文档boards/rpi-pico/doc.md外设引脚配置boards/rpi-pico/include/periph_conf.hLED/SAUL 定义boards/rpi-pico/include/board.h、boards/rpi-pico/include/gpio_params.h构建元数据boards/rpi-pico/Makefile.features、boards/rpi-pico/Makefile.include、boards/rpi-pico/KconfigPIO I2C 驱动drivers/include/periph/pio/i2c.h、cpu/rpx0xx/periph/i2c.c、cpu/rpx0xx/pio/i2c/i2c.c【免费下载链接】RIOTRIOT - The friendly OS for IoT项目地址: https://gitcode.com/GitHub_Trending/riot/RIOT创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考