4 - SysTimeClassic_IntegrationManuals

SysTime Classic Integration Manual
Project
BMW AUTOSAR 4 Core Rel. 3
Author
BMW AG
Release Date
2017-12-14
Version
5.0.3
Status
Release
Hotline
+49 89 382 - 32233
Contact
bac@bmw.de
https://asc.bmw.com/jira/browse/BSUP (extern)
https://asc.bmwgroup.net/jira/browse/BSUP (intern)
Revision History
VersionDateDescription5.0.3
2017-12-14
Version Update
5.0.2
2017-10-12
Version Update
5.0.1
2017-08-10
Version update, no change of content.
5.0.0
2017-06-08
Initial version for SP2021
CompanyBayerische
Motoren Werke
Aktiengesellschaft
Postal addressBMW AG
80788 München
Office addressForschungs- und
Innovationszentrum
(FIZ)
Hufelandstr. 1
80937 München
TelephoneSwitchboard
+49 89 382-0
Internetwww.bmwgroup.com
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 1 of 11
Table of Contents1 Introduction31.1Functional overview3
2 Related documentation43 Limitations54 Software Architecture64.1Dependencies on AUTOSAR modules6
4.1.1RTE6
4.1.2Det6
4.1.3Dcm6
4.1.4Dem6
4.1.5Com6
4.1.6BswM6
4.2Dependencies to other modules6
5 Integration75.1Configuration of other Modules7
5.1.1Dcm7
5.1.2Com7
5.1.3Dem7
5.1.4BswM8
5.1.5Det8
5.2Configuration of generic part8
5.2.1SysTimeGeneral8
5.2.1.1SysTimeDevErrorDetect8
5.2.1.2SysTimeMainTaskCycle9
5.2.1.3SysTimeInitialTimeout9
5.3Configuration of adapter part9
5.3.1SysTimeGeneral9
5.3.1.1SysTimeEnableServiceInterface9
5.4Configuration of the RTE9
5.4.1Assembly Software Connectors9
5.4.1.1Dcm10
5.4.1.2Dem10
5.4.1.3Det10
5.4.1.4BswM10
5.4.1.5Other Application SWC10
5.4.2Event Mapping10
5.4.3Data Mapping10
5.4.4Exclusive Areas11
5.5Software Integration11
5.5.1Startup/Initialization11
5.5.2Normal Operation11
5.5.3Shutdown/Deactivation11
5.5.4SWCD11
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 2 of 11
1IntroductionThis Integration Manual describes the basic functionality of the BMW system function "System Time
Client", the configuration of the SysTime module and of dependant modules, and the integration of the
SysTime module into the BAC4.
[IM_SysTime_0001] dThe SysTime module shall be integrated in every diagnosable ECU.
c
(DMA_PA_9033)Functional overviewThe system time represents the time, which has passed since the initialization of the System Time
Master. The main objective of the System Time Client functionality is to maintain the current system time
for the local ECU. This means:
Receiving the system time from the System Time Master
Interpolation of the system time if no system time signal was received from the System Time Master
Providing the system time to the Dem and to other software components
Providing the system time for diagnostic requests
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 3 of 11
2Related documentationReferencesSysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 4 of 11
3LimitationsNo limitations are known.
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 5 of 11
4Software ArchitectureDependencies on AUTOSAR modulesThe current version of the Module SysTime depends on the following BSW modules:
RTEAs a software component, the SysTime module uses Rte client/server communication as well as
sender/receiver communication to communicate with other SWCs and BSW modules. Additionally the
scheduling is done by the Rte.
DetThe System Time Client optionally reports development errors to the Det.
DcmThe System Time Client implements a ReadDataByIdentifier service. Dcm shall be configured in a way,
that it dispatches the job 0x22 0x17 0x01 to the SysTime SWC.
DemThe System Time Client provides a port interface for the Dem to get the current system time, which will
be attached to an event as event related data.
ComThe System Time Client receives the signal containing the current system time from the Com module.
BswMThe System Time Client receives and requests mode switches from the BswM.
Dependencies to other modulesSysTime does not have dependencies to other modules.
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 6 of 11
5IntegrationConfiguration of other ModulesThe following modules shall be configured, before this module can be generated, compiled and linked.
Dcm[IM_SysTimeClassic_0003] dThe ReadDataByIdentifier request 0x22 0x17 0x01 shall be configured
in the Dcm module with the following settings:
a container "DcmDspData" with
a "DcmDspDataSize" of 32 bit (4 bytes)
"DcmDspDataType" =
UINT8N”DcmDspDataUseP ort” = USE_DAT A_SY NCH_CLIENT _SERV ER
"DcmDspDataConditionCheckReadFncUsed" = FALSE
a container "DcmDspDid" with
"DcmDspDidIdentifier" = 0x1701
only read-access, without session or security restrictions
one DID Signal "DcmDspDidSignal" with Data Position = 0 and a Data Reference to the
"DcmDspData" container configured before.
c
(DMA_PA_8550, DMA_PA_8551, DMA_PA_8552)ComIn the Com module, a signal has to be configured, that receives the message containing the 32-bit
system time from the bus.
Note: In a Can or FlexRay environment, the system time is received within the signal named
T_SEC_COU_REL. In an Ethernet environment, the system time is received within the Parameter
"timeSecondCounterRelative" of the Event "RelativeTimeBN2020".
Dem[IM_SysTimeClassic_0006] dTo attach the system time to a freeze frame of a Dem entry, the
following has to be configured in the Dem module:
a Data Element Class "DemDataElementClass"
of type "DemExternalCSDataElementClass"
with a size "DemDataElementDataSize" of 4 byte
with port usage "DemDataElementUsePort" = TRUE
a Data Id "DemDidClass" with reference to the Data Element Class mentioned above
with reference to the Data Element Class mentioned above
with "DemDidIdentifier" = 0x1701
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 7 of 11

