v11.0 · 151 Fases
Visão Geral Fases 1–151 Atualizado · ~9 min (1.691 palavras) MermaidGuias 01–41Trilhas
📄 docs/README.md ↗

Zenith AutoOS

Documentação Zenith AutoOS

33 guias técnicos · 151 fases · 157.358+ veículos · LLM, Voz Neural & Mapa 3D 100% offline

Documentos Fases Offline AI & Mapa 3D Status

🏠 README principal · 🧭 Trilhas · 📚 Índice · 🖼️ Galeria · 📊 Cobertura


🧭 Trilhas de leitura

Escolha o caminho de acordo com o seu objetivo. Cada trilha foi ordenada para evitar pré-requisitos quebrados.

Trilha Para quem Sequência recomendada
🚀 Primeiro contato Quem acabou de clonar o repositório 01 — Arquitetura → 08 — Buildroot → 24 — Simulador → 06 — Instalação
🔌 Bancada e hardware Eletrônica, instalação e retrofit 02 — Elétrica/ESP32 → 33 — Hardware completo → 19 — CAN/gRPC → 16 — Energia
🎨 HMI e experiência UI/UX, Godot, frontend e branding 34 — Design System → 11 — Multi-screen → 21 — Temas → 33 — Mapa 3D, LLM & Voz → 25 — i18n/RTL
🧠 ADAS, IA e dados Visão computacional, LLM, voz e mapas 3D 07 — ADAS 360° → 23 — LLM/SDK → 33 — LLM/Voz/Mapa 3D Offline → 28 — Banco de veículos → 29 — Segurança ADAS
🔧 Integração e API Backend, apps e automações 05 — API/IPC → 19 — gRPC/CAN → 26 — Settings → 32 — Conectividade

🗺️ Mapa da documentação

Diagrama Mermaid
flowchart LR
    subgraph BASE["🏗️ Base"]
        D01["01 · Arquitetura"]
        D02["02 · Elétrica/ESP32"]
        D08["08 · Buildroot/Kernel"]
        D10["10 · OTA A/B"]
        D19["19 · CAN/gRPC"]
    end

    subgraph MEDIA["🎬 Áudio & Vídeo"]
        D03["03 · DSP 6ch"]
        D09["09 · DVR"]
        D15["15 · DSP competição"]
        D17["17 · DRM/KMS"]
    end

    subgraph HMI["🎨 HMI & Design"]
        D11["11 · Multi-screen"]
        D21["21 · Temas"]
        D22["22 · Digital Twin"]
        D25["25 · i18n"]
        D27["27 · Branding"]
        D34["34 · Design System"]
    end

    subgraph INTELL["🧠 Inteligência"]
        D07["07 · ADAS 360°"]
        D13["13 · Fusão/ANC"]
        D20["20 · V2X/HSM"]
        D23["23 · LLM/SDK"]
        D29["29 · Segurança ADAS"]
        D30["30 · Conforto 360°"]
        D31["31 · DTC/Diário"]
        D33["33 · LLM, Voz & Mapa 3D"]
    end

    subgraph OPS["🛠️ Operação"]
        D05["05 · API"]
        D06["06 · Instalação"]
        D12["12 · Rede/Segurança"]
        D24["24 · Simulador"]
        D28["28 · Banco veicular"]
        D32["32 · Conectividade"]
    end

    BASE --> MEDIA
    BASE --> HMI
    BASE --> INTELL
    BASE --> OPS
    D05 --> D11
    D05 --> D24
    D07 --> D29
    D28 --> D26
    D26 --> D11

    style BASE fill:#0A5C36,color:#fff,stroke:#C8A951
    style MEDIA fill:#123A52,color:#fff,stroke:#38BDF8
    style HMI fill:#3B2452,color:#fff,stroke:#C084FC
    style INTELL fill:#4A2B12,color:#fff,stroke:#F59E0B
    style OPS fill:#1E3A34,color:#fff,stroke:#2DD4BF

Legenda: 🟢 base concluída · 🔵 mídia e vídeo · 🟣 HMI · 🟠 inteligência · 🟦 operação. As cores dos diagramas seguem a identidade visual do Zenith AutoOS.


📚 Índice completo

🏗️ Arquitetura, sistema embarcado e hardware

# Documento Fases O que você encontra
01 Arquitetura Geral & Perfis Dual-Vehicle 1–119 Camadas do SO, mapa de serviços systemd, sockets IPC, perfis Freelander/Lexus e evolução 120–138.
02 Hardware, Elétrica, ESP32, PC817, Relés, MOSFET & I2C 1–151 Safe shutdown, pinagem ESP32, MCP23017/PCA9685, isolação 12 V, sensores e atuadores.
08 Buildroot Core, Kernel Linux 6.6 & Boot < 5 s 1–119 Árvore BR2_EXTERNAL, defconfig, kernel cirúrgico, pós-build e imagem versionada.
10 OTA Seguro: RAUC, A/B e Rollback GRUB2 10, 80 Partições GPT, bundles .raucb, deltas por chunks, troca de slot e crash reporter.
16 Gestão de Energia, ULP, INA226, UPS, Solar & IA 41–50 Corte em < 11,9 V, coulomb counting, supercapacitor, MPPT e saúde preditiva da bateria.
19 SocketCAN, ESP32 FreeRTOS, gRPC, mDNS, HIL, PTP & OTA 71–80 Bridge CAN em C, TWAI 2 Mbaud, Protobuf, descoberta mDNS, ECU flasher e sincronismo IEEE 1588.
33 Especificações Completas de Hardware v2.0 1–151 BOM de 76 itens, 3 níveis de custo, pinagens, mapas I2C/CAN, orçamento de energia e homologação.

