ADTF Devicetoolbox
ADTF Devicetoolbox
ADTF Devicetoolbox
Technical support
Phone: +49-9131-7701-7777
http://automotive.elektrobit.com/support
c 2019 Elektrobit Group Plc., Erlangen
Contents
1. Toolbox 9
1.1. Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.2. Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.3. Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.4. Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
1.5. Remarks regarding system configurations . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.6. Implementation specific restrictions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1.7. Driver version check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
1.8. Special text formats and symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
3. CAN 30
3.1. Vector CAN XL Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.1.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.1.2. Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.1.3. Filter GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
3.1.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.1.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
3.2. Vector CAN XL Sender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2.2. Platform Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2.3. Filter GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3
Contents
3.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
3.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3. Peak CAN Receiver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
3.3.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.3.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
3.4. Peak CAN Sender . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.4.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.4.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.4.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.4.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
3.5. CAN Legacy Filter In . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.5.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.5.2. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.5.3. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
3.6. CAN Legacy Filter Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.6.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.6.2. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.6.3. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
3.7. Can Config Codec Ext . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.7.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.7.2. Decode CAN Messages with CCCExt . . . . . . . . . . . . . . . . . . . . . . . . 40
3.7.3. Encode CAN Messages with CCCExt . . . . . . . . . . . . . . . . . . . . . . . . 41
3.7.4. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.7.5. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
3.7.6. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
3.7.7. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.7.8. Media Description Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
3.7.9. Extensibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
3.7.10. Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.8. Can Config Codec Ext—Signal Configurator . . . . . . . . . . . . . . . . . . . . . . . . 48
3.8.1. CAN Specific Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
3.9. Can Config Codec (XML-CanCodec) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.9.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
3.9.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.9.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
3.9.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.9.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.9.6. Limitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
3.10.CAN Trace View Extended Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.10.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.10.2. CAN Trace Tree View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
3.10.3. CAN Trace List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
3.10.4. Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4
Contents
4. LIN 56
4.1. Vector LIN Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.1.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.1.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.1.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
4.1.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.1.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2. LIN Config Codec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
4.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
4.3. LIN Config Codec—Signal Configurator . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.3.1. LDF4Channel Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
4.4. LIN Trace View Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.4.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.4.2. LIN Trace Tree View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
4.4.3. LIN Trace List View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
4.4.4. Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
5. FlexRay 66
5.1. Support of several FlexRay Networks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
5.2. VectorFlexrayDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
5.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
5.2.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
5.2.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
5.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
5.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
5.3. FlexCardDevice . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.4. FlexRay ECU Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.4.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.4.2. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.4.3. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
5.4.4. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.5. FlexRay Trace View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.5.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.6. FlexRay Signal Provider . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.6.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.7. FlexRay Config Codec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.7.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.7.2. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.7.3. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.7.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
5.8. FlexRay Config Codec—Signal Configurator . . . . . . . . . . . . . . . . . . . . . . . . 77
5.8.1. FlexRay Specific Differences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
5.8.2. Special issues on decoding or encoding a FlexRay signal . . . . . . . . . . . . . 78
5.9. FlexRay DAT Exporter Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5
Contents
6. MOST 81
6.1. Vector MOST Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.1.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.1.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.1.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
6.1.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
6.1.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
6.2. OptoLyzer G1 MOST Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.2.1. description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.2.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.2.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
6.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
6.3. OptoLyzer G2 MOST Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
6.3.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
6.3.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6.3.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6.3.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
6.3.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
6.4. MOST Support Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
7. Ethernet 89
7.1. Ethernet Device UDP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.1.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
7.1.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.1.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.1.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
7.1.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.2. Ethernet Device TCP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
7.2.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
7.2.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
7.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
7.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
8. Camera 94
8.1. General Video Capture Device Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
8.2. Blue Fox Capture Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
8.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
8.2.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
8.2.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
8.2.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
8.2.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
8.3. Direct Show Video Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8.3.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8.3.2. Platform support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8.3.3. Filter-GUID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8.3.4. Pins . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
8.3.5. Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
6
Contents
7
Contents
8
Device Toolbox – EB Assist ADTF
1 Toolbox
This is the documentation of the ADTF Device Toolbox. The toolbox provides filters to connect several
external communication system devices to A D T F.
For Device-Toolbox-Programming have a look at the ADTF Device Toolbox SDK Documentation. You will
find it in the doc directory within your Device Toolbox installation directory.
1.1 Requirements
Documentation about the FlexRay protocol can be obtained from the FlexRay consortium (www.flexray.
com). Documentation about the FIBEX format can be obtained from the “Assaociation for Standardization
of Automation and Mesauring Systems” (www.asam.net).
1.2 Installation
Any previously installed ADTF FlexRay Toolbox has to be uninstalled prior to installing this
ADTF Device Toolbox!
If you are using ADTF on a Windows 7 operating system, you should not install it into the
“ProgramFiles” or any other “System” directory. Because of the user account control (UAC)
you have to have administrative privileges to run CMake and/or the batch-file to build the
examples. If you don’t have these privileges, the build will fail every time.
1.3 Licensing
The ADTF Device Toolbox does only run with a valid toolbox flag in your A D T F license. If the needed
feature flag is not set, the Plugins will not be loaded.
There is no warning that the needed flag could not be found in the given license file while
starting A D T F except in the ADTF DebugMonitor.
1.4 Templates
A Device Toolbox Project bases on a template. These templates are standard Configurations that ease
the creation of new Projects with the devices of the ADTF Device Toolbox. Each Configuration can also
be used as a template. An overview of available templates is provided in Table 1.1 Description of the
templates.
Toolbox is delivered with an example test file example_test_file_can.dat. Example file contains
video and CAN data (tCANData) streams. Both data types are described in DDL file
example_test_file_can.dat.description. Please see the ADTF SDK Documentation for
details on the tCANData structure. Both files are located in ADTF bin/templates directory.
Template Description
BlueFox There are also Three Configurations (Live, Playback, Recording) with the
corresponding Filters for the recording, playback and live viewing of video
data from a camera via Matrixvision BlueFox API.
CanConfigCodecExt Template for the usage of the CanConfigCodecExt Filter, the TableDisplay and
the Random Number Generator (the code of last two Filters can be found in
the ADTF installation in the example folder. The Filters have to be build first).
VectorCANDevice Three Configurations (Live, Playback, Recording) with the corresponding Fil-
ters Vector_CAn_XL_Receiver and Vector_CAN_XL_Sender for the recording
and playing the CAN Data from a Vector CAN card (CANcardX or CANcardXL).
Receiving FlexRay data consumes noteworthy processing power. To minimize the probability of data loss
it is recommended to use a system with a dual-core CPU at least. Although the priority of the thread
handling communication with the FlexRay hardware is set to the highest value, data loss can occur during
heavy system load.
If FlexRay data is to be sent the requirements on response time are even higher. The thread responsible
for sending the data to the FlexRay hardware has to react to each cycle start event. When this event is
received from the device, the data of the next cycle has to be sent to the FlexRay hardware. Any delay
during this process may lead to transmission of erroneous data on the FlexRay bus. It is recommended
to use a PCI-card device for sending FlexRay data, since devices connected via USB induce higher delay
and system load.
FIBEX standard versions 1.2.0, 2.0.1, 3.0.x and 3.1.x are supported with the following restrictions:
I Signals using text-table coding rules ar not supported. They are handled like integer values.
I A signal may only be aggregated in one frame; otherwise the decoding/coding is ambiguous.
I A cell in the dynamic segment has to be reserved for only one ECU.
I FIBEX XML files have to use the ASCII character-set. If UTF-8 is used non-ASCII characters will
not be recognized correctly.
I The redundant sending of PDUs/Frames on both FlexRay Channels simultaneously is currently not
supported. You can work around this limitation by manually sending them on both channels. To
do so with the help of the FlexRay Config Codec add two Pins with the same layout but use the
Signals from the PDUs of the different Channels. Then connect your Filter to both input Pins. Note
that timing limitiations may lead to data inconsistencies between the two Channels.
CAN restrictions:
I Please keep in mind that there will be a null-terminated string in use and the last character is
reserved for the null character ’\0’. Consequently the message- and signal-names can only have
MAX_SIG_LEN - 1 characters.
Every device in the ADTF Device Toolbox has been tested with a specific set of drivers. All device Filters
will check on initialization if a tested driver is used. If this requirement is not fulfilled, the Filter will interrupt
the initialization and display an error message. All Filters have a Property to disable this interruption.
For detailed information about the tested driver versions, each device provides a subsection
Platform Support.
For the using of Vector Devices it is necessary that they are part of the XL Driver Library
(current used version is 9.8.1.0). Only Vector Devices which are part of this API could
be supported by the ADTF Device Toolbox. For further information please refer to http:
//www.vector.com/.
This software guide uses special text formats and symbols to indicate important elements and facts, as
shown here:
URLs: www.url.com
inline code
Source code
Properties
Proper names
The ADTF Signal Config application is used to select elements of database files. This can be *.dbc
(CAN), *.xml (FlexRay) or *.ldf (LIN) files.
Selected elements can be processed to configuration files for ADTF Filters like the Can Config Codec
(abbreviated CCC), the Can Config Codec Ext (abbreviated CCCExt, see section 3.7 Can Config Codec
Ext), LIN Config Codec (abbreviated LCC, see section 4.2 LIN Config Codec) and the FlexRay Config
Codec (abbreviated FCC, see section 5.7 FlexRay Config Codec). Existing configurations for CCC,
CCCExt, LCC and FCC can be imported from XML files.
Additionally existing structs and buffers from header files (see section 2.4 Header menu) can be imported
and changes can be returned. A validation of the configurations is also possible.
The filters Can Config Codec Ext, LIN Config Codec, FlexRay Config Codec and Can Config Codec have
an adjusted context menu. So if you click on the Filter you will see the context menu (for example the
CCCExt was taken) shown in Figure 2.1 Context menu of the CCC Ext.
If the menu Edit Properties with ADTF Signal Config Filter Editor for CCCExt is selected then the
dialog in Figure 2.2 Signal Configurator of CCC Ext is opened. Initially all database files found in the
Global Configuration Settings and Configuration Settings are loaded in Databases. The Configuration
File of the selected Can Config Codec Ext Filter is opened in Configuration.
In this dialog you can add one or more databases using the menu point File → Add Database . . . . Then
using the File → New Config . . . menu point you can create a new Buffer Configuration file. You will get
the nodes Input Pins and Output Pins in the second tree. With a right click on one of those nodes you
can add a new Pin on which you can now drag one or more signals of a database.
Now you can close the dialog by clicking on the button Ok. All database files loaded in Databases will
be stored in the Configuration Settings if they are not already stored in the Global Configuration Settings.
The currently opened Configuration File in Configuration will be used by the selected Config Codec
Filter.
With the help of the file menu (see Figure 2.3 File menu of the Signal Configurator) Configuration files
and database files are handled.
I New Config: A new and empty Configuration file will be generated. The configuration tree will be
empty.
I Open Config: An existing Configuration file can be opened. The content of the file will be inserted
in the configuration tree.
I Save Config: The current content of the configuration tree will be saved in the currently loaded
Configuration file.
I Save Config as: The current content of the configuration tree will be saved in a new Configuration
file.
I Add Database: An existing database file (e.g. .dbc) has to be selected. The content of the
database file will be added to the databases tree as a new node.
With the mode menu (see Figure 2.4 Mode menu of the Signal Configurator) additional operations can be
executed.
I Link Mode: The link mode can be (de-)activated. With activated link mode it is possible to relink
existing structure elements in the configuration tree to another database signal. If the link mode is
I Check . . . : The current configuration will be checked. If an error is detected then this is either
shown in a message box or a log file will be generated.
Using the Header → Save Header . . . menu point you can create a C++ header file, which maps the
pins and structs shown in Configuration.
typedef struct
{
tInt32 ESP_v_Signal; // signal=RawDataChannel_Tr$idx$.CycleCounter_Tr$idx$;
tUInt8 PSD_Endkruemmung; // signal=PSD_01.PSD_Endkruemmung;
} tStruct0;
typedef struct
{
tStruct0 sStruct0[90];
} tTest_output;
The comment
// signal=PSD_01.PSD_Endkruemmung;
is optional. Besides of signal you can also specify the signed signal:
// signal=PSD_01.PSD_Endkruemmung; sign_signal=PSD_Endkruemmung_Vorz;
The following line indicates an array, see Figure 2.5 Signal Configurator—Array of Structs).
tStruct0 sStruct0[90];
To import structs from a header file see section 2.6 Configuration tree.
A struct is saved under the same name and has a “t” as prefix. If a struct is imported and it
has a “t” at the beginning, then the “t” is considered as a prefix and will be omitted.
The typedef struct statement must have the same appearance as shown in the example
above to be imported correctly.
In the Databases Tree all added database files are shown as own nodes. The messages and signals
included in the added database files are shown in nodes within the according database node. If you have
set any databases (DBC-Files, LDF-Files or XML-Files) in one of the properties DBCFiles4ChannelX,
flexray_fibex_filename or LDF4ChannelX (Global Configuration Settings -> Bus -> (CAN, FlexRay, LIN,
MOST), the Signal Configurator will load these files to the Databases Tree.
The Signal Config Filter Editor takes all settings from the globals.xml and puts them to
the system.xml. If the pathes of the files are absolute, they will be kept absolute. If using
MACROS they will be kept also. If the pathes are defined relative (to the globals.xml), they
will be extended with the $GLOBALSDIR$ -Macro.
With the help of the edit field on top of the tree the messages and signals can be filtered. The field works
comparable to an InStr() search. So all messages and signals which have the input character sequence
in their names are displayed. All others are hidden.
I Add Database . . . : An existing database file has to be selected. The content of the file will be
added to the databases tree as new node.
I Input Pins and Output Pins: With a right click on this node there is the possibility to add a new Pin
to the selected node by selecting the menu point Add Input Pin or Add Output Pin.
• one trigger: A trigger can be added with the context menu point Add Trigger which
appears by right clicking on the Pin node.
• one or more signals: Signals can be added to a created Pin by dragging signals from the
database to the wished Pin.
• one or more items: Any child item, which does not necessarily has to be a signal, can be
added to a Pin (or a structure).
• one or more structures: There is the possibility to create more than one structure for a
selected Pin. To do so a right click on the Pin node has to be performed and the menu
point Add Struct has to be selected. A structure can contain one or more structures.
Signals or items are always stored within a struct. A pin can have one or more structs. If
you create a new pin, you can add items or signals to the pin. In this case the pin has one
single struct. Although it is not visible, it contains the items and signals you’ve justed added.
The struct becomes visible, if you define a second struct. After that, even if you remove the
second struct, the first struct will remain visible anyway.
An Input Pin is saved as an Output Pin in the Buffer Configuration file and vice versa.
Using the context menu Import Structs . . . , structs can be imported from a C++ header file.
The configuration value table on the right of the dialog (see Figure 2.2 Signal Configurator of CCC Ext)
shows additional information for:
I Database
I Pin
I Structure
I Trigger
I Signal
If the link mode is activated, multiple selection is deactivated in Databases. A database signal can be
dragged to Configuration and replaces a signal.
This section describes the available properties in the Signal Configuration Editor.
2.9.1 InputPin/OuputPin
timestamp $FIRST$ yes Specifies when and how the time stamp
$LAST$ is set for the decoded data:
$MEAN$ $FIRST$: time stamp of the first valid
message message in the cycle for this buffer
name $LAST$: time stamp of the last mes-
sage in the cycle before the data of this
buffer is sent.
$MEAN$: average value of the
$FIRST$ and $LAST$ time stamp
MessageName: time stamp of the cor-
responding message is used if this is
received (otherwise 0)
2.9.2 Struct
The struct node defines a specific C-structure, whose elements can be filled with decoded signals, macros
or just nothing. A buffer node can contain multiple structs with different attributes (array, pack, etc.). When
creating the structures, special care must be taken that the "pack" specification matches the #pragma
pack (see Microsoft Visual Studio help) of the C-structure so that the alignment of the individual structure
elements fits! By default in Visual Studio, a #pragma pack(8) is set.
array_format format speci- yes printf format specifier for the array in-
fier dex.
The alignment of the base types depends on the compiler used. The Microsoft compiler
uses an alignment value equal to the size of the type e.g. 8 for a "double" value. GCC uses
a 4 byte alignment for all 64 bit types. For "#pragma pack"-values larger than 1, this can
lead to a different memory layout of the structure!
2.9.3 Element
It is not possible to send signals of he same message but in different multiplexes in one
buffer.
2.9.4 Triggers
The optional trigger specifies when a decoding cycle begins and when it ends. If no such node exists,
all appropriate messages are decoded and, if all messages required for the buffer were received, the
MediaSample is sent. During this step multiplexed signals are treated just as signals from different
messages, i.e. all needed multiplexes of a message must have been received to trigger a transmit. By
setting the stop_valid_signal to the multiplexor it is possible to trigger the buffer transmission on specific
multiplexes. The stop trigger can be composed of a stop message (with an optional valid condition) and a
timeout.
Macros allow the user to extend input or output data with algorithmically generated content such as
checksums or counters. The CanConfigCodecExt ships with a number of built in macros which shall be
described in this section. It is possible to extend the macro functionality with user generated macros, for
further information see "Conversion of Old CanConfigCodecExt Macros" in the ADTF Device Toolbox
SDK Documentation.
Element Macros Element macros generate content for a buffer element or can signal. To use an element
macro you need to select a macro from the dropdown list in the macro property, additional attributes may
be required to provide data to a macro implementation. Macros have a direction, which means that they
can be used for input or ouput data.
$CONSTANT$ value Input None The $CONSTANT$ macro fills the el-
Ouput ement with a constant numeric value
provided by the attribute "value".
$TIMESTAMP$ message| Input tInt64 Fills the element with a timestamp. The
signal source of the timestamp can be a mes-
sage or a signal.
$HARDWARETIME$ message| Input tUInt64 Fills the element with a devices’ hard-
signal ware timestamp. The source of the
timestamp can be a message or a sig-
nal.
$CURRENT_TIME$ message| Input tInt64 Fills the element with IO time of the
signal mediasample. The source of the times-
tamp can be a message or a signal.
$CURRENT_TIME_ message| Input tFloat64 Fills the element with IO time of the
SEC$ signal mediasample in seconds. The source
of the timestamp can be a message or
a signal.
$MSG_TIMESTAMP$ message| Input tInt64 Fills the element with the received Me-
signal diasample timestamp.
$MSG_TIMESTAMP_ message| Input tFloat64 Fills the element with the received Me-
SEC$ signal diasample timestamp in seconds.
$IF_RECEIVED$ message| Input none Fills the element with the content of
signal + "value" if a message or signal was re-
value ceived and the value of "else" otherwise.
else The attribute "else" is optional and a
value of 0 is used if it is not present.
$RAWVALUE$ signal Input tUInt64 Fills the element with the raw can signal
value.
$CONSTANT$ x x x
$COUNTER$ x x x
$TIMESTAMP$ x x x
$TIMESTAMP_SEC$ x x x
$HARDWARETIME$ x x x
$CURRENT_TIME$ x x x
$CURRENT_TIME_ x x x
SEC$
$MSG_TIMESTAMP$ x x x
$MSG_TIMESTAMP_ x x x
SEC$
$IF_RECEIVED$ x x x
$RAWVALUE$ x x x
$CHECKSUM$ x - -
$MYCHECKSUM$ x - -
$MYRAWVALUES$ - - x
3 CAN
3.1.1 Description
The Vector CAN XL Receiver serves to receive CAN data via the Vector XL Hardware into A D T F.
Vector XL Hardware is hardware that is supported by the Vector XL Driver Library (e.g. CANcardXLe,
CANboardXL, CANcaseXL, VN7600, . . . ).
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.vector.com/.
Windows Linux
adtf.io.vector_can_xl_receiver
3.1.4 Pins
output MEDIA_TYPE_CAN out Output Pin for the received CAN data
MEDIA_SUBTYPE_CAN_DATA
3.1.5 Properties
application_name “ADTF” String The application name as defined by the Vector Hard-
ware tool.
Warning: in ADTF the channels begin with 0, there-
fore, the Vector CAN channel CAN1 matches channel
0 in A D T F!
tx_receipts false Bool If set to “true”, tx receipts will be generated for all
transmitted CAN messages.
add_hardwaretime_info false Bool If “true”, the Device Original Time of a message will
be transmitted with the media sample info area.
VerifyDriverVersion true Bool If “true”, the filter will check if a tested driver version
is used and interrupt initialization if this requirement
is not fulfilled.
WakeUp false Bool If “true”, the device will generate a high voltage
wakeup impulse on the CAN channels.
This filter sends every second a bus status message for each of the device’s can controller,
even there is no data on the bus!
3.2.1 Description
The Vector CAN XL Sender serves to transmit CAN messages via the Vector XL Hardware. Vector XL
Hardware is hardware that is supported by the Vector XL Driver Library (e.g. CANcardXLe, CANboardXL,
CANcaseXL, VN7600, . . . ).
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.vector.com/.
Windows Linux
adtf.io.vector_can_xl_sender
3.2.4 Pins
3.2.5 Properties
application_name “ADTF” String The application name as defined by the Vector Hardware
tool.
Warning: in ADTF the channels begin with 0, therefore,
the Vector CAN channel CAN1 matches channel 0 in
A D T F!
VerifyDriverVersion true Bool If “true”, the filter will check if a tested driver version is
used and interrupt initialization if this is requirement is not
fulfilled.
WakeUp false Bool If “true”, the device will generate a high voltage wakeup
impulse on the CAN channels.
Starting with Device Toolbox 2.3.0 the Vector CAN XL Device is marked as deprecated and
will not be supported any more ! Starting with the Device Toolbox 2.4.0 the Vector CAN XL
Device is removed completely from the Toolbox. Please use the Vector CAN XL Receiver
and Vector CAN XL Sender instead!
3.3.1 Description
The Peak CAN Receiver serves to receive CAN raw data via the Peak Hardware into A D T F.
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.peak-system.com/.
Windows Linux
The device has been tested with the driver in the The device has been tested with the driver in the
version 3.13.0.15462. version 7.14.0.0.
3.3.3 Filter-GUID
adtf.io.peak_can_receiver
3.3.4 Pins
output MEDIA_TYPE_CAN out Output Pin for the received CAN raw data
MEDIA_SUBTYPE_CAN_DATA of the hardware.
3.3.5 Properties
channel_id 0 int This device supports only a single CAN channel. All
mesages will be given to this channel ID (in the tCANData
structure). Please see the ADTF SDK Documentation for
details on the tCANData structure.
If a Peak CAN Sender with the same devicename is active,
this Property has to be set to the same value in both Filter
configurations!
add_hard- false bool If true, the Device Original Time of a message will be trans-
ware- mitted with the MediaSample in info area.
time_info
VerifyDriver- true bool If “true” the Filter will check if a tested driver is used and
Version interrupt initialization if this requirement is not fulfilled.
On Windows, the Peak CAN Device has to be connected to the computer before starting
A D T F. Otherwise A D T F cannot detect it correctly!
This filter sends a bus status message each second, even there is no data on the bus!
3.4.1 Description
The Peak CAN Sender serves to transmit CAN messages via the Peak hardware.
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.peak-system.com/.
Windows Linux
The device has been tested with the driver in the The device has been tested with the driver in the
version 3.13.0.15462. version 7.14.0.0.
3.4.3 Filter-GUID
adtf.io.peak_can_sender
3.4.4 Pins
output MEDIA_TYPE_CAN out Output Pin for the received CAN raw data
MEDIA_SUBTYPE_CAN_DATA of the hardware.
3.4.5 Properties
channel_id 0 int This device supports only a single CAN channel. Only
CAN messages with this channel ID will be forwarded to
the CAN bus.
If a Peak CAN Receiver with the same devicename is
active, this Property has to be set to the same value in
both Filter configurations!
devicename “default” String For Windows: see Table 3.9 Properties of the Peak CAN
Receiver
For Linux: Name of the Peak CAN Device, e.g.
/dev/pcan32
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is used and
interrupt initialization if this requirement is not fulfilled.
On Windows, the Peak CAN Device has to be connected to the computer before starting
A D T F. Otherwise, A D T F cannot detect it correctly!
Starting with Device Toolbox 2.3.0 the Peak CAN Device and Peak CAN Device Basic are
marked as deprecated and will not be supported any more ! Starting with the Device Tool-
box 2.4.0 the the Peak CAN Device and Peak CAN Device Basic are removed completely
from the Toolbox. Please use the Peak CAN Sender and Peak CAN Receiver instead!
3.5.1 Description
The Filter transforms legacy CAN data to the new CAN data format.
3.5.2 Filter-GUID
adtf.io.can_legacy_in
3.5.3 Pins
In Device Toolbox 2.3.x and lower there is a bug at conversion of the extended CAN
message identifiers in the CAN Legacy Filter Out. This causes corrupt message identifiers
in the legacy extended can data. Unfortunately there is no suitable way to recover extended
can identifier, which are processed with this filter and recorded. Because of the bug bit 27 is
removed from the identifier instead of bit 31 (see ADTF Device Toolbox SDK Documentation
tCANData::MSG_EXTENDED_FLAG for more information). Hence the bit was removed the
resulting identifier in legacy extended can data is ambiguous.
3.6.1 Description
The Filter transforms new CAN data (tCANData) to the legacy CAN data format (tCanMessage/tCanMes-
sageExt).
3.6.2 Filter-GUID
adtf.io.can_legacy_out
3.6.3 Pins
3.7.1 Description
The Can Config Codec Ext Filter decodes and encodes raw CAN data (as its predecessor Can Config
Codec). The Can Config Codec Ext knows no previously specified C structures, but only storage ranges
that are filled via the decoding instructions specified in an individual configuration file. This process is
extendible via the interface ICanDynamicMacro.
During decoding (CAN input), the raw CAN messages (e.g. from the Peak CAN Device, Vector CAN
Device and Harddisk Player ) are read in via the Pin “input” into the Filter and then decoded with the help
of DBC files and a configuration file, that maps CAN signals to locations in a buffer.
Here for each configured input buffer of Can Config Codec Ext, an individual Output Pin is generated,
which is used to forward the data to other Filters. These can transform the data into the corresponding C
structures using casts. The Output Pin has the same name as the corresponding input buffer.
The requested signals are converted into the appropriate SI unit if the DBC file specifies a valid (and
known) physical unit (e.g. [km/h] → [m/s]). The supported unit strings are listed in the ADTF SDK
Documentation of the class cUnitConversion.
During encoding (CAN output) raw data structures are read in via an Input Pin with the name of the
corresponding buffer. These structures are converted into CAN messages according to the output
configuration, which maps buffer locations to CAN signals. Then the generated CAN messages are
forwarded to the Pin “output”. For these output buffers a configurable timer allows to send the generated
messages repeatedly.
Data structure elements can also be filled with macros with constant values or time stamps instead of
decoded signals.
The decoding of CAN messages will be shown on the basis of the following example.
Message 1: S1 # S2 S3 #
Message 2: S1 S2 S3 S4 #
The messages are filled with Signals. The symbol ’#’ means, that there is no signal at this part of the
message. In the following, a Signal i of message j will be written as Messagej_Si.
With the help of the CCCExt a decode buffer can be defined, that includes signals of any CAN message.
If the CCCExt receives these messages, it will fill the buffer and write it to a media sample and transmit it.
A look at figure 3.1 shows how it works. The buffer that should be transmitted, contains all signals of
message 1 and message 2. At time t = 0 the CCCExt has received message 1. At time t = 1 message
2 has arrived and the CCCExt will fill the media samle and transmit it.
Sometimes a media sample is transmitted/triggered at specific times (see: 2.9.4). If, for
example message 2 has not arrived before the sample is triggered, all signals of message
2 will be set to their default values. The default values are taken from the DBC file. You can
also set your own default value in this case, with the help of the Signal Configurator 3.8.
The encoding of CAN messages will also be shown on the basis of the previous example. At first, have a
look at figure 3.2.
With the help of the CCCExt a encode buffer can be defined, that includes signals of any CAN message.
If the CCCExt receives a media sample belonging to this buffer, it will create all CAN messages that
contain signals of the buffer and transmit it. A look at figure 3.2 shows how it works. The buffer contains
two signals of message 1 and two signals of message 2. Since Message1_S1, Message2_S3 and
Message2_S4 can not be filled with values, they will be set to their default values defined in the DBC
file.
Every bit of a CAN message, that does not belong to a signal will be set to zero.
Windows Linux
X X
3.7.5 Filter-GUID
adtf.io.can_config_codec
3.7.6 Pins
3.7.7 Properties
Automatic SI Unit false bool If “true”, every signal with a known unit is automatically
Conversion [Auto- converted to its SI unit.
CalcUnitToSI] This behaviour is overridden signal-specifically by the con-
figuration file. This Property defines the default behaviour.
Create Media true bool This allows you to disable the generation of media de-
Descriptions scriptions for the buffer pins. If these become rather large
[create_media- ( > 10000 Signals) this can be a very time consuming step.
_descriptions] A media description is only created for input buffers (Out-
put Pins)! Output buffers (Input Pins) of the Can Config
Codec Ext have no media description.
Default CAN 0 int Default channel for CAN I/O. this behaviour is overidden
Channel [de- by configuration file.
fault_channel]
Dump Buffer false bool Print sizes of encoded/decoded data structures (for de-
Layout bugging issues)
[show_struct_info]
Dump Sig- false bool Dump all signal values to ConsoleView (for debugging
nal Updates issues)
[dump_signal_up-
dates]
Handling of Signal ignore string How should the Codec handle a signal’s min/max value
Limits of Database from database during encoding messages ?
[LimitHandlingPol- The following options are supported:
icy] ’ignore’ (default) Do not do anything, treat limits as com-
ments.
’clip’ Silently clip the signal to the violated boundary.
’warn’ Send the signal as is, but issue a log warning.
This behavior is signal-specifically overridden by the con-
figuration file. This Property defines the default behavior.
Ignore Error Mes- false bool Ignore incoming CAN error messages.
sages [ignore_er-
ror_messages]
Skip irrele- true bool Checks each incoming CAN message for relevance be-
vant messages fore processing. Increases performance if only a few
[skip_irrelevant_me- messages are needed. Disable this check, if most of the
ssages] messages are configured. The transmitted data field will
be filled with zeros
Device Toolbox – EB Assist ADTF 45
If the property Create Media Descriptions is set to “true”, the Can Config Codec Ext Filter will create a
Media Description for the configured Output Pins of following format:
Two structs, one for the Output Pin and one for its struct:
. name: t<name_of_filter>_<name_of_output_pin>
• name: struct_<index>
• type: “struct2”
. name: t<name_of_filter>_<name_of_output_pin>_struct_<index>
. contains element with the name and the type of the configured signal (mapped to database)
in Can Config Codec Ext Filter
I name: <name_of_output_pin>
. name: “struct1”
. type: “struct1”
Example:
<structs>
<struct
alignment="1"
name="tCAN_Config_Codec_Ext_outPin"
version="1">
<element
alignment="8"
arraysize="1"
byteorder="LE"
bytepos="0"
name="struct_0"
type="tCAN_Config_Codec_Ext_outPin_struct_0"
/>
</struct>
<struct
alignment="8"
name="tCAN_Config_Codec_Ext_outPin_struct_0"
version="1">
<element
alignment="8"
arraysize="1"
byteorder="LE"
bytepos="0"
name="ESP_v_Signal"
type="tFloat64"
/>
</struct>
</structs>
<streams>
<stream
description="streamid_1"
name="outPin"
type="adtf.core.media_type">
<struct
bytepos="0"
name="tCAN_Config_Codec_Ext_outPin"
type="tCAN_Config_Codec_Ext_outPin"
/>
</stream>
</streams>
3.7.9 Extensibility
The Can Config Codec Ext Filter is extendable with the help of the interface ICanDynamicMacro.
There is an example which presents a macro that calculates the known XOR checksum for a CAN
message. This example can be found in /src/example/src/can_macro_checksum. The
macros are always addressed with the “macro” attribute of a buffer element.
3.7.10 Limitation
CAN messages with identifier set to 0 are not supported and will never be decoded because CAN
message identifier 0 is internally used by the Can Config Codec Filter to mark invalid CAN identifiers.
The CAN Config Codec Ext has an adjusted context menu. If the menu Edit Properties with ADTF
Signal Config Filter Editor for CCCExt is selected, then the ADTF Signal Config Filter Editor is opened.
The editor works almost the same way as the editors for the FlexRay Config Codec and LIN Config
Codec. For detailed information see chapter 2 Config Codec—Signal Configurator. The CAN specific
differences are demonstrated here:
Element Properties
The property default_value is only available for the Can Config Codec Ext:
DBCFiles4Channel Properties
You can adjust the channel id of a database by selecting a database node (see Figure 3.3 Signal
Configurator—Set database channel).
The DBCFiles4ChannelX properties are available in Global Configuration Settings -> Bus -> CAN and
also in the Configuration Properties (Property Browser ). How the Signal Config Editor handles global
and local DBCFiles4ChannelX properties is demonstrated with the following example:
. DBCFiles4Channel0 = DBC0.dbc
. DBCFiles4Channel1 = DBC1.dbc
. DBCFiles4Channel2 = DBC2.dbc
. DBCFiles4Channel0 = ""
. DBCFiles4Channel1 = ""
. DBCFiles4Channel2 = ""
I After opening the Signal Config Filter Editor for CCCExt, the Databases Tree will show the three
entries DBC0.dbc, DBC1.dbc and DBC2.dbc. DBC0.dbc is set to channel 0. DBC1.dbc is set to
channel 1. DBC2.dbc is set to channel 2. These databases are loaded into ADTF by opening
the editor. After closing the Signal Config Filter Editor for CCCExt these DBC files are set to the
Configuration’s settings.
I If you change the channel of a DBC File with the Signal Config Filter Editor, these changes will be
taken to the Configuration’s settings. For example, the channel of DBC1 is changed from channel 1
to channel 0. This influences the Configuration’s settings as follows:
. DBCFiles4Channel1 = ""
. DBCFiles4Channel2 = "DBC2.dbc"
I After opening the Signal Config Filter Editor for CCCExt again, you will now see three databases.
. DBC0.dbc on channel 0
. DBC1.dbc on channel 0
. DBC2.dbc on channel 2
You can edit input and output pins of your Can Config Codec Ext Configuration-Files to set the channel-
property to a specific environment variable or ADTF-Macro.
Example: <input channel="$(CANIDMacro)">
Please refer to chapter Overview of the available macros in ADTF in the ADTF SDK Documentation
to get an overview of the available macros in ADTF or how to define your own macro.
3.9.1 Description
This Filter is ouf of date and is not supported anymore. Users are encouraged to use the
Can Config Codec Ext Filter instead.
The Can Config Codec Filter decodes and encodes raw CAN data. The Can Config Codec (abbreviated
CCC) knows no previously specified C structures, but only storage ranges that are filled via the decoding
instructions specified in an individual configuration file.
During decoding (CAN input), the raw CAN messages (e.g. from the Peak CAN Device, Vector CAN
Device and Harddisk Player ) are read in via the Pins “input” or “input_ext” into the Filter and then
decoded with the help of DBC files and the configuration in the configuration file.
Here for each configured input buffer of Can Config Codec, an individual Output Pin is generated, which
is used to forward the data to other Filters. These can transform the data into the corresponding C
structures using casts. The Output Pin has the same name as the corresponding input buffer.
When reading in CAN signals, their values are automatically converted into the appropriate SI unit if a
valid physical unit is specified for the input signal the DBC file (e.g. [km/h] → [m/s]).
During encoding (CAN output) raw data structures are read in via an Input Pin with the name of the
corresponding buffer. These structures are converted into CAN messages according to the output
configuration, which maps buffer locations to CAN signals. Then the generated CAN messages are
forwarded to the Pins “can_output” and “can_output_ext”. For these output buffers a configurable timer
allows to send the generated messages repeatedly.
The data structures except CAN signals can also be described through macros with constant values or
time stamps.
Windows Linux
X X
3.9.3 Filter-GUID
adtf.io.can_config_codec
3.9.4 Pins
3.9.5 Properties
ShowStructInfo false bool Activates the debug outputs for the initialization
AutoCalcUnitToSI false bool If “true” the conversion of the signal values with known units
into the corresponding SI unit is enabled.
3.9.6 Limitation
CAN messages with identifier set to 0 are not supported and will never be decoded because CAN
message identifier 0 is internally used by the Can Config Codec Filter to mark invalid CAN identifiers.
3.10.1 Description
The CAN Trace View Extended Service replaces the standard ADTF Trace View Service (The ADTF
Trace View Service was removed in ADTF 2.9). Apart from general performance improvements this
service is capable of handling the new CAN MediaType as described on the CAN Support Service page
in the ADTF Device Toolbox SDK Documentation. Additionally a second display called the CAN Trace
List View window is available.
The window displays a current snapshot of all CAN messages, which were transmitted by any Pin in the
current Configuration. For each channel the following additional information is displayed (see Figure 3.4
CAN Trace Tree View):
I The count of CAN Error frames (after the first error frame was received)
I The approximately calculated busload of each channel (only if the baudrate is known)
I The Info column contains information about the CycleTime and the current time. The information
about the CycleTime is taken from the database, the current time is the calculated difference
between the timestamps of the last two signals. Normally the current time should not differ more
than 10% from the CycleTime, however a divergence greater than 10% is possible.
The window displays a chronological list of transmitted CAN messages of one Pin in the current Configu-
ration (see Figure 3.5 CAN Trace List View).
The displayed CAN messages can be filtered using three filters: CAN Channel Id, CAN Message Id
and Filter.Pin.
CAN Channel Id and Filter.Pin allows a selection of one or more entries using checkboxes. For example
it is possible to select all messages from channel 00 and channel 01. The CAN Message Id accepts
regular expressions to filter the message number or the name.
The filter settings will be saved if ADTF is closed and restored if restarted again.
The green button in the upper right allows to stop the update of the list, the Configuration will not be
affected by using this option. To enable the update of the view, the button has to be pressed again.
The global Property CANTrace: CAN list view history size defines the count of CAN messages which
can be displayed in the window.
3.10.4 Settings
Via the Settings Editor (see Figure 3.6 Settings for the CAN Trace View) it is possible to specify the font
size and other settings.
The CAN Trace View Extended uses the Global Configuration Settings to decode the messages of the
CAN channels and for the mapping of DBC files to the channel number in A D T F. DBC files which are
configured in the Global Configuration Settings are valid system wide for every loaded Configuration File.
These settings are saved in the Global Configuration Settings File. Configuration Files may set their own
Properties for each Configuration. These specific settings override the Global Configuration Settings.
This can be done with the Configuration Editor (Context menu of the Configuration: Configuration →
Properties).
4 LIN
4.1.1 Description
This Vector LIN Device Filter serves to read the raw LIN data via the Vector hardware into A D T F.
The LDF database filename has to be provided as Property in Global Configuration Settings or in
Configuration Settings (see subsection 4.1.5 Properties).
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.vector.com/.
Windows Linux
4.1.3 Filter-GUID
adtf.io.vector_lin_device
4.1.4 Pins
input MEDIA_TYPE_LIN in The Input Pin is used for LIN data to the
MEDIA_SUBTYPE_LIN bus.
output MEDIA_TYPE_LIN out The Output Pin is used for receiving LIN
MEDIA_SUBTYPE_LIN data from the bus.
4.1.5 Properties
application_name “ADTF” String The application name as defined by the Vector Hardware
tool.
Warning: in A D T F the channels begin with 0, there-
fore, the Vector LIN channel LIN1 matches channel 0 in
A D T F!
ecu_name “Master” String Name of the ECU which parameters are to be used for
LIN Configuration
add_hardware- false bool If “true”, the Device Original Time will be transmitted with
time_info the MediaSample in info area
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is used and
interrupt initialization if this requirement is not fulfilled.
4.2.1 Description
The LIN Config Codec Filter decodes and encodes raw LIN data. For this it uses no previously specified
C structures, but only storage ranges that are filled via the decoding instructions specified in the individual
configuration file.
During decoding (LIN input), the raw LIN messages (e.g. from the Vector LIN Device or the Harddisk
Player ) are read in via the Input Pin and are then decoded with the help of LDF database files and the
configuration in the associated XML file.
For each configured input buffer of the LIN Config Codec an individual Output Pin is generated, which
is used to forward the data to other Filters. These can transform the data into the corresponding C
structures using casts. The Output Pin has the same name as the input buffer.
For encoding (LIN output), data structures are converted into LIN messages according to the output
configuration and are then transferred to the connected LIN device via the Output Pin.
The LDF database filename has to be provided in the Global Configuration Settings or in the Configuration
Settings (see subsection 4.2.5 Properties).
Windows Linux
X X
4.2.3 Filter-GUID
adtf.io.lin_config_codec
4.2.4 Pins
input MEDIA_TYPE_LIN in Input Pin for LIN raw data (e.g. from the
MEDIA_SUBTYPE_LIN LIN Device Filter )
output MEDIA_TYPE_LIN out Output Pin for encoded LIN raw data (e.g.
MEDIA_SUBTYPE_LIN for the LIN Device Filter )
4.2.5 Properties
Automatic SI Unit false bool If “true”, every signal with a known unit is automatically
Conversion [Auto- converted to its SI unit.
CalcUnitToSI] This behaviour is overridden signal-specifically by the con-
figuration file. This Property defines the default behaviour.
Create Media true bool This allows you to disable the generation of media descrip-
Descriptions tions for the buffer pins. If these become rather large ( >
[create_media- 10000 Signals) this can be a very time consuming step. A
_descriptions] media description is only created for input buffers (Output
Pins)! Output buffers (Input Pins) of the Lin Config Codec
have no media description.
Dump Buffer false bool Print sizes of encoded/decoded data structures (for de-
Layout bugging issues)
[show_struct_info]
Dump Sig- false bool Dump all signal values to ConsoleView (for debugging
nal Updates issues)
[dump_signal_up-
dates]
Handling of Signal ignore string How should the Codec handle a signal’s min/max value
Limits of Database from database during encoding messages ?
[LimitHandlingPol- The following options are supported:
icy] ’ignore’ (default) Do not do anything, treat limits as com-
ments.
’clip’ Silently clip the signal to the violated boundary.
’warn’ Send the signal as is, but issue a log warning.
This behavior is signal-specifically overridden by the con-
figuration file. This Property defines the default behavior.
The LIN Config Codec has an adjusted context menu. If the menu Edit Properties with ADTF Signal
Config Filter Editor for LIN Config Codec is selected, then the ADTF Signal Config Filter Editor is
opened. The editor works almost the same way as the editor for the CAN Config Codec Extended and
LIN Config Codec. For detailed information see chapter 2 Config Codec—Signal Configurator. The LIN
specific differences are demonstrated here:
The LDF4ChannelX properties are available in Global Configuration Settings -> Bus -> LIN and also in
the Configuration Properties (Property Browser ). How the Signal Config Editor handles global and local
LDF4ChannelX properties is demonstrated with the following example:
. LDF4Channel0 = LDF0.dbc
. LDF4Channel1 = LDF1.dbc
. LDF4Channel2 = LDF2.dbc
. LDF4Channel0 = ""
. LDF4Channel1 = ""
. LDF4Channel2 = ""
I After opening the Signal Config Filter Editor for LIN Config Codec, the Databases Tree will show
the three entries LDF0.dbc, LDF1.dbc and LDF2.dbc. LDF0.dbc is set to channel 0. LDF1.dbc is
set to channel 1. LDF2.dbc is set to channel 2. These databases are loaded into ADTF by opening
the editor. After closing the Signal Config Filter Editor for LIN Config Codec these LDF files are
set to the Configuration’s settings.
I If you change the channel of a LDF File with the Signal Config Filter Editor, these changes will be
taken to the Configuration’s settings. For example, the channel of LDF1 is changed from channel 1
to channel 0. This influences the Configuration’s settings as follows:
. LDF4Channel1 = ""
. LDF4Channel2 = "LDF2.dbc"
I After opening the Signal Config Filter Editor for LIN Config Codec again, you will now see three
databases.
. LDF0.dbc on channel 0
. LDF1.dbc on channel 0
. LDF2.dbc on channel 2
You can adjust the channel id of a database by selecting a database node (compare with figure Figure 3.3
Signal Configurator—Set database channel of CCCExt).
4.4.1 Description
The LIN Trace View Service provides two trace displays for LIN message analysis during runtime.
This window displays a current snapshot of all LIN messages, which were transmitted by any Pin in the
current Configuration.
This window displays a chronological list of transmitted LIN messages of one Pin in the current Con-
figuration (see Figure 4.2 LIN Trace List View). To select the Pin for which LIN messages should be
dsplayed, the combobox Filter.Pin can be used. By using the combobox LIN Channel Id the displayed
LIN messages can be filtered by a specific channel ID.
The green button in the upper right allows to stop the update of the list, the Configuration will not be
affected by using this option. To enable the update of the view, the button has to be pressed again.
The global Property LINTrace: LIN list view history size defines the count of LIN messages which can
be displayed in the window.
4.4.4 Settings
Via the Settings Editor (see Figure 4.3 Settings for the LIN Trace View) it is possible to specify the font
size and other settings.
The LIN Trace View uses the Global Configuration Settings to decode the messages of the LIN channels
and for the mapping of LDF files to the channel number in ADTF. LDF files which are configured in the
Global Configuration Settings are valid system wide for every loaded Configuration File. These settings
are saved in the Global Configuration Settings File. Configuration Files may set their own Properties for
each Configuration. These specific settings override the Global Configuration Settings.
This can be done with the Configuration Editor (Context menu of the Configuration: Configuration →
Properties).
5 FlexRay
For processing FlexRay data the information about the configuration of the FlexRay bus is required. This
information is stored in a FIBEX file. ADTF FlexRay modules need this file for handling the FlexRay data
and for configuration of the FlexRay devices. The filename has to be provided in the Global Configuration
Settings or in the Configuration Settings (see Table 5.1 General Configuration Settings for FlexRay).
Bus::FlexRay:: DO_NOT_UPDATE enum Defines the behavior of the flexray coder when the
flexray_- update bit is not set on a PDU or signal group.
updatebit_- The ADTF Device Toolbox SDK Documentation
behavior provides additional information about the update
bit behavior and how it can be used in implemen-
tations.
DO_NOT_UPDATE: The coder will not process
the PDU or signal. Data buffers will not be updated
with received values and hence their content is
undefined.
SAMPLE_AND_HOLD: The coder will stick to the
last valid receive value. That means data buffers
are not updated with the reveived values but re-
main in the state of the last valid received PDU/sig-
nal value. Valid denotes in this case the last re-
ceive operation with update bit set.
USE_RECEIVED_VALUE: The coder updates
data buffers with the received values no matter
if the update bit has been set or not.
If you use more than one FIBEX-File, some Clusters, Channels, ECUs, PDUs and Signals can have
the same short name and same ID’s. To make sure that ADTF will not overwrite information of one
FIBEX-File with information from another File, every FIBEX-File must have an unique Project-ID! ADTF
will use this ID to store all internal information and give you the possibility to access signals from a specific
File! Figure 5.1 shows where the Project-ID can be found in a FIBEX-File.
Figure 5.1.: Make sure that each ProjectID is unique, if you want to use more then one FIBEX-File!
The ADTF Device Toolbox supports more than only one FlexRay-Network (Channel A and B). All clusters
defined in the FIBEX-File(s) (see property flexray_fibex_filename) will be parsed and can be used in all
FlexRay modules within ADTF. FIBEX files can contain more than one FlexRay Cluster. All valid clusters
from all files in the property flexray_fibex_filename will be available after parsing.
The Signal string now contains additional information for Cluster-Name and Project-ID. The structure is:
FlexRay-PIN/ClusterName(Project-ID)/Channel-Name/ECU/PDU/Signal
Please use the Vector Hardware Config Tool to map all the connected FlexRay-Devices to Channels.
Afterwards connect the Vector FlexRay Device to these channels (Networks) with the following steps:
I Set the Property DeviceID of the Vector FlexRay Device to a comma-seperated list of Device ID’s.
I Each ID connects the Device-Filter to a FlexRay Network provided by the Vector Hardware Config
Tool.
I Example: 0,2,5 - The Device Filter will work with the Devices mapped to Channel 1,3 and 6. Each
Channel is a Cluster/Network within ADTF and contains Channels A,B or A and B
I Please enter the Cluster name for each ’DeviceIDXClusterName’-Property in the Property Browser.
I The FlexRay Signal Provider registers all Signals to the Signal Registry. Use the Signal View
from ADTF Display Toolbox to make signals of different FlexRay Networks and Channels A and B
visible.
I The FlexRay Trace View shows a tree of all PDU’s from all used Networks.
I The FlexRay Vector Device can handle several FlexFray Networks with different cluster configura-
tions.
I The FlexRay Config Codec can handle several FlexFray Networks and both channels A and B.
The ADTF Device Toolbox provides several FlexRay modules for ADTF. These modules are documented
in the following sections.
5.2 VectorFlexrayDevice
5.2.1 Description
This Filter enables the communication with the FlexRay hardware from Vector Informatik (VN3300,
VN3600, and VN7600).
Windows Linux
5.2.3 Filter-GUID
adtf.io.vector_flexray_device
5.2.4 Pins
Output MEDIA_TYPE_FLEXRAY out The Output Pin is used for receiving data
MEDIA_SUBTYPE_FLEXRAY from the bus.
5.2.5 Properties
ColdStart False Bool Set this Property to “true” to allow the device to
initialize the cluster communication. [optional]
ColdStartSlotId 0 Integer FlexRay slot ID for cold start. If this Property is set
to “0”, the value specified in the FIBEX database
for the ECU will be used. [optional]
Wakeup False Bool If this Property is set to “true” the FlexRay device is
configured to transmit a wakeup pattern. [optional]
ColdStart2 False Bool If this Property is set to “true” the second commu-
nication controller on the FlexRay device is config-
ured to perform a cold start. For this functionality
an “Advanced API” license from Vector Informatik
is required. [optional]
HILSendMode False Bool If this Property is set to “true” all Flexray frames
will be sent as they were recorded. Otherwise if
set to “false” the PDU Update-Bits of each frame
are checked. If Update-Bits are set, a new frame
containing the appropriate PDUs is created and
sent on the Flexray bus. [optional]
SendCycleOffset 5 Integer Set this Property to change the cycle sending be-
havior. Change this value with caution and only! if
the signal view shows unpredictable signal values.
[hidden]
Note: The Harddisk Player is not synchronized
with the FlexRay bus. The time lag between
the time of playback and the transmission on the
FlexRay bus is not predictable.
5.3 FlexCardDevice
The ’Eberspaecher FlexRay Device’ Filter (deprecated) is not supported with this version of
the Device Toolbox. The device will be supported as soon as a new Linux and Windows
driver is released for the device.
5.4.1 Description
The purpose of this Filter is to filter the FlexRay data on ECU level.
For each FlexRay data frame it is checked whether the name of the sending ECU is included in the
Property ECUs. In the positive case the data will be sent on the Output Pin.
5.4.2 Filter-GUID
adtf.io.flexray_ecu_filter
5.4.3 Pins
5.4.4 Properties
5.5.1 Description
This Service is started if it is integrated in the Manifest File. A new child window FlexRay Trace View is
created. In this window all Output Pins which transport FlexRay data are displayed. Starting from the Pin,
the tree displays items in the following hierarchy:
1. Pins
2. channels
3. ECUs
4. PDUs
5. signal values
In the Global Settings the following Properties can be set to modify the FlexRay Trace View:
FontName Courier String Font name for the displayed text in the tree view. It is recom-
mended to use a monospaced font here.
Also show false bool If “true”, additional text will be shown in column “Time/Value” for
text for all parameter values the FlexRay database provides them for.
values
5.6.1 Description
The FlexRay Signal Provider Service visualizes signal values in cooperation with the Signal View Filter
from the ADTF Display Toolbox.
Further documentation can be found in the documentation of the ADTF Display Toolbox.
5.7.1 Description
This FlexRay Config Codec Filter can be used to decode and encode FlexRay data. The format of
the data is controlled by a XML file which has to be specified in the Properties section. To create
this XML configuration file the ADTF Signal Config Filter Editor may be used, see below. The FlexRay
Config Codec depends on the FlexRay Support Service, so this Service needs to run and be properly
configured.
If you are using more than one FIBEX-File, you might have the Problem that a Signal (that you want
to use) is part of several files. There is an easy way to tell ADTF, which Signal-Information it should
use to encode/decode this signals values. If you edit new Configurations with the ADTF Signal Config
Filter Editor (XML-Files), ADTF will automatically store the Project-ID into each Signal-Name-String (see
Section 5.1).
With this information it is possible to determine from which FIBEX-File this signal came from. If you
are using old Configuration-Files together with other FIBEX-Files loaded, it can happen, that ADTF will
use the wrong Signal-Information for encoding/decoding. To prevent this effect, please expand your old
configuration files with the ProjectID of your desired FIBEX-File. This is shown in Figure 5.3.
Figure 5.3.: The ProjectID-Information is stored automatically, if you use Device Toolbox-Version >= 2.6.0.
Configuration-Files, that have been generated with older Device Toolbox-Versions must be
edited by the user, if you want to make sure that the Signal-Information is taken from a
specific FIBEX-File!
Since FIBEX databases can become rather large, starting the Filter for the first time may
take a while depending on the configuration of your system.
At startup the FlexRay Config Codec Filter will check if the FIBEX database specified in the XML
configuration and in the global settings of ( ADTF) are the same and will generate a warning message if
they don’t match.
5.7.2 Filter-GUID
adtf.io.flexray_config_codec
5.7.3 Properties
Automatic SI Unit false bool If “true”, every signal with a known unit is automatically
Conversion [Auto- converted to its SI unit.
CalcUnitToSI] This behaviour is overridden signal-specifically by the con-
figuration file. This Property defines the default behaviour.
Create Media true bool This allows you to disable the generation of media de-
Descriptions scriptions for the buffer pins. If these become rather large
[create_media- ( > 10000 Signals) this can be a very time consuming
_descriptions] step. A media description is only created for input buffers
(Output Pins)! Output buffers (Input Pins) of the FlexRay
Config Codec have no media description.
Dump Buffer false bool Print sizes of encoded/decoded data structures (for de-
Layout bugging issues)
[show_struct_info]
Dump Sig- false bool Dump all signal values to ConsoleView (for debugging
nal Updates issues)
[dump_signal_up-
dates]
Handling of Signal ignore string How should the Codec handle a signal’s min/max value
Limits of Database from database during encoding messages ?
[LimitHandlingPol- The following options are supported:
icy] ’ignore’ (default) Do not do anything, treat limits as com-
ments.
’clip’ Silently clip the signal to the violated boundary.
’warn’ Send the signal as is, but issue a log warning.
This behavior is signal-specifically overridden by the con-
figuration file. This Property defines the default behavior.
5.7.4 Pins
output MEDIA_TYPE_FLEXRAY out The Output Pin is used to send the en-
MEDIA_SUBTYPE_FLEXRAY coded FlexRay data.
The FlexRay Config Codec has an adjusted context menu. If the menu Edit Properties with ADTF
Signal Config Filter Editor for FlexRay Config Codec is selected, then the ADTF Signal Config
Filter Editor is opened. The editor works almost the same way as the editors for the CAN Config
Codec Extended and LIN Config Codec. For detailed information see chapter 2 Config Codec—Signal
Configurator. The FlexRay specific differences are demonstrated here:
InputPin/OutputPin
The properties channel and channelmask do not exist for FlexRay. The Vector FlexRay Device can
be configured to send and receive data from a specific cluster on a specific channel. Please refer to
section 5.1 Support of several FlexRay Networks.
Triggers
Element
The properties default_value, unit_conversion, sign_signal and limits do not exist for FlexRay.
FlexRay-specific element properties are:
Signals in a FIBEX file are defined by several properties like position in the PDU or the width of the signal
in bits. Because the FIBEX standard allows the use of several computation methods like scaling (offset,
factor, min, max) and/or additional TEXTTABLEs it’s necessary to do the following when configuring a
XML.
Example:
The FIBEX file defines a signal with a bitlength of 7. So the RAW value range will be 0 to 127. Assuming
that there is also a computation info for scaling defined with OFFSET = 0.0, FACTOR = 2.0, MINIMUM =
0 (raw) and MAXIMUM = 125 (raw). In addition there is a TEXTTABLE defined e.g. for status handling
with the entries INIT = 126 (raw) and ERROR = 127 (raw).
Decoding case: To receive a reliable signal (scaled signal values AND status handling) 2 output
buffer/pins should be defined in the ADTF Signal Config Filter Editor. The first one is to receive the
scaled values. Because of FCC raw value forwarding these could also be the raw values scaled with
FACTOR = 1.0 and OFFSET = 0.0. So the output of the first buffer could be from 0.0 to 250.0 (in the
example FACTOR = 2.0 for scaled values) AND also 126.0 or 127.0 (FACTOR = 1.0 for raw values). This
causes a misinterpretation in the application, because the raw value 63 AND the raw value 126 will be
126.0 on the output buffer. To check the validity of a signal, the second buffer is needed to receive the
raw values for status handling. Therefor the $RAWVALUE$ macro has to be set for that signal in the
second buffer. Both buffers will be transmitted at the same time (depending on their configuration). In the
case mentioned before the application can check the validity by comparing the scaled value with the raw
value (scaled_1 = 126.0 and raw_1 = 63 / scaled_2 = 126.0 and raw_2 = 126).
Encoding case: To transmit the whole signal (scaled signal value AND status handling) 2 input buffer/pins
have to be defined in the ADTF Signal Config Filter Editor. The first one is to transmit the scaled values.
The second one is to transmit the the status handling values. Therefor the $RAWVALUE$ macro has to
be set for that signal in the second buffer. The first buffer will only be scaled to raw and transmitted if the
incomming value is in (scaled) range between 0.0 and 250.0 (in the example factor is 2.0). Otherwise
an error log message will be shown in the ADTF Console View. To avoid overwriting the outgoing PDU
data (on FCC "output" pin, the second buffer should not act at the same time. In case of status handling
only the second buffer should transmit something to the FlexRay Config Codec Filter as raw value (0 ...
127).
It’s not advisable to use a float value for encoding a raw value. The FCC will only copy the
incomming value bytewise. Using an usingned integer instead is recommended.
In this Toolbox version the $RAWVALUE$ macro for encoding is only available for FlexRay.
With the FlexRay DAT Exporter Support FlexRay data recorded into DAT Files can be exported into the
Vector Informatik ASC format (see ADTF User’s Manual to get further information about the ADTF DAT
Exporter and how it works). The ASC files are used for logging purposes by CANoe itself and reflect all
relevant messages which were sent over the FlexRay bus.
After export, it’s possible to create an offline configuration inside CANoe or CANalyzer and use the
exported file as input to this configuration. The FlexRay DAT Exporter Support is installed automatically
if you install the Device Toolbox.
6 MOST
6.1.1 Description
This Vector MOST Device Filter serves to communicate with MOST hardware from Vector Informatik.
The following devices are supported:
I VN2610 (USB)
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.vector.com/.
Windows Linux
6.1.3 Filter-GUID
adtf.io.most.vector
6.1.4 Pins
output MEDIA_TYPE_MOST out Output Pin for the received MOST data
MEDIA_SUBTYPE_MOST
6.1.5 Properties
add_hardware- false bool If “true”, the Device Original Time of a message will
time_info be transmitted with the MediaSample in info area.
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is used
and interrupt initialization if this requirement is not
fulfilled.
6.2.1 description
This OptoLyzer G1 MOST Device Filter serves to communicate with MOST hardware from SMSC. The
following devices are supported:
I OptoLyzer G1 (MOST25)
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.smsc-ais.com/.
Windows Linux
6.2.3 Filter-GUID
adtf.io.most.optolyzer_g1
6.2.4 Pins
output MEDIA_TYPE_MOST out Output Pin for the received MOST data
MEDIA_SUBTYPE_MOST
6.2.5 Properties
6.3.1 Description
This OptoLyzer G2 MOST Device Filter serves to communicate with MOST hardware from SMSC. The
following devices are supported:
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.smsc-ais.com/.
Windows Linux
6.3.3 Filter-GUID
adtf.io.most.optolyzer_g2
6.3.4 Pins
output MEDIA_TYPE_MOST out Output Pin for the received MOST data
MEDIA_SUBTYPE_MOST
6.3.5 Properties
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is
used and interrupt initialization if this requirement
is not fulfilled.
The MOST Support Service implements the MOST MediaSample class. It has to be used whenever
MOST data is processed.
7 Ethernet
Starting with Device Toolbox 2.2 the Ethernet Device UDP and Ethernet Device TCP are
marked as deprecated and will not supported any more !
Both filters will provided as source-code under src/plugins/ethernet_udp (_tcp).
If you want changes or enhancements, please feel free to do it by yourself.
Starting with Device Toolbox 2.2 the Ethernet Device UDP is not supported any more !
Please see the hints at the beginning of chapter 7 Ethernet.
7.1.1 Description
This Ethernet Device UDP Filter serves to read in and output Ethernet data packets via the user datagram
protocol (UDP) in ADTF. The complete data packets received via the specified Ethernet port are packed
in a MediaSample of the type
(MEDIA_TYPE_NETWORK_DATA, MEDIA_SUBTYPE_NETWORK_DATA_IP)
and fed via the Output Pin into A D T F. If the device should be used on win32 platforms with multicast
addresses, have a look at the ADTF SDK Documentation (class cDatagramSocket).
It is in the nature of UDP connections that packages may be lost or reordered on their way
due to the quality of the physical connection.
Windows Linux
7.1.3 Filter-GUID
adtf.io.ethernet_device_udp
7.1.4 Pins
input MEDIA_TYPE_NETWORK_DATA in Input Pin for the data packets to be sent via
Ethernet.
output MEDIA_TYPE_NETWORK_DATA out Output Pin for the received Ethernet data pack-
ets.
7.1.5 Properties
TxPort 0 int Port number of the remote port to which the data is sent.
Starting with Device Toolbox 2.2 the Ethernet Device TCP is not supported any more !
Please see the hints at the beginning of chapter 7 Ethernet.
7.2.1 Description
This Ethernet Device TCP Filter serves to read in and output Ethernet data packets via the transmission
control protocol (TCP) in ADTF. The complete data packets received via the specified Ethernet port are
packet in a MediaSample of the type
(MEDIA_TYPE_NETWORK_DATA, MEDIA_SUBTYPE_NETWORK_DATA_IP)
Windows Linux
7.2.3 Filter-GUID
adtf.io.ethernet_device_tcp
7.2.4 Pins
input MEDIA_TYPE_NETWORK_DATA in Input Pin for the data packets to be sent via
Ethernet.
output MEDIA_TYPE_NETWORK_DATA out Output Pin for the received Ethernet data pack-
ets.
7.2.5 Properties
ConstantPacketSize true bool “true”: new MediaSample is only transmitted when con-
figured PacketSize is reached
“false”: new MediaSample is always transmitted when
new data was received
Port 1718 int Port number of the remote port that is connected
8 Camera
All Video Capture Device Filters offer the following basic Properties:
DeviceName “default” String Specifies the device which should be opened. The
input always depends on the concrete device that
is supported. Default is either a number of devices
starting with 1 with the specification “capture:1”, “cap-
ture:2”, etc. or the specification of the device names
or their serial numbers, e.g. “MVF-2371”.
8.2.1 Description
This Blue Fox Capture Device Filter serves to initialize cameras of the brand Matrix Vision BlueFOX and
play back the images in A D T F. The BlueFOX API is used to address various camera functions and to
make settings.
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.matrix-vision.com/.
Windows Linux
The device has been tested with the driver in the The device has been tested with the driver in the
version 2.13.0.1629. version 2.13.0.1629.
8.2.3 Filter-GUID
adtf.io.bluefox_capture
8.2.4 Pins
8.2.5 Properties
The Filter supports the basic Properties for Video Capture Devices (see ADTF User’s Manual, Section
6.2.1).
devicename “” String The device to be used. Use serial number or device index
[1..n]. Serial number will be preferred and may contain
* as wildcard for single characters or rightmost string.
Examples: BF002215, BF*, ***02*, 1
After installing the Matrix Vision drivers the Serial can be
easily found by 2 ways:
1. After starting wxPropView within the installation-path
you can choose your camera in the upper left corner.
Now the Serial is shown within the Box you’ve chosen
the camera: it’s the part before the brackets. Example:
BF002215 (myBlueFox-1012dG, DeviceID: ’3’)
2. After starting mvDeviceConfigure within the installation-
path you see a list of all Devices. You can find the serial
in the column ’Serial’.
Height 0 int Height of output video. 0 takes value from current camera
settings or UserConfig property. If not 0 and value differs
from UserConfig the image will be stretched.
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is used and
interrupt initialization if this requirement is not fulfilled.
Width 0 int Width of output video. 0 takes value from current camera
settings or UserConfig property. If not 0 and value differs
from UserConfig the image will be stretched.
8.3.1 Description
The Direct Show Video Device Filter serves to read in video images. Here, various cameras as video
sources are supported. For reading in, the functionality of DirectShow is used.
For importing video files (e.g. AVI or MPG) please use the Create New Dat File option in
ADTF-GUI (see ADTF User Manual section Creating a new DAT File) or with ADTF Datex-
porter Tool (see ADTF User Manual section Command line DAT Exporter/Importer/Repair).
For the use of some DirectShow video sources (e.g. Bluefox camera), the device assignment
is only possible without errors with administrator rights.
Windows Linux
X –
8.3.3 Filter-GUID
adtf.io.direct_show_video_device
8.3.4 Pins
output MEDIA_TYPE_VIDEO out Output Pin for the read in video images
MEDIA_SUBTYPE_VIDEO_UNCOMPRESSED
8.3.5 Properties
The Filter offers, in addition to the basic Properties, no additional Properties. The devices are numbered
starting with “capture:1”.
8.4.1 Description
This µEye Capture Device Filter serves to initialize cameras of the Imaging Development Systems and
play back the images in ADTF. The µEye API is used to address various camera functions and to make
settings.
For more information about the hardware, drivers, and driver compatibility issues see the vendor’s
homepage http://www.ids-imaging.com/.
Windows Linux
The device has been tested with the driver in the The device has been tested with the driver in the
version 4.40.1.0. version 4.40.1.0.
8.4.3 Filter-GUID
adtf.io.ueye_capture
8.4.4 Pins
8.4.5 Properties
The Filter supports the basic Properties for Video Capture Devices.
VerifyDriverVersion true bool If “true”, the Filter will check if a tested driver is used
and interrupt initialization if this requirement is not fulfilled.
Unchecking this flag when using parameter files may lead
to unexpected behaviour!
8.5.1 Description
The Linux Video Capture Device incorporates Video4Linux image sources into A D T F.
Windows Linux
– X
8.5.3 Filter-GUID
adtf.io.linux_video_capture_device
8.5.4 Pins
8.5.5 Properties
The Filter —in addition to the basic Properties—also offers the some device-dependent Properties. These
are shown in Table 8.13 Properties of the Linux Video Capture Device.
The Property devicename can be set to any Linux Video Capture Device. The default for this is
/dev/video0”.
9 Additional Service
With the External File Support Service bus data can be imported from several custom file formats into
DAT Files or bus data recorded into DAT Files can be exported into various file formats (see ADTF User
Manual for further information about the ADTF DAT Exporter and how it works).
With the External Stream Sync Source of the External File Support Service you can create a valid
ADTF Dat file stream of type MEDIA_TYPE_STREAM_SYNC, which contains sync data for an external
multimedia stream in relation to ADTF SampleTime.
To do this, an external ASCII file containing the header line External_Stream_Sync and pairs of
ADTF timestamps and the appropriate multimedia-stream time (in seconds) of an external video/audio or
other multimedia stream has to be created before, as input for the External Stream Sync Source.
The 3rd column containing an index into the external multimedia stream, is optional. The 1st and 2nd
columns with ADTF Timestamp and external stream time (in seconds) are mandatory.
For an usage example see section 9.2 ADTF MDF4 DeviceTB support for the Dat Exporter Service.
To find out the available ADTF DAT Exporter command-line switches, open a command-line in your
A D T F binary directory and type the following command.
adtf_datexporter --help
If you are using an A D T F version lower than 2.9.0 have a look at the following description. It illustrates
the use of the ADTF DAT Exporter command-line utility:
Command
To convert an ADTF 1.x DAT File use the import options below.
Import options
Append options
For each file the first source that can handle the file is used
-append FILE - Append FILE to the output.
-append FOLDER - Append all files in FOLDER in alphabetical
order.
Repair options
-repair BROKEN REFERENCE OUTPUT - Tries to repair BROKEN DAT File by using
the stream information from REFERENCE and
stores the result in OUTPUT.
See the ADTF Device Toolbox SDK Documentation to get more information of all available
sinks and sources.
9.1.4 MOST
ASC X – – –
CCO X1 – – –
IMG X X X X
OP2 X1 – – –
OPD X1 – – –
1
Control and light/lock messages are imported only.
Please keep in mind: An import of ’base dec’ ASC-files is currently not supported for MOST.
So make sure to configure your ASC-exporting tool to write ’base hex’ ASC-files, at least for
MOST.
The following examples illustrate the use of the ADTF DAT Exporter command-line utility:
1. To export MOST data from the stream most stored in a DAT File named most_example.dat
the following command has to be issued:
adtf_datexporter -service <path>/external_file_support.srv
-service <path>/most_support.srv -export most most_example.dat
2. To import MOST data from a custom file named most_trace.asc into a DAT File named
most_custom.dat the following command has to be issued:
adtf_datexporter -service <path>/external_file_support.srv
-service <path>/most_support.srv -import most_trace.asc most_custom.dat
9.1.5 CAN
Currently exporting a DAT File to an ASC file and importing from ASC to a DAT File is supported.
Please keep in mind: An import of ’base dec’ ASC-files is currently not supported for CAN.
So make sure, to configure your ASC-exporting tool to write ’base hex’ ASC-files, at least
for CAN.
The previously used tCANMessage structure has been replaced with the more powerful tCANData
structure. Please see the ADTF SDK Documentation for details on the tCANData structure.
The following examples illustrate the use of the ADTF DAT Exporter command-line utility to export the
CAN stream as ASC file:
To export the new tCANData data from the stream can stored in a DAT File named
<path_to_dat_file>.dat into an ASCII File named <path_to_asc_file>.asc the following
command has to be issued:
adtf_datexporter -service <path_to>/can_support.srv
-service <path_to>/external_file_support.srv
-export <stream_name e.g. rawcan>
-sinkid adtf.export.asc_file_sink
-property DBCFiles4Channel0=<path_to_dbc_file>.dbc
-property DBCFiles4Channel1=<path_to_dbc_file>.dbc
-output <path_to_asc_file>.asc <path_to_dat_file>.dat
The token <path_to> has to be substituted by the installation path of the ADTF Device Toolbox bin
directory.
9.1.6 LIN
Currently exporting a DAT File to an ASC file and importing from ASC to a DAT File is supported.
The following examples illustrate the use of the ADTF DAT Exporter command-line utility to export the
LIN stream as ASC file:
To export the new tLINData data from the stream lin stored in a DAT File named
<path_to_dat_file>.dat into an ASCII File named <path_to_asc_file>.asc the following
command has to be issued:
adtf_datexporter -service <path_to>/can_support.srv
-service <path_to>/external_file_support.srv
-export <stream_name e.g. output>
-sinkid adtf.export.lin_asc_file_sink
-output <path_to_asc_file>.asc <path_to_dat_file>.dat
The token <path_to> has to be substituted by the installation path of the ADTF Device Toolbox bin
directory.
9.1.7 FlexRay
The following examples illustrate the use of the ADTF DAT Exporter command-line utility to export the
FlexRay stream as ASC file:
To export FlexRay data from the stream flexray stored in a DAT File named
<path_to_dat_file>.dat into an ASC File named <path_to_asc_file>.asc the following
command has to be issued:
adtf_datexporter -service /path_to/flexray_support.srv
-service <path_to>/flexray_export.srv
-export <stream_name e.g. Flexray>
-sinkid adtf.export.flexray
-property flexray_fibex_filename=<path_to_xml_file>.xml
-output <path_to_asc_file>.asc <path_to_dat_file>.dat
The token <path_to> has to be substituted by the installation path of the ADTF Device Toolbox bin
directory.
With the ADTF MDF4 DeviceTB support for the Dat Exporter Service bus data recorded into DAT Files
can be exported into the MDF4 (MDF 4.0 Measurement Data Format) file format (see ADTF User Manual
to gain more information about the ADTF DAT Exporter and how it works). See subsection 9.1.1 External
Stream Sync for information about how to sync an external multimedia stream with the bus data.
I tCANData
I tCANMessage (deprecated)
I tFlexRayData
9.2.1 Usage
This chapter covers the usage of the ADTF DAT Exporter regarding the ADTF MDF4 DeviceTB support
for the Dat Exporter Service. For information about the general usage of the ADTF DAT Exporter see
chapter Usage of ADTF DAT Exporter.
To use the MFD4 support, the ADTF DAT Exporter has to be called with the according options.
-service <CalibTbBinDir>\adtf_a2l_support.srv
-service <CalibTbBinDir>\mdf_calibtb_support.srv
-export <xcp stream name> -sinkid adtf.export.mdf_xcp_sample_sink
-property A2L_File=<a2l file>
I For generating an MDF4-file containing external video reference data and synchronizing it with
the bus data, the External Stream Sync is used. See chapter External Stream Sync for
information about the <VIDEO_INDEX_FILE> ASCII file that will be used in the following steps.
To process the ASCII input file with external video sync-data and create a valid ADTF-Stream, call
the Dat exporter with the following options.
<AdtfBinDir>\adtf_datexporter [VIDEO_IMP_IDX_OPTIONS]
<VIDEO_IDX_INPUT_FILE>
[VIDEO_IMP_IDX_OPTIONS]:
-service <DevTbBinDir>\external_file_support.srv
-import <VIDEO_INDEX_FILE>
-stream External_Stream_Sync -name External_Stream_Sync
To generate the MDF4 file containing synchonized video reference data, call the Dat exporter with
the following options.
<AdtfBinDir>\adtf_datexporter [MDF_OPTIONS]
-output <MDF_OUTOUT_FILE> <VIDEO_IDX_INPUT_FILE>
I To append an export of a ADTF-stream to an existing MDF4 file, add the following option to the
[MDF_OPTIONS]:
-property append_mdf=true
Filename and path of the existing MDF-file must be set as Output filename.
I If you want an additionally (and optionally) debug-log-file beside the MDF4 output file, e.g. if you
assume some failures during the MDF-conversion (or if the ADTF-Support requests this), add the
following option to the [MDF_OPTIONS]:
-property write_debug_log_file=true
For a quick start use the following example. The batch file covers all options described above.
I Edit/change/adapt the necessary variables at the beginning of the script (paths, filenames, stream-
names etc. See description inside the file.)
I Call the script in a Windows cmd-shell with one parameter: the Input-DAT-file
I A file generated.mf4 (or with the name you have chosen inside the script) is created in the
same directory, which contains all exported streams:
. CAN
. FlexRay
. XCP
. External_Stream_Sync
If you want, you can append as many streams as you like to the generated.mf4
(more CAN, FlexRay, XCP and External-Video-syncs too). You only need to enhance
the batch-script. But keep in mind: Regarding the MDF-specification, there is only one
time-reference-base in the MDF HD-block, so all exported streams should be from the same
ADTF Input-DAT-file.
10 FAQ
I Error: If the ADTF Filters “VectorCANDevice” and “VectorFlexrayDevice” are in the same configura-
tion the start of the configuration fails.
I Error: If the device VN3600 from Vector Informatik is used with driver version 6.5.12 some FlexRay
frames are not received.
I If the device VN7600 from Vector Informatik with driver version 6.5.23 together with ADTF Filter
“VectorCANDeviceXL” is used the error message “VectorCANDeviceXL: Could not open driver!
Please check config!” is displayed on startup.
Solution: The ADTF Filter “VectorFlexrayDevice” is not able to handle the cycle start events emitted
from the device fast enough. In the menu System configuration → Vector Hardware the value
for the Property Receive latency has to be set to a smaller value.
I What are the data structures behind the Media Types of Device Toolbox filters?
Solution:
Type Struct
MEDIA_TYPE_CAN tCANData
MEDIA_TYPE_LIN tLINData
MEDIA_TYPE_FLEXRAY tFlexRayData
MEDIA_TYPE_MOST tMOSTData
Further information about these structs can be found in the ADTF Device Toolbox SDK Documen-
tation.
11 Abbreviations
Name Description
IP Internet Protocol
A Change Log
This list tracks the changes made within the ADTF Device Toolbox.
Changes
Bugfixes
Changes
I #22409 [External File Support Service]: provide option to import flexray data from ASC file to DAT
file
Reject reason: Duplicates #25920 - [External File Support, Flexray Support Service]: Implementa-
tion of flexray_asc_file_source {HD - TicketID 21859LKCMF}
I #33288 [Vector FlexRay Device Filter] Errors during playback of FlexRay-Frames if too many ECUS
were recorded
I #35723 [Vector CAN XL Device, Vector LIN Device, Vector FlexRay Device, Vector MOST Device]
Update to Vector XL Driver Library version 9.7 to support Vector Keyman License Dongle
I #37128 [flexray_export] FlexRay ASC Sink must set the correct cycle repetition value
Bugfixes
I #21078 [FlexRay Support Service]: IFIBEXDatabase method GetPDUID does not work properly -
{HD - TicketID 15633KFIMJ}
I #22856 [FlexRay Config Codec]: property "Handling of Signal Limits from Database" does not
work correctly (ignore, maybe clip too)
I #28888 [BaseCodec] Calculating Factor and Offset on a media buffer from type integer leads to a
loss of data
I #29456 [FlexRay Config Codec],[FlexRay Signal Config Filter Editor] $RAWVALUE$ macro does
not work in combination with Project-ID
I #33469 [CAN Signal Provider] Error Frames are interpreted as normal frames
I #34732 [CAN Signal Config Filter Editor, FlexRay Signal Config Filter Editor, LIN Signal Config
Filter Editor] Exporting Media Description in all Signal Config Filter Editors does not work
I #34759 [LIN Support Service] LIN to .asc export does not work
I #34849 [Vector FlexRay Device / Fibex Parser] Using of several flexray networks and device filters
in car can lead to unsyncable flexray networks - ADTFS-44108
I #35637 [MDF DeviceTB Support Service] MDF Flexray Sink ignores linked source for Flexray
Cluster
I #35724 [Vector CAN XL Device, Vector LIN Device, Vector FlexRay Device, Vector MOST Device]
Vector Keyman license stick not supported
I #37698 [MDF Flexray Sink] Crash if calculated Media-Sample timestamps are negative
I #38663 [PEAK-CAN Device] ADTF hangs on Linux64 if PEAK-CAN Device is not connected to a
CAN bus
Changes
I #32511 [PROCESS] Add presentation of Elektrobit FlexRay Framework including EB 5200 Card to
public documentation
I #34118 [Usermanual] Downgrade PDF Version due to crash issue in some readers (PDF Error
131)
Bugfixes
I #28920 [FCC-Parser] FCC Parser does not support special signal-types and attributes {HD -
TicketID 26579LFKHH}
Reject reason: Workaround for this exists by implementing own parser - see #24574
I #31473 [Vector Flexray Device] FlexRay channel B data are sent via channel A if HILSendMode is
enabled - {HD - TicketID 27105LEPKE}
I #31900 [Vector FlexRay Device Filter] Optimize the internal data processing to avoid gaps on the
FlexRay bus during playback
I #31936 [Vector FlexRay Device Filter] Unable to send FlexRay-Frames via Slots which are marked
as ColdStart-Slots
I #32011 [MDF DeviceTB Support Service] Exported MDF file cannot be read in CANape with more
than one FlexRay channel enabled
I #32283 [FlexRay Config Codec],[FlexRay Signal Config Filter Editor] Provide option to trigger also
whole PDU - {HD - TicketID 28264LDPFL}
I #32812 [FlexRay Signal Provider, CAN Signal Provider, MOST Signal Provider, LIN Signal Provider]
Enable text entries for signals providing them
I #33428 [Can Trace View] Update of the cCANPinCombobox leads to a crash in Qt {ADTFS-44077}
I #34691 [Vector FlexRay Device] Using of several flexray networks and device filters in car can lead
to unsyncable flexray networks - {ADTFS-44108}
Bugfixes
I #29020 [CCC Parser] ADTF crashes when loading keyword value description greater than 4k - {HD
- TicketID 26626LFJNF}
I #29062 [Vector FlexRay Device] Vector FlexRay Device from Device Toolbox 2.6 is not compatible
with ADTF 2.13 - {HD - TicketID 26573LFKHN}
Changes
I #1680 MOST-Codec: Mark MOST Trace View and MOST List View as BETA
I #6526 [FlexRayConfigCodec] Enhance the FlexRay Config Codec to maintain several FlexRay
networks within ADTF
I #6716 [Vector FlexRay Device] Enhance the Vector FlexRay Device to maintain several FlexRay
networks within ADTF
I #6717 [Eberspaecher FlexRay Device] Enhance the Eberspaecher FlexRay Device to maintain
several FlexRay networks within ADTF
I #6718 [FlexRay Signal Provider] Enhance the FlexRay Signal Provider to maintain several FlexRay
networks within ADTF
I #6719 [FlexRay Trace View] Enhance the FlexRay Trace View to maintain several FlexRay networks
within ADTF
I #11034 Support of 8 CAN channels of the Eberspaecher device for all supported platforms
(especially linux 64)
I #11613 Support the Eberspaecher Device on 64 bit Linux, when official drivers are available
I #13234 [SDK Documentation] Create overview of Global Configuration Setting provided by Device
Toolbox
I #17053 [UserManual] Improve Documentation of Direct Show Capture Device {HD - TicketID
12637KIFMF}
I #18307 [CAN Support Service] ICANSupportV2 is deprecated and will be removed in a further
version
I #18885 [FCC,LCC] Provide bus independent features on all ConfigCodecs (e.g. the feature
clear_after_transmit from the CCCExt)
I #22596 [CAN Config Codec Ext]: support of arrays of different initalized sizes using the content of
a CAN message (StopMessage has to be enhanced to SignalCount)
I #25578 [CAN Config Codec Ext]: Calculate Offset and Factor before Type Conversion {HD -
TicketID 16763KEIKM}, {HD - TicketID 22816LJDQE} Product Ticket
I #25866 [FCC, Base Codec]: Provide the element properties corrective_factor and corrective_offset
in FCC {HD - TicketID 21775LKDJL}
I #26831 [Direct Show Capture Device], [cBaseIODeviceFilter]: Support of virtual camera devices
I #27133 Add information to all Vector Device Filter Documentation that only devices could be used
which are supported by XL Driver Library - {HD - TicketID 23589LIHGI}
Bugfixes
I #15134 The Timeout Trigger Value in the CCCExt Codec is set to Zero during Filter::Stop {HD -
TicketID 11013KJKIH}
I #15820 Checkboxes of combo boxes in trace list views are missing under Linux (Ubuntu)
I #23486 [CAN Support Service]: LoadCANDatabases does not work correctely when only global
settings are used
I #26018 [SCFE for CCCExt]: ADTF-Crash after using "Add struct from DDL" {HD - TicketID
22024LJLHH}
I #26028 [SCFE for CAN / LIN / FLEXRAY]: Add Database only supports .dbc (CAN) / .ldf (LIN) /
.xml (FLEXRAY) file format {HD - TicketID 22025LJLHG}
I #26331 [signal_config_editor_lib]: The configuration checker doesn’t resolve structs with indexed
signal names {HD - TicketID 17789KDJII}
I #26584 [FlexRay Support Service ],[FCC Parser]: FCC Parser and FlexRay Coder have Problems
with PDUs of Byteorder Motorola
I #27662 [CAN Support Service] Crash without error message when loading DBC file
Bugfixes
I #26907 [CAN Media Coder]: The Enum Values of tCANSignalValue::eTypeTag have changed
between 2.4.0 and 2.5.0
Changes
I #17722 Check and improve all tooltips on all Properties of the delivered Toolbox Filters
I #20932 Create possibility to get CAN information form ARXML instead of DBC (same for FLEXRAY
and LIN) - {HD - TicketID 15396KFLDM}
I #21043 [CAN Support Service]: Create possibility to get CAN information from FIBEX instead of
DBC
I #24300 [µEye Capture Device, Blue Fox Capture Device, PeakCan, VectorCan]: Devices should
support the latest driver and api version - {HD - TicketID 19619KBMOB}
I #24323 [FCC] improve documentation regarding FCC/FIBEX and PDU triggering - {HD - TicketID
19268KBQFH}
I #24574 [Parser]: The CAN/Fibex parser must be exchangeable for different file formats
I #25071 [FlexCard Device]: provide option to measure delay in device {HD - TicketID 20683LLDHO}.
Bugfixes
I #12649 CCCExt: Timestamps of incoming MediaSamples get distorted {HD - TicketID 9938SJPE}
(no longer reproducable)
I #24374 [CAN Config Codec Ext, FlexRay Config Codec, LIN Config Codec ]: trigger defined in
depends on ADTFTime, not StreamTime
I #25059 [FCC]: Signal cannot be found in FIBEX file {HD - TicketID 20325LLGKG}; see also #23081
I #25203 [adtfcomm]: Initializing a configuration using FlexRay Config Codec may lead to heap
corruption
I #25348 [CAN Signal Config Filter Editor ]: DBC file paths from globals are lost
Changes
I #19679 [Flexray Signal Provider]: Evaluation of the PDU Update Bit (Clearance Monitoring Bit)
I #21824 Build the toolbox against ADTF 2.10 on the new/changed platforms and OS (Windows 7
64 Bit [win64_vc100], Windows 7 32 Bit [win32_vc90], Ubuntu 12.04 64 Bit [linux64])
I #22125 [Vector CAN XL Device,Peak CAN Device]: Remove deprecated Devices cVectorCANXL-
LegacyDevice and cPeakCanLegacyDevice
Bugfixes
I #16004 CAN-ASC Dat-Importer does not work because of LANG-Variable and RegExResolver-Bug
{HD - TicketID 11947KJBOG}
I #18622 CCCExt: ChannelMask for dbc node in config.xml does not work properly - {HD - TicketID
14682KGHHP}
I #19715 cDom: Unable to load FIBEX file (no valid xml tag)
I #20518 [FIBEX Database]: Memory leak when playing configuration with different FIBEX files
I #20874 [CAN Support Service]: decoding multiplexed signals misses if signals of a message have
different byteorder - {HD - TicketID 15396KFLDM}
I #21965 [CAN Legacy Filter Out]: Wrong conversion of CAN-Message-ID using the CAN Legacy
Filter Out with extended CAN-Messages ⇒ unfortunately this corrupts the extended message ids
which will lead to wrong CAN-IDs
I #22157 [FlexrayConfigCodec]: signal is updated, but OutputPin buffer will not be sent ⇒ Problem
with unknown FlexRay-Frames within a FlexRayFrameVector (full vector was ignored by FCC)
Bugfixes
I #20536 MDF-Exporter: change the content of si_tx_path (for Export of CAN + Flexray + Exter-
nal_Stream_Sync)
I #21029 [FlexRay Support Service]: ADTF crashes constantly when initializing config with certain
FIBEX files three times
Changes
Bugfixes
I #18738 FCC does not encode/decode signals which computation information are not fully defined
in Fibex (e.g. no TEXTTABLE entries for all possible values)
I #18747 Fibex DB GetFrameInfo() may return the code "ERR_NOERROR" also when frameinfo are
not available
I #19300 CCCExt: wrong behaviour with sign_signal when Encoding (output buffer)
I #19703 [Flexray Trace View]: To few or to much ECUs displayed when using Flexray_ECU_Filter -
Bug in Fibex file
I #19766 [FibexParser]: Error when parsing FIBEX files with developer messages
Changes
I #15980 All tCanMessage Filters are deprecated use tCANData instead . . . see documentation
I #18100 cansupport service supports the new ICANSupportExtended interface to load DBC Files -
ICANSupportV2 is deprecated and will be removed in a further version
Bugfixes
I #15568 CAN Trace Tree View does not correctly decode incomming messages with a smaller DLC
than defined in the DBC
I #15838 missing media samples when using more than one PeakCAN device (basic) {HD - TicketID
11489KJGFI} - Device is deprecated, use new Peak Device Receiver
I #16019 CCCExt sets wrong timestamps if no signal of timestamp message is element of buffer
I #16358 Eberspächer Device does not support 100KB Baudrate for CAN
I #16782 SignalConfigFilterEditor for CCCExt: value 0 is not accepted for CONSTANT macro
I #16783 CCCExt: Value type Int32 and Int16 are not supported
I #17306 FCC: Correctly Initialize RawValue before encoding data with coder
I #18095 Timing Problems - different behaviour in 2.1.3 and 2.2.0 {HD - TicketID 13120KHLIL}
I #18102 Mediasubtype is not shown on hoovering over the pin in the ConfigEditor when the pin
type is set to MEDIA_SUBTYPE_CAN_DATA {HD - TicketID 13042KHMFL}
I #18171 CCCExt: Data areas of a message which are not definded in a dbc, will not be initialized to
zero when generating a CAN message
I #18219 LCC: Data areas of a message which are not defined in a .ldf, will not be initialized to zero
when generating a LIN message
I #18267 FCC: Data areas of a message which are not defined in a fibex, will not be initialized to
zero when generating a message
Bugfixes
I #17626 Memory Leak with HD Player and loaded CAN-Services {HD - TicketID 12938KICPE} -
Caused by build against ADTF 2.8.0
Changes
I #13886 µEye-Device should support the latest driver and api version
I #13974 The Peakcan device should support additonal baudrates {HD - TicketID 10938KKAPE}
I #15233 Move the directshowcapture and video4linux device from adtf_core to the device toolbox
I #13516 FlexrayCoder/FCC: Provide possibility to change factor and offset in fcc or to get the error
codes of a signal
I #13670 CAN Support Service should inform about loaded dbc files
I #13797 Signal Config Editor does not show any self-made macros in the macro-list
Bugfixes
I #10076 A D T F hangs when PCAN PCI is not connected to bus {HD - TicketID 8402RNNH}
I #11250 Flexray Devices cannot send a PDU separately that is defined for channel A and B
I #15134 The Timeout Trigger Value in the CCCExt Codec is set to Zero during Filter::Stop {HD -
TicketID 11013KJKIH}
I #15996 Flexray: Media Sample Serialization of PDU samples encodes wrong size.
Changes
Bugfixes
I #13300 Flexray Config Codec should support "old" (Flexray Toolbox 1.3) XML-Files configuration
files.
Bugfixes
I #12675 Documentation: Commandline DatExporter for Export CAN → ASCII {HD - TicketID
9881SKJQ}
Changes
Changes
I #11040 The contents of the FlexRay Toolbox are now integrated into the DeviceToolbox
I #11085 Signal Config Filter Editor for CCCExt: "Create Pins from Configuration" should be called
after the Filter Editor is closed
I #10780 Add an Option to ASC Can Importer to process the file sequentially
I #9447 Added example for triggering the Harddisk Recorder with a CAN Message.
I #8903 CCC: Send several Multiplexed Messages (same ID, different Multiplex) with one Buffer {HD
- TicketID 7666QKJJ}
I #8896 Make the DeviceToolbox available for Windows 7 with Visual Studio 2010
I #8533 CAN Trace View Ext: Improve the handling of multiplex signals
I #8693 CAN Trace View Ext: An additional list view has been added to see the time span of signals
I #8692 CAN Trace View Ext: Add a combo box to filter the view for root nodes and channels
I #6444 CCC: Implement a new macro to read a signal’s raw value ($RAWVALUE$)
Bugfixes
I #11364 LIN Config Codec: Missing Media Description {HD - TicketID 9138SRHE}
I #11095 CAN Signal Provider decodes extended signals wrong {HD - TicketID 8956RINI}
I #10810 CAN Signal Provider does not deliver correct raw values and multiplexed signal values
{HD - TicketID 8829RJPC}
I #10806 CAN Signal Provider does not deliver signals after second start of configuration
I #10381 PEAK Device does not define property ’devicename’ (Linux only) {HD - TicketID 8593RMFP}
I #10357 CAN Trace View Ext: No signal values visibile for extended CAN messages {HD - TicketID
8497RNEL}
I #9602 FlexRay Devices fails to send data if flexray frame is not completly defined by FIBEX {HD -
TicketID 8090RRAS}
I #9575 FIBEX file with missing DENOMINATOR tag fails to load {HD - TicketID 8073RRCN}
I #9574 Flexray Trace View: Incorrect display of data when multi channel mode is active {HD -
TicketID 8073RRCN}
Changes
I #5916 CAN Trace View Extended: Optimized new CAN Trace View, can show ErrorFrames and
bus load
I #8866 CCC: Add documention and examples for sending Multiplexed Messages
I #8653 CAN Devices are separated into receiver and sender filter
Bugfixes
I #8285 SignalConfig: Default can-channel in input tag is not written to config file
I #8557 CCCext: The Info field of the incoming MediaSample is not copied to the sent MediaSample
I #9019 CAN ASC Importer fails to import CAN messages with message flags
Changes
I #7212 New Examples: Vector CAN device and SYSTEC CAN device
I #7307 MOST MediaSample extended for new MOST150 lock status events
I #8257 OptoLyzer G2: Messages for active node are received by INIC now
I #8688 OptoLyzer 3150: Support for additional registers buffer precount, busload burst count,
busload retrycount
Bugfixes
Bugfixes
I #8214 OptoLyzer G1: Sporadic crash when system control messages are received
Bugfixes
I #7338 OptoLyzer G2: Switching timing mode between slave <-> spy caused shutdown
I #8293 OptoLyzer G2: Incorrect size of received MOST150 Async. High Msg
Changes
I #6897 Device peakcan linked is now with driver dll 1.55. Compatible with new driver 3.x
I #6581 OptoLyzer G2 MOST 150 Control messages for synchonous channel allocation / deallocation
Bugfixes
I #6931 VectorCANDeciceXL: CAN channel ids are not used as configured in Vector Hardware
Confg
I #6727 Stress feature rx buffer control works now with OptoLyzer 3025 V1
Changes
I #5919 CCC: Additional Factor (f2) and Offset (o2) → f 2 · (f 1 · signal + o1) + o2
I #5917 CAN Signal Provider shall use the new CAN Support Service
I #5689 Enhance the documentation for the usage of multiplexed messages within the CanConfig-
Codec (CCC)
I #4901 CCC: Using the IMacroRecorder interface resolving the DBC filepath if using macros
I #4651 VectorLIN Device: LDF file Filter Property shall be moved to the GlobalSettings
I #4004 Using the hardware time stamp as additional information. This will be put to the MediaSam-
pleInfo.
Bugfixes
I #5279 The SignalView does not work with more than one CAN
I #4939 Peak CAN Device Hardware timestamps are not synchronized to the ADTF time.
I #4360 CAN Provider takes the settings only of the global settings and ignores the settings of the
system.xml
Changes
I Information: Due the compile with A D T F 2.2.2 the provided Device Toolbox Filters are more
perfomant.
Bugfixes
I #4598 CAN Signal Provider holds a reference to ADTF Kernel too long.
For known problems and open issues please have a look at known-problems.pdf inside directory
<INSTALL_DIR>/doc.
List of Figures
5.1. Make sure that each ProjectID is unique, if you want to use more then one FIBEX-File! . 67
5.2. Hardware Configuration of several FlexRay Networks . . . . . . . . . . . . . . . . . . . 68
5.3. The ProjectID-Information is stored automatically, if you use Device Toolbox-Version >=
2.6.0. Configuration-Files, that have been generated with older Device Toolbox-Versions
must be edited by the user, if you want to make sure that the Signal-Information is taken
from a specific FIBEX-File! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
List of Tables
Index
FIBEX, 9, 11
FlexRay Config Codec, 74
FlexRay DAT Exporter, 79
FlexRay Signal Provider, 74
FlexRay Trace View, 73