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.
🏠 README · 📚 Documentação · ⬅️ 29 · Segurança ADAS · 31 · DTC/Viagens ➡️
📑 Neste guia — 7 seções · ~3 min de leitura
- 🗺️ Visão geral em diagrama
- Fase 126 — Farol Automático via Sensor VEML7700 (AutoHeadlightsController)
- Fase 127 — Ar-Condicionado Automático Digital (AutoClimateController)
- Fase 128 — Detecção de Lâmpada Queimada (BulbOutageMonitor)
- Fase 129 — Fechamento de Conforto ao Trancar
- Fase 130 — Sensor de Estacionamento com Som Direcional DSP 6 Canais
- Fase 131 — Vista de Cima 360° Bird's-Eye por Homografia (BirdEye360Stitcher)
Retrofit: farol automático, A/C digital, lâmpada queimada, vidros e Bird's-Eye 360°.
🗺️ Visão geral em diagrama
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:#C8A951Como 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.
- Túnel: Queda brusca para luminosidade baixa acende o farol imediatamente (
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ão22 °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 de2 °Cno evaporador.
- Calcula erro térmico
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.
- Compara corrente medida contra o limiar mínimo apenas nos circuitos que estão ligados no momento (
Fase 129 — Fechamento de Conforto ao Trancar
- Firmware + Backend: Ao executar trancamento (
POST /api/hardware/lockou pulso do controle original / Telegram/trancarcomcomfort_close_on_lock = true), a funçãotriggerComfortCloseWindows()no ESP32 aciona sequencialmente os módulos de subida dos 4 vidros elétricos (e teto solar se habilitado), atualizandowindows_closed = true.
Fase 130 — Sensor de Estacionamento com Som Direcional DSP 6 Canais
- Integração Áudio DSP: Os sensores ultrassônicos (
PDC_ULTRA @ 0x57para cantosfl,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 sinkzenith.spatial_chime(channelmix.disable = true).- A tela exibe simultaneamente as distâncias exatas em
cmpara 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:
- Remove distorção radial das 4 câmeras olho de peixe (
cv2.fisheye.undistortImage). - Projeta cada quadro no plano zenital mediante matrizes de homografia
3×3calibráveis (cv2.getPerspectiveTransform/ DLT SVD em NumPy fallback). - 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.
- Remove distorção radial das 4 câmeras olho de peixe (
⬅️ 29 · Segurança ADAS · ⬆️ Topo · 📚 Índice · 31 · DTC/Viagens ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal