Growatt Modbus für Home Assistant (Marketplace-Integration)

Installationen: Nicht angezeigt: gemeinsame Domain growatt_modbus
GitHub-Sterne: 71
Verbindung: Funktioniert lokal
Pflege: In den letzten 6 Monaten aktualisiert
Version: v2.0.5, 26. Oktober 2026
Kategorie: Energie, Solar und Batteriespeicher
Art: Marketplace-Integration
Marke: Growatt
Voraussetzung: Braucht den Marketplace (HACS bis Home Assistant 2026.10)
Domain: growatt_modbus
Quelle: github.com/0xAHA/Growatt_ModbusTCP
Probleme: Problem melden

Unabhängiges Verzeichnis, erstellt vom Entwickler von Vulpo. Steht in keiner Verbindung zu Home Assistant oder der Open Home Foundation.

Überblick

Growatt Modbus ist eine Integration, die Growatt-Solarwechselrichter über Modbus TCP oder eine serielle Verbindung ausliest. Sie kommuniziert lokal, ohne die Cloud, ShineWiFi oder die Server von Growatt. Sie fügt Sensoren, Binärsensoren, Zahlen, Auswahlen, Schalter, Uhrzeit-Entitäten und Tasten hinzu, darunter eine Uhrzeit-Synchronisierung des Wechselrichters und Schalter für die Leistung des Wechselrichters und den AC-Ausgang. Die Optionen umfassen das Abfrageintervall, ein langsameres Offline-Intervall, das Verbindungs-Timeout, die Anfrageverzögerung, invertierte Netz- oder Batterieleistung und eine Überschreibung des Batteriespannungsbereichs. Die Einrichtung läuft in der Benutzeroberfläche, bietet eine Auswahl der Wechselrichterserie und enthält eine Sicherheitsprüfung für Off-Grid-Modelle der SPF-Reihe, die ein anderes Protokoll verwenden. Reparaturhinweise melden Probleme wie zurückgesetzte Einstellungen, nicht passende Antworten des Gateways oder ein wahrscheinlich falsches Profil, und für Fehlerberichte steht ein Diagnose-Download bereit.

Zusammenfassung der README und des Codes von 0xAHA/Growatt_ModbusTCP, automatisch erstellt und übersetzt. Stimmt etwas nicht, oder betreust du das Projekt und möchtest hier deinen eigenen Text? Melde dich

Unterstützt

Funktioniert lokal Spricht mit deinen Geräten in deinem eigenen Netzwerk. Keine Cloud des Herstellers dazwischen.
Aus dem Marketplace Wird über den Marketplace installiert, früher HACS.
Aktiv gepflegt Das Projekt hat in den letzten sechs Monaten eine neue Version oder Änderung veröffentlicht.

Stellt bereit

Schalter
Sensoren

Einrichtung

Installiere sie aus dem Marketplace und starte Home Assistant neu. Füge sie dann unter Einstellungen > Geräte & Dienste hinzu.

Growatt Modbus Einrichtung

IntegrationsnameLokaler Name für Ihren Wechselrichter
Wechselrichter-SerieWählen Sie Ihr Wechselrichtermodell/-serie
VerbindungstypWie Sie eine Verbindung herstellen möchten

Wähle dein Wechselrichtermodell

Wechselrichtermodell

TCP-Verbindungseinrichtung

IP-AdresseIP-Adresse Ihres RS485-zu-TCP-Konverters
PortModbus TCP-Port (normalerweise 502)
Modbus Slave-IDWechselrichter Modbus-Adresse (normalerweise 1)
Trotzdem hinzufügen, ohne VerbindungstestFügt den Wechselrichter hinzu, auch wenn er nicht geantwortet hat. Nutze das, wenn er vorerst offline ist oder noch nicht unterstützt wird und du den Register-Scanner brauchst, um einen Scan zu erstellen.
VerbindungshardwareLegt Startwerte für die Abfrageeinstellungen unten fest. Wähle einen Growatt-Dongle, wenn du einen verwendest, denn er braucht langsamere, kleinere Lesevorgänge, um verbunden zu bleiben.

Serielle Verbindungseinrichtung

GerätepfadSerieller Gerätepfad (z.B. /dev/ttyUSB0 oder COM3)
BaudrateSerielle Kommunikationsgeschwindigkeit (normalerweise 9600)
Modbus Slave-IDWechselrichter Modbus-Adresse (normalerweise 1)

⚠️ Off-Grid Wechselrichter Sicherheitsprüfung

Ich habe einen Off-Grid (SPF) WechselrichterAktivieren Sie dies NUR, wenn Sie einen SPF-Serie Off-Grid Wechselrichter haben. Off-Grid Wechselrichter verwenden ein anderes Protokoll und werden zurückgesetzt, wenn VPP-Register abgerufen werden.

