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 barramento de eventos do Home Assistant, viagem iniciada, viagem encerrada, carro estacionado, falha encontrada, aceleração brusca, ECU online, o que significa que você pode escrever automações que reagem ao momento em que algo acontece, em vez de ficar consultando um valor e adivinhando.

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 a telemetria em tempo real enquanto você dirige. O modo “Casa” acumula os dados no aplicativo enquanto você está fora e descarrega assim que o telefone volta para a sua rede: útil quando o Home Assistant só é alcançável em casa. O aplicativo escolhe o endereço pela conexão que tem no momento, então usa o endereço local em casa e o remoto na estrada.

O que você ganha

Cada veículo da sua garagem vira um dispositivo no Home Assistant, com o seu próprio conjunto de entidades. Os nomes seguem o padrão car2home_{brand}_{model}_{sensor}, com o apelido que você deu ao carro incluído quando existe, para que dois carros do mesmo modelo nunca colidam. Você escolhe quais sensores são exportados, então a lista fica tão curta ou tão completa quanto você quiser. A escolha fica na tela Sensores Suportados do app: um sensor é exportado enquanto está ativo e com a chave HA/MQTT ligada.

• 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 um device_tracker que mostra onde o carro está estacionado, com endereço e hora de chegada. O GPS do telefone só transmite durante a viagem.
• 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.
• Vehicle Hub: previsão do próximo abastecimento, próxima manutenção, próximo lembrete, totais e consumo do mês, mais os sinalizadores de atrasado e de vence logo. Eles aparecem apenas para as funções que você realmente usa.

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_parking_detected: dispara quando o carro estaciona, levando a vaga, o tempo e a distância da viagem, e o combustível e a autonomia que sobraram. É nele que se penduram as automações de “cheguei em casa”.
• 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.

• 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.