Skip to content

HDMI

media.ingest.hdmi

Descripción

Capture vídeo sin comprimir y audio embebido por HDMI con tarjetas DeckLink y la serie HWS (AVMatrix, Acasis). Las resoluciones y frecuencias dependen del modelo y de la señal de entrada.

Configuración

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

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

Parámetros

Parámetro Función
device Ruta obligatoria del dispositivo HDMI V4L2; se recomienda un enlace estable /dev/v4l/by-path/…
standard Estándar de señal opcional; si se omite, se detecta en la entrada
pixel_format 8 bits por defecto; v210 — 10 bits. HDMI RGB utiliza el ARGB negociado por el controlador
audio Lista de pistas de audio; una lista vacía selecciona una pista PCM estéreo del primer par de canales
audio[].channels Números de los canales de audio de entrada desde uno; el orden define la disposición de canales de la pista
audio[].sample_type pcm por defecto; smpte337 extrae audio comprimido AC-3/E-AC-3 de un par de canales
audio[].lang Idioma opcional de la pista
peer_timeout_ms Tiempo de espera de fotogramas en milisegundos; por defecto 30 000

Utilice la sección de entrada independiente hdmi. Los campos SDI ad_marks y timecode no están disponibles: HDMI no transporta VANC SCTE-104 ni código de tiempo ATC.

Ejemplo de una pista PCM estéreo explícita; su número corresponde a su posición en la lista audio, desde uno:

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

Opciones de transporte

La captura requiere un controlador de tarjeta HDMI con interfaz V4L2 y acceso al dispositivo para el proceso Sapsan. Al abrirlo se comprueba que el controlador lo identifique como HDMI; se rechazan los dispositivos SDI. Utilice un enlace estable /dev/v4l/by-path/….

Códecs admitidos

  • 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 y ARGB 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

El estado de la entrada y la causa del fallo están en las estadísticas del stream. Ante desconexión o ausencia de fotogramas se aplican los mecanismos de reintento y conmutación a reserva.

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.

Las estadísticas de entrada utilizan la categoría hdmi. Los contadores de hardware se comparten con SDI, pero el procesamiento VANC y ATC está desactivado: sus contadores no representan actividad 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

Otros detalles

Los fotogramas sin comprimir cargan PCIe y memoria independientemente del bitrate de salida. Dimensione las entradas según la capacidad real del bus, la resolución y la frecuencia.

Qué sigue