Open1722

Maintainers

• Naresh Nayak - Robert Bosch GmbH
• Adriaan Niess - Robert Bosch GmbH
• Kamel Fakih - Robert Bosch GmbH

Introduction

Open1722 is a fork of AVNU/libavtp which is an open source reference implementation of the Audio Video Transport Protocol (AVTP) specified in IEEE 1722-2016 spec. libavtp primarily focuses on audio video data formats of the IEEE 1722-2016 spec.

IEEE 1722 is also gaining a lot of traction in the automotive community, mainly, to bridge fieldbus technologies over automotive Ethernet. In particular the AVTP Control Formats (ACF) specify serialization for a set of data formats relevant for automotive applications (e.g., CAN, LIN, etc.). Open1722 extends/modifies libavtp to also include these ACF formats.

NOTE: Open1722 is currently incubating and under active development. The APIs are not fully stable and are subject to changes.

Open1722 is under BSD License. For more information see LICENSE file.

Implementation

This repository is organized as follows:

• The src/ and include/ folders contain the IEEE 1722 protocol implementation. We strive to make the implementation platform independant and avoid usage of platform specific headers or libraries. For now the implementation is tested only on Linux.
• The examples/ folder contains various applications that use our Open1722 library. The applications are targeted to Linux platforms.

Before building Open1722 make sure you have installed the following software :

• CMake >= 3.20
• CMocka >= 1.1.0

Alternatively, you can use VS Code to run the provided dev container which takes care of the dependencies.

The first step to build Open1722 is to generate the Makefile and build the project.

$ mkdir build
$ cd buid
$ cmake ..
$ make

The build can be cleaned using the following command:

$ make clean

To install Open1722 on your system run:

$ sudo make install

AVTP Formats Support

AVTP protocol defines several AVTPDU type formats (see Table 6 from IEEE 1722-2016 spec).

The following is the list of the formats currently supported by Open1722:

• AAF (PCM encapsulation only)
• CRF
• CVF (H.264, MJPEG, JPEG2000)
• RVF
• AVTP Control Formats (ACF) (see Table 22 from IEEE 1722-2016 spec)
  • CAN
  • CAN Brief
  • GPC
  • Sensor
  • Sensor Brief

Examples

The examples/ directory provides sample applications which demonstrate the Open1722 functionalities. Each example directory contains a README file that includes specific details on its functionality, configuration, and dependencies.

To execute the IEEE 1722 CAN Talker application:

$ ./bin/acf-can-talker