MICROSAR DET
Technical Reference
Version 12.0.0
Authors
Hartmut Hörner
Status
Released
Technical Reference MICROSAR DET
© 2021 Vector Informatik GmbH Version 12.0.0 2
based on template version 6.0.1
Document Information
History
Author
Date
Version
Remarks
Hartmut Hörner
2007-11-29
1.0
Initial version
Hartmut Hörner
2008-01-03
1.1
Update to AUTOSAR 3
Hartmut Hörner
2008-04-14
1.2
Naming changed to AUTOSAR short
name, screen shots updated.
(ESCAN00025687)
Hartmut Hörner
2008-09-16
1.3
Added DET extension mechanism based
on callout.
Added chapter 3.4.
Hartmut Hörner
2010-01-13
2.0
Update to AUTOSAR 4
Hartmut Hörner
2012-04-20
2.1
Added usage hints related to silent BSW
concept in 3.7.
(ESCAN00058419)
Hartmut Hörner
2013-04-09
2.2
Added Configurator 5 and service port
interface
(ESCAN00066511)
Hartmut Hörner
2013-09-13
2.3
Added DLT forwarding support for
Configurator 5
(ESCAN00068394, ESCAN00069807)
Hartmut Hörner
2014-12-10
2.3.1
Added description of
BCD-coded return value of
Det_GetVersionInfo()
(ESCAN00079310)
Hartmut Hörner
2015-06-12
2.4.0
File name changed
(ESCAN00081049)
Added chapter 3.2.
Hartmut Hörner
2016-12-24
10.0.0
Update to AUTOSAR 4.3 (FEAT-1939)
Hartmut Hörner
2020-07-16
11.0.0
Update to AUTOSAR 19-11
Hartmut Hörner
2021-04-30
12.0.0
Usage of Det_MemMap.h (MSR4-31200)
Component history chapter removed.
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
AUTOSAR_SWS_DefaultErrorTracer
19-11
[2]
AUTOSAR
AUTOSAR_TR_BSWModuleList
19-11
Technical Reference MICROSAR DET
© 2021 Vector Informatik GmbH Version 12.0.0 3
based on template version 6.0.1
Scope of the Document
This technical reference describes the general use of the MICROSAR Default Error Tracer
(DET).
Note that this release of the DET supports only AUTOSAR 4 and the configuration tool
Configurator 5. If you need a DET module for previous AUTOSAR versions or tools an
older version is required.
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 DET
© 2021 Vector Informatik GmbH Version 12.0.0 4
based on template version 6.0.1
Contents
1 Introduction................................................................................................................... 7
1.1 Architecture Overview ........................................................................................ 7
2 Functional Description ................................................................................................. 9
2.1 Features ............................................................................................................ 9
2.1.1 Deviations .......................................................................................... 9
2.1.2 Additions/ Extensions ......................................................................... 9
2.1.3 Limitations ........................................................................................ 10
2.2 Initialization ...................................................................................................... 10
2.3 States .............................................................................................................. 10
2.4 Main Functions ................................................................................................ 10
2.5 Error Handling .................................................................................................. 10
2.5.1 Development Error Reporting ........................................................... 10
2.5.2 Production Code Error Reporting ..................................................... 11
2.6 Handling of development errors - Debugging with the DET .............................. 11
2.6.1 Extended Debug Features ............................................................... 11
2.6.1.1 Filters ............................................................................. 12
2.6.1.2 Logging .......................................................................... 13
2.6.1.3 Break handler ................................................................ 14
2.6.1.4 Filtering of DLT forwarding ............................................. 15
2.7 Handling of runtime errors and transient faults ................................................. 15
2.8 Extension of the DET ....................................................................................... 16
2.9 Usage of ErrorId .............................................................................................. 16
3 Integration ................................................................................................................... 17
3.1 Scope of Delivery ............................................................................................. 17
3.1.1 Static Files ....................................................................................... 17
3.1.2 Dynamic Files .................................................................................. 17
3.2 Critical Sections ............................................................................................... 17
3.3 Include Structure .............................................................................................. 17
3.4 Handling of Recursions .................................................................................... 18
3.5 Multi-core system ............................................................................................. 18
3.6 Partitioning and memory protection .................................................................. 18
3.7 Usage Hints for Operation in Safety Related ECUs .......................................... 19
4 API Description ........................................................................................................... 20
4.1 Type Definitions ............................................................................................... 20
4.2 Services provided by DET ................................................................................ 21
4.2.1 Det_Init ............................................................................................ 21
Technical Reference MICROSAR DET
© 2021 Vector Informatik GmbH Version 12.0.0 5
based on template version 6.0.1
4.2.2 Det_InitMemory ................................................................................ 21
4.2.3 Det_Start .......................................................................................... 22
4.2.4 Det_GetVersionInfo .......................................................................... 22
4.2.5 Det_ReportError ............................................................................... 23
4.2.6 Det_ReportRuntimeError ................................................................. 23
4.2.7 Det_ReportTransientFault ................................................................ 24
4.3 Services used by DET ..................................................................................... 25
4.4 Callback Functions ........................................................................................... 25
4.5 Configurable Interfaces .................................................................................... 25
4.5.1 Callout Functions ............................................................................. 25
4.5.1.1 <DetErrorHook> ............................................................. 25
4.5.1.2 <DetReportRuntimeErrorCallout> .................................. 26
4.5.1.3 <DetReportTransientFaultCallout> ................................. 26
4.6 Service Ports ................................................................................................... 27
4.6.1 Client Server Interface ..................................................................... 27
4.6.1.1 Provide Ports on DET Side ............................................ 27
4.6.1.1.1 DETService................................................ 27
5 Configuration .............................................................................................................. 29
5.1 Configuration Variants ...................................................................................... 29
6 Glossary and Abbreviations ...................................................................................... 30
6.1 Glossary .......................................................................................................... 30
6.2 Abbreviations ................................................................................................... 30
7 Contact ........................................................................................................................ 31