AUTOSAR Classic Zeitsynchronisation

Returns the version information of this module.

By this API service the CanTSyn gets an indication and the result of ICV generation.

By this API service the CanTSyn gets an indication and the result of ICV verification.

This function initializes the Time Synchronization over CAN.

Main function for cyclic call / resp. Timesync message transmission

Indication of a received PDU from a lower layer communication interface module.

This API is used to turn on and off the TX capabilities of the CanTSyn.

The lower layer communication interface module confirms the transmission of a PDU, or the failure to transmit a PDU.

This is the base type for the configuration of the Time Synchronization over CAN. A pointer to an instance of this structure will be used in the initialization of the Time Synchronization over CAN. The content of this structure is defined in chapter 10 Configuration specification.

Handles the enabling and disabling of the transmission mode

This API is used to read FollowUp information TLV parameters from received Follow_Up message.

This API is used to read Follow Up information TLV parameters from received Follow_ Up message.

Returns the version information of this module.

This function initializes the Time Synchronization over Ethernet.

Main function for cyclic call / resp. Sync, Follow_Up and Pdelay_Req transmissions

By this API service the EthTSyn gets an indication and the data of a received frame.

This API is used to set FollowUp information TLV parameters of a Follow_Up message prior transmission. The API is called within StbM_SetBusProtocolParam which provides the content of the structure protocolParam.

This API is used to set Follow Up information TLV parameters of a Follow_ Up message prior transmission. The API is called within Stb M_ Set Bus Protocol Param which provides the content of the structure p rotocol Param.

This API is used to turn on and off the TX capabilities of the EthTSyn.

Allows resetting state machine in case of unexpected Link loss to avoid inconsistent Sync and Follow_Up sequences

Confirms the transmission of an Ethernet frame

This is the base type for the configuration of the Global Time Synchronization over Ethernet. A pointer to an instance of this structure will be used in the initialization of the Global Time Synchronization over Ethernet. The content of this structure is defined in chapter 10 Configuration specification.

Handles the enabling and disabling of the transmission mode

Returns the version information of this module.

By this API service the FrTSyn gets an indication and the result of ICV generation.

By this API service the FrTSyn gets an indication and the result of ICV verification.

This function initializes the Time Synchronization over FlexRay.

Main function for cyclic call / resp. Timesync message transmission

Indication of a received PDU from a lower layer communication interface module.

This API is used to turn on and off the TX capabilities of the FrTSyn.

Within this API, the upper layer module (called module) shall check whether the available data fits into the buffer size reported by PduInfoPtr->SduLength. If it fits, it shall copy its data into the buffer provided by PduInfoPtr->SduDataPtr and update the length of the actual copied data in PduInfoPtr->SduLength. If not, it returns E_NOT_OK without changing PduInfoPtr.

This is the base type for the configuration of the Time Synchronization over FlexRay. A pointer to an instance of this structure will be used in the initialization of the Time Synchronization over FlexRay. The content of this structure is defined in chapter 10 Configuration specification.

Handles the enabling and disabling of the transmission mode

The callback notifies the customers, when a <Time Base> related event occurs, which is enabled by the notification mask

Provides a recorded snapshot data block of the measurement data table belonging to the Synchronized Time Base.

Provides a recorded snapshot data block of the measurement data table belonging to the Offset Time Base.

This callback notifies the <Customer>, when a Time Base reaches the time value set by Stb M_ Start Timer for the <Time Base>

This interface is used by the StbM to query the current freshness value.

This API returns the freshness value from the Most Significant Bits in the first byte, of the Freshness array, in big endian format Tags: atp.Status=draft

This interface is used by the StbM to obtain the current freshness value. The interface function provides also the truncated freshness transmitted in the secured time sync message. Tags: atp.Status=draft

This interface is used by the StbM to indicate that the Secured Time Synchronization Message has been initiated for transmission. Tags: atp.Status=draft

Returns the current Time Tuple, status and User Data of the Time Base.

Allows the Time Base Provider Modules to forward a new Global Time tuple (i.e., Rx Time Tuple) to the Stb M.

Provides CAN Timesyn module specific data for a Time Master to the Stb M. Tags: atp.Status=draft

