AUTOSAR ComM功能及配置參數(shù)詳解

AUTOSAR ComM模塊的分享分為ComM模塊概念詳解和ComM模塊配置及代碼分析，本篇為ComM模塊配置及代碼分析篇。

1.ComM和其他模塊交互時序分析

1.1開始信號傳輸和接收（以CAN通道為例）

ComM模塊調(diào)用CanSM_Request請求CanSM開啟CAN通信，CanSM開啟通信后調(diào)用ComM_BusSM_ModeIndication通知到ComM當(dāng)前CAN通道Channel已經(jīng)切換到COMM_FULL_COMMUNICATION狀態(tài)了。ComM隨后調(diào)用CanNM模塊的Nm_NetworkRequest或者Nm_PassiveStartup接口開啟該通道的網(wǎng)絡(luò)管理。

1.2被動喚醒(以CAN通道為例)

EcuM調(diào)用ComM_EcuM_WakeUpIndication通知到ComM模塊ECU被喚醒，CanNM模塊調(diào)用ComM_Nm_RestartIndication通知到ComM網(wǎng)絡(luò)管理模塊重啟網(wǎng)絡(luò)，隨后NM調(diào)用ComM_Nm_NetworkStartIndication通知到ComM網(wǎng)絡(luò)管理模塊開始網(wǎng)絡(luò)管理。

ComM模塊中CAN通道的狀態(tài)從COMM_NO_COM_NO_PENDING_REQUEST切換到COMM_NO_COM_REQUEST_PENDING狀態(tài)。ComM模塊等待運行通信標(biāo)志CommunicationAllowed=TRUE。允許通信后，ComM模塊調(diào)用CanSM_RequestComMode請求COMM_FULL_COMMUNICATION通信。

CanSM開啟通道的通信后，ComM模塊通道切換到COMM_FULL_COM_NETWORK_REQUESTED狀態(tài)。隨后，ComM模塊調(diào)用Nm_PassiveStartUp請求NM被動開啟網(wǎng)絡(luò)管理，NM也調(diào)用ComM_Nm_NetworkMode通知到ComM當(dāng)前NM的網(wǎng)絡(luò)模式。

1.3網(wǎng)絡(luò)關(guān)閉(以CAN通道為例)

1.4通信請求

2.ComM模塊配置

ComM配置ComMConfigSet和ComMGeneral兩個頂層Container。

ComMConfigSet: 包含子配置參數(shù)Container。

ComMGeneral: ComM模塊的通用配置參數(shù)。

2.1ComMGeneral

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

ComMDirectUserMapping: 配置是否讓工具自動為每個ComMChannel映射ComMUser句柄（handler）。

ComMEcuGroupClassification: 配置模式抑制（mode inhibition）是否會影響到ECU。

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

ComMPncGatewayEnabled: 局部網(wǎng)絡(luò)網(wǎng)關(guān)是否被使能。

ComMPncPrepareSleepTimer: COMM_PNC_PREPARE_SLEEP狀態(tài)下定時器限值（以秒為計數(shù)單位）。

ComMPncSupport: 配置是否支持局部網(wǎng)絡(luò)功能。

ComMResetAfterForcingNoComm: 配置ComM進(jìn)入到無通信狀態(tài)后ComM模塊是否進(jìn)行重啟。

ComMSynchronousWakeUp: 配置是否支持通道同步喚醒（一個通道被喚醒則所有通道就被喚醒）。

ComMTMinFullComModeDuration: 配置COMM_FULL_COMMUNICATION狀態(tài)的COMM_FULL_COM_NETWORK_REQUESTED子狀態(tài)下最小的時間周期（以秒為單位）。

ComMWakeupInhibitionEnabled: 配置是否支持喚醒抑制（wake up inhibition）功能。

2.2ComMConfigSet

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

ComMChannel: 此容器包含總線通道的配置(參數(shù))。信道參數(shù)應(yīng)在整個通信堆棧內(nèi)協(xié)調(diào)一致。

ComMPnc: 該容器包含部分網(wǎng)絡(luò)集群(PNC)的配置。

ComMUser: 這個容器包含一個標(biāo)識符列表，這些標(biāo)識符用于引用系統(tǒng)中指定請求通信模式的用戶。

2.2.1ComMUser

ComMUserIdentifier:一種標(biāo)識符，用于引用系統(tǒng)中指定請求通信模式的用戶。ImplementationType: ComM_UserHandleType

用戶的概念與ECU State Manager規(guī)范中的請求者的概念非常相似。

ComMUserEcucPartitionRef: 表示請求程序在其中執(zhí)行“EcucPartition”。當(dāng)分區(qū)停止時，ComM中的通信請求將被取消，以避免由于分區(qū)停止而導(dǎo)致總線保持喚醒，這個參數(shù)基本不使用，也不配置。

2.2.2?ComMChannel

此容器包含總線通道的配置(參數(shù))。信道參數(shù)應(yīng)在整個通信堆棧內(nèi)協(xié)調(diào)一致。

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: 調(diào)用復(fù)雜驅(qū)動（CDD）的API時需要加上的前綴。

