Integração com Home Assistant

O Car 2 Home tem uma integração de primeira classe com o Home Assistant que transforma o seu carro em um participante real da sua casa inteligente, não só mais uma fonte de dados. Ela funciona como componente nativo do Home Assistant (instalado via HACS, conversando direto com o app por WebSocket) ou como cliente MQTT padrão. Os dois caminhos são suportados; escolha o que combina melhor com seu setup.

O que torna o caminho nativo especial é que ele vai além de expor sensores. O seu carro publica eventos no event bus do Home Assistant, viagem iniciada, viagem encerrada, código de falha encontrado, aceleração brusca, ECU online, o que permite escrever automações que reagem a momentos, não só a números cruzando limites.

Dois caminhos, mesmo resultado

Integração com Home Assistant

Com uma integração customizada do Home Assistant instalado via HACS. O Home Assistant gera um código de pareamento de 6 dígitos que você digita no App. Sem token pra gerenciar, sem broker pra instalar. A comunicação é bidirecional por WebSocket, o Home Assistant recebe todos os sensores e eventos do carro através do App, e pode alterar configurações como o modo de sincronização e outras ações, desde que o app esteja conectado.

MQTT (qualquer broker)

Se você já roda Mosquitto, EMQX, HiveMQ ou qualquer outro broker, ou se quer que os dados fluam o Home Assistant, ou outras ferramentas como Node-RED, openHAB, ioBroker, etc, o Car 2 Home publica os mesmos sensores com auto-discovery completo do Home Assistant. A diferença é que o caminho MQTT carrega estado contínuo, não eventos: coisas como trip_started ou dtc_found só existem na integração nativa.

Como instalar

1. 1. Instale via HACS

   Abra o HACS no Home Assistant, adicione Car 2 Home pela lista de integrações e reinicie o Home Assistant. (Se ainda não tem o HACS, instale primeiro a partir de hacs.xyz.)

2. 2. Adicione a integração

   Vá em Configurações → Dispositivos & Serviços → Adicionar Integração no Home Assistant e procure por "Car 2 Home". O Home Assistant vai gerar um código de pareamento.

3. 3. Pareie com o código de 6 dígitos

   Digite a sua URL pública do Home Assistant e o código de pareamento no App em Configurações → Home Assistant → Integração e está pronto!

4. 4. Escolha um modo de sincronização

   O modo "Online" transmite telemetria em tempo real enquanto você dirige. O modo "Somente Wi-Fi" armazena os dados no App enquanto você está fora e descarrega no momento em que o celular se conectar a uma rede Wi-Fi, útil quando você não tem uma URL pública para o Home Assistant ou quer economizar dados móveis.

O que você ganha

Cada veículo da sua garagem se torna um dispositivo no Home Assistant com o seu próprio conjunto de entidades. Os nomes seguem o padrão car2home_{fabricante}_{modelo}_{sensor}, então múltiplos veículos nunca colidem. As entidades usam a semântica RestoreSensor do Home Assistant, mantêm o último valor conhecido entre reinícios e nunca ficam indisponíveis só porque o motor desligou.

• Sensores OBD-II padrão: velocidade, RPM, líquido de arrefecimento, nível de combustível, posição da borboleta, lambda e o resto do catálogo SAE J1979 suportado pelo seu carro.
• Sensores específicos (específicos do fabricante e modelo): PIDs estendidos que variam por marca, descobertos automaticamente.
• Sensores calculados: taxa de combustível, consumo médio em janelas (10/50/100 km), potência nas rodas, autonomia estimada, distância da viagem.
• Localização: Altitude, precisão e localização como sensor device_tracker.
• TPMS: pressão por roda, temperatura, ID do sensor.
• Estado de diagnóstico: luz da injeção (MIL), contagem de DTCs, freeze frame, voltagem do adaptador, ECU online/offline, status da conexão com o Home Assistant ou MQTT.
• Comportamento na direção: Safe Score e Eco Score ao vivo, contadores de eventos bruscos, histórico mensal.

Eventos no event bus do Home Assistant

É o que diferencia a integração nativa. Suas automações podem escutar momentos discretos em vez de ficar consultando estado.

• car2home_trip_started: disparado no momento em que uma viagem começa (motor ligado + movimento). Payload inclui id do veículo e local de partida.
• car2home_trip_ended: disparado quando uma viagem termina, com resumo completo: distância, duração, velocidade média / máxima, combustível usado, endereço de estacionamento.
• car2home_dtc_found: uma varredura de diagnóstico terminou e encontrou códigos. O payload traz o modo da varredura e as listas de códigos confirmados, pendentes e permanentes.
• car2home_harsh_event: aceleração, frenagem ou curva brusca detectada. Útil pra notificações de direção segura, especialmente com motoristas iniciantes.
• car2home_ecu_online / car2home_ecu_offline: disparados sempre que a conexão com a ECU sobe ou cai, então dá pra distinguir "carro está rodando agora" de "carro está estacionado".

Exemplos de automação

Algumas ideias pra inspirar. Os blocos completos de configuração estão na seção de Guias.

• Abrir o portão da garagem e acender as luzes da varanda ao chegar na rua de casa (geofence + trip_started).
• Notificar a família com o endereço de estacionamento e link no mapa no momento que a viagem termina.
• Alerta no Telegram quando uma varredura encontra códigos, dizendo quantos são confirmados, pendentes e permanentes.
• Pré-climatizar a casa no momento em que você sai do trabalho (geofence trabalho + trip_started).

Compatibilidade & requisitos

• Home Assistant 2024.12 ou mais novo.
• Funciona com Nabu Casa Cloud, Cloudflare Tunnel, Tailscale ou qualquer reverse proxy de sua confiança.
• Multi-veículo: cada carro da garagem aparece como um device próprio no Home Assistant, com entidades e histórico independentes.
• Tokens são guardados no Keychain do iOS / Keystore do Android, nunca em preferências do app.