v11.0 · 151 Fases
Documentação & Contratos Fases 120–151 Contrato · ~6 min (1.057 palavras) EventBusGDScriptMQTT
📄 ZenithAutoOS/docs/eventos.md ↗

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.

Formato de nomeaçã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

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

Categoria: Documentação Fases: 120–151 Status: Contrato EventBus: stack GDScript: stack MQTT: stack

🏠 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
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

media.*

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

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

gdscript
# Publicar evento
EventBus.emit("vehicle.speed.changed", {"kmh": 120.5, "source": "obd"})

# Assinar evento
EventBus.connect("vehicle.handbrake.state", self, "_on_handbrake_changed")

# Comando (requisição)
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