v11.0 · 151 Fases
API & Dados Fases 71–80 Implementado · ~9 min (1.636 palavras) SocketCANgRPCESP32PTP
📄 docs/19-socketcan-esp32-grpc-mdns-ecu-hil-ptp-ota-fases-71-80.md ↗

19 — SocketCAN, ESP32 FreeRTOS 2Mbaud, gRPC/Protobuf, mDNS, ECU Flasher, HIL, PTP & OTA Deltas (Fases 71–80)

Este documento detalha a camada de comunicação automotiva de latência sub-milissegundo, serialização binária inter-módulos, autodescoberta em rede, remapeamento seguro de ECU, emulação Hardware-in-the-Loop (HIL), instrumentação fail-safe OLED, sincronismo IEEE 1588 PTP, diagnóstico bidirecional e atualizações OTA diferenciais das Fases 71 a 80 do Zenith AutoOS.

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

Categoria: API & Dados Fases: 71–80 Status: Implementado SocketCAN: stack gRPC: stack ESP32: stack PTP: stack

🏠 README · 📚 Documentação · ⬅️ 18 · Bluetooth áudio · 20 · V2X/HSM ➡️

📑 Neste guia — 13 seções · ~10 min de leitura

Diagnóstico e barramento CAN
Barramento: SocketCAN com BPF, gRPC/Protobuf, HIL e sincronismo PTP.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    ECU["ECU do veículo"] --> CAN["SocketCAN<br/>filtro BPF"]
    CAN --> BRIDGE["zenith_can_bridge"]
    BRIDGE --> GRPC["gRPC :50051"]
    GRPC --> HUB["Hub / HMI"]
    ESP["ESP32 FreeRTOS<br/>TWAI 2 Mbaud"] <--> BRIDGE
    MDNS["mDNS/Avahi"] --> RSE["RSE"]
    PTP["PTP IEEE 1588"] --> CAM["Câmeras"]
    HIL["vcan0 HIL"] --> CI["CI/CD"]

    style CAN fill:#1F6FEB,color:#fff,stroke:#93C5FD
    style BRIDGE fill:#0A5C36,color:#fff,stroke:#C8A951
    style ESP fill:#E7352C,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.

1. Integração Nativa SocketCAN & K-Line com Filtragem BPF (Fase 71)

  • Kernel & Device Tree:
    • linux.config habilita diretamente no kernel CONFIG_CAN=y, CONFIG_CAN_RAW=y, CONFIG_CAN_BCM=y, CONFIG_CAN_GW=y, CONFIG_CAN_VCAN=y e CONFIG_CAN_MCP251X=y.
    • zenith-can-kline.dts configura o transceptor SPI MCP2515 (can0, cristal 16 MHz, IRQ GPIO 25) e UART dedicada ao transceptor K-Line L9637D (ISO 9141-2 / KWP2000 @ 10400 baud).
    • zenith_autoos_defconfig e Config.in adicionam can-utils, libsocketcan e o pacote customizado zenith-can-bridge.
  • Daemon C11 zenith_can_bridge (zenith_can_bridge.c + zenith-can-bridge.service):
    • Abre socket PF_CAN (SOCK_RAW, CAN_RAW) com SO_TIMESTAMPNS e anexa Berkeley Packet Filter (SO_ATTACH_FILTER) no espaço do kernel, aceitando exclusivamente os IDs da Land Rover Freelander 1 (0x1F0, 0x329, 0x200, 0x545), Lexus ES 300 (0x0B4, 0x2C4, 0x3B0, 0x025) e respostas OBD/UDS (0x7E8..0x7EF).
    • Decodifica frames CAN e K-Line L9637D (/dev/zenith-kline) com validação de checksum e publica simultaneamente em /run/zenith/hub_ingest.sock (JSON) e /run/zenith/can_proto.sock (Protobuf + CRC32).

2. ESP32 como Master Gateway Híbrido Multithread FreeRTOS (Fase 72)

  • Arquitetura Dual-Core (firmware.ino):
    • Core 0 (taskTwaiCanBus): Opera o driver nativo TWAI (CAN 500 kbps) via driver/twai.h, decodificando RPM, velocidade, temperatura de água, combustível e status MIL.
    • Core 1 (taskSensorsAndSerialGateway): Lê simultaneamente botões resistivos do volante SWC (ADS1115 0x48 ou ADC dedicado), encoder de direção por interrupção (IRAM_ATTR onSteerEncoderISR), entrada optoacoplada PC817 ACC (GPIO 32), rede K-Line (KlineSerial(1) @ 10400 baud), biometria FPM10A e expansores I2C (MCP23017 0x20/0x21, PCA9685 0x40).
  • Ejeção Determinística 10 ms @ 2 Mbaud:
    • A cada 10 ms (pdMS_TO_TICKS(10)), agrega o snapshot protegido por mutex (g_telemMutex), serializa em Protobuf wire format com cabeçalho 0x5A 0x45 ('ZE') + CRC32 IEEE 802.3 e transmite via USB Serial a 2.000.000 baud.
    • zenith_power_daemon.py (zenith-power.service) usa SerialMuxParser (zenith_proto_codec.py) para demultiplexar linhas EVENT:... e quadros binários Protobuf+CRC32 sem perda.

