This toolkit aims at capturing, analysing and transcoding SMPTE ST 2110 streams.

Features:

• capture RTP packets with high precision timestamps
• transcode ST 2110 essences to h264
• provide various pcap tools
• provide a recipe to create a live version of EBU-LIST
• troubleshoot the network by capturing traffic on remote hosts

Sponsored by:

Tested distros:

• Centos 7
• Dockerized Centos 7
• Ubuntu > 20.04

The repo contains multiple install sub-scripts, use the one in TOP DIRECTORY ONLY.

$ ./install.sh
Usage: ./install.sh <section>
sections are:
    * common:       compile tools, network utilities, config
    * ptp:          linuxptp
    * transcoder:   ffmpeg, x264, mp3 and other codecs
    * capture:      dpdk-based capture engine
    * ebulist:      EBU-LIST pcap analyzer, NOT tested for a while
    * nmos:         Sony nmos-cpp node and scripts for SDP patching

Regardless of your setup, please install 'common' section first.

Both capture and transcoder scripts have default parameters but they can be overriden by a config file to be installed as /etc/st2110.conf. See the sample. This config also provisions an EBU-LIST server in live mode, i.e. connected to a ST 2110 network.

These instructions show how to setup a performant stream capture engine based on Nvidia/Mellanox NIC + DPDK.

rtcdump is standalone remote capture tool for generic network issue.

It is required to go through the capture process before in order to validate all the underlying layers forwards a stream to an application. Then one can use our FFmpeg-based transcoder following these instructions.

Follow the integration guide for a complete capture and analysis solution.

README shows a POC for a NMOSisfied transcoder. And various scripts are propose to get SDP file from source and patch them to destination.

Pcap folder contains helper scripts which operate on PCAP files:

• ancillary editor: insert different types of failure in SMPTE ST 291-1 payload
• RTP pkt drop detector: count packets and drops for every (src/dst) IP pair found in a given pcap file
• video yuv extractor: convert RFC4175 payload into raw YUV file
• audio extractor: convert AES 67 payload into raw file

Dependencies:

• python3 and pip
• scapy
• bitstruct

• test the RFC4175 encoder in ffmpeg
• build a docker image for transcoder
• test recent version of linux-ptp to validate that pmc no longer needs root permission
• rework./capture/nic_setup.sh
• nmos-poller: display ffmpeg status

• video
• ancillary
• EBU tools