SDI¶

media.ingest.sdi

Descripción¶

Sapsan recibe vídeo sin comprimir y audio embebido de tarjetas SDI. Familias admitidas:

DekTec
DeckLink
AJA
Streamlabs
Softlab
Magewell
Acasis

12G-SDI es una ampliación independiente. La salida SDI y la captura ASI tienen páginas separadas.

Configuración¶

Configure el stream mediante la API de central. Fragmento de configuración:

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

Parámetros¶

Campo	Finalidad
`device`	Ruta del dispositivo de captura V4L2; obligatoria
`standard`	Estándar opcional, como `hd1080i50` o `uhd2160p50`. Se detecta a partir de la señal; indíquelo si el controlador no puede detectarlo antes de iniciar la captura
`pixel_format`	8 bits, predeterminado; `v210`: 10 bits
`audio`	Lista de pistas de audio; por defecto, estéreo de los canales 1–2
`ad_marks`	Recibir marcadores SCTE-104 de VANC; activado por defecto
`timecode`	Usar código de tiempo ATC; activado por defecto
`peer_timeout_ms`	Tiempo de espera de fotogramas; 30 000 ms por defecto

Opciones de transporte¶

La captura requiere un controlador con V4L2 y acceso al dispositivo para Sapsan. Utilice una ruta estable /dev/v4l/by-path/….

Códecs admitidos¶

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 y v210 son formatos de píxeles sin comprimir, y PCM es audio sin comprimir; no son códecs de vídeo H.264/HEVC. Configure transcodificación para obtener una salida comprimida. AC-3/E-AC-3 se extraen de un par de canales de audio solo con sample_type: smpte337; SMPTE ST 337 describe el empaquetado, no un códec de audio independiente.

Comportamiento ante errores¶

Cuando desaparece la señal, la entrada espera su recuperación durante peer_timeout_ms; al agotarse el plazo, la causa del fallo es no_signal. Un cambio de estándar de vídeo reinicia la captura con los nuevos parámetros. Si el dispositivo está ocupado, compruebe la dirección del puerto y los procesos que lo utilizan.

La entrada utiliza los mecanismos comunes de reintento y conmutación a reserva. Si el formato del dispositivo es incompatible, compruebe que esté instalado un controlador compatible con la tarjeta.

Aplicación de cambios¶

Aplique los cambios mediante la API de central. Cambiar la dirección o el formato vuelve a abrir la captura y puede interrumpirla durante la conexión. Compruebe después el estado y la llegada de fotogramas.

Contadores¶

Las tablas indican los nombres exactos de los campos de estadísticas del protocolo, incluidos contadores de eventos e indicadores del valor actual. Los campos nulos pueden omitirse. API y Prometheus exponen proyecciones distintas; un único resultado de Admin API no incluye necesariamente toda la lista. El detalle depende de la licencia de contadores.

Totales comunes de entrada: bytes, frames, errors, warnings. Agregan datos del protocolo; no deben sumarse otra vez a los contadores del protocolo.

Sdi¶

Campo	Tipo
`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`

Otros detalles¶

Pistas de audio¶

La posición en audio define el número de pista de audio del stream. channels contiene los números de canales de audio SDI, del 1 al 16, en el orden deseado; lang es el idioma según ISO 639-2. Un canal no puede pertenecer a dos pistas. Una lista vacía selecciona estéreo del primer par.

sample_type: pcm selecciona audio sin comprimir. Si un canal transporta datos en lugar de PCM, se sustituye por silencio en la pista PCM.

AC-3 y E-AC-3 mediante SMPTE 337¶

Para audio comprimido en un par de canales SDI, configure sample_type: smpte337 y exactamente dos números de canal. La entrada extrae AC-3 o E-AC-3 sin decodificarlos a PCM. Los tipos no admitidos, incluido Dolby E, y los modos ST 337 de 20/24 bits se contabilizan en sdi_unsupported_codec_total.

audio:
  - channels: [1, 2]
    lang: rus
  - channels: [3, 4]
    sample_type: smpte337
    lang: rus

Datos auxiliares VANC¶

OP-47 y teletexto VBI alimentan la pista de teletexto.
SCTE-104 se convierte en marcadores de la pista común scte35; consulte SCTE-35 para la entrega posterior.
CDP (CEA-608/708) se analiza y se contabiliza; no genera una pista de subtítulos independiente.
Código de tiempo ATC se utiliza cuando timecode está activado.
Pares DID/SDID desconocidos se contabilizan.

Captura y salida son funciones independientes. La salida requiere un puerto de salida; ASI tiene una página separada.