Ihr Xpeng in Home Assistant, ganz ohne Abo

Das Prinzip in einer Minute

Xpeng bietet keine offizielle Home-Assistant-Integration. Die Daten kommen deshalb über zwei verschiedene Wege, die am selben Ort enden: einem kleinen Nachrichtendienst namens MQTT, dem Home Assistant zuhört.

Mein Rat: Wenn Sie nur einen Weg wählen, beginnen Sie mit XPENG Direct (kostenlos, viele Daten). Nehmen Sie den WiCAN Pro dazu, wenn Sie genaue und vollständig lokale Messwerte wollen, etwa um das Laden mit Ihrer PV-Anlage zu steuern.

Kleines Glossar für Einsteiger

Was Sie brauchen

• Home Assistant, installiert und vom Computer aus erreichbar.
• Das Add-on Mosquitto broker (Einstellungen → Add-ons → Add-on-Store). Wenn Sie Zigbee2MQTT nutzen, haben Sie es schon.
• Einen eigenen Home-Assistant-Benutzer für MQTT: Einstellungen → Personen → Benutzer → Hinzufügen, zum Beispiel mqtt-xpeng, „Nur lokaler Zugriff“ anhaken, kein Administrator. Notieren Sie das Passwort.
• Für Weg 1: 2,4-GHz-WLAN am Stellplatz des Autos (der WiCAN sieht kein 5 GHz).
• Für Weg 2: ein rund um die Uhr laufendes Gerät, auf dem Docker läuft, und ein zweites XPENG-Konto (andere E-Mail-Adresse).

1Weg 1: der WiCAN-Pro-Dongle

Der WiCAN Pro (Artikelnummer MP-WICAN-PRO, Hersteller MeatPi) kostet bei Mouser etwa 76 € netto, alternativ über Crowd Supply. Kaufen Sie nicht den einfachen WiCAN: Er ist günstiger, aber zu eingeschränkt.

