Skip to content

HDMI

media.ingest.hdmi

Descrição

Capture vídeo sem compressão e áudio embutido por HDMI com placas DeckLink e a série HWS (AVMatrix, Acasis). Resoluções e frequências dependem do modelo e do sinal de entrada.

Configuração

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

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

Parâmetros

Parâmetro Função
device Caminho obrigatório do dispositivo HDMI V4L2; prefira um link estável /dev/v4l/by-path/…
standard Padrão de sinal opcional; quando omitido, é detectado na entrada
pixel_format 8 bits por padrão; v210 — 10 bits. HDMI RGB usa o ARGB negociado pelo driver
audio Lista de trilhas de áudio; uma lista vazia seleciona uma trilha PCM estéreo do primeiro par de canais
audio[].channels Números dos canais de áudio de entrada a partir de um; a ordem define a disposição dos canais da trilha
audio[].sample_type pcm por padrão; smpte337 extrai áudio comprimido AC-3/E-AC-3 de um par de canais
audio[].lang Idioma opcional da trilha
peer_timeout_ms Tempo limite de quadros em milissegundos; padrão de 30.000

Use a seção de entrada separada hdmi. Os campos SDI ad_marks e timecode não estão disponíveis: HDMI não transporta VANC SCTE-104 nem timecode ATC.

Exemplo de uma trilha PCM estéreo explícita; seu número corresponde à posição na lista audio, a partir de um:

hdmi:
  device: /dev/v4l/by-path/pci-0000:5e:00.0-video-index0
  audio:
  - channels: [1, 2]
    sample_type: pcm
    lang: eng

Opções de transporte

A captura exige um driver de placa HDMI com interface V4L2 e acesso ao dispositivo pelo processo Sapsan. Ao abrir o dispositivo, verifica-se se o driver o identifica como HDMI; dispositivos SDI são rejeitados. Use um link estável /dev/v4l/by-path/….

Codecs compatíveis

  • UYVY 4:2:2 (8-bit)
  • v210 4:2:2 (10-bit)
  • ARGB (HDMI RGB)
  • PCM
  • AC-3 (SMPTE ST 337)
  • E-AC-3 (SMPTE ST 337)

UYVY, v210 e ARGB 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

O estado da entrada e a causa da falha estão nas estatísticas do stream. Desconexão ou ausência de quadros usa os mecanismos de repetição e comutação para reserva.

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.

As estatísticas de entrada usam a categoria hdmi. Os contadores de hardware são compartilhados com SDI, mas o processamento VANC e ATC está desativado: seus contadores não representam atividade HDMI.

HDMI

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

Quadros sem compressão carregam PCIe e memória independentemente do bitrate de saída. Dimensione as entradas pela capacidade real do barramento, resolução e frequência.

Próximos passos