a Freeze Frame Class "DemFreezeFrameClass" with reference to the Data Id above
This DemFreezeFrameClass has to be referenced in the "DemDTCAttributes" of every DTC.
c
(DK_T3_1374, DK_T3_452, DK_T3_453)BswMThe BswM has to provide one BswMModeRequestPort to receive mode switches of the
ModeDeclarationGroup "SysTime_LifeCycle" from the SysTime module, and one RteModeRequestPort
to request modes of the ModeDeclarationGroup "SysTime_LifeCycle".
To initialize the SysTime module the BswM has to provide a rule, that results in an action that requests
the mode "SYSTIME_INITIALIZED"of the mode declaration group "SysTime_LifeCycle".
To set the SysTime module to normal operation mode the BswM has to provide a rule, that results in an
action that requests the mode "SYSTIME_RUNNING" of the mode declaration group
"SysTime_LifeCycle". This rule shall be triggered, if the mode has been switched to
"SYSTIME_INITIALIZED" by the SysTime module itself, AND it is technically possible to receive the
system time on the bus. When the SysTime module is in normal operation mode, the SysTime module
switches the mode to "SYSTIME_RUNNING".
To deactivate the SysTime module the BswM has to provide a rule, that results in an action that requests
the mode "SYSTIME_STOPPED" of the mode declaration group "SysTime_LifeCycle".
For details on how to initialize / deactivate the SysTime module, please refer to chapter 6.4.
DetA SysTime entry shall be added to the Software Component List from Det. This is only necessary, if the
parameter "SysTimeDevErrorDetect" is set to "true" (see chapter 6.2).
Configuration of generic partSysTimeGeneralThis container contains the configuration parameters of the generic part of the SysTime module
SysTimeDevErrorDetectThis parameter activates/deactivates the Development Error Detection and Notification.
If set to true: Development Error Detection and Notification is activated. If set to false: Development Error
Detection and Notification is deactivated.
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 8 of 11
SysTimeMainTaskCycleThis parameter describes the cycle rate, in which the function "SysTime_MainFunction" is called. This
value has to be configured according to the cycle time of the task, which the Timing Event "TimingEvent"
is mapped to (see chapter 6.3.1). Allowed values are 0.01s (10ms) to 0.10s (100ms).
The function "SysTime_MainFunction" is mapped to the Runnable Entity "MainFunction", which is
triggered by the Timing Event "TimingEvent".
SysTimeInitialTimeout[IM_SysTime_0002] dThis parameter describes the initial timeout value for the system time signal. The
System Time Client will set the system time to 0xFFFFFFFF, if no valid system time has been received
until this timeout has expired. If the system time signal is received via Can, FlexRay or Ethernet, this
parameter has to be set to 5.0 seconds. c
(DMA_PA_8471)Configuration of adapter partSysTimeGeneralThis container contains the configuration parameters of the classic adapter of the SysTime module.
SysTimeEnableServiceInterfaceThis parameter describes whether the system time is received via Service Interface or via a plain signal.
On Ethernet the system time is transmitted via Parameter "timeSecondCounterRelative" of Event
"RelativeTimeBN2020" of Service Interface "VehicleInformation". On Can and Flexray the system time is
transmitted via Signal T_SEC_COU_REL.
true: system time is received via Service Interface (needed for Ethernet communication)
false: System time is received via plain signal (needed for Can and Flexray communication)
Configuration of the RTEAfter performing the steps indicated in chapter 6.1 and 6.2, the RTE configuration can be started. In other
way, the RTE will report an interface incompatibility error.
Assembly Software ConnectorsThe ports of the SysTime module have to be connected with ports of other modules as follows:
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 9 of 11
Dcm[IM_SysTimeClassic_0002] dSystemTime <-> DataServices_<Data> where <Data> is the name of
the corresponding container "DcmDspData" configured in the Dcm module. c
(DMA_PA_8552)Dem[IM_SysTimeClassic_0007] dSystemTime <-> CBReadData_<SyncDataElement> where
<SyncDataElement> is the name of the corresponding container "DemDataElementClass" configured in
the Dem module. c
(DK_T3_1374)DetSysTimeReportError <-> DS<xxx> where <xxx> is an identifier of the module id of the SysTime
configured in the Det module.
BswMLifeCycle <-> BswMModeRequestPort_xxx where BswMModeRequestPort_xxx means the R-Port of the
BswM that receives a mode switch from the SysTime module. LifeCycleRequest <->
RteModeRequestPort_xxx where RteModeRequestPort_xxx means the P-Port of the BswM that provides
a mode request to the SysTime module.
Other Application SWCSysTime <-> ApplicationPort where ApplicationPort means the R-Port of an Application SWC that wants
to read the current system time from the SysTime module.
Event MappingThe timing event "TimingEvent" of the SysTime module has to be mapped to a cyclic task with a cycle
time according to parameter "SysTimeMainTaskCycle" in chapter 6.2. The data received event
"SysTimeRx" has to be mapped to an os-task.
Data Mapping[IM_SysTimeClassic_0001] dIf the system time is received via Can or FlexRay, the data element
"timeSignal" of the sender-receiver-interface "SysTimeRx" has to be mapped to the signal in the Com
configuration mentioned in chapter 6.1. In the BNE export this signal is named T_SEC_COU_REL.
c
(DMA_PA_8471)SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 10 of 11

