SNIP_CLASSIC_FR_SECTION_8_4_25_Fr_SetAbsoluteTimer

8.4.25 Fr_SetAbsoluteTimer [SWS_Fr_00033] Definition of API function Fr_SetAbsoluteTimer Upstream requirements: SRS_Fr_05044 ⌈ Service Name Fr_SetAbsoluteTimer Syntax Std_ReturnType Fr_SetAbsoluteTimer ( uint8 Fr_CtrlIdx, uint8 Fr_AbsTimerIdx, uint8 Fr_Cycle, uint16 Fr_Offset ) Service ID [hex] 0x11 Sync/Async Synchronous Reentrancy Non Reentrant for the same device Fr_CtrlIdx Index of FlexRay CC within the context of the FlexRay Driver. Fr_AbsTimerIdx Index of absolute timer within the context of the FlexRay CC. Fr_Cycle Absolute cycle the timer shall elapse in. Parameters (in) Fr_Offset Offset within cycle Fr_Cycle in units of macrotick the timer shall elapse at. 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 Sets the absolute FlexRay timer. Available via Fr.h ⌋ Note: The Fr module’s environment shall only call Fr_SetAbsoluteTimer() when the CC Fr_CtrlIdx is synchronous to FlexRay global time (at the moment of timer activation). [SWS_Fr_00273] ⌈The function Fr_SetAbsoluteTimer() shall perform the following tasks: 1. Program the absolute FlexRay timer Fr_AbsTimerIdx according to the parameters Fr_Cycle and Fr_Offset. 2. Return E_OK. ⌋ [SWS_Fr_00272] ⌈If the function Fr_SetAbsoluteTimer() is able to and detects a hardware error while performing the requested functionality, then it shall call Dem_SetEventStatus() (FR_E_CTRL_TESTRESULT, DEM_EVENT_STATUS_FAILED) and return E_NOT_OK.⌋ [SWS_Fr_00267] ⌈If development error detection for the Fr module is enabled, and if the function Fr_SetAbsoluteTimer() is called before the successful initialization of Fr, then the function Fr_SetAbsoluteTimer() shall raise the development error FR_E_INIT_FAILED.⌋ [SWS_Fr_00268] ⌈If development error detection for the Fr module is enabled, then the function Fr_SetAbsoluteTimer() shall check the validity of the parameter Fr_CtrlIdx. If Fr_CtrlIdx is invalid, then the function Fr_SetAbsoluteTimer() shall raise the development error FR_E_INV_CTRL_IDX.⌋ [SWS_Fr_00269] ⌈If development error detection for the Fr module is enabled, then the function Fr_SetAbsoluteTimer() shall check the validity of the parameter Fr_AbsTimerIdx. If Fr_AbsTimerIdx is invalid, then the function Fr_SetAbsoluteTimer() shall raise the development error FR_E_INV_TIMER_IDX.⌋ [SWS_Fr_00270] ⌈If development error detection for the Fr module is enabled, then the function Fr_SetAbsoluteTimer() shall check the validity of the parameter Fr_Cycle. If Fr_Cycle is invalid, then the function Fr_SetAbsoluteTimer() shall raise the development error FR_E_INV_CYCLE.⌋ [SWS_Fr_00271] ⌈If development error detection for the Fr module is enabled, then the function Fr_SetAbsoluteTimer() shall check the validity of the parameter Fr_Offset. If Fr_Offset is invalid, then the function Fr_SetAbsoluteTimer() shall raise the development error FR_E_INV_OFFSET.⌋ [SWS_Fr_00436] ⌈The function Fr_SetAbsoluteTimer() shall check whether the CC Fr_CtrlIdx is synchronous to the FlexRay global time. If the CC Fr_CtrlIdx is not synchronous to the FlexRay global time, then the function Fr_SetAbsoluteTimer() shall raise the runtime error FR_E_INV_POCSTATE.⌋