🎬 Áudio, vídeo e câmeras

# Documento Fases O que você encontra
03 Áudio DSP 6 Canais, Vídeo & Câmeras 360° 3–60 PipeWire + CamillaDSP, matriz Mid/Side, crossovers FIR, asound.conf bit-perfect e v4l2loopback.
09 DVR Dual-Channel VAAPI & Modo Sentinela 9, 53 Splitter zero-copy /dev/video10..13, gravação HEVC de 3 min e buffer circular de 50 GB.
15 DSP de Competição Audiófila 31–40 Auto-EQ REW/UMIK-1, FIR 4096 taps, Fletcher-Munson, Ambisonics, limiter e RTA 3D.
17 Engenharia de Vídeo, DRM/KMS, RSE, Touch & 3D LUT 51–60 EDID spoofing, multi-seat RSE, DMA-BUF EGL, QuickSync 4K, matrix touch, backlight e Plymouth.

🎨 HMI, design e experiência

# Documento Fases O que você encontra
11 Dual-Screen Godot 4, Voz Offline, GPS & DMS 12–136 Weston multi-monitor, janelas Godot, Vosk/eSpeak, gpsd, fadiga/gestos e expansões 101–138.
21 Temas, Color-Sync, Dimmer, Plymouth & VFSX 91–95 Protocolo binário < 10 ms, dimmer logarítmico DDC/CI, splash DRM e shader reativo à telemetria.
22 Garagem 3D, True Tone, Micro-Animações, Branding & 60 FPS 96–100 Clearcoat PBR, VEML7700, física de mola, identidade visual e pipeline síncrono de 16,667 ms.
25 i18n Global, RTL, Unidades & Hot-Swap de Voz 117 10 locales, inversão RTL, conversão de unidades e troca a quente de modelos via gRPC.
26 Configurações Centrais & Configurador de Garagem 118 Painel de 7 abas, YAML com AES-256-GCM, catálogo Marca → Modelo → Ano e autoconfiguração global.
27 Identidade Visual, Logotipo & Branding Cross-Platform 99–118 Assets oficiais, paleta, SVG/TTF, Plymouth, Godot, React, Cluster UI e validação automatizada.
34 Manual de UI/UX & Design System 90–100 Grid 8 px, layout das 4 telas, temas, tipografia, iconografia, micro-interações e shaders Godot 4.

🧠 ADAS, inteligência artificial e dados

# Documento Fases O que você encontra
07 ADAS 360° 3D: 8 Câmeras, Coral TPU & Godot 5–25 Calibração das câmeras, estimação monocular, YOLOv8 na Coral e renderização DRM/Wayland.
13 Fusão EKF, ANC, AR HUD, Biometria & Track Day 21–25 LiDAR + mmWave + YOLO, ANC 40–120 Hz, projeção no para-brisa, FPM10A e IMU 100 Hz.
14 Edge ML, LoRa V2V, Valet, WebRTC & CI/CD 26–30, 89 Isolation Forest, rádio SX1276, imobilizador geofence, gêmeo digital remoto e pipeline Monolith.
20 V2X, Pothole, HSM, Bio-Feedback, K3s, Tribologia & Boot DAG 81–90 SPaT/GLOSA, ATECC608 ECC, energia topográfica SRTM, K3s térmico, óleo por IA e boot < 3,5 s.
23 LLM Local, SDK Sandbox, Welcome, Clima, Sentry, BSW, LaneWatch & Saúde 101–110 llama.cpp, plugins .pck isolados, perfil BLE, MQTT, dashcam sentinela, BSW e chime espacial.
28 Banco Global de Veículos: ETL Offline & Cache 119 Parser NHTSA .bak, OpenDBC/OBDb, cache anti-duplicação e SQLite com 157.358+ veículos.
29 Segurança ADAS Avançada no Dia a Dia 120–125 Safe Exit, “carro da frente andou”, placas R-19, LDW, radares offline e SOS Telegram.
30 Conforto, Retrofit e Vista 360° de Manobra 126–131 Farol automático, A/C digital, lâmpada queimada, fechamento de vidros, PDC e bird's-eye.
31 DTC em Português, Custo em R$, Diário e Nota 132–135 Explicador de falhas, consumo real, abastecimento automático, logbook CSV e nota de condução.
33 LLM Qwen2.5, Voz Neural, Visores 3D & Mapa MapLibre/Valhalla 101–138+ Modelos GGUF/Whisper/Vosk/Piper offline, visores com carros/motos/pessoas (sem quadrados) e MapLibre 3D + 945 mil prédios OSM + Valhalla.