If the system time is received via Ethernet, the data element "RelativeTimeBN2020" of the
sender-receiver-interface "SysTimeEventRx" has to be mapped to the signal group in the Com
configuration, which represents the Event "RelativeTimeBN2020".
Exclusive AreasThe exclusive area "SysTimeGetTimeArea" has to be configured in the RTE.
Software IntegrationStartup/InitializationBefore initialization of the SysTime module, the Det module and the RTE have to be initialized.
[IM_SysTimeClassic_0004] dTo initialize the SysTime module, the BswM shall request the mode
"SYSTIME_INITIALIZED" of the mode declaration group "SysTime_LifeCycle". This shall be done before
any monitoring function is active which could lead to error memory entries. c
(DMA_PA_8300)When initialization of the SysTime has been finished successfully, the SysTime module switches the
mode to "SYSTIME_INITIALIZED".
Normal OperationWhen the SysTime module switches the mode to "SYSTIME_INITIALIZED", AND it is technically
possible to receive the system time on the bus, the BswM shall request the mode
"SYSTIME_RUNNING". When the SysTime module switches the mode to "SYSTIME_RUNNING", the
module is in normal operation mode.
Shutdown/Deactivation[IM_SysTimeClassic_0005] dTo deactivate the SysTime module, the BswM has to request the mode
"SYSTIME_STOPPED". When the SysTime module switches the mode to "SYSTIME_STOPPED", the
module is deactivated. This shall not be done as long as any monitoring function is active which could
lead to error memory entries. c
(DMA_PA_8300)SWCDIf the modules Dem and Dcm are configured correctly, there should be no changes necessary in the file
SysTime_ext_interfaces.arxml. If the RTE importer complains about incompatible interfaces, please
check the Dem and Dcm configuration, or adapt the interfaces in SysTime_ext_interfaces.arxml according
to the generated Software Component Description files of Dcm and Dem.
SysTimeClassic_IntegrationManual.pdf, Version 5.0.3, Software Platforms
Page 11 of 11
Document Outline
7 - SysTimeClassic_ReleaseNotess

