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

Media Gateway 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 reference pipelines in the Holoscan for Media user guide for more information.

Build The Docker Image

• Place the Rivermax SDK archive rivermax_ubuntu2204_1.70.32.tar.gz obtained from Rivermax SDK inside the mlnx-packages directory.
• To build the container, run:
  docker build -t nvds_nmos_bin:<tag> .
  

  where:
  • <tag> is a version label for this image (for example, 1.0-dev)
• 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 by the properties.
• Patches SDPs with additional information required by NVIDIA/nvnmos and Rivermax.
• Handles NMOS callbacks.
• Sets callback SDP on nvdssdpsink, nvdssdpsrc using the sdp property, which 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 application itself is licensed under the Apache License, Version 2.0. The notices, attribution, licenses and source code are included in the tarball.