Page tree
Skip to end of metadata
Go to start of metadata

NMOS is supported since Firmware 3.9.9.44345 (Horus - Hapi) 1.1.8b44345 (Anubis)

Supported NMOS API's

  • NMOS Node API IS-04 v1.2
  • NMOS Connection API IS-05 v1.0

Advanced Page for NMOS Settings

To enable NMOS on a supported device the “Advanced” web page provides an additional NMOS Tab

Figure 1 The NMOS settings tab on the Advanced configuration page

NMOS General Settings

  • Enable:
    • Enable NMOS operation such as registering against a registry server and responding to NMOS REST API calls. To change the registration server configuration NMOS needs to be disabled.
      When the NMOS switch is enabled two things happen:
      1. Depending on the chosen "Mode" in the "Configure Registration Server" section the device starts to look for a registration server
      2. It opens up the "Port" chosen in the "NMOS General Settings" section for NMOS API calls. Supported NMOS API's are: IS-04 v1.2 and IS-05 v1.0
    • Disabling NMOS
      1. stops the server from listening for API calls
      2. Revokes the registration from a registration server
  • Port:
    This is the port used to reach the NMOS API on the device. This setting can be changed when NMOS is not enabled

Configure Registration Server

  • Mode:
    Let’s you choose between mDNS (Bonjour), Unicast DNS and Static
    • mDNS (Bonjour): The registration server is found browsing for _nmos-register._tcp taking the first server to be found
    • Search domain: A search domain for looking up a DNS entry needs to be supplied. The search domain associated with the primary network interface is shown as Suggested. This mode is not yet supported on embedded devices
    • Static Address: The registration server is found using the address given in the “Address” field. This is the preferred way at the time of writing and tests against the Sony nmos-cpp registry and the Riedel NMOS explorer were carried out using this method.
  • Address
    IP address of the registration server which is evaluated and used when the mode is set to "Static".
    The supported format is "<ip address>:<port number>"
  • Search Domain
    If the mode is set to "Search Domain" this will be used as search domain for DNS look up (Unicast DNS).
    Under certain circumstances an available  search domain can be identified and is added as "Suggested" one.
    Unicast DNS is not yet supported on all platforms (ZMAN is not supported)

Registration Server

  • This section only provides status information about the Registration Server
  • Server Name and Host are usually provided as response from a DNS/mDNS look up - they might be empty when mode is set to static
  • The <ip-address> of the server
  • The <port> of the server
  • If a registration server can be reached the Registered shows "true" over a green background. Otherwise it just reads "false"

Supported Functionality

  • IS-04 exposes the Ravenna device using this structure:
  • Each session source created on the “Sessions sources” tab creates a Sender, a Source and the corresponding Flow-NMOS-object. Each “Session sink” that has triggered a save operation on the web page is represented as a Receiver-NMOS-object
  • The registration is kept alive using a heartbeat every 5 seconds
  • Although deprecated creating a connection using just IS-04 is still supported
  • IS-05 connection API is supported using single as well as bulk operation.
  • Only immediate activation is supported

Test results with the official test facility

  • We run nightly regression tests using the AMWA NMOS testing tool
    • Passing all IS-04-01 tests
    • Passing 53 of 68 tests skipping tests test_01..test_08 (replaced by ‘auto’ test), tests test_27..test_30 (absolute and relative activation) and test_41 (SDPoker test) and test_42 (warning)
    • Passing all IS-05-02 tests (interaction between IS-05 and IS-04)

Known Issues and Limitations

  • Testing is carried out using only our node implementations on Anubis and on our RavennaASIO implementation running on a PC.
  • Tools used are the Sony nmos-cpp registry and the Riedel NMOS explorer 

    Figure 2 Setup used to test our NMOS functionality

  • Absolute and relative time connection activation (IS-05) is not supported.
  • Finding the most suitable registry server using priority text records is not supported
  • Finding the most suitable registry server using unicast DNS is not yet supported
    • Therefore the suggested registration server mode is to use a static address (although simple mDNS using only one registration server works as well)
  • ST-2022-7 is not supported yet
  • No labels