SNIP_CLASSIC_FRSM_SECTION_8_3_2_FrSM_RequestComMode

8.3.2 FrSM_RequestComMode [SWS_FrSM_00020] Definition of API function FrSM_RequestComMode Upstream requirements: SRS_BSW_00310, SRS_BSW_00460, SRS_BSW_00461, SRS_BSW_ 00484 ⌈ Service Name FrSM_RequestComMode Syntax Std_ReturnType FrSM_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 FrSM.h ⌋ [SWS_FrSM_00021] ⌈The FrSM_RequestComMode function shall store the requested communication mode.⌋ The next activation of the FrSM_MainFunction will then process this request when processing the state machine of the corresponding cluster. Note, that the state machine definition in Chapter 7.2 refers to this stored request as reqComMode. [SWS_FrSM_00022] ⌈If NoCom is requested after FullCom has been reached (i.e. when the FrSM state machine of the corresponding cluster is in state FRSM_ONLINE, FRSM_KEYSLOT_ONLY, FRSM_LOW_NUMBER_OF_COLDSTARTERS or FRSM_ONLINE_PASSIVE), the FrSM_RequestComMode function shall immediately process the corresponding transition of the state machine (see [SWS_FrSM_00093]).⌋ Rationale of [SWS_FrSM_00022]: This shall ensure that the NoCom request will stop the participation of the ECU in the FlexRay communication at the end of the current FlexRay cycle. [SWS_FrSM_00141] Upstream requirements: SRS_BSW_00350 ⌈If the parameter mode has the value COMM_SILENT_COMMUNICATION, the FrSM shall not store the requested communication mode and return E_NOT_OK. In case development error detection is enabled, the FrSM shall additionally raise the development error code FRSM_E_INV_MODE.⌋ [SWS_FrSM_00018] Upstream requirements: SRS_BSW_00369, SRS_BSW_00323, SRS_BSW_00350 ⌈If development error detection is enabled and the parameter network has an invalid value, the FrSM_RequestComMode function shall raise the development error code FRSM_E_INV_HANDLE and the FrSM_RequestComMode function shall return E_NOT_OK.⌋ [SWS_FrSM_00019] Upstream requirements: SRS_BSW_00350 ⌈If development error detection is enabled and the parameter mode has an invalid value, the FrSM_RequestComMode function shall raise the development error code FRSM_E_INV_MODE and the FrSM_RequestComMode function shall return E_NOT_ OK.⌋ [SWS_FrSM_00061] Upstream requirements: SRS_BSW_00406, SRS_BSW_00350 ⌈If development error detection is enabled and the FrSM module has not been initialized using FrSM_Init, the FrSM_RequestComMode function shall raise the development error code FRSM_E_UNINIT and the function FrSM_RequestComMode shall return E_NOT_OK.⌋