Device Toolbox ADTF DAT Tool Plugins

The ADTF Device Toolbox delivers *.adtffileplugins which can be used within the ADTF DAT Tool from ADTF.

For further information check the ADTF DAT Tool Processor.

The adtf_dattool offers in this way the export of different streams (CAN, CAN FD, FlexRay) from ADTF DAT files to supported file formats and import this streams from supported file formats to ADTF DAT files.

Supported file formats
Format	Stream	Importer(...->DAT)	Exporter(DAT->...)
ASC	CAN	X	X
	CAN FD	X	X
	FlexRay	X	X
MDF	CAN	-	-
	CAN FD	-	-
	FlexRay	-	-
	SOME/IP	-	X

The delivered *.adtffileplugins are found and called in the folder:

<ADTF_DEVICE_TOOLBOX_DIR>/bin or <ADTF_DEVICE_TOOLBOX_DIR>/bin/debug

Plugin Properties
Plugin	Properties	Description	Default value
`asc_can_exporter.adtffileplugin`	channel_mask	filter for CAN IDs	0xffff
	set_negative_time_to_zero	option to reset timestamp	1
	sort_by_timestamp	option to adapt sorting	0
`asc_canfd_exporter.adtffileplugin`	channel_mask	filter for CAN IDs	0xffff
	set_negative_time_to_zero	option to reset timestamp	1
	sort_by_timestamp	option to adapt sorting	0
	skip_error_frames	option to skip messages of type ERROR_FRAMES	1
	skip_status_messages	option to skip messages of type STATUS_MESSAGE	1
`asc_flexray_exporter.adtffileplugin`	adtf_dir	path to ADTF	""
`asc_flexray_exporter.adtffileplugin`	database_file_path	path to your database file	""
`mdf_someip_exporter.adtffileplugin`	additional_parser_parameters	optional arguments for parser engine	""
	database	path to database file	""
	parser_service	path to parser adtfplugin	""
	message_meta_data	option to store payload only	false
	ignore_invalid_messages	option to skip invalid content	false

Example usage

This example covers an usage for the provided Demo CAN Config Decoder. You have to set DATTOOL_PATH, ADTF_DIR and ADTF_DEVICE_TOOLBOX_DIR manually.

        
echo off
set DATTOOL_PATH=<Path to the adtf_dattool.exe>
set ADTF_DIR=<Your ADTF-Installation-Path>
set ADTF_DEVICE_TOOLBOX_DIR=<Your DevTB-Installation-Path>

call %DATTOOL_PATH% ^
    --export example_can_random.adtfdat ^
    --plugin %ADTF_DEVICE_TOOLBOX_DIR%/bin/can_mdf_processor.adtffileplugin ^
    --stream output_can ^
    --processorid can_mdf ^
    --output random_can.mdf ^
    --property adtf_dir=%ADTF_DIR% ^
    --property database_file_path=example_can.dbc

The fileplugins are loading their relevant services themself and should not be moved. For further information how to use the ADTF DAT Tool take advantage of its --help command.

Constraints

The CAN FD to ASC processors does not convert remote frames into the desired asc file.

Due to the ISO-11898-1:
The RRS (Remote Request Substitution) bit shall be transmitted in FD Frames at the position of the RTR bit in Classical Frames. The RRS bit shall be transmitted dominant, but receivers shall accept recessive and dominant RRS bits. The RRS was introduced instead of the RTR (Remote Transmission Request) Bit. Therefore no CAN FD Remote Frames exist anymore.