v11.0 · 151 Fases
Documentação & Contratos Fases 5–100 Manual · ~4 min (801 palavras) Godot 4WebSocketADAS
📄 godot_adas/README.md ↗

Godot Engine 4 — Cliente 3D ADAS 360° & HMI Multi-Window (Fases 5, 12, 21, 23, 25, 28, 40, 48, 55, 57, 60 e 91–100)

O projeto conta com dois pontos de entrada Godot 4 alinhados ao protocolo WebSocket: a HMI embarcada multi-window e o cliente standalone de desenvolvimento.

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

Categoria: Documentação Fases: 5–100 Status: Manual Godot 4: stack WebSocket: stack ADAS: stack

🏠 README · 📚 Documentação · ⬅️ 37 · SDK de Plugins · 39 · Eventos ➡️

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

Radar ADAS e layouts Godot
Godot ADAS: dois pontos de entrada, Radar3D e integração com o hub WebSocket.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    HUB["Hub WebSocket<br/>ws://127.0.0.1:8765"] --> MASTER["ZenithMaster.gd"]
    MASTER --> PIPELINE["ZenithRenderPipeline.gd<br/>16,667 ms"]
    PIPELINE --> CL["ClusterWindow.gd<br/>1920×720"]
    PIPELINE --> CE["CentralWindow.gd<br/>1920×1080"]
    PIPELINE --> HUD["AR_HUD.gd<br/>1280×720"]
    MASTER --> RADAR["Radar3D.gd"]
    RADAR --> SPAWN["Carro · Moto · Pessoa · Buraco"]
    MASTER --> STANDALONE["AdasRadar3D.gd<br/>cliente standalone"]

    style HUB fill:#0A5C36,color:#fff,stroke:#C8A951
    style MASTER fill:#478CBF,color:#fff,stroke:#93C5FD
    style RADAR fill:#F97316,color:#fff,stroke:#FDBA74

Como ler: o diagrama resume o fluxo principal deste guia; os detalhes, pinagens, endpoints e trechos de código aparecem nas seções abaixo.

1. HMI Embarcada Multi-Window

Projeto Godot 4 executado no Zenith AutoOS Buildroot com Wayland/DRM-KMS em modo pixel-perfect (scale=1).


2. Cliente Standalone / Desenvolvimento

Cliente leve para desenvolver e validar o radar 3D sem subir a HMI completa, conectado ao FastAPI (:8000) ou ao adas_coral_yolo.py.

  • Script: AdasRadar3D.gd (ws://127.0.0.1:8000/ws/adas ou ws://127.0.0.1:8765), também equipado com _build_sculpted_entity para renderizar modelos 3D distinguíveis de veículos, motos e pedestres sem depender de .tscn externos.

3. Como executar

bash
# HMI embarcada (no alvo Buildroot, com Weston ativo)
cd board/zenith/rootfs_overlay/opt/zenith/hmi
godot --path project

# Cliente standalone (desktop, com backend em :8000)
cd godot_adas
godot --path . --editor
💡 Dica

No modo demo, o backend do simulador já publica ws://127.0.0.1:8000/ws/adas e o hub embarcado publica ws://127.0.0.1:8765. Use o DevTools God Mode para injetar carros, motos, pedestres e buracos em tempo real.


4. Integração e contrato

  • Fonte de dados: um único WebSocketPeer em ZenithMaster.gd distribui o mesmo frame para cluster, central, AR-HUD e RSE.
  • Formato: JSON a 60 FPS; o radar 3D consome adasObjects, telemetry, theme, brightness e locale.
  • Objetos suportados: Carro, Moto, Pessoa/Pedestre, Buraco, com malhas multi-parte e fallback procedural.
  • Assets: carro.tscn, pessoa.tscn, moto.tscn e modelos .OBJ/.GLB são carregados por ObjMeshLoader.gd.
  • Documentação relacionada: 07 — ADAS 360°, 11 — Multi-screen e 33 — LLM/Voz/Mapa 3D.

⬅️ 37 · SDK de Plugins · ⬆️ Topo · 📚 Índice · 39 · Eventos ➡️

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