Growatt Modbus voor Home Assistant (Marketplace-integratie)

Installaties: Niet getoond: gedeeld domein growatt_modbus
GitHub-sterren: 71
Verbinding: Werkt lokaal
Onderhoud: Bijgewerkt in de afgelopen 6 maanden
Versie: v2.0.5, 26 oktober 2026
Categorie: Energie, Zonne-energie en batterijen
Soort: Marketplace-integratie
Merk: Growatt
Vereist: Vereist de Marketplace (HACS op 2026.10 en ouder)
Domein: growatt_modbus
Bron: github.com/0xAHA/Growatt_ModbusTCP
Problemen: Probleem melden

Onafhankelijk overzicht, gemaakt door de ontwikkelaar van Vulpo. Niet gelieerd aan Home Assistant of de Open Home Foundation.

Over dit item

Growatt Modbus is een integratie die Growatt-zonne-omvormers uitleest via Modbus TCP of een seriële verbinding. Ze communiceert lokaal, zonder de cloud, ShineWiFi of de servers van Growatt. Ze voegt sensoren, binaire sensoren, nummers, selecties, schakelaars, tijdentiteiten en knoppen toe, waaronder een klokssynchronisatie van de omvormer en schakelaars voor het vermogen van de omvormer en de AC-uitgang. De opties omvatten scaninterval, een trager offline-interval, verbindingstimeout, verzoekvertraging, omgekeerd net- of accuvermogen en een overschrijving van het spanningsbereik van de accu. De installatie verloopt in de gebruikersinterface, biedt een keuze uit omvormerseries en bevat een veiligheidscontrole voor off-grid SPF-modellen, die een ander protocol gebruiken. Reparatiemeldingen wijzen op problemen zoals teruggedraaide instellingen, niet-overeenkomende gatewayantwoorden of een waarschijnlijk verkeerd profiel, en voor bugrapporten is een diagnosedownload beschikbaar.

Automatische samenvatting van de README en de code van 0xAHA/Growatt_ModbusTCP, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op

Ondersteunt

Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.

Levert

Schakelaars
Sensoren

Instellen

Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.

Growatt Modbus Installatie

IntegratienaamLokale naam voor uw omvormer
Omvormer SerieSelecteer uw omvormermodel/-serie
VerbindingstypeHoe u verbinding wilt maken

Selecteer je omvormermodel

Omvormermodel

TCP-verbinding instellen

IP-adresIP-adres van uw RS485-naar-TCP-converter
PoortModbus TCP-poort (normaal 502)
Modbus Slave-IDOmvormer Modbus-adres (normaal 1)
Toch toevoegen, zonder verbindingstestVoegt de omvormer toe, ook al heeft hij niet geantwoord. Gebruik dit als hij nu offline is, of als hij nog niet wordt ondersteund en je de registerscanner nodig hebt om een scan te maken.
VerbindingshardwareStelt beginwaarden in voor de pollinginstellingen hieronder. Kies een Growatt-dongle als je er een gebruikt: die hebben tragere, kleinere leesopdrachten nodig om verbonden te blijven.

Seriële verbinding instellen

ApparaatpadSerieel apparaatpad (bijv. /dev/ttyUSB0 of COM3)
BaudrateSeriële communicatiesnelheid (normaal 9600)
Modbus Slave-IDOmvormer Modbus-adres (normaal 1)

⚠️ Off-Grid Omvormer Veiligheidscontrole

Ik heb een off-grid (SPF) omvormerActiveer dit ALLEEN als u een SPF-serie off-grid omvormer heeft. Off-grid omvormers gebruiken een ander protocol en resetten als VPP-registers worden benaderd.

Na het instellen

ApparaatnaamUw naam voor het apparaat (wordt voor alle sensornamen geplaatst)
Omvormer SerieSelecteer uw omvormermodel/-serie (selecteert automatisch protocolversie)
ScanintervalHoe vaak de omvormer wordt gepolld wanneer online (5-300 seconden)
Offline scanintervalHoe vaak de omvormer wordt gepolld wanneer offline/'s nachts (60-3600 seconden, standaard 300)
VerbindingstimeoutHoe lang te wachten op een reactie van de omvormer (1-60 seconden)
Netvermogen omkerenActiveren als CT-klem omgekeerd is geïnstalleerd (wisselt import/export aan de AC-kant)
Batterijvermogen omkerenActiveren als batterijvermogen omgekeerde richting toont (wisselt laad-/ontlaadteken)
BatterijspanningsbereikAutomatische selectie van het batterijspanningsregister overschrijven. Gebruik Hoogspanning wanneer VPP register 31214 niet reageert en register 3169 ~10× te laag leest (symptoom van 16-bit overloop bij ARK/HV batterijsystemen).
Modbus-aanvraagvertraging (ms)Minimale pauze tussen opeenvolgende Modbus-aanvragen binnen een pollcyclus (50–1000 ms, standaard 250). Verhoog naar 500–1000 ms als het logboek transaction ID discrepantiefouten toont of als de omvormer valse foutmeldingen registreert terwijl de integratie actief is.
USB / Seriële poortPaden onder /dev/serial/by-id/ zijn gekoppeld aan de adapter zelf en blijven na een herstart behouden. Een /dev/ttyUSB-pad wordt toegewezen op volgorde van aansluiting en kan naar een ander apparaat verschuiven als je meer dan één USB-seriële adapter hebt.
Of voer handmatig een pad inOverschrijft de selectie hierboven. Gebruik dit als de adapter niet in de lijst staat, of om een pad van /dev/serial/by-id/ te plakken.
Baudrate
Host / IP-adresIP-adres of hostnaam van de RS485-naar-TCP-gateway.
TCP-poort
Unit / Slave-IDModbus-unit-ID waarop de omvormer antwoordt. Meestal 1. Als alle metingen niet beschikbaar zijn en het logboek transportfouten toont, is het de moeite waard dit te controleren met een losse Modbus-client: sommige omvormers negeren het adres dat in ShineTools is ingesteld en antwoorden alleen op 1.

Teksten uit de code van 0xAHA/Growatt_ModbusTCP. Teksten waarvoor de repository geen Nederlandse vertaling heeft, zijn automatisch vertaald.

Entiteiten

KnoppenKlokssynchronisatie omvormer, APX-accu wekken
SensorenAC-schijnbaar vermogen, AC-laadenergie vandaag, AC-laadenergie totaal, AC-laadmaximumvermogen, AC-stroom, AC-stroom fase R, AC-stroom fase S, AC-stroom fase T, AC-ontlaadenergie vandaag, AC-ontlaadenergie totaal, AC-frequentie, AC-ingangsvermogen en nog 184
SchakelaarsVermogen omvormer, AC-uitgang

Probleemoplossing

DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Growatt: instellingen worden teruggedraaid, Growatt: omvormermodel wordt niet meer herkend, Growatt: RS485-gateway geeft niet-overeenkomende antwoorden, Growatt: deze omvormer staat mogelijk op het verkeerde profiel, Growatt: geen antwoord sinds de installatie, controleer de Modbus-unit-ID

Uit de 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.

Uit de README van 0xAHA/Growatt_ModbusTCP, MIT License. Ingekort.