AUTOSAR Classic System Services
Die System Services steuern den gesamten ECU-Lebenszyklus von Power-On über Wakeup, Betriebszustände, Modus-Arbitrierung (BswM) bis zum sicheren Herunterfahren und Programmlauf-Überwachung (WdgM).
Topic map
BswM
35EcuM
65HTMSS
10SwCluC
47WdgM
19No element data available for this release
Arti
Returns the version information of this module.
void Arti_GetVersionInfo(Std_VersionInfoType* VersionInfoPtr);Service to initialize the ARTI module
void Arti_Init(void);BswM
Function called by the Bsw M when a Bsw MUser Callout is executed. The function name and all function parameters are defined b y the Bsw MUser Callout Function configuration parameter. Any return values are ignored by the Bsw M.
void <BswMUserCalloutFunction> (implementation_specific -);Function called by Restart Task if the partition containing the Bsw M has been restarted.
void BswM_BswMPartitionRestarted (void);Function called by Can SM to indicate its current state. Ava ilable via Bsw M_ Can SM.h
void BswM_CanSM_CurrentState (NetworkHandleType Network, CanSM_BswMCurrentStateType CurrentState);Function called by Com M to indicate the current communication mode of a Com M channel.
void BswM_ComM_CurrentMode (NetworkHandleType Network, ComM_ModeType RequestedMode);Function is called by Com M to indicate the current mode of the PNC. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager
void BswM_ComM_CurrentPNCMode (PNCHandleType PNC, ComM_PncModeType CurrentPncMode);Function is called by Com M to signal a shutdown.
void BswM_ComM_InitiateReset (void);This function is called by the DCM in order to report an updated application.
void BswM_Dcm_ApplicationUpdated (void);Function called by DCM to inform the Bsw M about the current state of the communication mode.
void BswM_Dcm_CommunicationMode_CurrentState (NetworkHandleType Network, Dcm_CommunicationModeType RequestedMode);Deinitializes the BSW Mode Manager.
void BswM_Deinit (void);Function called Ecu M to indicate the current ECU Operation Mode.
void BswM_EcuM_CurrentState (EcuM_StateType CurrentState);Function called by Ecu M to indicate the current state of a wakeup source.
void BswM_EcuM_CurrentWakeup (EcuM_WakeupSourceType source, EcuM_WakeupStatusType state);Function called by Ecu M notify about current Status of the Run Request Protocol.
void BswM_EcuM_RequestedState (EcuM_StateType State, EcuM_RunStatusType CurrentState);Function called by Eth If to indicate the link state change of a certain Ethernet switch port group.
void BswM_EthIf_PortGroupLinkStateChg (EthIf_SwitchPortGroupIdxType PortGroupIdx, EthTrcv_LinkStateType PortGroupState);Function called by Eth SM to indicate its current state.
void BswM_EthSM_CurrentState (NetworkHandleType Network, EthSM_NetworkModeStateType CurrentState);Function called by Fr SM to indicate its current state.
void BswM_FrSM_CurrentState (NetworkHandleType Network, FrSM_BswM_StateType CurrentState);Returns the version information of this module.
void BswM_GetVersionInfo (Std_VersionInfoType* VersionInfo);Initializes the BSW Mode Manager.
void BswM_Init (const BswM_ConfigType* ConfigPtr);This API tells the Bsw M the desired communication status of the available networks. The status will typically be activated via COM I - PDU group switches.
void BswM_J1939DcmBroadcastStatus (uint16 NetworkMask);Notification of current J1939Nm state after state changes. AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager
void BswM_J1939Nm_StateChangeNotification (NetworkHandleType Network, uint8 Node, Nm_StateType NmState);Function called by Lin SM to indicate the currently active schedule table for a specific LIN channel.
void BswM_LinSM_CurrentSchedule (NetworkHandleType Network, LinIf_SchHandleType CurrentSchedule);Function called by Lin SM to indicate its current state.
void BswM_LinSM_CurrentState (NetworkHandleType Network, LinSM_ModeType CurrentState);Function called by Lin TP to request a mode for the corresponding LIN channel. The Lin Tp_ Mode correlates to the LIN schedule table that should be used.
void BswM_LinTp_RequestMode (NetworkHandleType Network, LinTp_Mode LinTpRequestedMode);Main function of the Bsw M
void BswM_MainFunction (void);Function called by Nm to indicate a Car Wakeup.
void BswM_Nm_CarWakeUpIndication (NetworkHandleType Network);Notification of current Nm state after state changes.
void BswM_Nm_StateChangeNotification (NetworkHandleType Network, Nm_StateType currentState);Function called by Nv M to indicate the current block mode of an Nv M block.
void BswM_NvM_CurrentBlockMode (NvM_BlockIdType Block, NvM_RequestResultType CurrentBlockMode);Function called by Nv M to inform the Bsw M about the current state of a multi block job.
void BswM_NvM_CurrentJobMode (NvM_MultiBlockRequestType MultiBlockRequest, NvM_RequestResultType CurrentJobMode);Generic function call to request modes. This function shall only be used by other BSW modules that does not have a specific mode request interface.
void BswM_RequestMode (BswM_UserType requesting_user, BswM_ModeType requested_mode);Function called by Service Discovery to indicate current state of the Client Service (available/ down).
void BswM_Sd_ClientServiceCurrentState (uint16 SdClientServiceHandleId, Sd_ClientServiceCurrentStateType CurrentClientState);Function called by Service Discovery to indicate current status of the Consumed Eventgroup (available/ down).
void BswM_Sd_ConsumedEventGroupCurrentState (uint16 SdConsumedEventGroupHandleId, Sd_ConsumedEventGroupCurrentStateType ConsumedEventGroupState);Function called by Service Discovery to indicate current status of the Event Handler (requested/ released).
void BswM_Sd_EventHandlerCurrentState (uint16 SdEventHandlerHandleId, Sd_EventHandlerCurrentStateType EventHandlerStatus);Function called by Wdg M to request a partition reset.
void BswM_WdgM_RequestPartitionReset (ApplicationType Application);This structure contains all post - build configurable parameters of the BSW Mode AUTOSAR CP R20 - of Document ID : AUTOSAR_SWS_BSWModeManager Manager. A pointer to this structure is passed to the BSW Mode Manager initialization function for configuration.
This type identifies the modes that can be requested by Bsw M Users.
This type identifies a Bsw M User that makes mode requests to the Bsw M.
EcuM
Ecum_AbortWakeupAlarm aborts the wakeup alarm previously set by this user. EcuM_Abort WakeupAlarm is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_AbortWakeupAlarm (EcuM_UserType user);This callout shall provide driver initialization and other hardware-related startup activities in case of a power on reset.
void EcuM_AL_DriverInitOne (void);This callout shall provide driver initialization and other hardware-related startup activities for loading the post-build configuration data. Beware: Here only pre-compile and link-time configurable modules may be used.
void EcuM_AL_DriverInitZero (void);This callout shall provide driver initialization and other hardware-related startup activities in the wakeup case.
void EcuM_AL_DriverRestart (void);This callout shall take the code for resetting the ECU.
void EcuM_AL_Reset (EcuM_ResetType reset);If the configuration parameter EcuMSetProgrammableInterrupts is set to true, this callout Ecu M_AL_SetProgrammableInterrupts is executed and shall set the interrupts on ECUs with programmable interrupts.
void EcuM_AL_SetProgrammableInterrupts (void);This callout shall take the code for shutting off the power supply of the ECU. If the ECU cannot unpower itself, a reset may be an adequate reaction.
void EcuM_AL_SwitchOff (void);This callout is intended to provide a RAM integrity test. The goal of this test is to ensure that after a long SLEEP duration, RAM contents is still consistent. The check does not need to be exhaustive since this would consume quite some processing time during wakeups. A well designed check will execute quickly and detect RAM integrity defects with a sufficient probability. This specification does not make any assumption about the algorithm chosen for a particular ECU. The areas of RAM which will be checked have to be chosen carefully. It depends on the check algorithm itself and the task structure. Stack contents of the task executing the RAM check e.g. very likely cannot be checked. It is good practice to have the hash generation and checking in the same task and that this task is not preemptible and that there is only little activity between hash generation and hash check. The RAM check itself is provided by the system designer. In case of applied multi core and existence of Satellite-Ecu M(s): this API will be called by the Master-EcuM only.
uint8 EcuM_CheckRamHash (void);This callout is called by the EcuM to validate a wakeup source. If a valid wakeup has been detected, it shall be reported to EcuM via EcuM_ValidateWakeupEvent().
void EcuM_CheckValidation (EcuM_WakeupSourceType wakeupSource);This callout is called by the EcuM to poll a wakeup source. It shall also be called by the ISR of a wakeup source to set up the PLL and check other wakeup sources that may be connected to the same interrupt.
void EcuM_CheckWakeup (EcuM_WakeupSourceType wakeupSource);Clears wakeup events.
void EcuM_ClearWakeupEvent (EcuM_WakeupSourceType sources);This callout should evaluate some condition, like port pin or NVRAM value, to determine which post-build configuration shall be used in the remainder of the startup process. It shall load this configuration data into a piece of memory that is accessible by all BSW modules and shall return a pointer to the EcuM post-build configuration as a base for all BSW module post-build configrations.
const EcuM_ConfigType* EcuM_DeterminePbConfiguration (void);The ECU Manager Module calls EcuM_DisableWakeupSources to set the wakeup source(s) defined in the wakeupSource bitfield so that they are not able to wake the ECU up.
void EcuM_DisableWakeupSources (EcuM_WakeupSourceType wakeupSource);The ECU Manager Module calls EcuM_EnableWakeupSource to allow the system designer to notify wakeup sources defined in the wakeupSource bitfield that SLEEP will be entered and to adjust their source accordingly.
void EcuM_EnableWakeupSources (EcuM_WakeupSourceType wakeupSource);This API is called by any SW Module whose wakeup source is checked asynchronously (e.g. asynchronous Can Trcv Driver) and the Check of the Wakeup returns a negative Result (no Wakeup by this Source). The API cancels the CheckWakeupTimer for the WakeupSource. If the correponding CheckWakeupTimer is canceled the check of this wakeup source is finished.
void EcuM_EndCheckWakeup (EcuM_WakeupSourceType WakeupSource);The ECU State Manager will call the error hook if the error codes "ECUM_E_RAM_CHECK_ FAILED" or "ECUM_E_CONFIGURATION_DATA_INCONSISTENT" occur. In this situation it is not possible to continue processing and the ECU must be stopped. The integrator may choose the modality how the ECU is stopped, i.e. reset, halt, restart, safe state etc.
void EcuM_ErrorHook (uint16 reason);see EcuM_CheckRamHash
void EcuM_GenerateRamHash (void);EcuM_GetBootTarget returns the current boot target - see EcuM_SelectBootTarget. EcuM_Get BootTarget is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetBootTarget (EcuM_BootTargetType* target);EcuM_GetCurrentTime returns the current value of the EcuM clock (i.e. the time since battery connect). EcuM_GetCurrentTime is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetCurrentTime (EcuM_TimeType* time);Gets expired wakeup events.
EcuM_WakeupSourceType EcuM_GetExpiredWakeupEvents (void);EcuM_GetLastShutdownTarget returns the shutdown target of the previous shutdown process. EcuM_GetLastShutdownTarget is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetLastShutdownTarget (EcuM_ShutdownTargetType* shutdownTarget, EcuM_ShutdownModeType* shutdownMode);Gets pending wakeup events.
EcuM_WakeupSourceType EcuM_GetPendingWakeupEvents (void);EcuM_GetShutdownCause returns the selected shutdown cause as set by EcuM_Select ShutdownCause. EcuM_GetShutdownCause is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetShutdownCause (EcuM_ShutdownCauseType* shutdownCause);EcuM_GetShutdownTarget returns the currently selected shutdown target as set by EcuM_ SelectShutdownTarget. EcuM_GetShutdownTarget is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetShutdownTarget (EcuM_ShutdownTargetType* shutdownTarget, EcuM_ShutdownModeType* shutdownMode);Gets validated wakeup events.
EcuM_WakeupSourceType EcuM_GetValidatedWakeupEvents (void);Returns the version information of this module.
void EcuM_GetVersionInfo (Std_VersionInfoType* versioninfo);EcuM_GetWakeupTime returns the current value of the master alarm clock (the minimum absolute time of all user alarm clocks). EcuM_GetWakeupTime is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_GetWakeupTime (EcuM_TimeType* time);Instructs the ECU State Manager module to go into a sleep mode, Reset or OFF depending on the previously selected shutdown target.
Std_ReturnType EcuM_GoDownHaltPoll (EcuM_UserType UserID);Initializes the ECU state manager and carries out the startup procedure. The function will never return (it calls StartOS)
void EcuM_Init (void);If the configuration parameter EcuMResetLoopDetection is set to true, this callout EcuM_Loop Detection is called on every startup.
void EcuM_LoopDetection (void);The purpose of this service is to implement all activities of the ECU State Manager while the OS is up and running.
void EcuM_MainFunction (void);This call allows the system designer to notify that the GO OFF I state is about to be entered.
void EcuM_OnGoOffOne (void);This call allows the system designer to notify that the GO OFF II state is about to be entered.
void EcuM_OnGoOffTwo (void);Releases a POST RUN request previously done with a call to EcuM_RequestPOST_RUN. The service is intended for implementing AUTOSAR ports.
Std_ReturnType EcuM_ReleasePOST_RUN (EcuM_UserType user);Releases a RUN request previously done with a call to EcuM_RequestRUN. The service is intended for implementing AUTOSAR ports.
Std_ReturnType EcuM_ReleaseRUN (EcuM_UserType user);Places a request for the POST RUN state. Requests can be placed by every user made known to the state manager at configuration time. Requests for RUN and POST RUN must be tracked independently (in other words: two independent variables). The service is intended for implementing AUTOSAR ports.
Std_ReturnType EcuM_RequestPOST_RUN (EcuM_UserType user);Places a request for the RUN state. Requests can be placed by every user made known to the state manager at configuration time.
Std_ReturnType EcuM_RequestRUN (EcuM_UserType user);EcuM_SelectBootTarget selects a boot target. EcuM_SelectBootTarget is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SelectBootTarget (EcuM_BootTargetType target);EcuM_SelectShutdownCause elects the cause for a shutdown. EcuM_SelectShutdownCause is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SelectShutdownCause (EcuM_ShutdownCauseType target);EcuM_SelectShutdownTarget selects the shutdown target. EcuM_SelectShutdownTarget is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SelectShutdownTarget (EcuM_ShutdownTargetType shutdownTarget, EcuM_ShutdownModeType shutdownMode);EcuM_SetAbsWakeupAlarm sets the user's wakeup alarm to an absolute point in time. EcuM_ SetAbsWakeupAlarm is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SetAbsWakeupAlarm (EcuM_UserType user, EcuM_TimeType time);EcuM_SetClock sets the EcuM clock time to the provided value. This API is useful for testing the alarm services; Alarms that take days to expire can be tested. EcuM_SetClock is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SetClock (EcuM_UserType user, EcuM_TimeType time);EcuM_SetRelWakeupAlarm sets a user's wakeup alarm relative to the current point in time. EcuM_SetRelWakeupAlarm is part of the ECU Manager Module port interface.
Std_ReturnType EcuM_SetRelWakeupAlarm (EcuM_UserType user, EcuM_TimeType time);Function called by BswM to notify about State Switch.
void EcuM_SetState (EcuM_StateType state);Sets the wakeup event.
void EcuM_SetWakeupEvent (EcuM_WakeupSourceType sources);Typically called from the shutdown hook, this function takes over execution control and will carry out GO OFF II activities.
void EcuM_Shutdown (void);This callout is invoked periodically in all reduced clock sleep modes. It is explicitely allowed to poll wakeup sources from this callout and to call wakeup notification functions to indicate the end of the sleep state to the ECU State Manager.
void EcuM_SleepActivity (void);This API is called by the ECU Firmware to start the CheckWakeupTimer for the corresponding WakeupSource. If EcuMCheckWakeupTimeout > 0 the CheckWakeupTimer for the Wakeup Source is started. If EcuMCheckWakeupTimeout <= 0 the API call is ignored by the EcuM.
void EcuM_StartCheckWakeup (EcuM_WakeupSourceType WakeupSource);This function implements the STARTUP II state.
void EcuM_StartupTwo (void);The callout shall start the given wakeup source(s) so that they are ready to perform wakeup validation.
void EcuM_StartWakeupSources (EcuM_WakeupSourceType wakeupSource);The callout shall stop the given wakeup source(s) after unsuccessful wakeup validation.
void EcuM_StopWakeupSources (EcuM_WakeupSourceType wakeupSource);After wakeup, the ECU State Manager will stop the process during the WAKEUP VALIDATION state/sequence to wait for validation of the wakeup event.This API service is used to indicate to the ECU Manager module that the wakeup events indicated in the sources parameter have been validated.
void EcuM_ValidateWakeupEvent (EcuM_WakeupSourceType sources);
A pointer to such a structure shall be provided to the ECU State Manager initialization routine for configuration.
This type describes the reset mechanisms supported by the ECU State Manager. It can be extended by configuration.
Result of the Run Request Protocol sent to BswM
This type describes the cause for a shutdown by the ECU State Manager. It can be extended by configuration.
This data type represents the modes of the ECU Manager module.
ECU State Manager states.
This data type represents the time of the ECU Manager module.
Unique value for each user.
EcuM_WakeupSourceType defines a bitfield with 5 pre-defined positions (see Range). The bitfield provides one bit for each wakeup source. In WAKEUP, all bits cleared indicates that no wakeup source is known. In STARTUP, all bits cleared indicates that no reason for restart or reset is known. In this case, ECUM_WKSOURCE_RESET shall be assumed.
The type describes the possible states of a wakeup source.
HTMSS
-
void HTMSS_GetVersionInfo(Std_VersionInfoType* versioninfo);Initializes the HTMSS module
void HTMSS_Init(const HTMSS_TestCfgType* ConfigPtr);The ECU State Manager will call the error hook if the HTMSS provided shutdown test results have a failure. In this situation, the integrator has to control the CPU processing based on the system requirements, i.e. reset, safe state etc...
void HTMSS_ShutdownTestErrorHook(void);Starts the MSTP configured tests
Std_ReturnType HTMSS_StartTest(HTMSS_TestGroupType GrpId);The ECU State Manager will call the error hook if the HTMSS provided startup test results have a failure. In this situation, the integrator has to control the CPU processing based on the system requirements, i.e. reset, safe state etc...
void HTMSS_StartupTestErrorHook(void);Returns current test status on requested test
HTMSS_TestStatusType HTMSS_GetTestStatus(HTMSS_TestGroupType GrpId, HTMSS_TestResultType* RequestTestResultPtr);Configuration data structure of HTMSS module
HTMSS_ Test Group Type describes the test group type Variation --
It describes the current test result Variation --
HTMSS_ Test Status Type describes status of test.
SwCluC
Returns the number of actually used - and thereby connected - handle sets Tags: atp.Status=draft
SwCluC_BManif_HandleIndexType SwCluC_BManif_GetNoOfHandleSets_< Resource Entry Group>_<Resource Entry>(void);Returns the number of actually used - and thereby connected - handle sets. Tags: atp.Status=draft
SwCluC_BManif_HandleIndexType SwCluC_BManif_GetNoOfHandleSets_< Resource Entry Group>(SwCluC_BManif_TableIndexType resIndex);Returns the Id of the connected Software Cluster for a Notifier Handle of a Provide Resource Entry or Provide Handle of a Require Resource Entry Tags: atp.Status=draft
SwCluC_BManif_SwClusterIdType SwCluC_BManif_GetConSwClusterId_< ResourceEntryGroup>_<Handle>(SwCluC_BManif_TableIndexType resIndex, SwCluC_BManif_HandleIndexType notifierSetIndex);Returns the Id of the connected Software Cluster for a Notifier Handle of a Provide Resource Entry or a Provide Handle of a Require Resource Entry Tags: atp.Status=draft
SwCluC_BManif_SwClusterIdType SwCluC_BManif_GetConSwClusterId_< ResourceEntryGroup>_<ResourceEntry>_<Handle>(SwCluC_BManif_HandleIndexType notifierSetIndex);Returns the Id of the connected Software Cluster for a Notifier Handle of a Provide Resource Entry or a Provide Handle of a Require Resource Entry Tags: atp.Status=draft
<handleType> SwCluC_BManif_GetHandle_<ResourceEntryGroup>_<Handle>(SwCluC_BManif_TableIndexType resIndex, SwCluC_BManif_HandleIndexType notifierSetIndex);Returns a handle of a Resource Entry in a Resource Entry Group Tags: atp.Status=draft
<handleType> SwCluC_BManif_GetHandle_<ResourceEntryGroup>_< ResourceEntry>_<Handle>(SwCluC_BManif_HandleIndexType notifierSetIndex);Returns the value of the Subscribed Interface Validity Marker. Tags: atp.Status=draft
uint32 SwCluC_BManif_GetValidityMarker(void);This callback function indicates that the signal of the primitive data item/event is ready for reception. It is an implementation of a <ComUser_CbkRxAck> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_CbkRxAck(CbkHandleIdType ComUserCbkHandleId);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 SwCluC_ComProxy_<BS>_ComCbkCopyTxData(CbkHandleIdType ComUserCbkHandleId, const PduInfoType* info, const RetryInfoType* retry, PduLengthType* availableDataPtr);This callback function indicates that COM has received a signal and parsed it as "invalid". It is an implementation of a <ComUser_CbkInv> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_COMCbkInv(CbkHandleIdType ComUserCbkHandleId);Indication of a received PDU from a lower layer communication interface module. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_ComCbkRxIndication(CbkHandleIdType ComUserCbkHandleId, const PduInfoType* PduInfoPtr);This callback function indicates that the aliveTimeout after the last successful reception of the signal of the data item/event has expired (data element outdated). It is an implementation of a <ComUser_CbkRxTOut> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_COMCbkRxTOut(CbkHandleIdType ComUserCbkHandleId);This callback function indicates that the signal of the data item/event is already handed over by COM to the PDU router. It is an implementation of a <ComUser_CbkTxAck> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_COMCbkTAck(CbkHandleIdType ComUserCbkHandleId);This callback function indicates that an error occurred when the signal of the data item/event was handed over by COM to the PDU router. It is an implementation of a <ComUser_CbkTx Err> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_COMCbkTErr(CbkHandleIdType ComUserCbkHandleId);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 SwCluC_ComProxy_<BS>_ComCbkTpRxIndication(CbkHandleIdType ComUserCbkHandleId, 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 SwCluC_ComProxy_<BS>_ComCbkTriggerTransmit(CbkHandleIdType ComUserCbkHandleId, 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 SwCluC_ComProxy_<BS>_ComCbkTxConfirmation(CbkHandleIdType ComUserCbkHandleId, Std_ReturnType result);This callback function indicates that the timeout of TransmissionAcknowledgementRequest for sending the signal of the data item/event has expired. It is an implementation of a <ComUser_ CbkTxTOut> callback. Tags: atp.Status=draft
void SwCluC_ComProxy_<BS>_COMCbkTxTOut(CbkHandleIdType ComUserCbkHandleId);SwCluC_ComProxy_Init is intended to allocate and initialize system resources used by the ComProxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_ComProxy_Init_<SwCluCComBaseSocket>(void);SwCluC_DcmProxy_Init is intended to allocate and initialize system resources used by the DCM Proxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_DcmProxy_Init_<SwCluCDcmBaseSocket>(void);SwCluC_DemProxy_Init is intended to allocate and initialize system resources used by the DEM Proxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_DemProxy_Init_<SwCluCDemBaseSocket>(void);SwCluC_FiMProxy_Init is intended to allocate and initialize system resources used by the FiM Proxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_FiMProxy_Init_<SwCluCFiMBaseSocket>(void);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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_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 SwCluC_LdComProxy_<BS>_LdComCbkTxConfirmation(CbkHandleIdType LdComUserCbkHandleId, Std_ReturnType result);SwCluC_LdComProxy_Init is intended to allocate and initialize system resources used by the LdComProxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_LdComProxy_Init_<SwCluCLdComBaseSocket>(void);SwCluC_NvMProxy_Init is intended to allocate and initialize system resources used by the Nv MProxy linked to this specific socked. Tags: atp.Status=draft
void SwCluC_NvMProxy_Init_<SwCluCNvMBaseSocket>(void);This function informs the NvM proxy of the SwCluC about the end of the NvM_ReadAll job.
void SwCluC_NvMProxy_MultiBlockReadAllJobFinished(void);SwCluC_OsProxy_Init is intended to allocate and initialize system resources used by the Os Proxy linked to this specific socked Tags: atp.Status=draft
void SwCluC_OsProxy_Init_<SwCluCOsProxyOsBaseSocket>(void);SwCluC_Xcc_Init is intended to allocate and initialize system resources used by the Software Cluster Connection. It initializes interface memory which might be needed to be read by other Software Clusters but it is not allowed to do any read access to memory of any another Software Cluster. Tags: atp.Status=draft
void SwCluC_Xcc_Init1(void);SwCluC_Xcc_Init2 is intended to allocate and initialize system resources used by the Software Cluster Connection. It can execute initializations which require a read access to interface memory of another Software Clusters. Tags: atp.Status=draft
void SwCluC_Xcc_Init2(void);Type to code control flags for the connection process. Bit 0..14 are reserved. Tags: atp.Status=draft
Type for the global ID value of a resource Tags: atp.Status=draft
Index type to address a set of handles in the immutable and modifiable interface table Tags: atp.Status=draft
Tags: atp.Status=draft
Type for the global ID value of a resource Tags: atp.Status=draft
Type for the guard value of a resource Tags: atp.Status=draft
Type to code the properties of a resource. Bit 0..5 are reserved. Tags: atp.Status=draft
Type to code the type of a resource Tags: atp.Status=draft
Type of the Software Cluster's ID value Tags: atp.Status=draft
Index type to address the immutable and modifiable interface table Tags: atp.Status=draft
Generic function pointer type according C default type for functions Tags: atp.Status=draft
WdgM
Indicates to the Watchdog Manager that a Checkpoint within a Supervised Entity has been reached.
Std_ReturnType WdgM_CheckpointReached (WdgM_SupervisedEntityIdType SEID, WdgM_CheckpointIdType CheckpointID);De - initializes the Watchdog Manager.
void WdgM_DeInit (void);Returns SEID that first reached the stat e WDGM_ LOCAL_ STATUS_ EXPIRED.
Std_ReturnType WdgM_GetFirstExpiredSEID (WdgM_SupervisedEntityIdType* SEID);Returns the global supervision status of the Watchdog Manager.
Std_ReturnType WdgM_GetGlobalStatus (WdgM_GlobalStatusType* Status);Returns the supervision status of an individual Supervised Entity.
Std_ReturnType WdgM_GetLocalStatus (WdgM_SupervisedEntityIdType SEID, WdgM_LocalStatusType* Status);Returns the current mode of the Watchdog Manager.
Std_ReturnType WdgM_GetMode (WdgM_ModeType* Mode);Returns the version information of this module.
void WdgM_GetVersionInfo (Std_VersionInfoType* VersionInfo);Initializes the Watchdog Manager.
void WdgM_Init (const WdgM_ConfigType* ConfigPtr);Performs the processing of the cyclic Watchdog Manager jobs.
void WdgM_MainFunction (void);Instructs the Watchdog Manager to cause a watchdog reset.
void WdgM_PerformReset (void);Sets the current mode of Watchdog Manager.
Std_ReturnType WdgM_SetMode (WdgM_ModeType Mode);-
This type identifies a Checkpoint in the context of a Supervised Entity for the Watchdog Manager. Note that an individual Checkpoint can only be identified by the pair of Supervised Entity ID and Checkpoint ID.
This structure contains all post - build configurable parameters of the Watchdog Manager. A pointer to this structure is passed to the Watchdog Manager initialization function for configuration. AUTOSAR CP R20 - of D ocument ID : AUTOSAR_SWS_WatchdogManager
This type shall be used for variables that represent the global supervision status of the Watchdog Manager module.
This type shall be used for variables that represent the current status of supervision for individual Supervised Entitie s.
The category of Mode Declaration Group Wdg M_ Mode is EXPLICIT_ ORDER, The attribute value for the Mode Declaration are set as following: "SUPERVISION_ OK" = 0 "SUPERVISION_ FAILED" = 1 "SUPERVISION_ EXPIRED" = 2 "SUPERVISION_ STOPPED" = 3 "SUP ERVISION_ DEACTIVATED" = 4 The on Transition Value is defined as 255
This type distinguishes the different modes that were configured for the Watchdog Manager.
This type identifies an individual Supervised Entity for the Watchdog Manager.
Cluster guideAI-GENERATED
Coordinates ECU lifecycles, arbitrates operating modes, and ensures functional watchdog monitoring.
Coordinates ECU lifecycles, arbitrates operating modes, and ensures functional watchdog monitoring.
The System Services module cluster controls the lifecycle of the ECU from early boot phases to shutdown, arbitrates operating modes, and ensures program flow monitoring to fulfill functional safety requirements SafetyConceptStatusReport p. 15. The ECU State Manager aggregates mode requests and delegates state decisions to the BSW Mode Manager, while the Watchdog Manager monitors execution and controls the Watchdog Driver SWS_ECUStateManager p. 103. In the event of severe control flow violations, the cluster stops watchdog servicing and forces a safe hardware reset [SWS_WdgM_00232].
The System Services module cluster controls the lifecycle of the ECU, switches operating modes, and safeguards program flow monitoring according to functional safety requirements SafetyConceptStatusReport p. 15. The BSW Mode Manager (BswM) acts as the central decision-making instance, while the ECU State Manager (EcuM) coordinates hardware-specific phases such as StartPreOS, Sleep, and Shutdown and propagates requests to the BswM SWS_ECUStateManager p. 103. Program flow monitoring is implemented by the Watchdog Manager (WdgM), which performs alive, deadline, and control flow monitoring and triggers the hardware via the Watchdog Driver (Wdg) [SWS_Wdg_00155].
Context diagram: Architecture and collaboration of System Services with BSW, RTE, and hardware. Sources: SWS_ECUStateManager p. 34, AUTOSAR_EXP_ModeManagementGuide p. 61.
During ongoing operation, requests such as RUN or POST_RUN collect in EcuM, which reports them in aggregated form to BswM [SWS_BswM_91004]. After evaluating configured rules, BswM sets the state via EcuM_SetState, which is reported to the components via the RTE [SWS_EcuM_04116]. In sleep phases, wakeup events are processed via a standardized state machine (NONE, PENDING, VALIDATED, EXPIRED) and signaled synchronously to BswM [SWS_BswM_00131].
Sequence diagram: Interaction path of ECU Mode Handling between SW-C, EcuM, BswM, and RTE. Sources: SWS_ECUStateManager p. 103, ModeManagementGuide p. 34.
If a critical monitoring error occurs in WdgM, the monitoring status changes to WDGM_GLOBAL_STATUS_STOPPED, whereupon watchdog triggering is stopped and the hardware initiates a system reset [SWS_WdgM_00232]. The cluster reports configuration or call errors to the Default Error Tracer (Det) in a standardized manner [SWS_EcuM_03026].
1. System Architecture & Role of the Module Cluster
The System Services module cluster forms the functional backbone of the AUTOSAR Classic Platform. It comprises the BSW Mode Manager (BswM), the ECU State Manager (EcuM), the Watchdog Manager (WdgM), and the hardware-level Watchdog Driver (Wdg) SWS_ECUStateManager p. 35. Together, these modules control the holistic lifecycle of the ECU, coordinate hardware-related as well as application operating modes, and ensure temporal and logical program flow monitoring to guarantee functional safety SafetyConceptStatusReport p. 15.
In the AUTOSAR layered architecture, BswM, EcuM, and WdgM are located in the System Services layer above the abstraction and driver layers, while the Watchdog Driver (Wdg) operates the hardware registers of the watchdog timer as part of the Microcontroller Abstraction Layer (MCAL) [SWS_Wdg_00106]. In its flexible variant (EcuM Flex), EcuM acts as a link to the hardware for early boot and late shutdown sequences before and after the operating system start, respectively. It no longer has its own complex state machine for application modes, but delegates mode arbitration to BswM SWS_ECUStateManager p. 103. External diagnostic standards such as UDS (ISO 14229) and network management protocols couple directly into the rule evaluation of BswM via defined BSW interfaces (such as Service 0x28 CommunicationControl via Dcm) [SWS_BswM_00048].
Context diagram: Architecture and collaboration of System Services with BSW, RTE, and hardware. Sources: SWS_ECUStateManager p. 34, AUTOSAR_EXP_ModeManagementGuide p. 61.
2. Interplay & Interaction Paths between the Modules
The interaction within the cluster is characterized by clearly demarcated control and reporting relationships. As part of ECU Mode Handling, EcuM receives requests for states such as RUN or POST_RUN from software components (SW-Cs) and forwards the aggregated arbitration result via [SWS_BswM_91004] to BswM ModeManagementGuide p. 34. Since EcuM does not make its own transition decision, BswM evaluates configured logical rules and instructs the target state synchronously via EcuM_SetState [SWS_EcuM_04116]. EcuM then mirrors this state to the application via the RTE and confirms the current execution status to BswM via BswM_EcuM_CurrentState [SWS_BswM_91003].
A parallel interaction path connects BswM, WdgM, and Wdg. Software components and BSW modules report reaching defined checkpoints to WdgM, which determines the local and global monitoring status from them SWS_WatchdogManager p. 51. WdgM provides state changes of local monitoring via provided mode ports [SWS_WdgM_00148]. Depending on the higher-level system state, BswM switches the operating mode of the Watchdog Manager via WdgM_SetMode [SWS_WdgM_00154]. WdgM then configures the Watchdog Driver (Wdg) via the Watchdog Interface (WdgIf) and controls the hardware triggering via Wdg_SetTriggerCondition [SWS_Wdg_00155].
Sequence diagram: Interaction path of ECU Mode Handling between SW-C, EcuM, BswM, and RTE. Sources: SWS_ECUStateManager p. 103, ModeManagementGuide p. 34.
3. Synchronization, Reentrancy, and Task Contexts
The execution of System Services is distributed deterministically across periodic task levels, asynchronous callbacks, and interrupt contexts. The periodic main load of mode management is carried by BswM_MainFunction, which is called in the context of an OS task by the BSW Scheduler (SchM) and processes all rules to be evaluated with a delay [SWS_BswM_00053]. If events requiring immediate rule evaluation occur, they are processed directly synchronously in the context of the calling BSW indication or SW-C API ModemanagementGuide p. 31.
In multicore systems, standardization requires a strict allocation of resources. BswM_Init is designed to be conditionally reentrant to enable separate instantiations per partition or processor core [SWS_BswM_00002]. During sleep and halt phases, EcuM reserves core-internal OS resources (RES_AUTOSAR_ECUM_<core#>) to safeguard synchronization between master and slave cores [SWS_EcuM_03010]. Driver initialization via EcuM_AL_DriverInitZero and EcuM_AL_DriverInitOne is called separately on each core and initializes core-local MCAL modules exclusively [SWS_EcuM_04145]. The clearing of wakeup events via EcuM_ClearWakeupEvent is explicitly non-interruptible and may be performed from both task and interrupt contexts [SWS_EcuM_02807].
4. Typical Lifecycles and Operating Modes
The lifecycle of an ECU is normatively divided into the phases STARTUP, UP, SHUTDOWN, and SLEEP [SWS_EcuM_91005]. The STARTUP phase begins before the operating system start in sequence StartPreOS with the call of EcuM_Init, the evaluation of the reset cause, and the loading of the post-build configuration via EcuM_DeterminePbConfiguration AUTOSAR_SWS_ECUStateManager p. 38. After control is handed over to the operating system via StartOS, EcuM initializes SchM and BswM in StartPostOS [SWS_EcuM_02934]. Subsequently, BswM assumes control and starts up the remaining BSW modules as well as the application.
During ongoing operation (phase UP), EcuM and BswM manage modes RUN and POST_RUN as well as the optional Alarm Clock service SWS_ECUStateManager p. 75. When switching to the sleep state (SLEEP), the cluster structurally distinguishes between HALT (stops the CPU) and POLL (reduced CPU clock) SWS_ECUStateManager p. 54. In advance, call WdgM_DeInit deinitializes the Watchdog Manager and adjusts the trigger timeouts to prevent unwanted resets during shutdown [SWS_WdgM_00261]. In the poll sequence, EcuM blocks in a check loop with periodic calls of EcuM_SleepActivity and EcuM_CheckWakeupHook until a wakeup event is detected [SWS_EcuM_03020].
Detected wakeup events undergo strict state management from ECUM_WKSTATUS_NONE via PENDING to VALIDATED or EXPIRED [SWS_EcuM_04091]. EcuM signals each status change synchronously to BswM by means of BswM_EcuM_CurrentWakeup [SWS_BswM_00131]. Wakeup validation protects against transient bus faults and monitors the time window by means of configurable validation timers [SWS_EcuM_04004]. If the lifecycle ends in SHUTDOWN, OffPreOS deactivates BswM and SchM before OffPostOS resets the ECU or de-energizes it via integration callouts such as EcuM_AL_Reset or EcuM_AL_SwitchOff AUTOSAR_SWS_ECUStateManager p. 49.
State diagram: Wakeup source state machine of the EcuM with notification of the BswM. Sources: AUTOSAR_SWS_ECUStateManager p. 60, [SWS_EcuM_04091].
5. Error Handling, DET Tracing, and Degradation
To detect runtime and configuration errors, the cluster integrates standardized reporting mechanisms to the Default Error Tracer (Det). If an entity attempts to issue a release via EcuM_ReleasePOST_RUN without a prior request, EcuM reports development error ECUM_E_MISMATCHED_RUN_RELEASE to Det [SWS_EcuM_03026]. Multiple requests by the same user are detected with ECUM_E_MULTIPLE_RUN_REQUESTS [SWS_EcuM_03025]. Likewise, WdgM monitors API calls in the uninitialized state and reports WDGM_E_UNINIT if services are called before initialization is complete [SWS_WdgM_00288].
Safety monitoring relies on the three-stage functional supervision of the WdgM (alive supervision, deadline supervision, and logical control flow supervision) SafetyConceptStatusReport p. 47. If a supervision error leads to a violation of fault tolerances, the global supervision status changes from WDGM_GLOBAL_STATUS_OK via FAILED to WDGM_GLOBAL_STATUS_EXPIRED and finally STOPPED [SWS_WdgM_00387]. In this state, the WdgM sets the trigger condition for all watchdog drivers to 0, causing the hardware watchdog to immediately reset the microcontroller [SWS_WdgM_00232]. For controlled emergency resets, the WdgM provides the WdgM_PerformReset service, which stops continuous retrigging and forces a hardware reset [SWS_WdgM_00264]. To ensure safety after extended sleep phases, the EcuM also checks the consistency of the volatile memory using EcuM_CheckRamHash to catch faulty restarts in the event of RAM corruption [SWS_EcuM_02921].
This guide is based on the specifications of AUTOSAR Classic Platform R20-11 and summarizes the architecture and mechanisms of the System Services module cluster.
Module im Cluster
AUTOSAR Run-Time Interface (Arti)
AUTOSAR Classic System Services-Modul AUTOSAR Run-Time Interface (Arti, Spezifikation: AUTOSAR_CP_SWS_ARTI.pdf, AUTOSAR_SWS_ClassicPlatformARTI.pdf).
BSW Mode Manager (BswM)
Arbitrates mode requests and executes action lists to control system state transitions.
ECU State Manager (EcuM)
Controls ECU lifecycle states: Startup, Run, PostRun, Sleep, and Shutdown.
HW Test Manager on Startup and Shutdown (HTMSS)
AUTOSAR Classic System Services-Modul HW Test Manager on Startup and Shutdown (HTMSS, Spezifikation: AUTOSAR_CP_SWS_HWTestManager.pdf, AUTOSAR_SWS_HWTestManager.pdf).
BSW Scheduler Module (SchM)
AUTOSAR Classic System Services-Modul BSW Scheduler Module (SchM, Spezifikation: AUTOSAR_SWS_BSW_Scheduler.pdf).
Software Cluster Connection (SwCluC)
AUTOSAR Classic System Services-Modul Software Cluster Connection (SwCluC, Spezifikation: AUTOSAR_CP_SWS_SoftwareClusterConnection.pdf, AUTOSAR_SWS_SoftwareClusterConnection.pdf).
Watchdog Manager (WdgM)
Performs alive supervision, deadline supervision, and logical program flow monitoring.
gemini-3.8-flash-low· 2026-10-13 · German original