Release Notes SysTimeClassic
Project
BMW AUTOSAR 4 Core Rel. 3
Author
BMW AG
Release Date
2017-12-14
Version
5.0.3
Status
Release
Hotline
+49 89 382 - 32233
Contact
bac@bmw.de
https://asc.bmw.com/jira/browse/BSUP (extern)
https://asc.bmwgroup.net/jira/browse/BSUP (intern)
Revision History
VersionDateIssues5.0.3
2017-12-14
BAC-6695
5.0.2
2017-10-12
BAC-5176, BAC-6230, BAC-6433
5.0.1
2017-08-10
BAC-6204, BAC-6200
5.0.0
2017-06-29
CompanyBayerische
Motoren Werke
Aktiengesellschaft
Postal addressBMW AG
80788 München
Office addressForschungs- und
Innovationszentrum
(FIZ)
Hufelandstr. 1
80937 München
TelephoneSwitchboard
+49 89 382-0
Internetwww.bmwgroup.com
ReleaseNotes_SysTimeClassic, Version 5.0.3, Software Platforms
Page 1 of 4
1Module DescriptionThis package contains the adapter for a classic AUTOSAR platform for the SysTimeGeneric package. The
System Time Client is modeled as an AUTOSAR software component (SWC) residing above the RTE.
2Revisions and ModificationsRevision 5.0.3 [Released]ItemDescriptionCR ID:
BAC-6695
CR Headline:
Fix MISRA violations
Description of Issues:
SysTime has MISRA violations.
Description of Changes:
Fixed MISRA violations where reasonable.
Changed Files:
src/SysTime_ConcAdapter.c
src/SysTimeClassic.c
src/SysTime_TimerAdapter.c
include/SysTime_AssertAdapter.h
Compatibility:
Revision 5.0.2 [Released]ItemDescriptionCR ID:
BAC-5176
CR Headline:
BAC modules paramdef violate TPS_ECUC_06004
Description of Issues:
According to AUTOSAR_TPS_ECUConfiguration
TPS_ECUC_06004 an AdminData field is required at the
beginning of every ECU Configuration Parameter Definition XML
file.
Description of Changes:
Added AdminData field containing module version and release
date.
Changed Files:
cfgdesc/SysTimeClassic_paramdef.arxml
Compatibility:
ItemDescriptionCR ID:
BAC-6230
CR Headline:
Usage of IMPLEMENTATION-CONFIG-CLASSES in BMW
modules is invalid according to ASR4.2.2
Description of Issues:
Elements IMPLEMENTATION-CONFIG-CLASSES containing
ECUC-IMPLEMENTATION-CONFIGURATION-CLASS are
deprecated.They shall be replaced by VALUE-CONFIG-
CLASSES/ECUC-VALUE-CONFIGURATION-CLASS and/or
MULTIPLICITY-CONFIG-CLASSES/ECUC-MULTIPLICITY-
CONFIGURATION-CLASS
ReleaseNotes_SysTimeClassic, Version 5.0.3, Software Platforms
Page 2 of 4

