Communication Manager (ComM)

同步函数 ComM_Init（服务 ID 0x01）用于 AUTOSAR Communication Manager 的基本初始化，并重新启动其内部状态机 [SWS_ComM_00146]。作为输入参数，它接收 ConfigPtr，该参数作为指向类型为 const ComM_ConfigType* 的 Post-Build 配置结构的指针进行传递 [SWS_ComM_00146]。该函数没有返回值（返回类型 void），并通过头文件 ComM.h 声明 [SWS_ComM_00146]。

关于并发性，ComM_Init 被定义为不可重入（Non Reentrant）[SWS_ComM_00146]。规范数据中未指定具体调用者；推测该调用在 ECU 启动阶段作为 BSW 初始化的一部分集中进行。 问题 Q-7121f73c12407087 (未决)

在整个系统中，ComM_Init 对整个模块具有核心的控制和前提条件功能：只要 ComM 模块尚未初始化，所有模块和 API 服务均不得开始其常规运行，并且对于具有标准返回类型的服务，必须返回 E_NOT_OK [SWS_ComM_00612]。该禁令的例外情况仅适用于 ComM_Init 本身以及查询函数 ComM_GetVersionInfo 和 ComM_GetStatus [SWS_ComM_00612]。

使用

根据 [SWS_ComM_00147]，函数 ComM_DeInit 用于 AUTOSAR Communication Manager (ComM) 的去初始化。该服务采用同步设计，具有服务 ID 0x02，并通过头文件 ComM.h 声明。根据签名 void ComM_DeInit(void)，该函数不接收任何输入、输出或传递参数，且不向调用者返回任何返回值 [SWS_ComM_00147]。

错误处理

由于函数签名返回 void，因此通过接口调用不会直接反馈错误代码或状态代码 [SWS_ComM_00147]。特定的错误响应，例如通知 Development Error Tracer (DET) 或 Diagnostic Event Manager (DEM)，未包含在现有规范数据中，因此未作说明。

并发性与系统上下文

根据 [SWS_ComM_00147]，该接口被指定为不可重入（Non Reentrant）。由此对系统集成提出了强制性要求，即必须完全杜绝来自多个任务或上下文的并行或中断调用。作为对系统流程的解释，一旦 BSW 的通信通道已关闭，该调用通常由上层状态管理系统（例如 BSW Manager）在有序的 ECU 关机过程中执行。 问题 Q-f3b68dc129993cb7 (未决)

用法与调用上下文

同步且可重入的函数 ComM_RequestComMode ([SWS_ComM_00110]) 用于为一个已定义的用户 (User) 请求通信模式。它可通过 ComM.h 获取。作为 ComMode 的传入参数，仅允许以下值作为用户请求：

• COMM_FULL_COMMUNICATION：请求完全通信能力 ([SWS_ComM_00110])。
• COMM_NO_COMMUNICATION：释放或终止通信请求 ([SWS_ComM_00110])。

模式 COMM_SILENT_COMMUNICATION（用于关机同步）以及 COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST（用于下层硬件的内部唤醒触发器，例如在支持 OA TC10 的以太网硬件中）是内部状态，不得由用户请求 ([SWS_ComM_00110])。解释：传递这些内部模式大概率会以 E_NOT_OK 进行确认返回。 问题 Q-973ed1ce1845983e (未决)

返回值与错误处理

该函数通过定义的返回值 ([SWS_ComM_00110]) 指示结果：

• E_OK：已成功完成向期望通信模式的切换。
• E_NOT_OK：模式切换失败。
• COMM_E_MODE_LIMITATION：由于活动的通信抑制（Mode Inhibition），无法授予请求的模式。通信请求也可通过此类抑制而被重新释放。

交互与状态机

是否存在活动请求会影响 ComM 的通道状态机。如果通道处于带有配置 ComMNmVariant = SLAVE_ACTIVE 的子状态 COMM_FULL_COM_NETWORK_REQUESTED，且不存在对 ComM_RequestComMode(<user>, COMM_FULL_COMMUNICATION) 的活动调用，则 ComM 状态机切换到子状态 COMM_FULL_COM_READY_SLEEP ([SWS_ComM_01017])。

服务 ID 为 0x62 的同步函数 ComM_UpdatePncToChannelMapping 用于在 ECU 或 PNC 网关的 PNC 到通道映射中设置条目 [SWS_ComM_91015]。该接口通过头文件 ComM.h 提供，并在 Release R20-11 中标记为 Draft 状态 [SWS_ComM_91015]。

范围

该函数调用传入三个输入参数 [SWS_ComM_91015]：

• MappingTable：指向二维 boolean 数组（const boolean*）的指针，该数组包含 PNC 网关当前的 PNC 到通道映射，其中第一维涵盖所有相关通道，第二维涵盖所有相关 PNC [SWS_ComM_91015]。
• channelCnt：在 MappingTable 中传入的物理通道数量 [SWS_ComM_91015]。
• PncCnt：在 MappingTable 中传入的 PNC 数量 [SWS_ComM_91015]。

返回值与错误处理

该函数返回类型为 Std_ReturnType 的状态值 [SWS_ComM_91015]：

• E_OK：映射条目设置成功 [SWS_ComM_91015]。
• E_NOT_OK：设置映射条目失败 [SWS_ComM_91015]。
• COMM_E_LEARNING_ACTIVE：由于 PNC 学习阶段处于活动状态，无法执行该调用 [SWS_ComM_91015]。

并发性与限制

