Time Service (Tm)

Returns the version information of this module.

Resets a timer instance (user point of view).

Delivers the time difference (current time - reference time).

Shifts the reference time of the timer instance.

Synchronizes two timer instances.

Performs busy waiting by polling with a guaranteed minimum waiting time.

Resets a timer instance (use r point of view).

Service Name Tm_ Get Time Span1us24bit Syntax Std_ Return Type Tm_ Get Time Span1us24bit ( const Tm_ Predef Timer1us24bit Type* Timer Ptr, uint32* Time Span Ptr ) Service ID [hex] 0x8 Sync/ Async Synchronous Reentrancy Reentrant Parameters (in) Timer Ptr Pointer to a timer instance defined by the user. Parameters (inout) None Parameters (out) Time Span Ptr Pointer to time span destination data in RAM Return value Std _ Return - Type E_ OK: The underlying GPT driver service has returned E_ OK and no development error has been detected E_ NOT_ OK: The underlying GPT driver service has returned E_ NOT_ OK, or a development error has been detected Descripti on Delivers the time difference (current time - reference time). Available via Tm.h

Shifts the reference time of the timer instance.

Synchronizes two timer instances.

Performs busy waiting by polling with a guaranteed minimum waiting time.

Resets a timer instance (user point of view).

Delivers the time difference (current time - reference time).

Shifts the reference time of the timer instance.

Synchronizes two timer instances.

Performs busy waiting by polling with a guaranteed minimum waiting time.

Resets a timer instance (use r point of view).

Service Name Tm_ Get Time Span100us32bit Syntax Std_ Return Type Tm_ Get Time Span100us32bit ( const Tm_ Predef Timer100us32bit Type* Timer Ptr, uint32* Time Span Ptr ) Service ID [hex] 0x12 Sync/ Async Synchronous Reentrancy Reentrant Parameters (in) Timer Ptr Pointer to a timer instance defined by the user. Parameters (inout) None Parameters (out) Time Span Ptr Pointer to time span destination data in RAM Return value Std _ Return - Type E_ OK: The underlying GPT driver service has returned E_ OK and no development error has been detected E_ NOT_ OK: The underlying GPT driver service has returned E_ NOT_ OK, or a development error has been detected Descripti on Delivers the time difference (current time - reference time). Available via Tm.h

Shifts the reference time of the timer instance.

Synchronizes two timer instances.

Reset a timer instance by setting the reference time to the current value of the related PreDef Timer.

Delivers the (relative) value of the time since the last reset (or shifting) of the timer instance.

Performs busy waiting by polling with a guaranteed minimum waiting time.

Data type of Time Service Predef Timer 1us16bit. The structure contains the reference time.

Data type of Time Service Predef Timer 1us24bit. The structure contains the reference time.

Data type of Time Service Predef Timer 1us32bit. The structure contains the reference time.

Data type of Time Service Predef Timer 100µs32bit. The structure contains the reference time.

The Time Service module shall use the G PT driver service Gpt_GetPredefTimerValue to get the current time value for the desired Predef Timer.

The “ 1us16bit ” functions shall use the Timer GPT_PREDEF_TIMER_1US_16BIT as time base if a time base is needed .

The “ 1us24bit ” functions shall use the Timer GPT_PREDEF_TIMER_1US_24BIT as time base if a time base is needed .

The “ 1us32bit ” functio ns shall use the Timer GPT_PREDEF_TIMER_1US_32BIT as time base if a time base is needed .

The “ 100us32bit ” functions shall use the Timer GPT_PREDEF_TIMER_100US_32BIT as time base if a time base is needed .

The ResetTimer functions shall reset the timer instance passed by the parameter TimerPtr . This means, the reference time of the timer instance shall be set to the current time of the related GPT Predef Timer.

The ResetTim er functions shall be reentrant, if the timer instances used in concurrent calls are different.

[SWS_Tm_00008] Upstream requirements: SRS_BSW_00369, SRS_BSW_00323 ⌈If development error detection for the Time Service module is enabled: If the param- eter timerId is not a valid timer instance, the Tm_ResetTimer functions shall raise the development error TM_E_PARAM_VALUE.⌋