🔌 Conectividade, API e operação

# Documento Fases O que você encontra
04 Bluetooth, OBD-II, TPMS BLE & RGB 4–70 ELM327 a 15 Hz, ISO 9141-2/KWP2000, TPMS BLE, BlueZ multiponto e iluminação RGB sincronizada.
05 API REST, IPC & WebSocket Unificado 4–119 Hub :8765 a 60 Hz, sockets /run/zenith, gRPC/Protobuf, FastAPI e todos os endpoints.
06 Instalação no Raspberry Pi 4 (Kiosk) 1–20 Dependências, build, systemd, dual-screen, HDMI → CVBS e ajustes de vídeo.
12 LTE, Hotspot, Cibersegurança, Watchdog, MQTT & QEMU 15–138 Wardriving, nftables/IDS, self-healing, Home Assistant, QEMU, Telegram e garage sync.
18 Bluetooth Multiponto, Áudio Audiófilo, PaaK & BLE Gateway 61–70 LDAC/aptX HD, AEC, dual A2DP, AVRCP 1.6, TPMS, PaaK, gateway ESP32 e watchdog HCI0.
24 Simulador Multi-Janela, Câmeras Virtuais, DevTools & HomeLink 111–116 setup_demo, telemetria fantasma, YOLO fake, 4 displays, God Mode e RF CC1101.
32 Android Auto/CarPlay, Telegram & Garage Sync 136–138 aasdk/openauto, bot autenticado e sincronização Wi-Fi em auto/ask/never.

📎 Documentos complementares

Documento Conteúdo
Relatório de Implementação 120–151 32 fases Godot, EventBus, NotificationCenter, TripLogger, banco de testes e estrutura final.
SDK de Plugins Isolados Manifesto plugin.json, permissões, sandbox LXC/chroot e carregamento seguro de .pck.
Godot ADAS 360° Cliente standalone, AdasRadar3D.gd, WebSocket e integração com o HMI embarcado.
Contrato de Eventos Fonte única de verdade para nomes, direções e payloads do barramento de eventos.
Decisões de Arquitetura ADRs da implementação autônoma das fases 120–151.
GDExtension CAN Integração nativa SocketCAN ↔ Godot 4.

📊 Cobertura por fase

Diagrama Mermaid
timeline
    title 151 fases do Zenith AutoOS
    section Base & HMI
        Fases 1–20 : Buildroot, kernel, ESP32, OBD-II, áudio, câmeras
    section ADAS & DSP
        Fases 21–40 : Coral TPU, fusão EKF, ANC, AR HUD, DSP 6ch
    section Energia & Vídeo
        Fases 41–60 : ULP, INA226, UPS, solar, DRM/KMS, RSE, 3D LUT
    section Conectividade & OTA
        Fases 61–80 : Bluetooth, SocketCAN, gRPC, mDNS, HIL, PTP, OTA
    section Inteligência & Tema
        Fases 81–100 : V2X, HSM, K3s, digital twin, temas, 60 FPS
    section IA & Globalização
        Fases 101–119 : LLM, SDK, i18n, settings, banco de veículos
    section Veículo & Conectividade
        Fases 120–151 : segurança ADAS, retrofit 360°, DTC, CarPlay, garagem
Diagrama Mermaid
pie showData
    title Documentação por categoria (33 guias)
    "ADAS & IA" : 7
    "HMI & Design" : 6
    "Áudio & Vídeo" : 4
    "Conectividade" : 4
    "Embedded & Arquitetura" : 4
    "API, Dados & Operação" : 4
    "Hardware & Energia" : 2
    "Conforto & Inteligência" : 2

🖼️ Galeria

HMI Zenith AutoOS — Hyper-Cockpit 3D, OBD-II, DSP 6 canais e Configurações
HMI multi-janela: Hyper-Cockpit 3D · OBD-II/Fases 132–135 · DSP 6 canais · Temas, i18n e Garagem 3D

Cinco layouts do cluster digital 1920×720
Cluster 1920×720: MoTeC Pro-R · Virtual Cockpit · Lexus Optitron · Crimson GT · Hexagon Twin


📐 Convenções desta documentação

Símbolo Significado
✅ Fase implementada e coberta por testes ou validação de bancada.
🧪 Comportamento validado no simulador/DevTools.
🔌 Requer hardware físico para validação final.
⚠️ Atenção: envolve segurança veicular, alta corrente ou homologação.
📎 Documento complementar ou referência cruzada.
  • Todos os links são relativos ao repositório e funcionam no GitHub.
  • Códigos, caminhos e nomes de arquivos usam a mesma nomenclatura do projeto.
  • Valores em R$ refletem a estimativa de novembro de 2026.
  • Diagramas usam Mermaid nativo do GitHub; não é necessário instalar nada.

🔗 Voltar

🏠 README principal · 🎨 Design System · 🔩 Hardware · 🧩 SDK

Zenith AutoOS 11.0 · Documentação técnica · Novembro de 2026