O Car 2 Home é um cliente MQTT completo. Todo sensor que você escolhe exportar, do OBD padrão e dos PIDs estendidos às métricas calculadas, GPS, TPMS e estado de diagnóstico, é publicado no seu broker, junto com os números do Vehicle Hub: previsão de abastecimento, manutenções e lembretes a vencer, totais e consumo do mês. As leituras e o hub são atribuídos por carro, em todos os formatos de publicação.
Se você já roda Mosquitto, EMQX, HiveMQ ou outro broker, está a alguns campos de distância de um setup funcional. O Car 2 Home não depende dos nossos servidores pra nada disso, a telemetria vai direto do app pro seu broker.
MQTT vs. integração nativa do Home Assistant
Os dois caminhos carregam os mesmos sensores. A diferença é que o MQTT carrega estado contínuo, enquanto a integração nativa do Home Assistant também carrega eventos (viagem iniciada, DTC encontrado, aceleração brusca). Se você só usa MQTT, vai ter todos os dados ao vivo, mas os momentos discretos que dão origem às automações mais interessantes só existem na integração nativa.
Como os dados são publicados
- Payloads de auto-discovery são enviados com
retain=true, pra qualquer subscriber que conectar depois ver o catálogo de entidades imediatamente. - Apenas atualizações delta: valores são republicados só quando mudam, com throttling opcional, pra evitar inundar o broker.
- PIDs enumerados são decodificados: Fuel Type "1" vira "Gasoline", commanded equivalence ratio é reportado como fração, etc. Tanto o valor bruto quanto o legível ficam expostos como atributos.
- Ícones Material Design são incluídos nos payloads de discovery, então os dashboards renderizam certo de cara.
- QoS configurável por classe de tópico. Estado de sensor padrão QoS 0; mensagens de ciclo de vida usam QoS 1.
- TLS e autenticação suportados; credenciais guardadas no Keychain do iOS / Keystore do Android.
Funciona com
Qualquer coisa que fale MQTT, combinada com o formato de publicação certo (veja acima). Testamos regularmente contra:
- Home Assistant pela integração MQTT com o formato Home Assistant Discovery (detectado automaticamente).
- OpenHAB e ioBroker com o formato Homie 4.0 (binding MQTT Homie / adapter MQTT Client).
- Hubitat, Node-RED, Domoticz com o formato Tópicos Simples.
- Grafana + Telegraf / InfluxDB e dashboards customizados com o formato JSON Unificado.
- ThingsBoard CE / Cloud com o preset ThingsBoard; bridges ESPHome e qualquer consumidor MQTT DIY com Tópicos Simples ou JSON Unificado.
Formatos de publicação
Escolha o formato que combina com a sua plataforma de destino. O padrão Home Assistant Discovery cobre o HA sem configuração extra; troque por um dos outros pra OpenHAB, Hubitat, dashboards genéricos ou ThingsBoard.
Home Assistant Discovery
Padrão. Payloads de auto-discovery sob homeassistant/<component>/<deviceId>/<sensor>/config. O carro aparece automaticamente em Configurações → Dispositivos e Serviços → MQTT no HA. Estado contínuo é publicado como JSON em batch no tópico <prefix>/<deviceId>/state.
Homie 4.0
Padrão aberto com descoberta por uma topologia homie/<deviceId>/$nodes e metadados $datatype / $unit / $format por propriedade, com last will adequado e o ciclo de vida de estado completo, para o broker sempre saber se o carro está online. Alvo nativo do OpenHAB (binding MQTT Homie) e do ioBroker.
Tópicos simples
Um tópico MQTT por sensor, sem discovery. O payload alterna entre o valor puro (ex. 1850) ou um JSON {value, ts}. Funciona com Hubitat, Node-RED, Domoticz e qualquer consumidor MQTT genérico.
JSON unificado
Todos os sensores em um único payload JSON num tópico configurável, retained para subscribers que conectam depois. Bom encaixe pra Grafana, InfluxDB / Telegraf e dashboards customizados que preferem se inscrever em um tópico só e parsear o snapshot completo do veículo.
ThingsBoard
Preset nativo pra ThingsBoard CE e ThingsBoard Cloud. Publica telemetria em v1/devices/me/telemetry e sensores estáticos (VIN, tipo de combustível, CalID) em v1/devices/me/attributes. O access token vai no campo de usuário; deixe Senha em branco.
Troque de formato a qualquer momento em Configurações → MQTT → Formato. Quando você sai do Home Assistant ou Homie, o app oferece limpar os tópicos de discovery retidos no broker pra você não ver dispositivos fantasma no consumidor.
Escolhendo um broker
Se você ainda não roda um, aqui vai um ponto de partida:
- Mosquitto: a opção mais simples. Roda como add-on do Home Assistant com um clique, ou stand-alone via Docker. Suficiente pra uma casa.
- EMQX: clusterizado, escala bem, tem uma UI web boa. Vale se você tem muitos devices ou quer monitoramento detalhado.
- HiveMQ: opção comercial / na nuvem se você não quer self-host.
Setup rápido
1. Tenha um broker acessível pelo celular
Na sua rede local ou via túnel (Tailscale, Cloudflare Tunnel, Nabu Casa). O MQTT precisa estar acessível enquanto você dirige pra telemetria fluir ao vivo.
2. Abra Configurações → MQTT no app
Preencha host, porta, usuário, senha, opcional TLS. O app valida a conexão e mostra o status em tempo real.
3. Inscreva-se e veja as entidades chegarem
Os payloads de auto-discovery são publicados imediatamente. No Home Assistant o device aparece em Configurações → Dispositivos & Serviços → MQTT. No Node-RED ou em qualquer MQTT explorer, navegue na árvore de tópicos sob o prefixo configurado.
Matter / SmartThings / Google Home / Alexa
Um plugin do Matterbridge que exporta os sensores do Car 2 Home como dispositivos Matter, para eles aparecerem na Casa da Apple, no Google Home, no SmartThings e na Alexa sem um Home Assistant no meio, está pronto e em teste. Ainda não vamos publicar: os tipos de dispositivo do Matter não cobrem bem o tipo de leitura e de evento que um carro produz, e o resultado ainda não chega ao nível que a gente quer. Damos notícia assim que isso mudar.