1. Integration in Home Assistant installierenFügen Sie in HACS das benutzerdefinierte Repository https://github.com/jay-oswald/ha-wican hinzu (Kategorie Integration), installieren Sie es und starten Sie Home Assistant neu.
2. Dongle einstecken und verbindenStecken Sie ihn in die OBD-Buchse unter dem Lenkrad. Er öffnet ein WLAN namens WiCAN_xxxxxx (Passwort @meatpi#). Verbinden Sie Handy oder Computer damit und öffnen Sie http://192.168.0.10 im Browser.
3. Sofort das Passwort ändernSonst kann sich jeder, der am Auto vorbeigeht, mit dem Dongle verbinden.
4. Firmware-Version prüfenZiel ist die v4.51. Stand Oktober 2026 fragt die v6.00 die PIDs des G6 nicht mehr ab und löscht die Einstellungen: Ich habe sie getestet und bin zurückgegangen. Exportieren Sie vor jedem Update eine Sicherung der Konfiguration.
5. Mit dem WLAN verbindenSchalten Sie den Dongle in den Modus Station und wählen Sie Ihr 2,4-GHz-WLAN. Notieren Sie seinen Namen im Tab Status (etwa wican_xxxxxxxxxxxx.local) und reservieren Sie im Router eine feste IP.
6. Protokoll und MQTT einstellenTab Settings:
   • CAN-Protokoll: AutoPID. Ohne das funktioniert nichts – der häufigste Fehler.
   • MQTT-Broker: die IP von Home Assistant, ohne http:// und ohne Port. Port 1883, mit dem zuvor angelegten MQTT-Benutzer.
   Speichern (Store) und den Dongle im Tab About neu starten.
7. Das schlanke G6-Profil ladenDas eingebaute Xpeng-Profil fragt 234 Parameter ab, viele davon mit falschen Werten, und überlastet den Dongle. Laden Sie stattdessen mein Profil mit 8 Parametern xpeng_g6_wican.json herunter und importieren Sie es unter Automate → Vehicle Profiles. Mischen Sie dieses Profil nicht mit von Hand hinzugefügten PIDs.
8. Auto wecken und prüfenDas Bordnetz antwortet nicht, solange das Auto schläft. Setzen Sie sich bei eingeschalteter Zündung hinein und vergleichen Sie den Akkustand in Home Assistant mit der Anzeige im Auto: Er muss exakt übereinstimmen.

2Weg 2: die App XPENG Direct

XPENG Direct wurde von Paul Simon geschrieben und von Stéphane Bonnell als Docker-Image verpackt, beide Mitglieder der Facebook-Gruppe „Hey Xpeng France !“. Es meldet sich genau wie die Handy-App bei der Xpeng-Cloud an und legt die Daten in MQTT ab.

1. Ein zweites XPENG-Konto anlegenLegen Sie in der XPENG-App ein neues Konto mit einer anderen E-Mail-Adresse an und teilen Sie das Auto von Ihrem Hauptkonto aus mit diesem Konto. Ein separates Konto schützt Ihr Hauptkonto.
2. Das Gerät für XPENG Direct wählenSie brauchen ein dauerhaft laufendes Gerät mit Docker: ein Docker-fähiges NAS von Synology oder QNAP, einen Raspberry Pi 4 oder 5, einen Mini-PC oder einen LXC-Container unter Proxmox (so bei mir). Unter Debian oder Raspberry Pi OS installieren Sie Docker mit:

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

   Kopieren

   Unter Proxmox aktivieren Sie bei einem unprivilegierten LXC-Container zuerst zwei Optionen in der Host-Shell (<ID> durch die Container-Nummer ersetzen):

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

   Kopieren
3. Den Einrichtungsassistenten starten

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

   Kopieren
   Öffnen Sie dann http://IP-des-Geräts:8765 im Browser.
4. Das Formular ausfüllen
   • Melden Sie sich mit dem Zweitkonto an.
   • MQTT: Adresse = IP von Home Assistant (ohne http://), Port 1883, MQTT-Benutzer und Passwort.
   • Akkukapazität: zum Beispiel 80 kWh für einen G6 (2026).
   Bestätigen und den Assistenten mit Strg + C beenden.
5. Prüfen, ob alles gespeichert wurdeBei mir blieb die Broker-Adresse trotz Speichern leer, und es kam nichts an. Dieser Befehl zeigt die Einstellungsdatei:

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

   Kopieren
   Ist die Adresse leer, wiederholen Sie Schritt 3.
6. XPENG Direct dauerhaft starten

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

   Kopieren
   Die Option --restart unless-stopped startet es nach einem Stromausfall automatisch neu. Um zu sehen, was es tut:

   docker logs -f xpeng-direct

   Kopieren
7. Das Auto in Home Assistant findenEinstellungen → Geräte & Dienste → MQTT: Ein Gerät Xpeng vehicle erscheint mit seinen Sensoren (Ladestand, Reichweite, Verriegelung, Kabel, Reifen, Fenster, Innenraum, Position…).

So aktualisieren Sie XPENG Direct später:

docker pull sbonnell/xpeng-direct:latest
docker rm -f xpeng-direct
# dann den Befehl „docker run -d …“ von oben erneut ausführen

3In Home Assistant

1. Entitäten gleich umbenennenSie kommen mit unleserlichen Namen wie sensor.wican_14c19f…_soc. Benennen Sie sie in sensor.xpeng_g6_soc usw. um (Einstellungen → Entitäten → Zahnrad). Karten und Automationen werden so viel übersichtlicher.
2. Kilometerzähler anlegenZwei Helfer vom Typ „Verbrauchszähler“ auf den Kilometerstand, einer monatlich, einer jährlich. Bis zum zweiten Messwert zeigen sie unbekannt: Das ist normal.
3. Den echten Verbrauch berechnenKombinieren Sie gefahrene Kilometer mit der von Ihrer Wallbox gemessenen Energie, und Sie erhalten Ihre echten kWh/100 km und Kosten pro 100 km. Der Rechner Watt Budget erledigt dasselbe für die Preisseite.
4. Watt Budget mit Home Assistant verbindenDer Akkustand des Autos ist jetzt ein Sensor: Watt Budget kann ihn jede Minute lesen und Ihre Ladungen berechnen, ohne dass Sie etwas eingeben müssen. Die vier Schritte.
5. Ihre Karte bauenMeine Karte ist eine custom:button-card (in HACS verfügbar). Sie nutzt die Daten von XPENG Direct, wenn sie jünger als 30 Minuten sind, sonst die des WiCAN, und zeigt den Solaranteil jeder Ladung. Sie möchten dieselbe? Schreiben Sie mir über die Kontaktseite von Watt Budget.

4Vorsichtsmaßnahmen

• Ruhemodus des WiCAN: Stellen Sie die Schlafschwelle knapp über die 12-V-Spannung des schlafenden Autos (13,1 V bei meinem G6), damit der Dongle gleichzeitig einschläft.
• Nur lesend: Keiner der beiden Wege kann das Auto entriegeln oder die Klimaanlage starten. Dafür bleibt die XPENG-App (oder ihre Kurzbefehle auf dem iPhone).
• Leasingfahrzeug: Prüfen Sie Ihren Vertrag, bevor Sie ein Gerät dauerhaft eingesteckt lassen. Es ist vor der Rückgabe in zwei Sekunden entfernt.

Häufige Fragen

Links und Dank

• Mein Repository (WiCAN-Profil, Rückmeldungen): github.com/FranckH250/xpeng-home-assistant-wican
• XPENG Direct (Docker-Image): github.com/Swiiney/xpeng-direct-docker
• WiCAN-Firmware: github.com/meatpiHQ/wican-fw · Integration: github.com/jay-oswald/ha-wican

Danke an Paul Simon und Stéphane Bonnell für XPENG Direct, an stevelea für die Arbeit an den Xpeng-PIDs, an das MeatPi-Team und an die Community „Hey Xpeng France !“.