Tu Xpeng en Home Assistant, sin suscripción

Cómo funciona, en un minuto

Xpeng no ofrece ninguna integración oficial con Home Assistant. Por eso los datos llegan por dos caminos distintos que terminan en el mismo sitio: un pequeño servicio de mensajería llamado MQTT, que Home Assistant escucha.

Mi consejo: si solo eliges una, empieza por XPENG Direct (gratis y con muchos datos). Añade el WiCAN Pro si quieres medidas precisas y totalmente locales, por ejemplo para gestionar la carga con tus placas solares.

Pequeño glosario para principiantes

Qué necesitas

• Home Assistant instalado y accesible desde tu ordenador.
• El complemento Mosquitto broker (Ajustes → Complementos → Tienda de complementos). Si ya usas Zigbee2MQTT, ya lo tienes.
• Un usuario de Home Assistant dedicado a MQTT: Ajustes → Personas → Usuarios → Añadir, por ejemplo mqtt-xpeng, marca «solo acceso local», sin permisos de administrador. Apunta su contraseña.
• Para la vía 1: Wi-Fi de 2,4 GHz que llegue hasta donde aparcas el coche (el WiCAN no ve el 5 GHz).
• Para la vía 2: un aparato encendido 24 h capaz de ejecutar Docker y una segunda cuenta XPENG (otro correo electrónico).

1Vía 1: el dongle WiCAN Pro

El WiCAN Pro (referencia MP-WICAN-PRO, fabricante MeatPi) cuesta unos 76 € sin IVA en Mouser, o se puede pedir en Crowd Supply. No compres el WiCAN básico: es más barato pero demasiado limitado.

