MICROSAR Diagnostic Log and Trace
Technical Reference
Diagnostic Log and Trace
Version 5.1.0
Authors
visml, visore, viszda
Status
Released
Technical Reference MICROSAR Diagnostic Log and Trace
© 2021 Vector Informatik GmbH Version 5.1.0 2
based on template version 4.8.0
Document Information
History
Author
Date
Version
Remarks
visml
2011-06-20
1.0.0
Creation
visml
2013-03-26
1.0.1
ESCAN00065965: Extended integration
directions.
visore
2013-07-11
1.1.0
ESCAN00068275: AR4-292: Reporting of
DET and DEM errors via DLT
visem
2013-10-07
1.1.1
Typos and formats
viszda
2015-03-24
1.2.0
Feature: DLT with AUTOSAR functionality and
DLT Transport Layer
viszda
2015-11-20
2.0.0
ESCAN00086655: Create two different
Technical References for Dlt_OnXcp and
Dlt_Autosar.
viszda
2016-03-07
2.1.0
Security Mechanism added.
viszda
2017-07-03
2.1.1
ESCAN00092156
viszda
2018-11-13
3.0.0
STORY-8329: Add the APIs introduced in
ASR DLT 4.3.1.
viszda
2019-02-06
3.1.0
STORY-9729: Change data types
corresponding to ASR 4.3.1 and change the
APIs using those data types.
viszda
2020-03-13
4.0.0
SWAT-15: Support of PduR as lower layer
viszda
2020-04-21
4.1.0
SWAT-62: store configuration
SWAT-78: SWC injection
viszda
2020-05-28
4.2.0
SWAT-35: Implement the multi log channel
support
viszda
2020-07-09
4.3.0
SWAT-1041: Support of bandwidth
management
viszda
2020-08-05
4.4.0
SWAT-1110: Separate exclusive areas for tx
and rx
viszda
2020-11-25
5.0.0
SWAT-1252: Provide the API to get the
default LogLevel and default TraceStatus
viszda
2021-01-11
5.1.0
SWAT-1070: Validate SoAd parameter to
support Dlt over TCP
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
Specification of Diagnostic Log
and Trace
R19-11
[2]
AUTOSAR
Specification of Default Error Tracer
V4.3.1
[3]
AUTOSAR
Specification of Diagnostic Event Manager
V4.2.0
Technical Reference MICROSAR Diagnostic Log and Trace
© 2021 Vector Informatik GmbH Version 5.1.0 3
based on template version 4.8.0
[4]
Vector
UserManual AMD – MICROSAR 4 AUTOSAR Monitoring
and Debugging
V1.3.1
[5]
Vector
ASAP2 Tool-Set User Manual
V4.3
[6]
AUTOSAR
Log and Trace Protocol Specification
R19-11
[7]
Vector
TechnicalReference NvM
See delivery
[8]
Vector
TechnicalReference SoAd
See delivery
Scope of the Document:
This technical reference describes the use of the DLT module for tracing and logging
purposes.
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 Diagnostic Log and Trace
© 2021 Vector Informatik GmbH Version 5.1.0 4
based on template version 4.8.0
Contents
1 Introduction............................................................................................................................ 7
1.1 Architecture Overview ................................................................................................. 8
2 Functional Description .......................................................................................................... 9
2.1 Features ..................................................................................................................... 9
2.1.1 Supported features...................................................................................... 9
2.1.2 Deviations ................................................................................................... 9
2.2 Initialization ............................................................................................................... 10
2.3 States ....................................................................................................................... 10
2.4 Main Functions ......................................................................................................... 11
2.5 Error Handling ........................................................................................................... 11
2.5.1 Development Error Reporting .................................................................... 11
2.5.2 Production Code Error Reporting .............................................................. 12
3 Integration ............................................................................................................................ 13
3.1 Embedded Implementation ....................................................................................... 13
3.2 Critical Sections ........................................................................................................ 13
3.3 Common Configuration Steps ................................................................................... 13
3.4 DLT on XCP .............................................................................................................. 14
3.4.1 XCP Event ................................................................................................ 14
3.4.2 XCP: Logging of verbose and non-verbose DLT messages....................... 15
3.4.3 Workflow McData ...................................................................................... 16
3.4.4 DLT Reporting with CANoe ....................................................................... 18
3.4.5 DLT Reporting with CANape ..................................................................... 20
4 API Description .................................................................................................................... 23
4.1 Type Definitions ........................................................................................................ 23
4.2 Services provided by DLT ......................................................................................... 23
4.2.1 Dlt_InitMemory .......................................................................................... 23
4.2.2 Dlt_Init....................................................................................................... 24
4.2.3 Dlt_MainFunction ...................................................................................... 24
4.2.4 Dlt_GetVersionInfo .................................................................................... 25
4.2.5 Dlt_DetForwardErrorTrace ........................................................................ 26
4.2.6 Dlt_DemTriggerOnEventStatus ................................................................. 26
4.2.7 Dlt_SendLogMessage ............................................................................... 27
4.2.8 Dlt_SetState .............................................................................................. 28
4.2.9 Dlt_GetState ............................................................................................. 29
4.3 Services used by DLT ............................................................................................... 29
Technical Reference MICROSAR Diagnostic Log and Trace
© 2021 Vector Informatik GmbH Version 5.1.0 5
based on template version 4.8.0
5 Glossary and Abbreviations ............................................................................................... 31
5.1 Glossary ................................................................................................................... 31
5.2 Abbreviations ............................................................................................................ 31
6 Contact ................................................................................................................................. 32