Description of Changes:
Replaced IMPLEMENTATION-CONFIG-CLASSES by
VALUE-CONFIG-CLASSES, added
MULTIPLICITY-CONFIG-CLASSES where necessary.
Changed Files:
cfgdesc/SysTimeClassic_paramdef.arxml
Compatibility:
ItemDescriptionCR ID:
BAC-6433
CR Headline:
Schema of paramdefs, paramconfs and SWCDen should be
AUTOSAR_4-3-0_STRICT_COMPACT.xsd
Description of Issues:
Schema of parameter definition files and SWCDs should be
conform to AUTOSAR_4-3-0_STRICT_COMPACT.xsd
Description of Changes:
Adapted parameter definition files and SWCDs to schema
AUTOSAR_4-3-0_STRICT_COMPACT.
Changed Files:
cfgdesc/SysTimeClassic_paramdef.arxml
generate/meta/SysTime_ext_interfaces.arxml.pgen
generate/meta/SysTime_internal.arxml.pgen
generate/meta/SysTime_interfaces.arxml.pgen
Compatibility:
Revision 5.0.1 [Released]ItemDescriptionCR ID:
BAC-6204
CR Headline:
SysTime: Wrong cross version check for classic adapter
Description of Issues:
SysTimeClassic_Version.h uses wrong cross version check of
generic part.
Description of Changes:
Correct cross version check in classic adapter.
Changed Files:
generate/include/SysTimeClassic_Version.h.pgen
Compatibility:
ItemDescriptionCR ID:
BAC-6200
CR Headline:
Improve Requirements Traceability
Description of Issues:
Add requirements from IntegrationManual to RequirementsTable.
Description of Changes:
Added requirements from IntegrationManual to
RequirementsTable.
Changed Files:
Compatibility:
Revision 5.0.0 [Released]ItemDescriptionCR ID:
CR Headline:
Initial Release for SP2021
Description of Issues:
Initial Release for SP2021
ReleaseNotes_SysTimeClassic, Version 5.0.3, Software Platforms
Page 3 of 4

Description of Changes:
Initial Release for SP2021
Changed Files:
Compatibility:
ReleaseNotes_SysTimeClassic, Version 5.0.3, Software Platforms
Page 4 of 4
Document Outline
13 - SysTimeGeneric_ReleaseNotess