1. Instala la integración en Home AssistantEn HACS, añade el repositorio personalizado https://github.com/jay-oswald/ha-wican (categoría Integración), instálalo y reinicia Home Assistant.
2. Conecta el dongle y accede a élEnchúfalo en la toma OBD bajo el volante. Crea una red Wi-Fi llamada WiCAN_xxxxxx (contraseña @meatpi#). Conecta el móvil o el ordenador a ella y abre http://192.168.0.10 en el navegador.
3. Cambia la contraseña enseguidaSi no, cualquiera que pase junto al coche podría conectarse al dongle.
4. Comprueba la versión del firmwareUsa la v4.51. A fecha de octubre de 2026, la v6.00 ya no consulta los PID del G6 y borra los ajustes: la probé y volví atrás. Antes de cualquier actualización, exporta una copia de la configuración.
5. Conéctalo a tu Wi-FiPon el dongle en modo Station y elige tu Wi-Fi de 2,4 GHz. Apunta su nombre en la pestaña Status (del tipo wican_xxxxxxxxxxxx.local) y reserva una IP fija para él en el router.
6. Configura el protocolo y MQTTPestaña Settings:
   • Protocolo CAN: AutoPID. Sin esto no funciona nada: es el error número uno.
   • Broker MQTT: la IP de Home Assistant, sin http:// ni puerto. Puerto 1883, con el usuario MQTT creado antes.
   Guarda (Store) y reinicia el dongle desde la pestaña About.
7. Carga el perfil ligero del G6El perfil Xpeng integrado consulta 234 parámetros, muchos con valores erróneos, y satura el dongle. Descarga mejor mi perfil de 8 parámetros xpeng_g6_wican.json e impórtalo en Automate → Vehicle Profiles. No mezcles este perfil con PID añadidos a mano.
8. Despierta el coche y compruebaLa red del coche no responde mientras duerme. Siéntate dentro con el contacto puesto y compara el porcentaje de batería de Home Assistant con el del cuadro: deben coincidir exactamente.

2Vía 2: la aplicación XPENG Direct

XPENG Direct lo escribió Paul Simon y Stéphane Bonnell lo empaquetó como imagen Docker; ambos son miembros del grupo de Facebook «Hey Xpeng France !». Se conecta a la nube de Xpeng exactamente igual que la app del móvil y deja los datos en MQTT.

1. Crea una cuenta XPENG secundariaCrea una cuenta nueva en la app XPENG con otro correo y, desde tu cuenta principal, comparte el coche con ella. Usar una cuenta aparte protege la principal.
2. Elige el aparato que ejecutará XPENG DirectHace falta un aparato siempre encendido con Docker: un NAS Synology o QNAP compatible con Docker, una Raspberry Pi 4 o 5, un mini PC o un contenedor LXC en Proxmox (mi caso). En Debian o Raspberry Pi OS, Docker se instala con:

   curl -fsSL https://get.docker.com | sh

   Copiar

   En Proxmox, dentro de un contenedor LXC sin privilegios, activa antes dos opciones desde la consola del host (sustituye <ID> por el número del contenedor):

   pct set <ID> --features nesting=1,keyctl=1

   Copiar
3. Lanza el asistente de configuración

   docker run -it --rm -v xpeng-storage:/data -p 8765:8765 \
     sbonnell/xpeng-direct:latest /app/setup.sh

   Copiar
   Después abre http://IP-del-aparato:8765 en el navegador.
4. Rellena el formulario
   • Inicia sesión con la cuenta secundaria.
   • MQTT: dirección = IP de Home Assistant (sin http://), puerto 1883, usuario y contraseña MQTT.
   • Capacidad de la batería: por ejemplo 80 kWh para un G6 2026.
   Valida y detén el asistente con Ctrl + C.
5. Comprueba que todo se ha guardadoEn mi caso la dirección del broker se quedó vacía aunque la había guardado, y no llegaba nada. Este comando muestra el archivo de ajustes:

   docker run --rm -v xpeng-storage:/data alpine \
     sh -c 'ls -l /data; cat /data/settings.json'

   Copiar
   Si la dirección está vacía, repite el paso 3.
6. Lanza XPENG Direct de forma definitiva

   docker run -d --name xpeng-direct --restart unless-stopped \
     -v xpeng-storage:/data sbonnell/xpeng-direct:latest

   Copiar
   La opción --restart unless-stopped lo vuelve a arrancar solo después de un corte de luz. Para ver lo que hace:

   docker logs -f xpeng-direct

   Copiar
7. Encuentra el coche en Home AssistantAjustes → Dispositivos y servicios → MQTT: aparece un dispositivo Xpeng vehicle con sus sensores (nivel, autonomía, cierre, cable, neumáticos, ventanillas, habitáculo, posición…).

Para actualizar XPENG Direct más adelante:

docker pull sbonnell/xpeng-direct:latest
docker rm -f xpeng-direct
# y vuelve a lanzar el comando «docker run -d …» de arriba

3En Home Assistant

1. Renombra las entidades desde el principioLlegan con nombres ilegibles como sensor.wican_14c19f…_soc. Renómbralas a sensor.xpeng_g6_soc, etc. (Ajustes → Entidades → rueda dentada). Tus tarjetas y automatizaciones serán mucho más claras.
2. Añade contadores de kilómetrosDos ayudantes «Contador de servicios públicos» sobre el odómetro, uno mensual y otro anual. Muestran desconocido hasta la segunda lectura: es normal.
3. Calcula tu consumo realCruzando los kilómetros recorridos con la energía que mide tu cargador obtienes tus kWh/100 km y tu coste real a los 100 km. La calculadora Watt Budget hace lo mismo en cuanto a precios.
4. Conecta Watt Budget a Home AssistantEl nivel de batería del coche ya es un sensor: Watt Budget puede leerlo cada minuto y calcular tus cargas sin que tengas que escribir nada. Los cuatro pasos.
5. Construye tu tarjetaMi tarjeta es una custom:button-card (disponible en HACS). Usa los datos de XPENG Direct cuando tienen menos de 30 minutos y, si no, los del WiCAN, y muestra la parte solar de cada carga. ¿Quieres la misma? Escríbeme desde la página de contacto de Watt Budget.

4Precauciones

• Reposo del WiCAN: ajusta el umbral de reposo justo por encima de la tensión de 12 V del coche dormido (13,1 V en mi G6), para que el dongle se duerma a la vez que él.
• Solo lectura: ninguna de las dos vías permite abrir el coche ni encender el climatizador. Para eso, sigue usando la app XPENG (o sus Atajos en iPhone).
• Coche en renting: revisa tu contrato antes de dejar un aparato conectado. Se quita en dos segundos antes de devolver el coche.

Preguntas frecuentes

Enlaces y agradecimientos

• Mi repositorio (perfil WiCAN, comentarios): github.com/FranckH250/xpeng-home-assistant-wican
• XPENG Direct (imagen Docker): github.com/Swiiney/xpeng-direct-docker
• Firmware WiCAN: github.com/meatpiHQ/wican-fw · integración: github.com/jay-oswald/ha-wican

Gracias a Paul Simon y Stéphane Bonnell por XPENG Direct, a stevelea por su trabajo con los PID de Xpeng, al equipo de MeatPi y a la comunidad «Hey Xpeng France !».