v11.0 · 151 Fases
Bluetooth & Conectividade Fases 4–70 Implementado · ~6 min (1.192 palavras) BluetoothTPMSBLEELM327
📄 docs/04-bluetooth-obd2-tpms-rgb.md ↗

04 — Bluetooth (A2DP/HFP/AVRCP), OBD-II (ELM327), TPMS BLE & Iluminação RGB

Este documento cobre as pilhas de telemetria veicular, diagnósticos OBD-II, sensores BLE TPMS, áudio/telefonia Bluetooth (BlueZ 5 + PipeWire) e iluminação RGB no Zenith AutoOS.

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

Categoria: Bluetooth & Conectividade Fases: 4–70 Status: Implementado Bluetooth: stack TPMS: stack BLE: stack ELM327: stack

🏠 README · 📚 Documentação · ⬅️ 03 · Áudio/Vídeo · 05 · API/IPC ➡️

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

Diagnóstico OBD-II em português na central
OBD-II: telemetria, DTCs em português, TPMS e diagnóstico ao vivo.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    ELM["ELM327<br/>ISO 9141-2 / KWP2000"] --> BT["BlueZ<br/>RFCOMM"]
    TPMS["TPMS BLE<br/>4 rodas"] --> BLE["Scanner BLE"]
    PHONE["Smartphone"] --> BT
    BT --> HUB["Hub 60 Hz"]
    BLE --> HUB
    HUB --> UI["Cluster + Central"]
    HUB --> RGB["PCA9685 / ELK-BLEDOM"]

    style ELM fill:#1F6FEB,color:#fff,stroke:#93C5FD
    style BT fill:#0082FC,color:#fff,stroke:#7DD3FC
    style HUB fill:#0A5C36,color:#fff,stroke:#C8A951

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. Telemetria & Diagnóstico OBD-II (ELM327 @ 15 Hz)

A. Daemon Embarcado no Linux (zenith_telemetry.py)

  • Gerenciado por zenith-telemetry.service.
  • Conecta via /dev/rfcomm0 (Bluetooth Serial) ou fallback USB (/dev/ttyUSB1, /dev/ttyUSB2, /dev/ttyACM0, mantendo /dev/ttyUSB0 reservado para o ESP32).
  • Força sequencialmente os protocolos analógicos do python-obd:
    1. "3" — ISO 9141-2 (5-baud init)
    2. "5" — ISO 14230-4 KWP2000 (Fast init)
    3. "4" — ISO 14230-4 KWP2000 (5-baud init)
  • Realiza polling a 15 Hz de RPM, SPEED, COOLANT_TEMP, ENGINE_LOAD e CONTROL_MODULE_VOLTAGE (com fallback ELM_VOLTAGE), injetando em /run/zenith/hub_ingest.sock para transmissão em 60 Hz no WebSocket ws://127.0.0.1:8765.

B. Backend FastAPI Dual-Vehicle (obd_service.py)

  • Land Rover Freelander 1 (2006): Redline 6200 RPM, Alerta Água 102 °C, Crítico 110 °C, Bateria < 11.8V.
  • Lexus ES 300 (1998 XV20): Redline 6300 RPM, Alerta Água 100 °C, Crítico 108 °C, Bateria < 11.9V.
  • Auto-Scan & DTC: Endpoints GET /api/obd/ports, POST /api/obd/connect, GET /api/obd/dtc, DELETE /api/obd/dtc.

2. Monitoramento de Pressão dos Pneus (TPMS Bluetooth BLE — Fases 7, 67 e 69)

  • Daemon Dedicado no SO Embarcado (zenith_tpms_ble.py + zenith-tpms.service):
    • Executa Passive Scan (BleakScanner(scanning_mode="passive")) ou consome os pacotes já decodificados pelo ESP32 BLE Gateway (Fase 69) via /run/zenith/tpms_ingest.sock, suportando também leitura GATT sob demanda (0x2A19 Battery Service).
    • Decodifica frames hexadecimais 0x0100 (16/18 B), 0x00AC (6/12 B) e 8 B das 4 rodas (fl, fr, rl, rr) mapeados por /data/profiles/tpms_sensors.json.
    • Alertas: Dispara "low_alert": true quando psi < 28.0, psi > 44.0 ou em vazamento rápido (>= 2.5 PSI/min), destacando o alarme no Cluster 1920x720 (ClusterWindow.gd).
  • No Backend FastAPI: Implementado em tpms_service.py com perfis freelander_2006 (30 PSI / alerta ≤ 26 PSI) e lexus_es300_1998 (32 PSI / alerta ≤ 28 PSI).

3. Bluetooth Automotivo: Multiponto, LDAC/aptX HD/AAC, HFP AEC, AVRCP 1.6 & Watchdog (Fases 8 e 61–70)

  • BlueZ 5 (main.conf) + dbus-broker RT: Classe 0x200420 (Car Audio), ControllerMode = dual, MultiProfile = multiple, MaxConnectedDevices = 6, pareamento persistido em /data/bluetooth (bind mount em /var/lib/bluetooth), prioridade RR 55 / Nice=-15.
  • Orquestrador Multiponto (zenith_bt_manager.py): Gerencia threads isoladas para dispositivos fixos Always-On (rgb_ble, tpms_ble, obd, rse_headphone) para jamais bloquear o pareamento do smartphone (phone), forçando Auto-Power, Auto-Connect e Trust.
  • Agente AVRCP 1.6, OBEX/BIP Album Art & SWC Reverso (zenith_bluetooth_agent.py + zenith-bt-agent.service):
    • Extrai metadados AVRCP 1.6 completos + Capa do Álbum via OBEX/BIP convertida em Base64 (album_art_b64) para o card 2D e material 3D Godot.
    • Roteamento reverso SWC: botões físicos do volante (EVENT:SWC do ESP32) disparam MediaPlayer1.Next(), Previous(), Play(), Pause() via /run/zenith/bt_cmd.sock.
  • Codecs Audiófilos, AEC & Dual A2DP RSE (52-zenith-bluetooth.lua, 52-zenith-bluetooth.conf, 40-zenith-aec.conf & 50-zenith-rse-dual-bt.conf):
    • Prioriza LDAC 96kHz/24-bit (hq), aptX HD e AAC com travamento de clock do DAC sem resampling (zenith_bitperfect_clock.py) e selo "Hi-Res Audio LDAC" na Godot HMI.
    • Chamadas HFP (zenith_call_manager.py) mutam CamillaDSP, reduzem o blower do A/C via ESP32 e ativam WebRTC AEC no microfone de teto (zenith.aec.source).
    • Nó virtual zenith.rse.virtual_splitter divide áudio de filmes dos encostos para 2 fones Bluetooth traseiros independentes.
  • Watchdog HCI0 (uhubctl 500ms), PaaK / Welcome Mode 3m (Fase 103) & ESP32 BLE Gateway: Ver detalhes completos em 18 — Bluetooth Multiponto, Áudio Audiófilo, PaaK, BLE Gateway & Watchdog (Fases 61–70) e 23 — Fases 101–110 (PAAK_WELCOME_3M_RSSI_DBM = -64 dBm, wake do PC + fade-in PWM + perfil Godot/CamillaDSP + reconexão A2DP automática via bt_connect_a2dp).

4. Iluminação Ambiente RGB (PCA9685 + BLE Nativo Redline / Music Sync / Espelho 3D)

  • Via Daemon BLE Nativo (zenith_ble_rgb.py — Fases 63, 69, 91, 92 e 95): Protocolo ELK-BLEDOM (0000fff3-...) via Bleak ou offloading Serial para o ESP32 BLE Gateway (ble_gw_rgb), sincronizado em < 10 ms pelo RPC binário Protobuf Color-Sync (Fase 91), respeitando curva de dimerização logarítmica (rgb_dimmer_log, Fase 92), aceleração de respiração sob Warp/G-Force e strobe vermelho no Redline (>= 6000/6200 RPM, Fase 95), modo Music Sync guiado pelos graves do PipeWire RTA (20–125 Hz) e espelhamento no gêmeo 3D em Radar3D.gd.
  • Via ESP32 I2C (PCA9685 @ 0x40): 3 zonas RGB independentes (zone: 0 Painel ch 0..2, zone: 1 Assoalho ch 3..5, zone: 2 Teto Estrelado ch 6..8) em PWM 12-bit (1000 Hz, curva logarítmica computeLogarithmicPwm12 + modulação direta via ColorSyncRpc Protobuf).
  • Via Backend FastAPI (ble_rgb_service.py & theme_sync_service.py): APIs REST /api/hardware/rgb e /api/theme/palette / /api/theme/dimmer sincronizando tela e cabine simultaneamente. Além disso, na Fase 107 (BSW), adas_radar.py + zenith_ble_rgb.py enviam bsw_alert (r: 255, g: 0, b: 0) para piscar a fita RGB em vermelho intenso quando há seta ligada e veículo detectado no ponto cego pelo YOLOv8.

5. Inteligência OBD-II: Explicador de DTCs em Português, Consumo Real R$ & Nota (Fases 132–135)

A leitura contínua da ECU via ELM327 / SocketCAN alimenta os módulos inteligentes descritos em Doc 31:

  • Explicação de DTC em Português (zenith_dtc_explainer.py): Cruza DTCs lidos (GET /api/obd/dtc/explain) com a base offline dtc_knowledge_pt.json + llama-cli local, retornando título, explicação, gravidade e pode_seguir_viagem.
  • Consumo Real, Abastecimento & Diário CSV (zenith_trip_logbook.py): Calcula L/h e km/L (via MAF ou Speed-Density), detecta abastecimento automaticamente pelo salto do nível do tanque (POST /api/trips/refuel), salva viagens completas em SQLite WAL (GET /api/trips/export.csv) e calcula a Nota de Condução (0–100).

⬅️ 03 · Áudio/Vídeo · ⬆️ Topo · 📚 Índice · 05 · API/IPC ➡️

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