v11.0 · 151 Fases
Hardware & Energia Fases 126–131 Implementado · ~4 min (693 palavras) VEML7700PDCOpenCV
📄 docs/30-conforto-retrofit-360-fases-126-131.md ↗

30 — Conforto, Retrofit e Vista 360° de Manobra (Fases 126–131)

Este documento descreve as 6 funções que modernizam o veículo antigo com recursos de carro novo, cobrindo as Fases 126 a 131.

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

Categoria: Hardware & Energia Fases: 126–131 Status: Implementado VEML7700: stack PDC: stack OpenCV: stack

🏠 README · 📚 Documentação · ⬅️ 29 · Segurança ADAS · 31 · DTC/Viagens ➡️

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

Clima e conforto no HMI
Retrofit: farol automático, A/C digital, lâmpada queimada, vidros e Bird's-Eye 360°.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    VEML["VEML7700"] --> HEAD["Farol automático"]
    SHT["SHT31"] --> CLIMA["A/C digital"]
    INA["INA219"] --> BULB["Lâmpada queimada"]
    LOCK["Trancamento"] --> WIN["Fechamento de vidros"]
    PDC["Ultrassom"] --> DSP["Som direcional DSP"]
    CAM["4 câmeras"] --> BIRD["Bird's-Eye 360°"]

    style HEAD fill:#F59E0B,color:#111,stroke:#FDE68A
    style CLIMA fill:#0EA5E9,color:#fff,stroke:#7DD3FC
    style BIRD 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.

Fase 126 — Farol Automático via Sensor VEML7700 (AutoHeadlightsController)

  • Módulo: zenith_brightness_sync.py + leitura I2C VEML7700 (0x10) no ESP32.
  • Lógica anti-pisca:
    • Túnel: Queda brusca para luminosidade baixa acende o farol imediatamente (reason = "tunnel").
    • Anoitecer: Abaixo do limiar crepuscular configurado por tempo sustentado (dusk_delay_sec) liga o relé de faróis no ESP32.
    • Dia: Só apaga quando a luz solar permanece acima do limiar superior por daylight_delay_sec, evitando oscilação embaixo de árvores/viadutos.

Fase 127 — Ar-Condicionado Automático Digital (AutoClimateController)

  • Hardware: Sensor digital de temperatura/umidade na cabine SHT31 (0x44) + sensor evaporador + PWM ventilador/embreagem do compressor no firmware.ino.
  • Malha fechada (zenith_smart_hvac.py):
    • Calcula erro térmico cabin_temp_c - target_temp_c (padrão 22 °C) e regula automaticamente velocidade do ventilador (1..7), compressor e recirculação.
    • Inclui proteção anticongelamento do evaporador (evap_freeze_guard): desliga o compressor abaixo de 2 °C no evaporador.

Fase 128 — Detecção de Lâmpada Queimada (BulbOutageMonitor)

  • Hardware: Shunt + sensor de corrente I2C INA219 (0x45) monitorando as linhas de luzes de freio, lanternas traseiras e faróis quando energizadas.
  • Diagnóstico (zenith_bulb_monitor.py):
    • Compara corrente medida contra o limiar mínimo apenas nos circuitos que estão ligados no momento (circuits_on).
    • Se um circuito acionado cair abaixo da corrente mínima, emite exatamente o aviso legível em português, como "Luz de freio esquerda queimada", propagado no cluster e na interface Web/Godot.

Fase 129 — Fechamento de Conforto ao Trancar

  • Firmware + Backend: Ao executar trancamento (POST /api/hardware/lock ou pulso do controle original / Telegram /trancar com comfort_close_on_lock = true), a função triggerComfortCloseWindows() no ESP32 aciona sequencialmente os módulos de subida dos 4 vidros elétricos (e teto solar se habilitado), atualizando windows_closed = true.

Fase 130 — Sensor de Estacionamento com Som Direcional DSP 6 Canais

  • Integração Áudio DSP: Os sensores ultrassônicos (PDC_ULTRA @ 0x57 para cantos fl, fr, rl, rr) enviam distâncias em centímetros.
  • Som por canal físico (zenith_spatial_chime.py):
    • play_park_assist_directional() sintetiza arquivo WAV 6 canais com cadência e frequência proporcionais à proximidade apenas no canal do alto-falante correspondente (fl→0, fr→1, rl→2, rr→3), usando o sink zenith.spatial_chime (channelmix.disable = true).
    • A tela exibe simultaneamente as distâncias exatas em cm para cada canto.

Fase 131 — Vista de Cima 360° Bird's-Eye por Homografia (BirdEye360Stitcher)

  • Módulo: zenith_birdseye_360.py + serviço systemd zenith-birdseye.service.
  • Pipeline:
    1. Remove distorção radial das 4 câmeras olho de peixe (cv2.fisheye.undistortImage).
    2. Projeta cada quadro no plano zenital mediante matrizes de homografia 3×3 calibráveis (cv2.getPerspectiveTransform / DLT SVD em NumPy fallback).
    3. Faz blending ponderado nas junções, desenha a silhueta central do carro, linhas dinâmicas curvas pelo ângulo de esterçamento e medições PDC, entregando frame JPEG/PNG ao vivo em GET /api/cameras/360/frame.

⬅️ 29 · Segurança ADAS · ⬆️ Topo · 📚 Índice · 31 · DTC/Viagens ➡️

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