Allows the Can TSyn Module to forward CAN specific details to the Stb M. Tags: atp.Status=draft

Copies Time Base data (current time, user data, rate corrction) from Source Time Base to Destination Time Base. The Source Time Base is identified by the parameter Stb MSource Time Base (ECUC_ Stb M_00074). Stb?M_?Clone Time Base behaves synchronuously (immediate copy of Time Base) if DEFERRED_ COPY flag of parameter clone Cfg is set to true, otherwise it behaves asynchronuously (deferred copy of Time Base). Note: Even, if conf igured to behave synchronuously (immediate copy of Time Base), actual transmission of cloned Time Base value on the bus occurs asynchronuously.

Provides Ethernet Timesyn module specific data for a Time Master to the Stb M. Tags: atp.Status=draft

- Tags: atp.Status=draft

- Tags: atp.Status=draft

Allows the Eth TSyn Module to forward Ethernet specific details to the Stb M. Tags: atp.Status=draft

Provides Flexray Timesyn module specific data for a Time Master to the Stb M. Tags: atp.Status=draft

Allows the Fr TSyn Module to forward Flexray specific details to the Stb M. Tags: atp.Status=draft

This API is used to get bus specific parameters from received Follow_ Up message

Returns a time triple (Local Time, Fallback Local Time, Global time and timebase status) and user data details. Note: This API shall be called with locked interrupts / within an Exclusive Area to prevent interruption (i.e., the risk that the time stamp is outdated on return of the function call). Tags: atp.Status=draft ▽ △

Returns a time value (Local Time Base derived from Global Time Base) in standard format. Note: This API shall be called with locked interrupts / within an Exclusive Area to prevent interruption (i.e., the risk that the time stamp is outdated on return of the function call).

Returns a time value (Local Time Base derived from Global Time Base) in extended format. Note: This API shall be called with locked interrupts / within an Exclusive Area to prevent interruption (i.e., the risk that the time stamp is outdated on return of the function call).

Returns the Virtual Local Time of the referenced Time Base.

Returns the Fallback Virtual Local Time of the referenced Time Base. Tags: atp.Status=draft

Indicates if the functionality for a system wide master (e.g. Stb M_ Set Global Time) for a given Time Base is ava ilable or not.

Allows the Timesync Modules to get the current Offset Time and User Data.

Accesses to the recorded snapshot data Header of the table belonging to the Offset Time Base.

Returns value of the current rate deviation of a Time Base

This interface is used by the StbM to query the current freshness value. Tags: atp.Status=draft

Accesses to the recorded snapshot data Header of the table belonging to the Synchronized Time Base. Available v ia Stb M.h

Returns detailed status information for a Synchronized (or Pure Local) Time Base and, if called for an Offset Time Base, for the Offset Time Base and the underlying Synchronized Time Base.

Allows the Timesync Modules to detect, whether a Time Base should be transmitted immediately in the subsequent <Bus>TSyn_ Main Function() cycle.

Returns value of Time Leap.

This API returns the freshness value from the Most Significant Bits in the first byte, of the Freshness array, in big endian format. Tags: atp.Status=draft

This interface is used by the StbM to obtain the current freshness value. The interface function provides also the truncated freshness transmitted in the secured time sync message. Tags: atp.Status=draft

Returns the version information of this module.

Initializes the Synchronized Time - base Manager

This function will be called cyclically by a task body provided by the BSW Schedule. It will invoke the triggered customers and synchronize the referenced OS Schedule Tables.

This API is used to set bus specific parameters of a Time Master

Sets an offset time that will be added to the synchronized time when cloning a Time Base.

Allows the Customers to set the new global time that has to be valid for the system, which will be sent to the busses. This function will be used if a Time Master is present in this ECU.

Allows the Customers and the Timesync Modules to set the Offset Time and the User Data.

Allows to set the rate of a Synchronized Time Base (being either a Pure Local Time Base or not).

Allows the Customers to set the new User Data that has to be valid for the system, which will be sent to the busses.

Sets a time value, which the Time Base value is compared against

Called by the <Upper Layer> to force the Times ync Modules to transmit the current Time Base again due to an incremented time Base Update Counter[time Base Id]

