Contrato Central de Eventos — Zenith AutoOS
Este documento é a única fonte da verdade para nomes de eventos e comandos do barramento.
Qualquer novo evento ou comando deve ser adicionado aqui antes da implementação.
<dominio>.<subdominio>.<acao>.<qualificador?>
Exemplos: vehicle.handbrake.state, alert.overheat.trend, media.radio.rds.
Domínios
Domínio
Descrição
system
Sistema operacional, inicialização, desligamento
vehicle
Dados do veículo (CAN/OBD, sensores, estado)
alert
Alertas e notificações críticas
notification
Notificações gerais (fila, prioridade)
media
Áudio, rádio, mídia, podcasts
navigation
GPS, rota, destino, geofence
trip
Registro de viagens, telemetria
maintenance
Manutenção, documentos, custos
security
Alarme, inclinação, carro destrancado
display
Telas, temas, brilho, layout
profile
Perfis de motorista, convidado
device
ESP32, hardware físico, saídas
diagnostic
Alternador, caixa-preta, desempenho
🏠 README ·
📚 Documentação ·
⬅️ 38 · Godot ADAS ·
40 · Decisões ➡️
📑 Neste guia — 18 seções · ~6 min de leitura
🗺️ Visão geral em diagrama
Diagrama Mermaid Ampliar
flowchart LR
MODULES["Módulos Godot<br/>120–151"] --> BUS["EventBus<br/>singleton GDScript"]
BUS --> NOTIFY["NotificationCenter"]
BUS --> TRIP["TripLogger"]
BUS --> GEO["GeofenceEngine"]
BUS --> REMOTE["RemoteNotifier"]
NOTIFY --> UI["Cluster · Central · RSE"]
REMOTE --> CLOUD["MQTT · HTTP · Telegram"]
style BUS fill:#478CBF,color:#fff,stroke:#93C5FD
style UI fill:#0A5C36,color:#fff,stroke:#C8A951
style CLOUD fill:#26A5E4,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.
system.*
Evento
Direção
Payload
Descrição
system.boot.started
out
{}
Sistema iniciando
system.boot.completed
out
{version, mode}
Boot concluído (mode: bancada/producao)
system.shutdown.requested
in
{reason}
Solicita desligamento
system.shutdown.completed
out
{}
Desligamento concluído
system.feature_flag_changed
out
{flag, enabled}
Uma feature flag foi alterada
system.settings_changed
out
{key, value}
Uma configuração foi alterada
system.locale_changed
out
{locale}
Idioma alterado (pt-BR, en-US, es)
vehicle.*
Evento
Direção
Payload
Descrição
vehicle.speed.changed
out
{kmh, source}
Velocidade mudou
vehicle.rpm.changed
out
{rpm, source}
RPM mudou
vehicle.gear.changed
out
{gear}
Marcha mudou (P, R, N, D, 1-8)
vehicle.handbrake.state
out
{engaged}
Freio de mão puxado/solto
vehicle.driving_mode.changed
out
{mode}
eco, comfort, sport, track
vehicle.ignition.state
out
{on}
Ignição ligada/desligada
vehicle.door.state
out
{door, open}
Porta aberta/fechada
vehicle.trunk.state
out
{open}
Porta-malas aberto/fechado
vehicle.hood.state
out
{open}
Capô aberto/fechado
vehicle.seatbelt.state
out
{seat, fastened}
Cinto afivelado/desafivelado
vehicle.tire_pressure.changed
out
{tire, psi}
Pressão dos pneus
vehicle.fuel_level.changed
out
{liters, percent}
Nível de combustível
vehicle.engine_temp.changed
out
{celsius}
Temp. do motor
vehicle.oil_pressure.changed
out
{psi}
Pressão de óleo
vehicle.battery_voltage.changed
out
{volts}
Tensão da bateria
vehicle.headlights.state
out
{on}
Faróis ligados/desligados
vehicle.turn_signal.state
out
{direction}
left, right, hazard, off
vehicle.parking_brake.state
out
{engaged}
Freio de estacionamento
vehicle.obd.fault_code.added
out
{code, description, severity}
Código de falha OBD-II
vehicle.obd.fault_code.removed
out
{code}
Falha removida
vehicle.can.message_received
in
{can_id, data}
Quadro CAN recebido
vehicle.can.send
out
{can_id, data}
Enviar quadro CAN
alert.*
Evento
Direção
Payload
Descrição
alert.critical.displayed
out
{id, title, message, source}
Alerta crítico exibido
alert.critical.dismissed
out
{id}
Alerta crítico descartado
alert.overheat.trend
out
{temp_c, trend_c_per_min, level}
Tendência de superaquecimento
alert.overheat.high
out
{temp_c, limit_c}
Temperatura acima do limite
alert.handbrake_moving
out
{speed_kmh}
Freio de mão com carro em movimento
alert.vehicle_tailgating
out
{distance_m, seconds_gap}
Veículo colado atrás
alert.security.tilt
out
{angle_deg}
Inclinação detectada (alarme)
alert.security.unlocked_car
out
{reason}
Carro destrancado e esquecido
alert.security.alternator
out
{status, voltage, ripple}
Status do alternador
alert.impact_detected
out
{g_force, axis}
Impacto detectado (caixa-preta)
notification.*
Evento
Direção
Payload
Descrição
notification.added
out
{id, title, message, priority, expire_after}
Nova notificação na fila
notification.removed
out
{id}
Notificação removida
notification.displayed
out
{id, screen}
Notificação exibida em uma tela
notification.history.added
out
{id, ...}
Notificação adicionada ao histórico
notification.remote.sent
out
{id, provider}
Notificação enviada ao celular
notification.remote.failed
out
{id, error}
Falha ao enviar notificação remota
Evento
Direção
Payload
Descrição
media.playback.state
out
{state, source}
playing, paused, stopped
media.track.changed
out
{track}
Faixa atual mudou
media.source.changed
out
{source}
spotify, radio, usb, bluetooth
media.volume.changed
out
{zone, volume}
Zona: front, rear_left, rear_right
media.radio.rds
out
{name, text, program_type}
Dados RDS da rádio FM
media.radio.tuned
out
{frequency, band}
Rádio sintonizada
media.ducking.active
out
{side, target_zone}
Ducking de áudio ativo
media.ducking.inactive
out
{}
Ducking finalizado
navigation.*
Evento
Direção
Payload
Descrição
navigation.route.started
out
{destination, eta}
Navegação iniciada
navigation.route.updated
out
{eta, distance}
Rota atualizada
navigation.route.completed
out
{}
Destino alcançado
navigation.geofence.entered
out
{geofence_id, name}
Entrou em geofence
navigation.geofence.exited
out
{geofence_id, name}
Saiu de geofence
navigation.gps.update
out
{lat, lon, alt, speed, sats}
Update de GPS
navigation.destination.suggested
out
{destination, confidence}
Destino provável sugerido
trip.*
Evento
Direção
Payload
Descrição
trip.started
out
{trip_id, start_time}
Viagem detectada (ignição + movimento)
trip.updated
out
{trip_id, distance, duration, avg_speed, max_speed}
Viagem em andamento
trip.completed
out
{trip_id, total_distance, total_duration, fuel_consumed}
Viagem finalizada
trip.event.recorded
out
{trip_id, event_type, timestamp}
Evento de viagem (frenagem, etc.)
trip.gps.sample
out
{trip_id, lat, lon, timestamp}
Amostra GPS da viagem
maintenance.*
Evento
Direção
Payload
Descrição
maintenance.due_soon
out
{item, days_remaining}
Manutenção vencendo em breve
maintenance.due_now
out
{item}
Manutenção vencida
maintenance.recorded
out
{service_id, date, km, cost}
Serviço registrado
maintenance.odometer.changed
out
{km}
Odômetro atualizado
security.*
Evento
Direção
Payload
Descrição
security.alarm.armed
out
{mode}
Alarme armado
security.alarm.disarmed
out
{}
Alarme desarmado
security.alarm.triggered
out
{reason, severity>
Alarme disparado
security.car_unlocked_forgotten
out
{minutes}
Carro destrancado e esquecido
security.tilt_detected
out
{angle, reference}
Inclinação detectada
security.vibration_detected
out
{pattern}
Vibração (macaco/guincho)
display.*
Evento
Direção
Payload
Descrição
display.theme.changed
out
{theme}
Tema alterado (glass, oled, cyberpunk)
display.brightness.changed
out
{level}
Brilho alterado
display.screen.locked
out
{screen, reason}
Tela bloqueada (carro em movimento)
display.screen.unlocked
out
{screen}
Tela desbloqueada
profile.*
Evento
Direção
Payload
Descrição
profile.changed
out
{profile_id, name}
Perfil ativo alterado
profile.guest.entered
out
{}
Modo convidado ativado
profile.guest.exited
out
{}
Modo convidado desativado
profile.data.isolated
out
{profile_id}
Dados isolados por perfil
device.*
Evento
Direção
Payload
Descrição
device.esp32.connected
out
{}
ESP32 conectado
device.esp32.disconnected
out
{}
ESP32 desconectado
device.output.activated
out
{output, state}
Saída física ativada (pisca, luz, limpador)
device.output.deactivated
out
{output, state}
Saída física desativada
device.output.timeout
out
{output}
Timeout de segurança da saída
diagnostic.*
Evento
Direção
Payload
Descrição
diagnostic.alternator.test
out
{rpm, voltage, ripple, status}
Teste do alternador
diagnostic.blackbox.event
out
{event_id, duration_before, duration_after}
Evento da caixa-preta
diagnostic.performance.measurement
out
{test_type, result}
Medição de desempenho (0-100, etc.)
Regras de prioridade de exibição
Prioridade
Nível
Exibição acima de 20 km/h
Som
critical
3
Sempre (sobrescreve)
Sim, imediato
security
2
Sempre
Sim
informativo
1
Não (exceto segurança)
Opcional
Exemplos de uso no barramento
EventBus.emit("vehicle.speed.changed" , {"kmh" : 120.5 , "source" : "obd" })
EventBus.connect("vehicle.handbrake.state" , self , "_on_handbrake_changed" )
EventBus.emit("vehicle.can.send" , {"can_id" : 0x7DF , "data" : PackedByteArray([0x01 ])})
⬅️ 38 · Godot ADAS ·
⬆️ Topo ·
📚 Índice ·
40 · Decisões ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal