Resource contains source code to build the Media Gateway Next application along with an archive of its open-source dependencies.

Media Gateway Next is a reference container for Holoscan for Media, built on DeepStream. It adds a GStreamer element, nvdsnmosbin, that allows the registration and management of NMOS senders and receivers corresponding to ST 2110 sinks and sources in a flexible GStreamer pipeline passed to the container.

For a video walk-through of the technology, see Bringing Up a NMOS-Capable ST 2110 Media Processing Node in 30 Minutes from the IP Showcase On The Water at IBC 2023.

Refer to the Local Developer Setup with Docker for more information.

Build The Docker Image

• Place the Rivermax SDK archive rivermax_ubuntu2204_1.50.7.tar.gz obtained from Rivermax SDK inside the mlnx-packages directory.
• To build the container, run

  docker build -t nvds_nmos_bin:<tag> --build-arg WITH_ALL_CODECS=0 --build-arg ARCH=$(shell uname -m) --load .
  

• To build the source code separately, follow the steps in the builder step in the Dockerfile.

Architecture

This repository is a collection of three GStreamer elements, nvdsnmosbin, nvdssdpsink, nvdssdpsrc. The user is only expected to interact with nvdsnmosbin which implements the NMOS node. nvdssdpsink, nvdssdpsrc implement NMOS senders and receivers for nvdsnmosbin.

nvdsnmosbin:

• Sets up the NMOS HTTP server based on srcs and sinks requested via properties.
• Patches SDPs with additional information required by NVIDIA/nvnmos and Rivermax.
• Handles NMOS callbacks.
• Sets callback SDP on nvdssdpsink, nvdssdpsrc via the property sdp that must have flag GST_PARAM_MUTABLE_PLAYING. The sdp property is the only hard coupling between nvdsnmosbin and nvdssdpsink/nvdssdpsrc.
• Sets nvdssdpsrc-desc, nvdssdpsink-desc on nvdssdpsink/nvdssdpsrc if those elements have those properties to propagate user configuration of nvdsudpssrc/nvdsudpssink. Both properties may be implemented by nvdssdpsink/nvdssdpsrc but it is not required.

nvdssdpsink:

• Decides on whether to use nvdsudpsink or udpsink, depending on whether network interface is supported by Rivermax.
• Dynamically reconfigures nvdsudpsink/udpsink and payloaders if required, on every SDP change.

nvdssdpsrc:

• Decides on whether to use nvdsudpssrc or udpsrc, depending on whether network interface is supported by Rivermax.
• Dynamically reconfigures nvdsudpsrc/udpsrc and depayloaders if required, on every SDP change.

License

By downloading and using this software, you accept the terms and conditions of the NVIDIA AI Product Agreement.

The source code for the Media Gateway Next application itself is licensed under the Apache License, Version 2.0. The notices, attribution, licenses and source code are included in the tarball.