Nach der Einrichtung

GerätenameIhr Name für das Gerät (wird allen Sensornamen vorangestellt)
Wechselrichter-SerieWählen Sie Ihr Wechselrichtermodell/-serie (wählt automatisch die Protokollversion)
AbtastintervallWie oft der Wechselrichter im Online-Zustand abgefragt wird (5-300 Sekunden)
Offline-AbtastintervallWie oft der Wechselrichter im Offline-/Nachtbetrieb abgefragt wird (60-3600 Sekunden, Standard 300)
Verbindungs-TimeoutWie lange auf eine Antwort vom Wechselrichter gewartet wird (1-60 Sekunden)
Netzleistung invertierenAktivieren, wenn der CT-Klemmsensor verkehrt herum installiert ist (tauscht Import/Export auf der AC-Seite)
Batterieleistung invertierenAktivieren, wenn die Batterieleistung die falsche Richtung anzeigt (tauscht Lade-/Entladezeichen)
BatteriespannungsbereichAutomatische Auswahl des Batteriespannungsregisters überschreiben. Verwenden Sie Hochspannung wenn VPP register 31214 nicht antwortet und register 3169 ~10× zu niedrig liest (Symptom eines 16-bit Überlaufs bei ARK/HV-Batteriesystemen).
Modbus-Anfrageverzögerung (ms)Mindestpause zwischen aufeinanderfolgenden Modbus-Anfragen innerhalb eines Abfragezyklusses (50–1000 ms, Standard 250). Erhöhen Sie auf 500–1000 ms wenn das Protokoll transaction ID Fehler zeigt oder wenn der Wechselrichter während des Betriebs der Integration fehlerhafte Einträge protokolliert.
USB / Serieller AnschlussPfade unter /dev/serial/by-id/ sind an den Adapter selbst gebunden und bleiben nach einem Neustart erhalten. Ein /dev/ttyUSB-Pfad wird in der Reihenfolge des Einsteckens vergeben und kann auf ein anderes Gerät wechseln, wenn du mehr als einen USB-Seriell-Adapter hast.
Oder gib einen Pfad manuell einÜberschreibt die Auswahl oben. Nutze das, wenn der Adapter nicht aufgelistet ist oder um einen /dev/serial/by-id/-Pfad einzufügen.
Baudrate
Host / IP-AdresseIP-Adresse oder Hostname des RS485-zu-TCP-Gateways.
TCP-Port
Unit / Slave-IDModbus-Unit-ID, unter der der Wechselrichter antwortet. Meist 1. Wenn alle Messwerte nicht verfügbar sind und das Log Transportfehler zeigt, lohnt sich eine Prüfung mit einem eigenständigen Modbus-Client, denn manche Wechselrichter ignorieren die in ShineTools eingestellte Adresse und antworten nur auf 1.

Texte aus dem Code von 0xAHA/Growatt_ModbusTCP. Texte, für die das Repository keine Übersetzung hat, wurden automatisch übersetzt.

Entitäten

TastenUhrzeit-Synchronisierung des Wechselrichters, APX-Batterie aufwecken
SensorenAC-Scheinleistung, AC-Ladeenergie heute, AC-Ladeenergie gesamt, AC-Ladung maximale Leistung, AC-Strom, AC-Strom Phase R, AC-Strom Phase S, AC-Strom Phase T, AC-Entladeenergie heute, AC-Entladeenergie gesamt, AC-Frequenz, AC-Eingangsleistung und 184 weitere
SchalterLeistung des Wechselrichters, AC-Ausgang

Fehlerbehebung

DiagnosedatenLädt eine Diagnosedatei herunter, die du an einen Fehlerbericht anhängen kannst.
ReparaturhinweiseMögliche Hinweise unter Einstellungen > Reparaturen:Growatt: Einstellungen werden zurückgesetzt, Growatt: Wechselrichtermodell wird nicht mehr erkannt, Growatt: RS485-Gateway liefert nicht passende Antworten, Growatt: Dieser Wechselrichter hat möglicherweise das falsche Profil, Growatt: Keine Antwort seit der Einrichtung, prüfe die Modbus-Unit-ID

Aus der README

A native Home Assistant integration for Growatt solar inverters using direct Modbus RTU/TCP communication. Real-time data straight from your inverter — no cloud, no ShineWiFi, no dependency on Growatt's servers.
The documentation site covers supported models, sensor reference, inverter controls, energy dashboard setup, troubleshooting, and developer guides.

Aus der README von 0xAHA/Growatt_ModbusTCP, MIT License. Gekürzt.