v11.0 · 151 Fases
HMI & Design Fases 118 Implementado · ~7 min (1.399 palavras) YAMLAES-256-GCMSQLiteGodot 4
📄 docs/26-configuracoes-centrais-garagem-autoconfig-fase-118.md ↗

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.

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

Categoria: HMI & Design Fases: 118 Status: Implementado YAML: stack AES-256-GCM: stack SQLite: stack Godot 4: stack

🏠 README · 📚 Documentação · ⬅️ 25 · i18n/RTL · 27 · Branding ➡️

📑 Neste guia — 6 seções · ~8 min de leitura

Painel de configurações em 7 abas
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ável ZENITH_SETTINGS_KEY, permissões 0600) e AAD fixo zenith-settings-v1 (contando com fallback autenticado HMAC-SHA256-CTR caso a biblioteca cryptography esteja ausente em ambientes dev/venv).
    • O arquivo no NVMe (/data/config/zenith_settings.yaml) armazena um envelope YAML válido contendo zenith_settings_version, cipher, key_id, nonce_b64 e ciphertext_b64, mantendo todo o payload interno cifrado.
    • Adulteração de ciphertext ou chave divergente dispara SettingsIntegrityError e restaura o fallback seguro padrão no boot sem quebrar a inicialização.
  • 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=y habilitado em zenith_autoos_defconfig e diretório /data/config provisionado 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).

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

Diagrama Mermaid
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"]
  1. 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âmicas aeb_danger_distance_m e fcw_warning_distance_m, atualizando adas_radar.py e Radar3D.gd (danger_distance_m, warning_distance_m).
  2. PIDs de Injeção → Rede CAN/K-Line (Fase 71): escreve /run/zenith/can_vehicle_config.json e envia set_vehicle_can_config para /run/zenith/can_cmd.sock; zenith_can_bridge.c passa a decodificar frames do perfil ativo (Land Rover / Lexus / BYD / OBD-II CAN / K-Line 0x0B, 0x11, 0x2F, 0x42) enquanto TelemetryDaemon._reload_vehicle_cfg() em zenith_telemetry.py reordena ANALOG_PROTOCOLS ("5","4","3" para KWP2000 vs "3","5","4" para ISO 9141-2) e atualiza _active_injection_pids. can_kline_config.redline_rpm ajusta o tacômetro de ClusterWindow.gd.
  3. Diâmetro das Rodas → Velocímetro & Odômetro (compute_wheel_calibration): calcula circunferência (π * Ø), rotações/km e speed_correction_factor = effective_diameter_mm / stock_diameter_mm, corrigindo velocidade bruta em zenith_can_bridge.c, zenith_telemetry.py e zenith_simulator_core.py, além de escalar o incremento de odômetro em MaintenanceDatabase.update_telemetry() (zenith_maintenance_db.py).
  4. Modelo 3D .GLB Rotativo na Tela Principal: carregado via ObjMeshLoader.load_gltf_scene() (ObjMeshLoader.gd) no palco central VehicleShowcase3D.gd (VehicleShowcaseCenter3D em 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, metadados settings_persistence (cipher, boot_load_ms, path) e vehicle_autoconfig.
    • POST /api/settings — atualização parcial em tempo real (formato tabular {section, key, value}, aninhado por aba ou atalhos flat) sincronizada com audio_service, locale_service, theme_sync_service e filtragem yolo_sensitivity em /api/simulator/yolo.
    • GET /api/garage/vehicles — árvore encadeada Marca -> Modelo -> Ano, lista completa de veículos e configuração ativa.
    • POST /api/garage/select — seleção por brand + model + year (com wheel_rim_inches opcional) ou vehicle_id.
  • Suítes Automatizadas:

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