SNIP_CLASSIC_COMM_SECTION_8_6_2_Optional_Interfaces_BSWMODEMANAGER

8.6.2 Optional Interfaces According to [SWS_BswM_00039], the BswM can call any function in the AUTOSAR BSW. The following table contains a list of specific functions which may be useful in implementing BswM functionality. [SWS_BswM_00008] Definition of optional interfaces requested by module Bsw M Upstream requirements: SRS_BSW_00384 ⌈ API Function Header File Description Com_DisableReceptionDM Com.h Disables the reception deadline monitoring for the I-PDUs within the given I-PDU group. Com_EnableReceptionDM Com.h Enables the reception deadline monitoring for the I-PDUs within the given I-PDU group. Com_IpduGroupStart Com.h Starts a preconfigured I-PDU group. For example, cyclic I-PDUs will be sent out cyclically after the call of Com_IpduGroupStart(). If Initialize is true all I-PDUs of the I-PDU group shall be (re-)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 objects and shadow buffers of signal groups have to be (re-)initialized. Com_IpduGroupStop Com.h Stops a preconfigured I-PDU group. For example, cyclic I-PDUs will be stopped after the call of Com_ IpduGroupStop(). Com_SwitchIpduTxMode Com.h The service Com_SwitchIpduTxMode sets the transmission mode of the I-PDU referenced 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. ComM_GetCurrentComMode ComM.h Function to query the current Communication Mode. ComM 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: <Bus>SM _GetCurrentCom Mode(...)) ComM_GetInhibitionStatus ComM.h Returns the inhibition status of a ComM channel. ComM_GetMaxComMode ComM.h Function to query the maximum allowed Communication Mode of the corresponding user. ComM_GetRequestedComMode ComM.h Function to query the currently requested Communication Mode of the corresponding user. ComM_GetStatus ComM.h Returns the initialization status of the AUTOSAR Communication Manager. After a call to ComM_De Init() ComM should have status COMM_UNINIT, and a new call to ComM_Init needed to make sure Com M restart internal state machines to defailt values. ComM_GetVersionInfo ComM.h This function returns the version information of this module ▽ △ API Function Header File Description ComM_LimitChannelToNoComMode ComM.h Changes the inhibition status for the channel for changing from COMM_NO_COMMUNICATION to a higher Communication Mode. (See also ComM_ LimitECUToNoComMode, same functionality but for all channels) ComM_LimitECUToNoComMode ComM.h Changes the inhibition status for the ECU (=all channels) for changing from COMM_NO_ COMMUNICATION to a higher Communication Mode. (See also ComM_LimitChannelToNoCom Mode, same functionality but for a specific channels) ComM_PreventWakeUp ComM.h Changes the inhibition status COMM_NO_WAKEUP for the corresponding channel. ComM_ReadInhibitCounter ComM.h This function returns the amount of rejected COMM_FULL_COMMUNICATION user requests. ComM_RequestComMode ComM.h Requesting of a Communication Mode by a user. Note: The following modes are no vaild user requests, since they are used as internal modes: • COMM_SILENT_COMMUNICATION (this mode is used for synchronization at shutdown) • COMM_FULL_COMMUNICATION_WITH_ WAKEUP_REQUEST (this mode is used internally within the ComM 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 a ComM communication inhibition ComM_ResetInhibitCounter ComM.h This function resets the Inhibited COMM_FULL_ COMMUNICATION request Counter. ComM_SetECUGroupClassification ComM.h Changes the ECU Group Classification status (see chapter 10.2.2) ControlIdle Os.h This API allows the caller to select the idle mode action which is performed during idle time of the OS (e.g. if no Task/ISR is active). It can be used to implement energy savings. The real idle modes are hardware dependent and not standardized. The default idle mode on each core is IDLE_NO_HALT. Det_ReportError Det.h Service to report development errors. EcuM_AL_DriverInitBswM_<x> EcuM.h This callback shall provide BSW module initializations to be called by the BSW Mode Manager. EcuM_GoDownHaltPoll EcuM.h Instructs the ECU State Manager module to go into a sleep mode, Reset or OFF depending on the previously selected shutdown target. EcuM_SetState EcuM.h Function called by BswM to notify about State Switch. EthIf_StartAllPorts EthIf.h Request to set all configured and affected EthSwt Ports to ETH_MODE_ACTIVE ▽ △ API Function Header File Description EthIf_SwitchPortGroupRequestMode EthIf.h Request a mode for the EthIfSwtPortGroup. The call shall be forwarded to EthSwt by calling EthSwt_Set SwitchPortMode for all EthSwtPorts referenced by the port group. FrSM_AllSlots FrSM.h This API function can be used to leave the KeySlot OnlyMode. FrSM_SetEcuPassive FrSM.h This API function can be used to set all FlexRay clusters of the ECU to a receive only mode. Fw_SetFirewallState (draft) Fw.h This function is invoked by the BswM to indicate ECU state changes. Tags: atp.Status=draft IdsM_BswM_StateChanged IdsM_BswM.h This callback function is invoked by the BswM to indicate ECU state changes. J1939Dcm_SetState J1939Dcm.h Changes the communication state of J1939Dcm to offline or online. J1939Rm_SetState J1939Rm.h Changes the communication state of J1939Rm to offline (only Request for AC supported) or online. LinSM_ScheduleRequest LinSM.h The upper layer requests a schedule table to be changed on one LIN network. Nm_DisableCommunication Nm.h 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). Nm_EnableCommunication Nm.h 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). Sd_ServiceGroupStart Sd.h Starts a preconfigured SdServiceGroup. For example, OfferService entries will be sent out after the call of Sd_ServiceGroupStart() for all Server Servives of a SdServiceGroup, which are not requested yet. Sd_ServiceGroupStop Sd.h Stops a preconfigured SdServiceGroup. For example, StopOfferService entries will be sent out after the call of Sd_ServiceGroupStop() for all ServerServices of a SdServiceGroup, which are not requested by another SdServiceGroup. ⌋