V2XAPI¶
V2X(车联网)技术关键在于两部分设备:OBU 和 RSU,它们通过无线通信方式实现车与车以及车与路边设施之间的互联。
| 序号 | 组件 | 安装位置 | 描述 | 通信方式 |
|---|---|---|---|---|
| 1 | OBU(车载端) | 车辆内部 | 作为车辆通信节点 | 直连 RSU;与其他 OBU 通过 LTE 广播通信 |
| 2 | RSU(路侧端) | 路边设施 | 类似大型 WIFI,支持车辆通信 | 广播 CSAE2020 标准信息给所有车辆 OBU |
在 CSAE2020 标准下,RSU 负责将关键安全和导航信息以广播方式传输给车载 OBU,确保车辆及时获取重要通信。广播消息类型如下:
| 消息类型 | 覆盖内容 |
|---|---|
| SPAT | 信号灯状态信息,例如红绿灯变换 |
| RSI | 路侧信息,涉及道路状况例如施工、限速等 |
| RSM | 路侧安全信息,包括事故报告、车辆异常等 |
| MAP | 地图信息,详细描述路口设计及其信号灯相位信息 |
V2X API 速查¶
| 使用场景 | API |
|---|---|
| 主动查询:按需获取特定类型的 V2X 消息(轮询模式) | GetV2XInfo |
| 被动接收:注册回调,实时接收所有 V2X 消息更新(推荐,无数据丢失) | SetV2XInfoUpdateCB |
轮询 vs 回调:如何选择?¶
GetV2XInfo:适合只在特定时间点(如每帧开始)按需获取消息,代码简单,但高频消息可能漏帧。SetV2XInfoUpdateCB:适合需要处理每一条 V2X 消息的场景(如信号灯状态追踪),实时性更好,推荐优先使用。
infoType 参数取值对应枚举 ESimOne_V2X_MessageFrame_PR,详见 C++ API 参考文档。
完整 API 签名、参数说明及
SimOne_Data_V2XNFS结构体定义,参见: -GetV2XInfo-SetV2XInfoUpdateCB