该接口被定义为不可重入 [SWS_ComM_91015]。因此，不得并发调用。此外，只要通信系统处于活动的 PNC 学习阶段，就禁止进行更新 [SWS_ComM_91015]。

同步且不可重入的函数 ComM_ResetPncToChannelMapping 用于将 ECU 的 PNC 到通道映射的动态条目重置为配置的默认值 [SWS_ComM_91017]。它不接受传入参数，并返回类型为 Std_ReturnType 的状态值 [SWS_ComM_91017]。

行为与返回值

该函数的行为取决于 PNC 学习阶段的状态以及通道的配置：

• 如果至少有一个通道启用了 ComMDynamicPncToChannelMappingEnabled 且 PNC 学习阶段未处于活动状态，该函数将映射重置为原始配置的默认值（静态条目）并返回 E_OK [SWS_ComM_01043]。
• 如果系统处于活动 PNC 学习阶段，且至少有一个通道的 ComMDynamicPncToChannelMappingEnabled 或 ComMDynamicPncToChannelMappingSupport 设置为 TRUE，则拒绝重置并返回 COMM_E_LEARNING_ACTIVE [SWS_ComM_01042]、[SWS_ComM_01045]。
• 如果将映射重置为默认值失败，该函数返回 E_NOT_OK [SWS_ComM_91017]。

限制与调用条件

由于 ComM_ResetPncToChannelMapping 被指定为不可重入（Non Reentrant），因此不得从并发上下文中进行同时调用 [SWS_ComM_91017]。此外，该接口处于 Draft 状态 [SWS_ComM_91017]。

用法与语义

异步函数 ComM_PnLearningRequest 触发可选的动态 PNC 到通道映射（Dynamic PNC-to-channel-mapping）[SWS_ComM_91019]。它促使 Network Management（NM）返回到 NM Repeat Message State 状态 [SWS_ComM_91019]。在此过程中，发送 Partial Network Learning Bit 以使接收节点进行响应，并发送 Repeat Message Request Bit 以使接收节点同样切换到 NM Repeat Message State 状态 [SWS_ComM_91019]。调用通过 ComM.h 中的接口进行，无需传入参数，服务 ID 为 0x64 [SWS_ComM_91019]。

返回值与错误处理

该函数返回类型为 Std_ReturnType 的状态值 [SWS_ComM_91019]：

• E_OK：PNC 学习算法已成功启动 [SWS_ComM_91019]。
• E_NOT_OK：未能启动 PNC 学习算法 [SWS_ComM_91019]。
• COMM_E_LEARNING_ACTIVE：由于 PNC 学习阶段已处于活动状态，无法执行该函数调用 [SWS_ComM_91019]。

并发与配置

该函数被指定为不可重入（Non Reentrant），并具有 draft 状态 [SWS_ComM_91019]。它仅在预配置参数 ComMDynamicPncToChannelMappingSupport 设置为 TRUE 时可用 [SWS_ComM_01044]。

同步且不可重入的函数 ComM_UpdatePncMembership 由软件组件（SWC）使用，用于调整在 PNC 学习期间传输的 PNC 成员关系，以进行可选的动态 PNC 到通道映射 [SWS_ComM_91021]。仅当配置参数 ComMDynamicPncToChannelMappingSupport 设置为 TRUE 时，它才通过头文件 ComM.h 可用 [SWS_ComM_01047]。

通过参数 ComM_PncMembership 传入一个具有 PNC 向量长度的字节数组，该数组包含节点当前的 PNC 成员关系 [SWS_ComM_91021]。如果在至少一个通道上启用了该函数且 PNC 学习阶段处于非活动状态，则评估参数 Control [SWS_ComM_01049]：

• 当为 Control = 0 时，当前的 PNC 成员关系通过与 ComM_PncMembership 进行逻辑与运算来处理，以针对性地重置掩码中的相应位 [SWS_ComM_01049]。
• 当为 Control = 1 时，应用逻辑或运算以置位掩码中的相应位 [SWS_ComM_01049]。

如果更新成功，函数返回 E_OK [SWS_ComM_01049]。相反，如果至少在一个通道上配置了动态映射且 PNC 学习阶段处于活动状态，则拒绝执行并报告特定的错误值 COMM_E_LEARNING_ACTIVE [SWS_ComM_01048]。如果在更新过程中发生其他错误，则返回 E_NOT_OK [SWS_ComM_91021]。

用法与调用上下文

根据 [SWS_ComM_00156]，函数 ComM_PreventWakeUp 用于更改特定通信通道的抑制状态 COMM_NO_WAKEUP。它以同步方式执行，并通过头文件 ComM.h 获取。

调用时传递两个输入参数：

• Channel：根据类型 NetworkHandleType 标识相关通道 ([SWS_ComM_00156])。
• Status：布尔值，用于激活 (TRUE) 或停用 (FALSE) 唤醒抑制 ([SWS_ComM_00156])。

返回值与错误处理

作为返回值，该函数根据 [SWS_ComM_00156] 返回状态 Std_ReturnType：

• E_OK：已成功更新指定通道的唤醒状态。
• E_NOT_OK：更改唤醒状态失败，例如当该功能通过 ECU 分组分类 (ComMEcuGroupClassification) 停用时。

并发性与限制

该接口被指定为不可重入（Non Reentrant）([SWS_ComM_00156])。因此调用者必须确保避免对同一实例的并行调用。

