Votre Xpeng dans Home Assistant, sans abonnement

Le principe en une minute

Xpeng ne propose pas d'interface officielle pour Home Assistant. On récupère donc les données par deux chemins différents, qui aboutissent tous les deux au même endroit : un petit service de messagerie appelé MQTT, que Home Assistant écoute.

Mon conseil : si vous ne deviez en choisir qu'une, commencez par XPENG Direct (gratuit, beaucoup de données). Ajoutez le WiCAN Pro si vous voulez des mesures précises et totalement locales, par exemple pour piloter la recharge avec vos panneaux solaires.

Petit lexique pour débutants

Ce qu'il vous faut

• Home Assistant installé et accessible depuis votre ordinateur.
• Le module complémentaire Mosquitto broker (Réglages → Modules complémentaires → Boutique). Si vous utilisez déjà Zigbee2MQTT, vous l'avez déjà.
• Un utilisateur Home Assistant dédié pour MQTT : Réglages → Personnes → Utilisateurs → Ajouter, par exemple mqtt-xpeng, cochez « utilisateur local uniquement », non administrateur. Notez son mot de passe.
• Pour la voie 1 : un Wi-Fi 2,4 GHz qui capte à l'endroit où la voiture est garée (le WiCAN ne voit pas le 5 GHz).
• Pour la voie 2 : un appareil allumé 24 h/24 capable de faire tourner Docker, et un second compte XPENG (une autre adresse e-mail).

1Voie 1 : le dongle WiCAN Pro

Le WiCAN Pro (référence MP-WICAN-PRO, fabricant MeatPi) coûte environ 76 € HT chez Mouser. Ne prenez pas le WiCAN classique, moins cher mais trop limité.