ComMChannelId: 總線通道ID。

ComMFullCommRequestNotificationEnabled: 定義是否為該通道提供接口ComM_CurrentChannelRequest的可選SenderReceiver端口。

ComMMainFunctionPeriod: ComMMainFucntion調(diào)度周期。

ComMChannel: 配置是否允許切換ComM通道狀態(tài)到COMM_SILENT_COMMUNICATION或者COMM_FULL_COMMUNICATION。在ECU運行時可以通過以下API改變這個配置參數(shù)。

ECU/All channels: ComM_LimitECUToNoComMode().

Separate channels: ComM_LimitChannelToNoComMode().

ComMNoWakeup: 配置ECU是否不允許喚醒該通道。

ComMNoWakeUpInhibitionNvmStorage: 如果該參數(shù)設(shè)置為true，則通道的NoWakeUp抑制狀態(tài)將存儲在ComMGlobalNvmBlockDescriptor所指向的塊中(以某種具體實現(xiàn)的方式)。

ComMPncGatewayType: 定義該通道局部網(wǎng)絡(luò)網(wǎng)關(guān)行為。

ComMNetworkManagement: ComMChannel的子Container，該容器包含網(wǎng)絡(luò)管理的配置參數(shù)。

ComMUserPerChannel: ComMChannel的子Container，這個容器包含一個標(biāo)識符列表，這些標(biāo)識符用于引用鏈接到通道的系統(tǒng)中的用戶。

2.2.2.1ComMNetworkManagement

ComMNmLightTimeout: 定義COMM_FULL_COMMUNICATION子狀態(tài)COMM_FULL_COM_READY_SLEEP離開后的超時時間(秒)。僅在ComMNmVariant配置為Light時使用。

ComMNmVariant: 定義網(wǎng)絡(luò)管理的功能。應(yīng)與NM配置相協(xié)調(diào)。

FULL: AUTOSAR NM可用(默認(rèn))。

LIGHT: 沒有AUTOSAR NM可用，但有關(guān)閉通道的功能。

NONE: 不使用NM網(wǎng)絡(luò)管理。

PASSIVE: AUTOSAR NM運行在被動模式可用。

如果ComMBusType = COMM_BUS_TYPE_INTERNAL則 ComMNmVariant應(yīng)該被配置為NONE。

ComMPncNmRequest: 如果這個參數(shù)等于true，那么每次由于PNC狀態(tài)機(jī)改變?yōu)镃OMM_PNC_REQUESTED而請求FULL Communication時，Nm將使用API Nm_NetworkRequest調(diào)用。

2.2.2.2ComMUserPerChannel

ComMUserPerChannel: 引用此通道用戶對應(yīng)的ComMUser。

2.2.3ComMPnc

ComMPncId: 定義局部網(wǎng)絡(luò)ID

ComMChannelPerPnc: 局部網(wǎng)絡(luò)中的ComMChannel。

ComMPncEthIfSwitchPortGroupRef: 引用與此PNC對應(yīng)的PortGroups。

ComMUserPerPnc: 參考與此PNC對應(yīng)的ComMUsers。

ComMPncComSignal: 表示PNC通信信號，用于通信該PNC的EIRA和ERA狀態(tài)。

3.ComM模塊代碼分析

AUTOSAR模塊的代碼結(jié)構(gòu)在Autosar架構(gòu)下的模塊詳細(xì)設(shè)計及代碼實現(xiàn)--基于配置的編程方法一文中我們有闡述。關(guān)注公號車端

3.1 重要數(shù)據(jù)結(jié)構(gòu)分析

（1）配置代碼

配置項結(jié)構(gòu)體：

在ComM_PBcfg.c里面定義了每一個通道配置的具體實現(xiàn)。

（2）模塊的實時狀態(tài)數(shù)據(jù)結(jié)構(gòu)

每個通道都會有一個實時的狀態(tài)機(jī)，以及一些運行中的實時狀態(tài)，這些狀態(tài)一般保存在一個全局?jǐn)?shù)據(jù)結(jié)構(gòu)當(dāng)中。

ComM.c中

這些全局變量是我們在調(diào)試ComM的時候需要觀測的重要數(shù)據(jù)結(jié)構(gòu)，通常在排查問題的時候，我們僅僅需要觀測這幾個全局變量。

3.2 主邏輯代碼分析

ComM_Main.c

ComM_Prv_ChannelMainFunction函數(shù)中的邏輯一句話概括就是：根據(jù)配置走不同的分支，根據(jù)實時請求切換狀態(tài)并執(zhí)行響應(yīng)動作。

3.3 接口/回調(diào)函數(shù)使用分析

ComM.h中聲明了所有的接口函數(shù)

同理，ComM_Nm.h中聲明了Indication函數(shù)ComM_Nm_NetworkStartIndication，ComM_Nm_NetworkStartIndication.c文件中定義了ComM_Nm_NetworkStartIndication函數(shù)。

ComM_Nm_NetworkStartIndication函數(shù)最主要的就是根據(jù)配置，更新通道狀態(tài)結(jié)構(gòu)體變量中的PassiveRequestState_u8變量。

審核編輯：劉清