29 — Segurança ADAS Avançada no Dia a Dia (Fases 120–125)
Este documento detalha as 6 funções de segurança ativa no dia a dia implementadas nas Fases 120 a 125 sobre o pipeline ADAS/DVR/GPS do Zenith AutoOS (zenith_safety_adas.py, zenith_radar_db.py e zenith_crash_sos.py).
🏠 README · 📚 Documentação · ⬅️ 28 · Banco veicular · 30 · Retrofit 360° ➡️
📑 Neste guia — 7 seções · ~4 min de leitura
- 🗺️ Visão geral em diagrama
- Fase 120 — Aviso ao Abrir a Porta (SafeExitAssist)
- Fase 121 — "O Carro da Frente Andou" (LeadVehicleDepartureMonitor)
- Fase 122 — Leitura de Placas de Velocidade & Destaque Laranja no Cluster (TrafficSignSpeedRecognizer)
- Fase 123 — Alerta de Saída de Faixa (LaneDepartureDetector)
- Fase 124 — Base de Radares Offline (OfflineRadarDatabase)
- Fase 125 — Detecção de Batida, Trava da Dashcam & SOS no Telegram (CrashDetectionCoordinator)
Segurança ativa: Safe Exit, lead departure, placas R-19, LDW e SOS Telegram.
🗺️ Visão geral em diagrama
flowchart LR
CAM["Câmeras 360°"] --> SAFE["Safe Exit Assist"]
RADAR["Radares"] --> LEAD["Lead Vehicle Departure"]
SIGN["Placas R-19"] --> SPEED["Alerta de velocidade"]
LDW["LDW OpenCV"] --> ALERT["Cluster / HUD"]
CRASH["MPU6050"] --> SOS["Trava DVR + SOS Telegram"]
SAFE --> ALERT
LEAD --> ALERT
SPEED --> ALERT
style SAFE fill:#F97316,color:#fff,stroke:#FDBA74
style SOS fill:#B45309,color:#fff,stroke:#FCD34D
style ALERT 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 120 — Aviso ao Abrir a Porta (SafeExitAssist)
- Objetivo: Evitar colisões contra motos e bicicletas que se aproximam por trás ou pelas laterais enquanto o carro está estacionado.
- Lógica embarcada (zenith_safety_adas.py):
- Arma quando
speed_kmh <= 3.0 km/he detecta objetos vulneráveis (Moto,Bicicleta,Bicycle,Motorcycle) nas câmeras traseiras/laterais dentro da zona lateral de porta (distance_m <= 18.0 m). - Quando o firmware do ESP32 (firmware.ino) envia
EVENT:DOOR_HANDLE(puxão de maçaneta) ou porta entreaberta (doors) correspondente ao mesmo lado da ameaça (fl/rlesquerda oufr/rrdireita):- O LED da porta no ESP32 pisca em vermelho (
#FF0000, comandodoor_exit_alert). - O daemon de áudio direcional (zenith_spatial_chime.py) reproduz o alerta exclusivamente no alto-falante físico daquela porta (
fl→ch0,fr→ch1,rl→ch2,rr→ch3). - O cluster exibe banner SAFE EXIT vermelho no ClusterWindow.gd e em SafetyClusterHUD.tsx.
- O LED da porta no ESP32 pisca em vermelho (
- Arma quando
Fase 121 — "O Carro da Frente Andou" (LeadVehicleDepartureMonitor)
- Objetivo: Reduzir distrações parado no semáforo quando o tráfego à frente avança.
- Funcionamento:
- Monitora o veículo líder frontal (
pos_zentre1.2 me24.0 m) quando o veículo próprio fica parado (speed_kmh <= 1.5 km/h) por pelo menosdwell_stopped_sec = 1.2s. - Se a distância ao carro à frente aumentar
>= 2.2 mapósreaction_grace_sec = 0.8se o motorista permanecer parado, aciona o aviso sonoro discretoplay_lead_departure_chime()e exibe"O carro da frente andou".
- Monitora o veículo líder frontal (
Fase 122 — Leitura de Placas de Velocidade & Destaque Laranja no Cluster (TrafficSignSpeedRecognizer)
- Detecção: Segmenta círculos vermelhos (padrão brasileiro R-19) em espaço HSV na câmera frontal OpenCV (
cv2.inRange+ circularidade) ou recebe limite da base offline de radares / API. - Exibição & Excesso de Velocidade:
- O cluster exibe o círculo branco com borda vermelha e o limite ativo em km/h.
- Se a velocidade atual ultrapassar
limit_kmh(overspeed = True),speed_hexpassa para#F97316(laranja) e os dígitos do velocímetro no ClusterWindow.gd, ClusterLayouts.tsx e GhostCluster1920x720.tsx mudam automaticamente para laranja.
Fase 123 — Alerta de Saída de Faixa (LaneDepartureDetector)
- Pipeline OpenCV (com fallback NumPy): Converte para HLS, isola pintura branca/amarela na região trapezoidal da pista, aplica
Canny+HoughLinesPpara ajustar bordas esquerda/direita da faixa. - Regra de Seta: Se o deslocamento lateral ultrapassar o limiar em velocidade de rodovia sem a respectiva seta acionada (
turn_left/turn_right), dispara alerta vibratório/sonoro exatamente no lado da invasão (play_lane_departure_warning(depart_side)). Se a seta do lado correspondente estiver ligada,suppressed_by_blinker = Truee nenhum falso alarme é emitido.
Fase 124 — Base de Radares Offline (OfflineRadarDatabase)
- Armazenamento: Banco SQLite WAL local (
/data/nav/radars.db) populado inicialmente com amostra brasileira (radars_br_sample.csv) e importável por CSV (POST /api/nav/radars/import) sem internet ou Waze. - Geometria: Calcula distância exata via fórmula de Haversine e verifica cone direcional à frente em relação ao rumo GPS (
heading_deg/track_deg), integrando-se ao zenith_gps_nav.py.
Fase 125 — Detecção de Batida, Trava da Dashcam & SOS no Telegram (CrashDetectionCoordinator)
- Detecção física: O MPU6050 no firmware ESP32 (firmware.ino) detecta pico de aceleração em condução (
>= 3.2 G) e enviaEVENT:CRASH_IMPACT. - Resposta automática (zenith_crash_sos.py):
- Copia e trava os clipes ativos da dashcam para
/data/dvr/locked/<event_id>/(impedindo sobrescrita cíclica do DVR em zenith_dvr.py). - Gera payload SOS com coordenadas GPS + link Google Maps e dispara via zenith_telegram_bot.py para o
emergency_chat_idconfigurado (ou coloca em fila offline caso esteja temporariamente sem sinal celular).
- Copia e trava os clipes ativos da dashcam para
⬅️ 28 · Banco veicular · ⬆️ Topo · 📚 Índice · 30 · Retrofit 360° ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal