【AUTOSAR】 Classic Platform COM 模块--从入门到放弃

【AUTOSAR】 Classic Platform COM 模块–从入门到放弃这份材料主要依据AUTOSAR_CP_SWS_COM.pdfR23-11整理另外参考了 RTEAUTOSAR_CP_SWS_RTE.pdf、PDU RouterAUTOSAR_CP_TPS_ECUConfiguration.pdf、BswMAUTOSAR_CP_SWS_BSWModeManager.pdf、System TemplateAUTOSAR_CP_TPS_SystemTemplate.pdf以及 Transformer、LdCom 等规范。内容偏入门重点是把COM 到底在干什么、哪些配置项会影响行为讲清楚。目录COM 模块是干什么的基本概念Signal、Signal Group 与 I-PDU打包、解包与字节序什么时候发传输属性与传输模式收到之后过滤与超时监控和周边模块怎么配合常用 API 与回调上手建议1. COM 模块是干什么的AUTOSAR 的分层结构里每一层只跟紧邻的层打交道跨层的细节都被接口挡在后面。应用层的软件组件SWC脑子里装的是车速“转速”车门开没开这类带物理含义的值而总线那头只认字节。COM 就是负责把这两种表达方式对接起来的那一层。它的位置夹在 RTE 和 PDU RouterPduR之间往上SWC 通过 RTE 读写信号。跨 ECU 通信时 RTE 会直接调用 COM 的接口比如Com_SendSignal、Com_ReceiveSignal软件集群Software Cluster则通过 ComProxy 访问 COM。往下COM 不直接操作 CAN、LIN 或以太网驱动。它收发的单位统一是 I-PDU全部交给 PduR要发送时调PduR_ComTransmit总线收到报文时 PduR 反过来回调Com_RxIndication底层发完了再回调Com_TxConfirmation。旁边还有一组管状态的模块。BswM 根据 ECU 当前状态决定哪些 I-PDU 组该开、哪些该关Com_IpduGroupStart/Com_IpduGroupStop也能按需打开或关掉接收超时监控Com_EnableReceptionDM/Com_DisableReceptionDMEcuM 负责上电时Com_Init、下电时关闭通信。有一点要说清楚COM 从不自己判断现在该不该通信。它只是按上层给的指令干活——什么时候开、什么时候关、发送周期多长全部来自配置和模式管理模块。把这些关系画出来就是这样从图上能看出 COM 的价值它在信号和I-PDU这两套数据视图之间做了隔离。上层改个信号名不用动总线配置总线换一帧格式也不用动应用代码。2. 基本概念Signal、Signal Group 与 I-PDU2.1 信号ComSignalComSignal 是 COM 眼里最小的数据单位对应通信矩阵里的一行比如车速VehicleSpeed、发动机转速EngineSpeed。每个信号在配置时会绑定到某个 I-PDU并说明自己在那帧里的位置从第几个字节的第几位开始、占多少位。位置信息来自通信矩阵工具DaVinci Configurator、EB tresos 之类最终把它翻译成Com_Cfg.c里的打包描述。2.2 信号组ComSignalGroup与 Shadow Buffer有些数据必须成组出现。发动机转速和时间戳就是一对如果转速更新了、时间戳没跟上接收端会拿到新转速 旧时间戳这种自相矛盾的组合。信号组就是为这种场景准备的——一组信号要么一起更新要么一起不更新。实现手段是给每个信号组配一块 Shadow Buffer影子缓冲区。发送和接收两条路径上的用法不太一样。发送侧应用先逐个调用Com_UpdateShadowSignal()把各个子信号写进 Shadow Buffer。此时真正的 I-PDU 发送缓冲区还没动过。所有子信号写完后再调一次Com_SendSignalGroup()。COM 在这一个调用里把 Shadow Buffer 整体拷进 I-PDU不存在拷到一半被打断的可能。之后该不该发、什么时候发仍然由这个 PDU 的传输模式决定。接收侧收到含信号组的 I-PDU 时COM 先把整组数据解包进接收侧的 Shadow Buffer。应用调用Com_ReceiveSignalGroup()这个调用会锁定 Shadow Buffer 并拿到一份快照。然后用Com_ReceiveShadowSignal()逐个读子信号。因为读的是同一份快照读出来的值必然来自同一帧。顺序别搞反接收侧必须先锁再读。否则读到一半又来了新帧前后两次读到的数据就分属不同帧等于白锁。2.3 I-PDUComIPduComIPdu 是 COM 交给 PduR 的数据块里面装着一到多个信号或信号组。一个 ComIPdu 通常就对应一帧 CAN 报文、一帧 LIN 报文或者一个以太网 payload。发不发、多久发一次、发几次——这些参数都挂在 I-PDU 上不挂在信号上。这一点在排查发送异常时很关键。2.4 Update Bit更新位Update Bit 是可选功能作用是在 PDU 里额外占一位明确告诉对面这个信号我这轮更新过。发送侧上层调用Com_SendSignal时COM 自动把该信号对应的 Update Bit 置 1等这个 I-PDU 真正发出去、或者被Com_TriggerTransmit取走之后Update Bit 清零。接收侧COM 收到 I-PDU 后先看 Update Bit。为 1说明对方确实更新了这个信号正常解包并通知上层为 0则认为对方这轮没动它直接跳过。它的价值在于区分信号值变了和信号值恰好和上轮一样。像 E2E 里带计数器的场合没有 Update Bit 就很难判断对面是真的重发还是压根没发。3. 打包、解包与字节序3.1 支持的数据类型整型boolean、uint8、uint16、uint32、uint64、sint8、sint16、sint32、sint64浮点float32、float64字节数组uint8[n]分固定长度UINT8_N和动态长度UINT8_DYN两种3.2 字节序转换COM 要处理两层字节序的差异CPU 内存里怎么放和总线上约定怎么放。这两者不一定一致转换由 COM 完成应用层不用管。小端Little-EndianIntel 格式低位字节在低地址规范里写作MostSignificantByteLast。配置项startPosition指的是信号**最低有效位LSB**所处的位置。大端Big-EndianMotorola 格式高位字节在低地址规范里写作MostSignificantByteFirst。startPosition指的是信号**最高有效位MSB**所处的位置。Opaque不透明类型用于uint8[n]数组这类不关心字节序的数据。COM 原样搬运不做任何颠倒。字节序最容易踩的坑就是把startPosition的含义记混。同一个起始位数值在小端和大端里指的是信号的两端配错了偏移量会整体偏掉。位编号方面AUTOSAR 统一采用 Sawtooth锯齿模式、位序递减一帧的第 0 字节里bit 0 是 LSB、bit 7 是 MSB信号填充时从 LSB 往 MSB 逐位递增映射。3.3 符号扩展当有符号信号的位宽小于承载它的变量类型时例如线上传 10 bit 的sint10本地用sint16接收COM 在解包时会自动做符号扩展。举个例子收到的 10 bit 值是11 1111 1101b按有符号数读出来是 -3。拷进 16 bit 变量时如果高位补 0 就变成正数 1013 了所以 COM 把高位全部补 1得到1111 1111 1111 1101b在 16 bit 下依然是 -3。这个动作不需要应用层参与但理解它有助于解释为什么接收缓冲区里读到的负值和原始帧里的字节看着对不上。4. 什么时候发传输属性与传输模式一个 I-PDU 什么时候被发出去由两件事共同决定信号级的传输属性Transfer Property和PDU 级的传输模式Transmission Mode。前者回答上层写了个新值要不要马上发后者回答这个 PDU 平时按什么节奏发。4.1 传输属性Transfer Property每个 ComSignal / ComSignalGroup 在配置时都得选一个PENDING挂起调Com_SendSignal只更新 COM 内部缓冲区不触发发送。数据等着这个 PDU 周期性发出去或者被同一个 PDU 里别的 TRIGGERED 信号顺带带出去。TRIGGERED触发调Com_SendSignal会触发该 PDU 立即发送最迟在下一次Com_MainFunctionTx里执行。TRIGGERED_ON_CHANGE变化触发只有新值和 COM 缓冲区里的旧值或初始值不一样时才触发发送。值没变就不发能省不少总线负载。TRIGGERED_WITHOUT_REPETITION/TRIGGERED_ON_CHANGE_WITHOUT_REPETITION触发行为同上两条但忽略配置的重复发送次数ComTxModeNumberOfRepetitions只发一次。第 3 条的判断基准是 COM 缓冲区里的值不是总线上的值。中间如果发送被取消过比较基准可能和预期不一致。4.2 传输模式Transmission Mode每个 ComTxIPdu 会配置一种传输模式传输模式常量发送行为直接/多次模式DIRECT由事件如 TRIGGERED 信号更新触发立即连发1 N次N 为ComTxModeNumberOfRepetitions周期模式PERIODIC按固定间隔ComTxModeTimePeriod循环发送混合模式MIXED两者结合平时按周期发一旦有 TRIGGERED 信号更新额外插入一次直接发送无发送模式NONECOM 不主动发起发送。常见于由 PduR 轮询调用的Com_TriggerTransmit场景或用作 TMS 条件为假时的禁用状态4.3 动态切换TMS每个 Tx I-PDU 都可以在ComTxModeTrue和ComTxModeFalse两套参数之间动态切换这套机制叫 TMSTransmission Mode Selection传输模式选择。评估原理I-PDU 里可以配置若干参与 TMS 评估的信号每个信号带一个ComFilter条件。只要有一个参与信号的ComFilter评估为真该 I-PDU 的 TMS 状态就是 True采用ComTxModeTrue所有参与信号都评估为假时状态为 False采用ComTxModeFalse。TMS 状态一旦变化COM 会在当前或下一次Com_MainFunctionTx中立刻按新模式发包不需要额外触发。典型用法是让一个 PDU 在空闲时慢发、有事件时快发之间切换把周期性通信的确定性和事件驱动通信的实时性放在同一帧上兼顾。5. 收到之后过滤与超时监控5.1 接收过滤Reception Filtering收到新信号时COM 可以按配置先做一次筛选只有通过过滤的数据才会更新缓冲区并通知上层。常用的ComFilterAlgorithm有ALWAYS始终放行。NEVER始终丢弃。MASKED_NEW_EQUALS_X(New_Value Mask) X时放行。MASKED_NEW_DIFFERS_X(New_Value Mask) ! X时放行。MASKED_NEW_DIFFERS_MASKED_OLD(New_Value Mask) ! (Old_Value Mask)时放行也就是只有关心的那些位变了才放行。NEW_IS_WITHIN/NEW_IS_OUTSIDE数值落在或超出区间[Min, Max]时放行。ONE_EVERY_N每收到 N 次数据只放行一次用于降低上层处理频率。5.2 接收截止时间监控Rx DM总线断了、节点掉线、报文丢了这些在实车上都可能发生。Rx DM 就是用来发现这类问题的。监控参数配在 ComRxIPdu 上ComFirstTimeout从 I-PDU 启动Com_IpduGroupStart到收到第一帧报文的允许等待时间。ComTimeout连续两帧报文之间的最大允许间隔。超时之后 COM 做两件事处理数据。按ComRxDataTimeoutAction的配置决定保持旧值NONE、替换为指定的替代值ComTimeoutSubstitutionValueREPLACE或者替换成初始值ComSignalInitValueSUBSTITUTE。通知上层。调用预先配置的回调ComUser_CbkRxTOutRTE 侧对应Rte_COMCbkRxTOut把超时事件交给应用处理。需要注意的是Rx DM 默认是开的但可以按 I-PDU 组关掉再打开Com_DisableReceptionDM/Com_EnableReceptionDM比如某些模式切换过程中不希望报超时。5.3 发送截止时间监控Tx DMTx DM 监控的是另一个方向的问题发送请求发出去之后底层PduR / CAN 驱动有没有在规定时间内回Com_TxConfirmation。如果在ComTimeout周期内没等到确认COM 会取消超时定时器并调用ComUser_CbkTxTOut把发送失败这件事告知应用层。它的典型用途是发现CAN 控制器忙不过来了或总线一直仲裁失败这类发送侧异常。6. 和周边模块怎么配合6.1 COM 与 RTE 的收发流程发送Sender-Receiver跨 ECU应用 SWC 调用Rte_Write_p_data(value)。RTE 按配置映射调用Com_SendSignal(SignalId, value)。COM 做字节序转换、符号扩展打包进 I-PDU 缓冲区置 Update Bit。COM 按该信号的 Transfer Property 判断是否需要立即发送需要就调PduR_ComTransmit(PduId, PduInfo)。底层发送成功PduR 回调Com_TxConfirmation()COM 再通过Rte_COMCbkTAck()通知 RTE。接收总线收到报文PduR 调用Com_RxIndication(PduId, PduInfo)。COM 按固定顺序做预处理重置该 I-PDU 的 Rx DM 定时器检查 Update Bit字节序转换与符号扩展无效值检查Data Invalidation接收过滤Reception Filtering重置信号级 DM 定时器通过回调如Rte_COMCbkRxAck()通知 RTESWC 调用Rte_Read_r_data(value)读出最新的信号值。这个顺序是规范定死的。测到值更新了但回调没来这类现象时按这七步从头对一遍基本能定位到问题出在哪一步。6.2 COM Based TransformerComXf面对结构体或组合数据类型逐个处理 Primitive 信号效率不高。AUTOSAR 提供了 ComXfCOM 转换器定位ComXf 位于 RTE 内部/上层把应用层的结构体对象按信号组格式序列化成线性字节数组。和普通 COM 的区别普通 COM 逐个处理 Primitive 信号ComXf 配合Com_SendSignalGroupArray()/Com_ReceiveSignalGroupArray()直接以连续内存数组的形式把数据交给 COM省掉逐信号的打包开销。6.3 Large Data COMLdCom传大块数据时刷写 Data Block、诊断大数据包、传感器点云传统 COM 的打包、解包、过滤、Update Bit 处理会带来不小的 CPU 和内存开销得不偿失。LdCom 就是为这类场景准备的零拷贝、直接传递绕过信号打包和过滤流程在 RTE 与 PduR 之间直接传字节数组指针。轻量只支持基于事件的非周期大块传输开销显著更低。6.4 E2E 保护配合传输安全关键ASIL B~D的信号时数据里要嵌入 CRC 校验码和序列计数器Sequence Counter。做法是在 COM 上层挂一个E2E TransformerE2EXf它在序列化数据的前端或后端写入 CRC 与 Counter再交给 COM或 ComXf填入 I-PDU 空间。这样即便中间经过的总线、网关都不可信端到端仍能检测出数据被篡改或重复——也就是所谓黑通道Black Channel保护。7. 常用 API 与回调7.1 上层应用 / RTE调用 COM函数原型说明Com_SendSignalStd_ReturnType Com_SendSignal(Com_SignalIdType SignalId, const void* SignalDataPtr)更新指定信号的发送缓冲区并按该信号的 Transfer Property 决定是否触发 I-PDU 发送Com_ReceiveSignalStd_ReturnType Com_ReceiveSignal(Com_SignalIdType SignalId, void* SignalDataPtr)从接收缓冲区读出指定信号的最新值Com_SendSignalGroupStd_ReturnType Com_SendSignalGroup(Com_SignalGroupIdType SignalGroupId)把 Shadow Buffer 整体原子地刷进 I-PDUCom_ReceiveSignalGroupStd_ReturnType Com_ReceiveSignalGroup(Com_SignalGroupIdType SignalGroupId)锁定并快照信号组数据到接收侧 Shadow BufferCom_UpdateShadowSignalStd_ReturnType Com_UpdateShadowSignal(Com_SignalIdType SignalId, const void* SignalDataPtr)写发送侧 Shadow Buffer 中的子信号Com_ReceiveShadowSignalStd_ReturnType Com_ReceiveShadowSignal(Com_SignalIdType SignalId, void* SignalDataPtr)读接收侧 Shadow Buffer 中的子信号Com_IpduGroupStartvoid Com_IpduGroupStart(Com_IpduGroupIdType IpduGroupId, boolean Initialize)启动指定的 I-PDU 组Com_IpduGroupStopvoid Com_IpduGroupStop(Com_IpduGroupIdType IpduGroupId)停止指定的 I-PDU 组同时取消组内挂起的发送请求和 DM 定时器Com_EnableReceptionDMvoid Com_EnableReceptionDM(Com_IpduGroupIdType IpduGroupId)使能指定 I-PDU 组的接收超时监控Com_DisableReceptionDMvoid Com_DisableReceptionDM(Com_IpduGroupIdType IpduGroupId)关闭指定 I-PDU 组的接收超时监控7.2 底层PduR调用 COM函数原型说明Com_RxIndicationvoid Com_RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr)PduR 收到总线报文后调用把原始 I-PDU 字节流交给 COMCom_TxConfirmationvoid Com_TxConfirmation(PduIdType TxPduId, Std_ReturnType result)底层发送完成后经 PduR 告知 COM 发送结果Com_TriggerTransmitStd_ReturnType Com_TriggerTransmit(PduIdType TxPduId, PduInfoType* PduInfoPtr)由 LIN、FlexRay 等轮询式总线调用请求 COM 把最新 I-PDU 数据拷到给定缓冲区7.3 COM 通知上层的回调这些回调由工具根据配置生成最终接到 SWC 的运行实体上ComUser_CbkRxAckRTE 中为Rte_COMCbkRxAck信号/信号组成功接收并读取后回调。ComUser_CbkTxAckRTE 中为Rte_COMCbkTAck发送请求拿到底层Com_TxConfirmation确认后回调。ComUser_CbkRxTOutRTE 中为Rte_COMCbkRxTOut接收超时Rx DM触发时回调。ComUser_CbkTxTOut发送确认超时Tx DM触发时回调。8. 上手建议COM 的配置项不少但真正决定行为的其实就两条线索数据怎么走应用变量 → RTE 接口 → COM 打包与字节序转换 → I-PDU 缓冲区 → PduR 路由 → 总线驱动。这条线决定了值对不对。什么时候走BswM / ComM 的模式切换 → I-PDU 组的启停 → 截止时间监控的开关。这条线决定了发不发、什么时候发。调试的时候按这两条线分开看比堆在一起翻配置快得多。给几个具体建议对着生成的代码看配置。工具最终会产出Com_Cfg.h和Com_Cfg.c里面能看到每个信号的实际ComSignalType、ComBitPosition、ComBitSize、字节序以及每个 I-PDU 的ComTxMode。配合 CANoe 抓报文对照比只看 ARXML 直观。发不出去先查三处I-PDU 组开了没有、Transfer Property 是不是配成了PENDING、TMS 当前落在ComTxModeFalse还是True。收不到先查三处Rx DM 是不是已经超时并替换了数据、ComRxDataTimeoutAction配的是哪种动作、接收过滤是否把值挡掉了尤其MASKED_*系列掩码配错会很隐蔽。信号组务必先锁再读并且不要在Com_ReceiveSignalGroup和Com_ReceiveShadowSignal之间插入可能阻塞或耗时的操作。Update Bit 不是默认能力它是配置项且会真实占用 PDU 空间。设计通信矩阵时要提前和信号对齐好位宽。