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.
🏠 README · 📚 Documentação · ⬅️ 08 · Buildroot · 10 · OTA A/B ➡️
📑 Neste guia — 3 seções · ~3 min de leitura
Câmeras: splitter zero-copy, gravação HEVC e buffer circular.
🗺️ Visão geral em diagrama
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:#C8A951Como 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):
/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
1080pbruta e realiza downscale viascale_vaapiem 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=15eIOSchedulingClass=idlepara nunca prejudicar o pipe de áudio DSP nem a taxa de60 Hzda HMI 3D. - Pipeline GStreamer QuickSync H.265 Zero-Copy (
Fase 59):gst-launch-1.0captura/dev/video98emio-mode=dmabuf, comprime viavaapih265enc/vah265enc(15 Mbps) abaixo de5%de CPU e segmenta porsplitmuxsink(fallback automático paraffmpeg hevc_vaapi/libx264). - Sentinela Radar & Solar (
Fases 43 e 49): grava por60 sao despertar via radarRCWL-0516(GPIO 39) ou continuamente de forma gratuita enquanto a geração solar MPPT exceder> 15 W. - Segmentação Contínua: Grava blocos
.mp4de 3 minutos (180 s) commovflags=+faststartem:/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.mp4mais antigos até manter o consumo total abaixo de50 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ômetroMPU6050 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 exatamente120sdas câmeras Frontal e Traseira no pendrive USB (/media/usb*/zenith_sentry, fallback/data/dvr/sentry), executasync, enviaCMD:SENTRY_DONEe retorna à hibernação.
⬅️ 08 · Buildroot · ⬆️ Topo · 📚 Índice · 10 · OTA A/B ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal