v11.0 · 151 Fases
ADAS & IA Fases 26–30, 89 Implementado · ~4 min (832 palavras) LoRaWebRTCCI/CDLLM
📄 docs/14-edgeml-lorav2v-valet-webrtc-cicd.md ↗

14 — Edge ML Preditivo, Rádio LoRa V2V, Valet/Antifurto, WebRTC Twin & CI/CD

Este documento cobre as camadas finais de inteligência preditiva, comunicação mesh, segurança física, acesso remoto e automação industrial (Fases 26, 27, 28, 29 e 30).

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

Categoria: ADAS & IA Fases: 26–30, 89 Status: Implementado LoRa: stack WebRTC: stack CI/CD: stack LLM: stack

🏠 README · 📚 Documentação · ⬅️ 13 · Fusão/ANC · 15 · DSP competição ➡️

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

Serviços conectados do Zenith AutoOS
Edge: manutenção preditiva, V2V, imobilizador e gêmeo digital remoto.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    SENSOR["Sensores veiculares"] --> ML["Isolation Forest<br/>Edge ML"]
    ML --> ALERT["Alerta preditivo"]
    LORA["SX1276 915 MHz"] <--> V2V["Outros veículos"]
    VALET["Valet + Geofence"] --> ESP["ESP32 / Imobilizador"]
    TWIN["WebRTC Twin 3D"] <--> CLOUD["WireGuard"]
    CI["Monolith CI/CD"] --> OTA["Pacote OTA"]

    style ML fill:#F97316,color:#fff,stroke:#FDBA74
    style LORA fill:#0EA5E9,color:#fff,stroke:#7DD3FC
    style CI fill:#2496ED,color:#fff,stroke:#93C5FD

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. Manutenção Preditiva Edge ML (SQLite + Isolation Forest — Fase 26)

  • Daemon: zenith_prognostics.py (zenith-prognostics.service)
  • Banco Histórico: SQLite em modo WAL (/data/ml/zenith_telemetry_history.db, retenção circular de 50.000 amostras) gravando RPM, temperatura da água, carga do motor, tensão, ripple do alternador e menor pressão TPMS.
  • Detecção de Anomalias & Prognóstico:
    • PureNumpyIsolationForest (48 árvores, sem dependência SciPy) calcula escores de anomalia multivariada retreinados periodicamente no histórico normal do veículo (com suporte opcional a .tflite).
    • Monitora assinatura de partida (cranking voltage sag < 9.6V* ou atraso *> 1800ms → estimativa battery_cca_pct) e ripple de alternador (> 180mV / < 13.1V acima de 1200 RPM), enviando alertas preventivos em "prognostics" para a interface 3D.

2. Comunicação Veículo-a-Veículo LoRaWAN Mesh (SX1276 915MHz — Fase 27)

  • Daemon: zenith_mesh_radio.py (zenith-v2v.service)
  • Camada Física: Driver SPI direto Semtech SX1276 (/dev/spidev0.0 via python-spidev, 915 MHz, SF7, BW 125 kHz, +17 dBm PA_BOOST) com fallback serial UART (/dev/zenith-lora). Kernel habilitado com CONFIG_SPI=y, CONFIG_SPI_SPIDEV=y e CONFIG_SPI_PXA2XX=y em linux.config.
  • Protocolo Binário Autenticado (19 bytes): ZV | HazardType | SenderID(32b) | Lat(i32) | Lon(i32) | Speed(u16) | CRC16-CCITT.
  • Operação: Ao receber evento de frenagem de emergência (<= -0.75G) ou buraco (/run/zenith/v2v_cmd.sock), transmite beacon GPS para carros num raio de até 5 km e alerta no Cluster + AR HUD + voz eSpeak.

3. Modo Manobrista (Valet) & Imobilizador Anti-Furto Ativo (Fase 28)

  • Daemon & Segurança: zenith_valet_immobilizer.py (zenith-valet.service)
  • UI Touch Lock: CentralWindow.gd apresenta teclado numérico modal bloqueando configurações, mídia e porta-malas até inserção do PIN validado com salt+SHA-256 (/data/security/valet_pin.json, PIN padrão 2026).
  • Atuação Física no ESP32 (firmware.ino):
    • Modo Valet: Trava abertura de porta-malas (trunk_lockout), silencia PipeWire (wpctl set-mute) e aciona corte progressivo de ignição (GPIO 33 PIN_SOFT_CUT) se RPM > 2500 ou Velocidade > 40 km/h.
    • Modo Antifurto / Geo-Fence (50 m): Ao sair do perímetro armado ou receber comando remoto autenticado, corta o relé da bomba de combustível (GPIO 25 PIN_FUEL_CUT) e pisca faróis/strobe agressivamente (GPIO 27 + MCP 0x20 bit 5 a cada 140 ms).

4. WebRTC "Gêmeo Digital" 3D Holístico (< 150ms via WireGuard — Fases 29 & 89)

  • Servidor WebRTC (aiortc + aiohttp): zenith_webrtc_twin.py (zenith-webrtc.service)
  • Cliente Digital Twin HTML5 / Three.js GLB: static/index.html
  • Recursos & Segurança Zero-Trust:
    • Transmite mosaico H.264/VP8 1280x360 @ 15 FPS das câmeras (/dev/video10, /dev/video12) + DataChannel JSON a 60 FPS (16 ms, RTT < 150 ms) com renderização 3D Three.js / WebGL (/models/*.glb) onde as rodas esterçam ao vivo pelo encoder do volante e giram na velocidade real.
    • Comandos remotos críticos (trunk, door_unlock, immobilizer) são assinados por ECDSA P-256 compatível com o HSM ATECC608 (Fase 83) e isolados no nftables.conf pela VPN WireGuard (wg0).

5. Produção Monolith CI/CD & Empacotamento Automático (Fase 30)

  • Container & Scripts de Produção:
    • Dockerfile.builder: ambiente Debian Bookworm com toolchain Buildroot, ladspa-sdk e Godot Engine 4.3 headless export.
    • flash-chroot.sh: executa sintaxe C++ LADSPA/ALSA & Vídeo C (DMABUF/Genlock), exportação .pck Godot, build Buildroot versionado via post-image.sh (zenith_autoos_v7.0.0.img + .sha256), dd para SSD NVMe e inspeção chroot.
  • Pipelines CI/CD:
  • Suíte de Testes com Telemetria Simulada: tests/test_zenith_embedded.py valida EKF/RPLIDAR/mmWave, SQLite + Isolation Forest, LoRa CRC-16, máquina de estados Valet/Anti-Furto, DSP/Energia/Vídeo e toda a pilha Bluetooth/LDAC/RGB/AEC/RSE/AVRCP 1.6/TPMS/PaaK (Fases 21–70).

⬅️ 13 · Fusão/ANC · ⬆️ Topo · 📚 Índice · 15 · DSP competição ➡️

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