0. 引言
激光雷达的点云通常以 UDP 包形式从雷达输出到域控制器:一帧点云由成百上千个 1 KB 量级的小包组成,频率 10 Hz 级别。当这类数据需要进入 SOME/IP 网络(与域控内其他 ECU 统一的发现、订阅、诊断通道)时,客户端要自己完成服务发现、事件订阅、请求响应,还要回答一个更根本的问题:这条数据流是否可信。
本文说明怎样用 SOME/IP 栈承担前者、用 E2E 承担后者,以及为什么这两层不能互相替代。文中以 vsomeip 为主线,并给出 osp-someip 作为受限端替代时的差异。
参考链接:vsomeip 3.8.0、osp-someip、automotive-someip-rig
1. 方案概述与价值
1.1 背景
把点云送进 SOME/IP 网络,客户端至少要解决四件事:找到服务(Service Discovery)、订阅事件、按接口约定解析载荷、判断数据是否完整新鲜。很多项目最初用裸 socket 自己实现,能跑通,但随着车型和平台增多,会暴露三个问题:
- 协议细节散落在业务代码里,SD 重试、订阅超时、端口分配各写一遍;
- 换平台或换协议栈版本时,改的是业务代码而不是配置;
- 缺少统一的错误计数和状态机,出问题时只能靠抓包猜。
1.2 方案组成
方案分三层,职责不重叠:
| 层 | 组成 | 是否必需 | 负责 |
|---|---|---|---|
| 传输层 | vsomeip 或 osp-someip | 必需 | SD、订阅、请求响应,大消息按需启用 TP |
| 保护层 | E2E(Profile + CRC + 计数器 + Data ID) | 可选 | 端到端完整性、新鲜度、数据源识别 |
| 适配层 | 客户端 SDK | 必需 | 对外 API、队列、载荷解析、统计 |
传输层有两种可用实现。osp-someip 是本项目自研的 C++17 头文件库,与 vsomeip 3.4.10 做过双向互通测试,发现、订阅、事件和 RPC 全通,前提是对端提供 UDP 端点;目前只支持 UDP 与 IPv4 收发。后文以 vsomeip 为主线,osp-someip 作为资源受限端的替代路径,差异集中在下表:
| 维度 | vsomeip 3.8.0 | osp-someip |
|---|---|---|
| 交付形态 | 共享库、JSON 配置、插件 | 头文件库,编译时展开进调用方 |
| 线程与 socket | 自带 io 线程,由 routing manager 持有 socket | 不建线程、不持有 socket,收发与时钟由调用方提供 |
| 参数来源 | JSON 配置文件(见 5.1) | 模板参数与调用点(见附录 A.1.1) |
| 多进程 | 一个 routing manager 带多个应用,应用之间走本机通道 | 没有路由进程,一个实例就是一个进程内对象 |
| 内存 | 堆分配,用量随对端行为变化 | 容量编译期定死,热路径不分配 |
| E2E | 01/04/05/07/custom,或放在 SDK 层 | 库内 1/2/4/5/7,或放在 SDK 层 |
| 适合场景 | 车载 Linux,需要路由、配置与日志生态 | 资源受限、单线程事件循环、需要静态审查 |
两条路径的进程模型不通用:第 2 章的 routing manager、模式 A/B 和 5.1 的 JSON 只适用于 vsomeip。走 osp-someip 时,等价的约束见 3.2、3.4、4.1 与附录 A.1.1。
1.3 引入收益
| 收益 | 说明 |
|---|---|
| 协议能力复用 | SD、订阅、请求响应由成熟库实现,SDK 只保留业务适配 |
| 语义对齐公开规范 | 按 SOME/IP 公开规范实现,跨车型、跨供应商联调时有一致的参照 |
| 参数外置 | vsomeip 下 service/instance/event/端口写在 JSON 里,换车型改配置;osp-someip 下它们是模板参数,换车型改代码,但能静态核对 |
| 渐进可回退 | 保留原有传输实现,按项目切换,引入风险可控 |
这套框架的价值不在单点性能,而在协议栈复用、跨平台一致性和可运维性。性能需要用同平台实测校准,不能先验假设。
1.4 适用边界
这套框架解决的是"协议复用 + 数据可信",不解决下面这些,选型前先确认:
| 不适合的情况 | 原因 |
|---|---|
| 只有一台雷达,且域控内没有其他 SOME/IP 应用 | 引入 SD 和配置的成本大于收益,裸 socket 更省事 |
| 要求 SOME/IP 栈在 SDK 重启期间不断线 | 协议栈随进程退出;多个进程共用一条路由时还要依赖宿主进程,必须接入客户已有的协议栈 |
| 需要零丢包保证 | 事件层不重传,只能做到可检测、可降级 |
代价方面最实际的是 CPU:比裸 socket 多了封装、回调调度和本机通道转发,必须同平台实测。配置复杂度、多实例端口冲突、E2E 参数约定分别见 5.1、2.3、4.3。
非目标:不修改雷达端的服务接口与包布局;不涉及 SecOC/TLS。
2. vsomeip 技术架构
本章只描述 vsomeip 路径。osp-someip 没有 routing manager、本机通道和模式 A/B:一个实例就是调用方进程里的一个对象,socket、线程与时钟都由调用方提供。两条路径的对照见 1.2。
不需要 routing manager,也不代表要自己实现一个。只有一种情况需要额外写网关:同一主机上多个进程要共用一套 SD 与服务端口。这时选一个进程持有 30490 与服务端口,把数据转发给其他进程,其余进程不碰网络。单进程、或每个进程独占网卡与网络命名空间时,不需要额外组件。库里有 udp_link.hpp,现成的发送通道和组播加入函数可直接用。
routing manager 是 vsomeip 的实现概念,不是 SOME/IP 规范的一部分:规范只规定线格式与 SD、TP、E2E 的交互,不规定谁持有 socket、如何在本机分发。AUTOSAR 经典平台对应的角色是 SomeIpXf / someipd 这类守护进程,应用通过 IPC 接入;单进程实现里由应用自己 bind 端口、自己入组,中间不需要任何进程。
2.1 运行时模型
vsomeip 的运行时由四个概念组成:
| 概念 | 职责 |
|---|---|
runtime |
进程级单例,创建 application,管理 io 线程 |
application |
一个进程的 SOME/IP 句柄,负责注册回调、请求服务、订阅、发送 |
routing manager |
每主机唯一的网络出口与转发中心:SD 组播、UDP/TCP endpoint、本机转发 |
| local endpoint | application 与 routing manager 之间的本机通道(Unix domain socket 或本地回环) |
关键事实(均可在源码中核对):
- routing manager 不是必须单独启动的守护进程。 它编译在库里,由配置项
"routing"指定的应用在初始化时充当;上游仓库只在examples/routingmanagerd提供一个最小示例,不是部署前提。 - 只有 routing manager 持有对外 socket。 SD 组播和事件端口的 bind 都由它完成,普通 application 不重复 bind。
- 同一主机、同一网络命名空间只能有一个 routing manager,否则会端口冲突,或者两个 SD 域互相看不到。
- 回调运行在 vsomeip 的 io 线程上。 回调只做校验、拷贝和入队;解码、CRC 和落盘放到工作线程。
- SDK 自己担任 routing manager 时,它的生命周期等于宿主进程生命周期。
如果要求 SOME/IP 栈在 SDK 重启期间保持在线,应接入客户已有的 routing manager,而不是让每个进程各起一套。
2.2 部署拓扑
一个域控制器运行多个 SDK 进程、分别接入不同雷达时,推荐"一个 routing manager + 每雷达唯一 instance"的拓扑。
#mermaid-svg-aIgxgt3g2wIAgnsg{font-family:Microsoft YaHei;font-size:16px;fill:#0D47A1;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-aIgxgt3g2wIAgnsg .error-icon{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);}#mermaid-svg-aIgxgt3g2wIAgnsg .error-text{fill:rgb(0.3, 2.5500000001, 4.2000000001);stroke:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-aIgxgt3g2wIAgnsg .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-aIgxgt3g2wIAgnsg .marker{fill:#546E7A;stroke:#546E7A;}#mermaid-svg-aIgxgt3g2wIAgnsg .marker.cross{stroke:#546E7A;}#mermaid-svg-aIgxgt3g2wIAgnsg svg{font-family:Microsoft YaHei;font-size:16px;}#mermaid-svg-aIgxgt3g2wIAgnsg p{margin:0;}#mermaid-svg-aIgxgt3g2wIAgnsg .label{font-family:Microsoft YaHei;color:#0D47A1;}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster-label text{fill:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster-label span{color:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster-label span p{background-color:transparent;}#mermaid-svg-aIgxgt3g2wIAgnsg .label text,#mermaid-svg-aIgxgt3g2wIAgnsg span{fill:#0D47A1;color:#0D47A1;}#mermaid-svg-aIgxgt3g2wIAgnsg .node rect,#mermaid-svg-aIgxgt3g2wIAgnsg .node circle,#mermaid-svg-aIgxgt3g2wIAgnsg .node ellipse,#mermaid-svg-aIgxgt3g2wIAgnsg .node polygon,#mermaid-svg-aIgxgt3g2wIAgnsg .node path{fill:#E3F2FD;stroke:#1565C0;stroke-width:1px;}#mermaid-svg-aIgxgt3g2wIAgnsg .rough-node .label text,#mermaid-svg-aIgxgt3g2wIAgnsg .node .label text,#mermaid-svg-aIgxgt3g2wIAgnsg .image-shape .label,#mermaid-svg-aIgxgt3g2wIAgnsg .icon-shape .label{text-anchor:middle;}#mermaid-svg-aIgxgt3g2wIAgnsg .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-aIgxgt3g2wIAgnsg .rough-node .label,#mermaid-svg-aIgxgt3g2wIAgnsg .node .label,#mermaid-svg-aIgxgt3g2wIAgnsg .image-shape .label,#mermaid-svg-aIgxgt3g2wIAgnsg .icon-shape .label{text-align:center;}#mermaid-svg-aIgxgt3g2wIAgnsg .node.clickable{cursor:pointer;}#mermaid-svg-aIgxgt3g2wIAgnsg .root .anchor path{fill:#546E7A!important;stroke-width:0;stroke:#546E7A;}#mermaid-svg-aIgxgt3g2wIAgnsg .arrowheadPath{fill:#0b0b0b;}#mermaid-svg-aIgxgt3g2wIAgnsg .edgePath .path{stroke:#546E7A;stroke-width:2.0px;}#mermaid-svg-aIgxgt3g2wIAgnsg .flowchart-link{stroke:#546E7A;fill:none;}#mermaid-svg-aIgxgt3g2wIAgnsg .edgeLabel{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);text-align:center;}#mermaid-svg-aIgxgt3g2wIAgnsg .edgeLabel p{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-aIgxgt3g2wIAgnsg .edgeLabel rect{opacity:0.5;background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-aIgxgt3g2wIAgnsg .labelBkg{background-color:rgba(242, 253, 226.9999999999, 0.5);}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster rect{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);stroke:hsl(25.3846153846, 46.6666666667%, 89.1176470588%);stroke-width:1px;}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster text{fill:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-aIgxgt3g2wIAgnsg .cluster span{color:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-aIgxgt3g2wIAgnsg div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:Microsoft YaHei;font-size:12px;background:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);border:1px solid hsl(25.3846153846, 46.6666666667%, 89.1176470588%);border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-aIgxgt3g2wIAgnsg .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#0D47A1;}#mermaid-svg-aIgxgt3g2wIAgnsg rect.text{fill:none;stroke-width:0;}#mermaid-svg-aIgxgt3g2wIAgnsg .icon-shape,#mermaid-svg-aIgxgt3g2wIAgnsg .image-shape{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);text-align:center;}#mermaid-svg-aIgxgt3g2wIAgnsg .icon-shape p,#mermaid-svg-aIgxgt3g2wIAgnsg .image-shape p{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);padding:2px;}#mermaid-svg-aIgxgt3g2wIAgnsg .icon-shape .label rect,#mermaid-svg-aIgxgt3g2wIAgnsg .image-shape .label rect{opacity:0.5;background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-aIgxgt3g2wIAgnsg .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-aIgxgt3g2wIAgnsg .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-aIgxgt3g2wIAgnsg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-aIgxgt3g2wIAgnsg .core>*{fill:#EDE7F6!important;stroke:#4527A0!important;color:#311B92!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .core span{fill:#EDE7F6!important;stroke:#4527A0!important;color:#311B92!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .core tspan{fill:#311B92!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .sdk>*{fill:#E3F2FD!important;stroke:#1565C0!important;color:#0D47A1!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .sdk span{fill:#E3F2FD!important;stroke:#1565C0!important;color:#0D47A1!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .sdk tspan{fill:#0D47A1!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .radar>*{fill:#FFEBEE!important;stroke:#C62828!important;color:#B71C1C!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .radar span{fill:#FFEBEE!important;stroke:#C62828!important;color:#B71C1C!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .radar tspan{fill:#B71C1C!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .net>*{fill:#ECEFF1!important;stroke:#455A64!important;color:#263238!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .net span{fill:#ECEFF1!important;stroke:#455A64!important;color:#263238!important;}#mermaid-svg-aIgxgt3g2wIAgnsg .net tspan{fill:#263238!important;} 雷达 ECU
域控(单主机 / 单 routing manager)
local endpoint
local endpoint
local endpoint
SD 30490
SD + 事件 0x8001
instance 0x0001
SD + 事件 0x8001
instance 0x0002
SD + 事件 0x8001
instance 0x0003
SDK-1
instance 0x0001
SDK-2
instance 0x0002
SDK-3
instance 0x0003
routing manager
SD 30490
事件 30509
车载以太网交换机
VLAN / SD 组播
雷达 A
instance 0x0001
雷达 B
instance 0x0002
雷达 C
instance 0x0003
拓扑前提:
- 三台雷达的 service 相同(示例
0x1234),instance 分别为0x0001、0x0002、0x0003;instance 必须唯一,否则 routing manager 无法把事件分给不同 SDK。 - 每个 SDK 进程在配置中有唯一 application name 和 application ID;application ID 不是 instance ID。
- 域控侧只 bind 一次 SD 组播和事件端口,由 routing manager 统一持有。
- 如果雷达侧不能分配不同的 instance,只能改用每 SDK 独立网络命名空间,或把 SDK 分散到不同主机。
部署实验可参考 automotive-someip-rig:它用 network namespace 模拟两个 ECU,通过 Open vSwitch 连接,用 vsomeip 跑 SD 与订阅。
2.3 两种部署模式
下文按"SDK 进程是否自己担任 routing manager"区分两种模式。
| 模式 | 配置 | 适用 | 代价 |
|---|---|---|---|
| A. SDK 自己担任路由 | "routing": "radar-sdk",SDK 应用列入 applications |
域控上没有其他 vsomeip 应用 | SDK 独占 SD 与事件端口,重启会中断 SD |
| B. 接入宿主 | "routing": "<宿主应用名>",SDK 作为普通 application |
域控已有其他 vsomeip 应用 | 依赖宿主启动顺序、application ID 和配置合并 |
模式选择必须在集成前确认,不能让 SDK 在运行时自行猜测。同一主机多个 SDK 必须共用一个 routing manager;各起一套会争抢 SD 端口和事件端口。确实需要各自独立时,只能用独立网络命名空间或不同主机。
3. 服务接口与数据路径
3.1 服务接口
| 项目 | 值 |
|---|---|
| Service | 0x1234(示例) |
| Instance | 0x0001、0x0002、0x0003(示例,每台雷达唯一) |
| Major/Minor | 1.0(示例) |
| Eventgroup | 0x0001 |
| 点云事件 | 0x8001 |
| 单播端口 | UDP/TCP 30509(示例) |
| SD 组播 | 239.0.0.1:30490(示例) |
| 点云 UDP 包长 | 约 1.2 KB(示例 1200 字节) |
| SOME/IP 头 | 16 字节(规范值;vsomeip 由库生成,osp-someip 由线格式层编码) |
| 单条事件 payload | 1200 字节(示例,即一个点云包) |
服务、实例与成员的层级关系:
text
service 0x1234(服务接口)
├─ instance 0x0001(雷达 A)
│ ├─ method 0x0001、0x0002 ...
│ ├─ event 0x8001(点云)
│ └─ eventgroup 0x0001 { 0x8001 }
├─ instance 0x0002(雷达 B)
│ └─ 同一套 method/event/eventgroup ID
└─ instance 0x0003(雷达 C)
(service, instance) 定位"哪台设备上的哪个服务";method/event 是服务内部成员 ID,只在同一个 service 内唯一;eventgroup 是订阅容器,订阅粒度是 (service, instance, eventgroup)。三台雷达共用 service 是因为接口相同(同一份点云接口),用于区分设备的是 instance。
ID 表示法 :所有 ID 一律写成带
0x前缀的十六进制。vsomeip 解析时对带0x的值按十六进制,否则按十进制------混写不会立刻报错,但会把人工核对和评审变成猜谜。
ID 不绑定传输:method 与 event 本身都不带传输属性,走 UDP 还是 TCP 由 endpoint 配置和客户端请求参数决定。看到某个成员被标成"TCP",那只是当前实现的接线方式,不是协议规定。
3.2 启动、发现与订阅
下图以 vsomeip 路径为例;osp-someip 的对应调用见本节末尾。
雷达服务 vsomeip SDK 应用 雷达服务 vsomeip SDK 应用 #mermaid-svg-m3AR372GTC5FuRUj{font-family:Microsoft YaHei;font-size:16px;fill:#0D47A1;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-m3AR372GTC5FuRUj .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-m3AR372GTC5FuRUj .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-m3AR372GTC5FuRUj .error-icon{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);}#mermaid-svg-m3AR372GTC5FuRUj .error-text{fill:rgb(0.3, 2.5500000001, 4.2000000001);stroke:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-m3AR372GTC5FuRUj .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-m3AR372GTC5FuRUj .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-m3AR372GTC5FuRUj .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-m3AR372GTC5FuRUj .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-m3AR372GTC5FuRUj .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-m3AR372GTC5FuRUj .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-m3AR372GTC5FuRUj .marker{fill:#546E7A;stroke:#546E7A;}#mermaid-svg-m3AR372GTC5FuRUj .marker.cross{stroke:#546E7A;}#mermaid-svg-m3AR372GTC5FuRUj svg{font-family:Microsoft YaHei;font-size:16px;}#mermaid-svg-m3AR372GTC5FuRUj p{margin:0;}#mermaid-svg-m3AR372GTC5FuRUj .actor{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-m3AR372GTC5FuRUj text.actor>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-m3AR372GTC5FuRUj .actor-line{stroke:#1565C0;}#mermaid-svg-m3AR372GTC5FuRUj .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-m3AR372GTC5FuRUj .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#0D47A1;}#mermaid-svg-m3AR372GTC5FuRUj .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#0D47A1;}#mermaid-svg-m3AR372GTC5FuRUj #arrowhead path{fill:#0D47A1;stroke:#0D47A1;}#mermaid-svg-m3AR372GTC5FuRUj .sequenceNumber{fill:#ab9185;}#mermaid-svg-m3AR372GTC5FuRUj #sequencenumber{fill:#0D47A1;}#mermaid-svg-m3AR372GTC5FuRUj #crosshead path{fill:#0D47A1;stroke:#0D47A1;}#mermaid-svg-m3AR372GTC5FuRUj .messageText{fill:#0D47A1;stroke:none;}#mermaid-svg-m3AR372GTC5FuRUj .labelBox{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-m3AR372GTC5FuRUj .labelText,#mermaid-svg-m3AR372GTC5FuRUj .labelText>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-m3AR372GTC5FuRUj .loopText,#mermaid-svg-m3AR372GTC5FuRUj .loopText>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-m3AR372GTC5FuRUj .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:#1565C0;fill:#1565C0;}#mermaid-svg-m3AR372GTC5FuRUj .note{stroke:hsl(52.6829268293, 60%, 73.9215686275%);fill:#fff5ad;}#mermaid-svg-m3AR372GTC5FuRUj .noteText,#mermaid-svg-m3AR372GTC5FuRUj .noteText>tspan{fill:#333;stroke:none;}#mermaid-svg-m3AR372GTC5FuRUj .activation0{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-m3AR372GTC5FuRUj .activation1{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-m3AR372GTC5FuRUj .activation2{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-m3AR372GTC5FuRUj .actorPopupMenu{position:absolute;}#mermaid-svg-m3AR372GTC5FuRUj .actorPopupMenuPanel{position:absolute;fill:#E3F2FD;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-m3AR372GTC5FuRUj .actor-man line{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-m3AR372GTC5FuRUj .actor-man circle,#mermaid-svg-m3AR372GTC5FuRUj line{stroke:#1565C0;fill:#E3F2FD;stroke-width:2px;}#mermaid-svg-m3AR372GTC5FuRUj :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} 打开设备(SOME/IP 协议) 加载配置 / 校验接口约定 create_application / init / start SD Find(239.0.0.1:30490) SD Offer(service / instance) availability = true subscribe(eventgroup 0x0001) SD Subscribe SD SubscribeAck subscription = true 打开成功,进入 Streaming
设计要点:
runtime每进程初始化一次;同一进程的多个设备句柄共享同一个 runtime。- 服务可用后订阅 eventgroup
0x0001;只有收到订阅确认才把状态置为Streaming。 - 服务不可用时回到
Discovering,清空队列并重新请求。 - vsomeip 路径下,模式 B 必须等宿主 routing manager 就绪;SDK 不能假设自己拥有 SD 端口和事件端口。osp-someip 路径没有宿主进程,端口由调用方分配并绑定。
走 osp-someip 路径时,上面四步的对应关系是:StartFind() 发 Find,按 100 ms 起倍增重发三次;收到 Offer 后回调 OnServiceAvailable;Subscribe() 发订阅,OnSubscribeAck 到达才算进入 Streaming;HandleDatagram() 收报文,Tick(now_ms) 推进请求超时、订阅续订和服务消失。可运行的例子见 examples/client_demo.cpp,一个进程内完成发现、订阅、事件接收与一次方法调用。
3.3 事件数据面
下图同样以 vsomeip 路径为例。
应用 SDK 工作线程 vsomeip 雷达服务 应用 SDK 工作线程 vsomeip 雷达服务 #mermaid-svg-XTjGZ0foDAKywwAF{font-family:Microsoft YaHei;font-size:16px;fill:#0D47A1;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-XTjGZ0foDAKywwAF .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-XTjGZ0foDAKywwAF .error-icon{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);}#mermaid-svg-XTjGZ0foDAKywwAF .error-text{fill:rgb(0.3, 2.5500000001, 4.2000000001);stroke:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-XTjGZ0foDAKywwAF .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-XTjGZ0foDAKywwAF .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-XTjGZ0foDAKywwAF .marker{fill:#546E7A;stroke:#546E7A;}#mermaid-svg-XTjGZ0foDAKywwAF .marker.cross{stroke:#546E7A;}#mermaid-svg-XTjGZ0foDAKywwAF svg{font-family:Microsoft YaHei;font-size:16px;}#mermaid-svg-XTjGZ0foDAKywwAF p{margin:0;}#mermaid-svg-XTjGZ0foDAKywwAF .actor{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-XTjGZ0foDAKywwAF text.actor>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-XTjGZ0foDAKywwAF .actor-line{stroke:#1565C0;}#mermaid-svg-XTjGZ0foDAKywwAF .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-XTjGZ0foDAKywwAF .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#0D47A1;}#mermaid-svg-XTjGZ0foDAKywwAF .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#0D47A1;}#mermaid-svg-XTjGZ0foDAKywwAF #arrowhead path{fill:#0D47A1;stroke:#0D47A1;}#mermaid-svg-XTjGZ0foDAKywwAF .sequenceNumber{fill:#ab9185;}#mermaid-svg-XTjGZ0foDAKywwAF #sequencenumber{fill:#0D47A1;}#mermaid-svg-XTjGZ0foDAKywwAF #crosshead path{fill:#0D47A1;stroke:#0D47A1;}#mermaid-svg-XTjGZ0foDAKywwAF .messageText{fill:#0D47A1;stroke:none;}#mermaid-svg-XTjGZ0foDAKywwAF .labelBox{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-XTjGZ0foDAKywwAF .labelText,#mermaid-svg-XTjGZ0foDAKywwAF .labelText>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-XTjGZ0foDAKywwAF .loopText,#mermaid-svg-XTjGZ0foDAKywwAF .loopText>tspan{fill:#0D47A1;stroke:none;}#mermaid-svg-XTjGZ0foDAKywwAF .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:#1565C0;fill:#1565C0;}#mermaid-svg-XTjGZ0foDAKywwAF .note{stroke:hsl(52.6829268293, 60%, 73.9215686275%);fill:#fff5ad;}#mermaid-svg-XTjGZ0foDAKywwAF .noteText,#mermaid-svg-XTjGZ0foDAKywwAF .noteText>tspan{fill:#333;stroke:none;}#mermaid-svg-XTjGZ0foDAKywwAF .activation0{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-XTjGZ0foDAKywwAF .activation1{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-XTjGZ0foDAKywwAF .activation2{fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);stroke:hsl(85.3846153846, 86.6666666667%, 84.1176470588%);}#mermaid-svg-XTjGZ0foDAKywwAF .actorPopupMenu{position:absolute;}#mermaid-svg-XTjGZ0foDAKywwAF .actorPopupMenuPanel{position:absolute;fill:#E3F2FD;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-XTjGZ0foDAKywwAF .actor-man line{stroke:#1565C0;fill:#E3F2FD;}#mermaid-svg-XTjGZ0foDAKywwAF .actor-man circle,#mermaid-svg-XTjGZ0foDAKywwAF line{stroke:#1565C0;fill:#E3F2FD;stroke-width:2px;}#mermaid-svg-XTjGZ0foDAKywwAF :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;} Event 0x8001(一个点云 UDP 包) message handler(payload, 1200 字节) E2E 校验(可选) CRC32 校验 解析点云 / 状态 点云回调 / 状态回调
载荷约定 :
0x8001的 payload 不按 SOME/IP 序列化规则编码,而是雷达自有二进制结构的原始字节。这里把 SOME/IP 事件当作透明字节通道使用:SOME/IP 负责寻址、订阅和分段,载荷语义由 SDK 按设备文档解析。这在本场景是合理选择(点云是流式数据,逐字段序列化没有收益),但必须写进接口说明,否则后来的人会以为它是标准 SOME/IP 序列化结构。
数据面规则:
- vsomeip 路径下,回调只做事件 ID 校验、payload 拷贝和入队;工作线程负责 E2E、CRC32 和解析。osp-someip 路径下,这些工作发生在
HandleDatagram()返回之前,回调里同样只做入队。 - 队列满时丢弃最旧点云包,保留状态包,并累加
queue_drop。 - 点云和状态若共用同一事件 ID,SDK 必须按 payload 头部区分包类型,不能只按事件 ID 区分。
3.4 消息边界与 SOME/IP-TP
一个点云包映射为一条事件,消息长度约 1.2 KB(示例 payload 1200 字节)。vsomeip 的 UDP 消息上限是 1416 字节(VSOMEIP_MAX_UDP_MESSAGE_SIZE,含 16 字节头),payload 上限约 1400 字节,单包映射不需要 TP。
只有两种情况需要 TP:
- 把多个点云包聚合成超过 1400 字节的单条消息;
- E2E 要求保护整帧,消息边界改为帧级。
需要时按 service 配置 someip-tp,逐 method 指定 max-segment-length 与 separation-time:
- 方向由
service-to-client(服务端发给客户端,例如事件)或client-to-service(请求)区分,事件 ID 写在method字段里。 - 段长必须是 16 的整数倍,默认 1392;写成 1404 时 vsomeip 会自行修正并打印错误日志,配置看上去生效了,实际值已被改过。
- TP 会带来重组缓冲和"丢一段丢整条消息"的风险,不应默认开启,这也是宁可保持单包映射的理由。
- TP 只在消息超过 UDP 上限或需要跨包保护时才引入;能走单包就保持单包。
以上 someip-tp 参数属于 vsomeip 配置。osp-someip 没有段长配置项:分段与重组在库内,重组容量是模板参数,例如 TpReassembly<4096, 1> 表示 4 KB 载荷、1 路会话,不启用时不占内存。实现见 include/osp/someip/tp.hpp:按 16 字节单元记录到达情况,支持乱序重组,重叠分段丢弃,按(消息 ID,请求 ID)区分会话并做超时释放。
丢包与 QoS 的边界同样是三层分工,任何一层都做不到"零丢失":
| 层 | 负责 | 不负责 |
|---|---|---|
| 链路层:VLAN 优先级(PCP)、交换机优先级队列 | 降低丢包率、抑制突发时延 | 不保证零丢包 |
| SOME/IP 与 vsomeip | 寻址、订阅、用单包小消息缩小失败面 | 不重传;不提供 QoS 配置(源码中无 DSCP、无 SO_PRIORITY 处理,network 只用于绑定网卡) |
| E2E | 发现丢包、乱序、重放 | 不修复数据,只判定当前数据流是否可信 |
需要时延分级时,QoS 在交换机和操作系统层配置,不能写成框架能力。
4. E2E 端到端保护
4.1 为什么需要 E2E
E2E 回答的是"这条消息是否可信"。SOME/IP 自带的 CRC32 只能发现包内比特错误,无法发现:
- 丢包、重复包、乱序包;
- 旧数据被重新注入;
- 收发双方状态不一致。
E2E 在业务 payload 上增加 CRC、计数器和 Data ID,并用窗口状态机判断整条数据流是否可信。它和 TP 不是一层能力:TP 解决大消息分片,E2E 解决完整性、新鲜度和数据源识别。
E2E 有三个可用位置,差别在复用范围:
| 位置 | 实现 | 优点 | 限制 |
|---|---|---|---|
| vsomeip 库内 | implementation/e2e_protection,Profile 01/04/05/07/custom |
配置即用,不改代码 | 绑定 vsomeip 版本,换栈要重做 |
| SDK 层 | 自研或第三方库 | 跨版本、跨栈统一 | 每个项目都要自己维护 |
| osp-someip 库内 | 策略模板,Profile 1/2/4/5/7 | 无线程、不分配堆,同一份代码可跨栈复用 | 编译期选定策略;没有 3/6/11/22/44 |
本文选择 SDK 层,便于跨版本和跨栈复用;目标版本允许时也可以直接用库内实现。Profile 2 目前只有 osp-someip 提供,Profile 5 两边都有。启用与否、用哪个 Profile、Data ID 与偏移如何配置,仍由项目通信矩阵决定。
分层方式可参考 include/osp/someip/e2e.hpp:传输层只调用 Protect / Check,不把 E2E 逻辑写进业务解析;每个 Profile 是一个可替换的策略类型,默认 NoE2E 不产生开销。
4.2 E2E 在数据路径中的位置
#mermaid-svg-QNksWTcCxPXNRFP1{font-family:Microsoft YaHei;font-size:16px;fill:#0D47A1;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-QNksWTcCxPXNRFP1 .error-icon{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);}#mermaid-svg-QNksWTcCxPXNRFP1 .error-text{fill:rgb(0.3, 2.5500000001, 4.2000000001);stroke:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-QNksWTcCxPXNRFP1 .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-QNksWTcCxPXNRFP1 .marker{fill:#546E7A;stroke:#546E7A;}#mermaid-svg-QNksWTcCxPXNRFP1 .marker.cross{stroke:#546E7A;}#mermaid-svg-QNksWTcCxPXNRFP1 svg{font-family:Microsoft YaHei;font-size:16px;}#mermaid-svg-QNksWTcCxPXNRFP1 p{margin:0;}#mermaid-svg-QNksWTcCxPXNRFP1 .label{font-family:Microsoft YaHei;color:#0D47A1;}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster-label text{fill:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster-label span{color:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster-label span p{background-color:transparent;}#mermaid-svg-QNksWTcCxPXNRFP1 .label text,#mermaid-svg-QNksWTcCxPXNRFP1 span{fill:#0D47A1;color:#0D47A1;}#mermaid-svg-QNksWTcCxPXNRFP1 .node rect,#mermaid-svg-QNksWTcCxPXNRFP1 .node circle,#mermaid-svg-QNksWTcCxPXNRFP1 .node ellipse,#mermaid-svg-QNksWTcCxPXNRFP1 .node polygon,#mermaid-svg-QNksWTcCxPXNRFP1 .node path{fill:#E3F2FD;stroke:#1565C0;stroke-width:1px;}#mermaid-svg-QNksWTcCxPXNRFP1 .rough-node .label text,#mermaid-svg-QNksWTcCxPXNRFP1 .node .label text,#mermaid-svg-QNksWTcCxPXNRFP1 .image-shape .label,#mermaid-svg-QNksWTcCxPXNRFP1 .icon-shape .label{text-anchor:middle;}#mermaid-svg-QNksWTcCxPXNRFP1 .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-QNksWTcCxPXNRFP1 .rough-node .label,#mermaid-svg-QNksWTcCxPXNRFP1 .node .label,#mermaid-svg-QNksWTcCxPXNRFP1 .image-shape .label,#mermaid-svg-QNksWTcCxPXNRFP1 .icon-shape .label{text-align:center;}#mermaid-svg-QNksWTcCxPXNRFP1 .node.clickable{cursor:pointer;}#mermaid-svg-QNksWTcCxPXNRFP1 .root .anchor path{fill:#546E7A!important;stroke-width:0;stroke:#546E7A;}#mermaid-svg-QNksWTcCxPXNRFP1 .arrowheadPath{fill:#0b0b0b;}#mermaid-svg-QNksWTcCxPXNRFP1 .edgePath .path{stroke:#546E7A;stroke-width:2.0px;}#mermaid-svg-QNksWTcCxPXNRFP1 .flowchart-link{stroke:#546E7A;fill:none;}#mermaid-svg-QNksWTcCxPXNRFP1 .edgeLabel{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);text-align:center;}#mermaid-svg-QNksWTcCxPXNRFP1 .edgeLabel p{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-QNksWTcCxPXNRFP1 .edgeLabel rect{opacity:0.5;background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-QNksWTcCxPXNRFP1 .labelBkg{background-color:rgba(242, 253, 226.9999999999, 0.5);}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster rect{fill:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);stroke:hsl(25.3846153846, 46.6666666667%, 89.1176470588%);stroke-width:1px;}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster text{fill:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-QNksWTcCxPXNRFP1 .cluster span{color:rgb(0.3, 2.5500000001, 4.2000000001);}#mermaid-svg-QNksWTcCxPXNRFP1 div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:Microsoft YaHei;font-size:12px;background:hsl(25.3846153846, 86.6666666667%, 99.1176470588%);border:1px solid hsl(25.3846153846, 46.6666666667%, 89.1176470588%);border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-QNksWTcCxPXNRFP1 .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#0D47A1;}#mermaid-svg-QNksWTcCxPXNRFP1 rect.text{fill:none;stroke-width:0;}#mermaid-svg-QNksWTcCxPXNRFP1 .icon-shape,#mermaid-svg-QNksWTcCxPXNRFP1 .image-shape{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);text-align:center;}#mermaid-svg-QNksWTcCxPXNRFP1 .icon-shape p,#mermaid-svg-QNksWTcCxPXNRFP1 .image-shape p{background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);padding:2px;}#mermaid-svg-QNksWTcCxPXNRFP1 .icon-shape .label rect,#mermaid-svg-QNksWTcCxPXNRFP1 .image-shape .label rect{opacity:0.5;background-color:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);fill:hsl(85.3846153846, 86.6666666667%, 94.1176470588%);}#mermaid-svg-QNksWTcCxPXNRFP1 .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-QNksWTcCxPXNRFP1 .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-QNksWTcCxPXNRFP1 :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}#mermaid-svg-QNksWTcCxPXNRFP1 .net>*{fill:#EDE7F6!important;stroke:#4527A0!important;color:#311B92!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .net span{fill:#EDE7F6!important;stroke:#4527A0!important;color:#311B92!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .net tspan{fill:#311B92!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .e2e>*{fill:#FCE4EC!important;stroke:#AD1457!important;color:#880E4F!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .e2e span{fill:#FCE4EC!important;stroke:#AD1457!important;color:#880E4F!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .e2e tspan{fill:#880E4F!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .crc>*{fill:#FFFDE7!important;stroke:#F9A825!important;color:#F57F17!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .crc span{fill:#FFFDE7!important;stroke:#F9A825!important;color:#F57F17!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .crc tspan{fill:#F57F17!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .codec>*{fill:#FFF3E0!important;stroke:#EF6C00!important;color:#E65100!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .codec span{fill:#FFF3E0!important;stroke:#EF6C00!important;color:#E65100!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .codec tspan{fill:#E65100!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .app>*{fill:#E8F5E9!important;stroke:#2E7D32!important;color:#1B5E20!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .app span{fill:#E8F5E9!important;stroke:#2E7D32!important;color:#1B5E20!important;}#mermaid-svg-QNksWTcCxPXNRFP1 .app tspan{fill:#1B5E20!important;} 传输层交付的消息
(TP 已重组)
E2E 校验
CRC32
点云 / 状态解码
应用回调
顺序不可交换:vsomeip 交付完整 payload → E2E 校验 → CRC32 → 业务解析。启用 TP 时,E2E 必须在重组之后、业务解析之前;顺序搞反会出现"校验通过但数据错位"的偶发问题。
4.3 检查内容与状态机
E2E 分两步工作:
- 单包检查:校验 CRC、计数器、Data ID,返回 OK、REPEATED、WRONGSEQUENCE、ERROR 等结果。
- 窗口状态判断:根据最近若干包的结果更新状态机,避免单包误判。
| 状态 | 含义 | SDK 行为 |
|---|---|---|
INIT |
启动中,样本不足 | 暂不用于安全功能,可缓存或丢弃 |
VALID |
窗口内好帧足够 | 正常交付应用 |
INVALID |
错误超过阈值 | 丢弃数据,记录 e2e_error,上报降级 |
NODATA |
超时或没有新数据 | 上报链路异常,触发重连或降级 |
E2E 规则:
- 雷达端未启用 E2E 时透传,仅保留 CRC32;启用时必须使用相同 Profile、Data ID、计数器偏移、CRC 偏移和头偏移。
- 校验失败丢弃当前包并记录
e2e_error,不把坏数据交给应用。 - 状态机按窗口判断,不能只看单包 CRC;点云是否启用由安全目标决定,控制命令优先。
4.4 vsomeip 自带的 E2E 配置
vsomeip 提供 SD、订阅和可选 TP,也提供 E2E protection。若直接使用后者,配置挂在根节点下:
json
{
"e2e": {
"e2e_enabled": "true",
"protected": [
{ "service_id": "0x1234", "event_id": "0x8001", "variant": "checker", "profile": "04" }
]
}
}
两个容易写错的点:variant 只接受 checker(只校验)、protector(只保护)、both(两者兼具)三个值,写成其他字符串不会报错,只是不启用任何 E2E 处理;Profile 04 的偏移等参数通过 protected 项下的自定义键传入,键名随版本变化,需按目标版本核对。
本文把 E2E 放在 SDK 层,作为跨版本、跨栈的统一实现;传输和 E2E 始终是两个层次,不能因为库自带 E2E 就省掉通信矩阵与安全配置。SecOC/TLS 不在本设计范围。
5. 配置与验证
5.1 配置模型
本节只适用于 vsomeip 路径。osp-someip 没有配置文件,参数在编译期或调用点给出,最小接入见附录 A.1.1。
vsomeip 配置外置为 JSON,主要配置项如下,完整示例见附录 A.1。
| 配置项 | 作用 | 注意 |
|---|---|---|
unicast |
本机 SOME/IP 地址 | 同一主机多进程必须一致 |
applications / routing |
application 列表与 routing 宿主 | name/ID 唯一;模式 A 指向自己,模式 B 指向宿主 |
service-discovery |
SD 组播、端口、重试参数 | vsomeip 默认是 224.224.224.0:30490,与车辆网络不一致时必须显式覆盖 |
services |
service/instance/端口/事件/eventgroup | 与通信矩阵一致;someip-tp 按需添加 |
max-payload-size-local / -unreliable |
本机与 UDP 的 payload 上限 | 填写的是 payload 字节数,vsomeip 内部自动加 16 字节头 |
5.2 可靠性与可观测性
状态推进只有一条主线:初始化与发现(Discovering / Subscribing)→ 订阅确认后 Streaming → 超时或连续错误进入 Degraded → 释放资源后 Stopped。四类典型情况的处理方式:
| 场景 | 动作 |
|---|---|
| 服务不可用 / 订阅失败 | 清空队列,回到 Discovering,退避重试 |
| 连续多个状态周期无状态包 | 判定 Degraded,触发重连 |
| 队列满 | 丢弃最旧点云包,保留状态包 |
| CRC / E2E 错误 | 丢弃当前包,记录 crc_error / e2e_error |
关键指标按四类采集:SD 与订阅事件、可用性状态、CRC/E2E 错误、队列丢弃与回调时延。示例命名 sd_offer_count、crc_error、e2e_error、queue_drop、callback_slow 都是本文建议命名,不是 SOME/IP 标准字段,可按项目规范调整。
5.3 如何验证本文的结论
文中可核对的判断都给出了验证手段,建议在集成前逐条走一遍:
bash
# 1. 指定配置并开启 debug 日志(配置写错时 vsomeip 通常只在日志里提示,不会退出)
VSOMEIP_CONFIGURATION=./radar.json VSOMEIP_APPLICATION_NAME=radar-sdk ./radar_sdk
# 2. 抓包确认 SD 与事件:先看到 Offer,再看到 Subscribe / SubscribeAck
sudo tcpdump -i eth0 -nn 'udp port 30490 or udp port 30509'
# 3. 核对事件报文长度:单包映射时应约等于 payload 加 16 字节头
sudo tcpdump -i eth0 -nn -v 'udp port 30509'
# 4. 确认同主机只有一个进程持有 SD 与事件端口
ss -lunp | grep -E '30490|30509'
判断标准(针对 vsomeip 路径):
- 上面
ss只列出一个进程,说明同主机只有一个 routing manager 在持有端口。 - 订阅确认后才出现事件报文,说明订阅流程没有靠"盲目收包"掩盖。
- 事件报文长度稳定,说明没有意外的 TP 分段或聚合。
- debug 日志中没有
max-segment-length must be multiple of 16之类的修正提示。
走 osp-someip 路径时,等价的验证入口是:cmake --preset demo 构建示例,ctest --preset host-debug 跑用例,tools/sd_probe.py 用 Python 独立核对字节,tools/vsomeip_interop.sh 与 vsomeip 双向互通。命令与环境前置见该仓库的 docs/validation_lanes_zh.md。
附录 A
A.1 vsomeip 配置示例
json
{
"unicast": "192.168.1.2",
"applications": [{ "name": "radar-sdk", "id": "0x1200" }],
"routing": "radar-sdk",
"max-payload-size-local": "1200",
"max-payload-size-unreliable": "1400",
"service-discovery": {
"enable": "true", "multicast": "239.0.0.1", "port": "30490", "protocol": "udp",
"initial_delay_min": "10", "initial_delay_max": "100",
"repetitions_base_delay": "200", "repetitions_max": "3"
},
"services": [
{
"service": "0x1234",
"instance": "0x0001",
"unreliable": "30509",
"events": [{ "event": "0x8001", "is_field": "false", "is_reliable": "false" }],
"eventgroups": [{ "eventgroup": "0x0001", "events": ["0x8001"] }]
}
],
"logging": { "level": "info", "console": "true" }
}
配置要点:
max-payload-size-local不小于单包 payload(示例 1200);max-payload-size-unreliable不超过 1400,因为 vsomeip 的 UDP 消息上限是 1416 字节且已含 16 字节头。- 未知键通常被静默忽略;配置写错不会报错,必须用日志或抓包确认。
- 模式 B 下
"routing"改为宿主应用名,application ID 使用客户分配值,全局 payload 与 SD 参数以宿主配置为准。 - 需要 TP 时,在对应 service 内追加配置。方向键为
service-to-client或client-to-service,事件/方法 ID 写在method字段;max-segment-length必须是 16 的倍数,默认 1392:
json
{
"someip-tp": {
"service-to-client": [
{ "method": "0x8001", "max-segment-length": "1392", "separation-time": "0" }
]
}
}
- SD 的时间参数单位是毫秒;
cyclic_offer_delay、ttl属于 offer 侧参数,纯客户端示例中省略。
A.1.1 osp-someip 最小接入
没有配置文件,服务与容量写在类型参数里,收发由调用方做:
cpp
#include "osp/someip/client.hpp"
struct UdpSink {
void operator()(osp::span<const std::uint8_t> datagram,
const osp::someip::Ipv4Endpoint& to) noexcept {
// 在这里对 to 调用 sendto,datagram 用完即可丢弃
}
};
struct Handler {
void OnServiceAvailable(osp::someip::ServiceInstance service) noexcept {} // 在这里发订阅
void OnSubscribeAck(std::uint16_t, std::uint16_t, std::uint16_t,
std::uint32_t) noexcept {}
void OnEvent(osp::someip::MessageView message) noexcept {} // 交给工作线程
void OnResponse(std::uint32_t request_id, osp::someip::MessageView message) noexcept {}
void OnTimeout(std::uint32_t request_id) noexcept {}
void OnServiceGone(osp::someip::ServiceInstance service) noexcept {}
void OnSenderRebooted(const osp::someip::Ipv4Endpoint& source) noexcept {}
};
UdpSink sink;
Handler handler;
osp::someip::Client<UdpSink, Handler> client(sink, handler, local_endpoint, sd_multicast_endpoint);
const auto service = osp::someip::ServiceInstance::New(0x1234U, 0x0001U, 1U);
client.StartFind(0x1234U, now_ms); // 发 Find,随后按倍增重发
client.Subscribe(service, 0x0001U, 3U, now_ms); // 服务可用后订阅事件组
client.HandleDatagram(bytes, source, now_ms); // 收到一个数据报
client.Tick(now_ms); // 推进超时、续订、服务消失
Client<Sink, Handler> 后面还有三个可选模板参数:服务表容量、在途请求数、数据报缓冲大小,默认 16 / 4 / 1400 字节,例如 Client<UdpSink, Handler, 32U, 8U, 1400U>;Server 的形态相同。local_endpoint 与 sd_multicast_endpoint 由调用方按部署给出。整条链路不分配堆,tests/no_alloc_witness.cpp 是可以直接运行的验证程序。
A.2 术语表
| 术语 | 说明 |
|---|---|
| SOME/IP | 面向服务的车载以太网协议,定义 service、method、event、字段 |
| SD | Service Discovery,服务发现,使用 30490 端口和组播 |
| Eventgroup | 一组事件的订阅单位 |
| Method | 客户端发起、服务端响应的请求 |
| TP | SOME/IP Transport Protocol,大消息分片与重组 |
| E2E | End-to-End Protection,端到端完整性、新鲜度和数据源保护 |
| routing manager(vsomeip) | 每主机唯一的网络出口与转发中心 |
| application(vsomeip) | 一个进程的 SOME/IP 句柄,拥有唯一 name 和 application ID |
| local endpoint(vsomeip) | 本机 application 与 routing manager 之间的进程间通道 |
| Sink(osp-someip) | 发送通道,作为模板参数传入,调用方提供 operator()(bytes, endpoint) |
| Tick(osp-someip) | 时间推进入口,由调用方按时调用,库本身不持有定时器 |
| TpReassembly(osp-someip) | 定容 TP 重组器,容量是模板参数,不启用时不占内存 |