带有服务 ID 0x0b 的同步函数 ComM_LimitChannelToNoComMode 在 Communication Manager 中用于指定单个通信通道的抑制状态 [SWS_ComM_00163]。它阻止或允许通道从状态 COMM_NO_COMMUNICATION 切换到上层通信模式 [SWS_ComM_00163]。

参数与调用上下文

该接口通过头文件 ComM.h 声明，且既无输入/输出参数也无纯输出参数 [SWS_ComM_00163]。调用时传递两个输入参数 [SWS_ComM_00163]：

• Channel：通过类型为 NetworkHandleType 的标识符对相应通道进行寻址 [SWS_ComM_00163]。
• Status：作为 boolean 确定期望的抑制状态。传递 TRUE 将激活通道对 COMM_NO_COMMUNICATION 的限制，而 FALSE 重新停用此限制 [SWS_ComM_00163]。

返回值与错误处理

该函数向调用者返回类型为 Std_ReturnType 的值 [SWS_ComM_00163]：

• E_OK：已成功调整寻址通道的抑制状态 [SWS_ComM_00163]。
• E_NOT_OK：无法执行状态更改，例如在配置 ComMEcuGroupClassification（参见 ECUC_ComM_00563）停用该功能的情况下便是如此 [SWS_ComM_00163]。

并发性与系统关联

关于执行行为，该函数以同步 (Synchronous) 且不可重入 (Non Reentrant) 的方式执行 [SWS_ComM_00163]。对于整个系统级别的相同目的，存在相关函数 ComM_LimitECUToNoComMode，该函数不仅针对单个通道，而且统一步骤在 ECU 的所有通道上实现相同的限制 [SWS_ComM_00163]。

使用

同步函数 ComM_LimitECUToNoComMode（服务 ID 0x0c）在 ComM.h 中定义，用于更改整个 ECU 的抑制状态 [SWS_ComM_00124]。它阻止或允许 ECU 的所有通信通道从 COMM_NO_COMMUNICATION 切换到更高的通信模式 [SWS_ComM_00124]。通过形参 Status 进行控制：

• TRUE：激活 ECU 对模式 COMM_NO_COMMUNICATION 的限制 [SWS_ComM_00124]。
• FALSE：重新停用 ECU 对 COMM_NO_COMMUNICATION 的限制 [SWS_ComM_00124]。

错误处理与返回值

该函数向调用者返回类型为 Std_ReturnType 的状态码 [SWS_ComM_00124]：

• E_OK：ECU 的抑制状态已成功应用 [SWS_ComM_00124]。
• E_NOT_OK：抑制状态的更改失败，例如在配置参数 ComMEcuGroupClassification（参见 ECUC_ComM_00563）停用该功能的情况下 [SWS_ComM_00124]。

调用者必须评估返回值，以确定限制是成功生效还是已被模块配置拒绝 [SWS_ComM_00124]。

并发性与交互

该接口被声明为不可重入（Non Reentrant）；因此并行或中断调用是不允许的，并且必须在调用方避免 [SWS_ComM_00124]。虽然 ComM_LimitChannelToNoComMode 针对单个通道单独提供相同的控制功能，但 ComM_LimitECUToNoComMode 始终涉及 ECU 的所有通道总体 [SWS_ComM_00124]。

用法与调用上下文

同步函数 ComM_ReadInhibitCounter（服务 ID 0x0d）用于查询被拒绝的完全通信运行用户请求的数量 (COMM_FULL_COMMUNICATION) [SWS_ComM_00224]。函数声明通过头文件 ComM.h 提供 [SWS_ComM_00224]。

该函数没有输入参数。基类型为 uint16* 的指针 CounterValue 用作唯一的输出参数，被拒绝请求的计数值通过该指针传递给调用者 [SWS_ComM_00224]。如果能够成功确定并写入计数值，该函数返回 E_OK；失败时返回 E_NOT_OK [SWS_ComM_00224]。

错误处理

接口描述中未专门列出具体错误代码或标准化开发错误（DET）。以返回值 E_NOT_OK [SWS_ComM_00224] 导致的失败推测可能是由于无效的指针参数（空指针）或在 ComM 模块初始化之前调用所致（解释）。 问题 Q-5779d898381d9894 (未决)

并发性与限制

该接口被明确指定为不可重入（Non Reentrant）[SWS_ComM_00224]。因此，调用方必须在系统级确保不会发生跨不同任务或中断服务例程的并发或打断调用，以避免读取计数器时产生不一致。

使用与工作原理

同步接口 ComM_ResetInhibitCounter 用于重置 Communication Manager 中被拒绝或受阻止的完全通信请求的内部计数器（Inhibited COMM_FULL_COMMUNICATION request Counter）[SWS_ComM_00108]。该调用通过头文件 ComM.h 提供，具有服务 ID 0x0e，且不需要任何传入参数 [SWS_ComM_00108]。成功执行后，该函数返回类型为 Std_ReturnType 的返回值 E_OK [SWS_ComM_00108]。

错误处理与边界条件

如果在重置计数器时发生错误，该服务通过返回值 E_NOT_OK 来指示此情况 [SWS_ComM_00108]。本规范摘录中未列出具体的开发错误（DET）或错误场景；推测如果模块尚未初始化，则执行失败并返回 E_NOT_OK。 问题 Q-31d1ba95e419fa8e (未决)

并发性

该函数被声明为不可重入（Non Reentrant）[SWS_ComM_00108]。因此，用户必须通过适当的同步确保不会发生来自多个线程、任务或中断服务例程的并行调用，以避免计数器出现不一致。