1. Installez l'intégration dans Home AssistantDans HACS, ajoutez le dépôt personnalisé https://github.com/jay-oswald/ha-wican (catégorie Intégration), installez-le puis redémarrez Home Assistant.
2. Branchez le dongle et connectez-vous dessusBranchez-le sur la prise OBD sous le volant. Il crée un réseau Wi-Fi nommé WiCAN_xxxxxx (mot de passe @meatpi#). Connectez votre téléphone ou PC dessus, puis ouvrez http://192.168.0.10 dans un navigateur.
3. Changez tout de suite le mot de passeSinon, n'importe qui passant près de la voiture peut se connecter au dongle.
4. Vérifiez la version du firmwareVisez la v4.51. À ce jour (octobre 2026), la v6.00 n'interroge plus les PID du G6 et efface les réglages : je l'ai testée puis je suis revenu en arrière. Avant toute mise à jour, exportez une sauvegarde de la configuration.
5. Connectez-le à votre Wi-FiPassez le dongle en mode Station, choisissez votre Wi-Fi 2,4 GHz. Notez son nom dans l'onglet Status (forme wican_xxxxxxxxxxxx.local) et réservez-lui une IP fixe dans votre box.
6. Réglez le protocole et MQTTOnglet Settings :
   • Protocole CAN : AutoPID. Sans ça, rien ne fonctionne : c'est l'erreur n°1.
   • Broker MQTT : l'IP de Home Assistant, sans http:// ni port. Port 1883, identifiants de l'utilisateur MQTT créé plus haut.
   Enregistrez (Store), puis redémarrez le dongle depuis l'onglet About.
7. Chargez le profil allégé du G6Le profil Xpeng intégré interroge 234 paramètres, dont beaucoup donnent des valeurs fausses et saturent le dongle. Téléchargez plutôt mon profil à 8 paramètres xpeng_g6_wican.json et importez-le dans l'onglet Automate → Vehicle Profiles. Ne mélangez pas ce profil avec des PID ajoutés à la main.
8. Réveillez la voiture et vérifiezLe bus de la voiture ne répond pas quand elle dort. Asseyez-vous dedans, contact mis, et comparez le pourcentage de batterie affiché dans Home Assistant avec celui du tableau de bord : il doit être identique.

2Voie 2 : l'application XPENG Direct

XPENG Direct a été écrit par Paul Simon et mis en image Docker par Stéphane Bonnell, deux membres du groupe Facebook « Hey Xpeng France ! ». Il se connecte au cloud Xpeng exactement comme l'app de votre téléphone, puis dépose les données dans MQTT.

1. Créez un compte XPENG secondaireCréez un nouveau compte dans l'app XPENG avec une autre adresse e-mail, puis, depuis votre compte principal, partagez la voiture avec ce compte. Utiliser un compte à part protège votre compte principal.
2. Choisissez la machine qui fera tourner XPENG DirectIl faut un appareil allumé en permanence avec Docker : NAS Synology ou QNAP compatible Docker, Raspberry Pi 4 ou 5, mini-PC, ou conteneur LXC sous Proxmox (c'est mon cas). Sur Debian ou Raspberry Pi OS, Docker s'installe avec :

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

   Copier

   Sous Proxmox, dans un conteneur LXC non privilégié, activez d'abord deux options depuis le shell de l'hôte (remplacez <ID> par le numéro du conteneur) :

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

   Copier
3. Lancez l'assistant de configuration

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

   Copier
   Ouvrez ensuite http://IP-de-la-machine:8765 dans votre navigateur.
4. Remplissez le formulaire
   • Connectez-vous avec le compte secondaire.
   • MQTT : adresse = IP de Home Assistant (sans http://), port 1883, utilisateur et mot de passe MQTT.
   • Capacité batterie : par exemple 80 kWh pour un G6 2026.
   Validez, puis arrêtez l'assistant avec Ctrl + C.
5. Vérifiez que tout est bien enregistréChez moi, l'adresse du broker était restée vide malgré l'enregistrement, et rien ne remontait. Cette commande affiche le fichier de réglages :

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

   Copier
   Si l'adresse est vide, relancez l'étape 3.
6. Lancez XPENG Direct pour de bon

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

   Copier
   L'option --restart unless-stopped le relance automatiquement après une coupure de courant. Pour voir ce qu'il fait :

   docker logs -f xpeng-direct

   Copier
7. Retrouvez la voiture dans Home AssistantRéglages → Appareils et services → MQTT : un appareil Xpeng vehicle apparaît, avec ses capteurs (niveau, autonomie, verrouillage, câble, pneus, vitres, habitacle, position…).

Pour mettre à jour XPENG Direct plus tard :

docker pull sbonnell/xpeng-direct:latest
docker rm -f xpeng-direct
# puis relancez la commande « docker run -d … » ci-dessus

3Dans Home Assistant

1. Renommez les entités dès le départElles arrivent avec des noms illisibles du type sensor.wican_14c19f…_soc. Renommez-les en sensor.xpeng_g6_soc, etc. (Réglages → Entités → roue dentée). Vos cartes et automatisations seront bien plus lisibles.
2. Ajoutez des compteurs de kilomètresDeux entrées « Compteur de service » sur l'odomètre, l'une mensuelle, l'autre annuelle. Elles affichent inconnu jusqu'à la deuxième lecture : c'est normal.
3. Calculez votre consommation réelleEn croisant les kilomètres parcourus avec l'énergie mesurée par votre borne, vous obtenez vos kWh/100 km et votre coût réel aux 100 km. Le calculateur Watt Budget fait la même chose côté prix.
4. Reliez Watt Budget à Home AssistantLe niveau de batterie de la voiture est maintenant un capteur : Watt Budget peut le lire chaque minute et calculer vos recharges sans que vous ayez rien à saisir. Les quatre étapes.
5. Construisez votre carteMa carte est une custom:button-card (disponible dans HACS). Elle prend les données de XPENG Direct quand elles ont moins de 30 minutes, sinon celles du WiCAN, et affiche la part de solaire dans chaque recharge. Vous voulez la même ? Écrivez-moi via la page contact de Watt Budget.

4Précautions

• Veille du WiCAN : réglez le seuil de mise en veille juste au-dessus de la tension 12 V de la voiture endormie (13,1 V sur mon G6), pour qu'il s'endorme en même temps qu'elle.
• Lecture seule : aucune de ces deux voies ne permet d'ouvrir la voiture ou de lancer la climatisation. Pour ça, restez sur l'app XPENG (ou ses Raccourcis sur iPhone).
• Voiture en location longue durée : vérifiez votre contrat avant de laisser un boîtier branché. Il se retire en deux secondes avant la restitution.

Questions fréquentes

Liens et remerciements

• Mon dépôt (profil WiCAN, retours) : github.com/FranckH250/xpeng-home-assistant-wican
• XPENG Direct (image Docker) : github.com/Swiiney/xpeng-direct-docker
• Firmware WiCAN : github.com/meatpiHQ/wican-fw · intégration : github.com/jay-oswald/ha-wican

Merci à Paul Simon et Stéphane Bonnell pour XPENG Direct, à stevelea pour le travail sur les PID Xpeng, à l'équipe MeatPi et à la communauté « Hey Xpeng France ! ».