ST 2110 Receiver

Receive video, audio, ancillary or subtitle flows over SMPTE ST 2110 from the network. Bind to a NIC configured under Global Configuration. Multiple essences from the same device share one node; each becomes its own output pad. (Ancillary and subtitles are forward-compat placeholders — receive support arrives with 2110-40.)

Component Configuration

Option Description Required

id

A unique identifier for the component instance

displayName

The name shown in the Studio UI of this component

nicId

NIC (from Global Configuration → ST 2110 NICs) this receiver binds to. Add a new NIC inline with the '+ New' button.

redundantNicId

Optional second NIC for ST 2022-7 hitless redundancy. When set, the receiver listens on both NICs simultaneously — typically each connects to a different switch (red / blue networks).

sourceName

Source name surfaced to downstream subscribers in this Studio document.

essences

Essence flows to receive. Each becomes an output pad on this node.

nmosResourceId

Optional NMOS resource UUID for external controllers to bind to. Auto-generated if blank.

Essences

Option Description Required

kind

Type of essence. 'ancillary' and 'subtitles' are reserved for 2110-40 support. (default: "video")

multicastGroup

IPv4 multicast group to join, e.g. 239.0.0.1.

port

UDP port of the incoming RTP stream. (default: 5400)

idleTimeoutMs

Optional idle-timeout override (ms). Default is derived from the SDP frame rate.

Global Configuration

Nics

Option Description Required

id

Short stable identifier referenced by ST 2110 components. Letters, digits, dash and underscore.

displayName

Operator-facing label, e.g. 'Mellanox ConnectX-6 #1 (10G)'

pciAddress

PCI BDF address as DPDK expects it, e.g. 0000:01:00.0 — find with 'lspci' on the host.

addressMode

Where this NIC's IP address comes from. Use 'static' to set it explicitly below, or 'dhcp' to let the network DHCP server assign one. (default: "static")

ipAddress

IPv4 address bound to this NIC for ST 2110 traffic. Required when address mode is 'static'.

netmask

IPv4 netmask in dotted-decimal form, e.g. 255.255.255.0. Required when address mode is 'static'.

gateway

Optional default gateway. Leave blank for link-local-only segments.

hugeDir

Dedicated hugetlbfs mount path for this NIC's DPDK primary. Defaults to /dev/hugepages-<id> at runtime if blank. Each ST 2110 NIC needs its own mount — EAL holds an exclusive flock on the mount root during init.

coreCount

Number of cores to pin this NIC's DPDK threads to. Defaults to 5 (matches the production test rig). Norsk uses recommendCoresFor to pick NUMA-local cores honouring isolcpus / nohz_full. (default: 5)

mainCore

Advanced: explicit main core to pin to. Setting this skips automatic core recommendation. Use only if you know which CPU core to dedicate.

otherCores

Advanced: additional worker cores pinned alongside the main core (only used when mainCore is set). (default: [])

Nmos Node

Option Description Required

label

Operator-facing name advertised in NMOS device discovery.

description

Optional longer description shown in NMOS browsers.

hostname

DNS-SD hostname this Node advertises, e.g. studio-host.local

managementIp

IP NMOS controllers reach for the Node's HTTP API. Typically your control-plane NIC, NOT a media NIC. Pick from the discovered hardware list or enter manually. Leave blank if not using ST 2110 — the receiver/sender components will surface a clear error if a stream tries to start without it.

chassisId

Optional MAC-formatted chassis identifier. Pick from a host NIC's MAC or enter manually. Set explicitly if you need a stable value across NIC swaps — some NMOS controllers bind to this for receiver/sender connection state.

tags

Optional NMOS tags. Each tag is a key with one or more values. (default: [])

clocks

Timing clocks this Node exposes. ST 2110 senders reference these by name. The default 'clk01' is an internal clock — replace with PTP for real facility deployments. (default: [{"name":"clk01","type":"internal"}])

Tags: