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 | Environment override |
|---|---|---|---|
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. |
✗ |
Nics
Environment override: GLOBAL_ST2110_NICS (sets this global option as a whole).
| 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
Environment override: GLOBAL_ST2110_NMOS_NODE (sets this global option as a whole).
| 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: