AUTOSAR ComM功能及配置参数详解
2023-5-31 17:51:28 Author: 谈思实验室(查看原文) 阅读量:13 收藏

AUTOSAR ComM模块的分享分为ComM模块概念详解和ComM模块配置及代码分析,本篇为ComM模块配置及代码分析篇。

1.ComM和其他模块交互时序分析

1.1 开始信号传输和接收(以CAN通道为例)

ComM模块调用CanSM_Request请求CanSM开启CAN通信,CanSM开启通信后调用ComM_BusSM_ModeIndication通知到ComM当前CAN通道Channel已经切换到COMM_FULL_COMMUNICATION状态了。ComM随后调用CanNM模块的Nm_NetworkRequest或者Nm_PassiveStartup接口开启该通道的网络管理。

1.2被动唤醒 (以CAN通道为例)

EcuM调用ComM_EcuM_WakeUpIndication通知到ComM模块ECU被唤醒,CanNM模块调用ComM_Nm_RestartIndication通知到ComM网络管理模块重启网络,随后NM调用ComM_Nm_NetworkStartIndication通知到ComM网络管理模块开始网络管理。ComM模块中CAN通道的状态从COMM_NO_COM_NO_PENDING_REQUEST切换到COMM_NO_COM_REQUEST_PENDING状态。ComM模块等待运行通信标志CommunicationAllowed=TRUE。允许通信后,ComM模块调用CanSM_RequestComMode请求COMM_FULL_COMMUNICATION通信。CanSM开启通道的通信后,ComM模块通道切换到COMM_FULL_COM_NETWORK_REQUESTED状态。随后,ComM模块调用Nm_PassiveStartUp请求NM被动开启网络管理,NM也调用ComM_Nm_NetworkMode通知到ComM当前NM的网络模式。

1.3网络关闭(以CAN通道为例)

1.4通信请求

ComM配置ComMConfigSet和ComMGeneral两个顶层Container。

ComMConfigSet: 包含子配置参数Container。

ComMGeneral: ComM模块的通用配置参数。

2.1 ComMGeneral

ComMGeneral主要包含ComM的一些通用配置。

ComMDirectUserMapping: 配置是否让工具自动为每个ComMChannel映射ComMUser句柄(handler)。

ComMEcuGroupClassification: 配置模式抑制(mode inhibition)是否会影响到ECU。

ComMModeLimitationEnabled: 配置模式限制(mode limitation)是否被使能(enable or disable)。

ComMPncGatewayEnabled: 局部网络网关是否被使能。

ComMPncPrepareSleepTimer: COMM_PNC_PREPARE_SLEEP状态下定时器限值(以秒为计数单位)。

ComMPncSupport: 配置是否支持局部网络功能。

ComMResetAfterForcingNoComm: 配置ComM进入到无通信状态后ComM模块是否进行重启。

ComMSynchronousWakeUp: 配置是否支持通道同步唤醒(一个通道被唤醒则所有通道就被唤醒)。

ComMTMinFullComModeDuration: 配置COMM_FULL_COMMUNICATION状态的COMM_FULL_COM_NETWORK_REQUESTED子状态下最小的时间周期(以秒为单位)。

ComMWakeupInhibitionEnabled: 配置是否支持唤醒抑制(wake up inhibition)功能。

2.2 ComMConfigSet

ComMConfigSet主要包括以下三个配置container。

ComMChannel: 此容器包含总线通道的配置(参数)。信道参数应在整个通信堆栈内协调一致。

ComMPnc: 该容器包含部分网络集群(PNC)的配置。

ComMUser: 这个容器包含一个标识符列表,这些标识符用于引用系统中指定请求通信模式的用户。

2.2.1 ComMUser

ComMUserIdentifier: 一种标识符,用于引用系统中指定请求通信模式的用户。ImplementationType: ComM_UserHandleType

用户的概念与ECU State Manager规范中的请求者的概念非常相似。

ComMUserEcucPartitionRef: 表示请求程序在其中执行“EcucPartition”。当分区停止时,ComM中的通信请求将被取消,以避免由于分区停止而导致总线保持唤醒,这个参数基本不使用,也不配置。

2.2.2 ComMChannel

此容器包含总线通道的配置(参数)。信道参数应在整个通信堆栈内协调一致。

ComMBusType: 总线类型,包括:COMM_BUS_TYPE_CAN,COMM_BUS_TYPE_CDD,COMM_BUS_TYPE_ETH,COMM_BUS_TYPE_FR,COMM_BUS_TYPE_INTERNAL,COMM_BUS_TYPE_LIN六种类型。

