Integración con Home Assistant

Car 2 Home incluye una integración de primer nivel con Home Assistant que convierte tu coche en un participante real de tu smart home, no solo en otra fuente de datos. Funciona como un componente nativo de Home Assistant (instalado vía HACS, hablando directamente con la app por WebSocket) o como un cliente MQTT estándar. Ambos caminos son compatibles; elige el que mejor se adapte a tu configuración.

Lo que hace especial a la vía nativa es que va más allá de exponer sensores. Tu auto publica eventos en el bus de eventos de Home Assistant, viaje iniciado, viaje terminado, auto estacionado, fallo encontrado, aceleración brusca, ECU en línea, lo que te permite escribir automatizaciones que reaccionan al momento en que algo pasa, en vez de consultar un valor y adivinar.

Dos caminos, el mismo resultado

Integración con Home Assistant

Una integración personalizada de Home Assistant instalada vía HACS. Home Assistant genera un código de emparejamiento de 6 dígitos que escribes en la app. Sin tokens que gestionar ni broker que instalar. La comunicación es bidireccional por WebSocket: Home Assistant recibe cada sensor y evento del coche a través de la app, y puede cambiar ajustes como el modo de sincronización y disparar otras acciones, siempre que la app esté conectada.

MQTT (cualquier broker)

Si ya tienes Mosquitto, EMQX, HiveMQ o cualquier otro broker, o si quieres que los datos fluyan hacia Home Assistant u otras herramientas como Node-RED, openHAB, ioBroker, etc., Car 2 Home publica los mismos sensores con autodescubrimiento MQTT completo de Home Assistant. La diferencia es que el camino MQTT transmite estado continuo, no eventos: cosas como trip_started o dtc_found solo existen en la integración nativa.

Cómo instalarlo

1. 1. Instala vía HACS

   Abre HACS en Home Assistant, añade Car 2 Home desde la lista de integraciones y reinicia Home Assistant. (Si aún no tienes HACS, instálalo primero desde hacs.xyz.)

2. 2. Añade la integración

   Ve a Configuración → Dispositivos y servicios → Añadir integración en Home Assistant y busca "Car 2 Home". Home Assistant generará un código de emparejamiento.

3. 3. Empareja con el código de 6 dígitos

   Introduce la URL pública de tu Home Assistant y el código de emparejamiento en la app, en Configuración → Home Assistant → Integración, ¡y listo!

4. 4. Elige un modo de sincronización

   El modo “En línea” transmite la telemetría en tiempo real mientras conduces. El modo “Casa” acumula los datos en la app mientras estás fuera y los descarga en cuanto el teléfono vuelve a tu red: útil cuando Home Assistant solo es alcanzable en casa. La app elige la dirección según la conexión que tenga en ese momento, así que usa la local en casa y la remota en la carretera.

Lo que obtienes

Cada vehículo de tu garaje se convierte en un dispositivo de Home Assistant con su propio conjunto de entidades. Los nombres siguen el patrón car2home_{brand}_{model}_{sensor}, con el apodo que le pusiste al auto incluido cuando existe, para que dos autos del mismo modelo nunca choquen. Tú eliges qué sensores se exportan, así que la lista queda tan corta o tan completa como quieras. La elección se hace en la pantalla Sensores soportados de la app: un sensor se exporta mientras está activo y con el interruptor HA/MQTT encendido.

• Sensores OBD-II estándar: velocidad, RPM, refrigerante, nivel de combustible, posición del acelerador, lambda y el resto del catálogo SAE J1979 compatible con tu coche.
• Sensores específicos del fabricante/modelo: PID extendidos que varían según la marca y el modelo, detectados automáticamente.
• Sensores calculados: consumo instantáneo, economía de combustible móvil (ventanas de 10/50/100 km), potencia en las ruedas, autonomía estimada, distancia del viaje.
• Ubicación: altitud, precisión y un device_tracker que muestra dónde está estacionado el auto, con dirección y hora de llegada. El GPS del teléfono solo transmite durante un viaje.
• TPMS: presión, temperatura e ID del sensor por rueda.
• Estado de diagnóstico: MIL encendido/apagado, número de DTC, freeze frame, voltaje del adaptador, ECU en línea/fuera de línea, estado de la conexión con Home Assistant o MQTT.
• Comportamiento de conducción: Safe Score y Eco Score en vivo, contadores de eventos bruscos, historial mensual.
• Vehicle Hub: previsión de la próxima carga de combustible, próximo mantenimiento, próximo recordatorio, totales y consumo del mes, más los indicadores de atrasado y de por vencer. Aparecen solo para las funciones que realmente usas.

Eventos en el bus de eventos de Home Assistant

Esto es lo que diferencia a la integración nativa. Tus automatizaciones pueden escuchar momentos concretos en lugar de sondear el estado.

• car2home_trip_started: se dispara en el momento en que comienza un viaje (arranque del motor + movimiento). El payload incluye el id del vehículo y la ubicación de inicio.
• car2home_trip_ended: se dispara cuando termina un viaje, con el resumen completo del viaje: distancia, duración, velocidad media / máxima, combustible usado, dirección de aparcamiento.
• car2home_parking_detected: se dispara cuando el auto estaciona, con el lugar, el tiempo y la distancia del viaje, y el combustible y la autonomía que quedan. Es el evento para las automatizaciones de “llegué a casa”.
• car2home_dtc_found: un escaneo de diagnóstico terminó y encontró códigos. El payload trae el modo del escaneo y las listas de códigos confirmados, pendientes y permanentes.
• car2home_harsh_event: se detectó una aceleración brusca, un frenado brusco o una curva tomada de forma brusca. Útil para notificaciones de conducción segura, especialmente con conductores nuevos.
• car2home_ecu_online / car2home_ecu_offline: se disparan cada vez que la conexión con la ECU se establece o se cae, así puedes distinguir entre "el coche se está conduciendo ahora mismo" y "el coche está aparcado".

Ejemplos de automatizaciones

Algunas ideas para inspirar las tuyas.

• Abre la puerta del garaje y enciende las luces del porche cuando entras en tu calle (geofence + trip_started).
• Avisa a la familia con la dirección de aparcamiento y un enlace al mapa en el momento en que termina un viaje.
• Alerta por Telegram cuando un escaneo encuentra códigos, indicando cuántos son confirmados, pendientes y permanentes.
• Refresca la casa por adelantado en el momento en que sales de la oficina (geofence del trabajo + trip_started).

Compatibilidad y requisitos

• Home Assistant 2024.12 o posterior.
• Funciona con Nabu Casa Cloud, Cloudflare Tunnel, Tailscale o cualquier proxy inverso en el que ya confíes.
• Multivehículo: cada coche de tu garaje aparece como su propio dispositivo en Home Assistant, con entidades e historial independientes.
• Los tokens se almacenan en el Keychain de iOS / Keystore de Android, nunca en las preferencias de la app.