3. Comunicação gRPC & Protobuf de Baixa Latência (Fase 73)

  • Esquema Universal (proto/zenith_telemetry.proto):
    • Define EngineTelemetry, BatteryEnergy, DspAudioState, AdasState, ChassisActuators, SecurityHsmState, V2XTrafficLight, OilTribology, BootDagStatus e o serviço RPC ZenithTelemetryService (StreamTelemetry, SendActuatorCommand, Heartbeat).
  • Implementação Multi-Linguagem sem Parsing JSON no Caminho Crítico:

4. Auto-Discovery Zero-Conf mDNS/Avahi (_zenith_rse._tcp) (Fase 74)

  • Avahi & Firewall Interno:
  • Orquestrador (zenith_mdns_mesh.py + zenith-mdns-mesh.service):
    • Implementa codificador/decodificador DNS-SD mDNS RFC 6762/6763 e varredura avahi-browse.
    • Ao encontrar os Raspberry Pis traseiros dos encostos de cabeça, deriva chave de túnel criptografado (wireguard-chacha20), provisiona túnel RTP de áudio PipeWire (pactl load-module module-rtp-send, porta 4713) e libera o fluxo de telemetria GPS Protobuf sem IPs fixos.

5. Remapeamento de ECU Nativo & Recuperação Fail-Safe (Fase 75)

  • Módulo (zenith_ecu_flasher.py + zenith-ecu-flasher.service):
    • Implementa KWP2000 Fast Init (StartCommunication 0x81 com checksum) e UDS ISO 14229 (0x10 ProgrammingSession, 0x27 SecurityAccess Seed/Key, 0x34/0x36/0x37 Download/TransferData).
    • Faz backup imutável da ROM original (Lexus / Freelander) com hash SHA-256 em /data/ecu/backups/ no SSD NVMe e edita mapas de calibração (avanço de ignição, fator de injeção e corte de giro) recalculando o CRC32.
    • Recovery Automático: Grava journal atômico (/data/ecu/flash_journal.json). Se ocorrer queda de tensão (< 10.8 V) ou falha durante o flash, envia CMD:ECU_POWER_HOLD_ON ao ESP32 (MCP23017 0x21 GPB2) sustentando a ECU pelo banco de capacitores e regrava automaticamente a ROM original de fábrica.

6. Simulador Hardware-in-the-Loop (HIL) & Rede Fantasma vcan0 (Fase 76)

  • Driver Virtual & Gerador Físico (zenith_vcan_setup.sh, zenith_hil_simulator.py, zenith-hil.service):
    • Sobe interface vcan0 e injeta frames SocketCAN autênticos de 16 bytes (0x1F0, 0x329, 0x200, 0x025) simulando aceleração suave 0 -> 120 km/h, cruzeiro, curvas e frenagem sem ligar o motor nem gerar falhas na injeção.
    • Também disponível no simulador de bancada via python3 emulator/mock_car_devices.py --hil.

7. Instrumentação Redundante Fail-Safe OLED (Fase 77)

  • Monitoramento de Heartbeat gRPC (1.5 s):
    • zenith_grpc_hub.py transmite CMD:HEARTBEAT_GRPC a cada 250 ms para o ESP32.
    • Se o PC x86 travar, reiniciar ou atualizar e ficar silencioso por >= 1500 ms, o ESP32 (firmware.ino) corta o relé do monitor HDMI principal (PIN_HDMI_PANEL_RELAY GPIO 12 / MCP23017 0x21 GPB0), acende o OLED I2C SSD1306 (0x3C) e renderiza barras de alto contraste de Velocidade, RPM e Combustível diretamente do barramento TWAI CAN em C++.