Release Notes SysTimeGeneric
Project
BMW AUTOSAR Core 4 Rel. 3 and adaptive BMW AUTOSAR Core Rel. 1
Author
BMW AG
Release Date
2017-12-14
Version
5.0.3
Status
Release
Hotline
+49 89 382 - 32233 (classic) / +49 89 382 - 22522 (adaptive)
Contact
bac@bmw.de (classic) / abac@bmw.de (adaptive)
https://asc.bmw.com/jira/browse/BSUP (extern)
https://asc.bmwgroup.net/jira/browse/BSUP (intern)
Revision History
VersionDateIssues5.0.3
2017-12-14
BAC-6695
5.0.2
2017-10-12
BAC-5176, BAC-6230, BAC-6433
5.0.1
2017-08-10
BAC-6200
5.0.0
2017-06-29
CompanyBayerische
Motoren Werke
Aktiengesellschaft
Postal addressBMW AG
80788 München
Office addressForschungs- und
Innovationszentrum
(FIZ)
Hufelandstr. 1
80937 München
TelephoneSwitchboard
+49 89 382-0
Internetwww.bmwgroup.com
ReleaseNotes_SysTimeGeneric, Version 5.0.3, Software Platforms
Page 1 of 3
1Module DescriptionThe system time represents the time, which has passed since the initialization of the System Time
Master. The main objective of the System Time Client functionality is to maintain the current system time
for the local ECU. This means: - Receiving the system time from the System Time Master - Interpolation
of the system time if no system time signal was received from the System Time Master - Providing the
system time to the Dem and to other software components - Providing the system time for diagnostic
requests
2Revisions and ModificationsRevision 5.0.3 [Released]ItemDescriptionCR ID:
BAC-6695
CR Headline:
Fix MISRA violations
Description of Issues:
SysTime has MISRA violations.
Description of Changes:
Fixed MISRA violations where reasonable.
Changed Files:
src/SysTime.c
Compatibility:
Revision 5.0.2 [Released]ItemDescriptionCR ID:
BAC-5176
CR Headline:
BAC modules paramdef violate TPS_ECUC_06004
Description of Issues:
According to AUTOSAR_TPS_ECUConfiguration
TPS_ECUC_06004 an AdminData field is required at the
beginning of every ECU Configuration Parameter Definition XML
file.
Description of Changes:
Added AdminData field containing module version and release
date.
Changed Files:
cfgdesc/SysTime_paramdef.arxml
Compatibility:
ItemDescriptionCR ID:
BAC-6230
CR Headline:
Usage of IMPLEMENTATION-CONFIG-CLASSES in BMW
modules is invalid according to ASR4.2.2
Description of Issues:
Elements IMPLEMENTATION-CONFIG-CLASSES containing
ECUC-IMPLEMENTATION-CONFIGURATION-CLASS are
deprecated.They shall be replaced by VALUE-CONFIG-
CLASSES/ECUC-VALUE-CONFIGURATION-CLASS and/or
MULTIPLICITY-CONFIG-CLASSES/ECUC-MULTIPLICITY-
CONFIGURATION-CLASS
ReleaseNotes_SysTimeGeneric, Version 5.0.3, Software Platforms
Page 2 of 3

Description of Changes:
Replaced IMPLEMENTATION-CONFIG-CLASSES by
VALUE-CONFIG-CLASSES, added
MULTIPLICITY-CONFIG-CLASSES where necessary.
Changed Files:
cfgdesc/SysTime_paramdef.arxml
Compatibility:
ItemDescriptionCR ID:
BAC-6433
CR Headline:
Schema of paramdefs, paramconfs and SWCDen should be
AUTOSAR_4-3-0_STRICT_COMPACT.xsd
Description of Issues:
Schema of parameter definition files and SWCDs should be
conform to AUTOSAR_4-3-0_STRICT_COMPACT.xsd
Description of Changes:
Adapted parameter definition files and SWCDs to schema
AUTOSAR_4-3-0_STRICT_COMPACT.
Changed Files:
cfgdesc/SysTime_paramdef.arxml
Compatibility:
Revision 5.0.1 [Released]ItemDescriptionCR ID:
BAC-6200
CR Headline:
Improve Requirements Traceability
Description of Issues:
Add requirements from IntegrationManual to RequirementsTable.
Description of Changes:
Added requirements from IntegrationManual to
RequirementsTable.
Changed Files:
Compatibility:
Revision 5.0.0 [Released]ItemDescriptionCR ID:
CR Headline:
Initial Release for SP2021
Description of Issues:
Initial Release for SP2021
Description of Changes:
Initial Release for SP2021
Changed Files:
Compatibility:
ReleaseNotes_SysTimeGeneric, Version 5.0.3, Software Platforms
Page 3 of 3
Document Outline