函数 ComM_Nm_NetworkStartIndication 用作网络管理向 Communication Manager 发送的通知接口。根据 [SWS_ComM_00383]，它指示在 Bus Sleep Mode 状态期间接收到了 NM 报文，这表明网络中的某些节点已经切换到 Network Mode。

• 调用与参数：该接口通过头文件 ComM_Nm.h 声明，并接受受影响的通信通道 Channel（类型为 NetworkHandleType）作为输入参数 [SWS_ComM_00383]。
• 同步性与返回值：该调用没有返回值（void），并遵循异步执行语义 [SWS_ComM_00383]。
• 并发性：该函数分配有服务 ID 0x15，并被指定为可重入（Reentrant）[SWS_ComM_00383]。

规范中未为该接口指定具体的错误代码、DET 或 DEM 报告以及单独的错误反应 [SWS_ComM_00383]。解释：推测该指示在内部用于启动指定通道从睡眠状态向活动网络通信的转换。 问题 Q-97a02db4ab6a3af8 (未决)

在 AUTOSAR 通信管理器（ComM）中，函数 ComM_Nm_NetworkMode 充当通知回调，Network Management（Nm）借此指示已成功进入网络模式（Network Mode）[SWS_ComM_00390]。

调用与参数

该接口通过头文件 ComM_Nm.h 可用，并具有服务 ID 0x18 [SWS_ComM_00390]。调用时，通过类型为 NetworkHandleType 的唯一输入参数 Channel 传递受影响的通信通道 [SWS_ComM_00390]。该函数不返回任何返回值（返回类型为 void），且不包含任何输出参数 [SWS_ComM_00390]。

并发性与语义

ComM_Nm_NetworkMode 的执行行为被声明为异步（Asynchronous）[SWS_ComM_00390]。关于并发性，该函数被指定为可重入（Reentrant），因此可以针对并行通道事件进行可重入调用 [SWS_ComM_00390]。

错误处理

由于函数签名未提供返回值，因此不会直接向调用方传递错误码 [SWS_ComM_00390]。

函数 ComM_Nm_PrepareBusSleepMode 用作 Communication Manager（ComM）的通知接口。它向 ComM 通知指定通信通道的网络管理已切换至“Prepare Bus - Sleep Mode”状态 [SWS_ComM_00391]。

使用与签名

该接口通过头文件 ComM_Nm.h 可用，并具有服务 ID 0x19 [SWS_ComM_00391]。执行为异步进行 [SWS_ComM_00391]。函数签名包含以下参数：

• Channel（In，NetworkHandleType）：标识其网络管理已进入 Prepare-Bus-Sleep 模式的受影响网络通道 [SWS_ComM_00391]。
• 返回值：void；不返回任何状态值或错误值，也不包含输入/输出参数 [SWS_ComM_00391]。

并发性与限制

关于并发性，ComM_Nm_PrepareBusSleepMode 被指定为可重入，但具有明确的限制条件，即不适用于同一 NM 通道（Reentrant (but not for the same NM - Channel)）[SWS_ComM_00391]。因此，针对不同通道的调用可以并行发生，而针对同一通道的同时调用必须予以排除。

调用上下文与错误处理

解释：调用上下文应位于通用或特定总线的 Network Management 中，其将达到该状态的情况报告给 ComM。 问题 Q-41524322db480310 (未决)规范中未为该接口定义特定的错误码、DET 或 DEM 报告 [SWS_ComM_00391]。

使用

回调函数 ComM_Nm_BusSleepMode 用于通知 ComM 模块网络管理已切换至 Bus-Sleep 模式 [SWS_ComM_00392]。通过该调用，该函数应将关联的硬件以及收发器转换至 Bus-Sleep 模式 [SWS_ComM_00392]。

接口与参数

该函数通过头文件 ComM_Nm.h 提供，并带有服务 ID 0x1a [SWS_ComM_00392]。调用通过签名 void ComM_Nm_BusSleepMode (NetworkHandleType Channel) 进行，具有以下参数属性 [SWS_ComM_00392]：

• Channel：类型为 NetworkHandleType 的输入参数，用于标识受影响的通信通道 [SWS_ComM_00392]。
• 该函数未设计输入/输出参数，亦未设计输出参数 [SWS_ComM_00392]。
• 未定义返回值（void）[SWS_ComM_00392]。

并发性与限制

关于执行行为和可能的限制条件，该需求规定了以下基本条件 [SWS_ComM_00392]：

• 异步语义：该调用被分类为异步（Asynchronous）[SWS_ComM_00392]。
• 重入性：该函数被定义为可重入（Reentrant）[SWS_ComM_00392]。

服务 ID 为 0x1b 的回调函数 ComM_Nm_RestartIndication 由 NM-Interface 调用，并在头文件 ComM_Nm.h 中声明 [SWS_ComM_00792]。它用于在受协调总线正在进行的关断过程中，通知 Communication Manager 网络管理已重新启动 [SWS_ComM_00792]。唯一的输入参数 Channel（类型为 NetworkHandleType）指定受影响的通道；该操作不返回任何返回值 [SWS_ComM_00792]。

该接口被指定为异步且可重入 [SWS_ComM_00792]。当同时满足以下三个条件时，由 NM-Interface 调用该接口：

• NM-Interface 已开始关闭协调总线 [SWS_ComM_00792]。
• 这些受协调的总线尚未全部报告 Bus-Sleep 状态 [SWS_ComM_00792]。
• 在这些受协调的总线中，至少有一条总线重新启动了网络管理 [SWS_ComM_00792]。