8. Sincronismo Temporal PTP IEEE 1588 Automotivo (Fase 78)

  • Daemon & Perfil (ptp4l.conf, zenith_ptp_sync.py, zenith-ptp.service):
    • Habilita CONFIG_PTP_1588_CLOCK=y e CONFIG_NETWORK_PHY_TIMESTAMPING=y no kernel e linuxptp no Buildroot.
    • Calcula offset_ns = ((t2 - t1) - (t4 - t3)) // 2 e path_delay_ns entre o relógio do ESP32 (evento de pedal de freio), timestamps SO_TIMESTAMPNS do SocketCAN e frames da câmera Coral TPU, determinando o tempo exato de reação física dos freios em milissegundos (brake_reaction_ms) sem jitter.

9. Diagnóstico Ativo Bidirecional — Menu "Ativadores" (Fase 79)

  • Override UDS 0x2F (zenith_active_diag.py + zenith-active-diag.service):
    • Envia quadros InputOutputControlByIdentifier (0x2F) via /run/zenith/diag_cmd.sock para desligar bicos injetores individuais (cut_injector_1..6), forçar ventoinha no máximo (fan_override_max) e pulsar válvula EGR (egr_pulse).
    • Cruza a queda de RPM (delta_rpm), fluxo de massa de ar (delta_maf_gps) e temperatura para gerar laudo automático exibido no painel "Ativadores" em CentralWindow.gd.

10. CI/CD Unificado, OTA Deltas RAUC & Reset Watchdog 3s (Fase 80)

  • Deltas Binários & Rollback (zenith_ota_delta.py, zenith-ota.service, 99-zenith-watchdog.conf):
    • compute_chunked_delta / apply_chunked_delta transferem apenas blocos SHA-256 modificados via Wi-Fi/LTE (casync + rauc install no slot inativo A/B).
    • O ESP32 recebe CMD:OTA_ARM_SLOT e CMD:OTA_REBOOT_PC; caso a nova partição sofra Kernel Panic (panic=3 em grub.cfg e RuntimeWatchdogSec=3s), o sistema retorna automaticamente ao slot saudável anterior e publica o relatório de erro em /data/ota/last_crash_report.json e via /run/zenith/mqtt_alert.sock.

Extensão FASE 117 — RPCs de Internacionalização (SetLocale / GetLocale) & Framing ZL

No contrato zenith_telemetry.proto e no daemon zenith_grpc_hub.py, o serviço ZenithTelemetryService (:50051) passou a incluir:

  • rpc SetLocale(LocaleConfigRequest) returns (LocaleConfigAck) — recebe locale, unidades (speed_unit, temp_unit, pressure_unit), flag rtl e preferência de motor STT (stt_engine), persiste em /data/profiles/locale.json e despacha atualização instantânea aos sockets Unix DGRAM de Voz (/run/zenith/voice_cmd.sock) e LLM (/run/zenith/llm_cmd.sock).
  • rpc GetLocale(StreamRequest) returns (LocaleConfigAck) — consulta o estado e os caminhos de modelos acústicos/LLM carregados no runtime.
  • Subcanal WebSocket Protobuf (ws://127.0.0.1:8766): além de telemetria (magic 0x5A 0x45 "ZE"), aceita quadros 0x5A 0x4C "ZL" codificados por pack_locale_frame() (zenith_proto_codec.py / ProtobufWire.gd), respondendo com LocaleConfigAck enquadrado.

Extensão FASE 118 — Autoconfiguração Dinâmica de PIDs & Calibração de Rodas no Barramento

Ao trocar de veículo no Configurador de Garagem (zenith_settings_manager.py), o backend grava /run/zenith/can_vehicle_config.json e sinaliza /run/zenith/can_cmd.sock sem intervenção humana:

  • zenith_can_bridge.c: apply_vehicle_cfg_json ajusta em runtime perfil CAN (land_rover, lexus_toyota, obd2_can, etc.), protocolo/baudrate K-Line (0x0B, 0x11, 0x2F, 0x42) e multiplica todas as leituras de velocidade pelo speed_correction_factor calculado a partir do diâmetro exato da roda.
  • zenith_telemetry.py: TelemetryDaemon._reload_vehicle_cfg() reordena ANALOG_PROTOCOLS (priorizando KWP2000 5/4 ou ISO 9141-2 3), recarrega _active_injection_pids de INJECTION_PID_OBD_MAP e aplica _speed_correction_factor na velocidade OBD-II.
  • zenith_maintenance_db.py: aplica wheel_calibration_factor no cálculo incremental do odômetro via set_wheel_calibration (/run/zenith/maint_cmd.sock).

⬅️ 18 · Bluetooth áudio · ⬆️ Topo · 📚 Índice · 20 · V2X/HSM ➡️

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