26 — Sistema Central de Gerenciamento de Configurações & Configurador de Garagem (FASE 118)
Este documento detalha a arquitetura completa da FASE 118 — Central Settings & Garage Setup, que unifica todos os controles das 117 fases anteriores em um painel modular na Godot Engine 4, persiste todo estado em tempo real num arquivo zenith_settings.yaml criptografado no NVMe (carregado em < 10 ms no boot) e realiza autoconfiguração veicular zero-intervenção a partir do catálogo zenith_vehicle_db.json.
🏠 README · 📚 Documentação · ⬅️ 25 · i18n/RTL · 27 · Branding ➡️
📑 Neste guia — 6 seções · ~8 min de leitura
- 1. Interface Modular "Configurações" na Godot Engine 4
- 2. Persistência Criptografada em Tempo Real (zenith_settings.yaml < 10 ms)
- 3. Catálogo Veicular (zenith_vehicle_db.json) & Modelos .GLB
- 4. Pipeline de Autoconfiguração Global Zero-Intervenção
- 5. API REST, Simulador & Cobertura de Testes
- 6. Extensão Schema v2 em zenith_settings_manager.py (Fases 120–138)
Configurações: YAML criptografado, catálogo Marca → Modelo → Ano e autoconfiguração.
1. Interface Modular "Configurações" na Godot Engine 4
Implementada em SettingsPanel.gd (SettingsMasterPanel) e integrada à tela principal em CentralWindow.gd através do botão Configurações (BtnConfiguracoesMaster):
Aba (TabContainer) |
Seção YAML | Principais Controles Implementados |
|---|---|---|
| 1. Veículo | vehicle |
Dropdowns encadeados dinâmicos Marca → Modelo → Ano (DropdownMarca, DropdownModelo, DropdownAno), pintura Clearcoat PBR (paint_hex), aro das rodas (14"–24"), intensidade Clearcoat/Metallic e resumo global em tempo real |
| 2. Áudio DSP | audio_dsp |
Slider Volume Mestre (0–100%), ganho subwoofer (-12 a +12 dB), preset EQ CamillaDSP, Sweet Spot, clock Bit-Perfect (48/96 kHz), Loudness Fletcher-Munson, ANC, ASD, proteção térmica e Spatial Chimes |
| 3. ADAS & Câmeras | adas_cameras |
Slider Sensibilidade do YOLO (yolo_sensitivity 0.15..0.95), leitura dinâmica da física de frenagem ADAS injetada pelo peso do veículo, auto-off câmera frontal e toggles ADAS 360°, BSW, LaneWatch PiP, Buracos/Lombadas, Pré-Tensionador, DVR, Sentry, LiDAR EKF e DMS |
| 4. Iluminação RGB | lighting_rgb |
Alimentação LED BLE/PWM, Color Picker (rgb_hex), brilho (0–100%), seletor de zona (all, starlight_roof, cabin_strips, doors), Music Sync RTA, Redline Strobe, BSW Flash e Follow-Me-Home |
| 5. Conectividade (Bluetooth/Wi-Fi) | connectivity |
Auto-Power BlueZ, Multiponto, Gateway BLE ESP32, Welcome Mode PaaK, Codec BT preferencial (LDAC, aptX HD, AAC, SBC), Hotspot Car_Hotspot (ZenithAutoOS-5G), mDNS RSE, V2X Mesh, MQTT e HomeLink Geofence (<= 30 m) |
| 6. Telas & Temas | displays_themes |
Slider Master Dimmer Global (0–100%), brilho RSE traseiro, seletor de tema (glassmorphism, cyberpunk_neon, minimalist_oled), cor primária Color-Sync e toggles True Tone VEML7700, Brilho Solar, Kawase Blur, Glitch, Wireframe ADAS, RSE Dual e Screensaver |
| 7. Sistema | system |
Seletor Idioma (10 locales i18n/gRPC), unidades (speed_unit, temp_unit, pressure_unit) e toggles Valet Mode, assinatura estrita HSM ATECC608, K3s Thermal Offload, LLM NCM Offline, Sandbox .pck USB e OTA Delta RAUC |
Cada Toggle (CheckButton), Slider (HSlider) e Seletor (OptionButton) emite setting_changed(section, key, value) e a seleção veicular emite vehicle_selected(brand, model, year), sincronizando imediatamente via ZenithMaster.gd (send_settings_patch / send_vehicle_select) sobre WebSocket (:8765 / :8000) e atualizando localmente ZenithThemeEngine e ZenithLocalization.
2. Persistência Criptografada em Tempo Real (zenith_settings.yaml < 10 ms)
Implementada por EncryptedYamlSettingsStore em zenith_settings_manager.py:
- Cifragem Autenticada AEAD:
- Utiliza AES-256-GCM com chave simétrica 256-bit provisionada em
/data/hsm/settings.key(ou derivada via variávelZENITH_SETTINGS_KEY, permissões0600) e AAD fixozenith-settings-v1(contando com fallback autenticadoHMAC-SHA256-CTRcaso a bibliotecacryptographyesteja ausente em ambientes dev/venv). - O arquivo no NVMe (
/data/config/zenith_settings.yaml) armazena um envelope YAML válido contendozenith_settings_version,cipher,key_id,nonce_b64eciphertext_b64, mantendo todo o payload interno cifrado. - Adulteração de ciphertext ou chave divergente dispara
SettingsIntegrityErrore restaura o fallback seguro padrão no boot sem quebrar a inicialização.
- Utiliza AES-256-GCM com chave simétrica 256-bit provisionada em
- Persistência Atômica & Orçamento
< 10 ms:- Gravação atômica via
.yaml.tmp(chmod 0600) +os.replace(). - Leitura binária direta e parsing em C via
yaml.CSafeLoader(BR2_PACKAGE_PYTHON_PYYAML=yhabilitado em zenith_autoos_defconfig e diretório/data/configprovisionado em zenith-runtime.conf e post-build.sh). - Orquestrada no boot pelo nó
"settings_nvme_decrypt"(budget_ms: 10.0) em zenith_boot_dag.py, antes de PipeWire, Coral TPU, SocketCAN e Godot HMI (active_phases: 118).
- Gravação atômica via
3. Catálogo Veicular (zenith_vehicle_db.json) & Modelos .GLB
Definido em zenith_vehicle_db.json com 9 veículos em 4 marcas, cada um acompanhado de malha glTF 2.0 binária gerada por generate_vehicle_glbs.py em board/zenith/rootfs_overlay/opt/zenith/hmi/project/assets/models/:
| ID | Marca | Modelo | Ano | Massa (mass_kg) |
Pneu / Aro | Ø Roda (mm) | Protocolo Bus | Modelo .GLB |
|---|---|---|---|---|---|---|---|---|
freelander_2006 |
Land Rover | Freelander 1 | 2006 | 1640.0 |
215/65R16 / 16" |
685.9 |
KWP2000 / SocketCAN-LR |
land_rover_freelander1_2006.glb |
freelander_2004 |
Land Rover | Freelander 1 | 2004 | 1580.0 |
195/80R15 / 15" |
693.0 |
ISO 9141-2 / KWP2000 |
land_rover_freelander1_2004.glb |
discovery3_2008 |
Land Rover | Discovery 3 | 2008 | 2494.0 |
235/65R17 / 17" |
737.3 |
SocketCAN-HS-500K |
land_rover_discovery3_2008.glb |
lexus_es300_1998 |
Lexus | ES 300 | 1998 | 1520.0 |
205/65R15 / 15" |
647.5 |
ISO 9141-2 / SocketCAN-LEXUS |
lexus_es300_1998.glb |
lexus_es300_2001 |
Lexus | ES 300 | 2001 | 1535.0 |
205/60R16 / 16" |
652.4 |
ISO 9141-2 / SocketCAN-LEXUS |
lexus_es300_2001.glb |
lexus_is300_2003 |
Lexus | IS 300 | 2003 | 1475.0 |
215/45R17 / 17" |
625.3 |
ISO 9141-2 / SocketCAN-LEXUS |
lexus_is300_2003.glb |
toyota_sw4_2012 |
Toyota | Hilux SW4 | 2012 | 2020.0 |
265/65R17 / 17" |
776.3 |
SocketCAN-TOYOTA / ISO 15765-4 |
toyota_sw4_2012.glb |
toyota_corolla_2018 |
Toyota | Corolla | 2018 | 1320.0 |
205/55R16 / 16" |
631.9 |
SocketCAN-TOYOTA / ISO 15765-4 |
toyota_corolla_2018.glb |
vw_golf_gti_2016 |
Volkswagen | Golf GTI | 2016 | 1382.0 |
225/45R17 / 17" |
634.3 |
SocketCAN-VW-UDS / ISO 15765-4 |
vw_golf_gti_2016.glb |
4. Pipeline de Autoconfiguração Global Zero-Intervenção
flowchart LR
U["SettingsPanel.gd / GarageConfigurator.gd<br/>(Marca -> Modelo -> Ano)"] -->|"WS settings_patch / vehicle_select<br/>ou REST /api/garage/select"| M["ZenithSettingsManager<br/>zenith_settings.yaml (AES-256-GCM)"]
M -->|"Lookup"| DB["VehicleDatabaseParser<br/>zenith_vehicle_db.json"]
M -->|"1. mass_kg + brake_decel"| ADAS["adas_radar.py + Radar3D.gd<br/>Energia Cinetica & AEB/FCW + YOLO Slider"]
M -->|"2. injection_pids + protocolo<br/>/run/zenith/can_vehicle_config.json"| BUS["zenith_can_bridge.c (Fase 71)<br/>+ zenith_telemetry.py (OBD/K-Line)"]
M -->|"3. diameter_mm -> speed_correction_factor"| ODO["zenith_maintenance_db.py<br/>+ ClusterWindow.gd (Odometro & Velocimetro)"]
M -->|"4. glb_res_path / paint_hex"| HMI["VehicleShowcase3D.gd (CentralWindow.gd)<br/>+ GarageConfigurator.gd + Radar3D.gd"]- Peso do Veículo → Frenagem ADAS (
compute_adas_braking_physics): calcula energia cinética (0.5 * m * v²), fator de desaceleração efetiva e distâncias dinâmicasaeb_danger_distance_mefcw_warning_distance_m, atualizando adas_radar.py e Radar3D.gd (danger_distance_m,warning_distance_m). - PIDs de Injeção → Rede CAN/K-Line (Fase 71): escreve
/run/zenith/can_vehicle_config.jsone enviaset_vehicle_can_configpara/run/zenith/can_cmd.sock; zenith_can_bridge.c passa a decodificar frames do perfil ativo (Land Rover / Lexus / BYD / OBD-II CAN / K-Line0x0B,0x11,0x2F,0x42) enquantoTelemetryDaemon._reload_vehicle_cfg()em zenith_telemetry.py reordenaANALOG_PROTOCOLS("5","4","3"para KWP2000 vs"3","5","4"para ISO 9141-2) e atualiza_active_injection_pids.can_kline_config.redline_rpmajusta o tacômetro de ClusterWindow.gd. - Diâmetro das Rodas → Velocímetro & Odômetro (
compute_wheel_calibration): calcula circunferência (π * Ø), rotações/km espeed_correction_factor=effective_diameter_mm / stock_diameter_mm, corrigindo velocidade bruta emzenith_can_bridge.c,zenith_telemetry.pyezenith_simulator_core.py, além de escalar o incremento de odômetro emMaintenanceDatabase.update_telemetry()(zenith_maintenance_db.py). - Modelo 3D
.GLBRotativo na Tela Principal: carregado viaObjMeshLoader.load_gltf_scene()(ObjMeshLoader.gd) no palco central VehicleShowcase3D.gd (VehicleShowcaseCenter3Dem CentralWindow.gd), na gaveta GarageConfigurator.gd e como ego-veículo em Radar3D.gd.
5. API REST, Simulador & Cobertura de Testes
- FastAPI Backend (backend/app/routers/settings.py) e Simulador (zenith_simulator_core.py):
GET /api/settings— snapshot completo das 7 abas, metadadossettings_persistence(cipher,boot_load_ms,path) evehicle_autoconfig.POST /api/settings— atualização parcial em tempo real (formato tabular{section, key, value}, aninhado por aba ou atalhos flat) sincronizada comaudio_service,locale_service,theme_sync_servicee filtragemyolo_sensitivityem/api/simulator/yolo.GET /api/garage/vehicles— árvore encadeadaMarca -> Modelo -> Ano, lista completa de veículos e configuração ativa.POST /api/garage/select— seleção porbrand+model+year(comwheel_rim_inchesopcional) ouvehicle_id.
- Suítes Automatizadas:
test_fase_118_settings_encrypted_yaml_and_garage_autoconfigem tests/test_zenith_embedded.py.test_fase_118_central_settings_and_garage_autoconfigem backend/tests/test_api.py.
6. Extensão Schema v2 em zenith_settings_manager.py (Fases 120–138)
O arquivo zenith_settings_manager.py (schema_version: 2) e as 7 abas de SettingsPanel.gd foram expandidos com as chaves persistidas das 19 funções novas:
vehicle:comfort_close_on_lock,sunroof_close_on_lock,fuel_tank_capacity_l,fuel_price_brl.adas_cameras:safe_exit_enabled,lead_departure_enabled,tsr_enabled,ldw_enabled,radar_alerts_enabled,crash_sos_enabled,park_assist_directional_audio,birdseye_360_enabled.lighting_rgb:auto_headlights_enabled,auto_headlights_lux_thresh,bulb_outage_monitor_enabled.connectivity:openauto_enabled,telegram_enabled,telegram_bot_token,telegram_allowed_chat_ids,telegram_emergency_chat_id,home_wifi_ssid,garage_sync_mode("auto"/"ask"/"never"),garage_sync_nas_target,garage_sync_dashcam,garage_sync_media,garage_sync_ota.system:dtc_pt_llm_enabled,trip_logbook_auto,driving_score_enabled.
⬅️ 25 · i18n/RTL · ⬆️ Topo · 📚 Índice · 27 · Branding ➡️
Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026 · README principal