SDI¶

media.ingest.sdi

Descrição¶

O Sapsan recebe vídeo sem compressão e áudio embutido de placas SDI. Famílias compatíveis:

DekTec
DeckLink
AJA
Streamlabs
Softlab
Magewell
Acasis

12G-SDI é uma extensão independente. A saída SDI e a captura ASI têm páginas separadas.

Configuração¶

Configure o stream pela API do central. Trecho de configuração:

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

Parâmetros¶

Campo	Finalidade
`device`	Caminho do dispositivo de captura V4L2; obrigatório
`standard`	Padrão opcional, como `hd1080i50` ou `uhd2160p50`. Detectado a partir do sinal por padrão; informe-o se o driver não conseguir detectá-lo antes da captura
`pixel_format`	8 bits, padrão; `v210`: 10 bits
`audio`	Lista de trilhas de áudio; por padrão, estéreo dos canais 1–2
`ad_marks`	Receber marcadores SCTE-104 de VANC; ativado por padrão
`timecode`	Usar timecode ATC; ativado por padrão
`peer_timeout_ms`	Tempo de espera de quadros; 30.000 ms por padrão

Opções de transporte¶

A captura requer driver com V4L2 e acesso ao dispositivo para o Sapsan. Use um caminho estável /dev/v4l/by-path/….

Codecs compatíveis¶

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 e v210 são formatos de pixels sem compressão, e PCM é áudio sem compressão; não são codecs de vídeo H.264/HEVC. Configure transcodificação para obter uma saída comprimida. AC-3/E-AC-3 são extraídos de um par de canais de áudio somente com sample_type: smpte337; SMPTE ST 337 descreve o empacotamento, não um codec de áudio separado.

Comportamento em caso de erro¶

Quando o sinal desaparece, a entrada aguarda seu retorno durante peer_timeout_ms; após o prazo, a causa da falha é no_signal. Uma mudança do padrão de vídeo reinicia a captura com os novos parâmetros. Se o dispositivo estiver ocupado, verifique a direção da porta e os processos que o utilizam.

A entrada usa os mecanismos comuns de repetição e comutação para reserva. Se o formato do dispositivo for incompatível, verifique se está instalado um driver compatível com a placa.

Aplicação de alterações¶

Aplique as alterações pela API do central. Alterar o endereço ou o formato reabre a captura e pode interrompê-la durante a conexão. Verifique depois o estado e a chegada de quadros.

Contadores¶

As tabelas mostram os nomes exatos dos campos de estatísticas do protocolo, incluindo contadores de eventos e indicadores do valor atual. Campos zerados podem ser omitidos. API e Prometheus expõem projeções diferentes; uma única resposta da Admin API não contém necessariamente toda a lista. O detalhe depende da licença de contadores.

Totais comuns da entrada: bytes, frames, errors, warnings. Eles agregam dados do protocolo; não devem ser somados novamente aos contadores do 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`

Outros detalhes¶

Trilhas de áudio¶

A posição em audio define o número da trilha de áudio do stream. channels contém os números dos canais de áudio SDI, de 1 a 16, na ordem desejada; lang é o idioma segundo a ISO 639-2. Um canal não pode pertencer a duas trilhas. Uma lista vazia seleciona estéreo do primeiro par.

sample_type: pcm seleciona áudio sem compressão. Se um canal transportar dados em vez de PCM, ele é substituído por silêncio na trilha PCM.

AC-3 e E-AC-3 via SMPTE 337¶

Para áudio comprimido em um par de canais SDI, configure sample_type: smpte337 e exatamente dois números de canal. A entrada extrai AC-3 ou E-AC-3 sem decodificação para PCM. Tipos não compatíveis, incluindo Dolby E, e modos ST 337 de 20/24 bits são contabilizados em sdi_unsupported_codec_total.

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

Dados auxiliares VANC¶

OP-47 e teletexto VBI alimentam a trilha de teletexto.
SCTE-104 é convertido em marcadores da trilha comum scte35; consulte SCTE-35 para a entrega posterior.
CDP (CEA-608/708) é analisado e contabilizado; não gera uma trilha de legendas independente.
Timecode ATC é usado quando timecode está ativado.
Pares DID/SDID desconhecidos são contabilizados.

Captura e saída são funções independentes. A saída requer uma porta de saída; ASI tem uma página separada.