如果满足这些先决条件，NM-Interface 会专门使用已指示过 Bus-Sleep 状态的那些通道的句柄来调用该函数 [SWS_ComM_00792]。

规范摘录中未规定特定的错误码、错误反应或向开发测试或错误存储模块（DET/DEM）的报告 [SWS_ComM_00792]。Interpretation: 该函数在 ComM 中应当用于将已休眠通道的内部状态重新与重新激活的总线协调对齐。

使用

函数 ComM_Nm_RepeatMessageLeftIndication 用作通知接口，向 ComM 指示所有总线 NM 模块（<Bus Nm>）的状态已退出 Repeat Message 状态 [SWS_ComM_91024]。在用于将 Partial Network Cluster 动态映射到通道的可选功能特性（Dynamic PNC-to-channel-mapping）的框架内，此调用指示学习阶段结束 [SWS_ComM_91024]。

该接口通过头文件 ComM_Nm.h 声明，且无返回值（void）[SWS_ComM_91024]。作为传入参数传递受影响的通信通道：

• Channel（In，NetworkHandleType）：报告其退出状态的通道标识 [SWS_ComM_91024]。

相互协作与功能影响

该指示的行为控制着 PNC 学习阶段：只要配置参数 ComMDynamicPncToChannelMappingEnabled 设置为 TRUE 并且调用了 ComM_Nm_RepeatMessageLeftIndication，ComM 就会将相应通道的 PNC 学习阶段（PNC Learning Phase）设置为非活动状态 [SWS_ComM_01029] [SWS_ComM_01046]。

并发性与限制

该接口被指定为可重入的，并具有异步执行语义 [SWS_ComM_91024]。在当前规范中，该元素还被标记为开发状态 draft [SWS_ComM_91024]。

函数 ComM_Nm_PncLearningBitIndication 用作模块 ComM 的通知接口，以指示接收到置位了 PNC-Learning-Bit 的 NM 报文 [SWS_ComM_91026]。该接口具有服务 ID 0x69，通过头文件 ComM_Nm.h 提供，并在规范中标记为“draft”状态 [SWS_ComM_91026]。

关于用法和签名，适用以下规定：

• 参数：作为输入参数传递类型为 NetworkHandleType 的 Channel，用于标识相关通信通道 [SWS_ComM_91026]。既没有输入/输出参数也没有输出参数，返回类型为 void [SWS_ComM_91026]。
• 并发性：该调用被指定为异步且可重入 [SWS_ComM_91026]。根据标识符和头文件，一旦接收到相应的 NM 报文，该调用通常由下层 NM 模块执行。 问题 Q-31b0ce30b88c71b6 (未决)
• 错误处理：在规范范围内，既未为该服务记录返回值，也未记录针对 DET 或 DEM 的特定错误代码或通知。

在与动态 PNC 映射的交互中，该函数控制学习阶段的激活：如果在配置参数 ComMDynamicPncToChannelMappingEnabled 设置为 TRUE 的通道上调用了 ComM_Nm_PncLearningBitIndication，则 ComM 必须将该通道的 PNC 学习阶段（PNC Learning Phase）置为激活状态 [SWS_ComM_01026]。根据规范，如果模块本身调用 Nm_PnLearningRequest，ComM 也会在相关通道上触发相同的激活学习阶段状态 [SWS_ComM_01026]。

同步且可重入的函数 ComM_Nm_ForwardSynchronizedPncShutdown（服务 ID 0x6b）通过头文件 ComM_Nm.h 声明，用于协调转发同步 PNC 关闭 [SWS_ComM_91003]。

使用与调用上下文：当扮演中间 PNC 协调器（intermediate PNC coordinator）角色的 ECU 通过总线特定的 NM 接收到 PN 关闭消息时，该函数被调用 [SWS_ComM_91003]。受影响的通信通道（Channel，类型为 NetworkHandleType）作为唯一的输入参数传入。未定义返回值（void）[SWS_ComM_91003]。

相互协作与流程：在接收到指示后，ComM 立即释放受影响的 PNC 状态机。此外，它立即将 PN 信息转发给受影响的 ComM 通道以及相应的 NM 通道 [SWS_ComM_91003]。这确保了通过分层 PN 拓扑结构从上层顶级协调器到下属 PNC 节点实现基本同步的 PNC 关闭 [SWS_ComM_91003]。

错误处理与约束条件：由于该接口没有返回值且未记录具体错误代码，因此推测错误处理在内部或通过 DET 进行。 问题 Q-618a8c1da055cdf5 (未决)该元素在 Release R20-11 中被归类为 Draft [SWS_ComM_91003]。

用法与调用上下文

同步接口 ComM_DCM_ActiveDiagnostic 用于 Diagnostic Communication Manager (DCM) 向 Communication Manager (ComM) 通知特定通信通道上的活跃诊断活动 [SWS_ComM_00873]。该函数在头文件 ComM_Dcm.h 中定义，并标明服务 ID 为 0x1f [SWS_ComM_00873]。

数据类型为 NetworkHandleType 的输入参数 Channel 作为唯一的调用参数，用于唯一标识即将进行诊断通信的受影响通道 [SWS_ComM_00873]。该接口没有返回值（返回类型 void），且既不存在输入/输出参数，也不存在输出参数 [SWS_ComM_00873]。

并发性与限制

关于并发性，该服务元素被指定为可重入 [SWS_ComM_00873]。这允许从不同的执行上下文中并行同步调用该函数，例如当 DCM 必须同时管理或服务多个网络通道时。

