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

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

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: