12G-SDI¶

media.ingest.sdi_12g

Описание¶

media.ingest.sdi_12g расширяет базовый приём SDI. Расширение включает код обработки особо высокой нагрузки, приближающейся к пределам современного оборудования. При таких скоростях сервер учитывает NUMA, а проектировщик должен учитывать реальную пропускную способность шины памяти.

Настройка¶

Настройка выполняется через API central. Фрагмент конфигурации стрима:

streams:
- name: source1
  inputs:
  - sdi:
      device: /dev/v4l/by-path/pci-0000:5e:00.0-video-index0
      standard: uhd2160p50
      pixel_format: v210

Параметры¶

Параметр	Описание
—	Поля совпадают с базовым SDI.
`standard`	На 12G-портах DTA-2178 задайте `standard` явно, чтобы приёмник мог начать захват.

Варианты транспорта¶

Для захвата нужен драйвер карты с интерфейсом V4L2 и доступ процесса Sapsan к устройству. Используйте устойчивый путь /dev/v4l/by-path/….

Поддерживаемые кодеки¶

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 и v210 — форматы несжатых пикселей, а PCM — несжатый звук; это не видеокодеки H.264/HEVC. Для сжатого выхода настройте транскодирование. AC-3/E-AC-3 извлекаются из звуковой пары только при sample_type: smpte337; SMPTE ST 337 описывает упаковку, а не отдельный аудиокодек.

Поведение при ошибках¶

Состояние входа и причина отказа доступны в статистике стрима. При обрыве или отсутствии кадров действует общий механизм повторных подключений и переключения на резерв.

Применение изменений¶

Изменения передаются через API central. При изменении адреса источника или формата захват открывается заново; это может прервать приём на время подключения. После применения проверьте состояние входа и поступление кадров.

Счётчики¶

Ниже — точные имена полей протокольной статистики. counter накапливает события, gauge показывает текущее значение; список включает оба вида. Нулевые поля могут отсутствовать в ответе. API и Prometheus используют разные проекции: весь список не следует ожидать в одном ответе Admin API. Доступ к детализации зависит от лицензии на счётчики.

Общие показатели входа: bytes, frames, errors, warnings. Они суммируют данные протокола, поэтому складывать их с протокольными счётчиками повторно не нужно.

Sdi¶

Поле	Тип
`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`

Прочее¶

Несжатые кадры нагружают PCIe и память независимо от битрейта кодированного выхода. При расчёте числа входов учитывайте реальные возможности шины и выбранные разрешение и частоту.