v11.0 · 151 Fases
Áudio & Vídeo Fases 9–53 Implementado · ~3 min (566 palavras) VA-APIHEVCv4l2loopbackDVR
📄 docs/09-dvr-sentinela-vaapi.md ↗

09 — Sistema DVR Dual-Channel VAAPI & Modo Sentinela (v4l2loopback)

Este documento descreve o subsistema de gravação contínua de vídeo (Fase 9), projetado para operar em segundo plano sem competir com a inferência de visão computacional do ADAS.

Zenith AutoOS: 11.0.0 Fases: 151 Guias: 33 Idioma: PT-BR

Categoria: Áudio & Vídeo Fases: 9–53 Status: Implementado VA-API: stack HEVC: stack v4l2loopback: stack DVR: stack

🏠 README · 📚 Documentação · ⬅️ 08 · Buildroot · 10 · OTA A/B ➡️

📑 Neste guia — 3 seções · ~3 min de leitura

Câmeras e DVR no HMI
Câmeras: splitter zero-copy, gravação HEVC e buffer circular.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    CAM["Câmera frontal / traseira"] --> SPLIT["Splitter V4L2"]
    SPLIT --> DVR["zenith_dvr.py"]
    DVR --> VAAPI["VA-API HEVC<br/>QuickSync"]
    VAAPI --> RING["Buffer circular 50 GB"]
    RING --> MP4["/data/dvr/*.mp4"]
    IMPACT["MPU6050<br/>Sentinela"] --> LOCK["/data/dvr/locked"]
    LOCK --> MP4

    style CAM fill:#555555,color:#fff,stroke:#CBD5E1
    style VAAPI fill:#334155,color:#fff,stroke:#94A3B8
    style RING fill:#0A5C36,color:#fff,stroke:#C8A951

Como ler: o diagrama resume o fluxo principal deste guia; os detalhes, pinagens, endpoints e trechos de código aparecem nas seções abaixo.

1. Arquitetura Zero-Copy para Acesso Simultâneo (v4l2loopback)

Como dispositivos V4L2 físicos (/dev/video0 e /dev/video7) aceitam apenas um consumidor exclusivo por vez, o serviço zenith-v4l2-splitter.service executa zenith_v4l2_splitter.sh sobre o módulo v4l2loopback (v4l2loopback.conf):

text
/dev/video0 (Frontal 1920x1080 MJPG) ---> /dev/video98 (1080p Bruto -> GStreamer QuickSync HEVC 15Mbps)
                                     |--> /dev/video99 (640x480 VAAPI -> Coral YOLO Tensor)
                                     '--> /dev/video10 / video11 (Aliases legados ADAS/DVR)

/dev/video7 (Traseira 640x480 MJPG) --> ffmpeg (-c:v copy) ---> /dev/video12 (adas_radar.py)
                                                            '--> /dev/video13 (zenith_dvr.py)
  • O zenith_v4l2_splitter.sh clona a saída 1080p bruta e realiza downscale via scale_vaapi em silício Intel (sem sobrecarregar CPU).

2. Gravação QuickSync HEVC (H.265) / VAAPI & Buffer Circular de 50 GB

Implementado em zenith_dvr.py e zenith_hevc_recorder.sh, gerenciado por zenith-dvr.service:

  • Prioridade Baixa (QoS): Roda com Nice=15 e IOSchedulingClass=idle para nunca prejudicar o pipe de áudio DSP nem a taxa de 60 Hz da HMI 3D.
  • Pipeline GStreamer QuickSync H.265 Zero-Copy (Fase 59): gst-launch-1.0 captura /dev/video98 em io-mode=dmabuf, comprime via vaapih265enc / vah265enc (15 Mbps) abaixo de 5% de CPU e segmenta por splitmuxsink (fallback automático para ffmpeg hevc_vaapi / libx264).
  • Sentinela Radar & Solar (Fases 43 e 49): grava por 60 s ao despertar via radar RCWL-0516 (GPIO 39) ou continuamente de forma gratuita enquanto a geração solar MPPT exceder > 15 W.
  • Segmentação Contínua: Grava blocos .mp4 de 3 minutos (180 s) com movflags=+faststart em:
    • /data/dvr/front/front_YYYYMMDD_HHMMSS.mp4
    • /data/dvr/rear/rear_YYYYMMDD_HHMMSS.mp4
  • Buffer Circular (50 GB): A cada 15 segundos, contabiliza o uso em /data/dvr/ e exclui automaticamente os segmentos .mp4 mais antigos até manter o consumo total abaixo de 50 GiB (preservando os arquivos ativos em gravação).
  • Dashcam Estacionária / Sentry Mode 2 Minutos (Fase 106): Com o veículo desligado (ACC OFF), o PC e as câmeras permanecem offline; ao detectar impacto no acelerômetro MPU6050 0x68 (deltaG >= 0.45 G) ou aproximação no PIR (GPIO 39), o ESP32 desperta o PC e o zenith-sentry.service (zenith_sentry_guard.py + zenith_sentry_capture.sh) grava exatamente 120s das câmeras Frontal e Traseira no pendrive USB (/media/usb*/zenith_sentry, fallback /data/dvr/sentry), executa sync, envia CMD:SENTRY_DONE e retorna à hibernação.

⬅️ 08 · Buildroot · ⬆️ Topo · 📚 Índice · 10 · OTA A/B ➡️

Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal