【免费下载链接】TobudOSTobudOS 是面向物联网领域开发的实时操作系统早期版本基于腾讯自研的物联网操作系统TencentOS Tiny2020年由腾讯捐赠到开放原子开源基金会进行孵化2023年正式更名为TobudOSTobudOS具有低功耗低资源占用模块化安全可靠等特点可有效提升物联网终端产品开发效率提供精简的 RTOS 内核内核组件可裁剪可配置可快速移植到多种主流 MCU (如 STM32 全系列) 及模组芯片上。而且基于 RTOS 内核提供了丰富的物联网组件内部集成主流物联网协议栈如 CoAP/MQTT/TLS/DTLS/LoRaWAN/NB-IoT 等可助力物联网终端设备及业务快速接入物联网云平台。项目地址https://gitcode.com/openatomfoundation/TobudOS点击查看免费下载本文围绕 TobudOS 仓库内 MicroPython 子系统的 RP2xxx 端口通用说明系统梳理以 Raspberry Pi Pico搭载 RP2040为代表的 RP2xxx 系列芯片的硬件技术规格、外设资源并在此基础上结合仓库内的快速参考文档、PIO 教程、rp2模块 API 文档与可运行示例给出从 REPL 基本操作到 PIO 状态机编程的完整实战方案。读完本文你将掌握 RP2040 的关键参数与片上外设、MicroPython 下 GPIO/UART/PWM/ADC/SPI/I2C 等接口的标准用法以及用 PIO 实现 1Hz 闪烁、WS2812 灯带驱动等经典场景的底层原理。图Raspberry Pi Pico 开发板引脚分布图片来源Raspberry Pi Foundation出自 RP2 快速参考文档一、RP2xxx 端口与 RP2040 芯片概览MicroPython 的 rp2 端口面向树莓派基金会Raspberry Pi Foundation的RP2xxx 系列微控制器其中最具代表性的产品就是搭载RP2040的 Raspberry Pi Pico 开发板。在 TobudOS 仓库中该端口对应的 MicroPython 移植位于 components/language/micropython/port由 KY-zhang-X 于 2022 年贡献并深度集成了 TobudOS 内核特性而 rp2 端口的完整文档体系则位于 components/language/micropython/docs/rp2包括general.rst本文主体、quickref.rst接口速查、tutorial/入门与 PIO 教程以及library/rp2*.rst模块 API。1.1 制造工艺与封装RP2040 采用40 nm 硅工艺制造封装为7×7 mm 的 QFN-56 SMD 封装。这颗芯片不内置 Flash 与 EEPROM复位后由 bootloader 从外部 Flash 或 USB 总线把固件加载到内部 SRAM 中运行因此固件存储与启动链路与常见 MCU 有所不同。1.2 核心与存储规格特性参数CPU双核 ARM Cortex-M0主频 133 MHz可超频至 400 MHz 以上SRAM264 KB分六个独立 bank片上存储无内部 Flash / EEPROM复位后 bootloader 从外部 Flash 或 USB 加载固件至内部 SRAM外部存储QSPI 总线控制器支持最大 16 MB 外部 Flash电源片上可编程 LDO 生成核心电压时钟2 个片上 PLL分别生成 USB 时钟与核心时钟GPIO30 个其中 4 个可选作模拟输入更详细的芯片数据请参考树莓派官方发布的 RP2040 数据手册本仓库文档中给出了官方 datasheet 链接文中不再重复外部地址。1.3 片上外设资源RP2040 提供的外设包括2 个 UART2 个 SPI 控制器2 个 I2C 控制器16 路 PWM 通道1 个 USB 1.1 控制器8 个 PIO 状态机2 个 PIO 块 × 4 个状态机这些外设在 MicroPython 中均通过machine与rp2模块暴露下文的接口速查会逐一演示。二、开发环境与基础操作2.1 REPL 控制台MicroPython REPL 通过USB 串口访问。两个实用技巧Tab 补全帮助快速查看对象拥有的方法粘贴模式Ctrl-E适合将大段 Python 代码一次性粘贴进 REPL。machine模块的基础操作import machine machine.freq() # 获取当前 CPU 频率 machine.freq(240000000) # 将 CPU 频率设置为 240 MHzrp2模块的引入方式import rp2注意默认情况下 REPL over UART 是关闭的如需启用请参阅 RP2 入门教程 中关于 REPL over UART 的说明。2.2 延时与计时使用time模块import time time.sleep(1) # 睡眠 1 秒 time.sleep_ms(500) # 睡眠 500 毫秒 time.sleep_us(10) # 睡眠 10 微秒 start time.ticks_ms() # 获取毫秒计数器 delta time.ticks_diff(time.ticks_ms(), start) # 计算时间差2.3 定时器TimerRP2040 的系统定时器外设提供全局微秒时基并产生中断。当前可使用软件定时器数量不限受内存限制无需指定定时器 id当前支持id-1将使用默认值from machine import Timer tim Timer(period5000, modeTimer.ONE_SHOT, callbacklambda t:print(1)) tim.init(period2000, modeTimer.PERIODIC, callbacklambda t:print(2))三、外设接口快速参考RP2 端口速查以下用法完整继承自 RP2 快速参考文档是 RP2xxx 端口最常被引用的实操清单。3.1 引脚与 GPIO使用machine.Pin类from machine import Pin p0 Pin(0, Pin.OUT) # 在 GPIO0 上创建输出引脚 p0.on() # 将引脚置为 on高电平 p0.off() # 将引脚置为 off低电平 p0.value(1) # 置为高电平 p2 Pin(2, Pin.IN) # 在 GPIO2 上创建输入引脚 print(p2.value()) # 读取电平值0 或 1 p4 Pin(4, Pin.IN, Pin.PULL_UP) # 使能内部上拉电阻 p5 Pin(5, Pin.OUT, value1) # 创建时即置高3.2 UART 串口RP2040 有两个 UARTUART0可映射到 GPIO 0/1、12/13、16/17UART1可映射到 GPIO 4/5、8/9。from machine import UART, Pin uart1 UART(1, baudrate9600, txPin(4), rxPin(5)) uart1.write(hello) # 写 5 字节 uart1.read(5) # 读最多 5 字节3.3 PWM 脉宽调制共有8 个独立通道每个通道有 2 路输出合计 16 路 PWM时钟范围 7 Hz ~ 125 MHzfrom machine import Pin, PWM pwm0 PWM(Pin(0)) # 从引脚创建 PWM 对象 pwm0.freq() # 获取当前频率 pwm0.freq(1000) # 设置频率 pwm0.duty_u16() # 获取当前占空比范围 0-65535 pwm0.duty_u16(200) # 设置占空比范围 0-65535 pwm0.deinit() # 关闭该引脚上的 PWM3.4 ADC 模数转换RP2040 共有5 个 ADC 通道其中 4 个为 12 位 SAR 型 ADCGP26、GP27、GP28、GP29分别对应 ADC0~ADC3Pico 板上 GP29 连接 VSYS。标准 ADC 量程为 0~3.3V。第 5 个通道连接内置温度传感器可用于测温from machine import ADC, Pin adc ADC(Pin(26)) # 在 ADC 引脚上创建 ADC 对象 adc.read_u16() # 读取值0-65535 对应电压 0.0v - 3.3v3.5 SPI 总线软件 SPIbit-banging 实现可在所有引脚上工作通过machine.SoftSPI访问。注意polarity是 SCK 的空闲电平phase0表示在 SCK 第一个边沿采样、phase1表示第二个边沿from machine import Pin, SoftSPI spi SoftSPI(baudrate100_000, polarity1, phase0, sckPin(0), mosiPin(2), misoPin(4)) spi.init(baudrate200000) # 设置波特率 spi.read(10) # 在 MISO 上读 10 字节 spi.read(10, 0xff) # 读 10 字节同时在 MOSI 上输出 0xff buf bytearray(50) # 创建缓冲区 spi.readinto(buf) # 读入给定缓冲区此处读 50 字节 spi.readinto(buf, 0xff) # 读入缓冲区并在 MOSI 上输出 0xff spi.write(b12345) # 在 MOSI 上写 5 字节 buf bytearray(4) # 创建 4 字节缓冲区 spi.write_readinto(b1234, buf) # 写 MOSI 并从 MISO 读入缓冲区 spi.write_readinto(buf, buf) # 将 buf 写到 MOSI并从 MISO 读回 buf警告当前初始化软件 SPI 时sck、mosi、miso三个引脚必须全部指定。硬件 SPIRP2040 有 2 个硬件 SPI 总线通过machine.SPI访问方法与软件 SPI 相同from machine import Pin, SPI spi SPI(1, 10_000_000) # 默认分配sckPin(10), mosiPin(11), misoPin(8) spi SPI(1, 10_000_000, sckPin(14), mosiPin(15), misoPin(12)) spi SPI(0, baudrate80_000_000, polarity0, phase0, bits8, sckPin(6), mosiPin(7), misoPin(4))3.6 I2C 总线软件 I2C可在所有支持输出的引脚上工作通过machine.SoftI2C访问from machine import Pin, SoftI2C i2c SoftI2C(sclPin(5), sdaPin(4), freq100_000) i2c.scan() # 扫描总线上的设备 i2c.readfrom(0x3a, 4) # 从地址 0x3a 的设备读 4 字节 i2c.writeto(0x3a, 12) # 向地址 0x3a 的设备写 12 buf bytearray(10) # 创建 10 字节缓冲区 i2c.writeto(0x3a, buf) # 将缓冲区写入外设硬件 I2C通过machine.I2C访问方法同软件 I2Cfrom machine import Pin, I2C i2c I2C(0) # 默认分配sclPin(9), sdaPin(8) i2c I2C(1, sclPin(3), sdaPin(2), freq400_000)3.7 I2S 音频总线I2S 支持两个总线id0与id1当前作为Technical Preview技术预览提供API 可能在预览期后调整。注意ws引脚号必须比sck引脚号大 1from machine import I2S, Pin i2s I2S(0, sckPin(16), wsPin(17), sdPin(18), modeI2S.TX, bits16, formatI2S.STEREO, rate44100, ibuf40000) # 创建 I2S 发送对象 i2s.write(buf) # 将音频采样缓冲区写入 I2S 设备 i2s I2S(1, sckPin(0), wsPin(1), sdPin(2), modeI2S.RX, bits16, formatI2S.MONO, rate22050, ibuf40000) # 创建 I2S 接收对象 i2s.readinto(buf) # 从 I2S 设备读取音频采样到缓冲区3.8 RTC 实时时钟from machine import RTC rtc RTC() rtc.datetime((2017, 8, 23, 2, 12, 48, 0, 0)) # 设置具体日期与时间如 2017/8/23 1:12:48 rtc.datetime() # 获取日期与时间3.9 WDT 看门狗RP2040 的看门狗是一个递减计数器计数归零时重启芯片部分电路from machine import WDT # 使能 WDT超时 5s最小 1s wdt WDT(timeout5000) wdt.feed()3.10 OneWire 总线驱动OneWire 驱动为软件实现可在所有引脚上工作from machine import Pin import onewire ow onewire.OneWire(Pin(12)) # 在 GPIO12 上创建 OneWire 总线 ow.scan() # 返回总线上的设备列表 ow.reset() # 复位总线 ow.readbyte() # 读一个字节 ow.writebyte(0x12) # 在总线上写一个字节 ow.write(123) # 在总线上写多个字节 ow.select_rom(b12345678) # 通过 ROM 码选择指定设备DS18S20 / DS18B20 温度传感器有专用驱动import time, ds18x20 ds ds18x20.DS18X20(ow) roms ds.scan() ds.convert_temp() time.sleep_ms(750) for rom in roms: print(ds.read_temp(rom))注意数据线上必须接4.7k 上拉电阻且每次采样温度前都要调用convert_temp()方法。3.11 NeoPixel 与 APA106 灯带驱动from machine import Pin from neopixel import NeoPixel pin Pin(0, Pin.OUT) # 将 GPIO0 设为输出来驱动 NeoPixels np NeoPixel(pin, 8) # 在 GPIO0 上为 8 个像素创建 NeoPixel 驱动 np[0] (255, 255, 255) # 将第一个像素设为白色 np.write() # 将数据写入所有像素 r, g, b np[0] # 读取第一个像素颜色APA106 驱动继承 NeoPixel但内部使用不同的颜色顺序from apa106 import APA106 ap APA106(pin, 8) r, g, b ap[0]APA102DotStar因多了一个时钟引脚需要使用不同的驱动。四、PIO 可编程 IO原理与九条指令对于没有硬件外设支持、或需要自定义 I/O 行为的协议RP2040 提供PIOProgrammable Input Output可编程输入输出。传统的bit banging位拆技术通过 CPU 快速翻转引脚来发送数据会让 CPU 忙于位操作而无法执行其他逻辑而 PIO 允许位操作在后台完成CPU 可以同时执行主任务。4.1 硬件结构除两个 Cortex-M0 核心外RP2040 还有2 个 PIO 块每块含 4 个独立状态机共 8 个状态机。状态机通过FIFO先入先出缓冲区与外部交换数据使状态机与主处理器既能独立工作又能同步数据。每个 FIFO 含4 个 32 位字并可链接 DMA 以传输更大数据量。所有 PIO 指令遵循统一模式.side(...)侧置与[...]延时均可选允许一条指令执行多个操作让 PIO 程序保持短小而高效instruction .side(side_set_value) [delay_value]4.2 九条核心指令与修饰符、伪指令九条指令及其职责指令功能jmp()将控制流转到程序其他位置wait()暂停直至特定动作发生in_()将位从源暂存寄存器或引脚组移入输入移位寄存器ISRout()将位从输出移位寄存器OSR移出到目标push()将数据送入 RX FIFOpull()从 TX FIFO 接收数据mov()将数据从源移动到目标irq()设置或清除 IRQ 标志set()向目标写入立即数指令修饰符.side()在指令开始时设置侧置side-set引脚[]指令执行后延时一定周期数汇编伪指令directiveswrap_target()指定程序循环回绕后继续执行的位置wrap()指定程序控制流发生回绕的指令位置label()为jmp()指令设置标签word()在程序中发射一条原始的 16 位值作为指令4.3asm_pio装饰器与程序初始化参数用rp2.asm_pio()装饰 Python 函数即可编写 PIO 汇编例程使用 Python 语法支持标准 Python 变量与算术运算。其关键参数控制 GPIO 引脚初始状态与移位/阈值行为out_init配置out()指令所用引脚的初始状态set_init配置set()指令所用引脚最多 5 个sideset_init配置侧置引脚最多 5 个。取值可为PIO.IN_LOW、PIO.IN_HIGH、PIO.OUT_LOW、PIO.OUT_HIGH多引脚时传元组如out_init(PIO.OUT_LOW, PIO.OUT_LOW)in_shiftdir/out_shiftdirISR / OSR 默认移位方向取PIO.SHIFT_LEFT或PIO.SHIFT_RIGHTpush_thresh/pull_thresh触发自动推入 / 拉出的位数阈值autopush/autopull是否启用自动推入 / 自动拉出fifo_join是否将 4 字的 TX/RX FIFO 合并为单向 8 字 FIFO取值PIO.JOIN_NONE、PIO.JOIN_RX、PIO.JOIN_TX。以上移位方向与阈值参数在默认设置下也可通过StateMachine.init()覆盖。4.4rp2.StateMachine类状态机运行控制PIO 程序通过rp2.StateMachine实例运行RP2040 共 8 个编号 0~7。关键方法与参数StateMachine(id, [program, ...])获取编号为id的状态机可选配程序StateMachine.init(program, freq-1, *, in_baseNone, out_baseNone, set_baseNone, jmp_pinNone, sideset_baseNone, ...)配置状态机运行给定程序。程序会加入该 PIO 实例的指令内存若已存在则复用偏移以节省指令内存freq状态机运行频率Hz默认系统时钟频率。时钟分频按system clock frequency / freq计算存在轻微取整误差最小分频是系统时钟的 1/65536即默认 125 MHz 系统时钟下freq最小为1908——要跑更慢需先用machine.freq()降低系统时钟in_base/out_base/set_base/jmp_pin/sideset_base分别指定in()、out()、set()、jmp(pin, ...)与侧置所用基址引脚StateMachine.active([value])获取或设置状态机是否在运行StateMachine.restart()通过SM_RESTART寄存器重启状态机并跳回程序开头清除输入/输出移位计数、ISR 内容、延时计数器、等待 IRQ 状态及停滞的exec()指令StateMachine.exec(instr)用asm_pio_encode将字符串编码后执行单条 PIO 指令如sm.exec(set(0, 1))StateMachine.get(bufNone, shift0)从 RX FIFO 拉取一个字FIFO 空则阻塞返回值先右移shift位StateMachine.put(value, shift0)向 TX FIFO 推入一个字FIFO 满则阻塞值先左移shift位StateMachine.rx_fifo()/StateMachine.tx_fifo()返回 RX / TX FIFO 中当前字数0 表示空可用于在调用get()/put()前检查状态StateMachine.irq(handlerNone, trigger0|1, hardFalse)返回并可选配置该状态机的 IRQ 对象。4.5 各指令的详细语义完整的指令语义供编写 PIO 程序时查阅源自 rp2 模块文档jmp(label)/jmp(cond, label)无条件跳转或按条件跳转。条件包括not_x、not_y寄存器为零时为真、x_dec、y_dec寄存器非零时为真并后自减、x_not_yX≠Y 时为真、pin输入引脚为高时为真、not_osreOSR 未达到阈值、即非空时为真wait(polarity, src, index)阻塞等待引脚或 IRQ 线的高/低电平。polarity为 0 或 1低/高src可为gpio绝对引脚、pin相对in_base的引脚、irqindex为 0~31in_(src, bit_count)从srcpins、x、y、null、isr、osr移入 ISR位数 1~32out(dest, bit_count)从 OSR 移出到destpins、x、y、pindirs、pc、isr、exec位数 1~32push(...)将 ISR 推入 RX FIFO 并清零 ISR。形式有push()、push(block)、push(noblock)、push(iffull)、push(iffull, block)、push(iffull, noblock)。默认blockRX FIFO 满则停驻iffull表示仅当输入移位计数达到阈值时才推入pull(...)从 TX FIFO 拉入 OSR。形式类似pull()、pull(block)、pull(noblock)、pull(ifempty)、pull(ifempty, block)、pull(ifempty, noblock)。默认blockTX FIFO 空则停驻ifempty表示仅当输出移位计数达到阈值时才拉出mov(dest, src)将值从src移到dest。dest可为pins、x、y、exec、pc、isr、osrsrc可为pins、x、y、null、status、isr、osr并可用invert()或reverse()修饰二者不可同时使用irq(index)/irq(mode, index)设置或清除 IRQ 标志。index为 0~7 或rel(0)~rel(7)mode可为block停驻直至标志被其他实体清除、clear清除标志而非设置。相对 IRQ 索引以模 4 加法将状态机 ID 加到 IRQ 索引上IRQ 0~3 对处理器可见4~7 仅在状态机内部使用set(dest, data)向destpins、x、y、pindirs写入值data0~31nop()伪指令汇编为mov(y, y)无副作用.side(value)可作用于任意指令的修饰符控制侧置引脚输出值.delay(value)/[value]延时修饰符指定指令执行后延时的周期数0~31使用侧置引脚时最大值会减小。此外asm_pio_encode(instr, sideset_count, sideset_optFalse)可单独汇编一条 PIO 指令一般建议使用asm_pio()汇编出错时抛出PIOASMError异常。rp2.PIO类则面向高级用法add_program/remove_program/state_machine/irq常规场景优先使用StateMachine。五、实战一PIO 实现 1Hz LED 闪烁与 IRQ 上报仓库在 examples/rp2/pio_1hz.py 提供了该示例PIO 教程 对其做了逐步讲解# Example using PIO to blink an LED and raise an IRQ at 1Hz. import time from machine import Pin import rp2 rp2.asm_pio(set_initrp2.PIO.OUT_LOW) def blink_1hz(): # Cycles: 1 1 6 32 * (30 1) 1000 irq(rel(0)) set(pins, 1) set(x, 31) [5] label(delay_high) nop() [29] jmp(x_dec, delay_high) # Cycles: 1 7 32 * (30 1) 1000 set(pins, 0) set(x, 31) [6] label(delay_low) nop() [29] jmp(x_dec, delay_low) # Create the StateMachine with the blink_1hz program, outputting on Pin(25). sm rp2.StateMachine(0, blink_1hz, freq2000, set_basePin(25)) # Set the IRQ handler to print the millisecond timestamp. sm.irq(lambda p: print(time.ticks_ms())) # Start the StateMachine. sm.active(1)运行原理拆解sm rp2.StateMachine(0, blink_1hz, freq2000, set_basePin(25))创建状态机 0以 2000 Hz 频率运行blink_1hz程序输出接到 Pin(25)Pico 板载 LEDirq(rel(0))在 LED 点亮时抛出与该状态机关联的 IRQ随后sm.irq(lambda p: ...)注册的回调打印毫秒时间戳set(pins, 1)点亮 LEDset(x, 31) [5]将 31 装入寄存器 X 并延时 5 周期nop() [29]等待 30 周期jmp(x_dec, delay_high)只要 X 非零就循环回delay_high标签并后自减。X 初值 31因此跳转 31 次nop() [29]共执行 32 次每次循环还消耗 1 条jmp指令周期set(pins, 0)熄灭 LED再执行 32 次nop() [29]jmp(...)循环未显式指定wrap_target()/wrap()时使用默认值程序执行到底部后回绕到顶部回绕不消耗任何执行周期。整个例程恰好消耗状态机2000 个周期将状态机频率设为 2000 Hz 即可让 LED 以 1 Hz 闪烁。六、实战二PIO 驱动 WS2812 灯带side-set autopull仓库 examples/rp2/pio_ws2812.py 展示了 side-set、自动拉出与 FIFO 数据推送的典型组合# Example using PIO to drive a set of WS2812 LEDs. import array, time from machine import Pin import rp2 # Configure the number of WS2812 LEDs. NUM_LEDS 8 rp2.asm_pio( sideset_initrp2.PIO.OUT_LOW, out_shiftdirrp2.PIO.SHIFT_LEFT, autopullTrue, pull_thresh24, ) def ws2812(): T1 2 T2 5 T3 3 wrap_target() label(bitloop) out(x, 1) .side(0) [T3 - 1] jmp(not_x, do_zero) .side(1) [T1 - 1] jmp(bitloop) .side(1) [T2 - 1] label(do_zero) nop() .side(0) [T2 - 1] wrap() # Create the StateMachine with the ws2812 program, outputting on Pin(22). sm rp2.StateMachine(0, ws2812, freq8_000_000, sideset_basePin(22)) # Start the StateMachine, it will wait for data on its FIFO. sm.active(1) # Display a pattern on the LEDs via an array of LED RGB values. ar array.array(I, [0 for _ in range(NUM_LEDS)]) # Cycle colours. for i in range(4 * NUM_LEDS): for j in range(NUM_LEDS): r j * 100 // (NUM_LEDS - 1) b 100 - j * 100 // (NUM_LEDS - 1) if j ! i % NUM_LEDS: r 3 b 3 ar[j] r 16 | b sm.put(ar, 8) time.sleep_ms(50) # Fade out. for i in range(24): for j in range(NUM_LEDS): ar[j] ar[j] 1 0x7F7F7F sm.put(ar, 8) time.sleep_ms(50)关键点autopullTruepull_thresh24让状态机在 OSR 移位计数达到 24 位阈值时自动从 TX FIFO 拉取新数据.side(1)/.side(0)在每条指令开始时同步翻转侧置引脚以生成 WS2812 的时序脉冲主程序通过sm.put(ar, 8)将 32 位颜色值左移 8 位后推入 FIFO实现纯 Python 侧逐帧刷新 8 颗灯珠。七、更多仓库示例与 TobudOS 中的工程定位examples/rp2 目录还提供了其他可直接运行的参考pio_exec.py演示StateMachine.exec()动态执行单条指令pio_pinchange.py基于wait()指令实现引脚电平变化检测pio_pwm.py用 PIO 状态机生成 PWM 波形pio_uart_rx.py/pio_uart_tx.py用 PIO 状态机实现 UART 收发演示无硬件外设时用 PIO 自建协议栈的思路pwm_fade.py基于machine.PWM的呼吸灯效果。从工程结构看TobudOS 内的 MicroPython 移植位于 components/language/micropython/port其中mpmain.c 将 MicroPython 运行时挂接在 TobudOS 任务上GC 堆通过tos_mmheap_alloc(MP_HEAP_SIZE)8 KB分配栈顶/栈上限取自tos_task_curr_task_get()并在 VFSMICROPY_VFS_TOS挂载/fs后依次执行boot.py与main.py随后进入 REPL 循环mpconfigport.h 中MICROPY_BEGIN_ATOMIC_SECTION()映射到tos_cpu_cpsr_save()/tos_cpu_cpsr_restore()MICROPY_EVENT_POLL_HOOK调用tos_task_delay(1)可见线程调度与临界区保护均复用了 TobudOS 内核原语modules 下提供machine的 Pin/UART/Timer/SPI 实现、utime、网络ESP8266与 VFS 文件系统桥接等模块。可移植性说明RP2040 的 PIO、FIFO 与状态机机制属于树莓派 RP2xxx 芯片特有能力因此rp2模块仅在 rp2 端口可用而machine通用接口Pin/UART/Timer/PWM/ADC/SPI/I2C在 TobudOS 面向其他 MCU 的 MicroPython 移植中也保持一致的 API 约定。当前仓库的 rp2 文档general/quickref/tutorial/library与示例主要面向 Raspberry Pi Pico 开发板其中StateMachine.init()的freq下限、默认 125 MHz 系统时钟等数值均以 RP2040 默认配置为基准。八、小结RP2xxx 端口是 TobudOS 内置 MicroPython 支持中最具特色的移植之一RP2040 凭借双核 Cortex-M0、264 KB SRAM、16 MB 外部 QSPI Flash 扩展、丰富的片上外设以及独创的 PIO 状态机让开发者既能用machine模块快速驱动常见外设又能用rp2模块以汇编级精度实现自定义协议。从 1Hz 闪烁到 WS2812 灯带再到 UART 收发与 PWM 生成仓库内的文档与示例构成了从入门到进阶的完整学习路径。结合 RP2 快速参考、PIO 教程、rp2 模块 API 与 示例代码你可以在 Pico 板上直接复刻上述全部实战内容。赞分享【免费下载链接】TobudOSTobudOS 是面向物联网领域开发的实时操作系统早期版本基于腾讯自研的物联网操作系统TencentOS Tiny2020年由腾讯捐赠到开放原子开源基金会进行孵化2023年正式更名为TobudOSTobudOS具有低功耗低资源占用模块化安全可靠等特点可有效提升物联网终端产品开发效率提供精简的 RTOS 内核内核组件可裁剪可配置可快速移植到多种主流 MCU (如 STM32 全系列) 及模组芯片上。而且基于 RTOS 内核提供了丰富的物联网组件内部集成主流物联网协议栈如 CoAP/MQTT/TLS/DTLS/LoRaWAN/NB-IoT 等可助力物联网终端设备及业务快速接入物联网云平台。项目地址https://gitcode.com/openatomfoundation/TobudOS点击查看免费下载相关推荐MicroPython RP2 端口快速参考Raspberry Pi PicoRP2040/RP2350外设编程速查手册MicroPython RP2 端口快速参考Raspberry Pi PicoRP2040/RP2350外设编程速查手册 本篇技术指南以 MicroPyt嵌入式语言运行时编程语言解释器编译器物联网系统编程FastLED 在 Raspberry Pi RP2xxxRP2040/RP2350平台上的 PIO 驱动架构与实践指南FastLED 在 Raspberry Pi RP2xxxRP2040/RP2350平台上的 PIO 驱动架构与实践指南 FastLED 为 Raspber嵌入式物联网硬件开发驱动开发MicroPython rp2.PIO 类详解RP2040 可编程 I/OPIO接口的进阶用法MicroPython rp2.PIO 类详解RP2040 可编程 I/OPIO接口的进阶用法 本文基于 MicroPython 仓库中 rp2.PIO.嵌入式语言运行时编程语言解释器编译器物联网系统编程上一篇5分钟搞定BepInExUnity游戏插件框架的终极安装与配置指南下一篇web-vitals单元测试指南使用Jest确保性能指标准确性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 【免费下载链接】TobudOSTobudOS 是面向物联网领域开发的实时操作系统早期版本基于腾讯自研的物联网操作系统TencentOS Tiny2020年由腾讯捐赠到开放原子开源基金会进行孵化2023年正式更名为TobudOSTobudOS具有低功耗低资源占用模块化安全可靠等特点可有效提升物联网终端产品开发效率提供精简的 RTOS 内核内核组件可裁剪可配置可快速移植到多种主流 MCU (如 STM32 全系列) 及模组芯片上。而且基于 RTOS 内核提供了丰富的物联网组件内部集成主流物联网协议栈如 CoAP/MQTT/TLS/DTLS/LoRaWAN/NB-IoT 等可助力物联网终端设备及业务快速接入物联网云平台。项目地址https://gitcode.com/openatomfoundation/TobudOS点击查看免费下载本文围绕 TobudOS 仓库内 MicroPython 子系统的 RP2xxx 端口通用说明系统梳理以 Raspberry Pi Pico搭载 RP2040为代表的 RP2xxx 系列芯片的硬件技术规格、外设资源并在此基础上结合仓库内的快速参考文档、PIO 教程、rp2模块 API 文档与可运行示例给出从 REPL 基本操作到 PIO 状态机编程的完整实战方案。读完本文你将掌握 RP2040 的关键参数与片上外设、MicroPython 下 GPIO/UART/PWM/ADC/SPI/I2C 等接口的标准用法以及用 PIO 实现 1Hz 闪烁、WS2812 灯带驱动等经典场景的底层原理。图Raspberry Pi Pico 开发板引脚分布图片来源Raspberry Pi Foundation出自 RP2 快速参考文档一、RP2xxx 端口与 RP2040 芯片概览MicroPython 的 rp2 端口面向树莓派基金会Raspberry Pi Foundation的RP2xxx 系列微控制器其中最具代表性的产品就是搭载RP2040的 Raspberry Pi Pico 开发板。在 TobudOS 仓库中该端口对应的 MicroPython 移植位于 components/language/micropython/port由 KY-zhang-X 于 2022 年贡献并深度集成了 TobudOS 内核特性而 rp2 端口的完整文档体系则位于 components/language/micropython/docs/rp2包括general.rst本文主体、quickref.rst接口速查、tutorial/入门与 PIO 教程以及library/rp2*.rst模块 API。1.1 制造工艺与封装RP2040 采用40 nm 硅工艺制造封装为7×7 mm 的 QFN-56 SMD 封装。这颗芯片不内置 Flash 与 EEPROM复位后由 bootloader 从外部 Flash 或 USB 总线把固件加载到内部 SRAM 中运行因此固件存储与启动链路与常见 MCU 有所不同。1.2 核心与存储规格特性参数CPU双核 ARM Cortex-M0主频 133 MHz可超频至 400 MHz 以上SRAM264 KB分六个独立 bank片上存储无内部 Flash / EEPROM复位后 bootloader 从外部 Flash 或 USB 加载固件至内部 SRAM外部存储QSPI 总线控制器支持最大 16 MB 外部 Flash电源片上可编程 LDO 生成核心电压时钟2 个片上 PLL分别生成 USB 时钟与核心时钟GPIO30 个其中 4 个可选作模拟输入更详细的芯片数据请参考树莓派官方发布的 RP2040 数据手册本仓库文档中给出了官方 datasheet 链接文中不再重复外部地址。1.3 片上外设资源RP2040 提供的外设包括2 个 UART2 个 SPI 控制器2 个 I2C 控制器16 路 PWM 通道1 个 USB 1.1 控制器8 个 PIO 状态机2 个 PIO 块 × 4 个状态机这些外设在 MicroPython 中均通过machine与rp2模块暴露下文的接口速查会逐一演示。二、开发环境与基础操作2.1 REPL 控制台MicroPython REPL 通过USB 串口访问。两个实用技巧Tab 补全帮助快速查看对象拥有的方法粘贴模式Ctrl-E适合将大段 Python 代码一次性粘贴进 REPL。machine模块的基础操作import machine machine.freq() # 获取当前 CPU 频率 machine.freq(240000000) # 将 CPU 频率设置为 240 MHzrp2模块的引入方式import rp2注意默认情况下 REPL over UART 是关闭的如需启用请参阅 RP2 入门教程 中关于 REPL over UART 的说明。2.2 延时与计时使用time模块import time time.sleep(1) # 睡眠 1 秒 time.sleep_ms(500) # 睡眠 500 毫秒 time.sleep_us(10) # 睡眠 10 微秒 start time.ticks_ms() # 获取毫秒计数器 delta time.ticks_diff(time.ticks_ms(), start) # 计算时间差2.3 定时器TimerRP2040 的系统定时器外设提供全局微秒时基并产生中断。当前可使用软件定时器数量不限受内存限制无需指定定时器 id当前支持id-1将使用默认值from machine import Timer tim Timer(period5000, modeTimer.ONE_SHOT, callbacklambda t:print(1)) tim.init(period2000, modeTimer.PERIODIC, callbacklambda t:print(2))三、外设接口快速参考RP2 端口速查以下用法完整继承自 RP2 快速参考文档是 RP2xxx 端口最常被引用的实操清单。3.1 引脚与 GPIO使用machine.Pin类from machine import Pin p0 Pin(0, Pin.OUT) # 在 GPIO0 上创建输出引脚 p0.on() # 将引脚置为 on高电平 p0.off() # 将引脚置为 off低电平 p0.value(1) # 置为高电平 p2 Pin(2, Pin.IN) # 在 GPIO2 上创建输入引脚 print(p2.value()) # 读取电平值0 或 1 p4 Pin(4, Pin.IN, Pin.PULL_UP) # 使能内部上拉电阻 p5 Pin(5, Pin.OUT, value1) # 创建时即置高3.2 UART 串口RP2040 有两个 UARTUART0可映射到 GPIO 0/1、12/13、16/17UART1可映射到 GPIO 4/5、8/9。from machine import UART, Pin uart1 UART(1, baudrate9600, txPin(4), rxPin(5)) uart1.write(hello) # 写 5 字节 uart1.read(5) # 读最多 5 字节3.3 PWM 脉宽调制共有8 个独立通道每个通道有 2 路输出合计 16 路 PWM时钟范围 7 Hz ~ 125 MHzfrom machine import Pin, PWM pwm0 PWM(Pin(0)) # 从引脚创建 PWM 对象 pwm0.freq() # 获取当前频率 pwm0.freq(1000) # 设置频率 pwm0.duty_u16() # 获取当前占空比范围 0-65535 pwm0.duty_u16(200) # 设置占空比范围 0-65535 pwm0.deinit() # 关闭该引脚上的 PWM3.4 ADC 模数转换RP2040 共有5 个 ADC 通道其中 4 个为 12 位 SAR 型 ADCGP26、GP27、GP28、GP29分别对应 ADC0~ADC3Pico 板上 GP29 连接 VSYS。标准 ADC 量程为 0~3.3V。第 5 个通道连接内置温度传感器可用于测温from machine import ADC, Pin adc ADC(Pin(26)) # 在 ADC 引脚上创建 ADC 对象 adc.read_u16() # 读取值0-65535 对应电压 0.0v - 3.3v3.5 SPI 总线软件 SPIbit-banging 实现可在所有引脚上工作通过machine.SoftSPI访问。注意polarity是 SCK 的空闲电平phase0表示在 SCK 第一个边沿采样、phase1表示第二个边沿from machine import Pin, SoftSPI spi SoftSPI(baudrate100_000, polarity1, phase0, sckPin(0), mosiPin(2), misoPin(4)) spi.init(baudrate200000) # 设置波特率 spi.read(10) # 在 MISO 上读 10 字节 spi.read(10, 0xff) # 读 10 字节同时在 MOSI 上输出 0xff buf bytearray(50) # 创建缓冲区 spi.readinto(buf) # 读入给定缓冲区此处读 50 字节 spi.readinto(buf, 0xff) # 读入缓冲区并在 MOSI 上输出 0xff spi.write(b12345) # 在 MOSI 上写 5 字节 buf bytearray(4) # 创建 4 字节缓冲区 spi.write_readinto(b1234, buf) # 写 MOSI 并从 MISO 读入缓冲区 spi.write_readinto(buf, buf) # 将 buf 写到 MOSI并从 MISO 读回 buf警告当前初始化软件 SPI 时sck、mosi、miso三个引脚必须全部指定。硬件 SPIRP2040 有 2 个硬件 SPI 总线通过machine.SPI访问方法与软件 SPI 相同from machine import Pin, SPI spi SPI(1, 10_000_000) # 默认分配sckPin(10), mosiPin(11), misoPin(8) spi SPI(1, 10_000_000, sckPin(14), mosiPin(15), misoPin(12)) spi SPI(0, baudrate80_000_000, polarity0, phase0, bits8, sckPin(6), mosiPin(7), misoPin(4))3.6 I2C 总线软件 I2C可在所有支持输出的引脚上工作通过machine.SoftI2C访问from machine import Pin, SoftI2C i2c SoftI2C(sclPin(5), sdaPin(4), freq100_000) i2c.scan() # 扫描总线上的设备 i2c.readfrom(0x3a, 4) # 从地址 0x3a 的设备读 4 字节 i2c.writeto(0x3a, 12) # 向地址 0x3a 的设备写 12 buf bytearray(10) # 创建 10 字节缓冲区 i2c.writeto(0x3a, buf) # 将缓冲区写入外设硬件 I2C通过machine.I2C访问方法同软件 I2Cfrom machine import Pin, I2C i2c I2C(0) # 默认分配sclPin(9), sdaPin(8) i2c I2C(1, sclPin(3), sdaPin(2), freq400_000)3.7 I2S 音频总线I2S 支持两个总线id0与id1当前作为Technical Preview技术预览提供API 可能在预览期后调整。注意ws引脚号必须比sck引脚号大 1from machine import I2S, Pin i2s I2S(0, sckPin(16), wsPin(17), sdPin(18), modeI2S.TX, bits16, formatI2S.STEREO, rate44100, ibuf40000) # 创建 I2S 发送对象 i2s.write(buf) # 将音频采样缓冲区写入 I2S 设备 i2s I2S(1, sckPin(0), wsPin(1), sdPin(2), modeI2S.RX, bits16, formatI2S.MONO, rate22050, ibuf40000) # 创建 I2S 接收对象 i2s.readinto(buf) # 从 I2S 设备读取音频采样到缓冲区3.8 RTC 实时时钟from machine import RTC rtc RTC() rtc.datetime((2017, 8, 23, 2, 12, 48, 0, 0)) # 设置具体日期与时间如 2017/8/23 1:12:48 rtc.datetime() # 获取日期与时间3.9 WDT 看门狗RP2040 的看门狗是一个递减计数器计数归零时重启芯片部分电路from machine import WDT # 使能 WDT超时 5s最小 1s wdt WDT(timeout5000) wdt.feed()3.10 OneWire 总线驱动OneWire 驱动为软件实现可在所有引脚上工作from machine import Pin import onewire ow onewire.OneWire(Pin(12)) # 在 GPIO12 上创建 OneWire 总线 ow.scan() # 返回总线上的设备列表 ow.reset() # 复位总线 ow.readbyte() # 读一个字节 ow.writebyte(0x12) # 在总线上写一个字节 ow.write(123) # 在总线上写多个字节 ow.select_rom(b12345678) # 通过 ROM 码选择指定设备DS18S20 / DS18B20 温度传感器有专用驱动import time, ds18x20 ds ds18x20.DS18X20(ow) roms ds.scan() ds.convert_temp() time.sleep_ms(750) for rom in roms: print(ds.read_temp(rom))注意数据线上必须接4.7k 上拉电阻且每次采样温度前都要调用convert_temp()方法。3.11 NeoPixel 与 APA106 灯带驱动from machine import Pin from neopixel import NeoPixel pin Pin(0, Pin.OUT) # 将 GPIO0 设为输出来驱动 NeoPixels np NeoPixel(pin, 8) # 在 GPIO0 上为 8 个像素创建 NeoPixel 驱动 np[0] (255, 255, 255) # 将第一个像素设为白色 np.write() # 将数据写入所有像素 r, g, b np[0] # 读取第一个像素颜色APA106 驱动继承 NeoPixel但内部使用不同的颜色顺序from apa106 import APA106 ap APA106(pin, 8) r, g, b ap[0]APA102DotStar因多了一个时钟引脚需要使用不同的驱动。四、PIO 可编程 IO原理与九条指令对于没有硬件外设支持、或需要自定义 I/O 行为的协议RP2040 提供PIOProgrammable Input Output可编程输入输出。传统的bit banging位拆技术通过 CPU 快速翻转引脚来发送数据会让 CPU 忙于位操作而无法执行其他逻辑而 PIO 允许位操作在后台完成CPU 可以同时执行主任务。4.1 硬件结构除两个 Cortex-M0 核心外RP2040 还有2 个 PIO 块每块含 4 个独立状态机共 8 个状态机。状态机通过FIFO先入先出缓冲区与外部交换数据使状态机与主处理器既能独立工作又能同步数据。每个 FIFO 含4 个 32 位字并可链接 DMA 以传输更大数据量。所有 PIO 指令遵循统一模式.side(...)侧置与[...]延时均可选允许一条指令执行多个操作让 PIO 程序保持短小而高效instruction .side(side_set_value) [delay_value]4.2 九条核心指令与修饰符、伪指令九条指令及其职责指令功能jmp()将控制流转到程序其他位置wait()暂停直至特定动作发生in_()将位从源暂存寄存器或引脚组移入输入移位寄存器ISRout()将位从输出移位寄存器OSR移出到目标push()将数据送入 RX FIFOpull()从 TX FIFO 接收数据mov()将数据从源移动到目标irq()设置或清除 IRQ 标志set()向目标写入立即数指令修饰符.side()在指令开始时设置侧置side-set引脚[]指令执行后延时一定周期数汇编伪指令directiveswrap_target()指定程序循环回绕后继续执行的位置wrap()指定程序控制流发生回绕的指令位置label()为jmp()指令设置标签word()在程序中发射一条原始的 16 位值作为指令4.3asm_pio装饰器与程序初始化参数用rp2.asm_pio()装饰 Python 函数即可编写 PIO 汇编例程使用 Python 语法支持标准 Python 变量与算术运算。其关键参数控制 GPIO 引脚初始状态与移位/阈值行为out_init配置out()指令所用引脚的初始状态set_init配置set()指令所用引脚最多 5 个sideset_init配置侧置引脚最多 5 个。取值可为PIO.IN_LOW、PIO.IN_HIGH、PIO.OUT_LOW、PIO.OUT_HIGH多引脚时传元组如out_init(PIO.OUT_LOW, PIO.OUT_LOW)in_shiftdir/out_shiftdirISR / OSR 默认移位方向取PIO.SHIFT_LEFT或PIO.SHIFT_RIGHTpush_thresh/pull_thresh触发自动推入 / 拉出的位数阈值autopush/autopull是否启用自动推入 / 自动拉出fifo_join是否将 4 字的 TX/RX FIFO 合并为单向 8 字 FIFO取值PIO.JOIN_NONE、PIO.JOIN_RX、PIO.JOIN_TX。以上移位方向与阈值参数在默认设置下也可通过StateMachine.init()覆盖。4.4rp2.StateMachine类状态机运行控制PIO 程序通过rp2.StateMachine实例运行RP2040 共 8 个编号 0~7。关键方法与参数StateMachine(id, [program, ...])获取编号为id的状态机可选配程序StateMachine.init(program, freq-1, *, in_baseNone, out_baseNone, set_baseNone, jmp_pinNone, sideset_baseNone, ...)配置状态机运行给定程序。程序会加入该 PIO 实例的指令内存若已存在则复用偏移以节省指令内存freq状态机运行频率Hz默认系统时钟频率。时钟分频按system clock frequency / freq计算存在轻微取整误差最小分频是系统时钟的 1/65536即默认 125 MHz 系统时钟下freq最小为1908——要跑更慢需先用machine.freq()降低系统时钟in_base/out_base/set_base/jmp_pin/sideset_base分别指定in()、out()、set()、jmp(pin, ...)与侧置所用基址引脚StateMachine.active([value])获取或设置状态机是否在运行StateMachine.restart()通过SM_RESTART寄存器重启状态机并跳回程序开头清除输入/输出移位计数、ISR 内容、延时计数器、等待 IRQ 状态及停滞的exec()指令StateMachine.exec(instr)用asm_pio_encode将字符串编码后执行单条 PIO 指令如sm.exec(set(0, 1))StateMachine.get(bufNone, shift0)从 RX FIFO 拉取一个字FIFO 空则阻塞返回值先右移shift位StateMachine.put(value, shift0)向 TX FIFO 推入一个字FIFO 满则阻塞值先左移shift位StateMachine.rx_fifo()/StateMachine.tx_fifo()返回 RX / TX FIFO 中当前字数0 表示空可用于在调用get()/put()前检查状态StateMachine.irq(handlerNone, trigger0|1, hardFalse)返回并可选配置该状态机的 IRQ 对象。4.5 各指令的详细语义完整的指令语义供编写 PIO 程序时查阅源自 rp2 模块文档jmp(label)/jmp(cond, label)无条件跳转或按条件跳转。条件包括not_x、not_y寄存器为零时为真、x_dec、y_dec寄存器非零时为真并后自减、x_not_yX≠Y 时为真、pin输入引脚为高时为真、not_osreOSR 未达到阈值、即非空时为真wait(polarity, src, index)阻塞等待引脚或 IRQ 线的高/低电平。polarity为 0 或 1低/高src可为gpio绝对引脚、pin相对in_base的引脚、irqindex为 0~31in_(src, bit_count)从srcpins、x、y、null、isr、osr移入 ISR位数 1~32out(dest, bit_count)从 OSR 移出到destpins、x、y、pindirs、pc、isr、exec位数 1~32push(...)将 ISR 推入 RX FIFO 并清零 ISR。形式有push()、push(block)、push(noblock)、push(iffull)、push(iffull, block)、push(iffull, noblock)。默认blockRX FIFO 满则停驻iffull表示仅当输入移位计数达到阈值时才推入pull(...)从 TX FIFO 拉入 OSR。形式类似pull()、pull(block)、pull(noblock)、pull(ifempty)、pull(ifempty, block)、pull(ifempty, noblock)。默认blockTX FIFO 空则停驻ifempty表示仅当输出移位计数达到阈值时才拉出mov(dest, src)将值从src移到dest。dest可为pins、x、y、exec、pc、isr、osrsrc可为pins、x、y、null、status、isr、osr并可用invert()或reverse()修饰二者不可同时使用irq(index)/irq(mode, index)设置或清除 IRQ 标志。index为 0~7 或rel(0)~rel(7)mode可为block停驻直至标志被其他实体清除、clear清除标志而非设置。相对 IRQ 索引以模 4 加法将状态机 ID 加到 IRQ 索引上IRQ 0~3 对处理器可见4~7 仅在状态机内部使用set(dest, data)向destpins、x、y、pindirs写入值data0~31nop()伪指令汇编为mov(y, y)无副作用.side(value)可作用于任意指令的修饰符控制侧置引脚输出值.delay(value)/[value]延时修饰符指定指令执行后延时的周期数0~31使用侧置引脚时最大值会减小。此外asm_pio_encode(instr, sideset_count, sideset_optFalse)可单独汇编一条 PIO 指令一般建议使用asm_pio()汇编出错时抛出PIOASMError异常。rp2.PIO类则面向高级用法add_program/remove_program/state_machine/irq常规场景优先使用StateMachine。五、实战一PIO 实现 1Hz LED 闪烁与 IRQ 上报仓库在 examples/rp2/pio_1hz.py 提供了该示例PIO 教程 对其做了逐步讲解# Example using PIO to blink an LED and raise an IRQ at 1Hz. import time from machine import Pin import rp2 rp2.asm_pio(set_initrp2.PIO.OUT_LOW) def blink_1hz(): # Cycles: 1 1 6 32 * (30 1) 1000 irq(rel(0)) set(pins, 1) set(x, 31) [5] label(delay_high) nop() [29] jmp(x_dec, delay_high) # Cycles: 1 7 32 * (30 1) 1000 set(pins, 0) set(x, 31) [6] label(delay_low) nop() [29] jmp(x_dec, delay_low) # Create the StateMachine with the blink_1hz program, outputting on Pin(25). sm rp2.StateMachine(0, blink_1hz, freq2000, set_basePin(25)) # Set the IRQ handler to print the millisecond timestamp. sm.irq(lambda p: print(time.ticks_ms())) # Start the StateMachine. sm.active(1)运行原理拆解sm rp2.StateMachine(0, blink_1hz, freq2000, set_basePin(25))创建状态机 0以 2000 Hz 频率运行blink_1hz程序输出接到 Pin(25)Pico 板载 LEDirq(rel(0))在 LED 点亮时抛出与该状态机关联的 IRQ随后sm.irq(lambda p: ...)注册的回调打印毫秒时间戳set(pins, 1)点亮 LEDset(x, 31) [5]将 31 装入寄存器 X 并延时 5 周期nop() [29]等待 30 周期jmp(x_dec, delay_high)只要 X 非零就循环回delay_high标签并后自减。X 初值 31因此跳转 31 次nop() [29]共执行 32 次每次循环还消耗 1 条jmp指令周期set(pins, 0)熄灭 LED再执行 32 次nop() [29]jmp(...)循环未显式指定wrap_target()/wrap()时使用默认值程序执行到底部后回绕到顶部回绕不消耗任何执行周期。整个例程恰好消耗状态机2000 个周期将状态机频率设为 2000 Hz 即可让 LED 以 1 Hz 闪烁。六、实战二PIO 驱动 WS2812 灯带side-set autopull仓库 examples/rp2/pio_ws2812.py 展示了 side-set、自动拉出与 FIFO 数据推送的典型组合# Example using PIO to drive a set of WS2812 LEDs. import array, time from machine import Pin import rp2 # Configure the number of WS2812 LEDs. NUM_LEDS 8 rp2.asm_pio( sideset_initrp2.PIO.OUT_LOW, out_shiftdirrp2.PIO.SHIFT_LEFT, autopullTrue, pull_thresh24, ) def ws2812(): T1 2 T2 5 T3 3 wrap_target() label(bitloop) out(x, 1) .side(0) [T3 - 1] jmp(not_x, do_zero) .side(1) [T1 - 1] jmp(bitloop) .side(1) [T2 - 1] label(do_zero) nop() .side(0) [T2 - 1] wrap() # Create the StateMachine with the ws2812 program, outputting on Pin(22). sm rp2.StateMachine(0, ws2812, freq8_000_000, sideset_basePin(22)) # Start the StateMachine, it will wait for data on its FIFO. sm.active(1) # Display a pattern on the LEDs via an array of LED RGB values. ar array.array(I, [0 for _ in range(NUM_LEDS)]) # Cycle colours. for i in range(4 * NUM_LEDS): for j in range(NUM_LEDS): r j * 100 // (NUM_LEDS - 1) b 100 - j * 100 // (NUM_LEDS - 1) if j ! i % NUM_LEDS: r 3 b 3 ar[j] r 16 | b sm.put(ar, 8) time.sleep_ms(50) # Fade out. for i in range(24): for j in range(NUM_LEDS): ar[j] ar[j] 1 0x7F7F7F sm.put(ar, 8) time.sleep_ms(50)关键点autopullTruepull_thresh24让状态机在 OSR 移位计数达到 24 位阈值时自动从 TX FIFO 拉取新数据.side(1)/.side(0)在每条指令开始时同步翻转侧置引脚以生成 WS2812 的时序脉冲主程序通过sm.put(ar, 8)将 32 位颜色值左移 8 位后推入 FIFO实现纯 Python 侧逐帧刷新 8 颗灯珠。七、更多仓库示例与 TobudOS 中的工程定位examples/rp2 目录还提供了其他可直接运行的参考pio_exec.py演示StateMachine.exec()动态执行单条指令pio_pinchange.py基于wait()指令实现引脚电平变化检测pio_pwm.py用 PIO 状态机生成 PWM 波形pio_uart_rx.py/pio_uart_tx.py用 PIO 状态机实现 UART 收发演示无硬件外设时用 PIO 自建协议栈的思路pwm_fade.py基于machine.PWM的呼吸灯效果。从工程结构看TobudOS 内的 MicroPython 移植位于 components/language/micropython/port其中mpmain.c 将 MicroPython 运行时挂接在 TobudOS 任务上GC 堆通过tos_mmheap_alloc(MP_HEAP_SIZE)8 KB分配栈顶/栈上限取自tos_task_curr_task_get()并在 VFSMICROPY_VFS_TOS挂载/fs后依次执行boot.py与main.py随后进入 REPL 循环mpconfigport.h 中MICROPY_BEGIN_ATOMIC_SECTION()映射到tos_cpu_cpsr_save()/tos_cpu_cpsr_restore()MICROPY_EVENT_POLL_HOOK调用tos_task_delay(1)可见线程调度与临界区保护均复用了 TobudOS 内核原语modules 下提供machine的 Pin/UART/Timer/SPI 实现、utime、网络ESP8266与 VFS 文件系统桥接等模块。可移植性说明RP2040 的 PIO、FIFO 与状态机机制属于树莓派 RP2xxx 芯片特有能力因此rp2模块仅在 rp2 端口可用而machine通用接口Pin/UART/Timer/PWM/ADC/SPI/I2C在 TobudOS 面向其他 MCU 的 MicroPython 移植中也保持一致的 API 约定。当前仓库的 rp2 文档general/quickref/tutorial/library与示例主要面向 Raspberry Pi Pico 开发板其中StateMachine.init()的freq下限、默认 125 MHz 系统时钟等数值均以 RP2040 默认配置为基准。八、小结RP2xxx 端口是 TobudOS 内置 MicroPython 支持中最具特色的移植之一RP2040 凭借双核 Cortex-M0、264 KB SRAM、16 MB 外部 QSPI Flash 扩展、丰富的片上外设以及独创的 PIO 状态机让开发者既能用machine模块快速驱动常见外设又能用rp2模块以汇编级精度实现自定义协议。从 1Hz 闪烁到 WS2812 灯带再到 UART 收发与 PWM 生成仓库内的文档与示例构成了从入门到进阶的完整学习路径。结合 RP2 快速参考、PIO 教程、rp2 模块 API 与 示例代码你可以在 Pico 板上直接复刻上述全部实战内容。赞分享【免费下载链接】TobudOSTobudOS 是面向物联网领域开发的实时操作系统早期版本基于腾讯自研的物联网操作系统TencentOS Tiny2020年由腾讯捐赠到开放原子开源基金会进行孵化2023年正式更名为TobudOSTobudOS具有低功耗低资源占用模块化安全可靠等特点可有效提升物联网终端产品开发效率提供精简的 RTOS 内核内核组件可裁剪可配置可快速移植到多种主流 MCU (如 STM32 全系列) 及模组芯片上。而且基于 RTOS 内核提供了丰富的物联网组件内部集成主流物联网协议栈如 CoAP/MQTT/TLS/DTLS/LoRaWAN/NB-IoT 等可助力物联网终端设备及业务快速接入物联网云平台。项目地址https://gitcode.com/openatomfoundation/TobudOS点击查看免费下载相关推荐MicroPython RP2 端口快速参考Raspberry Pi PicoRP2040/RP2350外设编程速查手册MicroPython RP2 端口快速参考Raspberry Pi PicoRP2040/RP2350外设编程速查手册 本篇技术指南以 MicroPyt嵌入式语言运行时编程语言解释器编译器物联网系统编程FastLED 在 Raspberry Pi RP2xxxRP2040/RP2350平台上的 PIO 驱动架构与实践指南FastLED 在 Raspberry Pi RP2xxxRP2040/RP2350平台上的 PIO 驱动架构与实践指南 FastLED 为 Raspber嵌入式物联网硬件开发驱动开发MicroPython rp2.PIO 类详解RP2040 可编程 I/OPIO接口的进阶用法MicroPython rp2.PIO 类详解RP2040 可编程 I/OPIO接口的进阶用法 本文基于 MicroPython 仓库中 rp2.PIO.嵌入式语言运行时编程语言解释器编译器物联网系统编程上一篇5分钟搞定BepInExUnity游戏插件框架的终极安装与配置指南下一篇web-vitals单元测试指南使用Jest确保性能指标准确性创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
