12G-SDI¶
media.ingest.sdi_12g
Description¶
media.ingest.sdi_12g extends basic SDI ingest. It includes processing code for particularly heavy loads approaching modern hardware limits. At these rates, the server accounts for NUMA and the system designer must account for actual memory bus bandwidth.
Configuration¶
Configure the stream through the central API. Stream configuration fragment:
streams:
- name: source1
inputs:
- sdi:
device: /dev/v4l/by-path/pci-0000:5e:00.0-video-index0
standard: uhd2160p50
pixel_format: v210
Parameters¶
| Parameter | Description |
|---|---|
| — | Fields match basic SDI. |
standard |
Set standard explicitly on DTA-2178 12G ports so the receiver can start capture. |
Transport options¶
Capture requires a card driver exposing V4L2 and device access for Sapsan. Use a stable /dev/v4l/by-path/… path.
Supported codecs¶
- UYVY 4:2:2 (8-bit)
- v210 4:2:2 (10-bit)
- PCM
- AC-3 (SMPTE ST 337)
- E-AC-3 (SMPTE ST 337)
UYVY and v210 are uncompressed pixel formats, and PCM is uncompressed audio; they are not H.264/HEVC video codecs. Configure transcoding for compressed output. AC-3/E-AC-3 are extracted from an audio channel pair only with sample_type: smpte337; SMPTE ST 337 describes the packaging, not a separate audio codec.
Error handling¶
Input state and failure cause are available in stream statistics. Connection loss or missing frames uses the shared retry and failover mechanisms.
Applying changes¶
Apply changes through the central API. Changing the source address or format reopens capture and may interrupt ingest while connecting. Check input state and arriving frames afterwards.
Counters¶
The tables give exact protocol statistics field names, including event counters and current-value gauges. Zero fields may be omitted. API and Prometheus expose different projections; the full list is not necessarily present in one Admin API response. Detailed statistics depend on the counter license.
Common input totals: bytes, frames, errors, warnings. They aggregate protocol data and must not be added to protocol counters again.
Sdi¶
| Field | Type |
|---|---|
line_state |
gauge |
producer_restarts |
counter |
producer_restarts_wrong_standard |
counter |
producer_restarts_silence |
counter |
datagrams |
counter |
boundary_loss |
counter |
crc_errors |
counter |
unsupported_codec |
counter |
vanc_unknown |
counter |
vanc_cdp |
counter |
vanc_cdp_pairs |
counter |
ad_marks |
counter |
errors_ad_marks_dropped |
counter |
warning_ad_mark_descriptors_dropped |
counter |
timecode_missing |
counter |
timecode_rejected |
counter |
timecode_untrusted |
counter |
timecode_jumps |
counter |
Other details¶
Uncompressed frames load PCIe and memory independently of the encoded output bitrate. Size the number of inputs using actual bus capacity and the selected resolution and frame rate.