v11.0 · 151 Fases
Bluetooth & Conectividade Fases 61–70 Implementado · ~8 min (1.589 palavras) LDACAVRCPPaaKBLE
📄 docs/18-bluetooth-audiophile-paak-ble-gateway-fases-61-70.md ↗

18 — Bluetooth Multiponto, Áudio Audiófilo, PaaK, BLE Gateway & Watchdog (Fases 61–70)

Este documento detalha toda a arquitetura de conectividade Bluetooth de alta performance, áudio sem fio sem perdas, iluminação BLE sincronizada em 3D, telefonia HFP com cancelamento de eco, fones traseiros independentes, metadados AVRCP 1.6 com capa de álbum, TPMS passivo, Phone-as-a-Key (PaaK), offloading para o ESP32 BLE Gateway e auto-recuperação HCI das Fases 61 a 70 do Zenith AutoOS.

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

Categoria: Bluetooth & Conectividade Fases: 61–70 Status: Implementado LDAC: stack AVRCP: stack PaaK: stack BLE: stack

🏠 README · 📚 Documentação · ⬅️ 17 · DRM/Vídeo · 19 · CAN/gRPC ➡️

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

Áudio Bluetooth e DSP na central
Bluetooth: LDAC/aptX HD, HFP + AEC, dual A2DP, PaaK e gateway BLE.


🗺️ Visão geral em diagrama

Diagrama Mermaid
flowchart LR
    PHONE["Smartphone"] --> BT["BlueZ<br/>multiponto"]
    BT --> A2DP["A2DP<br/>LDAC / aptX HD"]
    BT --> HFP["HFP + AEC"]
    BT --> AVRCP["AVRCP 1.6"]
    A2DP --> DSP["CamillaDSP 6ch"]
    HFP --> DSP
    PAAK["PaaK BLE"] --> ESP["ESP32 BLE Gateway"]
    TPMS["TPMS BLE"] --> ESP
    ESP --> HUB["Hub 60 Hz"]

    style BT fill:#0082FC,color:#fff,stroke:#7DD3FC
    style DSP fill:#7C3AED,color:#fff,stroke:#C4B5FD
    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. Stack Bluetooth de Alta Performance & Multiponto Persistente (Fase 61)

  • Buildroot & Prioridade Real-Time:
  • Orquestrador Multiponto (zenith_bt_manager.py + zenith-bt-manager.service):
    • Força no boot Auto-Power (Powered=True), Auto-Connect (Pairable=True / Discoverable=True) e Trust (Trusted=True) via BlueZ D-Bus para todos os dispositivos cadastrados em bt_devices_default.json (/data/profiles/bt_devices.json).
    • Threads Isoladas ("Always-On"): Executa laços de reconexão em threads separadas por papel (rgb_ble, tpms_ble, obd, rse_headphone, phone), garantindo que tentativas infinitas de reconexão de luzes RGB BLE ou TPMS jamais travem o pareamento ou conexão do smartphone do motorista.
    • Quando o offloading do ESP32 BLE Gateway (Fase 69) está ativo (esp32_ble_gateway: true), as threads rgb_ble e tpms_ble poupam o adaptador hci0 do PC x86.

2. Streaming Audiófilo Sem Fio — LDAC, aptX HD e AAC (Fase 62)

  • Priorização de Codecs no WirePlumber (52-zenith-bluetooth.lua & 52-zenith-bluetooth.conf):
    • Lista de prioridade estrita: bluez5.codecs = [ ldac aptx_hd aptx aac sbc_xq sbc ].
    • Sony LDAC configurado com bluez5.a2dp.ldac.quality = "hq" (990 kbps, 96 kHz / 24-bit); Qualcomm aptX HD em 48 kHz / 24-bit; Apple AAC com aac.bitratemode = 0 (VBR máximo).
    • 51-zenith-xfi.conf e 10-zenith-xfi.conf liberam audio.allowed-rates = [ 44100 48000 88200 96000 ] com resample.disable = true em bluez_input.*.
  • Sincronização de Clock com o DAC X-Fi & Selo Godot (zenith_bitperfect_clock.py):
    • Inspeciona nós bluez_input.* no pw-dump, trava o clock do PipeWire via pw-metadata clock.force-rate na taxa exata do codec Bluetooth (ex: 96000 Hz no LDAC), regera os filtros FIR 4096 taps e recarrega o CamillaDSP (ws://127.0.0.1:1234) sem resampling por software.
    • Emite "bluetooth_audio" no Hub WebSocket (ws://127.0.0.1:8765), acendendo o selo dourado "Hi-Res Audio LDAC" na CentralWindow.gd.

3. Iluminação Ambiente RGB BLE, Redline, Music Sync & Espelho 3D (Fase 63)

  • Daemon & Protocolo (zenith_ble_rgb.py + zenith-ble-rgb.service):
    • Implementa quadros GATT 9-bytes nativos para fitas comerciais ELK-BLEDOM (UUID 0000fff3-0000-1000-8000-00805f9b34fb) via Bleak ou delegados via Serial para o ESP32 BLE Gateway (Fase 69).
    • Integração Telemetria Redline (Fase 7): Se rpm >= redline_rpm (padrão 6200 RPM), interrompe o efeito atual e pisca as fitas em vermelho (#FF0000) a ~8 Hz.
    • Modo Music Sync: Consome as 9 primeiras bandas graves ISO (20–125 Hz) do espectro rta do PipeWire para modular brilho (20%–100%) e deslocar matiz HSV a cada batida grave.
    • Espelho 3D na Godot Engine (Radar3D.gd): Atualiza EgoCabinRgbStrip (StandardMaterial3D) e EgoCabinRgbLight (OmniLight3D) na cena 3D com o RGB físico exato emitido na cabine.

4. Chamadas HFP & Cancelamento de Eco Acústico WebRTC AEC (Fase 64)

  • Pipeline AEC no PipeWire (40-zenith-aec.conf):
    • Carrega libpipewire-module-echo-cancel com library.name = aec/libspa-aec-webrtc (extended_filter, high_pass_filter, noise_suppression, voice_detection, gain_control), filtrando zenith_anc_ceiling_mic e expondo zenith.aec.source (48 kHz).
  • Orquestração Automática (zenith_call_manager.py + zenith-call.service):
    1. Ringing: Detecta chamada via D-Bus (org.ofono / HFP) e exibe popup de chamada com Caller ID em CentralWindow.gd.
    2. Active (Atendida): Muta a música no CamillaDSP (SetMute: true), reduz o ventilador do A/C via ESP32 (/run/zenith/esp32_cmd.sock → blower_pct: 15) e direciona o microfone de teto filtrado pelo WebRTC AEC (zenith.aec.source) para o uplink HFP.
    3. Idle (Encerrada): Restaura o estado de mudo anterior do CamillaDSP e a velocidade original do ventilador do A/C.

5. Fones de Ouvido Traseiros Independentes — Dual A2DP Sink (Fase 65)

  • Nó Virtual Divisor PipeWire (50-zenith-rse-dual-bt.conf & 53-zenith-rse-bt.conf):
    • Cria zenith.rse.virtual_splitter (libpipewire-module-combine-stream), isolando o áudio de filmes dos encostos (application.name=zenith_rse) e dividindo-o simultaneamente para até 2 fones Bluetooth pareados (bluez_output.*Zenith_RSE*).
  • Controle Independente na Tela Central (zenith_multiseat_rse.py + CentralWindow.gd):
    • Ajusta o volume individual do Fone 1 e do Fone 2 (rse_hp_volume via wpctl) e oferece o botão "Saída Filme: Fones BT / Forçar Cabine" (rse_route_mode), comutando dinamicamente o fluxo entre os fones traseiros e os alto-falantes 5.1 do carro.

6. Metadados AVRCP 1.6, Capa OBEX/BIP & Controle de Volante SWC (Fase 66)

  • Agente AVRCP 1.6 & Capa do Álbum (zenith_bluetooth_agent.py):
    • Extrai Title, Artist, Album, Genre, TrackNumber, NumberOfTracks, Duration, Position, Status, Shuffle, Repeat e ImgHandle de org.bluez.MediaPlayer1.
    • Baixa a imagem da capa via OBEX/BIP (org.bluez.obex.Image1), converte para Base64 (album_art_b64 + album_art_hash) e envia para o card 2D de CentralWindow.gd e para o material 3D AvrcpAlbumArt3D em Radar3D.gd.
  • Roteamento Reverso SWC:
    • O ESP32 (firmware.ino) lê a escada resistiva do volante via ADS1115 (0x48) e emite EVENT:SWC:{"button":"NEXT_TRACK"}.
    • zenith_power_daemon.py encaminha para /run/zenith/bt_cmd.sock, e zenith_bluetooth_agent.py invoca Next(), Previous(), Play(), Pause() diretamente no smartphone via D-Bus.

7. Sensores TPMS BLE Passivo + GATT & Alarmes no Cluster (Fase 67)

  • Daemon Dedicado (zenith_tpms_ble.py + zenith-tpms.service):
    • Executa Passive Scan (BleakScanner(scanning_mode="passive")) ou consome os pacotes já capturados pelo ESP32 BLE Gateway em /run/zenith/tpms_ingest.sock, além de suportar consulta GATT sob demanda para bateria (0x2A19).
    • Decodifica frames hexadecimais 0x0100 (16/18 bytes), 0x00AC (6/12 bytes) e 8 bytes em Pressão (PSI), Temperatura (°C), Bateria (%) e vazamento rápido (>= 2.5 PSI/min).
    • Envia para o Cluster 1920x720 (ClusterWindow.gd) disparando alarme visual vermelho imediato se qualquer pneu cair abaixo do limite.

8. Phone-as-a-Key (PaaK) & Gateway BLE Offloading no ESP32 (Fases 68 e 69)

  • PaaK por RSSI no ESP32 (firmware.ino):
    • Em Deep Sleep, esp_sleep_enable_timer_wakeup(1.2s) desperta brevemente o ESP32 para varredura BLE passiva buscando MACs autorizados (paak_register salvos em NVS Preferences).
    • RSSI fraco (> 10 m, >= -88 dBm): Acende apenas as fitas LED RGB de boas-vindas (PCA9685) mantendo o PC x86 desligado.
    • RSSI forte (< 2 m, >= -58 dBm): Pulsa o relé de destravamento das portas (MCP23017 0x21 GPB1), liga o PC x86 (PIN_PC_RELAY = HIGH) e transmite EVENT:PAAK_UNLOCK → zenith_profile_manager.py carrega automaticamente o banco elétrico, clima e Time Alignment de áudio daquele motorista (profiles_default.json com paak_mac).
  • Gateway BLE Offloading (Fase 69):
    • Tarefa FreeRTOS taskBleGatewayAndPaak opera o rádio BLE nativo do ESP32 em coexistência com Wi-Fi e Serial (2Mbaud), executando escritas GATT ble_gw_rgb em fitas ELK-BLEDOM e capturando pacotes TPMS EVENT:BLE_TPMS.
    • Mantém o controlador Bluetooth USB/PCIe do PC x86 (hci0) dedicado 100% exclusivamente ao streaming LDAC e chamadas HFP sem colisão de canal RF ou largura de banda.

9. Watchdog Bluetooth & Auto-Recuperação Elétrica HCI0 (Fase 70)

  • Serviço Watchdog (zenith_bluetooth_watchdog.sh + zenith-bt-watchdog.service):
    1. Monitora continuamente hci0 com hcitool dev / l2ping, D-Bus (busctl / dbus-send em /org/bluez/hci0) e falhas command tx timeout no dmesg.
    2. Se falhar por > 5 segundos, envia banner "Reiniciando Rádio" para a interface Godot (CentralWindow.gd e ClusterWindow.gd).
    3. Reinicia bluetooth.service, executa reset elétrico 5V de 500 ms na porta USB exata do adaptador (bDeviceClass=e0) via uhubctl -a off ... ; sleep 0.5 ; uhubctl -a on ... e sobe hciconfig hci0 up.
    4. Dispara bt_resume_last para /run/zenith/bt_cmd.sock, reconectando o celular e retomando a reprodução a partir do estado salvo em /run/zenith/bt_resume_state.json.

⬅️ 17 · DRM/Vídeo · ⬆️ Topo · 📚 Índice · 19 · CAN/gRPC ➡️

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