uORB Read and Write-飞控消息读写接口库¶
uORB Read and Write 库提供对 PX4 飞控内部 uORB（micro Object Request Broker）消息总线的读写接口，支持订阅和发布飞控内部的各种传感器、控制、状态等消息。
模块列表¶
| 模块 | 功能描述 |
|---|---|
| uORB Read (Async) | 异步方式读取 uORB 消息，非阻塞方式订阅飞控内部数据 |
| uORB Read Trigger | 触发式 uORB 消息读取，支持按事件触发方式获取数据 |
| uORB Write | 基础 uORB 消息写入，向飞控内部发布自定义消息数据 |
| uORB Write Advanced | 高级 uORB 消息写入，支持更多配置选项的消息发布 |
| uORB Write Advanced (Dai) | Dai 扩展的 uORB 高级写入，提供额外的功能和接口 |
uORB 简介¶
uORB 是 PX4 飞控使用的一种轻量级发布-订阅消息总线，用于飞控内部各模块之间的数据交换。
主要特点¶
| 特点 | 说明 |
|---|---|
| 发布-订阅模式 | 消息生产者发布消息，消费者订阅感兴趣的消息 |
| 异步通信 | 发布者和订阅者之间无需同步，解耦模块间依赖 |
| 轻量高效 | 针对嵌入式系统优化，资源占用小，传输效率高 |
| 类型安全 | 消息格式在编译期定义，避免运行时类型错误 |
使用场景¶
数据获取¶
- 传感器数据：读取 IMU、磁力计、气压计等传感器原始或融合数据
- 状态估计：获取飞控 EKF 输出的姿态、位置、速度等估计值
- 控制指令：读取飞控输出的控制指令，用于监控或分析
- 系统状态：获取电池、GPS、遥控器等系统状态信息
数据发布¶
- 自定义传感器：将外部传感器数据发布到飞控内部供其他模块使用
- 虚拟观测：发布虚拟的传感器数据用于仿真或测试
- 外部控制：通过发布控制指令实现外部对飞控的干预
使用注意事项¶
读取操作¶
- 消息更新检查：uORB 读取前需检查消息是否更新，避免读取陈旧数据
- 订阅管理：使用完后及时取消订阅，释放系统资源
- 多话题处理：同时订阅多个话题时注意处理顺序和同步问题
- 数据同步：异步读取的数据可能存在时间戳不一致，需要时进行插值处理
写入操作¶
- 话题存在性：发布消息前确保对应话题已存在，否则可能发布失败
- 数据完整性：确保发布的消息数据完整，避免因数据缺失导致订阅者异常
- 发布频率控制：过高的发布频率可能占用过多系统资源，合理设置发布周期
- 冲突避免：避免与飞控原生模块发布相同话题，防止数据冲突
性能优化¶
- 按需订阅：只订阅实际需要的数据，减少不必要的数据传输
- 批量处理：可能的情况下批量读取或写入消息，减少系统调用开销
- 缓存利用：合理利用飞控的消息缓存机制，平衡实时性和数据完整性
相关资源¶
注意：本文档为 uORB Read and Write 库的索引文档。各模块的详细使用说明请参考对应模块的独立文档页面。