错误处理与交互

对于此调用，未规定单独的错误代码，也未规定向开发错误管理（DET）以及诊断故障存储器管理（DEM）发送报告 [SWS_ComM_00873]。交互仅限于 DCM 与 ComM 之间的信号交换；Interpretation: 在 ComM 中，该调用大概用于在诊断活动持续期间将相应通道保持在活跃通信状态 [SWS_ComM_00873]。 问题 Q-bfd91da2e435fbb6 (未决)

使用

同步函数 ComM_DCM_InactiveDiagnostic 用于 Diagnostic Communication Manager (DCM) 向 Communication Manager (ComM) 指示特定通道上的诊断通信处于非活动状态且不再需要 [SWS_ComM_00874]。该接口的声明通过头文件 ComM_Dcm.h 提供，服务 ID 为 0x20 [SWS_ComM_00874]。

作为输入参数传递类型为 NetworkHandleType 的 Channel，用于标识相关的通信通道 [SWS_ComM_00874]。该函数既无输入/输出参数也无输出参数，且不返回值（void） [SWS_ComM_00874]。

并发与错误处理

该接口被指定为可重入的 [SWS_ComM_00874]，因此允许并发调用（例如针对不同的通信通道）。有效载荷中未针对该函数定义特定的错误码、DET 错误消息或 DEM 事件 [SWS_ComM_00874]。ComM 模块应当在内部利用该非活动消息来撤销该通道现有的诊断请求，并相应调整通道状态。 问题 Q-148d39d8c17e936c (未决)

函数 ComM_EcuM_WakeUpIndication 用于将相应受影响通信通道上发生的唤醒事件通知给 Communication Manager（ComM）[SWS_ComM_00275]。一旦 ECU State Manager（EcuM）在某个通道上登记了相应的唤醒，该调用通常应由其发起。 问题 Q-5f8c43b9df10dc8e (未决)

用法与调用上下文

该接口被定义为同步，并具有服务 ID 0x2a [SWS_ComM_00275]。通过类型为 NetworkHandleType 的输入参数 Channel 传递检测到唤醒的通信通道标识符 [SWS_ComM_00275]。该函数无返回值（void），并通过头文件 ComM_EcuM.h 声明 [SWS_ComM_00275]。

并发性与限制

根据规范，ComM_EcuM_WakeUpIndication 被归类为可重入 [SWS_ComM_00275]。因此允许针对不同通道或从并发上下文中并行调用该函数。在元素定义中未指明具体的错误码、返回值或 DET/DEM 报告 [SWS_ComM_00275]。

用法与调用上下文

同步函数 ComM_EcuM_PNCWakeUpIndication 用于向 Communication Manager 通知 Partial Network Cluster (PNC) 上的唤醒 [SWS_ComM_91001]。它通过头文件 ComM_EcuM.h 声明，并需要受影响集群的标识作为输入参数 PNCid；不存在返回值 [SWS_ComM_91001]。Interpretation: 该调用通常由 ECU State Manager (EcuM) 在检测到相应的 PNC 事件时执行。 问题 Q-fee4a70f73cde8ea (未决)

并发性与状态转换

该接口被指定为可重入 [SWS_ComM_91001]。其调用会在 ComM 的 PNC 状态机和通道状态机内引起针对性的状态转换：

• 如果引用的集群处于 PNC 主状态 PNC_NO_COMMUNICATION，则退出该状态并切换至 PNC 子状态 PNC_PREPARE_SLEEP [SWS_ComM_00964]。
• 如果在启用 PNC 支持（ComMPncSupport=TRUE）且禁用同步唤醒（ComMSynchronousWakeUp=FALSE）的情况下于子状态 COMM_NO_COM_NO_PENDING_REQUEST 中执行调用，则该模块将由指定 PNC 所引用的那些 ComM 通道状态机转换到子状态 COMM_NO_COM_REQUEST_PENDING [SWS_ComM_01014]。
• 反之，若在激活 ComMPncSupport 的情况下配置了 ComMSynchronousWakeUp=TRUE，则在子状态 COMM_NO_COM_NO_PENDING_REQUEST 中的调用将无例外地把所有 ComM 通道状态机切换到子状态 COMM_NO_COM_REQUEST_PENDING [SWS_ComM_01015]。

通过函数 ComM_CommunicationAllowed（[SWS_ComM_00871]），EcuM 或 BswM 向模块 ComM 指示特定通道的通信是否已被使能。

用法与调用上下文

该接口由模块 EcuM 或 BswM 调用；如果使用 EcuM Flex，则由 BswM 接管该任务（[SWS_ComM_00871]）。该函数通过头文件 ComM_BswM.h 声明，且具有服务 ID 0x35（[SWS_ComM_00871]）。

该函数没有返回值（void），并要求以下传入参数（[SWS_ComM_00871]）：

• Channel（类型 NetworkHandleType）：标识受影响的通信通道（[SWS_ComM_00871]）。
• Allowed（类型 boolean）：传递使能状态，TRUE 表示允许通信，FALSE 表示不允许通信（[SWS_ComM_00871]）。

并发性与限制

根据规范，该函数以异步方式工作（Asynchronous），并被归类为不可重入（Non Reentrant）（[SWS_ComM_00871]）。由于其不可重入性，调用方可能需要确保不会对该接口发生并行或打断调用。 问题 Q-e6688e3286d9ed60 (未决)

使用与签名

