Überblick
GoodWe Wallbox ist eine benutzerdefinierte Integration, die GoodWe EV-Ladegeräte in Home Assistant überwacht und steuert. Sie unterstützt den Cloud-Zugriff über das SEMS-Portal, lokales Modbus TCP und eine optionale native TCP-Verbindung, die als in Entwicklung markiert ist. Sie fügt einen Binärsensor für den Ladestatus, eine Taste zum Aktualisieren, Zahlen-Steuerelemente für Ladeleistung, Importstrom, Energie der Sitzung und Batterie-SOC, Auswahlfelder für Lademodus und Dauer, Schalter sowie Sensoren für Status, Leistung, Energie, Spannung und Strom hinzu. Die Schalter decken Laden, Plug & Charge, dynamisches Lastmanagement, Phasenumschaltung und die lokale TCP-Verbindung ab, wobei die Verfügbarkeit vom Modell und von den Werten abhängt, die die API meldet. Eine Option kann vor jedem Start aus Home Assistant den zuletzt in Home Assistant gewählten Lademodus wiederherstellen, und die native TCP-Verbindung kann automatisch übernehmen, wenn die Cloud ausfällt. Die Einrichtung erfolgt in der Benutzeroberfläche, und für Fehlerberichte steht ein Diagnose-Download zur Verfügung.
Zusammenfassung der README und des Codes von prezervos/goodwe-wallbox-sems-home-assistant, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich
Erscheint in Vulpo
Schnellumschalterkarte, Tastenkarte, Auswahl-Karte, Diagrammkarte, Apple Watch, Kontrollzentrum.Installationen im Verlauf
Platz 1.426 von 1.483 Marketplace-Integrationen. Installationen, die Analysedaten teilen.
Unterstützt
- Funktioniert lokalSpricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
- Aus dem MarketplaceWird über den Marketplace installiert, früher HACS.
- Aktiv gepflegtDas Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.
Stellt bereit
- Schalter
- Sensoren
Einrichtung
Installiere die Integration aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.
Verbindungstyp
- Verbindungstyp
- Vor dem Laden den in HA gewählten Modus wiederherstellenAktiviert: Vor einem Start aus HA den zuletzt in HA gewählten Lademodus wiederherstellen und prüfen. Die gespeicherte Präferenz bleibt beim Neuladen und bei HA-Neustarts erhalten. Ohne gespeicherte Präferenz bleibt der gemeldete Wallbox-Modus erhalten. Deaktiviert: Den aktuellen Wallbox-Modus beibehalten. SolarGo ersetzt die HA-Präferenz nicht. Kein Erzwingen beim Start oder regelmäßig. Der TCP-Leistungslimitschutz bleibt unabhängig aktiv.
Mit SEMS-Portal verbinden
- Benutzername (E-Mail)
- Passwort
Lokales Modbus TCP
- IP-Adresse oder Hostname
- Port
- Modbus-Geräte-ID (0 = automatisch)0 lassen für automatische Erkennung. GoodWe Wallbox Gen2 verwendet 247 (0xF7).
Plant / Station auswählen
- Plant / Station
Wallbox auswählen
- Wallbox
Seriennummer der Wallbox eingeben
- Wallbox-Seriennummer
- Plant ID (optional)
Produktmodell
- Produktmodell (z. B. GW11K-HCA)
Native TCP-Verbindung
- IPv4-Adresse der Wallbox
- Von der Wallbox erreichbare IPv4-Adresse von Home Assistant
- TCP-Listener-Port
- Identität durch LAN-Erkennung prüfen
- Seriennummer (bei Erkennung optional)
- IPv4-Adresse eines vertrauenswürdigen TCP-Proxys (optional; nur für Quell-NAT in Docker)
- Bei Cloud-Ausfall automatisch TCP verwendenCloud-Konto erforderlich. Übernahme nach mindestens drei Fehlern und 90 Sekunden ab dem ersten Fehler. Rückkehrversuch nach 30 Minuten im Leerlauf und erfolgreicher Vorprüfung; frische Daten innerhalb von 60 Sekunden. Fehlversuche verlängern den Abstand bis zwei Stunden. Manuelles TCP bleibt nach Neuladen aktiv; Rückkehr pausiert bis zur Cloud-Auswahl. Manuelle Cloud-Auswahl pausiert Fallback bis Neuladen.
Nach der Einrichtung
- Aktualisierungsintervall im Leerlauf (Sekunden)Cloud-/Modbus-Abfrageintervall. Lokales TCP nutzt 5 Sekunden, bei aktivem Leistungsschutz 2 Sekunden. Verifiziertes MQTT kann das HTTP-Ersatzintervall verdoppeln.
- Aktualisierungsintervall während des Ladens (Sekunden)Cloud-/Modbus-Abfrageintervall. Lokales TCP nutzt 5 Sekunden, bei aktivem Leistungsschutz 2 Sekunden. Verifiziertes MQTT kann das HTTP-Ersatzintervall verdoppeln.
- Plant IDZeigt den erkannten oder manuell eingetragenen Wert. Sie können ihn ändern; leer lassen für die automatische Erkennung.
- ProduktmodellZeigt den erkannten oder manuell eingetragenen Wert. Sie können ihn ändern; leer lassen für die automatische Erkennung.
- Vor dem Laden den in HA gewählten Modus wiederherstellenBeim Aktivieren wird der aktuell gemeldete Wallbox-Modus als Präferenz gespeichert. Ist er nicht lesbar, wird die Änderung nicht gespeichert. Danach stellt jeder Start aus HA den gespeicherten Modus wieder her und prüft ihn. Die Moduswahl in HA aktualisiert die Präferenz, SolarGo nicht. Sie bleibt beim Neuladen und Neustart erhalten. Deaktiviert bleibt der aktuelle Modus bestehen. Kein regelmäßiges Erzwingen; TCP-Leistungsschutz bleibt unabhängig aktiv.
- Native TCP-Steuerung aktivieren (Entwicklung)Aktiviert: weiter zu TCP und automatischem Wechsel auf Seite 2. Deaktiviert: auf dieser Seite speichern.
- IPv4-Adresse der Wallbox
- Von der Wallbox erreichbare IPv4-Adresse von Home Assistant
- TCP-Listener-Port
- Identität durch LAN-Erkennung prüfen
- Seriennummer (bei Erkennung optional)
- IPv4-Adresse eines vertrauenswürdigen TCP-Proxys (optional; nur für Quell-NAT in Docker)
- Bei Cloud-Ausfall automatisch TCP verwendenCloud-Konto erforderlich. Übernahme nach mindestens drei Fehlern und 90 Sekunden ab dem ersten Fehler. Rückkehrversuch nach 30 Minuten im Leerlauf und erfolgreicher Vorprüfung; frische Daten innerhalb von 60 Sekunden. Fehlversuche verlängern den Abstand bis zwei Stunden. Manuelles TCP bleibt nach Neuladen aktiv; Rückkehr pausiert bis zur Cloud-Auswahl. Manuelle Cloud-Auswahl pausiert Fallback bis Neuladen.
Texte aus dem Code von prezervos/goodwe-wallbox-sems-home-assistant. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.
Entitäten
- BinärsensorenLadevorgang
- TastenAktualisieren
- ZahlenMaximale Ladeleistung, Grenzstrom aus dem Netz, Max. Sitzungsenergie, Min. Sitzungsenergie, Min. Batterie-SOC, Ausgangsleistungsbegrenzung
- AuswahlfelderLademodus, Ladedauer
- SensorenStatus, Fahrzeugstatus, Ladeleistung, Energie der Ladesitzung, Zugeteilte Ladeleistung, Ladedauer, Status der Ladestation, Fahrzeugverbindung, Phase-A-Spannung, Phase-B-Spannung, Phase-C-Spannung, Phase-A-Strom und 12 weitere
- SchalterLaden, Min. Ladeleistung, Plug & Charge, Dynamisches Lastmanagement, Automatische Phasenumschaltung, EMS-Minimalleistungsmodus, Lokale TCP-Verbindung
Fehlerbehebung
- DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
Aus der README
Home Assistant custom integration for the GoodWe Wallbox.
3.0.7 also handles transient cloud state after Stop. It addresses cloud data changes after the SEMS update, adds bounded B0001 read recovery and improves opted-in native TCP control fallback. Beta availability does not mean GoodWe's cloud command backend is fixed. See release notes for validation and known limitations.
Informationen
- Installationen
- 55 teilen Analysedaten
- GitHub-Sterne
- 13
- Verbindung
- Funktioniert lokal
- Pflege
- In den letzten 6 Monaten aktualisiert
- Version
- 3.0.7,
- Kategorie
- Energie, Laden von E-Autos
- Art
- Marketplace-Integration
- Marke
- GoodWe
- Voraussetzung
- Braucht den Marketplace (HACS bis Home Assistant 2026.10)
- Domain
sems_wallbox- Probleme
- Problem melden















