1. 课程导入
在无人机与自主机器人开发领域，PX4 与 ROS2 是两条最重要的技术主线。PX4 是运行在飞控硬件上的实时飞行控制栈，负责姿态估计、位置控制、混控输出与安全逻辑；ROS2 则运行在机载计算机或地面站上，负责感知融合、路径规划、任务决策与多机协同。二者通过一条标准化的消息通道连接，这条通道的核心就是 PX4 内部的 uORB 消息总线。理解 uORB 如何组织数据、如何被外部接口读取与写入，是打通“飞控—机载计算”链路的起点。
一、PX4 与 ROS2 的生态分工
PX4 的软件架构可以粗略分为四层：最底层是 NuttX 实时操作系统与硬件驱动；其上是传感器、执行机构等驱动模块；再往上是估计器与控制模块；最上层是通信与应用模块。各模块之间并不直接互相调用，而是通过 uORB 发布/订阅主题来交换数据。这种设计让模块解耦、可独立替换，也让外部系统有了统一的接入点。
ROS2 侧则采用 DDS 作为通信中间件，节点之间通过话题、服务、动作交互。要让 PX4 与 ROS2 对话，就需要一个“翻译层”，把 uORB 主题映射为 ROS2 话题。常用的桥接方案包括 px4_ros_com、micro-ROS 以及基于 MAVLink 的 mavros。其中 px4_ros_com 直接基于 uORB 与 XRCE-DDS 生成桥接代码，是当前 PX4 官方主推的 ROS2 集成路径。
二、uORB 在 PX4 架构中的定位
uORB 是一个轻量级的发布/订阅消息系统，运行在 PX4 的同一进程空间内。每个消息主题（topic）都有固定的数据结构定义，存放在 msg/ 目录下的 .msg 文件中。模块通过 orb_subscribe() 订阅、orb_advertise() 发布、orb_copy() 读取数据。它不依赖网络，也不需要序列化开销，因此能满足飞控对实时性的严苛要求。
从数据流角度看，uORB 位于“模块间通信”这一层，向上支撑导航、控制、日志、通信等应用，向下承接驱动与估计器输出。它既是内部数据总线，也是外部接口的数据源。下图展示了 PX4 内部模块、uORB 总线与 ROS2 桥接之间的层次关系。
三、学习目标与整体课程框架
本课程围绕“uORB 消息机制”与“ROS2 接口开发”两条主线展开，目标是让学员能够独立完成从消息定义、桥接配置到应用开发的完整链路。具体学习目标如下：
- 理解 uORB 的发布/订阅模型、消息定义方式与生命周期管理；
- 掌握
.msg文件语法，能够新增或修改自定义消息； - 熟悉 XRCE-DDS 桥接原理，能够配置
px4_ros_com并生成 ROS2 接口； - 能够编写 ROS2 节点订阅 PX4 状态、发布控制指令；
- 掌握常见排障手段，如主题频率检查、QoS 匹配、时间同步等。
课程整体分为五个阶段，从概念到实操逐步深入：
| 阶段 | 核心内容 | 关键产出 |
|---|---|---|
| 基础认知 | PX4 架构、uORB 定位、ROS2 生态 | 理解数据流与模块边界 |
| 消息机制 | .msg 定义、发布订阅 API、多实例 | 能读写标准与自定义主题 |
| 桥接配置 | XRCE-DDS、px4_ros_com、QoS | 打通 PX4 与 ROS2 通信 |
| 应用开发 | 订阅状态、发布指令、Offboard 控制 | 可运行的 ROS2 控制节点 |
| 调试与优化 | 频率分析、延迟测量、故障排查 | 稳定可靠的集成方案 |
四、典型场景与常见误区
一个典型场景是：机载计算机上的 ROS2 节点需要获取无人机当前位置，用于视觉伺服降落。节点订阅 /fmu/out/vehicle_local_position 话题，该话题由桥接层从 uORB 的 vehicle_local_position 主题映射而来。若发现数据频率只有 1 Hz，而实际需要 50 Hz，问题往往出在桥接配置的发布频率或 QoS 设置上，而非 uORB 本身。
# 查看 PX4 端 uORB 主题频率
px4> listener vehicle_local_position 5
# 查看 ROS2 端话题频率
ros2 topic hz /fmu/out/vehicle_local_position
# 查看话题类型与 QoS
ros2 topic info /fmu/out/vehicle_local_position --verbose复盘来看，初学者最容易在“数据从哪来、到哪去、频率多少、时间基准是什么”这四个问题上卡住。本课程后续每一节都会围绕具体主题、具体配置和具体命令展开，帮助学员建立可验证、可调试的工程直觉。掌握 uORB 与 ROS2 的接口开发，本质上就是掌握一套“让飞控数据可控地流向应用层，并让应用指令安全地回流飞控”的方法论。