Getting Started

This guide covers your very first steps within ADTF. After reading it you will:

Where do I find the main toolset that make up ADTF?

Have a look inside the bin folder of your ADTF directory and you will find the executables listed in the overview.

If you need debug support, step down one directory and start the program from the debug folder.

What is ADTF (in a few words)?

ADTF is an application development framework and toolset written in the C++ language. It is designed to process and record data from different kind of data sources you find in modern cars (bus interfaces, camera, lidar, radar, ...), fuse them with a referenced timestamp, transform, combine or manipulate this data and supply it to any kind of data sink. It allows you to include new devices with little coding effort while making use of a rich set of default ADTF Components like video or image display, recoder and player.

What are the building blocks of ADTF?

ADTF System

An ADTF System encapsulates all things necessary to get an ADTF Session up and running on different environments.

All of this is saved within a ADTF System File which can be recognized by the file ending .adtfsystem.

ADTF Streaming Graph

The ADTF Streaming Graph defines the ADTF System's communication interface to

The definition is made within a ADTF Graph File (.adtfgraph) and can contain one or more ADTF Streaming Graphs.

ADTF Filter Graph

The ADTF Filter Graph defines how data and trigger flow through an ADTF Graph based system where you can

Since ADTF 3.8.0 it is also possible to use Streaming Services within the Filter Graph. This means you can access communication interfaces like within your Filter Graph.

The definition is made within a ADTF Graph File (.adtfgraph) and can contain one or more ADTF Filter Graphs.

ADTF Session

The ADTF Session is the file you need in order to launch an ADTF Launcher. Therefore the ADTF Session selects:

The definition is made within a ADTF Session File (.adtfsession).

ADTF Project

The ADTF Project contains all kind of files described previously to run an ADTF Launcher. An ADTF Project may contain multiple ADTF Filter Graphs ,ADTF Sessions, ADTF Systems but at least one:

in order to an ADTF Launcher.

The definition is made within a ADTF Project File (.adtfproject).

How can I launch it?

Let's launch an ADTF Session:

  1. Open a console and go into the bin directory of ADTF and start the ADTF Configuration Editor by typing: adtf_configuration_editor.exe or open the executable using your favorite explorer.
  2. Next open the example project by pressing ctrl + O, Open Project button in Home view or using the menu bar (File - Open project...)
  3. Enter the path to the project file ./src/examples/projects/adtf_example_project/adtf_example_project.adtfproject and press open
  4. Right click on Demo Playback Session in Sessions view and choose Launch with ADTF Control. Alternate you can just select the ADTF Session by double clicking it and using the menu bar (Launch - with ADTF Control) or pressing F6

  5. The Sessions View of the ADTF Configuration Editor
  6. Now you are in the Interactice Mode of ADTF Control, the ADTF Session is already launched and in the first runlevel (RL_System). Type rl running or rl 5 into the console for changig to runlevel to RL_Running

  7. The ADTF Control in form of a console

What do I see?

The ADTF Runtime / ADTF System is now in the state RL_Running. The loaded ADTF Session replays a previously recorded data stream. The ADTF XSystem, a mashup and handler of different widgets, displays various data contained in the stream and logging. Furthermore a player control enables the user to start, stop or seek the stream.

Finally you should see something like this:

Visualization of a data streams

Where to go next?

Have a look at the Best Practice Tooling to create a feeling which tools fulfills your request.