Getting started

This chapter will break down the use of the ADTF Calibration Toolbox 3. After reading this guide, you will know:

Where do I find the delivered example sessions?

We provide an example project in order to show the use cases of several filters provided in this toolbox. The project contains several ADTF sessions for different use cases.

If you have installed the toolbox within the addons folder of your used ADTF 3 installation, you can find the necessary ADTF project here: Within the Configuration Editor you can now choose one of the above listed ADTF sessions. For further information, like how the filters are working, you have to check the documentation of the individual components at the filter overview.

How can I start these sessions and what is their purpose?

The following sections will describe, how you can use the delivered sessions and their purposes.
In general, the sessions can be started in different ways. But we recommend to start them with the ADTF GUI Control, therefor you have to follow these steps:

  1. Start your ADTF GUI Control ($ADTF_FOLDER/bin/adtf_guicontrol.exe)

  2. Open the above mentioned ADTF-Project (calibrationtoolbox.adtfproject)

  3. By selecting one of the listed sessions you will be asekd, what URL should be used. Simply use the default-values.

  4. Now you can directly set your session in the 'initialized' and 'running' - state

  5. Your session is now running


Building a working configuration

If you would like to build your own configuration, you can follow these steps:

  1. Start with adding the transport sink (e.g. XCP On Ethernet Transmitter) or source (e.g. XCP On Ethernet Receiver) of your choice to the streaming graph and configure it. This depends on the properties of the used bus device (in case of ethernet: IP addresses, ports etc.). Note that if this information is specified in the A2L file you do not have to specify them explicitly.
  2. Add the XCP Master Filter, XCP Decode Filter and XCP Encode Filter to your filter graph.
  3. Set the 'A2L or Xml Filename' property of the XCP Master Filter to your A2L File.
  4. It is important that you connect the xcp_master-Pin of the XCP Master Filter with a 'Binding Proxy' inputpin.
  5. The output pin of this Binding Proxy has to be connected with the 'xcp_master' input pin of your XCP Encode Filter and XCP Decode Filter
  6. Right click on the XCP Encode Filter and XCP Decode Filter and select 'Signal Config Filter Editor'. Here you can create your custom configuration. (see SCFE)
  7. Alternatively you can specify your existing mapfile via the 'MapFilename' Property of the De/Encode-Filter.
  8. Connect the 'slave_xcp_frames' input pin of the XCP-Master-Filter with the 'xcp_frames' pin of the transport device (the sink/source inside the streaming graph) and vice versa. If you need help connecting a streaming graph with a filter graph have a look here.
  9. Now you're ready to go. If the initialization fails make sure that you check the Console Log for additional error messages!