MICROSAR Complex Device Driver
Technical Reference
DaVinci Configurator
Version 4.00.00
Authors
visssa, visms, visbms
Status
Released
Technical Reference MICROSAR Complex Device Driver
© 2021 Vector Informatik GmbH Version 4.00.00 2
based on template version 5.2.0
Document Information
History
Author
Date
Version
Remarks
visssa
2012-03-23
1.00.00
Initial Version
visms
2012-08-08
2.00.00
Support AUTOSAR 4
visms
2013-05-13
2.00.01
performed review rework
visbms
2014-02-05
2.01.00
Support J1939Rm Contribution
visbms
2014-02-28
2.02.00
Support the StartOfReception API with the
PduInfoType according to ASR4.1.2
visms
2014-05-07
2.02.00
AR4-769: ESCAN00075414
AR4-744: Cdd shall support
CddSoAdUpperLayerContribution as an
extension to AR 4.0.3 (schema shall
remain at AR 4.0.3)
visms
2016-02-24
2.03.00
FEAT-1631: Trigger Transmit API with
SduLength In/Out according to ASR4.2.2
visms
2017-01-09
2.04.00
Rename TechnicalReference_Cdd.pdf to
TechnicalReference_Cdd_Communication.
pdf
visms
2018-04-10
3.00.00
ESCAN00090877: Add statement about
template and user responsibility
visms
2021-08-26
4.00.00
COM-2349 Support Dynamic MemMap
Sections
COM-2035 Remove the AUTHOR
IDENTITY
Reference Documents
No.
Source
Title
Version
[1]
AUTOSAR
AUTOSAR_TPS_ECUConfiguration.pdf
3.2.0
[2]
AUTOSAR
AUTOSAR_TR_BSWModuleList.pdf
1.6.0
Technical Reference MICROSAR Complex Device Driver
© 2021 Vector Informatik GmbH Version 4.00.00 3
based on template version 5.2.0
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.
Caution
This symbol calls your attention to warnings.
Contents
1 Component History ...................................................................................................... 7
2 Introduction................................................................................................................... 8
2.1 Architecture Overview ........................................................................................ 9
3 Functional Description ............................................................................................... 10
3.1 Features .......................................................................................................... 10
4 Integration ................................................................................................................... 11
4.1 Scope of Delivery ............................................................................................. 11
4.1.1 Static Files ....................................................................................... 11
4.1.2 Dynamic Files .................................................................................. 11
4.2 Compiler Abstraction and Memory Mapping ..................................................... 12
5 API Description CddPduRUpperLayerContribution as IF ........................................ 13
5.1 Services used by <CDD> ................................................................................. 13
5.2 Callback Functions ........................................................................................... 13
5.2.1 <CDD>_RxIndication ....................................................................... 13
5.2.2 <CDD>_TxConfirmation ................................................................... 14
5.2.3 <CDD>_TriggerTransmit .................................................................. 14
6 API Description CddPduRUpperLayerContribution as TP ....................................... 16
6.1 Services used by <CDD> ................................................................................. 16
6.2 Callback Functions ........................................................................................... 16
Technical Reference MICROSAR Complex Device Driver
© 2021 Vector Informatik GmbH Version 4.00.00 4
based on template version 5.2.0
6.2.1 <CDD>_StartOfReception ................................................................ 16
6.2.2 <CDD>_CopyRxData ....................................................................... 17
6.2.3 <CDD>_TpRxIndication ................................................................... 18
6.2.4 <CDD>_CopyTxData ....................................................................... 19
6.2.5 <CDD>_TpTxConfirmation ............................................................... 20
7 API Description CddPduRLowerLayerContribution as IF ........................................ 21
7.1 Services provided by <CDD> ........................................................................... 21
7.1.1 <CDD>_Transmit ............................................................................. 21
7.1.2 <CDD>_CancelTransmit .................................................................. 22
7.2 Services used by <CDD> ................................................................................. 22
8 API Description CddPduRLowerLayerContribution as TP ...................................... 23
8.1 Services provided by <CDD> ........................................................................... 23
8.1.1 <CDD>_Transmit ............................................................................. 23
8.1.2 <CDD>_CancelTransmit .................................................................. 24
8.1.3 <CDD>_CancelReceive ................................................................... 25
8.1.4 <CDD>_ChangeParameter .............................................................. 26
8.2 Services used by <CDD> ................................................................................. 26
9 API Description CddComIfUpperLayerContribution ................................................ 27
9.1 Services used by <CDD> ................................................................................. 27
9.2 Callback Functions ........................................................................................... 27
9.2.1 <CDD>_RxIndication ....................................................................... 28
9.2.2 <CDD>_TxConfirmation ................................................................... 28
9.2.3 <CDD>_TriggerTransmit .................................................................. 29
10 API Description CddJ1939RmContribution .............................................................. 30
10.1 Services used by <CDD> ................................................................................. 30
10.2 Callback Functions ........................................................................................... 30
10.2.1 <CDD>_RequestIndication............................................................... 31
10.2.2 <CDD>_AckIndication ...................................................................... 31
10.2.3 <CDD>_RequestTimeoutIndication .................................................. 32
11 API Description CddSoAdUpperLayerContribution ................................................. 33
11.1 Services used by <CDD> ................................................................................. 33
11.2 Communication Interface Callback Functions .................................................. 34
11.2.1 <CDD>_[SoAd][If]RxIndication ......................................................... 34
11.2.2 <CDD>_[SoAd][If]TxConfirmation .................................................... 35
11.2.3 <CDD>_[SoAd][If]TriggerTransmit .................................................... 36
11.3 Transport Protocol Callback Functions ............................................................. 37
11.3.1 <CDD>_[SoAd][Tp]StartOfReception ............................................... 37
Technical Reference MICROSAR Complex Device Driver
© 2021 Vector Informatik GmbH Version 4.00.00 5
based on template version 5.2.0
11.3.2 <CDD>_[SoAd][Tp]CopyRxData ...................................................... 38
11.3.3 <CDD>_[SoAd][Tp]RxIndication ....................................................... 39
11.3.4 <CDD>_[SoAd][Tp]CopyTxData....................................................... 40
11.3.5 <CDD>_[SoAd][Tp]TxConfirmation .................................................. 41
12 Configuration .............................................................................................................. 42
12.1 Configuration Variants ...................................................................................... 42
13 AUTOSAR Standard Compliance............................................................................... 43
13.1 Deviations ........................................................................................................ 43
13.2 Additions/ Extensions ....................................................................................... 43
13.3 Limitations........................................................................................................ 43
14 Glossary and Abbreviations ...................................................................................... 44
14.1 Glossary .......................................................................................................... 44
14.2 Abbreviations ................................................................................................... 45
15 Contact ........................................................................................................................ 46
