Media Transport Library

1. Overview:

The Media Transport Library(Kahawai) is a solution based on DPDK prepared for transmitting and receiving media data with high throughput and low latency. It include a efficient user space udp stack support, beside UDP, it also has a built-in compliant implementation to the SMPTE ST 2110 Professional Media Over Managed IP Networks suite of standards.

1.1 Features:

• User-space UDP stack with POSIX socket compatible API.

1.1.1 ST2110 features:

• ST2110-10, ST2110-20, ST2110-21, ST2110-30, ST2110-40, ST2110-22, ST2022-7
• 1080p, 720p, 4k, 8k and other
• FPS: 120, 119.88, 100, 60, 59.94, 50, 30, 29.97, 25, 24, 23.98
• All the video format listed in ST2110-20, include YUV 4:2:2 10bit and others.
• CSC support status: status

1.2 Architecture:

Media transport library takes advantage DPDK features to implement a highly efficient, real-time & low-latency media transport stack, software based media transport makes it feasible for edge and cloud deployment based on COTS hardware.
Kahawai introduce a tasklet async based scheduler to fully utilize CPU resources, easy integration with different packet processing unit and accelerators.
The packet pacing module support different ways(algorithm) to acheive narrow pacing, RL(rate limit) is partially hardware offload while TSC is fully software based.
Kahawai also develope SIMD CSC(color space format covert), DMA, plugin interface to build a fulll video production ecosystem.

2. Build:

Please refer to build guide for how to build DPDK, the library and the sample application.
For Windows, please refer to Win build guide for how to build.

3. Run ST2110:

Please refer to run guide for how to setup and run the demo pipeline application.
For Windows, please refer to Win run guide for how to setup and run the demo.
For VF and VM support under Linux, please refer to vf guide for how to setup VF based on SRIOV, vm guide for how to setup VM based on VF passthrough.

4. ST2110 Programmers guide:

For how to develop application quickly based on Kahawai library, pls refer to sample code.

5. User space UDP stack guide:

From 23.03.0 version, Media transport library extend the support to user-space UDP stack which run directly under current process context for performance consideration. Other user-space UDP stack usually run with client-service architect, it introduce a cross-core message cost which hurt the performance. Our stack are running NIC tx/rx function from the sendto/recvfrom API directly which save the cross-core call and keep the data affinity(LLC) to the UDP consumer. For how to use the UDP api, pls refer to udp sample code.

6. How to Contribute:

We welcome community contributions to the Media Transport Library project. If you have any ideas/issues, please share it with us by the github issues or opening a pull request.

6.1 Coding style:

Run below command before opening a PR.

./format-coding.sh