Allows the Customers to set the Global Time that will be sent to the buses. This function will be used if a Time Master is present in this ECU. Using Update Global Time will not lead to an immediate transmission of the Global Time.

Structure with detailed data for Time Validation of the Time Master on CAN Variation ({ecuc(Can TSyn/ Can TSyn General/ Can TSyn Time Validation Support)} == True)

Structure with detailed timing data for the Time Slave on CAN Variation ({ecuc(Can TSyn/ Can TSyn General/ Can TSyn Time Validation Support)} == True)

bit DEFERRED_ COPY 0x01 True: copy of time information to destination is deferred until Source Time base is updated next time by <bus> TSyn module False: time information copied immediately to Destination Time Base bit IMMEDIATE_ TX 0x02 True: time information is transmitted on destination bus immediately after cloning False: time information is transmitted on destination bus only on ne xt cyclic transmission after cloning bit APPLY_ RATE 0x04 True: Rate correction value of SOurce Time Base shall be applied to Destination Time Base Description Bitfield to configure the cloning process. Bit 3 .. 7 are always 0 (reserved for future usage). Variation --

Configuration data structure of the Stb M module.

unique identifier of a notification customer Variation --

Structure with detailed data for Time Validation of the Time Master on Ethernet Variation ({ecuc(Eth TSyn/ Eth TSyn General/ Eth TSyn Time Validation Support)} == True)

Structure with detailed data for Time Validation of the Time Slave on Ethernet Variation ({ecuc(Eth TSyn/ Eth TSyn General/ Eth TSyn Time Validation Support)} == True)

Structure with detailed data for Time Validation of the Time Master on Flexray Variation ({ecuc(Fr TSyn/ Fr TSyn General/ Fr TSyn Time Validation Support)} == True)

Structure with detailed data for Time Validation of the Time Slave on Flexray Variation ({ecuc(Fr TSyn/ Fr TSyn General/ Fr TSyn Time Validation Support)} == True)

This type indicates if an ECU is configured for a system wide master for a given Time Base is available or not. Variation --

Structure which contains additional measurement data

Offset Time Base Record Table Block Variation --

Offset Time Base Record Table Header Variation --

Structure with detailed timing data for the p Delay Initiator Variation ({ecuc(Eth TSyn/ Eth TSyn General/ Eth TSyn Time Validation Support)} == True)

Structure with detailed timing d ata for the p Delay Responder Variation ({ecuc(Eth TSyn/ Eth TSyn General/ Eth TSyn Time Validation Support)} == True)

Structure which contains port identity data Variation ({ecuc(Eth TSyn/ Eth TSyn General/ Eth TSyn Time Validation Support)} == True)

This structure defines Time Sync protocol specific parameters relevant for the individual Time Sync modules (only Eth TSyn specific parameters are known so far) Variation --

Variables of this type are used to express a rate deviation in ppm. Variation --

Variables of this type are used to represent the kind of synchronized time - base. Variation --

Synchronized Time Base Record Table Block Variation --

Synchronized Time Base Record Table Header Variation --

bit EV_ GLOBAL_ TIME 0x01 Bit 0 (LSB): 0: synchronization to global time master not changed 1: GLOBAL_ TIME_ BASE in Stb M_ Time Base Status Type has changed from 0 to 1 bit EV_ TIMEOUT_ OCCURRED 0x02 Bit 1: 1: TIMEOUT bit in time Base Status has changed from 0 to 1 0: otherwise bit EV_ TIMEOUT_ REMOVED 0x04 Bit 2 1: TIMEOUT bit in time Base Status has changed from 1 to 0 0: otherwise bit EV_ TIMELEAP_ FUTURE 0x08 Bit 3 1: TIMELEAP_ FUTURE bit in time Base Status has changed from 0 to 1 0: otherwise bit EV_ TIMELEAP_ FUTURE_ REMOVED 0x10 Bit 4 1: TIMELEAP_ FUTURE bit in time Base Status has changed from 1 to 0 0: otherwise bit EV_ TIMELEAP_ PAST 0x20 Bit 5 1: TI MELEAP_ PAST bit in time Base Status has changed from 0 to 1 0: otherwise bit EV_ TIMELEAP_ PAST_ REMOVED 0x40 Bit 6 1: TIMELEAP_ PAST bit in time Base Status has changed from 1 to 0 0: otherwise bit EV_ SYNC_ TO_ SUBDOMAIN 0x80 Bit 7 1: SYNC_ TO_ GATEWAY bit in time Base Status has changed from 0 to 1 0: otherwise bit EV_ SYNC_ TO_ GLOBAL_ MASTER 0x100 Bit 8 1: SYNC_ TO_ GATEWAY bit of Time Domain changes from 1 to 0 0: otherwise bit EV_ RESYNC 0x0200 Bit 9: 1: A synchronization of the local time to the valid Global Time value has occured 0: No resynchronization event occured bit EV_ RATECORRECTION 0x0400 Bit 10 1: a valid rate correction has been calculated (not beyond limits) 0: No rate correction c alculated Description The Stb M_ Time Base Notification Type type defines a number of global time related events. The type definition is used for storing the events in the status variable Notification Events and for setting the mask variable Notification Mask which defines a subset of events for which an interrupt request shall be raised. Variation --

bit TIMEOUT 0x01 Bit 0 (LSB): 0x00: No Timeout on receiving Synchronisation Messages 0x01: Timeout on receiving Synchronisation Messages bit SYNC_ TO_ GATEWAY 0x04 Bit 2 0x00: Local Time Base is synchronous to Global Time Master 0x04: Local Time Base updates are based on a Time Gateway below the Global Time Master bit GLOBAL_ TIME_ BASE 0x08 Bit 3 0x00: Local Time Base is based on Local Time Base reference clock on ly (never synchronized with Global Time Base) 0x08: Local Time Base was at least synchronized with Global Time Base one time bit TIMELEAP_ FUTURE 0x10 Bit 4 0x00: No leap into the future within the received time for Time Base 0x10: Leap into the future w ithin the received time for Time Base exceeds a configured threshold bit TIMELEAP_ PAST 0x20 Bit 5 0x00: No leap into the past within the received time for Time Base 0x20: Leap into the past within the received time for Time Base exceeds a configured thr eshold Description Bit 1, 6, and 7 are always 0 (reserved for future usage) Variables of this type are used to express if and how a Local Time Base is synchronized to the Global Time Master. The type is a bitfield of individual status bits, although not e very combination is possible, i.e. any of the bits TIMEOUT, TIMELEAP_ FUTURE, TIMELEAP_ PAST and SYNC_ TO_ GATEWAY can only be set if the GLOBAL_ TIME_ BASE bit is set. Variation --

Variables of this type are used to express time differences / offsets as signed values in in nanoseconds Variation --

Variables of this type are used for expressing time stamps including relative time and absolute calendar time. The absolute time starts from 1970 - 01 - 01. Variation --

Variables of this type are used for expressing time stamps with a limited range including relative time and absolute calendar time. The absolute time starts from 1970 - 01 - 01. 0 to 4.294.967.295 s ~ 136 years 0 to 999999999ns [0x3B9A C9FF] invalid value in nanoseconds: [0x3B9A CA00] to [0x3FFF FFFF] Bit 30 and 31 reserved, default: 0 Variation --

Variables of this type are used for expressing time stamps including relative time and absolute calendar time. The absolute time starts from 1970 - 01 - 01. 0 to 281474976710655s == 3257812230d [0x FFFF FFFF FFFF] 0 to 999999999ns [0x3B9A C9FF] invalid value i n nanoseconds: [0x3B9A CA00] to [0x3FFF FFFF] Bit 30 and 31 reserved, default: 0 Variation --

Indicates the underlying Time Sync module Variation --

Current user data of the Time Base Variation --

Variables of this type store time stamps of the Virtual Local Time. The unit is nanoseconds. Variation --

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

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

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

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

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

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

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

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

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

Returns the version information of this module.

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

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

Resets a timer instance (user point of view).

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

Resets a timer instance (user point of view).

Shifts the reference time of the timer instance.

Shifts the reference time of the timer instance.

Shifts the reference time of the timer instance.

Shifts the reference time of the timer instance.

Synchronizes two timer instances.

Synchronizes two timer instances.

Synchronizes two timer instances.

Synchronizes two timer instances.

Data type of Time Service Predef Timer 100µs32bit. The structure contains the reference 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.