v11.0 · 151 Fases
Documentação & Contratos Fases 71–80 Manual · ~2 min (398 palavras) Godot 4SocketCANC++
📄 ZenithAutoOS/gdextension/README_CAN_GDEXTENSION.md ↗

GDExtension CAN Driver — Instruções para a Montadora

Este diretório contém o esqueleto para a integração com o driver CAN físico da montadora via GDExtension (Godot 4.x).

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

Categoria: Documentação Fases: 71–80 Status: Manual Godot 4: stack SocketCAN: stack C++: stack

🏠 README · 📚 Documentação · ⬅️ 40 · Decisões

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

🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    HW["Driver CAN físico<br/>Vector · Kvaser · Peak"] --> GDEXT["GDExtension C++<br/>CANBusDriver"]
    GDEXT --> IFACE["CANInterface.gd"]
    IFACE --> BUS["VehicleBusAdvanced"]
    BUS --> HUD["HMI Godot"]
    SOCK["SocketCAN<br/>candump | nc :9000"] --> IFACE
    IFACE --> SAFE["Somente leitura<br/>sem freio/direção"]

    style HW fill:#B45309,color:#fff,stroke:#FCD34D
    style GDEXT fill:#1F6FEB,color:#fff,stroke:#93C5FD
    style SAFE fill:#B91C1C,color:#fff,stroke:#FCA5A5

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

Arquitetura

O CANInterface.gd suporta duas abordagens para hardware real:

  1. SocketCAN (Linux nativo) — via gateway TCP:

    text
    candump can0 | nc -l 127.0.0.1 9000

    O Godot se conecta em 127.0.0.1:9000 e parseia quadros no formato <id_hex>:<hex_bytes> (ex: 123:DEADBEEF).

  2. GDExtension/GDNative — biblioteca C++ fornecida pela montadora:

    • Compile libcan_driver para a plataforma alvo (Linux/Windows).
    • Coloque o .gdextension e as bibliotecas em res://gdextension/.
    • No CANInterface, ative use_gdextension = true e aponte gdextension_library_path para o arquivo .gdextension.

Interface esperada da GDExtension (exemplo em C++)

cpp
class CANBusDriver : public RefCounted {
	GDCLASS(CANBusDriver, RefCounted);

public:
	Error connect(String interface, int bitrate);
	Dictionary read_frame(); // {id: int, data: PackedByteArray}
	Error send_frame(int can_id, PackedByteArray data);

private:
	// Handle do driver CAN físico (Vector, Kvaser, Peak, etc.)
	void *can_handle;
};

Passos de integração

  1. Implementar a GDExtension em C++ com a classe CANBusDriver.
  2. Compilar para Linux (.so) ou Windows (.dll) conforme o hardware do veículo.
  3. Copiar os binários para res://gdextension/bin/.
  4. Editar can_driver.gdextension com os caminhos corretos.
  5. No nó CANInterface no editor Godot:
    • enable_real_can = true
    • use_gdextension = true
    • gdextension_library_path = "res://ZenithAutoOS/gdextension/can_driver.gdextension"
  6. Testar com VehicleBusAdvanced para validar recebimento de velocidade, RPM, portas, etc.

Segurança

  • Nunca envie comandos CAN críticos (freio, direção, acelerador) sem validação dupla.
  • Use IDs CAN apenas para leitura de sensores (velocidade, RPM, status) no HMI.
  • Comandos de atuação devem passar por gateway automotivo autorizado.

⬅️ 40 · Decisões · ⬆️ Topo · 📚 Índice

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