RP2040 MicroPython实现UART DMA零CPU干预实战-北京尧图网络

有朋友在群里问RP2040 上跑 MicroPythonUART 能不能做到 DMA 搬运、CPU 彻底撒手我第一反应是能但别指望标准固件会给你现成接口。RP2040 的 DMA 控制器是真的正经外设只是 MicroPython 官方固件默认不暴露 DMA API所以这事得自己动手。这篇内容我会把 RP2040 DMA 的原理、UART 的零 CPU 干预怎么实现、以及我在 MicroPython 固件里加自定义 C 模块的完整过程都拆开讲清楚。适合已经在用 MicroPython 写 Pico 程序、觉得串口收发占 CPU、想用 DMA 又不知道从哪下手的开发者。看完至少能照着方案把最简单的 DMA 串口接收跑起来。1. 为什么要把 UART 交给 DMA1.1 RP2040 的 DMA 控制器到底是什么水平很多人一听“单片机上的 DMA”第一反应是 STM32 那套。实际上 RP2040 的 DMA 配置能力相当完整有 12 个独立通道每个通道都可以单独设置源地址、目的地址、传输计数和数据宽度。数据宽度支持 8 位、16 位、32 位也就是字节、半字、字三种粒度。它还能配置地址递增方式可以固定源地址、递增目的地址也可以反过来。最关键的一点是RP2040 的 DMA 请求可以由外设直接触发。UART、SPI、I2C、ADC、PIO 状态机这些外设都会产生 DREQ 信号DMA 收到 DREQ 才搬一次数据。这就意味着 DMA 不需要 CPU 干预也不需要 CPU 用定时器去“猜”外设什么时候有数据。只要外设准备好了硬件就会自动完成一次搬运。另外RP2040 DMA 还支持通道链式触发一个通道完成后可以自动触发另一个通道配合双缓冲、多段数据搬运很方便。它这个链式机制不是部分高端芯片那种完整的内存描述符链表但已经足够应付绝大多数嵌入式场景。对 UART 来说我们通常只关心三个东西源地址、目的地址、传输计数再配一个 DREQ 触发源剩下交给硬件就行。1.2 传统 UART 收发为什么费 CPU先算一笔账。串口 115200 波特率、8N1 格式每字节实际占用 10 bit那么 1 秒最多传输 11520 字节。如果用最简单的每字节触发一次中断中断频率就是每秒 11520 次。 RP2040 主频 133MHz处理一次中断压栈、进中断服务函数、读 FIFO、清标志、再恢复现场时间虽然很短但高负载下还是会影响主循环。如果同时开两三个串口或者在一个中断里去解析数据协议主循环的实时性就会下降。发送侧也一样。你要把一个 1KB 的 buffer 发出去传统写法是一个字节一个字节往 UART 的 TX FIFO 写。就算 FIFO 能缓存一部分数据中间也免不了判断 FIFO 是否满、是否需要等。这些操作本身不复杂但频率一高就会碎片化占用 CPU。DMA 的思路是把“搬数据”这件事完全交给硬件。发送时CPU 只需要设置 DMA 把内存数据搬进 UART 的发送 FIFO发完后 DMA 产生一次中断接收时DMA 自动把 RX FIFO 里的数据搬进内存收到预定长度后产生一次中断。整个传输过程中CPU 不参与逐字节搬运所以叫“零 CPU 干预”。注意这个零不是绝对意义上的 CPU 完全休眠而是没有逐字节参与最后该有的完成中断还是会有。1.3 MicroPython 在这件事上的特殊尴尬MicroPython 的问题在于官方 RP2040 固件把 DMA 藏得很深。你打开machine.UART的源码能看到它内部其实用了 Pico SDK 的底层驱动但上层暴露给你的只有read()、write()、any()这些方法。这些方法内部处理了中断和缓冲区对用户看起来确实“好用”但 CPU 并不是零负担。还有不少人尝试用machine.mem32直接操作 DMA 寄存器。这个思路很直接RP2040 的寄存器地址都是公开的理论上你可以用 Python 把 DMA 通道配置出来。但实际跑起来会发现几个问题一是 Python 解释执行寄存器操作太慢配置十几个寄存器可能就要几百微秒二是你没法在 DMA 中断服务函数里稳定地跑 Python 回调稍不留神就会死机或者漏数据。所以要玩真正的 DMA最靠谱的路线不是硬用纯 Python 去操作寄存器而是给 MicroPython 编译一个自定义 C 扩展模块把 DMA 能力封装成几个 Python 函数。后面我会详细讲这条路。2. 零 CPU 数据传输的方案选型与原理拆解2.1 方案一C SDK 直接写不绕弯如果项目没有“必须用 MicroPython”这个限制那最正统的方案当然是直接用 C 写Pico SDK 提供了完整的 DMA API。接收流程大概是这样的int ch dma_channel_claim_unused(true); dma_channel_config c dma_channel_get_default_config(ch); channel_config_set_transfer_data_size(c, DMA_SIZE_8); channel_config_set_read_increment(c, false); channel_config_set_write_increment(c, true); channel_config_set_dreq(c, DREQ_UART0_RX); uint8_t buf[256]; dma_channel_configure(ch, c, buf, // 目的地址内存 uart_get_hw(uart0)-dr, // 源地址UART 数据寄存器 256, // 传输计数 true); // 立即启动这段 C 代码做的事非常清晰DMA 通道源地址固定指向 UART0 的 DR 寄存器目的地址递增指向内存传输 256 字节每传一个字节就通过DREQ_UART0_RX等待 UART 收到新数据。完成后你可以自己写一个 DMA 中断服务函数置一个标志位让主循环去处理数据。用 C SDK 写这个问题不大但很多人就是不想放弃 MicroPython因为业务逻辑用 Python 写实在是太快了。所以如果既要 MicroPython又要 DMA那就得走下面的方案二。2.2 方案二给 MicroPython 编译 dma_uart 扩展模块MicroPython 允许你在固件里加入 C 扩展模块然后把模块里的函数注册成 Python 的 import 对象。比如我们可以做一个dma_uart模块提供start()、done()、received()这几个方法底层直接用 Pico SDK 的 DMA API上层 Python 代码只管调用。这个方案的原理并不复杂。MicroPython 本质上是一个 C 程序它执行 Python 字节码同时也能调用编译进固件的 C 函数。我们写一个 C 文件把 DMA 初始化和中断处理封装好再用 MicroPython 的模块注册机制挂到系统里。编译固件之后Python 里import dma_uart就能找到这个模块。好处是DMA 的实时性要求由 C 代码保证Python 侧不需要高频操作寄存器而业务逻辑、协议解析、UI 交互这些不要求实时的部分还是可以继续用 Python。坏处是你需要花点时间搭一套交叉编译环境第一次编译固件会有点折腾。2.3 方案三PIO 状态机不是 DMA聊到 RP2040总有人会问“能不能用 PIO 替代 DMA”。PIO 是 RP2040 独有的一组可编程 IO 状态机可以自己编指令模拟 UART、SPI、I2C、WS2812 这类协议。它的灵活性确实很高但它和 DMA 解决的问题不一样。PIO 状态机有自己的 RX/TX FIFO数据会流进状态机的 FIFO但把 FIFO 里的数据搬到内存仍然需要 CPU 或者 DMA。也就是说PIO 解决了“如何按协议收发”的问题DMA 解决了“如何不经过 CPU 搬数据”的问题。 MicroPython 的rp2.PIO类能让你加载 PIO 程序但不会直接给你一个“让 PIO FIFO 自动搬到 buffer”的高层接口。大多数情况下你还是要通过 PIO 中断或轮询去读取数据CPU 并没有真正解放。如果你的目标是 UART 零 CPU 干预那就老老实实用硬件 UART 加 DMA别在 PIO 上绕圈子。2.4 选型结论把三个方案放一起对比一下方案CPU 占用实现难度适合场景C SDK 直接写极低中纯 C 工程需要最高性能MicroPython 自定义 DMA 模块极低较高想用 Python 写业务又需要 DMAMicroPython 纯 Python 操作寄存器高高不建议只适合学习寄存器原理我自己的建议是如果只是 9600 波特率收发几字节传感器数据machine.UART那点 CPU 开销根本不用在意但如果你要跑 115200 甚至更高波特率还要连续收发大块数据或者主循环同时要处理显示、网络、按键那 DMA 模块就值得折腾。3. 实操过程手写一个 dma_uart 模块并跑通3.1 准备编译环境第一步是准备编译 MicroPython 固件的环境。这里以 Linux 环境为例Windows 用 WSL 也可以。你需要装这几样sudo apt update sudo apt install gcc-arm-none-eabi cmake ninja-build git python3然后拉取 MicroPython 源码并编译交叉编译器git clone https://github.com/micropython/micropython.git cd micropython make -C mpy-cross make -C ports/rp2 submodules第一次编译 RP2040 的固件会拉取 Pico SDK 等子模块时间取决于网络。全部准备好之后先编译一次官方固件验证环境make -C ports/rp2 BOARDPICO如果能在ports/rp2/build-PICO/firmware.uf2看到输出说明环境没问题。之后我们把自定义模块加进去重新编译就行。3.2 把自定义模块塞进固件MicroPython 的 RP2040 端口支持通过 CMake 把你自己的 C 模块编译进固件。我习惯在ports/rp2下新建一个dma_uart目录里面放dma_uart.c和一个micropython.cmake文件。micropython.cmake的内容很简单add_library(dma_uart_module INTERFACE) target_sources(dma_uart_module INTERFACE ${CMAKE_CURRENT_LIST_DIR}/dma_uart.c ) target_include_directories(dma_uart_module INTERFACE ${CMAKE_CURRENT_LIST_DIR}) target_link_libraries(usermod INTERFACE dma_uart_module)然后在ports/rp2的micropython.cmake文件里加一行include把你这个子文件引进来。不同 MicroPython 版本引入用户模块的方式稍有差异我写这篇文章对应的是当前比较新的版本用的是MP_REGISTER_MODULE注册方式。如果你是旧版本可能需要去mpconfigport.h里手动加模块声明具体看官方文档里cmodules.rst的说明。3.3 C 核心代码下面是我用的核心代码做了简化重点是说明 DMA 配置思路。这个模块目前只支持 UART0 的 RX DMA 接收你完全可以照着扩展成发送或者双通道版本。#include py/runtime.h #include hardware/dma.h #include hardware/uart.h #include pico/stdlib.h typedef struct _dma_uart_obj_t { mp_obj_base_t base; mp_obj_t buf_obj; // 保存 Python 端 buffer 引用防止被 GC 回收 uint8_t *buf; size_t len; size_t received; uint channel; bool claimed; volatile bool done; } dma_uart_obj_t; STATIC dma_uart_obj_t dma_uart_obj; static void dma_uart_irq_handler(void) { if (dma_channel_get_irq0_status(dma_uart_obj.channel)) { dma_channel_acknowledge_irq0(dma_uart_obj.channel); dma_uart_obj.received dma_uart_obj.len; dma_uart_obj.done true; } } STATIC mp_obj_t dma_uart_start(mp_obj_t buf_in, mp_obj_t len_in) { mp_buffer_info_t bufinfo; mp_get_buffer_raise(buf_in, bufinfo, MP_BUFFER_WRITE); size_t len mp_obj_get_int(len_in); if (len bufinfo.len) { len bufinfo.len; } if (!dma_uart_obj.claimed) { dma_uart_obj.channel dma_channel_claim_unused(true); dma_uart_obj.claimed true; } dma_uart_obj.buf_obj buf_in; dma_uart_obj.buf (uint8_t *)bufinfo.buf; dma_uart_obj.len len; dma_uart_obj.received 0; dma_uart_obj.done false; dma_channel_config c dma_channel_get_default_config(dma_uart_obj.channel); channel_config_set_transfer_data_size(c, DMA_SIZE_8); channel_config_set_read_increment(c, false); channel_config_set_write_increment(c, true); channel_config_set_dreq(c, DREQ_UART0_RX); dma_channel_configure(dma_uart_obj.channel, c, dma_uart_obj.buf, uart_get_hw(uart0)-dr, dma_uart_obj.len, true); dma_channel_set_irq0_enabled(dma_uart_obj.channel, true); irq_set_exclusive_handler(DMA_IRQ_0, dma_uart_irq_handler); irq_set_enabled(DMA_IRQ_0, true); return mp_const_none; } STATIC MP_DEFINE_CONST_FUN_OBJ_2(dma_uart_start_obj, dma_uart_start); STATIC mp_obj_t dma_uart_done(void) { return mp_obj_new_bool(dma_uart_obj.done); } STATIC MP_DEFINE_CONST_FUN_OBJ_0(dma_uart_done_obj, dma_uart_done); STATIC mp_obj_t dma_uart_received(void) { return mp_obj_new_int(dma_uart_obj.received); } STATIC MP_DEFINE_CONST_FUN_OBJ_0(dma_uart_received_obj, dma_uart_received); STATIC const mp_rom_map_elem_t dma_uart_module_globals_table[] { { MP_ROM_QSTR(MP_QSTR_start), MP_ROM_PTR(dma_uart_start_obj) }, { MP_ROM_QSTR(MP_QSTR_done), MP_ROM_PTR(dma_uart_done_obj) }, { MP_ROM_QSTR(MP_QSTR_received), MP_ROM_PTR(dma_uart_received_obj) }, }; STATIC MP_DEFINE_CONST_DICT(dma_uart_module_globals, dma_uart_module_globals_table); const mp_obj_module_t dma_uart_user_cmodule { .base { mp_type_module }, .globals (mp_obj_dict_t *)dma_uart_module_globals, }; MP_REGISTER_MODULE(MP_QSTR_dma_uart, dma_uart_user_cmodule);这里有几个关键点要解释一下。read_increment必须设置为false因为 UART 的 DR 寄存器地址是固定的DMA 每次读同一个地址就相当于取走 RX FIFO 里的一个字节。write_increment必须设置为true因为我们要把数据连续写入内存。DREQ_UART0_RX是 UART0 接收触发源DMA 只在有数据可读的时候才搬运不会读空 FIFO。中断服务函数里只做三件事确认中断、记录接收长度、把done标志置位。我没有在中断里直接调用 Python 回调因为 MicroPython 的中断环境里直接跑 Python 代码是不安全的容易触发重入或者内存管理问题。用轮询标志位的方式虽然看起来不那么“高级”但在实际工程里非常稳。3.4 MicroPython 脚本里怎么用固件编译烧录好之后Python 脚本就非常简单了。我演示一个 UART0 接收的例子import dma_uart from machine import UART, Pin import time uart UART(0, baudrate115200, txPin(0), rxPin(1)) buf bytearray(256) dma_uart.start(buf, 256) # 等待完成支持 machine.idle() 就优先用 idleDMA 中断会唤醒 CPU while not dma_uart.done(): try: machine.idle() except AttributeError: time.sleep_ms(1) print(received bytes:, dma_uart.received()) print(buf[:dma_uart.received()])如果你的固件支持machine.idle()在等待时 CPU 会进入低功耗模式DMA 完成中断会把它唤醒这样等待期间几乎不耗 CPU。如果确实不支持退而求其次用time.sleep_ms(1)也可以但对实时性要求极高的场景还是建议用 idle。注意一点这个示例默认 PC 会发满 256 字节。如果你的数据是不定长的DMA 传输长度设置成 256数据不够 256 字节时 DMA 永远都不会完成你需要自己加超时判断。这个坑下面会细说。3.5 和普通中断方式的简单对比测试验证是否真的省 CPU可以做一个很朴素的实验让 Pico 循环处理一个等待 DMA 的任务同时在等待期间跑一个纯 Python 计数循环看丢不丢数据。count 0 dma_uart.start(buf, 256) while not dma_uart.done(): count 1 if count % 100000 0: print(still counting, count) print(done, count , count)如果 DMA 配置正常即使主循环一直在做 100000 次计数的大循环UART 数据也不会丢。这就是“零 CPU 负担”最直观的体现。如果用普通uart.read()或者uart.any()循环去收数据主循环根本不可能跑这么重的任务。我做过的实测里115200 波特率下连续发 1KB 数据普通中断模式会出现大量时间碎片主循环任务被频繁打断改用 DMA 后主循环在 DMA 搬运期间可以连续执行其他逻辑只有最后处理数据时才介入一次。4. 常见问题与排查技巧实录4.1 数据错位、丢字节、DMA 不结束先列几个最容易踩的坑。第一源地址配错。DMA 的读地址一定要指向 UART 的 DR 数据寄存器而不是 UART 的外设基地址。在 C 代码里我用的是uart_get_hw(uart0)-dr如果你用machine.mem32或者从旧工程复制代码很可能写成UART0_BASE这种地址数据就会乱。第二read_increment被误设成true。这个错误特别隐蔽因为看起来 DMA 工作正常但每次读数据都会从 UART 寄存器地址递增偏移读到后续寄存器里的随机值。表现就是第一个字节对后面全乱。第三DMA 传输长度大于实际收到的数据量。如果你的协议不是固定帧长比如 PC 只发 10 个字节但 DMA 配置成接收 256 字节DMA 会一直等永远不完成。这种情况必须在应用层做超时处理。Python 侧可以这样做dma_uart.start(buf, 256) deadline time.ticks_ms() 500 while not dma_uart.done(): if time.ticks_diff(deadline, time.ticks_ms()) 0: break if not dma_uart.done(): print(timeout, stale bytes?, dma_uart.received())超时后 DMA 可能已经收了部分数据进 buffer但是done是 false你要根据received()的值决定是否保留这帧数据。如果确实需要取消 DMA最好在 C 模块里加一个abort()函数调用dma_channel_abort。4.2 变长数据怎么判断一帧结束很多从 STM32 转过来的朋友第一个念头就是找“接收空闲中断”。RP2040 的硬件 UART 并没有和 STM32 完全等价的空闲中断所以不能直接照搬那套“DMA 空闲中断接收不定长数据”的代码。我的做法是DMA 负责把数据搬进一个大缓冲区同时用一个 MicroPython 定时器或者主循环里的超时判断来模拟“线路空闲”。每次 DMA 完成一个接收任务就重置计时器如果超过设定时间没有新的 DMA 完成就认为当前帧结束了。整体流程大概是启动 DMA 接收固定最大长度收到数据且 DMA 完成后处理数据并把下一个新 DMA 任务启动如果在两个 DMA 完成之间超过了你设定的帧间隔就判定为帧结束。这种方式不用硬件空闲中断逻辑也直观。4.3 缓存对象被 GC 回收DMA 还在写这是自定义 C 模块最容易翻车的地方。如果你只在 C 模块里保存uint8_t *buf指针不保存 Python 对象的引用那么当 Python 侧的bytearray变量被重新赋值或者跳出作用域之后这块内存可能被 MicroPython 的垃圾回收器回收掉。DMA 这时候还傻乎乎地往那块地址写数据结果就是内存损坏、系统崩溃。所以我上面的 C 代码里专门加了一行dma_uart_obj.buf_obj buf_in;把 Python 传来的 buffer 对象保存在全局结构体里保持一个强引用。只要模块本身不被卸载这个对象就不会被 GC 收走。如果你不想在 C 模块里保存 Python 对象也可以用 C 模块内部静态数组当作 DMA 缓冲区再通过memoryview暴露给 Python这样生命周期完全可控代价是缓冲区大小固定。4.4 DMA 通道冲突与多串口扩展RP2040 有 12 个 DMA 通道看起来很多但 MicroPython 内部可能已经有其他功能在占用。比如某些固件的 USB 驱动、PIO、ADC 都可能用到 DMA只是没有被公开文档写清楚。所以自定义模块不要硬编码通道号应该用dma_channel_claim_unused(true)动态申请。如果你要同时做 UART0 接收、UART1 发送、ADC 连续采样就需要在模块里维护多个 DMA 通道。建议每个功能独占一个通道中断号也可以分开比如通道 0 到 5 用DMA_IRQ_0通道 6 到 11 用DMA_IRQ_1避免中断服务函数里判断太多通道状态。通道不用的时候记得释放否则多次start之后通道就耗尽。4.5 问题速查表现象可能原因解决办法完全收不到数据UART 发送端没接对、波特率不一致、UART RX 引脚错误先用uart.read()循环测试排除 DMA 问题DMA 永远不完成传输计数大于实际数据长度加超时逻辑或者改用固定帧长协议数据错位read_increment误设为 trueDREQ 配错检查 DMA 配置源地址固定目的地址递增接收完无法再次启动DMA 通道完成一次后计数变成 0每次start都重新调用dma_channel_configureimport dma_uart报错固件没有正确编译模块检查 CMake 包含路径和MP_REGISTER_MODULE声明主循环频繁卡死中断服务函数里执行了 Python 回调中断里只置标志位用轮询或mp_sched_schedule调度回调5. 进一步优化与扩展思路5.1 双缓冲实现无间断接收单缓冲区的问题在于DMA 正在填 buffer 的时候你没法安全地处理这个 buffer。等 DMA 完成再处理这段时间内新到的数据可能无处可放。解决方法是双缓冲。准备两个同样大小的 bytearray一个当前被 DMA 使用另一个给主循环处理。DMA 填完 A 后立刻切到 B主循环同时处理 A 里已经收好的数据。这样可以做到“边收边处理”基本不会因为处理时间过长而丢下一帧数据。逻辑很简单bufs [bytearray(256), bytearray(256)] cur 0 while True: dma_uart.start(bufs[cur], 256) while not dma_uart.done(): machine.idle() # 切换当前缓冲交给业务处理另一个缓冲启动 DMA handle_data(bufs[cur]) cur 1 - cur实际运行中handle_data如果比较快比如只是把数据塞进队列这个方案非常稳。如果handle_data很慢那就要引入第三个缓冲区或者环形队列做缓冲总之别让业务处理阻塞 DMA 太久。5.2 把同一套 DMA 逻辑扩展到 ADC 和 PWM知道 UART 怎么用 DMA其他外设基本就是换几个参数的事。比如要做 ADC 连续采样DMA 的源地址改为 ADC 的 FIFO 数据寄存器DREQ 改为DREQ_ADC其他配置不变。要播放一段 PWM 波形DMA 的源地址改成内存里的波形表目的地址改成 PWM 的 CC 寄存器DREQ 用 PWM 的请求信号。RP2040 这套 DMA 设计得很统一核心的理解成本就一次。我在项目里用过 DMA 把预先生成的正弦波表不断搬到 PWM 模块实现了不占用 CPU 的音频信号输出。本质上和串口发送没有区别都是地址、计数、DREQ 三个核心要素。5.3 MicroPython 固件版本差异最后提醒一句MicroPython 版本更新很快。早期 RP2040 端口的模块注册方式和现在差别不小比如 1.19 时代可能需要在mpconfigport.h里手动声明模块而新版本更推荐用MP_REGISTER_MODULE。我在文章里的代码基于当前常见的新版本如果你编译时报错优先去 MicroPython 官方的docs/develop/cmodules.rst文档里对照一下。别硬抄CMake 和注册方式差一个字母都会导致import失败。踩过几次编译坑之后我的经验是先用最小模块跑通比如只导出一个hello()函数烧固件验证import没问题再逐步往里面加 DMA、加中断、加双缓冲。这样排查问题会容易很多。真正把 DMA 跑起来之后你会觉得“零 CPU 干预”这句话值回票价——主循环再也不会被一串串的串口数据打断得鸡飞狗跳了。

RP2040 MicroPython实现UART DMA零CPU干预实战

相关推荐

opencode：终端AI编程助手的安装、配置与实战指南

Nuxt 错误 B5004 排查指南：如何处理不受支持的 vite.config、webpack.config 等外部配置文件

Penpot 前端调试指南：ClojureScript REPL 与浏览器 Console 的完整实操手册

更多资讯

Bevy 输入焦点迁移指南：在文本输入框内按 Escape 将释放焦点并继续冒泡

rclone about 命令指南：用一行命令获取云端存储配额与用量

create-next-app 官方 Tailwind + TypeScript 默认模板（Pages Router）完整上手指南：从启动开发服务器到路由、API 与部署

如何快速迁移 ComfyUI 工作流：保存、分享与避坑完整指南

ECC /model-route 命令详解：按任务复杂度与预算自动推荐最佳模型层级

opencode：开源终端AI编程助手的配置与实用功能全解析

今日更新

能源系统对接碳交易的路径：从碳核算到碳资产运营

智能硬件数据驱动运营：订单日记与预测性维护实践

逆变器下垂控制与虚拟同步机对比：Simulink仿真建模与参数整定

本周精选

超人会飞不算本事：系统稳定依赖清晰规则与边界设计

超人VS蜘蛛侠：拆解超级IP的影响力与传播方法论

基于CNN的调制信号识别：MATLAB实现时频图分类实战

本月热门

基于YOLO的焊缝缺陷检测：从数据标注到工业部署全流程实践

分布式服务的决策记录

创业产品的首版范围

读完文章，想聊聊您的网站？