SNIP_CLASSIC_LINIF_SECTION_8_2_7_LinIf_SetTrcvMode

8.2.7 LinIf_SetTrcvMode [SWS_LinIf_00544] Definition of API function LinIf_SetTrcvMode Upstream requirements: SRS_Lin_01584, SRS_Lin_01585, SRS_Lin_01586 ⌈ Service Name LinIf_SetTrcvMode Syntax Std_ReturnType LinIf_SetTrcvMode ( NetworkHandleType Channel, LinTrcv_TrcvModeType TransceiverMode ) Service ID [hex] 0x08 Sync/Async Synchronous Reentrancy Reentrant Channel Identification of the LIN channel Parameters (in) TransceiverMode Requested mode transition Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: Will be returned, if the transceiver state has been changed to the requested mode. E_NOT_OK: Will be returned, if the transceiver state change has failed or the parameter is out of the allowed range. The previous state has not been changed. Description Set the given LIN transceiver to the given mode. Available via LinIf.h ⌋ [SWS_LinIf_00536] ⌈This service shall call the underlying function LinTrcv_SetOpMode(LinNetwork, OpMode) for the corresponding requested LIN transceiver.⌋ [SWS_LinIf_00537] ⌈This API shall be applicable to all LIN transceivers with all values independent if the transceiver hardware supports these modes or not.⌋ [SWS_LinIf_00538] ⌈The API LinIf_SetTrcvMode returns the value that is returned by LinTrcv_SetOpMode.⌋ [SWS_LinIf_00539] ⌈If development error detection is enabled and an invalid value for Channel is given, the function LinIf_SetTrcvMode shall report LINIF_E_NONEXISTENT_CHANNEL to the default error tracer.⌋ [SWS_LinIf_00540] ⌈If development error detection is enabled and an invalid mode is requested for TransceiverMode, the function LinIf_SetTrcvMode shall report LINIF_E_TRCV_INV_MODE to the default error tracer.⌋ [SWS_LinIf_00634] ⌈The function LinIf_SetTrcvMode is required only if at least one LIN channel uses the LIN transceiver driver. This function shall be pre-compile time configurable On/Off by the configuration parameter LinIfTrcvDriverSupported.⌋ Caveats: The LIN Interface has to be initialized with a call of LinIf_Init before this API service may be called, see [SRS_BSW_00487].