The GetTimeSpan functions shall calc ulate and deliver the time difference between the current time and the reference time of the timer instance.

The GetTimeSpan functions shall perform proper wrap - around handling at subtraction (current time - reference time), if value of current time is less than value of reference time .

The GetTimeSpan functions shall be fully reentrant, this means even for the same timer instance.

[SWS_Tm_00012] Upstream requirements: SRS_BSW_00369, SRS_BSW_00323 ⌈If development error detection for the Time Service module is enabled: If the pointer parameter (timeSpan) is a null pointer, the Tm_GetTimeSpan functions shall raise the development error TM_E_PARAM_POINTER.⌋

The ShiftTimer functions shall shift the reference time of the timer instance. This means, the value TimeValue shall be added to the reference time of the timer instance.

The ShiftTimer functions shall perform proper wrap - around handling at adding (reference time + TimeValue), if the sum is greater than the maximum value of the timer.

The ShiftTimer functions with range 24bit shall limit the value of the parameter TimeValue to 0xFFFFFF.

If development error detection for the Time Service module is enabled: I f the value of the parameter TimeValue is greater than 0x FFFFFF , the ShiftTimer functions with range 24bit shall raise the error TM_E_PARAM_VALUE.

The ShiftTimer functions shall be reentrant, if the timer instances used in concurrent calls are different.

[SWS_Tm_00018]

The SyncTimer functions shall synchronize two timer instances. This means, the reference time of the destination timer instance shall be set to the reference time of the source timer instance.

The SyncTimer functions shall be reentrant, if the destination timer instances used in concurrent calls are different.

[SWS_Tm_00021] [SWS_Tm_00022] [SWS_Tm_00023]

The BusyWait functions shall perform busy waiting for the minimum time passed by the parameter WaitingTimeMin .

The BusyWait functions shall not disable the interrupts. T his means the real waiting time may be greater than t he desired waiting time .

The BusyWait functions shall guarantee the minimum waiting . This means, n+1 ticks must be observed to ensure that an interval of at least n ticks has passed.

The B usyWait functions shall be reentrant.

For each Predef Timer enabled by configuration the following set of API services shall be available: ResetTimer, GetTimeSpan, ShiftTimer, SyncTimer.

For each Predef Timer with tick duration 1µs enabled by configuration t he API service BusyWait shall be available.

Type of error Related error code Error value API parameter checking: invalid pointer TM_ E_ PARAM_ POINTER 0x01 API parameter checking: invalid value TM_ E_ PARAM_ VALUE 0x02

Additional errors that are detected because of specific implementation shall be added in the specific implementation specification. The classification and enumeration shall be compa tible to the errors listed .

Module Header File Imported Type Gpt Gpt.h Gpt _ Predef Timer Type Std Std_ Types.h Std _ Return Type Std_ Types.h Std _ Version Info Type

Det _ Report - Runtime Error Det.h Service to report runtime errors. If a callout has been configured then this callout shall be called. Gpt _ Get Predef - Timer Value Gpt.h Delivers the current value of the desired GPT Predef Timer.

These requirements are not applicable to this specific ation.

Det _ Report Error Det.h Service to report development errors.

When an error occurs the corresponding Time Service function shall return without any action , unless it is specified for the specific function differently / more in detail.

If the underlying GPT driver service returns E_NOT_OK , the functions ResetTimer , GetTimeSpan and BusyWait shall raise the error TM_E_HARDWARE_TIMER .

When an error is detected and the parameter TimeSpanPtr is not a null pointer, the GetTimeSpan functions shall deliver th e time span “ 0 ”.

When an error is detected , the BusyWait functions shall return E_NOT_OK and shall abort “waiting” immediately .

Type of error Related error code Error value Access to underlying hardware timer failed TM_ E_ HARDWARE_ TIMER 0x03

