第七章：PX4 的“神经系统”——uORB

PX4 的“神经系统”——uORB 机制深度解析

在阅读 PX4 源码时，很多人都会发现一个非常高频的名字：uORB

几乎所有模块之间的数据交互，都通过 uORB 完成

例如：

• IMU 发布传感器数据

• EKF 订阅 IMU 数据进行状态估计

• 位置控制器订阅 EKF 的状态

• 电机混控模块订阅控制输出

整个 PX4 系统的模块通信，几乎全部依赖 uORB

如果说：

• NuttX 是操作系统

• PX4 Module 是功能模块

那么：

uORB 就是 PX4 的神经系统

它负责让系统中的各个模块能够高效、可靠地交换数据

这一章，我们就从工程视角，深入理解 PX4 的核心通信机制

一、什么是 uORB

uORB（micro Object Request Broker）是 PX4 自研的一套发布-订阅（Publish-Subscribe）消息总线系统

它的核心作用只有一句话：

实现 PX4 各个模块之间的异步数据通信

在 PX4 中：

• 传感器模块 → 发布数据

• 算法模块 → 订阅数据

• 控制模块 → 继续发布控制指令

这种通信模式叫做：

发布-订阅模式（Pub/Sub）

它与传统的函数调用通信完全不同

1、传统模块调用方式

例如：

模块A -> 调用 -> 模块B

特点：

• 强耦合

• 必须知道对方接口

• 模块之间依赖复杂

2、uORB 通信方式

通过 uORB：

模块A -> 发布数据 -> uORB 模块B -> 订阅数据 -> uORB

模块之间完全不需要互相知道对方存在

这带来了三个巨大优势：

1 解耦模块

传感器模块不需要知道谁在用数据

2 支持多个订阅者

同一数据可以被多个模块使用：

例如：

vehicle_attitude EKF 控制器 日志模块

都可以订阅

3 异步通信

模块运行频率不同也没关系

例如：

IMU 1000Hz EKF 250Hz 控制器 100Hz

uORB 自动完成数据缓存与同步

二、uORB 在 PX4 中的作用

在 PX4 系统中，几乎所有模块通信都通过 uORB

典型数据流如下：

IMU ↓ sensor_combined ↓ EKF2 ↓ vehicle_attitude ↓ mc_att_control ↓ actuator_controls ↓ mixer ↓ PWM

每一层之间都通过uORB topic传递数据

例如：

可以理解为：

PX4 的所有模块都通过 topic 交换数据

三、uORB 的核心概念

理解 uORB，需要掌握三个核心概念：

Topic Publisher Subscriber

1、Topic（消息主题）

Topic 是消息类型定义

例如：

vehicle_attitude

它定义了一种数据结构：

timestamp roll pitch yaw quaternion

这些结构在 PX4 中定义在：

msg/

例如：

msg/vehicle_attitude.msg

示例：

uint64 timestamp float32 q[4] float32 rollspeed float32 pitchspeed float32 yawspeed

PX4 编译时会自动生成对应的 C 结构体

2、Publisher（发布者）

发布者负责发布数据。

例如：

IMU 模块发布传感器数据：

伪代码：

orb_advert_t pub = orb_advertise( ORB_ID(sensor_combined), &sensor_data );

更新数据：

orb_publish( ORB_ID(sensor_combined), pub, &sensor_data );

这样系统中所有订阅者都会收到更新

3、Subscriber（订阅者）

订阅者负责读取数据

例如 EKF 订阅 IMU 数据：

int sub = orb_subscribe(ORB_ID(sensor_combined));

读取数据：

orb_copy( ORB_ID(sensor_combined), sub, &sensor_data );

如果有新数据，就会被读取

四、uORB 的运行机制

uORB 的核心实现其实并不复杂

它本质上做了三件事：

1 创建 topic 2 管理订阅 3 数据更新通知

1、Topic 创建

当系统第一次调用：

orb_advertise()

时：

uORB 会创建一个topic 节点

内部结构大致如下：

topic ├ 数据缓存 ├ 发布者 └ 订阅列表

2、订阅管理

当模块调用：

orb_subscribe()

时：

系统会创建一个订阅句柄

这个句柄用于：

• 判断是否有新数据

• 从 topic 中读取数据

3、数据更新

发布数据时：

orb_publish()

系统会：

1 写入新数据
2 更新时间戳
3 通知所有订阅者

这样订阅者就可以获取新数据

五、uORB 与 NuttX 的关系

很多人会问：

uORB 是不是操作系统的一部分？

答案是：

不是

uORB 属于PX4 中间件层

架构如下：

应用模块 │ uORB │ PX4 middleware │ NuttX OS

底层依赖 NuttX 的：

• 文件系统

• poll 机制

• 设备节点

在 NuttX 中：

每个 topic 实际上是一个设备节点：

例如：

/obj/sensor_combined /obj/vehicle_attitude

模块通过文件描述符 + poll()监听数据更新

这也是 PX4 uORB 设计非常巧妙的地方

六、uORB 的工程优势

uORB 的设计，使 PX4 具有非常优秀的工程扩展性

1、模块完全解耦

模块之间不需要直接调用

例如：

新增一个模块：

avoidance

只需要：

订阅 vehicle_local_position 发布 trajectory_setpoint

就可以工作

无需修改其他模块

2、数据可以被多个模块共享

例如：

IMU 数据可以被：

EKF VIO 日志系统 调试模块

同时使用

3、支持高频数据

IMU 数据：

1000Hz

EKF：

250Hz

uORB 可以自动完成数据同步

4、易于日志记录

PX4 的日志系统：

ULog

实际上也是通过 uORB 订阅数据

例如：

vehicle_attitude vehicle_local_position actuator_outputs

都会被记录

七、uORB 在源码中的位置

在 PX4 源码中：

uORB 主要位于：

src/modules/uORB

核心文件包括：

uORBManager.cpp DeviceNode.cpp Publication.hpp Subscription.hpp

其中：

同时：

msg/

目录定义所有 topic

编译时会自动生成：

uORB topic headers

八、uORB 与 ROS 的区别

很多人会把 uORB 和 ROS topic 混淆

实际上两者设计目标不同

简单理解：

uORB 是 PX4 内部通信机制

而：

ROS 是机器人系统通信框架

不过 PX4 提供了桥接：

MAVROS ROS2 bridge

可以把 uORB 数据映射到 ROS

九、总结

这一章我们介绍了 PX4 最核心的通信机制：uORB

核心要点可以总结为：

1、uORB 是 PX4 的发布-订阅消息系统

2、模块之间通过topic 交换数据

3、核心概念：

Topic Publisher Subscriber

4、uORB 基于NuttX 设备节点 + poll 机制实现

5、它实现了：

• 模块解耦

• 高效通信

• 高扩展性

可以说：

没有 uORB，就没有 PX4 的模块化架构