接口 ComM_BusSM_ModeIndication 用于主管 Bus State Manager 向 ComM 模块指示实际总线模式 [SWS_ComM_00675]。该 C 函数可通过头文件 ComM.h 获取，并在服务 ID 0x33 下管理 [SWS_ComM_00675]。其语法为 void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode) [SWS_ComM_00675]。

该函数接收两个输入参数：

• Channel：受影响的通信通道，类型为 NetworkHandleType [SWS_ComM_00675]。
• ComMode：总线的实际模式，类型为 ComM_ModeType [SWS_ComM_00675]。

该接口无返回值（void），并且既未定义输入/输出参数，也未定义纯返回参数 [SWS_ComM_00675]。

并发与同步

关于运行时行为，规定调用是异步进行的（Asynchronous），且该函数可以可重入地（Reentrant）执行 [SWS_ComM_00675]。

整个系统中的交互

ComM 模块将通过此调用报告的状态转发给用户 [SWS_ComM_00675]。总线状态的这种传播通过 RTE 和 BswM 的接口进行 [SWS_ComM_00675]。

使用

同步服务函数 ComM_BusSM_BusSleepMode 用于主管 Bus State Manager (BusSM) 向 Communication Manager (ComM) 发送通知，表明通信通道的实际总线模式已切换至 Bus-Sleep 状态 [SWS_ComM_91000]。受影响通道的标识通过类型为 NetworkHandleType 的输入参数 Channel 进行 [SWS_ComM_91000]。该函数既未声明输出参数，也未声明返回值（void） [SWS_ComM_91000]。

取决于配置的有效性

该调用并非普遍允许，而是明确限制于参数 ComMNmVariant 设置为 SLAVE_ACTIVE 或 SLAVE_PASSIVE 的 ComM 通道 [SWS_ComM_91000]。为此，规范列举了两种典型的应用场景：

• 配置为 ComMNmVariant = SLAVE_ACTIVE 的 LIN 从节点 [SWS_ComM_91000]。
• 采用符合 OPEN Alliance TC10 的硬件且作为被动通信从节点运行的以太网通道，其中 ComMNmVariant = SLAVE_PASSIVE 且参数 EthTrcvActAsSlavePassiveEnabled 设定为 TRUE [SWS_ComM_91000]。

并发与集成

该接口的服务 ID 为 0x34，通过头文件 ComM.h 声明，并归类为可重入 [SWS_ComM_91000]。在函数定义中未列出特定的错误码或发生错误时的特殊行为 [SWS_ComM_91000]。

枚举类型 ComM_InitStatusType 用于表示 ComM（COM Manager）模块的初始化状态，可通过头文件 ComM.h 获取 [SWS_ComM_00668]。

取值范围恰好包含两个状态，用于区分运行就绪状态 [SWS_ComM_00668]：

• COMM_UNINIT（编码值为 0x00 或 0）：指示 COM Manager 未初始化或不可用。在复位后，该状态强制为默认值 [SWS_ComM_00668]。
• COMM_INIT（编码值为 0x01）：指示 COM Manager 已正确初始化且就绪可用 [SWS_ComM_00668]。

关于时间顺序和模块使用，该状态标明了 COM Manager 的基本可用性 [SWS_ComM_00668]。Interpretation: 调用者或模块内部例程应当评估此状态，以确保不会在状态 COMM_UNINIT 下处理通信请求，因为规范明确规定 COM Manager 在此状态下不可用 [SWS_ComM_00668]。 问题 Q-2c4da2e5c40a0f4b (未决)只有在成功切换到 COMM_INIT 之后，该模块才可用于上层交互。

枚举类型 ComM_PncModeType 定义 Communication Manager 中 Partial Network Cluster（PNC）的当前运行状态 [SWS_ComM_00673]。该类型通过头文件 ComM.h 提供，包含五个离散状态 [SWS_ComM_00673]：

• COMM_PNC_REQUESTED (0x00)：PNC 由本地 ComM 用户请求。
• COMM_PNC_READY_SLEEP (0x01)：PNC 由远程 ComM 用户请求。
• COMM_PNC_PREPARE_SLEEP (0x02)：PNC 处于激活状态，但没有期限监控（Deadline Monitoring）。
• COMM_PNC_NO_COMMUNICATION (0x03)：PNC 未发生通信。
• COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST (0x04)：本地 PNC 请求，并向 BswM 发送额外的硬件唤醒请求。

在与 BswM 的协作中，模式 COMM_PNC_REQUESTED_WITH_WAKEUP_REQUEST 用于指示活动请求还应额外触发通信硬件的唤醒 [SWS_ComM_00673]。这以该功能受支持且已配置为前提，例如符合 OA TC10 的以太网交换机的端口切换 [SWS_ComM_00673]。需要注意的限制是，在 R20-11 发行版中，该模式带有 draft 状态 [SWS_ComM_00673]。

由于它纯属类型定义，因此 ComM_PncModeType 不存在专门的错误处理例程或可重入性规定。

Interpretation: 由于该类型在 ComM.h 中声明，且 BswM 作为模式信息的接收者被寻址，因此该数据类型应当跨模块用作 PNC 状态消息的接口参数。 问题 Q-88ad945ffcf90e9e (未决)

使用和定义

类型 ComM_StateType 表示 AUTOSAR Classic Platform 中 Communication Manager (ComM) 内部状态机的状态和子状态 [SWS_ComM_00674]。它基于标准类型 uint8 定义为一个独立类型，并通过头文件 ComM.h 提供给软件组件和 BSW 模块 [SWS_ComM_00674]。

