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 al camino nativo es que va más allá de exponer sensores. Tu coche publica eventos en el bus de eventos de Home Assistant: viaje iniciado, viaje finalizado, DTC encontrado, aceleración brusca, ECU en línea, lo que significa que puedes escribir automatizaciones que reaccionen a momentos, no solo a números que cruzan umbrales.

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 "Solo Wi-Fi" almacena los datos en la app mientras estás fuera y los descarga en cuanto tu teléfono se conecta a una red Wi-Fi: útil cuando no tienes una URL pública para Home Assistant o quieres ahorrar datos móviles.

Lo que obtienes

Cada vehículo de tu garaje se convierte en un dispositivo en Home Assistant con su propio conjunto de entidades. Los nombres siguen el patrón car2home_{manufacturer}_{model}_{sensor}, así que varios vehículos nunca chocan entre sí. Las entidades usan la semántica RestoreSensor de Home Assistant: conservan su último valor conocido entre reinicios y nunca quedan no disponibles solo porque el motor se apagó.

• 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 una entidad device_tracker para el vehículo.
• 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.

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_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. Los bloques de configuración completos están en la sección de Guías.

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