SNIP_CLASSIC_LINSM_SECTION_8_3_5_LinSM_RequestComMode

8.3.5 LinSM_RequestComMode [SWS_LinSM_00126] Definition of API function LinSM_RequestComMode Upstream requirements: SRS_BSW_00369 ⌈ Service Name LinSM_RequestComMode Syntax Std_ReturnType LinSM_RequestComMode ( NetworkHandleType network, ComM_ModeType mode ) Service ID [hex] 0x40 Sync/Async Asynchronous Reentrancy Reentrant for different networks. Non reentrant for the same network. network Handle of the communication network Parameters (in) mode Requested communication mode Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: Request accepted E_NOT_OK: Request not accepted Description Request of a new communication mode. Available via LinSM.h ⌋ [SWS_LinSM_00127] ⌈If LinSMDevErrorDetect is enabled: If the network parameter has an invalid value, then the error-code LINSM_E_NONEXISTENT_NETWORK shall be reported to the DET module and E_NOT_OK shall be returned.⌋ [SWS_LinSM_00191] ⌈If LinSMDevErrorDetect is enabled: If the mode parameter has an invalid value, then the error-code LINSM_E_PARAMETER shall be reported to the DET module and E_NOT_OK shall be returned.⌋ [SWS_LinSM_00128] Upstream requirements: SRS_BSW_00406 ⌈If LinSMDevErrorDetect is enabled: If the state LINSM_UNINIT is active, then the error-code LINSM_E_UNINIT shall be reported to the DET module and E_NOT_OK shall be returned.⌋ [SWS_LinSM_00183] ⌈If COMM_SILENT_COMMUNICATION is requested the function shall return E_NOT_OK directly without action⌋ [SWS_LinSM_00223] ⌈LinSM_RequestComMode shall store the requested mode, if the return value is E_OK. The next activation of the LinSM_MainFunction will then process this request when processing the state machine. Note, that the state machine definition in section refers to this stored request as req ComMode.⌋