AUTOSAR Classic Communication Services
Die Communication Services bilden das nachrichten- und signalbasierte Rückgrat der BSW: Signalextraktion, PDU-Routing ohne Payload-Inspektion (PduR) und ECU-weites Kommunikations- und Kanalmanagement (ComM).
التهيئة والحالة
Com_DeInitCom_GetStatusCom_GetVersionInfoCom_InitComM_DeInitComM_GetStatusComM_GetVersionInfoComM_InitComXf_DeInitComXf_GetVersionInfoComXf_InitE2EXf_DeInitE2EXf_GetVersionInfoE2EXf_InitIpduM_GetVersionInfoIpduM_InitLdCom_DeInitLdCom_GetVersionInfoLdCom_InitMip_DeInitMip_GetVersionInfoMip_InitMirror_DeInitMirror_GetVersionInfoMirror_InitNm_GetVersionInfoNm_InitPduR_GetVersionInfoPduR_InitSomeIpXf_DeInitSomeIpXf_GetVersionInfoSomeIpXf_InitXcp_GetVersionInfoXcp_Initالخدمات · Get…
الخدمات · Inv…
الخدمات · transformer…
الخدمات · Nm…
الخدمات · Receive…
الخدمات · Send…
الخدمات · Add…
الخدمات · Ld…
الخدمات · Network…
الخدمات · Report…
الخدمات · Set…
الخدمات · Bus…
الخدمات · Disable…
الخدمات · Enable…
الخدمات · Return…
الخدمات · Update…
الخدمات · أخرى
Com_InvalidateSignalCom_InvalidateSignalGroupCom_IpduGroupStartCom_IpduGroupStopCom_SwitchIpduTxModeCom_TriggerIPDUSendCom_TriggerIPDUSendWithMetaDataComM_CommunicationAllowedComM_DCM_ActiveDiagnosticComM_DCM_InactiveDiagnosticComM_EcuM_PNCWakeUpIndicationComM_EcuM_WakeUpIndicationComM_LimitChannelToNoComModeComM_LimitECUToNoComModeComM_PnLearningRequestComM_PreventWakeUpComM_ReadInhibitCounterComM_RequestComModeComM_ResetInhibitCounterComM_ResetPncToChannelMappingIpduM_TransmitLdCom_TransmitMip_ExtractProtocolHeaderFieldsMirror_IsMirrorActiveMirror_IsSourceNetworkStartedMirror_OfflineMirror_RemoveFilterMirror_StartSourceNetworkMirror_StopSourceNetworkMirror_SwitchDestNetworkNm_CarWakeUpIndicationNm_CheckRemoteSleepIndicationNm_CoordReadyToSleepCancellationNm_CoordReadyToSleepIndicationNm_ForwardSynchronizedPncShutdownNm_ForwardSynchronizedPncShutdown#2Nm_PassiveStartUpNm_PncBitVectorTxIndicationNm_PnLearningRequestNm_PrepareBusSleepModeNm_RemoteSleepCancellationNm_RemoteSleepIndicationNm_RepeatMessageIndicationNm_RepeatMessageRequestNm_RequestSynchronizedPncShutdownNm_StateChangeNotificationNm_SynchronizationPointNm_SynchronizeModeNm_TxTimeoutExceptionSomeIpXf_ExtractProtocolHeaderFieldsXcp_LoTriggerTransmitدوال الاستدعاء الراجع
Com_CbkCounterErrCom_CbkInvCom_CbkRxAckCom_CbkRxTOutCom_CbkTxAckCom_CbkTxErrCom_CbkTxPrepCom_CbkTxTOutCom_CopyRxDataCom_CopyTxDataCom_RxIndicationCom_StartOfReceptionCom_TpRxIndicationCom_TpTxConfirmationCom_TriggerTransmitCom_TxConfirmationIpduM_RxIndicationIpduM_TriggerTransmitIpduM_TxConfirmationLdCom_CopyRxDataLdCom_CopyTxDataLdCom_RxIndicationLdCom_StartOfReceptionLdCom_TpRxIndicationLdCom_TpTxConfirmationLdCom_TriggerTransmitLdCom_TxConfirmationMirror_TriggerTransmitMirror_TxConfirmationNm_PduRxIndicationNm_PncBitVectorRxIndicationNm_PncBitVectorTxConfirmationXcp_LoRxIndicationXcp_LoTxConfirmationدوال Callout والواجهات المتوقعة
<LdComUser_LdComCbkCopyRxData><LdComUser_LdComCbkCopyTxData><LdComUser_LdComCbkRxIndication><LdComUser_LdComCbkStartOfReception><LdComUser_LdComCbkTpRxIndication><LdComUser_LdComCbkTpTxConfirmation><LdComUser_LdComCbkTriggerTransmit><LdComUser_LdComCbkTxConfirmation><NmCarWakeUpCallout>Com_RxIpduCalloutCom_TxIpduCalloutدورية
Com_MainFunctionRouteSignalsCom_MainFunctionRxCom_MainFunctionTxIpduM_MainFunctionRxIpduM_MainFunctionTxMirror_MainFunctionNm_MainFunctionXcp_MainFunctionالأنواع
Com_ConfigTypeCom_IpduGroupIdTypeCom_SignalGroupIdTypeCom_SignalIdTypeCom_StatusTypeComM_ConfigTypeComM_InitStatusTypeComM_ModeTypeComM_PncMembershipTypeComM_PncModeTypeComM_StateTypeComM_UserHandleArrayTypeComM_UserHandleSubArrayTypeComM_UserHandleTypeComMModeComXf_ConfigTypeE2EXf_ConfigTypeE2EXf_CSTransactionHandleTypeIpduM_ConfigTypeLdCom_ConfigTypeMirror_CanIdTypeMirror_ConfigTypeMirror_FlexRayChannelTypeMirror_NetworkTypemodeLimitationNm_BusNmTypeNm_ConfigTypeNm_ModeTypeNm_StateTypePduR_PBConfigIdTypePduR_PBConfigTypePduR_RoutingPathGroupIdTypePduR_StateTypeSomeIpXf_ConfigTypeXcp_ConfigTypeXcp_TransmissionModeType{Mip}_ConfigTypeالدوال
<LdComUser_LdComCbkCopyRxData><LdComUser_LdComCbkCopyTxData><LdComUser_LdComCbkRxIndication><LdComUser_LdComCbkStartOfReception><LdComUser_LdComCbkTpRxIndication><LdComUser_LdComCbkTpTxConfirmation><LdComUser_LdComCbkTriggerTransmit><LdComUser_LdComCbkTxConfirmation><NmCarWakeUpCallout>Com_CbkCounterErrCom_CbkInvCom_CbkRxAckCom_CbkRxTOutCom_CbkTxAckCom_CbkTxErrCom_CbkTxPrepCom_CbkTxTOutCom_CopyRxDataCom_CopyTxDataCom_DeInitCom_DisableReceptionDMCom_EnableReceptionDMCom_GetStatusCom_GetVersionInfoCom_InitCom_InvalidateSignalCom_InvalidateSignalGroupCom_IpduGroupStartCom_IpduGroupStopCom_MainFunctionRouteSignalsCom_MainFunctionRxCom_MainFunctionTxCom_ReceiveDynSignalCom_ReceiveDynSignalWithMetaDataCom_ReceiveSignalCom_ReceiveSignalGroupCom_ReceiveSignalGroupArrayCom_ReceiveSignalGroupArrayWithMetaDataCom_ReceiveSignalGroupWithMetaDataCom_ReceiveSignalWithMetaDataCom_RxIndicationCom_RxIpduCalloutCom_SendDynSignalCom_SendDynSignalWithMetaDataCom_SendSignalCom_SendSignalGroupCom_SendSignalGroupArrayCom_SendSignalGroupArrayWithMetaDataCom_SendSignalGroupWithMetaDataCom_SendSignalWithMetaDataCom_StartOfReceptionCom_SwitchIpduTxModeCom_TpRxIndicationCom_TpTxConfirmationCom_TriggerIPDUSendCom_TriggerIPDUSendWithMetaDataCom_TriggerTransmitCom_TxConfirmationCom_TxIpduCalloutComM_BusSM_BusSleepModeComM_BusSM_ModeIndicationComM_CommunicationAllowedComM_DCM_ActiveDiagnosticComM_DCM_InactiveDiagnosticComM_DeInitComM_EcuM_PNCWakeUpIndicationComM_EcuM_WakeUpIndicationComM_GetCurrentComModeComM_GetCurrentPNCComModeComM_GetInhibitionStatusComM_GetMaxComModeComM_GetPncToChannelMappingComM_GetRequestedComModeComM_GetStatusComM_GetVersionInfoComM_InitComM_LimitChannelToNoComModeComM_LimitECUToNoComModeComM_Nm_BusSleepModeComM_Nm_ForwardSynchronizedPncShutdownComM_Nm_NetworkModeComM_Nm_NetworkStartIndicationComM_Nm_PncLearningBitIndicationComM_Nm_PrepareBusSleepModeComM_Nm_RepeatMessageLeftIndicationComM_Nm_RestartIndicationComM_PnLearningRequestComM_PreventWakeUpComM_ReadInhibitCounterComM_RequestComModeComM_ResetInhibitCounterComM_ResetPncToChannelMappingComM_SetECUGroupClassificationComM_UpdatePncMembershipComM_UpdatePncToChannelMappingComXf_DeInitComXf_GetVersionInfoComXf_InitComXf_Inv_transformerIdComXf_transformerIdE2EXf_DeInitE2EXf_GetVersionInfoE2EXf_InitE2EXf_Inv_transformerIdE2EXf_transformerIdIpduM_GetVersionInfoIpduM_InitIpduM_MainFunctionRxIpduM_MainFunctionTxIpduM_RxIndicationIpduM_TransmitIpduM_TriggerTransmitIpduM_TxConfirmationLdCom_CopyRxDataLdCom_CopyTxDataLdCom_DeInitLdCom_GetVersionInfoLdCom_InitLdCom_RxIndicationLdCom_StartOfReceptionLdCom_TpRxIndicationLdCom_TpTxConfirmationLdCom_TransmitLdCom_TriggerTransmitLdCom_TxConfirmationMip_DeInitMip_ExtractProtocolHeaderFieldsMip_GetVersionInfoMip_InitMip_Inv_transformerIdMip_Inv_transformerId#2Mip_Inv_transformerId#3Mip_Inv_transformerId#4Mip_transformerIdMip_transformerId#2Mip_transformerId#3Mip_transformerId#4Mirror_AddCanMaskFilterMirror_AddCanRangeFilterMirror_AddFlexRayFilterMirror_AddLinMaskFilterMirror_AddLinRangeFilterMirror_DeInitMirror_GetDestNetworkMirror_GetNetworkHandleMirror_GetNetworkIdMirror_GetNetworkTypeMirror_GetStaticFilterStateMirror_GetVersionInfoMirror_InitMirror_IsMirrorActiveMirror_IsSourceNetworkStartedMirror_MainFunctionMirror_OfflineMirror_RemoveFilterMirror_ReportCanFrameMirror_ReportFlexRayChannelStatusMirror_ReportFlexRayFrameMirror_ReportLinFrameMirror_SetStaticFilterStateMirror_StartSourceNetworkMirror_StopSourceNetworkMirror_SwitchDestNetworkMirror_TriggerTransmitMirror_TxConfirmationNm_BusSleepModeNm_CarWakeUpIndicationNm_CheckRemoteSleepIndicationNm_CoordReadyToSleepCancellationNm_CoordReadyToSleepIndicationNm_DisableCommunicationNm_EnableCommunicationNm_ForwardSynchronizedPncShutdownNm_ForwardSynchronizedPncShutdown#2Nm_GetLocalNodeIdentifierNm_GetNodeIdentifierNm_GetPduDataNm_GetStateNm_GetUserDataNm_GetVersionInfoNm_InitNm_MainFunctionNm_NetworkModeNm_NetworkReleaseNm_NetworkRequestNm_NetworkStartIndicationNm_PassiveStartUpNm_PduRxIndicationNm_PncBitVectorRxIndicationNm_PncBitVectorTxConfirmationNm_PncBitVectorTxIndicationNm_PnLearningRequestNm_PrepareBusSleepModeNm_RemoteSleepCancellationNm_RemoteSleepIndicationNm_RepeatMessageIndicationNm_RepeatMessageRequestNm_RequestSynchronizedPncShutdownNm_SetUserDataNm_StateChangeNotificationNm_SynchronizationPointNm_SynchronizeModeNm_TxTimeoutExceptionNm_UpdateIRAPduR_DisableRoutingPduR_EnableRoutingPduR_GetConfigurationIdPduR_GetVersionInfoPduR_InitReq_ReturnTypeRte_LdComCbkCopyRxData_snReq_ReturnTypeRte_LdComCbkCopyTxData_snReq_ReturnTypeRte_LdComCbkStartOfReception_snRte_LdComCbkRxIndication_snRte_LdComCbkTpRxIndication_snRte_LdComCbkTpTxConfirmation_snRte_LdComCbkTriggerTransmit_snRte_LdComCbkTxConfirmation_snSomeIpXf_DeInitSomeIpXf_ExtractProtocolHeaderFieldsSomeIpXf_GetVersionInfoSomeIpXf_InitSomeIpXf_Inv_transformerIdSomeIpXf_Inv_transformerId#2SomeIpXf_Inv_transformerId#3SomeIpXf_transformerIdSomeIpXf_transformerId#2SomeIpXf_transformerId#3Xcp_GetVersionInfoXcp_InitXcp_LoRxIndicationXcp_LoTriggerTransmitXcp_LoTxConfirmationXcp_MainFunctionXcp_SetTransmissionModeالأنواع
Com_ConfigTypeCom_IpduGroupIdTypeCom_SignalGroupIdTypeCom_SignalIdTypeCom_StatusTypeComM_ConfigTypeComM_InitStatusTypeComM_ModeTypeComM_PncMembershipTypeComM_PncModeTypeComM_StateTypeComM_UserHandleArrayTypeComM_UserHandleSubArrayTypeComM_UserHandleTypeComMModeComXf_ConfigTypeE2EXf_ConfigTypeE2EXf_CSTransactionHandleTypeIpduM_ConfigTypeLdCom_ConfigTypeMirror_CanIdTypeMirror_ConfigTypeMirror_FlexRayChannelTypeMirror_NetworkTypemodeLimitationNm_BusNmTypeNm_ConfigTypeNm_ModeTypeNm_StateTypePduR_PBConfigIdTypePduR_PBConfigTypePduR_RoutingPathGroupIdTypePduR_StateTypeSomeIpXf_ConfigTypeXcp_ConfigTypeXcp_TransmissionModeType{Mip}_ConfigTypeخريطة المواضيع
Com
55ComM
47LdCom
29Mirror
32Nm
44PduR
9SomeIpXf
11Xcp
9لا توجد بيانات عناصر لهذا الإصدار
Com
This callback function corresponds to SWS_ Com_00680. It is called after recepti- on of an invalid signal or signal group respectively.
void Com_CbkInv (void);This callback represents notification class 1 of [17]. It is called immediately after the message has been stored in the receiving message object.
void Com_CbkRxAck (void);This callback corresponds to notification class 3 of [17]. It is called immediately after a message reception error has been detected by the deadline monitoring mechanism.
void Com_CbkRxTOut (void);This callback represents notification class 2 of [17]. It is called immediately after successful transmission of the I - PDU containing the message.
void Com_CbkTxAck (void);This callback corresponds to notification class 4 of [17]. It is called in case the transmission is not possible because the corresponding I - PDU group is stopped.
void Com_CbkTxErr (void);This callback function indicates that the signals/ signal groups of a dedicated Com_ Main Function Tx instance will now be prepared for transmission.
void Com_CbkTxPrep (void);This callback corresponds to notification class 4 of [17]. It is called immediately after a message transmission error has been detected by the deadline monitoring mechanism.
void Com_CbkTxTOut (void);Service Com_CopyRxData.
BufReq_ReturnType Com_CopyRxData (PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr);Service Com_CopyTxData.
BufReq_ReturnType Com_CopyTxData (PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This service stops the inter - ECU communication. All started I - PDU groups are stop- ped and have to be started again, if needed, after Com_ Init is called. By a call to Com_ De Init the AUTOSAR COM module is put into an not initialized state.
void Com_DeInit (void);Disables the reception deadline monitoring for the I - PDUs within the given I - PDU group.
void Com_DisableReceptionDM (Com_IpduGroupIdType IpduGroupId);Enables the reception deadline monitoring for the I - PDUs within the given I - PDU group.
void Com_EnableReceptionDM (Com_IpduGroupIdType IpduGroupId);Returns the status of the AUTOSAR COM module. Availab le via Com.h
Com_StatusType Com_GetStatus (void);Returns the version information of this module.
void Com_GetVersionInfo (Std_VersionInfoType* versioninfo);This service initializes internal and external interfaces and variables of the AUTO- SAR COM module layer for the further processing. After calling this function the inter - ECU communication is still disabled. In configurations, in which Com is assigned to mo re than one partition (i.e. Com_ Main Functions are mapped to partitions), Com may provide one init function per AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM partition.
void Com_Init (const Com_ConfigType* config);The service Com_ In validate Signal invalidates the signal with the given Signal Id by setting its value to its configured Com Signal Data Invalid Value.
uint8 Com_InvalidateSignal (Com_SignalIdType SignalId);The service Co m_ Invalidate Signal Group invalidates all group signals of the signal group with the given Signal Group Id by setting their values to their configured Com Signal Data Invalid Values.
uint8 Com_InvalidateSignalGroup (Com_SignalGroupIdType SignalGroupId);Starts a preconfigured I - PDU group. For example, cyclic I - PDUs will be sent out cyclically after the call of Com_ Ipdu Group Start(). If Initialize is true all I - PDUs of the I - PDU group shall be (r e - )initialized before the I - PDU group is started. That is they shall behave like after a start - up of COM, for example the old_ value of the filter ob- jects and shadow buffers of signal groups have to be (re - )initialized.
void Com_IpduGroupStart (Com_IpduGroupIdType IpduGroupId, boolean initialize);Stops a preconfigured I - PDU group. For example, cyclic I - PDUs will be stopped after the call of Com_ Ipdu Group Stop().
void Com_IpduGroupStop (Com_IpduGroupIdType IpduGroupId);Calls the signal gateway part of the AUTOSAR COM module to forward received signals to be routed. Per configured Com Main Function Route Signals instance one Com_ Main Functi on Route Signals_ shall be implemented. Hereby is the short name of the Com Main Function Route Signals configuration container in the ECU configuration.
void Com_MainFunctionRouteSignals (void);This function performs the processing of the AUTOSAR COM module's receive processing that are not directly handled within the COM's functions invoked by the PDU - R, for example Com_ Rx Indication. Per configured Com Main Function Rx instance one Com_ Main F unction Rx_ shall be implemented. Hereby is the short name of the Com Main Function Rx configuration container in the ECU configuration.
void Com_MainFunctionRx (void);This function performs the processing of the AUTOSAR COM module's transmissi- on activities that are not directly handled within the COM's function invoked by the AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM RTE, for example Com_ Send Signal. Per configured Com Main Function Tx instance one Com_ Main F unction Tx_ shall be implemented. Hereby is the short name of the Com Main Function Tx configuration container in the ECU configuration.
void Com_MainFunctionTx (void);Com_ Receive Dyn Signal copies the data of the signal identified by Signal Id to the lo cation specified by Signal Data Ptr and stores the length of the dynamical length signal at the position given by the Length parameter.
uint8 Com_ReceiveDynSignal (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length);Com_ Receive Dyn Signal With Meta Da ta copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr and stores the length of the dy- namical length signal at the position given by the Length parameter. The received meta data is stored at the position given by the Meta Data Ptr parameter.
uint8 Com_ReceiveDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16* Length, uint8* MetaDataPtr);Com_ Receive Signal copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr.
uint8 Com_ReceiveSignal (Com_SignalIdType SignalId, void* SignalDataPtr);The service Com_ Receive Signal Group copies the received signal group from the I - PDU to the shadow buffer.
uint8 Com_ReceiveSignalGroup (Com_SignalGroupIdType SignalGroupId);The service Com_ Receive Signal Group Array copies the re ceived signal group array AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM representation from the PDU to the location designated by Signal Group Ar - ray Ptr.
The service Com_ Receive Signal Group Array With Meta Data copies the received si gnal group array representation from the PDU to the location designated by Signal Group Ar - ray Ptr. The received meta data is stored at the position given by the Meta Data Ptr parameter.
The service Com_ Receive Signal Group With Meta Data copies the received signal group from the I - PDU to the shadow buffer. The received meta data is stored at the position given by the Meta Data Ptr parameter.
Com_ Receive Signal With Meta Data copies the data of the signal identified by Signal Id to the location specified by Signal Data Ptr. The received meta data is stored at the position given by the Meta Data Ptr parameter. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM
uint8 Com_ReceiveSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr);Indication of a received PDU from a lower layer communication interface module.
void Com_RxIndication (PduIdType RxPduId, const PduInfoType* PduInfoPtr);The I - PDU callout on receiver side can be configured to implement user - defined receive filtering mechanisms.
boolean Com_RxIpduCallout (PduIdType PduId, const PduInfoType* PduInfoPtr);The service Com_ Send Dyn Signal updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter.
uint8 Com_SendDynSignal (Com_SignalIdType SignalId, const void* SignalDataPtr, uint16 Length);The service Com_ Send Dyn Signal With Meta Data updates the signal object identified by Signal Id wit h the signal referenced by the Signal Data Ptr parameter. The meta data is provided via the Meta Data Ptr parameter. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM
uint8 Com_SendDynSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint16 Length, uint8* MetaDataPtr);The service Com_ Send Signal updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter. Avai lable via Com.h
uint8 Com_SendSignal (Com_SignalIdType SignalId, const void* SignalDataPtr);The service Com_ Send Si gnal Group copies the content of the associated shadow buffer to the associated I - PDU.
uint8 Com_SendSignalGroup (Com_SignalGroupIdType SignalGroupId);The service Com_ Send Signal Group Array copies the conte nt of the provided Signal Group Array Ptr to the associated I - PDU. The provided data shall correspond to the array representation of the signal group.
The service Com_ Send Signal Group Array With Meta Data copies the content of the provided Signal Group Array Ptr to the associated I - PDU. The provided data shall c orrespond to the array representation of the signal group. The meta data is provi- ded via the Meta Data Ptr parameter.
The service Com_ Send Si gnal With Meta Data updates the signal object identified by Signal Id with the signal referenced by the Signal Data Ptr parameter. The meta data is provided via the Meta Data Ptr parameter.
uint8 Com_SendSignalWithMetaData (Com_SignalIdType SignalId, void* SignalDataPtr, uint8* MetaDataPtr);Service Com_StartReception.
BufReq_ReturnType Com_StartOfReception (PduIdType id, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);The service Com_ Switch Ipdu Tx Mode sets the transmi ssion mode of the I - PDU refe- renced by Pdu Id to Mode. In case the transmission mode changes, the new mode shall immediately be effective (see SWS_ Com_00239). In case the requested transmission mode was already active for this I - PDU, the call will have no effect.
void Com_SwitchIpduTxMode (PduIdType PduId, booleanMode); ⚠️Called after an I - PDU has been received via the TP API, the result indicates whe- ther the transmission was successful or not.
void Com_TpRxIndication (PduIdType id, Std_ReturnType result);This function is called after the I - PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
void Com_TpTxConfirmation (PduIdType id, Std_ReturnType result);By a call to Com_ Trigger IPDUSend the I - PDU with the given ID is triggered for transmission.
Std_ReturnType Com_TriggerIPDUSend (PduIdType PduId);By a call to Com_ Trigger IPDUSend With Meta Data the AUTOSAR COM module updates its internal metadata for the I - PDU with the given ID by copying the metada- ta from the given position and with respect to length of the globally configured Meta Data Type of this I - PDU. Then the I - PDU is triggered for transmission.
Std_ReturnType Com_TriggerIPDUSendWithMetaData (PduIdType PduId, const uint8* MetaData);Within this API , the upper layer module (called module) shall check whether the available data fits into the buffer size reported by Pdu Info Ptr - >Sdu Length. If it fits, it shall copy its data into the buffer provided by Pdu Info Ptr - >Sdu Data Ptr and update the length of the actual copied data in Pdu Info Ptr - >Sdu Length. If not, it returns E_ NOT_ OK without changing Pdu Info Ptr.
Std_ReturnType Com_TriggerTransmit (PduIdType TxPduId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COM PDU, or the failure to transmit a PDU.
void Com_TxConfirmation (PduIdType TxPduId, Std_ReturnType result);The I - PDU callout on sender side can be configured for example to implement user - defined transmission filtering or user - defined pre - transmission - processing of the outgoing I - PDU.
boolean Com_TxIpduCallout (PduIdType PduId, PduInfoType* PduInfoPtr);This is the type of the data structure containing the initialization data for COM.
The AUTOSAR COM I - PDU module's group object identifier.
The AUTOSAR COM module's signal group object identifier.
The AUTOSAR COM module's signal object identifier.
This is a status value returned by the API service Com_ Get Status().
ComM
Notification of the corresponding Bus State Manager that the actual bus mode is Bus - Sleep. Only applicable for Com M channels with Com MNm Variant set to SLAVE_ ACTIVE or SLAVE_ PASSIVE. E.g. LIN slaves (Com MNMVariant = SLAVE_ ACTIVE) or Ethernet channels with OA TC10 compliant Ethernet hardware which act as passive communication slave (Com MNMVariant = SLAVE_ PASSIVE and Eth Trcv Act As Slave Passive Enabled set to TRUE)
void ComM_BusSM_BusSleepMode (NetworkHandleType Channel);Indication of the actual bus mode by the corresponding Bus State Manager. Com M shall propagate the indicated state to the users with means of the RTE and Bsw M.
void ComM_BusSM_ModeIndication (NetworkHandleType Channel, ComM_ModeType ComMode);Ecu M or Bsw M shall indicate to Com M when communication is allowed. If Ecu M/ Flex is used: Bsw M AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager
void ComM_CommunicationAllowed (NetworkHandleType Channel, boolean Allowed);Indication of active diagnostic by the DCM.
void ComM_DCM_ActiveDiagnostic (NetworkHandleType Channel);Indication of inactive diagnostic by the DCM.
void ComM_DCM_InactiveDiagnostic (NetworkHandleType Channel);This API de - initializes the AUTOSAR Communication Manager.
void ComM_DeInit (void);Notification of a wake up on the corresponding partial network cluster.
void ComM_EcuM_PNCWakeUpIndication (PNCHandleType PNCid);Notification of a wake up on the corresponding channel.
void ComM_EcuM_WakeUpIndication (NetworkHandleType Channel);Function to query the current Communication Mode. Com M shall use the corresponding interfaces of the Bus State Managers to get the current Communication Mode of the network. (Call to Bus State Manager API: XXXSM _ Get Current Com Mode(...))
Std_ReturnType ComM_GetCurrentComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);The function returns the current Communication Mode of the corresponding PNC the affected user is assigned to.
Std_ReturnType ComM_GetCurrentPNCComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Returns the inhibition status of a Com M channel.
Std_ReturnType ComM_GetInhibitionStatus (NetworkHandleType Channel, ComM_InhibitionStatusType* Status);Function t o query the maximum allowed Communication Mode of the corresponding user.
Std_ReturnType ComM_GetMaxComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);This function returns the current configuration of the ECUs PNC - to -
Std_ReturnType ComM_GetPncToChannelMapping (boolean* MappingTable, uint8* ChannelCnt, uint8* PncCnt);Function to query the currently requested Communication Mode of the corresponding user. Availa ble via Com M.h
Std_ReturnType ComM_GetRequestedComMode (ComM_UserHandleType User, ComM_ModeType* ComMode);Returns the initialization status of the AUTOSAR Communication Manager. After a call to Com M_ De Init() Com M should have status COMM_ UNINIT, and a new call to Com M_ Init needed to make sur e Com M restart internal state machines to defailt values.
Std_ReturnType ComM_GetStatus (ComM_InitStatusType* Status);This function returns the published information (for details refer to table 10.3)
void ComM_GetVersionInfo (Std_VersionInfoType* Versioninfo);Initializes the AUTOSAR Communication Manager and restarts the internal state machines.
void ComM_Init (const ComM_ConfigType* ConfigPtr);Changes the inhibition status f or the channel for changing from COMM_ NO_ COMMUNICATION to a higher Communication Mode. (See also Com M_ Limit ECUTo No Com Mode, same functionality but for all channels)
Std_ReturnType ComM_LimitChannelToNoComMode (NetworkHandleType Channel, boolean Status);Changes the inhibition status for the ECU (=all channels) for changing from COMM_ NO_ COMMUNICATION to a high er Communication Mode. (See also Com M_ Limit Channel To No Com Mode, same functionality but for a specific channels)
Std_ReturnType ComM_LimitECUToNoComMode (boolean Status);Notification that the network management has entered Bus - Sleep Mode. This callback function should perform a transition of the hardware and transceiver to bus - sleep mode.
void ComM_Nm_BusSleepMode (NetworkHandleType Channel);If an ECU in role of an intermediate PNC coordinator receives a PN shutdown message via a Nm, then Com M is immediately indicated via Com M_ Nm_ Forward Synchronized Pnc Shutdown to forward the request for a synchronized PNC shutdown of the affected PNCs. Therefore, Com M will immediately release the affected PNC state machines and forward the PN information to the affected Com M Channels and the corresponding NM channels, respectively. Note: This supports a nearly synchronized PNC shutdown across the PN topology from the top - level PNC coordinator down to the subordinated PNC node. Tags: atp.Stat us=draft
void ComM_Nm_ForwardSynchronizedPncShutdown (NetworkHandleType Channel);Notification that the network management has entered Network Mode.
void ComM_Nm_NetworkMode (NetworkHandleType Channel);Indication that a NM - message has been received in the Bus Sleep Mode, what indicates that some nodes in the network have already entered the Network Mode.
void ComM_Nm_NetworkStartIndication (NetworkHandleType Channel);Service to indicate that an NM message with set PNC Learning Bit has been received. Tags: atp.Status=draft
void ComM_Nm_PncLearningBitIndication (NetworkHandleType Channel);Notification that the network management has entered Prepare Bus - Sleep Mode.
void ComM_Nm_PrepareBusSleepMode (NetworkHandleType Channel);Notification that the state of all has left Repeat Message. This interface is used to indicate by the optional Dynamic PNC - to - channel - mapping feature to indicate that learning phase ends. Tags: atp.Status=draft
void ComM_Nm_RepeatMessageLeftIndication (NetworkHandleType Channel);If Nm If has started to shut down the coordinated busses, AND not all coordinated busses have indicated bus sleep state, AND on at least on one of the coordinated busses NM is restarted, THEN the NM Interface shall call the callback function Com M_ Nm_ Res tart Indication with the nm Network Handle of the channels which have already indicated bus sleep state.
void ComM_Nm_RestartIndication (NetworkHandleType Channel);Triggers the NM to return into NM Repe at Message State and send the Partial Network Learning Bit (in order for receiving nodes to respond) together with the Repeat Message Request Bit (in order for receiving nodes to return into NM Repeat Message State). This function is used for the optional Dynamic PNC - to - channel - mapping feature. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Tags: atp.Status=draft
Std_ReturnType ComM_PnLearningRequest (void);Changes the inhibition status COMM_ NO_ WAKEUP for the corresponding channel.
Std_ReturnType ComM_PreventWakeUp (NetworkHandleType Channel, boolean Status);This function returns the amount of rejected COMM_ FULL_ COMMUNICATION user requests.
Std_ReturnType ComM_ReadInhibitCounter (uint16* CounterValue);Requesting of a Communication Mode by a user. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_COMManager Note: The following modes are no vaild user requests, since they are used as internal modes: - COMM_ SIL ENT_ COMMUNICATION (this mode is used for synchronization at shutdown) - COMM_ FULL_ COMMUNICATION_ WITH_ WAKEUP_ REQUEST (this mode is used internally within the Com M channel statemachine to trigger the lower layers to request a wakeup on the network if the used hardware support such a feature. (e.g. Ethernet hardware which is compatible with OA TC10). The following modes are valid user requests: - COMM_ NO_ COMMUNICATION - COMM_ FULL_ COMMUNICATION. The communication request could also be released due to
Std_ReturnType ComM_RequestComMode (ComM_UserHandleType User, ComM_ModeType ComMode);This function resets the Inhibited COMM_ FULL_ COMMUNICATION request Counter.
Std_ReturnType ComM_ResetInhibitCounter (void);This function resets dynamic entries within the ECUs PNC - to - channel - mapping to default values Tags: atp.Status=draft
Std_ReturnType ComM_ResetPncToChannelMapping (void);Changes the ECU Group Classification status (see chapter 10.2.2)
Std_ReturnType ComM_SetECUGroupClassification (ComM_InhibitionStatusType Status);This function is used by SWCs to update the PNC membership which is transmitted during PNC Learning. This function is used for the optional Dynamic PNC - to - channel - mapping feature. This function is used for the optional Dynamic PNC - to - channel - mapping feature. Tags: atp.Status=draft
Std_ReturnType ComM_UpdatePncMembership (boolean Control, const uint8* ComM_PncMembership);This function can be used to set entries within the the ECUs PNC - to - channel -
Std_ReturnType ComM_UpdatePncToChannelMapping (const boolean* MappingTable, uint8 channelCnt, uint8 PncCnt);This type contains the implementation - specific post build configuration structure.
Initialization status of Com M.
Current mode of the Communication Manager (main state of the state machine).
Array of uint8 with Elements that holds the current PNC Membership of the node.
Current mode of a PNC
State and sub - state of Com M state machine Com M states vs. Communication Modes: COMM_ NO_ COM* : Communication Mode='No Communication' COMM_ FULL_ COM*: Communication Mode='Full Communication' COMM_ SILENT_ COM: Communicatio Mode='Silent Communication'
number Of Requesters contains the number of valid user handle entries in the "handle Array" member. If no user keeps the channel requested, this is zero {LOWER - LIMIT=0, UPPER - LIMIT= MAX_ CHANNEL_ REQUESTER }
This element contains the user handles of the users which keep the channel requested (if any), starting in its first entries. The size of the array MAX_ CHANNE L_ REQUESTERS is the maximum of the number of users requesting a channel.
Handle to identify a user. For each user, a unique value must be defined at system generation time. Maximum number of users is 255. Legal user IDs are in the range 0 .. 254; user ID 255 is reserved and shall have the symbolic representation COMM_ NOT_ USED _ USER_ ID.
-
-
ComXf
This service deinitializes the transformer.
void ComXf_DeInit(void);This service returns the version information of the called transformer module.
void ComXf_GetVersionInfo(Std_VersionInfoType* VersionInfo);This service initializes the transformer for the further processing.
void ComXf_Init(const ComXf_ConfigType* config);This function deserializes a Sender/Receiver communication using the deserialization of COM Based Transformer. It takes the uint8 array containing the serialized data as input and outputs the original data element which will be passed to the Rte.
This is the type of the data structure containing the initialization data for the transformer.
E2EXf
Deinitializes the E2E transformer.
void E2EXf_DeInit(void);Returns the version information of this module.
void E2EXf_GetVersionInfo(Std_VersionInfoType* versioninfo);Initializes the state of the E2E Transformer. The main part of it is the initialization of the E2E library state structures, which is done by calling all init-functions from E2E library.
void E2EXf_Init(const E2EXf_ConfigType* config);Checks the received data. If the data can be used by the caller, then the function returns E_OK.
Protects the array/buffer to be transmitted, using the in-place transformation.
uint8 E2EXf_<transformerId>([Std_TransformerForwardCode forwardedCode], [Std_ExtractProtocolHeaderFieldsType extractProtocolHeaderFields], [const E2EXf_CSTransactionHandleType* csTransactionHandle], uint8* buffer, uint32* bufferLength, [const uint8* inputBuffer], uint32 inputBufferLength);Parent container for the configuration of E2E Transformer. The content is implementation-specific.
Transaction handle for the C/S method call. - Used to tunnel the E2E Source ID and the E2E Counter from the request to the response at the server side via the RTE.
IpduM
Service returns the version information of this module.
void IpduM_GetVersionInfo(Std_VersionInfoType* versioninfo);Initializes the I-PDU Multiplexer. In configurations, in which IpduM is assigned to more than one partition (i.e. IpduM_Main Functions are mapped to partitions), IpduM may provide one init function per partition.
void IpduM_Init(const IpduM_ConfigType* config);This function performs the processing of the reception activities that are not directly handled within the calls from PduR. Per configured IpduMMainFunctionRx instance one IpduM_MainFunctionRx_<shortName> shall be implemented. Hereby <shortName> is the short name of the IpduMMainFunctionRx configuration container in the ECU configuration.
void IpduM_MainFunctionRx(void);This function performs the processing of the transmission activities that are not directly handled within the calls from PduR. Per configured IpduMMainFunctionTx instance one IpduM_MainFunctionTx_<shortName> shall be implemented. Hereby <shortName> is the short name of the IpduMMainFunctionTx configuration container in the ECU configuration.
void IpduM_MainFunctionTx(void);Indication of a received PDU from a lower layer communication interface module.
void IpduM_RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr);Requests transmission of a PDU.
Std_ReturnType IpduM_Transmit(PduIdType TxPduId, const PduInfoType* PduInfoPtr);Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr.
Std_ReturnType IpduM_TriggerTransmit(PduIdType TxPduId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void IpduM_TxConfirmation(PduIdType TxPduId, Std_ReturnType result);This is the type of the data structure containing the initialization data for the I-PDU multiplexer.
LdCom
This function is called to provide the received data of an I-PDU segment (N-PDU) to the upper layer. Each call to this function provides the next part of the I-PDU data. The size of the remaining data is written to the position indicated by bufferSizePtr. Tags: atp.Status=draft
BufReq_ReturnType <LdComUser_LdComCbkCopyRxData>(CbkHandleIdType LdComUserCbkHandleId, const PduInfoType* info, PduLengthType* bufferSizePtr);This function is called to acquire the transmit data of an I-PDU segment (N-PDU). Each call to this function provides the next part of the I-PDU data unless retry->TpDataState is TP_ DATARETRY. In this case the function restarts to copy the data beginning at the offset from the current position indicated by retry->TxTpDataCnt. The size of the remaining data is written to the position indicated by availableDataPtr Tags: atp.Status=draft
BufReq_ReturnType <LdComUser_LdComCbkCopyTxData>(CbkHandleIdType LdComUserCbkHandleId, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);Indication of a received PDU from a lower layer communication interface module. Tags: atp.Status=draft
void <LdComUser_LdComCbkRxIndication>(CbkHandleIdType LdComUserCbkHandleId, const PduInfoType* PduInfoPtr);This function is called at the start of receiving an N-SDU. The N-SDU might be fragmented into multiple N-PDUs (FF with one or more following CFs) or might consist of a single N-PDU (SF). The service shall provide the currently available maximum buffer size when invoked with TpSdu Length equal to 0. Tags: atp.Status=draft
BufReq_ReturnType <LdComUser_LdComCbkStartOfReception>(CbkHandleIdType LdComUserCbkHandleId, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);Called after an I-PDU has been received via the TP API, the result indicates whether the transmission was successful or not. Tags: atp.Status=draft
void <LdComUser_LdComCbkTpRxIndication>(CbkHandleIdType LdComUserCbkHandleId, Std_ReturnType result);This function is called after a Signal has been transmitted via the TP-API on its network. Tags: atp.Status=draft
void <LdComUser_LdComCbkTpTxConfirmation>(CbkHandleIdType LdComUserCbkHandleId, Std_ReturnType result);Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr. Tags: atp.Status=draft
Std_ReturnType <LdComUser_LdComCbkTriggerTransmit>(CbkHandleIdType LdComUserCbkHandleId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU. Tags: atp.Status=draft
void <LdComUser_LdComCbkTxConfirmation>(CbkHandleIdType LdComUserCbkHandleId, Std_ReturnType result);This function is called to provide the received data of an I-PDU segment (N-PDU) to the upper layer. Each call to this function provides the next part of the I-PDU data. The size of the remaining buffer is written to the position indicated by bufferSizePtr.
BufReq_ReturnType LdCom_CopyRxData(PduIdType id, const PduInfoType* info, PduLengthType* bufferSizePtr);This function is called to acquire the transmit data of an I-PDU segment (N-PDU). Each call to this function provides the next part of the I-PDU data unless retry->TpDataState is TP_ DATARETRY. In this case the function restarts to copy the data beginning at the offset from the current position indicated by retry->TxTpDataCnt. The size of the remaining data is written to the position indicated by availableDataPtr.
BufReq_ReturnType LdCom_CopyTxData(PduIdType id, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);With a call to LdCom_DeInit the AUTOSAR LdCom module is put into an not initialized state.
void LdCom_DeInit(void);Returns the version information of this module.
void LdCom_GetVersionInfo(Std_VersionInfoType* versioninfo);This service initializes internal and external interfaces and variables of the AUTOSAR LdCom module for the further processing.
void LdCom_Init(const LdCom_ConfigType* config);Indication of a received PDU from a lower layer communication interface module.
void LdCom_RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr);This function is called at the start of receiving an N-SDU. The N-SDU might be fragmented into multiple N-PDUs (FF with one or more following CFs) or might consist of a single N-PDU (SF). The service shall provide the currently available maximum buffer size when invoked with TpSdu Length equal to 0.
BufReq_ReturnType LdCom_StartOfReception(PduIdType id, const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);Called after an I-PDU has been received via the TP API, the result indicates whether the transmission was successful or not.
void LdCom_TpRxIndication(PduIdType id, Std_ReturnType result);This function is called after the I-PDU has been transmitted on its network, the result indicates whether the transmission was successful or not.
void LdCom_TpTxConfirmation(PduIdType id, Std_ReturnType result);Requests transmission of a signal.
Std_ReturnType LdCom_Transmit(PduIdTypeId, const PduInfoType* InfoPtr);Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr.
Std_ReturnType LdCom_TriggerTransmit(PduIdType TxPduId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void LdCom_TxConfirmation(PduIdType TxPduId, Std_ReturnType result);{OBSOLETE} Service Name Rte_ Ld Com Cbk Copy Rx Data_<sn> (obsolete) Syntax Buf Req_ Return Type Rte_ Ld Com Cbk Copy Rx Data_<sn> ( const Pdu Info Type* info, Pdu Length Type* buffer Size Ptr ) Sync/ Async Synchronous Reentrancy Non Reentrant for same sn, otherwise Reentrant Parameters (in) info Provides the source buffer (Sdu Data Ptr) and the number of bytes to be copied (Sdu Length). An Sdu Length of 0 can be used to query the current amount of available buffer in the upper layer module. In this case, the Sdu Data Ptr may be a NULL_ PTR. Param eters (inout) None Parameters (out) buffer Size Ptr Available receive buffer after data has been copied. Return value Buf Req _ - Return - Type BUFREQ_ OK: Data copied successfully BUFREQ_ E_ NOT_ OK: Data was not copied because an error occurred. Descript ion This function is called to provide the received data of an I - PDU segment (N - PDU) to the upper layer. Each call to this function provides the next part of the I - PDU data. The size of the remaining data is written to the position indicated by buffer Size Ptr. Tags: atp.Status=obsolete Available via Rte_ Cbk.h
BufReq_ReturnType Rte_LdComCbkCopyRxData_<sn>(const PduInfoType* info, PduLengthType* bufferSizePtr);This function is called to acquire the transmit data of an I - PDU segment (N - PDU). Each call to this function provides the next part of the I - PDU data u nless retry - >Tp Data State is TP_ DATARETRY. In this case the function restarts to copy the data beginning at the offset from the current position indicated by retry - >Tx Tp Data Cnt. The size of the remaining data is written to the position indicated by av ailable Data Ptr Tags: atp.Status=obsolete
BufReq_ReturnType Rte_LdComCbkCopyTxData_<sn>(const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This function is called at the start of receiving an N - SDU. The N - SDU might be fragmented into multiple N - PDUs (FF with one or more following CFs) or might consist of a single N - PDU (SF). The service shall provide the currently available maximum buffer size when invoked with Tp Sdu Length equal to 0. Tags: atp.Status=obsolete A vailable via Rte_ Cbk.h
BufReq_ReturnType Rte_LdComCbkStartOfReception_<sn>(const PduInfoType* info, PduLengthType TpSduLength, PduLengthType* bufferSizePtr);Indication of a received PDU from a lower layer communication interface module. Tags: atp.Status=obsolete
void Rte_LdComCbkRxIndication_<sn>(const PduInfoType* PduInfoPtr);Called after an I - PDU has been received via the TP API, the result indicates whether the transmission was successful or not. Tags: atp.Status=obsolete
void Rte_LdComCbkTpRxIndication_<sn>(Std_ReturnType result);This function is called after a Signal has been transmitted via the TP - API on its network. Tags: atp.Status=obsolete
void Rte_LdComCbkTpTxConfirmation_<sn>(Std_ReturnType result);Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by Pdu Info Ptr - >Sdu Length. If it fits, it shall copy its data into the buffer provided by Pdu Info Ptr - >Sdu Data Ptr and update the length of the actual copied data in Pdu Info Ptr - >Sdu Length. If not, it returns E_ NOT_ OK without changing Pdu Info Ptr. Tags: atp.Status=obsolete
Std_ReturnType Rte_LdComCbkTriggerTransmit_<sn>(PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU. Tags: atp.Status=obsolete
void Rte_LdComCbkTxConfirmation_<sn>(Std_ReturnType result);This type contains the implementation-specific post build configuration structure.
Mirror
Creates a CAN ID mask filter.
Std_ReturnType Mirror_AddCanMaskFilter(NetworkHandleType network, uint8* filterId, Can_IdType id, Can_IdType mask);Creates a CAN ID range filter.
Std_ReturnType Mirror_AddCanRangeFilter(NetworkHandleType network, uint8* filterId, Can_IdType lowerId, Can_IdType upperId);Creates a FlexRay filter.
Std_ReturnType Mirror_AddFlexRayFilter(NetworkHandleType network, uint8* filterId, uint16 lowerSlotId, uint16 upperSlotId, uint8 lowerBaseCycle, uint8 upperBaseCycle, uint8 cycleRepetition, Fr_ChannelType frChannel);Creates a LIN frame ID mask filter.
Std_ReturnType Mirror_AddLinMaskFilter(NetworkHandleType network, uint8* filterId, uint8 id, uint8 mask);Creates a LIN frame ID range filter.
Std_ReturnType Mirror_AddLinRangeFilter(NetworkHandleType network, uint8* filterId, uint8 lowerId, uint8 upperId);This function resets the Bus Mirroring module to the uninitialized state.
void Mirror_DeInit(void);Returns the currently selected destination bus.
NetworkHandleType Mirror_GetDestNetwork(void);Returns the network handle (ComMChannel) of the bus identified by the given network type and network ID, or MIRROR_INVALID_NETWORK.
NetworkHandleType Mirror_GetNetworkHandle(Mirror_NetworkType networkType, uint8 networkId);Returns the network ID of the given network.
uint8 Mirror_GetNetworkId(NetworkHandleType network);Returns the network type of the given network.
Mirror_NetworkType Mirror_GetNetworkType(NetworkHandleType network);Returns the state of a pre-configured filter.
Std_ReturnType Mirror_GetStaticFilterState(NetworkHandleType network, uint8 filterId, boolean* isActive);Returns the version information of this module.
void Mirror_GetVersionInfo(Std_VersionInfoType* versionInfo);This function initializes the Bus Mirroring module. In configurations, in which Mirror is assigned to more than one partition (i.e. Mirror_Main Functions are mapped to partitions), Mirror may provide one init function per partition.
void Mirror_Init(const Mirror_ConfigType* configPtr);Returns the global mirroring state.
boolean Mirror_IsMirrorActive(void);Returns the state of a source bus.
boolean Mirror_IsSourceNetworkStarted(NetworkHandleType network);Main function of the Bus Mirroring module. Used for scheduling purposes and timeout supervision. Per configured MirrorMainFunction instance one Mirror_MainFunction_<shortName> shall be implemented. Hereby <shortName> is the short name of the MirrorMainFunction configuration container in the ECU configuration.
void Mirror_MainFunction(void);Completely disables any mirroring activities. Source buses are reset to disabled, queued messages are purged, and the destination bus is reset to the default destination. Pre-configured filters are disabled, and filters added at runtime are removed.
void Mirror_Offline(void);Removes a CAN, LIN, or FlexRay filter that was added at runtime.
Std_ReturnType Mirror_RemoveFilter(NetworkHandleType network, uint8 filterId);Reports a received or transmitted CAN frame. All received CAN frames that pass the hardware acceptance filter are reported, independent of the software filter configuration. Transmitted CAN frames are reported when the transmission is confirmed.
void Mirror_ReportCanFrame(uint8 controllerId, Can_IdType canId, uint8 length, const uint8* payload);Reports a received or transmitted FlexRay frame or a Tx conflict.
void Mirror_ReportFlexRayFrame(uint8 controllerId, uint16 slotId, uint8 cycle, Fr_ChannelType frChannel, const PduInfoType* frame, boolean txConflict);Reports a received or transmitted LIN frame.
void Mirror_ReportLinFrame(NetworkHandleType network, Lin_FramePidType pid, const PduInfoType* pdu, Lin_StatusType status);Sets the state of a pre-configured filter.
Std_ReturnType Mirror_SetStaticFilterState(NetworkHandleType network, uint8 filterId, boolean isActive);Activates a source bus.
Std_ReturnType Mirror_StartSourceNetwork(NetworkHandleType network);Deactivates a source bus.
Std_ReturnType Mirror_StopSourceNetwork(NetworkHandleType network);Changes the destination bus to the given ComM channel. The previously active destination bus and all source buses are disabled.
Std_ReturnType Mirror_SwitchDestNetwork(NetworkHandleType network);Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr.
Std_ReturnType Mirror_TriggerTransmit(PduIdType TxPduId, PduInfoType* PduInfoPtr);The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void Mirror_TxConfirmation(PduIdType TxPduId, Std_ReturnType result);Local representation for Can_IdType Variation –
This is the base type for the configuration of the Bus Mirroring module. A pointer to an instance of this structure will be used in the initialization of the Bus Mirroring module. The content of this structure is defined in chapter 10 Configuration specification.
This type represents the assignment of a FlexRay frame to the channels A and B of a FlexRay network. Variation –
This type represents the bus types that are supported as source or destination buses for the Bus Mirroring module. The invalid type is used as a return value if a function cannot return a valid type. Variation –
Nm
Callout function to be called by Nm_CarWakeUpIndication()
void <NmCarWakeUpCallout>(NetworkHandleType nmNetworkHandle);Notification that the network management has entered Bus-Sleep Mode.
void Nm_BusSleepMode(NetworkHandleType nmNetworkHandle);This function is called by a <Bus>Nm to indicate reception of a CWU request.
void Nm_CarWakeUpIndication(NetworkHandleType nmChannelHandle);Check if remote sleep indication takes place or not. For that purpose <Bus>Nm_CheckRemote SleepIndication shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_CheckRemoteSleepIndication function is called if channel is configured as CAN).
Std_ReturnType Nm_CheckRemoteSleepIndication(NetworkHandleType nmNetworkHandle, boolean* nmRemoteSleepIndPtr);Cancels an indication, when the NM Coordinator Sleep Ready bit in the Control Bit Vector is set back to 0.
void Nm_CoordReadyToSleepCancellation(NetworkHandleType nmChannelHandle);Sets an indication, when the NM Coordinator Sleep Ready bit in the Control Bit Vector is set
void Nm_CoordReadyToSleepIndication(NetworkHandleType nmChannelHandle);Disables the NM PDU transmission ability. For that purpose <Bus>Nm_DisableCommunication shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM (e.g. CanNm_Disable Communication function is called if channel is configured as CAN).
Std_ReturnType Nm_DisableCommunication(NetworkHandleType NetworkHandle);Enables the NM PDU transmission ability. For that purpose <Bus>Nm_EnableCommunication shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_Enable Communication function is called if channel is configured as CAN).
Std_ReturnType Nm_EnableCommunication(NetworkHandleType NetworkHandle);Notification that the network management has received a PN shutdown message on a particular NM-channel. This is used to grant a nearly synchronized PNC shutdown across the entire PN topology. Tags: atp.Status=draft
void Nm_ForwardSynchronizedPncShutdown(void);Notification that the network management has received a PN shutdown message on a particular NM-channel. This is used to grant a nearly synchronized PNC shutdown across the entire PN topology.
void Nm_ForwardSynchronizedPncShutdown(NetworkHandleType NetworkHandle, const uint8* PncBitVectorPtr);Get node identifier configured for the local node. For that purpose <Bus>Nm_GetLocalNode Identifier shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. Can Nm_GetLocalNodeIdentifier function is called if channel is configured as CAN).
Std_ReturnType Nm_GetLocalNodeIdentifier(NetworkHandleType NetworkHandle, uint8* nmNodeIdPtr);Get node identifier out of the last successfully received NM-message. The function <Bus>Nm_ GetNodeIdentifier shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_GetNodeIdentifier function is called if channel is configured as CAN).
Std_ReturnType Nm_GetNodeIdentifier(NetworkHandleType NetworkHandle, uint8* nmNodeIdPtr);Get the whole PDU data out of the most recently received NM message. For that purpose <Bus Nm>_GetPduData shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_GetPduData function is called if channel is configured as CAN).
Std_ReturnType Nm_GetPduData(NetworkHandleType NetworkHandle, uint8* nmPduData);Returns the state of the network management. The function <Bus>Nm_GetState shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_GetState function is called if channel is configured as CAN).
Std_ReturnType Nm_GetState(NetworkHandleType nmNetworkHandle, Nm_StateType* nmStatePtr, Nm_ModeType* nmModePtr);Get user data out of the last successfully received NM message. For that purpose <Bus>Nm_ GetUserData shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_GetUserData function is called if channel is configured as CAN).
Std_ReturnType Nm_GetUserData(NetworkHandleType NetworkHandle, uint8* nmUserDataPtr);This service returns the version information of this module.
void Nm_GetVersionInfo(Std_VersionInfoType* nmVerInfoPtr);Initializes the NM Interface.
void Nm_Init(const Nm_ConfigType* ConfigPtr);This function implements the processes of the NM Interface, which need a fix cyclic scheduling.
void Nm_MainFunction(void);Notification that the network management has entered Network Mode.
void Nm_NetworkMode(NetworkHandleType nmNetworkHandle);This function calls the <Bus>Nm_NetworkRelease bus specific function in case NmBusType is not set to NM_BUSNM_LOCALNM (e.g. CanNm_NetworkRelease function is called if channel is configured as CAN).
Std_ReturnType Nm_NetworkRelease(NetworkHandleType NetworkHandle);This function calls the <Bus>Nm_NetworkRequest (e.g. CanNm_NetworkRequest function is called if channel is configured as CAN) function in case NmBusType is not set to NM_BUSNM_ LOCALNM.
Std_ReturnType Nm_NetworkRequest(NetworkHandleType NetworkHandle);Notification that a NM-message has been received in the Bus-Sleep Mode, what indicates that some nodes in the network have already entered the Network Mode.
void Nm_NetworkStartIndication(NetworkHandleType nmNetworkHandle);This function calls the <Bus>Nm_PassiveStartUp function in case NmBusType is not set to NM_BUSNM_LOCALNM (e.g. CanNm_PassiveStartUp function is called for NM_BUSNM_ CANNM).
Std_ReturnType Nm_PassiveStartUp(NetworkHandleType NetworkHandle);Notification that a NM message has been received.
void Nm_PduRxIndication(NetworkHandleType nmNetworkHandle);Indication that a bus specific network management has received a NM message on a particular NM-channel that contain a PNC bit vector. This is used to aggregate the external PNC requests. The function evaluate if a relevant PNC request (PNC bit set to '1') is available in the given PNC bit vector. If a relevant PNC request is available (PNC bit passes the PNC bit vector filter), then the RelevantPncRequestDetectedPtr refers to a boolean with value set to TRUE. Otherwise refer to booelan with value set to FALSE. RelevantPncRequestDetectedPtr is evaluated by the callee <Bus>Nm module to qualify the further processing of the received NM-PDU.
void Nm_PncBitVectorRxIndication(NetworkHandleType NetworkHandle, const uint8* PncBitVectorPtr, boolean* RelevantPncRequestDetectedPtr);Function called by <Bus>Nms to confirm the state of the transmission for the given PNC bit vector on the given NM-Channel.
void Nm_PncBitVectorTxConfirmation(NetworkHandleType NetworkHandle, const uint8* PncBitVectorPtr, Std_ReturnType result);Function called by <Bus>Nms to request the aggregated internal PNC requests for transmission within the Nm message.
void Nm_PncBitVectorTxIndication(NetworkHandleType NetworkHandle, uint8* PncBitVectorPtr);Set Repeat Message Request Bit and Partial Network Learning Bit for NM messages transmitted next on the bus. For that purpose <Bus>Nm_PnLearningRequest shall be called (e.g. CanNm_PnLearningRequest function if channel is configured as CAN). This will force all nodes to enter the PNC Learning Phase and re-enter Repeat Message Stat. This is needed for the optional Dynamic PNC-to-channel-mapping feature.
Std_ReturnType Nm_PnLearningRequest(NetworkHandleType NetworkHandle);Notification that the network management has entered Prepare Bus-Sleep Mode.
void Nm_PrepareBusSleepMode(NetworkHandleType nmNetworkHandle);Notification that the network management has detected that not all other nodes on the network are longer ready to enter Bus-Sleep Mode.
void Nm_RemoteSleepCancellation(NetworkHandleType nmNetworkHandle);Notification that the network management has detected that all other nodes on the network are ready to enter Bus-Sleep Mode.
void Nm_RemoteSleepIndication(NetworkHandleType nmNetworkHandle);Service to indicate that an NM message with set Repeat Message Re- quest Bit has been received. This is needed for node detection and the Dynamic PNC-to-channel-mapping feature.
void Nm_RepeatMessageIndication(NetworkHandleType nmNetworkHandle, boolean pnLearningBitSet);Set Repeat Message Request Bit for NM messages transmitted next on the bus. For that purpose <Bus>Nm_RepeatMessageRequest shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. CanNm_RepeatMessageRequest function is called if channel is configured as CAN). This will force all nodes on the bus to transmit NM messages so that they can be identified.
Std_ReturnType Nm_RepeatMessageRequest(NetworkHandleType NetworkHandle);This function store the request for a synchronized PNC shutdown of a particular PNC given by PncId per given NM-Channel. The handling of the synchronized PNC shutdown process is mainly done in the context of the Nm_Mainfunction. The function call is only valid if NmStandardBusType is not set to NM_BUSNM_LOCALNM as a <Bus>Nm like CanNm is needed to transmit the PNC shutdown requests.
Std_ReturnType Nm_RequestSynchronizedPncShutdown(NetworkHandleType NetworkHandle, PNCHandleType PncId);Set user data for NM messages transmitted next on the bus. For that purpose <Bus>Nm_Set UserData shall be called in case NmBusType is not set to NM_BUSNM_LOCALNM. (e.g. Can Nm_SetUserData function is called if channel is configured as CAN).
Std_ReturnType Nm_SetUserData(NetworkHandleType NetworkHandle, const uint8* nmUserDataPtr);Notification that the state of the lower layer <Bus>Nm has changed.
void Nm_StateChangeNotification(NetworkHandleType nmNetworkHandle, Nm_StateType nmPreviousState, Nm_StateType nmCurrentState);Notification to the NM Coordinator functionality that this is a suitable point in time to initiate the coordinated shutdown on.
void Nm_SynchronizationPoint(NetworkHandleType nmNetworkHandle);Notification that the network management has entered Synchronize Mode.
void Nm_SynchronizeMode(NetworkHandleType nmNetworkHandle);Service to indicate that an attempt to send an NM message failed.
void Nm_TxTimeoutException(NetworkHandleType nmNetworkHandle);Indication by ComM of internal PNC requests. This is used to aggregate the internal PNC requests.
void Nm_UpdateIRA(NetworkHandleType NetworkHandle, const uint8* PncBitVectorPtr);BusNm Type
Configuration data structure of the Nm module.
Operational modes of the network management.
States of the network management state machine.
PduR
Disables a routing path group.
void PduR_DisableRouting (PduR_RoutingPathGroupIdType id, boolean initialize);Enables a routing path group.
void PduR_EnableRouting (PduR_RoutingPathGroupIdType id);Returns the unique identifier of the post-build time configuration of the PDU Router
PduR_PBConfigIdType PduR_GetConfigurationId (void);Returns the version information of this module.
void PduR_GetVersionInfo (Std_VersionInfoType* versionInfo);Initializes the PDU Router
void PduR_Init (const PduR_PBConfigType* ConfigPtr);Identification of the post-build configuration currently used for routing I-PDUs. An ECU may contain several configurations (post-build selectable), each have unique Id.
Data structure containing post-build-time configuration data of the PDU Router.
Identification of a Routing Table
States of the PDU Router
SomeIpXf
This service deinitializes the transformer.
void SomeIpXf_DeInit(void);Function to extract the relevant SOME/IP protocol header fields of the message and the type of the message result. - At the time being, this is limited to the types used for C/S communication (i.e., REQUEST and RESPONSE and OK and ERROR).
Std_ReturnType SomeIpXf_ExtractProtocolHeaderFields(const uint8* buffer, uint32 bufferLength, Std_MessageTypeType* messageType, Std_MessageResultType* messageResult);This service returns the version information of the called transformer module.
void SomeIpXf_GetVersionInfo(Std_VersionInfoType* VersionInfo);This service initializes the transformer for the further processing.
void SomeIpXf_Init(const SomeIpXf_ConfigType* config);This function deserializes a Sender/Receiver communication using the deserialization of SOME/IP. It takes the uint8 array containing the serialized data as input and outputs the original data element which will be passed to the RTE.
This function deserializes a Client/Server communication using the deserialization of SOME/IP. It takes the uint8 array containing the serialized data as input and outputs the return value of the server runnable and the operation arguments which have to be passed from the server to the client.
uint8 SomeIpXf_Inv_<transformerId>(Rte_Cs_TransactionHandleType* TransactionHandle, const uint8* buffer, uint32 bufferLength, [ Std_ReturnType* returnValue ], [ <paramtype> data ]);This function transforms a Sender/Receiver communication using the serialization of SOME/IP. It takes the data element as input and outputs a uint8 array containing the serialized data. The length of the serialized data shall be calculated by the transformer during runtime and returned in the OUT-parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
This function transforms a Client/Server communication using the serialization of SOME/IP. It takes the operation arguments and optionally the return value as input and outputs a uint8 array containing the serialized data. The length of the serialized data shall be calculated by the transformer during runtime and returned in the OUT-parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
uint8 SomeIpXf_<transformerId>(const Rte_Cs_TransactionHandleType* TransactionHandle, uint8* buffer, uint32* bufferLength, [ Std_ReturnType returnValue ], <paramtype> data_1, ... <paramtype> data_n);This function transforms an external trigger event using the serialization of SOME/IP. It takes trigger as input and outputs a uint8 array. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
This is the type of the data structure containing the initialization data for the transformer.
Xcp
Returns the version information of this module.
void Xcp_GetVersionInfo(Std_VersionInfoType* versioninfo);This service initializes interfaces and variables of the AUTOSAR XCP layer.
void Xcp_Init(const Xcp_ConfigType* Xcp_ConfigPtr);Indication of a received PDU from a lower layer communication interface module.
void Xcp_<Lo>RxIndication(PduIdType RxPduId, const PduInfoType* PduInfoPtr); ⚠️Within this API , the upper layer module (called module) shall check whether the available data fits into the buffer size reported by Pdu Info Ptr - >Sdu Length. If it fits, it shall copy its data into the buffer provided by Pdu Info Ptr - >Sdu Data Ptr and update the length of the actual copied data in Pdu Info Ptr - >Sdu Length. If not, it returns E_ NOT_ OK without changing Pdu Info Ptr.
Std_ReturnType Xcp_<Lo>TriggerTransmit(PduIdType TxPduId, PduInfoType* PduInfoPtr); ⚠️The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.
void Xcp_< Lo>TxConfirmation(PduIdType TxPduId, Std_ReturnType result); ⚠️Scheduled function of the XCP module
void Xcp_MainFunction(void);This API is used to turn on and off of the TX capabilities of used communication bus channel in XCP module.
void Xcp_SetTransmissionMode(NetworkHandleType Channel, Xcp_TransmissionModeType Mode);This is the type of the data structure containing the initialization data for XCP.
Handles the enabling and disabling of the transmission mode
Xfrm
This service deinitializes the transformer.
void <Mip>_DeInit(void);Function to extract the relevant protocol header fields of the message and the type of the message result of a transformer. - At the time being, this is limited to the types used for C/S communication (i.e., REQUEST and RESPONSE and OK and ERROR).
Std_ReturnType <Mip>_ExtractProtocolHeaderFields(const uint8* buffer, uint32 bufferLength, Std_MessageTypeType* messageType, Std_MessageResultType* messageResult);This service returns the version information of the called transformer module.
void <Mip>_GetVersionInfo(Std_VersionInfoType* VersionInfo);This service initializes the transformer for the further processing.
void <Mip>_Init(const {Mip}_ConfigType* config);This function is the interface of the first transformer in a transformer chain of Client/Server communication (this is the last executed transformer on the receiving side!). It takes the constant buffer (IN parameter buffer) of length (IN parameter bufferLength which may be smaller than the maximum buffer size used by the RTE for buffer allocation) as input and outputs the operation arguments and optionally the return value (OUT parameters data_1, ..., data_n, and returnValue).
uint8 <Mip>_Inv_<transformerId>([ <datatype>* csTransactionHandle ], Rte_Cs_TransactionHandleType* TransactionHandle, const uint8* buffer, uint32 bufferLength, [ Std_ReturnType* returnValue ], [ <paramtype> data ]);This function is the interface of a transformer which is not the first transformer in a transformer chain. It takes the output of an earlier transformer in the chain and transforms the data. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
This function is the interface of the first transformer in a transformer chain of Sender/Receiver communication. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
This function is the interface of the first transformer in a transformer chain of Client/Server communication. It takes the operation arguments and optionally the return value as input and outputs a uint8 array containing the transformed data. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
uint8 <Mip>_<transformerId>([ const <datatype>* csTransactionHandle ], const Rte_Cs_TransactionHandleType* TransactionHandle, uint8* buffer, uint32* bufferLength, [ Std_ReturnType returnValue ], [ <paramtype> data_1, ... <paramtype> data_n ]);This function is the interface of the first transformer in a transformer chain of Sender/Receiver communication. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation. 5 General 4
This function is the interface of the first transformer in a transformer chain of external trigger events. The length of the transformed data shall be calculated by the transformer during runtime and returned in the OUT parameter bufferLength. It may be smaller than the maximum buffer size used by the RTE for buffer allocation.
This is the type of the data structure containing the initialization data for the transformer.
دليل العنقودمولَّد بالذكاء الاصطناعي
ينسق توجيه PDU، ومعالجة الإشارات، وإدارة وضع الشبكة لمكدس الاتصالات.
ينسق توجيه PDU، ومعالجة الإشارات، وإدارة وضع الشبكة لمكدس الاتصالات.
يجمع عنقود الوحدات «Communication Services» مع com وcomm وpdur المعالجة المركزية للإشارات، وتوجيه PDU، وإدارة وضع الشبكة في AUTOSAR Classic Platform SWS_PDURouter ص. 24. وهو يضمن حزم الإشارات الواردة من التطبيق باتساق، وإعادة توجيه وحدات I-PDU عبر جداول توجيه ثابتة بشكل مستقل عن البروتوكول إلى واجهات الاتصال، وتنشيط موارد الناقل حسب الحاجة [SWS_Com_00197]، [SWS_PduR_00160]. وعبر واجهات موحدة، يتم أيضًا تنسيق التوجيه الانتقائي للشبكات الفرعية، ومراقبة المهل الزمنية، وآليات تقليل الكفاءة للتشغيل الموفر للطاقة لوحدة التحكم الإلكترونية [SWS_ComM_00110].
يشكل عنقود الوحدات «Communication Services» العمود الفقري لمعالجة الرسائل والإشارات في AUTOSAR Classic Platform. فهو يدمج وحدات البرمجيات الأساسية الثلاث com وcomm وpdur في Services Layer: بينما تقوم الوحدة com بتسلسل إشارات ومجموعات إشارات RTE في وحدات I-PDU وتصفيتها ومراقبتها [SWS_Com_00197]، يتولى pdur، بوصفه جهة توجيه مستقلة عن البروتوكول، التوجيه بنسبة 1:1 و1:n لوحدات I-PDU بين المستخدمين العلويين وواجهات الناقل دون تعديل بيانات الحمولة [SWS_PduR_00160]. وتنسق الوحدة comm حالة الاتصال من خلال تقييم طلبات SW-Cs أو قنوات التشخيص، وتنشيط القنوات حسب الحاجة عبر مديري حالة الناقل (Bus State Managers) [SWS_ComM_00110]، [SWS_ComM_00873].
مخطط البنية المعمارية: علاقات الوحدات وتضمين عنقود Communication Services في البرمجيات الأساسية. المصادر: SWS_PDURouter ص. 24، SWS_COMManager ص. 30
تعمل الوحدات بتكامل وثيق أثناء مساري الإرسال والاستقبال. عند وجود طلبات إرسال، تقوم com بإعادة توجيه وحدات I-PDU عبر PduR_ComTransmit إلى pdur، والذي يترجم معرّفات I-PDU ويتحكم في برامج التشغيل المستهدفة [SWS_PduR_00406]، [SWS_PduR_00766]. وفي الواجهات المزامنة نبضيًا (مثل LIN)، يطلب برنامج التشغيل السفلي البيانات حسب الحاجة عبر TriggerTransmit، وهو ما يمرره PDU Router دون تخزين مؤقت إلى com [SWS_Com_00001]، [SWS_PduR_00430]. وتقوم pdur بتسليم وحدات I-PDU الواردة عبر RxIndication إلى com لفك حزم الإشارات، ويمكنها في الوقت نفسه نسخها عبر مسارات البوابة إلى نواقل أخرى [SWS_Com_00123]، [SWS_PduR_00362].
تتحدد دورة الحياة بشكل أساسي من خلال حالات comm وpdur. بعد بدء تشغيل النظام، يقوم PduR_Init بتحويل الموجه من PDUR_UNINIT إلى PDUR_ONLINE [SWS_PduR_00308]، [SWS_PduR_00326]. ويدير Communication Manager القنوات عبر الحالات الأساسية COMM_NO_COMMUNICATION وCOMM_FULL_COMMUNICATION وCOMM_SILENT_COMMUNICATION [SWS_ComM_00871]. ويدعم العنقود تقليل الكفاءة الانتقائي وحالات توفير الطاقة عبر آليات مثل منع الاتصال (Communication Inhibition، مثل ComM_LimitChannelToNoComMode) ومجموعات مسارات التوجيه الديناميكية (PduR_EnableRouting / PduR_DisableRouting) [SWS_ComM_00163]، [SWS_PduR_00615].
معمارية النظام & دور مجموعة الوحدات
يشكل عنقود الوحدات «Communication Services» المركز الوظيفي لمكدس الاتصالات في AUTOSAR Classic Platform (الإصدار R20-11) ضمن Services Layer. ويتألف من ثلاث وحدات برمجيات أساسية مترابطة بشكل وثيق هي com (AUTOSAR COM) وcomm (Communication Manager) وpdur (PDU Router). وتعمل هذه الوحدات معًا على تغليف الإدارة المستقلة عن الناقل، والتوجيه، وتجريد الإشارات لشبكة وحدة التحكم الإلكترونية تجاه بيئة وقت التشغيل (RTE) ومكونات برمجيات التطبيق (SW-Cs) وفقًا لهندسة طبقات AUTOSAR SWS_PDURouter ص. 24. ويتفاعل العنقود لأسفل مباشرة مع واجهات طبقة تجريد عتاد الاتصال (CanIf، LinIf، FrIf، EthIf) بالإضافة إلى بروتوكولات النقل (CanTp، FrTp، LinTp) وفقًا لمعايير مثل ISO 11898 (CAN)، وISO 17987 (LIN)، وISO 10681 (FlexRay)، وISO 15765-2 (Transport Layer) AUTOSAR_CP_SWS_PDURouter ص. 110.
تنفذ الوحدة com معالجة البيانات الموجهة بالإشارات: حيث تقوم بتحويل إشارات ومجموعات إشارات RTE إلى وحدات تفاعل (I-PDUs)، وتتولى حزم الإشارات وفكها (Signal Packing)، وتحويل ترتيب البايتات (Endianness) والإشارات الحسابية، فضلًا عن التصفية ومراقبة المهل الزمنية للإرسال (Deadline Monitoring) [SWS_Com_00197]، [SWS_Com_00784]. وتعمل الوحدة pdur كجهة توجيه مستقلة عن البروتوكول تقوم بإعادة توجيه وحدات I-PDU دون تعديل محتواها بين وحدات الخدمة العليا (Com، DCM) وواجهات الاتصال السفلى أو بروتوكولات النقل، وتخدم مسارات البث المتعدد المحلي بنسبة 1:n، وتنفذ البوابات المباشرة [SWS_PduR_00160]، [SWS_PduR_00406]. ويتولى comm التحكم الموجه بالموارد والحالات: فهو يجمع طلبات الاتصال من مكونات البرمجيات، ومدير أوضاع BSW (BswM)، وخدمات التشخيص (DCM وفقًا للمعيار ISO 14229 / UDS)، وينسق أوضاع تشغيل القنوات المادية والشبكات الجزئية (Partial Network Clusters، PNC) [SWS_ComM_00110]، [SWS_ComM_00873].
مخطط البنية المعمارية: علاقات الوحدات وتضمين عنقود Communication Services في البرمجيات الأساسية. المصادر: SWS_PDURouter ص. 24، SWS_COMManager ص. 30، SWS_RTE ص. 329
التكامل ومسارات التفاعل بين الوحدات
يتم التفاعل داخل العنقود عبر سلاسل استدعاء محددة بوضوح لمسارات الإرسال والاستقبال والتأكيد. عند الإرسال، تستدعي RTE واجهات برمجة تطبيقات الإرسال الخاصة بوحدة com، مثل Com_SendSignal أو Com_SendSignalGroup، لتوفير البيانات بشكل ذري [SWS_Com_00197]، [SWS_Com_00200]. وتقوم الوحدة com بحزم الإشارات في وحدة I-PDU المقترنة بها وتسليمها بشكل متزامن إلى PDU Router باستخدام PduR_ComTransmit [SWS_PduR_00406]. يبحث PDU Router عن وحدة I-PDU المستهدفة في جداول التوجيه الثابتة الخاصة به، ويحوّل معرّف I-PDU، ويمرر طلب الإرسال دون تعديل إلى الطبقة السفلى المعنية، على سبيل المثال عبر CanIf_Transmit [SWS_PduR_00161]، [SWS_PduR_00766]. وبعد الإرسال الناجح على الناقل، تؤكد الواجهة عملية النقل إلى pdur عبر PduR_<User:Lo>TxConfirmation [SWS_PduR_00365]، والذي يعيد توجيه الاستدعاء بدوره إلى Com_TxConfirmation [SWS_Com_00124].
بالنسبة لأنظمة النواقل الموقوتة زمنيًا أو القائمة على الاستقصاء مثل LIN أو FlexRay، يقوم المكدس بفك ارتباط طلب الإرسال من خلال إجراء TriggerTransmit: تبدأ الوحدة com الجاهزية للإرسال، لكنها تخزن بيانات الحمولة داخليًا AUTOSAR_CP_SWS_PDURouter ص. 101. وبمجرد وصول مجدول الناقل (في LinIf أو FrIf على سبيل المثال) إلى وقت الإرسال، تستدعي الطبقة السفلى PduR_<User:Lo>TriggerTransmit [SWS_PduR_00430]. ويفوض PDU Router هذا الاستدعاء على الفور ودون تخزين مؤقت إلى Com_TriggerTransmit [SWS_Com_00001]، وبناءً على ذلك تنسخ com البيانات الحالية مباشرة إلى المخزن المؤقت لبرنامج التشغيل SWS_PDURouter ص. 107.
في مسار الاستقبال، تشير واجهة الاتصال السفلى إلى وصول وحدة I-PDU عبر PduR_<User:Lo>RxIndication [SWS_PduR_00362]. ويعيد PDU Router توجيه PDU بشكل متزامن عبر Com_RxIndication إلى com [SWS_Com_00123]، حيث يتم فك حزم الإشارات وتصفيتها وتوفيرها لـ RTE AUTOSAR_CP_SWS_PDURouter ص. 97. وفي الوقت نفسه، يدعم pdur عمل البوابة (Gatewaying): حيث يمكن تسليم وحدة I-PDU المستلمة محليًا إلى com في نفس الوقت وإعادة توجيهها بالتوازي إلى واجهة شبكة صادرة [SWS_PduR_00621]، SWS_PDURouter ص. 114. وفي حالة وحدات PDU لبروتوكول النقل (مثل CanTp أو DCM)، ينسق pdur النقل المجزأ عبر StartOfReception وCopyRxData وTpRxIndication [SWS_PduR_00507]، [SWS_Com_00691]، [SWS_Com_00692].
مخطط التسلسل: مسار إرسال I-PDU المتحكَم به وسير عمل TriggerTransmit عبر PduR. المصادر: SWS_PDURouter ص. 107، AUTOSAR_SWS_COM ص. 114
المزامنة، وقابلية إعادة الدخول، وسياقات المهام
تعمل وحدات العنقود في سياق تنفيذ هجين يجمع بين استدعاءات الدوال المتزامنة والمعالجة الدورية للمهام. وغالبًا ما يتم إطلاق استدعاءات الرد للاستقبال (RxIndication) وتأكيدات نقل الإرسال (TxConfirmation) في سياق مقاطعة برامج التشغيل الأساسية أو في سياق مهام واجهات الاتصال. ولهذا السبب، صُممت وظائف التوجيه في PDU Router لتكون قابلة لإعادة الدخول بشكل صارم SWS_PDURouter ص. 88. وقد حُدد إلغاء عمليات النقل الجارية عبر PduR_<User:Up>CancelTransmit ليكون قابلاً لإعادة الدخول لمعرّفات PDU المختلفة، ولكنه غير قابل لإعادة الدخول لمعرّفات PDU المتطابقة [SWS_PduR_00769].
في الوحدة comm، تم تصميم واجهة المستخدم الأساسية ComM_RequestComMode صراحةً للاستدعاءات المتزامنة بواسطة عدة عناصر قابلة للتشغيل (Runnables) (canbeInvokedConcurrently = TRUE) وتم تنفيذها لتكون قابلة لإعادة الدخول [SWS_ComM_00110]، SWS_COMManager ص. 107. كما تتوفر استعلامات الحالة مثل ComM_GetRequestedComMode [SWS_ComM_00079] وComM_GetMaxComMode [SWS_ComM_00085] كدوال قابلة لإعادة الدخول. وفي المقابل، فإن الدوال الإدارية مثل ComM_SetECUGroupClassification [SWS_ComM_00552]، وComM_GetInhibitionStatus [SWS_ComM_00619] بالإضافة إلى واجهات برمجة تطبيقات التعيين الديناميكي (مثل ComM_UpdatePncToChannelMapping [SWS_ComM_01037]) محددة على أنها غير قابلة لإعادة الدخول وتتطلب الاستدعاء من مستويات مهام محمية.
لمنع عدم اتساق البيانات عند إجراء عمليات وصول متعددة للإشارات، يفرض AUTOSAR معالجة ذرية للإشارات لأنواع البيانات المركبة عبر مجموعات الإشارات [SWS_Com_00197]، [SWS_Com_00200]. وتعمل RTE على تفكيك الإشارات وتسلسلها باتساق في مخازن الظل المؤقتة (Shadow Buffers) المحلية قبل أن تقوم Com_SendSignalGroup بتحرير وحدة I-PDU SWS_RTE ص. 329. وتتم إدارة أنشطة الإرسال الدورية ومراقبة المهل عبر MainFunctions الدورية للوحدات، حيث يتم تنشيط مجموعات I-PDU أو إيقافها حسب الحاجة بواسطة BswM عبر Com_IpduGroupStart وCom_IpduGroupStop [SWS_Com_00784]، SWS_BSWModeManager ص. 93.
دورات الحياة النموذجية وأنماط التشغيل
تتبع دورة حياة عنقود الوحدات تسلسل تهيئة وتشغيل صارمًا. عند بدء التشغيل، يكون PDU Router في البداية في الحالة PDUR_UNINIT، والتي لا يُسمح فيها بأي توجيه إطلاقًا [SWS_PduR_00325]، [SWS_PduR_00330]. ومن خلال استدعاء PduR_Init، يتم تخصيص وتهيئة جميع المخازن المؤقتة الداخلية، وتنتقل الوحدة إلى الحالة PDUR_ONLINE [SWS_PduR_00308]، [SWS_PduR_00742]. وتبدأ الوحدة comm بالمثل في الحالة COMM_UNINIT [SWS_ComM_00668]. وعبر ComM_Init، تُقرأ المعلمات المستمرة (مثل عدادات المنع وتعيينات PNC) من NVRAM وتُنقل آلات حالة القنوات إلى الحالة الافتراضية COMM_NO_COM_NO_PENDING_REQUEST [SWS_ComM_00146]، [SWS_ComM_00674].
تتحكم آلة حالة القناة في comm بثلاثة أوضاع اتصال عليا: COMM_NO_COMMUNICATION وCOMM_SILENT_COMMUNICATION وCOMM_FULL_COMMUNICATION [SWS_ComM_00871]. ويمكن للمستخدمين فقط طلب الاتصال الكامل أو عدم الاتصال [SWS_ComM_00110]. وإذا ورد طلب من المستخدمين أو من DCM في COMM_NO_COM_NO_PENDING_REQUEST (ComM_DCM_ActiveDiagnostic)، تنتقل آلة الحالة إلى COMM_NO_COM_REQUEST_PENDING [SWS_ComM_00873]. وبمجرد توفر إذن الاتصال، يحدث الانتقال إلى COMM_FULL_COM_NETWORK_REQUESTED، وبناءً على ذلك يطلب comm الجاهزية للإرسال والاستقبال عبر مدير حالة الناقل المعني [SWS_ComM_01018]، SWS_COMManager ص. 64.
إذا تم تحرير الاتصال الكامل من قِبل جميع المستخدمين، تنتقل القناة إلى COMM_FULL_COM_READY_SLEEP وتطلب Nm_NetworkRelease في حال الإدارة الكاملة للشبكة SWS_COMManager ص. 78. وللتحضير لوضع سكون الناقل (Bus-Sleep)، تنتقل آلة الحالة إلى COMM_SILENT_COM، حيث يُمنع الإرسال مع بقاء الاستقبال نشطًا للمزامنة [SWS_ComM_00391]، [SWS_ComM_00829]. وعند الإبلاغ عن ComM_<Bus>SM_BusSleepMode، يتم الوصول مجددًا إلى COMM_NO_COM_NO_PENDING_REQUEST [SWS_ComM_91000]. وتتم معالجة الاستيقاظ بواسطة EcuM عبر ComM_EcuM_WakeUpIndication أو ComM_EcuM_PNCWakeUpIndication [SWS_ComM_91001]. ولا يُسمح بإيقاف تشغيل وحدة التحكم الإلكترونية عبر ComM_DeInit إلا بعد إلغاء تهيئة جميع القنوات بالكامل إلى COMM_NO_COMMUNICATION [SWS_ComM_00147].
مخطط الحالة: نموذج الحالة وتغيير وضع التشغيل لقناة اتصال ComM. المصادر: SWS_COMManager ص. 112، SWS_COMManager ص. 63، SWS_COMManager ص. 71
معالجة الأخطاء، وتتبع DET، والتدهور التدريجي للخدمة (Degradation)
تعتمد إدارة الأخطاء وتقليل الكفاءة في العنقود على إرسال بلاغات موحدة إلى Development Error Tracer (DET) وآليات تقييد قابلة للتكوين (Communication Inhibition). وإذا تم تنشيط اكتشاف أخطاء التطوير، يبلغ pdur عن الاستدعاءات غير المهيأة عبر رمز الخطأ PDUR_E_UNINIT [SWS_PduR_00100]، [SWS_PduR_00119]. وتتم معاقبة معرّفات جداول التوجيه غير الصحيحة في استدعاءات التحكم باستخدام PDUR_E_ROUTING_PATH_GROUP_ID_INVALID [SWS_PduR_00648]، بينما يتم الإبلاغ عن معلمات المؤشرات غير الصالحة كـ PDUR_E_PARAM_POINTER SWS_PDURouter ص. 72. وفي الوحدة comm، يؤدي استدعاء واجهات برمجة تطبيقات المراقبة قبل اكتمال التهيئة إلى إرجاع الحالة COMM_UNINIT [SWS_ComM_00242]، [SWS_ComM_00668].
لإجراء خفض الأداء المنضبط وتقليل استهلاك الطاقة، يوفّر comm واجهات لتقييد الاتصال: عبر ComM_LimitChannelToNoComMode أو ComM_LimitECUToNoComMode، يمكن حظر الانتقال إلى الاتصال الكامل لقنوات مفردة أو لوحدة التحكم الإلكترونية ECU بالكامل [SWS_ComM_00124]، [SWS_ComM_00163]. بالإضافة إلى ذلك، يثبط ComM_PreventWakeUp إيقاظ وحدة التحكم الإلكترونية القائم على الشبكة [SWS_ComM_00156]. يُتحكم في صلاحية عمليات الحظر هذه عبر بتات حجب (ComM_SetECUGroupClassification [SWS_ComM_00552]). تُسجل طلبات الاتصال الكامل المرفوضة في عدّاد بذاكرة الأعطال غير المتطايرة، والذي يمكن تشخيصه عبر ComM_ReadInhibitCounter وComM_ResetInhibitCounter [SWS_ComM_00108]، [SWS_ComM_00224]. تتجاوز طلبات التشخيص الصادرة عن DCM قيود الاتصال النشطة مؤقتًا، وذلك للحفاظ دائمًا على إمكانية الوصول إلى وحدة التحكم الإلكترونية [SWS_ComM_00873]، SWS_COMManager ص. 69.
أثناء التشغيل الفعلي، يمكن خفض أداء مسارات التوجيه ديناميكيًا أو تفعيلها داخل PDU Router: عبر PduR_EnableRouting وPduR_DisableRouting، يبدّل BswM مجموعات مسارات التوجيه المكونة على الفور [SWS_PduR_00615]، [SWS_PduR_00617]، [SWS_PduR_00715]. إذا كان مسار التوجيه معطلاً، ترفض استدعاءات الإرسال والاستقبال لوحدات I-PDU المتأثرة نقل البيانات على الفور مع E_NOT_OK أو BUFREQ_E_NOT_OK SWS_PDURouter ص. 69. في تكوينات Post-Build، يراقب pdur سلامة التكوين عبر PduR_GetConfigurationId، لاستبعاد أخطاء التخصيص عند تغير حدود الجداول والمخازن المؤقتة في RAM وNVRAM [SWS_PduR_00341]، [SWS_PduR_00771]، SWS_PDURouter ص. 160.
أُنشئ دليل الكتلة هذا تلقائيًا بالاستناد إلى مواصفات AUTOSAR Classic Platform (الإصدار R20-11) للوحدات com وcomm وpdur.
توفير خدمات معالجة الإشارات وتوجيه وحدات البيانات والتحكم بأنماط اتصالات النواقل في المركبة.
توفر حزمة خدمات الاتصال بنية متكاملة لنقل الإشارات وتوجيه وحدات بيانات البروتوكول وإدارة شبكات المركبة من خلال التنسيق بين وحدات COM وPduR وComM [SWS_Com_00197] و[SWS_PduR_00160]. وتتولى الحزمة مهام حزم الإشارات والتوجيه المحايد للبروتوكولات والتحكم في أنماط النواقل والشبكات الجزئية مع دعم البث المتعدد والتحكم الآني في الإرسال [SWS_ComM_00867] وSWS_PDURouter ص 33. وتلتزم المنظومة بحماية ذرية البيانات والتكامل مع متتبع DET وتطبيق قيود موانع الاتصال الموفرة للطاقة لضمان استقرار العمليات في الوقت الفعلي [SWS_ComM_00163].
تشكل حزمة خدمات الاتصال (Communication Services) في أوتوسار R20-11 المركز المحوري لمعالجة وتوجيه وإدارة تدفق البيانات في المركبة، متضمنةً وحدات COM وPduR وComM [SWS_Com_00197] و[SWS_PduR_00160] و[SWS_ComM_00867]. تختص وحدة COM باستخلاص وحزم الإشارات وإدارة مصفوفات البيانات الكبيرة [SWS_Com_00844]، بينما يعمل موجه PduR كنواة توجيه مجردة ومحايدة لبروتوكولات النقل تضمن نقل وحدات I-PDU دون تعديل بين الطبقات العليا وواجهات العتاد والشبكات المتعددة [SWS_PduR_00161] وSWS_PDURouter ص 24.
يتكامل تدفق البيانات عبر سلاسل استدعاء متزامنة للإرسال تبدأ من COM عبر PduR_ComTransmit [SWS_PduR_00406] وصولاً إلى واجهات النواقل، تليها إشعارات تأكيد غير متزامنة عبر Com_TxConfirmation [SWS_Com_00124]، في حين تتولى إشعارات الاستقبال المباشرة تسليم البيانات لوحدة COM لمعالجتها وتوزيعها على التطبيقات [SWS_Com_00123] و[SWS_PduR_00362]. كما يتيح PduR إمكانية التوجيه البيني (Gatewaying) وإعادة الإرسال متعدد الأطراف بالتوازي مع الاستقبال المحلي SWS_PDURouter ص 114، ويدعم نمط الجلب الآني TriggerTransmit للنواقل المجدولة مثل LIN وFlexRay [SWS_Com_00001] و[SWS_PduR_00369].
مخطط بنية النظام: تمثيل معماري للارتباطات البينية بين وحدات COM وPduR وComM والطبقات العلوية والسفلية. المصادر: SWS_PDURouter ص 24، و[SWS_ComM_00867].
تتولى وحدة ComM إدارة حالات قنوات الاتصال والشبكات الجزئية (PNC) عبر التنقل المنضبط بين أنماط الاتصال الكامل وغير المتصل والصامت [SWS_ComM_00151] و[SWS_ComM_00674] بالتنسيق مع مديري النواقل وإدارة الشبكة [SWS_ComM_00069] و[SWS_ComM_00133]. كما تؤمن الحزمة آليات الإنقاص الوظيفي وحظر الاتصال لتوفير الطاقة عبر [SWS_ComM_00163] و[SWS_ComM_00156]، مع الإبلاغ الفوري عن الأخطاء التشغيلية لمتتبع DET ورفض المسارات المعطلة دون تخزين وسيط لحماية استقرار النظام [SWS_PduR_00100] و[SWS_PduR_00805].
1. بنية النظام ودور حزمة الخدمات الاتصالية
تشكل حزمة «خدمات الاتصال» (Communication Services) في منصة أوتوسار الكلاسيكية (AUTOSAR Classic Platform R20-11) الركيزة البرمجية المركزية لنقل البيانات وتنسيق شبكات المركبة، وتضم ثلاث وحدات برمجية أساسية في طبقة الخدمات والوساطة: وحدة الاتصال [SWS_Com_00197] (AUTOSAR COM)، وموجه وحدات بيانات البروتوكول [SWS_PduR_00160] (PDU Router / PduR)، ومدير الاتصال [SWS_ComM_00867] (Communication Manager / ComM). ترتبط هذه الحزمة رأسيًا بطبقة بيئة التشغيل في الوقت الفعلي (RTE) وتطبيقات البرمجيات (SW-Cs)، وأفقيًا بوحدات إدارة التشخيص مثل مدير اتصالات التشخيص (DCM) وتطبيقات بروتوكولات التشخيص الموحدة ISO 14229 ونقل البيانات ISO 15765، كما تتصل نزولاً بطبقة تجريد عتاد الاتصال (Communication Hardware Abstraction Layer) التي تشمل وحدات واجهات النواقل مثل CanIf وLinIf وFrIf وبروتوكولات النقل CanTp وLinTp وFrTp SWS_PDURouter ص 24.
تتكامل أدوار هذه الوحدات بدقة لتأمين دورة الاتصال الشاملة؛ حيث تتولى وحدة COM استخلاص الإشارات وتجميعها من وإلى وحدات بيانات البروتوكول التفاعلية (I-PDUs)، والتحكم في دورية الإرسال ومراقبة المهل الزمنية، وتوفير واجهات وصول مصفوفية لمجموعات الإشارات المهيكلة عبر [SWS_Com_00844] و[SWS_Com_00845]. في المقابل، تعمل وحدة PduR كنقطة تبادل محايدة لبروتوكولات النقل، مسؤولة عن التوجيه الثابت والوساطة (Zero-Cost Routing أو Gatewaying) لوحدات I-PDU بين الطبقات العليا وواجهات العتاد دون تعديل على حمولة البيانات [SWS_PduR_00160]. وتكتمل المنظومة بوحدة ComM التي تدير حالات قنوات الاتصال الفعلية والشبكات الجزئية (Partial Networks)، وتستقبل طلبات المستخدمين وحالات التشخيص لتفعيل أو تعطيل النواقل بالتنسيق مع مديري حالات النواقل (Bus State Managers) ومدير إدارة الشبكة (Nm) [SWS_ComM_00110] و[SWS_ComM_00069].
مخطط بنية النظام: البنية الهيكلية لكتلة خدمات الاتصال وعلاقات التفاعل بين Com وPduR وComM مع الطبقات المجاورة. المصادر: SWS_PDURouter ص 24، و[SWS_PduR_00160]، و[SWS_ComM_00867].
2. مسارات التفاعل وتدفق البيانات بين الوحدات
يعتمد تدفق البيانات في اتجاه الإرسال على مسار تسلسلي منسق؛ تبدأ العملية عندما تودع مكونات البرمجيات بيانات الإشارات في وحدة COM عبر الواجهات [SWS_Com_00197] أو [SWS_Com_00200]، حيث تُحزم الإشارات داخل I-PDU مخصصة. وعند انطلاق شرط الإرسال (دوري أو حدثي)، تستدعي وحدة COM الدالة [SWS_PduR_00406] في موجه PduR. يقوم PduR بتحويل معرف I-PDU المصدر إلى معرف الوجهة المطابق استنادًا إلى جداول التوجيه المهيأة [SWS_PduR_00161] و[SWS_PduR_00766]، ويمرر حزمة البيانات مباشرة دون تعديل إلى واجهة الناقل المعنية (مثل CanIf_Transmit أو LinIf_Transmit). عند نجاح الإرسال الفعلي على الناقل، يرتد إشعار التأكيد عبر [SWS_PduR_00365] إلى PduR، الذي يعيد توجيهه بدوره عبر Com_TxConfirmation [SWS_Com_00124] لإتاحة تحديث مخازن الإشارات ومراقبة الأوقات المستهدفة.
في مسار الاستقبال، تطلق واجهة الناقل الحدث عند وصول إطار اتصالي عبر استدعاء [SWS_PduR_00362] في PduR، الذي يقوم فوريًا بتعيين مسار التوجيه واستدعاء Com_RxIndication [SWS_Com_00123] لتسليم الحمولة لوحدة COM لمعالجة الإشارات وإخطار الـ RTE. ولا يقتصر دور PduR على التوجيه البسيط (1:1)، بل يدعم كذلك توزيع البث المتعدد (1:N Multicast) وإعادة التوجيه الشبكي (Gatewaying)، حيث يمكن تحويل إطار مستلم من ناقل CAN وإرساله بالتزامن إلى ناقل CAN ثانٍ مع تسليمه محليًا إلى وحدة COM [SWS_PduR_00783] وSWS_PDURouter ص 114. علاوة على ذلك، تدعم الحزمة نمط الاستدعاء الآني (TriggerTransmit) المستخدم في نواقل LIN وFlexRay المجدولة زمنياً؛ حيث يطلب المشغل السفلي استرجاع البيانات المخزنة من COM عبر PduR عند حلول نافذة الإرسال المحددة دون حاجة لتخزين وسيط في موجه PduR [SWS_Com_00001] و[SWS_PduR_00369] و[SWS_PduR_00430].
بالنسبة للرسائل التشخيصية وحزم البيانات الكبيرة التي تتجاوز حجم الإطار الأحادي، يتعامل موجه PduR مع طبقات بروتوكول النقل (Transport Protocol) عبر واجهات تفاعلية تدفقية تشمل بدء الاستقبال [SWS_PduR_00375] ونسخ البيانات التدريجي [SWS_PduR_00507] و[SWS_PduR_00512] والتأكيد النهائي [SWS_PduR_00518] بالتنسيق مع وحدة DCM أو وحدة COM [SWS_Com_00691] و[SWS_Com_00692] و[SWS_Com_00650]. كما يتيح النظام التحكم الديناميكي بمسارات التوجيه المستقلة عبر تفعيل مجموعات مسارات PduR أو تعطيلها فوريًا بواسطة الدالتين [SWS_PduR_00615] و[SWS_PduR_00617]، مما يسمح لوحدة مدير الأنماط (BswM) بالتحكم في حركة المسارات تماشيًا مع حالة الشبكات الجزئية [SWS_PduR_00715] وModeManagementGuide ص 50.
مخطط تتابعي: مسار إرسال وتوجيه وحدات I-PDU من وحدة COM عبر PduR إلى واجهات النواقل مع التأكيد المرتجع. المصادر: [SWS_PduR_00406]، و[SWS_PduR_00365]، و[SWS_Com_00124]، وSWS_PDURouter ص 33.
3. التزامن وسياقات المهام وقابلية إعادة الدخول
تتطلب بنية الخدمات الاتصالية تنظيمًا صارمًا لبيئات التنفيذ وتوزيع أعباء المعالجة بين سياق المقاطعات (ISR Context) ومستوى المهام الدورية المجدولة (Task Level). يُرجَّح – كتفسير معماري معتمد في أوتوسار – أن دوال التبليغ والاستقبال مثل RxIndication وTriggerTransmit يمكن استدعاؤها مباشرة من سياق مقاطعة التعريفات الخاصة بالناقل لتحقيق زمن استجابة أدنى، في حين تُسند العمليات الثقيلة كاستخلاص الإشارات وحساب المرشحات ومراقبة فترات الإرسال الدورية إلى الدوال الرئيسية المجدولة (Com_MainFunctionRx وCom_MainFunctionTx) في سياق مهام نظام التشغيل SWS_PDURouter ص 106.
تتميز واجهات وحدة PduR عمومًا بكونها قابلة لإعادة الدخول (Reentrant) طالما اختلفت معرفات وحدات البيانات، مثل الدالة [SWS_PduR_00615] لإتاحة التوجيه ودالة الإلغاء [SWS_PduR_00769]. وبالمثل، تتمتع واجهات طلب الأنماط واستعلامها في مدير الاتصال ComM بقابلية متزامنة لإعادة الدخول لدعم عدة مستخدمين بالتوازي، كما يظهر في دالة طلب نمط الاتصال ComM_RequestComMode [SWS_ComM_00110] ودالة فحص النمط الأعلى ComM_GetMaxComMode [SWS_ComM_00085] ودالة النمط المطلوب [SWS_ComM_00079]. في المقابل، تُصنف دوال التهيئة والإلغاء وتعديل خرائط النواقل مثل ComM_Init [SWS_ComM_00146] وComM_DeInit [SWS_ComM_00147] وComM_UpdatePncToChannelMapping [SWS_ComM_91015] بكونها غير قابلة لإعادة الدخول (Non-Reentrant)، مما يوجب حمايتها واستدعاءها حصريًا من سياق مهام التهيئة الخاضع لرقابة مدير المكونات BSW.
لضمان ذرية البيانات (Data Atomicity) وتفادي تعارض الوصول عند تداول مصفوفات الإشارات المجمعة، يُلزم المعيار بتحديث مجموعات الإشارات ضمن I-PDU واحدة واستخدام مناطق حصرية (Exclusive Areas) لحماية المخازن المؤقتة المتبادلة بين واجهات الإرسال وموجه البيانات [SWS_Com_00200] و[SWS_Com_00201] وSWS_RTE ص 329. كما يتم تأمين حقول حالات القنوات ومتحكمات موانع الاتصال في ComM داخليًا لتفادي السباق البرمجي عند ورود تنبيهات استيقاظ متزامنة من EcuM أو Nm [SWS_ComM_91001] و[SWS_ComM_00792].
4. دورات الحياة وأنماط التشغيل وإدارة القنوات
تخضع دورة حياة وحدات الحزمة لتسلسل تهيئة بنائي يبدأ بعد إقلاع وحدة التحكم الإلكترونية؛ حيث تنتقل وحدة PduR من حالتها البدئية PDUR_UNINIT إلى الحالة النشطة PDUR_ONLINE عبر استدعاء PduR_Init [SWS_PduR_00324] و[SWS_PduR_00325] و[SWS_PduR_00326]، وتُهيأ المخازن المؤقتة لقيمها الافتراضية [SWS_PduR_00308] و[SWS_PduR_00645]. وفي وحدة ComM، تبدأ التهيئة عبر ComM_Init [SWS_ComM_00146] بشرط اكتمال تهيئة مدير الذاكرة غير المتطايرة (NvM) لاسترجاع معلمات الموانع وعدادات الحظر المحفوظة [SWS_ComM_00668] و[SWS_ComM_00242] وSWS_COMManager ص 97. بعد ذلك تنشط مجموعات وحدات I-PDU في وحدة COM عبر أوامر BswM من خلال Com_IpduGroupStart [SWS_Com_00784] وSWS_BSWModeManager ص 93.
تدير وحدة ComM أنماط الاتصال الأساسية الثلاثة على مستوى القنوات: نمط الاتصال الكامل COMM_FULL_COMMUNICATION، ونمط انعدام الاتصال COMM_NO_COMMUNICATION، ونمط الاتصال الصامت COMM_SILENT_COMMUNICATION المخصص حصريًا للتزامن مع طبقة إدارة الشبكة (Nm) ولا يمكن طلبه مباشرة من مستخدمي التطبيق [SWS_ComM_00867] و[SWS_ComM_00151] و[SWS_ComM_00868]. تتدرج الآلة الحالية لكل قناة عبر خمس حالات فرعية محددة بنوع ComM_StateType [SWS_ComM_00674]: تبدأ من COMM_NO_COM_NO_PENDING_REQUEST، وعند ورود طلب اتصال من مستخدم أو تشخيص DCM نشط [SWS_ComM_00873] تنتقل القناة إلى COMM_NO_COM_REQUEST_PENDING [SWS_ComM_00875] و[SWS_ComM_00876]. وبمجرد تحقق شرط السماح بالاتصال تنتقل إلى COMM_FULL_COM_NETWORK_REQUESTED في نمط الاتصال الكامل [SWS_ComM_00895] و[SWS_ComM_00899]، حيث يتم تفعيل قدرات الإرسال والاستقبال عبر إخطار مديري النواقل [SWS_ComM_00069].
عند زوال متطلبات الإرسال، تنتقل القناة إلى الحالة الفرعية COMM_FULL_COM_READY_SLEEP، حيث تطلب وحدة ComM تحرير الشبكة عبر Nm_NetworkRelease [SWS_ComM_00133] أو انتظار انتهاء مؤقت المهلة للنواقل الخفيفة SWS_COMManager ص 78. وفي حال انتقال الناقل لمرحلة التحضير للنوم، يتحول النمط إلى COMM_SILENT_COMMUNICATION الذي يوقف قدرة الإرسال مع الإبقاء على الاستقبال قائمًا للتنسيق النهائي [SWS_ComM_00071] و[SWS_ComM_00391]. ولا يُسمح بتنفيذ إلغاء التهيئة النهائي ComM_DeInit إلا إذا كانت كافة القنوات التابعة في نمط COMM_NO_COMMUNICATION والحالة البدئية المستقرة [SWS_ComM_00147].
5. آليات الحظر، معالجة الأخطاء والإنقاص الوظيفي
توفر وحدة ComM منظومة متقدمة لإدارة موانع الاتصال (Communication Inhibition) للحد من استهلاك الطاقة أثناء ظروف محددة مثل انخفاض الجهد الكهربائي؛ حيث تتيح الواجهات ComM_LimitChannelToNoComMode [SWS_ComM_00163] وComM_LimitECUToNoComMode [SWS_ComM_00124] قصر القنوات أو كامل وحدة التحكم على نمط انعدام الاتصال، بينما تمنع دالة ComM_PreventWakeUp [SWS_ComM_00156] استيقاظ القنوات غير الضروري. يتم التحكم في صلاحيات هذا الحظر عبر مصفوفة حقول بتية تصنيفية ComM_SetECUGroupClassification [SWS_ComM_00552] وSWS_COMManager ص 84، مع توثيق الطلبات المرفوضة عبر عداد مانع الاتصال الذي يمكن قراءته وتصفيره عبر [SWS_ComM_00224] و[SWS_ComM_00108] وحفظه في الذاكرة الدائمة NvM.
فيما يتعلق بتتبع الأخطاء التطويرية، ترتبط وحدات الحزمة بمتتبع أخطاء التطوير (DET)؛ إذ تبلغ وحدة PduR عن الخطأ PDUR_E_UNINIT عند استدعاء أي من خدمات التوجيه قبل اكتمال التهيئة، وتبلغ عن PDUR_E_PDU_ID_INVALID أو PDUR_E_ROUTING_PATH_GROUP_ID_INVALID عند تمرير معرفات غير صحيحة [SWS_PduR_00100] و[SWS_PduR_00119] و[SWS_PduR_00648]. وتعتمد الحزمة استراتيجيات إنقاص وظيفي متماسكة؛ فعلى الأرجح تُسقط وحدة PduR أي وحدة I-PDU موجهة إلى مسار غير متاح أو معطل عبر PduR_DisableRouting وتعيد فورًا رمز الفشل E_NOT_OK دون تعليق النظام أو استهلاك موارد الذاكرة المؤقتة [SWS_PduR_00805]، بينما تعود وحدة ComM بحالة COMM_E_MODE_LIMITATION عند رفض طلبات التفعيل تحت تأثير موانع الاتصال [SWS_ComM_00110]، مع استثناء جلسات التشخيص النشطة DCM التي تتجاوز مؤقتًا قيود المنع لضمان استمرارية فحص المركبة [SWS_ComM_00876].
تم إنشاء هذا الدليل الفني آليًا استنادًا إلى متطلبات ومواصفات منصة أوتوسار الكلاسيكية AUTOSAR Classic Platform R20-11 لكتلة خدمات الاتصال.
Module im Cluster
AUTOSAR COM
The AUTOSAR COM module provides signal-based communication services for inter-ECU exchange across diverse bus systems.
Communication Manager (ComM)
Manages communication states and channel modes across multiple network interfaces.
COM Based Transformer (ComXf)
AUTOSAR Classic Communication Services-Modul COM Based Transformer (ComXf, Spezifikation: AUTOSAR_CP_SWS_COMBasedTransformer.pdf, AUTOSAR_SWS_COMBasedTransformer.pdf).
Data Distribution Service (Dds)
AUTOSAR Classic Communication Services-Modul Data Distribution Service (Dds, Spezifikation: AUTOSAR_CP_SWS_DataDistributionService.pdf, AUTOSAR_SWS_ClassicPlatformDataDistributionService.pdf).
Data Distribution Service Transformer (DdsXf)
AUTOSAR Classic Communication Services-Modul Data Distribution Service Transformer (DdsXf, Spezifikation: AUTOSAR_CP_SWS_DataDistributionServiceTransformer.pdf).
E2E Transformer (E2EXf)
AUTOSAR Classic Communication Services-Modul E2E Transformer (E2EXf, Spezifikation: AUTOSAR_CP_SWS_E2ETransformer.pdf, AUTOSAR_SWS_E2ETransformer.pdf).
IPDU Multiplexer (IpduM)
AUTOSAR Classic Communication Services-Modul IPDU Multiplexer (IpduM, Spezifikation: AUTOSAR_CP_SWS_IPDUMultiplexer.pdf, AUTOSAR_SWS_IPDUM.pdf, AUTOSAR_SWS_IPDUMultiplexer.pdf).
Large Data COM (LdCom)
AUTOSAR Classic Communication Services-Modul Large Data COM (LdCom, Spezifikation: AUTOSAR_CP_SWS_LargeDataCOM.pdf, AUTOSAR_SWS_LargeDataCOM.pdf).
LSDU Router (LSduR)
AUTOSAR Classic Communication HW Abstraction-Modul LSDU Router (LSduR, Spezifikation: AUTOSAR_CP_SWS_LSduRouter.pdf).
Bus Mirroring (Mirror)
AUTOSAR Classic Communication Services-Modul Bus Mirroring (Mirror, Spezifikation: AUTOSAR_CP_SWS_BusMirroring.pdf, AUTOSAR_SWS_BusMirroring.pdf).
Network Management Interface (Nm)
AUTOSAR Classic Communication Services-Modul Network Management Interface (Nm, Spezifikation: AUTOSAR_CP_SWS_NetworkManagementInterface.pdf, AUTOSAR_SWS_NMInterface.pdf, AUTOSAR_SWS_NetworkManagementInterface.pdf).
PDU Router (PduR)
The PDU Router routes I-PDUs between communication interfaces, transport protocols, and upper layers without payload inspection.
SOME/IP Transformer (SomeIpXf)
AUTOSAR Classic Communication Services-Modul SOME/IP Transformer (SomeIpXf, Spezifikation: AUTOSAR_CP_SWS_SOMEIPTransformer.pdf, AUTOSAR_SWS_SOMEIPTransformer.pdf).
AUTOSAR Xcp
AUTOSAR Classic Communication Services-Modul XCP (Xcp, Spezifikation: AUTOSAR_CP_SWS_XCP.pdf, AUTOSAR_SWS_XCP.pdf).
General Transformer Specification (Xfrm)
AUTOSAR Classic Communication Services-Modul General Transformer Specification (Xfrm, Spezifikation: AUTOSAR_ASWS_TransformerGeneral.pdf, AUTOSAR_CP_ASWS_TransformerGeneral.pdf).
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني