MICROSAR Classic StbM
Technical Reference
Version 9.4.0
Authors
visssf, visbbk, visgut, vistra, vissi, visgig, visjwe,
istaehle, vrietz
Status
Released
Technical Reference MICROSAR Classic StbM
© 2023 Vector Informatik GmbH Version 9.4.0 2
based on template version 5.4.0
Document Information
History
Author
Date
Versio
n
Remarks
visssf
2012-12-06
1.0.0
Initial version
visssf
2013-04-10
1.1.0
Set status to released
Added StbM_InitMemory
Added description of critical sections
visssf
2013-10-30
2.0.0
Fixed review findings
visssf
2014-11-05
3.0.0
Support new global time synchronization
concept
visssf
2015-01-29
3.1.0
Renamed document
visssf
2015-08-12
3.2.0
Changed StbM_TimeStampRawType to
structure
visssf
2016-01-08
4.0.0
Support of High Resolution Time Base
Reference Clock based on GPT
Added EthTSyn_SetGlobalTime to used
services
visssf
2016-03-22
4.1.0
Support of time gateways
visssf
2017-03-29
4.2.0
Support of time correction
Removed EthTSyn from used services
Added EthIf to used services
visssf
2017-06-29
5.1.0
Support time precision measurement
visbbk, visgut,
visssf, vistra
2017-08-01
5.2.0
New Notifications for time expiration and status
changed events
Support of immediate time synchronization
Added handling of time leaps
vistra, visssf
2017-09-27
5.3.0
Minor AR4.3 extensions
Added StbM_GetTimeBaseStatus
Changed availability of service ports and
operations according to AR 4.3
vissi
2018-02-28
5.4.0
Updated AUTOSAR architecture
Updated referenced documents
visssf
2018-05-22
5.5.0
Support schedule table synchronization for
different counter resolutions
Support time base specific time difference
calculation according to AR 4.3.1
Improved exclusive area description
visssf
2018-07-16
5.6.0
First ASIL D version
Minor corrections
Technical Reference MICROSAR Classic StbM
© 2023 Vector Informatik GmbH Version 9.4.0 3
based on template version 5.4.0
vistra
2018-08-14
5.7.0
StbM avoids accessing an uncertain Ethernet
clock source
Added description of parameter 'ConfigPtr' of
StbM_Init()
Updated chapter 4.1 to new template
visssf
2018-10-22
5.8.0
MISRA-C:2012 compliance
Updated used services
vissi
2019-01-23
5.8.1
Minor improvements
vissi
2019-09-05
6.0.0
Minor improvements
Module rework and introduction of sub units for
functional safety
Time correction and time leap behavior
implemented according AR 4.3.1
Documented deviations to AR 4.3.1
visgig, vistra
2020-03-30
7.0.0
Support of enhanced precision of Global Time
(AR RfC 79959)
Initialization by BswM instead of EcuM
Added limitations for Local Time
visssf
2020-05-07
8.0.0
Support of time validation for Ethernet use case
(beta)
visjwe, visgig, visssf
2020-07-03
8.1.0
Support of time validation for Ethernet use case
(production)
Minor improvements
Post-Build Variant Support
visssf, vistra
2021-03-08
8.2.0
Corrected value range of
StbM_TimeBaseStatusType
Reserved time bases are not supported
visjwe, visssf, istaehle
2022-04-20
9.0.0
ASR memmap include structure ALL SLP
Multicore Distribution for CAN
Added API StbM_GetMainTime
Product name updated to MICROSAR
Classic
visssf
2022-06-13
9.0.1
Minor corrections
vrietz
2022-06-24
9.1.0
Added error checks and parameters for
STBM_E_PARAM_USERDATA and
STBM_E_PARAM_TIMESTAMP
vrietz, istaehle, visssf,
visjwe
2022-09-02
9.2.0
Support of time base cloning
Updated document to reference AR 21-11
Updated adjacent interface diagram
Add hint for GPT timer usage
Minor corrections
istaehle, visssf
2022-10-19
9.3.0
Support rate correction of sync reception delay
Improved documentation of Multi-Partition
support
Option to use time domains 32 to 127 as
synchronized time bases
Technical Reference MICROSAR Classic StbM
© 2023 Vector Informatik GmbH Version 9.4.0 4
based on template version 5.4.0
visssf
2023-01-13
9.4.0
Improved documentation of Multi-Partition
support
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
Specification of Synchronized Time-Base Manager
R21-11
[2]
AUTOSAR
List of Basic Software Modules
R21-11
[3]
AUTOSAR
Specification of Default Error Tracer
R21-11
[4]
AUTOSAR
Specification of RTE Software
R21-11
[5]
AUTOSAR
Specification of Operating System
R21-11
[6]
AUTOSAR
Specification of Ethernet Interface
R21-11
[7]
AUTOSAR
Specification of GPT Driver
R21-11
[8]
AUTOSAR
Specification of ECU State Manager
R21-11
[9]
AUTOSAR
Specification of Time Synchronization over CAN
R19-11
[10]
AUTOSAR
Specification of Time Synchronization over Ethernet
R4.4.0
[11]
AUTOSAR
Specification of Time Synchronization over FlexRay
R4.4.0
Scope of the Document
This technical reference describes the general use of the Synchronized Time-Base
Manager.
Caution
We have configured the programs in accordance with your specifications in the
questionnaire. Whereas the programs do support other configurations than the one
specified in your questionnaire, Vector´s release of the programs delivered to your
company is expressly restricted to the configuration you have specified in the
questionnaire.
Technical Reference MICROSAR Classic StbM
© 2023 Vector Informatik GmbH Version 9.4.0 5
based on template version 5.4.0
Contents
1 Introduction.......................................................................................................................... 10
1.1 Architecture Overview ............................................................................................... 10
2 Functional Description ........................................................................................................ 12
2.1 Features ................................................................................................................... 12
2.1.1 Deviations ................................................................................................. 12
2.1.2 Additions/ Extensions ................................................................................ 13
2.1.2.1 Memory Initialization ............................................................... 13
2.1.2.2 API to retrieve main time tuple, status and rate deviation ........ 13
2.1.2.3 Additional error check in StbM_StartTimer .............................. 14
2.1.2.4 Option to use time domains 32 to 127 as synchronized
time bases .............................................................................. 14
2.1.3 Limitations ................................................................................................. 14
2.1.3.1 Local Time .............................................................................. 14
2.1.4 Notifications for time expiration and status changed events ...................... 14
2.1.4.1 Status Notifications ................................................................. 14
2.1.4.2 Time Notifications ................................................................... 15
2.2 Initialization ............................................................................................................... 15
2.3 States ....................................................................................................................... 16
2.4 Main Functions ......................................................................................................... 16
2.4.1 Main Functions with Multi-Partition configurations ..................................... 16
2.5 Error Handling ........................................................................................................... 16
2.5.1 Development Error Reporting .................................................................... 16
2.5.2 Production Code Error Reporting .............................................................. 17
3 Integration ............................................................................................................................ 18
3.1 Embedded Implementation ....................................................................................... 18
3.2 Critical Sections ........................................................................................................ 19
3.3 OSScheduleTable Synchronization ........................................................................... 20
3.4 Memory Sections ...................................................................................................... 20
4 API Description .................................................................................................................... 21
4.1 Type Definitions ........................................................................................................ 21
4.2 Services provided by StbM ....................................................................................... 30
4.2.1 StbM_GetVersionInfo ................................................................................ 30
4.2.2 StbM_InitMemory ...................................................................................... 31
4.2.3 StbM_PreInit ............................................................................................. 31
4.2.4 StbM_Init ................................................................................................... 32
4.2.5 StbM_PostInit............................................................................................ 33
