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).
🏠 README · 📚 Documentação · ⬅️ 40 · Decisões
📑 Neste guia — 5 seções · ~3 min de leitura
🗺️ Visão geral em diagrama
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:#FCA5A5Como 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:
SocketCAN (Linux nativo) — via gateway TCP:
textcandump can0 | nc -l 127.0.0.1 9000O Godot se conecta em
127.0.0.1:9000e parseia quadros no formato<id_hex>:<hex_bytes>(ex:123:DEADBEEF).GDExtension/GDNative — biblioteca C++ fornecida pela montadora:
- Compile
libcan_driverpara a plataforma alvo (Linux/Windows). - Coloque o
.gdextensione as bibliotecas emres://gdextension/. - No
CANInterface, ativeuse_gdextension = truee apontegdextension_library_pathpara o arquivo.gdextension.
- Compile
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
- Implementar a GDExtension em C++ com a classe
CANBusDriver. - Compilar para Linux (
.so) ou Windows (.dll) conforme o hardware do veículo. - Copiar os binários para
res://gdextension/bin/. - Editar
can_driver.gdextensioncom os caminhos corretos. - No nó
CANInterfaceno editor Godot:enable_real_can = trueuse_gdextension = truegdextension_library_path = "res://ZenithAutoOS/gdextension/can_driver.gdextension"
- Testar com
VehicleBusAdvancedpara 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