Description

This package is a bundle of C++ libraries providing functionality for reading/writing adtfdat files, processing streams and (de)serialize sample (container for timestamped streamed data).

Remarks: If you want to use the ADTF File Library with Python, please check out the ADTF Python Package.

Please have a look at Release Notes.

Content

Libraries

Library	Description
adtf_file	Create/read adtfdat files (indexed files with samples) using C++.
adtfdat_processing	Process streams from/to adtfdat files.
ifhd_file	Create/read indexed files (no samples, just chunks).
utils5extension	Helper classes to create indexed files.

Tools & Applications

Tool	Description
adtf_dattool	Extendable CLI tool to to handle and access .adtfdat files for reading, writing and processing containing streams.
canwriter	Example application creating an adtfdat file containing a CAN stream.
fileaccess	Example application reading file and stream information.
referencedfiles	Example application accessing referenced_files extension.

ADTF File Plugins and Builtins

ADTF File Plugin	Description
builtins	Builtin Readers, Exporters and Serializers using adtf_file and adtfdat_processing.
csv_exporter	Export DDL based stream to csv file using adtfdat_processing.
csv_reader	Import DDL based stream from csv file using adtf_file.
trigonometry_reader	Example reader creating a sine, cosine and tangent stream using adtf_file.

How to build

Remarks: If for any reason you do not make use of our delivered prebuilt packages, we recommend using cmake together with conan on which the source code is based.
You will find the required scripts/conan/build/conanfile.py within the source package.

Build Environment

This package has been built and tested only under following compilers and operating systems (native/container):

Windows Desktop (x86_64)

Note: The packages can be used OS version independent, prefered together with conan.
We recommend our used and tested platform Microsoft Windows 11 64 Bit.
On any other Windows 64 Bit platform (e.g. Windows 7, 10 or Server) make sure that it fulfills the following requirements

Visual C++ 2019 (at least CXX Compiler MSVC 19.29) / Visual C++ 14.2 (VC142 Toolchain at least 14.29)
MSBuild Version 16.x (at least 16.11)
MSBuild Tools only or full Visual Studio IDE installation which covers this requirements
Windows Kit 11 (at least 10.0.22621.0)
CMake at least 3.23

Linux Desktop (x86_64)

Note: The packages can be used OS version and distribution independent, prefered together with conan.
We recommend our used and tested platform Ubuntu 18.04 LTS 64 Bit or higher.
On any other distributions (e.g. Fedora, Debian) make sure that it fulfills the following requirements

gcc >= 7
libc >= 2.27
libstdc++ >= 6.0.25
CMake at least 3.23
build-essential libarchive-dev mesa-common-dev mesa-utils libglib2.0-0 libxcb-xinerama0

Linux for ARMv8 (AArch64)

Note: The packages can be used OS version and distribution independent, prefered together with conan.
We recommend our used and tested platform Ubuntu 18.04 LTS 64 Bit or higher.
On any other distributions (e.g. Fedora, Debian) make sure that it fulfills the following requirements.
Our reference hardware is nVidia Jetson TX2 Board (compatible to e.g. nVidia Drive PX 2 or Jetson AGX XAVIER)

gcc >= 7
libc >= 2.27
libstdc++ >= 6.0.25
CMake at least 3.23
build-essential libarchive-dev mesa-common-dev mesa-utils libglib2.0-0

Note: Our entire code is prepared for cross-compiling (as we do as well). See cmake/conan documentation for how to.

License Information

For any license information have a look at LICENSE.

Furthermore please refer to Used Open Source Software for an overview of 3rd party packages we are glad to use.

Table of Contents