首页/软件

micro-ROS:把 ROS 2 塞进单片机,双主控架构的那座桥

MCU 管实时控制、SBC 管导航与感知——这是机器人最稳的分工。micro-ROS 是让两层说话不费劲的那座桥。

许可
Apache 2.0
协议
XRCE-DDS(与 ROS 2 的 DDS 图桥接)
支持板
STM32 / ESP32 / RP2040 等
上手
固件按目标板定制编译;官方支持主流开发板
角色
实时层与 ROS 2 图之间的标准桥
它解决什么问题
它解决的是「两层架构的桥要不要自己写」。没有它,MCU 与树莓派之间你要自定义串口协议、自己处理丢包、自己维护格式版本;有了它,MCU 上的程序就是一个正经 ROS 2 节点——话题、服务、参数与上层一致。架构上省掉的,正是自造组件里最容易出隐蔽 bug 的那一层。
替代品与对照
自己写串口协议(简单遥控场景完全够,调试更直观);ros2_control 加硬件接口(同一台机器上有实时内核时);全跑在 SBC 上(不做实时,演示级)。判断标准一条:控制环路的时间确定性要不要保证。要,就走它;不要,自己写更快。
上手要付出什么
门槛在工具链不在概念:固件按目标板编译(官方支持主流板,但交叉编译环境、RTOS 配置、主机侧 Agent 的部署都要自己踩),第一次跑通按天计。先在官方示例板上跑通,再换自己的板——一次换两个变量是调试的大忌。
已知的坑
①XRCE-DDS 的 QoS 与桌面 DDS 不完全对齐,大消息(图像)别走这条桥;②固件编译配置与板强绑定,换板要重配;③主机侧 Agent 挂了整层失联——Agent 要做成系统服务并配自动重启,这一条在文档里,但被跳过的次数比被执行的多。
我们核过什么
我们核过:①许可与协议(Apache 2.0 / XRCE-DDS)②对 RP2040、ESP32、STM32 的官方支持 ③「Agent 做成服务」是官方部署建议。没核过:我们自己没部署过——各板的固件编译工时来自社区报告。分级停在这一档。
这个站怎么判

做轮式小车或任何「MCU + SBC」双主控的机器,它值得——省掉的那层自造协议正是最隐蔽 bug 的窝。但它不是必需品:简单遥控车自己写串口更快。判断点是你有没有实时控制环路:有,它省的力气比它花的时间值;没有,先别上。

它到底桥接了什么

micro-ROS 的架构只有两层:MCU 上跑 client,主机(PC 或树莓派)上跑 Agent,中间是 eProsima 的 Micro XRCE-DDS 协议。Agent 负责在主机这一侧创建真正的 DDS 实体,把 MCU 注册成 ROS 2 网络里的一个正常参与者——发布、订阅、服务、动作、参数都和上层一致。

★这里有一条最容易被忽略、也最容易浪费一整晚的规则:Agent 不在运行,MCU 节点在 ROS 2 世界里就不存在。它不会报错,只是凭空消失——排查「节点看不到」的第一件事就是确认 Agent 在跑。

还要分清两条互不相干的通路:MCU 与硬件的 I/O(I2C / SPI / ADC / PWM)跟 MCU 与 Agent 之间的通信是分开的,DDS 与 XRCE 完全不参与硬件读写。传感器怎么采、电机怎么驱动,仍然是普通嵌入式固件的事。

官方支持的板子与 RTOS

官方直接维护的板子覆盖 STM32(含 ROBOTIS OpenCR)、ESP32、Arduino Portenta H7、RP2040、Teensy 3.x / 4.x 等;RTOS 上支持 FreeRTOS、Zephyr、NuttX,也有裸机路径。传输默认走串口;ESP32、Portenta 这类自带网络的板子可以直接走 UDP,省掉一根线。

什么时候不该用

  • 没有实时控制环路:简单遥控车自己写串口更快,引入 Agent 加 DDS 是纯负担。
  • 消息大或频率高:MCU 的内存与 CPU 限制了并发实体数量和消息大小,且并非所有 ROS 2 功能与 QoS 策略都可用。
  • 需要成熟调试工具:嵌入式侧的调试与性能分析工具不如标准 ROS 2 环境,这一项要在选型时算进去。

常见问题

micro-ROS 需要什么硬件?

一块官方支持的 32 位 MCU(STM32、ESP32、RP2040、Teensy 3.x/4.x、Portenta H7 等),加一台跑 Agent 的主机(PC 或树莓派)。内存门槛是几十 KB RAM 量级,中端 MCU 都够。建议先照官方支持列表选板子,社区移植的板子能用但不在 LTS 承诺范围内。

micro-ROS Agent 是什么,为什么必须有?

Agent 是跑在主机上的代理进程(通常用 Docker 起),负责把 MCU 的 XRCE 协议翻译成主机侧的 DDS 实体——MCU 自己没有能力跑完整 DDS 栈。Agent 没运行,MCU 节点在 ROS 2 里就不存在,而且不报错。「节点看不到」先查这一条。

micro-ROS 和 rosserial 有什么区别?

rosserial 是 ROS 1 时代的桥,靠自定义串口协议把话题转过去;micro-ROS 让 MCU 成为真正的 ROS 2 一等节点(发布、订阅、服务、动作、参数齐全),走标准化的 XRCE-DDS,不破坏 ROS 2 的抽象,也不用为嵌入式侧维护另一套通信中间件。

micro-ROS 有什么限制?

三条要记住:① 消息大小与并发实体数受 MCU 内存限制;② 并非所有 ROS 2 功能与 QoS 策略在资源受限平台上都可用;③ 嵌入式侧调试与性能分析工具不如标准 ROS 2 成熟。所以它适合传感器节点、电机控制这类实时小节点,不适合把重逻辑放上去。

来源

  • micro-ROS 官方文档(支持板、XRCE-DDS、部署建议)

涉及的对象

最后核实 2026-09-28