[SWS_Tm_00068] [SWS_Tm_00069] [SWS_Tm_00070] [SWS_Tm_00071] [SWS_ Tm_00077]

[SWS_Tm_00069] [SWS_Tm_00070] [SWS_Tm_00071] [SWS_ Tm_00077]

[SWS_Tm_00070] [SWS_Tm_00071] [SWS_ Tm_00077]

[SWS_Tm_00071] [SWS_ Tm_00077]

[SWS_Tm_00082] Unknown timer Upstream requirements: SRS_BSW_00386, SRS_BSW_00323 ⌈If development error detection for the Time Service module is enabled: If the parame- ter timerId is not a valid timer instance, the Tm_GetTimeSpan functions shall raise the development error TM_E_PARAM_VALUE.⌋

[SWS_Tm_91000]

[SWS_Tm_91001]

[SWS_Tm_91004] [SWS_Tm_91005] [SWS_Tm_91006]

[SWS_Tm_91005] [SWS_Tm_91006]

[SWS_Tm_91007] [SWS_Tm_91008] B.2.2 Changed Specification Items in R24-11 [ECUC_Tm_00001] [ECUC_Tm_00008]

[SWS_Tm_91008] B.2.2 Changed Specification Items in R24-11 [ECUC_Tm_00001] [ECUC_Tm_00008]

[SWS_Tm_CONSTR_00001] [SWS_Tm_CONSTR_00002] B.2.5 Changed Constraints in R24-11 none B.2.6 Deleted Constraints in R24-11 none B.3 Differences between R22-11 and R23-11 B.3.1 Added Specification Items in R23-11 none

[SWS_Tm_CONSTR_00002] B.2.5 Changed Constraints in R24-11 none B.2.6 Deleted Constraints in R24-11 none B.3 Differences between R22-11 and R23-11 B.3.1 Added Specification Items in R23-11 none

[SWS_Tm_NA_00059] Upstream requirements: SRS_BSW_00159, SRS_BSW_00167, SRS_BSW_00170, SRS_BSW_ 00398, SRS_BSW_00416, SRS_BSW_00437, SRS_BSW_00168, SRS_BSW_00423, SRS_BSW_00424, SRS_BSW_00425, SRS_BSW_ 00426, SRS_BSW_00427, SRS_BSW_00428, SRS_BSW_00429, SRS_BSW_00432, SRS_BSW_00433, SRS_BSW_00422, SRS_BSW_ 00417, SRS_BSW_00161, SRS_BSW_00162, SRS_BSW_00005, SRS_BSW_00415, SRS_BSW_00325, SRS_BSW_00342, SRS_BSW_ 00160, SRS_BSW_00007, SRS_BSW_00413, SRS_BSW_00347, SRS_BSW_00307, SRS_BSW_00373, SRS_BSW_00335, SRS_BSW_ 00353, SRS_BSW_00328, SRS_BSW_00006, SRS_BSW_00439, SRS_BSW_00357, SRS_BSW_00377, SRS_BSW_00378, SRS_BSW_ 00306, SRS_BSW_00308, SRS_BSW_00309, SRS_BSW_00359, SRS_BSW_00360, SRS_BSW_00440, SRS_BSW_00330, SRS_BSW_ 00331, SRS_BSW_00009, SRS_BSW_00172, SRS_BSW_00010, SRS_BSW_00333, SRS_BSW_00321, SRS_BSW_00341 ⌈These requirements are not applicable to this specification.⌋ B History of Constraints and Specification Items B.1 Differences between R24-11 and R25-11 B.1.1 Added Specification Items in R25-11 none B.1.2 Changed Specification Items in R25-11 none B.1.3 Deleted Specification Items in R25-11 none B.1.4 Added Constraints in R25-11 none B.1.5 Changed Constraints in R25-11 none B.1.6 Deleted Constraints in R25-11 none B.2 Differences between R23-11 and R24-11 B.2.1 Added Specification Items in R24-11 [ECUC_Tm_00009] [ECUC_Tm_00010] [ECUC_Tm_00011] [ECUC_Tm_00012]