ST 2110 Sender

Send video, audio, ancillary or subtitle flows over SMPTE ST 2110 to the network. Bind to a NIC configured under Global Configuration. Each configured essence becomes one outbound SDP/RTP flow on this NMOS device. (Ancillary and subtitles are forward-compat placeholders — send 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 sender binds to. Add a new NIC inline with the '+ New' button.

✗

redundantNicId

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

✗

clockName

Name of the clock (configured on the NMOS Node) that this sender's flows reference. Defaults to 'clk01'. (default: "clk01")

✗

essences

Essence flows to send. Each becomes a subscription pad on this node and one outbound RTP stream.

✗

nmosResourceId

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

✗

Essences (Video (2110-20))

Option Description Required

kind

Essence kind (set via the variant picker).

✓

destAddress

IPv4 multicast destination, e.g. 239.255.0.1.

✓

destPort

UDP destination port. (default: 5400)

✗

payloadType

RTP payload type number (RFC 3550 dynamic range, 96-127) that downstream receivers see on the wire. Norsk's defaults (112 video, 111 audio) work for the vast majority of deployments — only override when a specific vendor controller has been hard-coded to expect a different value.

✗

sourcePort

UDP source port override. Defaults to the destination port if unset.

✗

ssrc

RTP SSRC pinned on the wire. Leave unset to let Norsk pick a random value at create time.

✗

tsRefclk

Override the SDP a=ts-refclk value. Norsk auto-derives from the Node clock when blank — only set this for deployments where the downstream expects a different grandmaster identifier.

✗

mediaclk

Override the SDP a=mediaclk value. Defaults to 'direct=0'; override only if the downstream expects a different mediaclk form.

✗

wireFormat

ST 2110-20 wire format — combines sampling and bit-depth. 10-bit 4:2:2 is the broadcast standard. (default: "YUV_422_10_BE")

✓

compliance

ST 2110-21 pacing profile. 'Narrow' is the deterministic profile required for full broadcast compliance; relax to 'Wide' only if downstream receivers can't keep up. (default: "narrow")

✓

Essences (Audio (2110-30))

Option Description Required

kind

Essence kind (set via the variant picker).

✓

destAddress

IPv4 multicast destination, e.g. 239.255.0.1.

✓

destPort

UDP destination port. (default: 5400)

✗

payloadType

RTP payload type number (RFC 3550 dynamic range, 96-127) that downstream receivers see on the wire. Norsk's defaults (112 video, 111 audio) work for the vast majority of deployments — only override when a specific vendor controller has been hard-coded to expect a different value.

✗

sourcePort

UDP source port override. Defaults to the destination port if unset.

✗

ssrc

RTP SSRC pinned on the wire. Leave unset to let Norsk pick a random value at create time.

✗

tsRefclk

Override the SDP a=ts-refclk value. Norsk auto-derives from the Node clock when blank — only set this for deployments where the downstream expects a different grandmaster identifier.

✗

mediaclk

Override the SDP a=mediaclk value. Defaults to 'direct=0'; override only if the downstream expects a different mediaclk form.

✗

ptime

Audio packet time in milliseconds. 1ms is the ST 2110-30 standard; 0.125ms (125µs) is used for low-latency-critical workflows. (default: 1)

✓

format

Wire-format encoding. (default: "PCM16")

✓

Essences (Ancillary (2110-40 — not yet supported))

Option Description Required

kind

Essence kind (set via the variant picker).

✓

destAddress

IPv4 multicast destination, e.g. 239.255.0.1.

✓

destPort

UDP destination port. (default: 5400)

✗

payloadType

RTP payload type number (RFC 3550 dynamic range, 96-127) that downstream receivers see on the wire. Norsk's defaults (112 video, 111 audio) work for the vast majority of deployments — only override when a specific vendor controller has been hard-coded to expect a different value.

✗

sourcePort

UDP source port override. Defaults to the destination port if unset.

✗

ssrc

RTP SSRC pinned on the wire. Leave unset to let Norsk pick a random value at create time.

✗

tsRefclk

Override the SDP a=ts-refclk value. Norsk auto-derives from the Node clock when blank — only set this for deployments where the downstream expects a different grandmaster identifier.

✗

mediaclk

Override the SDP a=mediaclk value. Defaults to 'direct=0'; override only if the downstream expects a different mediaclk form.

✗

Essences (Subtitles (2110-40 — not yet supported))

Option Description Required

kind

Essence kind (set via the variant picker).

✓

destAddress

IPv4 multicast destination, e.g. 239.255.0.1.

✓

destPort

UDP destination port. (default: 5400)

✗

payloadType

RTP payload type number (RFC 3550 dynamic range, 96-127) that downstream receivers see on the wire. Norsk's defaults (112 video, 111 audio) work for the vast majority of deployments — only override when a specific vendor controller has been hard-coded to expect a different value.

✗

sourcePort

UDP source port override. Defaults to the destination port if unset.

✗

ssrc

RTP SSRC pinned on the wire. Leave unset to let Norsk pick a random value at create time.

✗

tsRefclk

Override the SDP a=ts-refclk value. Norsk auto-derives from the Node clock when blank — only set this for deployments where the downstream expects a different grandmaster identifier.

✗

mediaclk

Override the SDP a=mediaclk value. Defaults to 'direct=0'; override only if the downstream expects a different mediaclk form.

✗

Global Configuration

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: