SNIP_CLASSIC_FR_SECTION_8_4_2_Fr_ControllerInit

8.4.2 Fr_ControllerInit [SWS_Fr_00017] Definition of API function Fr_ControllerInit Upstream requirements: SRS_Fr_05116, SRS_Fr_05011 ⌈ Service Name Fr_ControllerInit Syntax Std_ReturnType Fr_ControllerInit ( uint8 Fr_CtrlIdx ) Service ID [hex] 0x00 Sync/Async Synchronous Reentrancy Non Reentrant for the same device Parameters (in) Fr_CtrlIdx Index of FlexRay CC within the context of the FlexRay Driver. Parameters (inout) None Parameters (out) None Return value Std_ReturnType E_OK: API call finished successfully. E_NOT_OK: API call aborted due to errors. Description Initialzes a FlexRay CC. Available via Fr.h ⌋ [SWS_Fr_00148] Upstream requirements: SRS_Fr_05059, SRS_Fr_05012 ⌈The function Fr_ControllerInit() shall perform the following tasks on FlexRay CC Fr_CtrIdx: 1. Switch CC into ’POC:config’ (from any other POCState). 2. Configure all FlexRay cluster and node configuration parameters (e.g., cycle length, macrotick duration). 3. Configure all transmit/receive resources (e.g., buffer initialization) according to the frame triggering configuration parameters contained in the FrIf. 4. Switch CC into ’POC:ready’ 5. Return E_OK. ⌋ CC post condition for the function Fr_ControllerInit(): CC Fr_CtrlIdx shall be left in POCState ’POC:ready’. [SWS_Fr_00149] ⌈The function Fr_ControllerInit() shall ensure that no transmission requests are pending.⌋ [SWS_Fr_00150] ⌈The function Fr_ControllerInit() shall ensure that no reception indications are pending.⌋ [SWS_Fr_00151] ⌈The function Fr_ControllerInit() shall ensure that no interrupts are pending.⌋ [SWS_Fr_00152] Upstream requirements: SRS_Fr_05169 ⌈The function Fr_ControllerInit() shall ensure that all timers are disabled.⌋ [SWS_Fr_00153] ⌈The function Fr_ControllerInit() shall ensure that all interrupts are disabled.⌋ [SWS_Fr_00515] ⌈The function Fr_ControllerInit() shall disable all LPdus which are dynamically reconfigurable (see Fr_ReconfigLPdu(), Fr_DisableLPdu()).⌋ [SWS_Fr_00147] ⌈If the function Fr_ControllerInit() detects errors while testing the CC (CC test), then it shall repeat the test procedure a configurable number ( FrCtrlTestCount) of times. If all tests fail, then it calls Dem_SetEventStatus() ( FR_E_CTRL_TESTRESULT, DEM_EVENT_STATUS_FAILED) and returns E_NOT_OK.⌋ [SWS_Fr_00647] ⌈The CC test as described in [SWS_Fr_00147] shall verify (read back and compare to reference values held in the configuration) that the node and cluster FlexRay parameters were written properly into the FlexRay CC.⌋ [SWS_Fr_00598] ⌈If the function Fr_ControllerInit() passes the CC test within a number of configurable (FrCtrlTestCount) times, then it calls Dem_SetEventStatus() (FR_E_CTRL_TESTRESULT, DEM_EVENT_STATUS_PASSED).⌋ [SWS_Fr_00143] ⌈If development error detection for the Fr module is enabled, and if the function Fr_ControllerInit() is called before the successful initialization of Fr, then the function Fr_ControllerInit() shall raise the development error FR_E_INIT_FAILED.⌋ [SWS_Fr_00144] ⌈If development error detection for the Fr module is enabled, then the function Fr_ControllerInit() shall check the validity of the parameter Fr_CtrlIdx. If Fr_CtrlIdx is invalid, then the function Fr_ControllerInit() shall raise the development error FR_E_INV_CTRL_IDX.⌋