ComMCDDBusPrefix: 调用复杂驱动(CDD)的API时需要加上的前缀。

ComMChannelId: 总线通道ID。

ComMFullCommRequestNotificationEnabled: 定义是否为该通道提供接口ComM_CurrentChannelRequest的可选SenderReceiver端口。

ComMMainFunctionPeriod: ComMMainFucntion调度周期。

ComMChannel: 配置是否允许切换ComM通道状态到COMM_SILENT_COMMUNICATION或者COMM_FULL_COMMUNICATION。在ECU运行时可以通过以下API改变这个配置参数。

ECU/All channels: ComM_LimitECUToNoComMode().

Separate channels: ComM_LimitChannelToNoComMode().

ComMNoWakeup: 配置ECU是否不允许唤醒该通道。

ComMNoWakeUpInhibitionNvmStorage: 如果该参数设置为true,则通道的NoWakeUp抑制状态将存储在ComMGlobalNvmBlockDescriptor所指向的块中(以某种具体实现的方式)。

ComMPncGatewayType: 定义该通道局部网络网关行为。

ComMNetworkManagement: ComMChannel的子Container,该容器包含网络管理的配置参数。

ComMUserPerChannel: ComMChannel的子Container,这个容器包含一个标识符列表,这些标识符用于引用链接到通道的系统中的用户。

2.2.2.1 ComMNetworkManagement

ComMNmLightTimeout: 定义COMM_FULL_COMMUNICATION子状态COMM_FULL_COM_READY_SLEEP离开后的超时时间(秒)。仅在ComMNmVariant配置为Light时使用。

ComMNmVariant: 定义网络管理的功能。应与NM配置相协调。

FULL: AUTOSAR NM可用(默认)。

LIGHT: 没有AUTOSAR NM可用,但有关闭通道的功能。

NONE: 不使用NM网络管理。

PASSIVE: AUTOSAR NM运行在被动模式可用。

如果ComMBusType = COMM_BUS_TYPE_INTERNAL则 ComMNmVariant应该被配置为NONE。

ComMPncNmRequest: 如果这个参数等于true,那么每次由于PNC状态机改变为COMM_PNC_REQUESTED而请求FULL Communication时,Nm将使用API Nm_NetworkRequest调用。

2.2.2.2 ComMUserPerChannel

ComMUserPerChannel: 引用此通道用户对应的ComMUser。

2.2.3 ComMPnc

ComMPncId: 定义局部网络ID

ComMChannelPerPnc: 局部网络中的ComMChannel。

ComMPncEthIfSwitchPortGroupRef: 引用与此PNC对应的PortGroups。

ComMUserPerPnc: 参考与此PNC对应的ComMUsers。

ComMPncComSignal: 表示PNC通信信号,用于通信该PNC的EIRA和ERA状态。

AUTOSAR模块的代码结构在Autosar架构下的模块详细设计及代码实现--基于配置的编程方法一文中我们有阐述。关注公号车端

3.1 重要数据结构分析

(1)配置代码

配置项结构体:

在ComM_PBcfg.c里面定义了每一个通道配置的具体实现。

(2)模块的实时状态数据结构

每个通道都会有一个实时的状态机,以及一些运行中的实时状态,这些状态一般保存在一个全局数据结构当中。

ComM.c中

这些全局变量是我们在调试ComM的时候需要观测的重要数据结构,通常在排查问题的时候,我们仅仅需要观测这几个全局变量。 

3.2 主逻辑代码分析

ComM_Main.c

ComM_Prv_ChannelMainFunction函数中的逻辑一句话概括就是:根据配置走不同的分支,根据实时请求切换状态并执行响应动作。

3.3 接口/回调函数使用分析

ComM.h中声明了所有的接口函数

同理,ComM_Nm.h中声明了Indication函数ComM_Nm_NetworkStartIndication,ComM_Nm_NetworkStartIndication.c文件中定义了ComM_Nm_NetworkStartIndication函数。

ComM_Nm_NetworkStartIndication函数最主要的就是根据配置,更新通道状态结构体变量中的PassiveRequestState_u8变量。


文章来源: http://mp.weixin.qq.com/s?__biz=MzIzOTc2OTAxMg==&mid=2247522668&idx=1&sn=b57ee891054ae0e0f9666837464e89da&chksm=e927ddb7de5054a1057152d43c278a4ea601cf1258d564aa7ffed6b7d213ee8b31d4613a1dd1#rd
如有侵权请联系:admin#unsafe.sh