SNIP_CLASSIC_FRIF_SECTION_8_3_14_FrIf_GetGlobalTime

8.3.14 FrIf_GetGlobalTime [SWS_FrIf_05015] Definition of API function FrIf_GetGlobalTime ⌈ Service Name FrIf_GetGlobalTime Syntax Std_ReturnType FrIf_GetGlobalTime ( uint8 FrIf_CtrlIdx, uint8* FrIf_CyclePtr, uint16* FrIf_MacroTickPtr ) Service ID [hex] 0x0e Sync/Async Synchronous Reentrancy non reentrant for identical values of FrIf_CtrlIdx, reentrant for different values of FrIf_CtrlIdx Parameters (in) FrIf_CtrlIdx Index of the FlexRay CC to address. Parameters (inout) None FrIf_CyclePtr Pointer to a memory location where output value will be stored. Parameters (out) FrIf_MacroTickPtr Pointer to a memory location where output value will be stored. Return value Std_ReturnType E_OK: The call of the FlexRay Driver’s API service has returned E_OK. E_NOT_OK: The call of the FlexRay Driver’s API service has returned E_NOT_OK, or an error has been detected in development mode. Description Wraps the FlexRay Driver API function Fr_GetGlobalTime(). Important Note: FrIf_GetGlobalTime may be called within an exclusive area. Available via FrIf.h ⌋ [SWS_FrIf_05194] ⌈If parameter FrIf_CtrlIdx of FrIf_GetGlobalTime has an invalid value and if development error detection is enabled (i.e. FrIfDevErrorDetect equals ON), the function FrIf_GetGlobalTime shall report development error code FRIF_E_ INV_CTRL_IDX to the Det_ReportError service of the DET module.⌋ [SWS_FrIf_05195] ⌈The function FrIf_GetGlobalTime shall wrap the FlexRay Driver API function Fr_GetGlobalTime() by: 1. Translating (based on static FrIf module configuration) the FlexRay CC index Fr If_CtrlIdx into a tuple (FlexRay Driver | Driver-specific CC index Fr_CtrlIdx). 2. Setting parameters 3. Fr_CylcePtr to FrIf_CyclePtr Fr_MacroTickPtr to FrIf_MacroTickPtr 4. Calling Fr_GetGlobalTime() of the determined FlexRay Driver module with the parameters determined as described above. ⌋ [SWS_FrIf_05196] ⌈Caveats of FrIf_GetGlobalTime: The FlexRay Interface module has to be initialized with a call of FrIf_Init() before this API service may be called, see [SWS_FrIf_05003].⌋