取值范围和子状态

取值范围包含五个固定值，它们反映了通信状态机的精确阶段 [SWS_ComM_00674]：

• COMM_NO_COM_NO_PENDING_REQUEST（值 0）：表示当前没有通信请求时 No Communication 内的状态 [SWS_ComM_00674]。
• COMM_NO_COM_REQUEST_PENDING（值 1）：表示有通信请求挂起时 No Communication 内的状态 [SWS_ComM_00674]。
• COMM_FULL_COM_NETWORK_REQUESTED（值 2）：表示网络已被主动请求时 Full Communication 内的状态 [SWS_ComM_00674]。
• COMM_FULL_COM_READY_SLEEP（值 3）：表示不再存在活跃请求且网络已准备好进入休眠时 Full Communication 内的状态 [SWS_ComM_00674]。
• COMM_SILENT_COM（值 4）：对应于通信模式 Silent Communication [SWS_ComM_00674]。

与通信模式的映射关系

ComM_StateType 的值与 ComM 的上级通信模式（Communication Modes）存在直接对应关系 [SWS_ComM_00674]。带有前缀 COMM_NO_COM* 的所有状态均归属于模式 No Communication，而带有前缀 COMM_FULL_COM* 的状态则对应于模式 Full Communication [SWS_ComM_00674]。值 COMM_SILENT_COM 映射同名的通信模式 Silent Communication [SWS_ComM_00674]。

数据类型 ComM_ModeType 在 Communication Manager 中映射当前的通信模式，从而映射 ComM 通道状态机的主要状态 [SWS_ComM_00672]。它派生自基本类型 uint8，并通过头文件 Rte_ComM_Type.h 提供给软件组件和其他 BSW 模块使用 [SWS_ComM_00672]。

取值范围包括四种离散的操作模式，这些模式定义了相应通道的通信能力 [SWS_ComM_00672]：

• COMM_NO_COMMUNICATION (0)：所配置的通道处于静默状态，既不具备发送能力也不具备接收能力 [SWS_ComM_00672]。
• COMM_SILENT_COMMUNICATION (1)：通道仅限于被动接收能力；禁止发送报文 [SWS_ComM_00672]。
• COMM_FULL_COMMUNICATION (2)：通道处于具有主动发送和接收能力的完全通信运行状态 [SWS_ComM_00672]。
• COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST (3)：通道具有向下层的发送和接收能力，例如符合 OPEN Alliance TC10 的以太网硬件 [SWS_ComM_00672]。

使用时存在重要的功能限制：模式 COMM_FULL_COMMUNICATION_WITH_WAKEUP_REQUEST 带有标签 atp.Status=draft，且明确仅供 ComM 通道状态机内部使用 [SWS_ComM_00672]。因此，外部用户或上层软件组件大概既不得将此状态作为目标模式进行请求，也不得通过接口直接期待此状态。 问题 Q-e5f4abe0d6543c82 (未决)该类型未定义特定的错误码、运行时检查或向 DET 或 DEM 的报告 [SWS_ComM_00672]。

根据 [SWS_ComM_01009]，规范元素 modeLimitation 被定义为通信管理器（ComM）针对接口 ComM_ECUModeLimitation 的提供端口（Provided Port）。Interpretation: 通过该端口接口，模块 ComM 应当向上层软件组件或 BswM 提供用于在 ECU 级别针对性限制活动通信模式的机制，以例如保障功耗或运行模式。 问题 Q-337c6b40bd72cf76 (未决)

系统中所提供该端口受显式变体条件的约束：根据 [SWS_ComM_01009]，仅当配置选项 {ecuc(ComM/ComMGeneral.ComMModeLimitationEnabled)} == true 被置位时，该元素才存在于系统中。禁用此参数大概会导致在代码生成期间省略该端口。 问题 (未决)因此，应用和基础软件组件仅在选项被激活时才可在架构上连接该接口。

关于具体的接口操作、参数、可重入性以及向 DET 或 DEM 的错误消息，[SWS_ComM_01009] 未包含单独的规定。因此，集成商尤其必须在将组件与端口 modeLimitation 连接之前，确保容器 ComMGeneral 中的所需配置已激活。

类型 ComMMode 在 ComM 模块中被指定为 Mode Declaration Group [SWS_ComM_01012]。该元素归属于类别 ALPHABETIC_ORDER，并定义该模块的基本通信模式 [SWS_ComM_01012]。

该组包含三个具有约束力的状态 [SWS_ComM_01012]：

• COMM_NO_COMMUNICATION：用作该组的初始模式 [SWS_ComM_01012]。
• COMM_SILENT_COMMUNICATION：表示被动通信模式 [SWS_ComM_01012]。
• COMM_FULL_COMMUNICATION：表示无限制的通信运行 [SWS_ComM_01012]。

COMM_NO_COMMUNICATION 被指定为初始模式，因此系统默认在无活动通信的情况下启动 [SWS_ComM_01012]。未为转换定义单独的值（“On transition value”）[SWS_ComM_01012]；Interpretation: 这大概意味着状态切换是直接进行的，没有定义的中间状态。 问题 Q-f0e73d26f85073b4 (未决)Interpretation: 这些模式应当映射模块中通道或通信用户的通信状态。 问题 Q-ef5fa29f6af152c7 (未决)Interpretation: 类别 ALPHABETIC_ORDER 应当主要为 RTE 的接口规定标准化的枚举和表示。 问题 Q-12af3dde3a4cc95e (未决)