[Modul] NRG-Stack InverterHub / Multi Wechselrichter - ein Modbus-TCP-Modul für GoodWe, SMA, Fronius, Sungrow, Solis, Growatt, SolaX, SolarEdge, Deye, Solplanet, Kostal, Victron, Huawei, FoxESS und weitere Hersteller (auch Symbox-RS485)

[Bricoleur]

Updates: 15.09.2026 (Huawei bestätigt, FoxESS neu, Kacheln wandern zu NRG-Stack Dashboard) und 19.09.2026 (Anschluss über den eingebauten RS485-Port der Symbox, Archiv-Verdichtung, Schutz vor Ausreißerwerten, GoodWe-Steuerung reagiert schneller). Details im jeweiligen Beitrag weiter unten, aktuell 0.77.0-beta.18.

InverterHub — ein Modbus-TCP-Modul für viele Wechselrichter (+ Discovery + Energiefluss-Kachel)

Moin zusammen,

InverterHub liest Wechselrichter verschiedenster Hersteller direkt per Modbus TCP aus — ein generisches Treiber-Framework statt eines eigenen Moduls pro Hersteller. Dazu gibt es einen Netzwerk-Discovery und eine animierte Energiefluss-Kachel .

Dank vieler fleißiger Beta-Tester (danke euch!) läuft mittlerweile einiges an realen Anlagen. Hier der aktuelle Stand.

Die drei Module

• InverterHub — die Auslese-Instanz. Hersteller wählen, IP eintragen, Datenpunkt-Gruppen aktivieren.
• InverterHub Discovery — durchsucht einen IP-Bereich und legt gefundene Wechselrichter automatisch als Instanz an (Herstellererkennung über charakteristische Register).
• InverterHub Kachel — Energiefluss-Visualisierung (Hauslast zentral, Solar/Netz/Batterie/Verbraucher radial). Funktioniert mit einer InverterHub-Instanz oder komplett eigenständig mit manuell zugewiesenen Variablen.

Unterstützte Hersteller

Legende: an realer Anlage bestätigt · an realer Anlage in Prüfung · nach Herstellerdoku/Referenz implementiert (Feldrückmeldung willkommen)

Hersteller	Status	Umfang
GoodWe (ET/EH/BT/BH)		PV, Netz, Batterie 1+2, Meter, Energie, Backup/Insel, EMS-Steuerung, Riso — produktiv im Einsatz
Fronius (SunSpec, GEN24-Hybrid)		PV je String (U/I/P), Netz, Smart Meter (Gesamt + je Phase U/I/P), Energie, Batterie (SOC/Leistung/Spannung), Status
SolarEdge (SunSpec + StorEdge)		PV, Netz, Meter inkl. Bezug/Einspeisung, Energie, Temperatur, StorEdge-Batterie (SOC/Leistung/Spannung/Strom/Temp/SOH/Zustand), berechnete PV-Erzeugung
Victron GX (Cerbo/Venus OS)		PV (DC + AC-gekoppelt), Netz, Batterie (SOC/Leistung/Spannung/Strom/Zustand), Hausverbrauch, Netz-Quelle
Kostal (PLENTICORE plus Gen. 1)		PV (3 DC-Eingänge), Netz, Batterie, Meter, Hausverbrauch nach Quelle, Energie, Riso
SMA (STP/STPS/SI)		PV, Netz, Meter, Energie, Temperatur, Status, Riso
Sungrow (SH-Hybrid)		PV, Netz, Batterie, Meter, Energie, Backup, Riso
Solis (Hybrid)		PV, Netz, Batterie, Meter, Energie
Growatt (TL-X/MOD/MIX/SPH/WIT)		PV, Netz, Energie, Temperatur, Fehlercodes, Riso (optional/modellabhängig)
SolaX		PV, Netz, Batterie, Meter — nur über SolaX-Monitoring-Dongle (TCP-Gateway)
Deye (SG04LP3)		PV, Netz, Batterie, Hausverbrauch, Energie
Solplanet / AISWEI		PV, Batterie, Temperatur, Energie
Huawei (SUN2000 + DTSU666 + LUNA2000)		PV, Netz, Wirkleistung, Temperatur, Status, Energie, Smart Meter, Batterie, Riso

Highlights

• Ein Modul, viele Hersteller — austauschbare Treiber, gemeinsame Konventionen.
• Discovery deckt alle Hersteller ab (Victron über Unit-ID 100, Huawei über Modell-Register …).
• Energiefluss-Kachel — animiert, skaliert automatisch, radiale Anordnung, beliebig viele Zusatz-Verbraucher (Wärmepumpe, mehrere Wallboxen mit Fahrzeug-Zuordnung, …). Neu: auch ohne InverterHub nutzbar (manuelle Datenpunkte von beliebigen Modulen/Zählern).
• Hauslast wird sauber berechnet (AC-Bilanz) und kann als eigene Variable ausgegeben werden; optionaler echter Hauslastzähler zeigt zusätzlich die Wandlungsverluste.
• Isolationswiderstand (Riso) bei GoodWe, Huawei, Sungrow, SMA, Kostal (Growatt optional).
• Invers-Schalter für Netz und Batterie (Datenpunkt-Konvention frei wählbar — die Kachel bleibt trotzdem korrekt).
• Energie-Einheit wahlweise kWh oder Wh (Basiseinheit; die neue Symcon-Darstellung skaliert dann selbst).

Anschluss-Besonderheiten (kurz)

• Kostal: Port 1502 (nicht 502) + Byte-Reihenfolge passend zum Gerät (Werk: CDAB).
• Victron: Port 502; Unit-ID ist bei Victron ein Geräte-Selektor → Systemdienst liegt fest auf 100 (wird automatisch angesprochen).
• Huawei: Port 502, Unit-ID meist 1 (auch 0/16 möglich).
• Fronius: Smart Meter ist ein eigenes Modbus-Gerät → „Smart-Meter-Adresse" (Vorgabe 200, oft 240).
• SolaX: nur über das Monitoring-Dongle (dessen IP eintragen, nicht die des WR).

Alle Registeradressen stehen im Beschreibungsfeld jeder Variable.

Installation über den Symcon Module Store (Beta-Kanal):

1. In der IP-Symcon-Konsole: Module Store öffnen.
2. Oben rechts den Kanal von „Stable" auf „Beta" umstellen (Zahnrad-/Filter-Symbol).
3. Nach „NRG-Stack InverterHub" suchen.
4. Installieren — danach stehen die Instanztypen „InverterHub", „InverterHub Suche" usw. beim Anlegen einer neuen Instanz zur Verfügung.

Der Beta-Kanal liefert laufend Updates ohne Review-Verzögerung — für Produktivanlagen also mit der üblichen Vorsicht genießen.

Status

Das Ganze ist Beta . Die Register basieren auf öffentlichen Hersteller-Doku, der Referenz OpenEMS, gepflegten Bibliotheken (z. B. huawei-solar-lib) und von euch geteilten Modbus-Vorlagen — und wurden, wo möglich, gegen reale Anlagen geprüft.

Rückmeldungen sind ausdrücklich erwünscht — besonders zu den mit / markierten Herstellern. Bitte mit Hersteller, Modell und betroffenem Register/Wert melden; bei Vorzeichen-Themen hilft ein kurzer Vergleich mit der Hersteller-App enorm.

Danke fürs Testen und die vielen guten Ideen!

Was noch kommt

Das Modul ist bewusst als wachsendes Projekt angelegt, nicht als abgeschlossenes Werk:

• Weitere Hersteller: und weitere sind als nächste Kandidaten im Blick — Vorschläge und vor allem Registerdokumentation zu weiteren Herstellern sind sehr willkommen.

• Monitoring Kachel-Visualisierung: geplant ist eine grafische Übersichts-Kachel die alle relevanten Elektrischen Werte darstellt.

• Mehrere Wechselrichter zusammenfassen: Bei Anlagen mit mehr als einem Wechselrichter (auch herstellerübergreifend) soll es eine Summen-/Aggregationsansicht geben, die die Werte aller Instanzen zu einer Gesamtanlagen-Sicht zusammenführt.

[DerStandart]

[Bricoleur]

Hallo DerStandart,

probiere nochmals, Update sollte oben sein und wirken.

Danke für den Test!

[DerStandart]

Mein WR ist von Sungrow. Ich habe keinerlei Gerät von GoodWe. Die IP von dem Gerät, die hier angezeigt wird, gehört zu einem MODBUS RTU zu MODBUS TCP Konverter und ist somit falsch.

Erstellen der Instanz funktioniert nun ohne Fehlermeldung.

Sehr sehr viele Variablen bleiben leer. Ich warte mal ein bißchen ab und melde mich später noch mal.

[Bricoleur]

Danke Dir für die Rückmeldung. Die Discovery Instanz findet alle Modbusgeräte und schaut auf welchen WR es passen könnte. Das ist natürlich suboptimal, bei mir findet er gleich mal 5 WR obwohl ich nur 1 WR habe, das andere sind Zähler und Wallboxen. Wenn alles mit dem Modul klappt, dann habe ich vor ein analoges Modul für Zähler bzw. Netzanalysegeräte wie z.B. PAC2200 bzw. Janitza UMG604 etc. zu bauen.

So wie das Modul den PAC2200 auf der 101 erkennt, scheint er einem SolaX ähnlich zu sein.

Vielleicht bekomme ich das noch hin, dass nicht alles was Modbus ist erkannt wird.

[DerStandart]

@Bricoleur

Die Discovery Instanz findet alle Modbusgeräte

Das ist nicht richtig. Ich habe den MODBUS RTU auf MODBUS TCP Konverter hier insgesamt 2 Mal im Netzwerk. Baugleiche Geräte. Nur eines wird gefunden. Darüber hinaus gibt es hier noch mindestens ein anderes Gerät, welches MODBUS spricht, aber auch nicht erkannt wird.

Mich stört es aber nicht.

[Bricoleur]

Sehr gut wenn es Dich nicht stört. Welchen Sungrow hast Du denn? Da Du sagst, dass nicht sehr viele Register ausgelesen werden, bin ich noch auf der Suche und dem einbinden nach anderen Registertabellen.

[DerStandart]

@Bricoleur

Welchen Sungrow hast Du denn?

Sungrow SH 6.0 RT

Hier die Idents der Variablen, die nie ausgelesen worden sind:

soc                       
bat_total_pwr             
bat_charge_max_w          
bat_discharge_max_w       
work_mode                 
riso                      
temp_air                  
temp_module               
temp_heatsink             
dev_model                 
dev_fw_arm                
dev_fw_dsp                
grid_mode                 
island                    
meter_total               
grid_l1_volt              
grid_l1_curr              
grid_l1_freq              
grid_l1_pwr               
grid_l2_volt              
grid_l2_curr              
grid_l2_freq              
grid_l2_pwr               
grid_l3_volt              
grid_l3_curr              
grid_l3_freq              
grid_l3_pwr               
inv_total                 
pv1_voltage               
pv1_current               
pv2_voltage               
pv2_current               
mppt1_power               
mppt1_current             
pv3_voltage               
pv3_current               
pv4_voltage               
pv4_current               
mppt2_power               
mppt2_current             
pv5_voltage               
pv5_current               
pv6_voltage               
pv6_current               
mppt3_power               
mppt3_current             
warn_code                 
err_msg                   
err_detail                
bat1_volt                 
bat1_curr                 
bat1_pwr                  
bat1_mode                 
bat1_soc                  
bat1_soh                  
bat1_temp                 
bat1_bms_volt             
bat1_bms_curr             
bat1_chg_max_a            
bat1_dis_max_a            
bat1_bms_warn             
bat1_bms_alarm            
bat2_volt                 
bat2_curr                 
bat2_pwr                  
bat2_mode                 
bat2_soc                  
bat2_soh                  
bat2_temp                 
bat2_bms_volt             
bat2_bms_curr             
e_sell_day                
e_buy_day                 
e_load_day                
e_load_total              
e_charge_day              
e_charge_total            
e_disch_day               
e_disch_total             
work_hours                
mt_l1_volt                
mt_l2_volt                
mt_l3_volt                
mt_l1_curr                
mt_l2_curr                
mt_l3_curr                
backup_active             
backup_l1_volt            
backup_l1_curr            
backup_l1_freq            
backup_l1_pwr             
backup_l2_volt            
backup_l2_curr            
backup_l2_freq            
backup_l2_pwr             
backup_l3_volt            
backup_l3_curr            
backup_l3_freq            
backup_l3_pwr             
ctl_work_mode             
ctl_ems_enable            
ctl_ems_mode              
ctl_ems_power             
ctl_export_enable         
ctl_export_limit          
ctl_soc_min               
ctl_internet              
ctl_restart               
ctl_run   

Ich muss dazu sagen, dass bei mir an MPPT2 nichts hängt.

Und ich habe die IP vom WINET-S genutzt. Wenn man die IP des dedizierten Netzwerkanschlusses am Gerät nutzt, mag es möglicherweise mehrere Infos geben. Das muss man ggf. alles noch beachten.

[Bricoleur]

SH 6.0 RT sollte schon funktionieren. Liest Du die Werte auch auf normalem Weg via Symcon aus? Also mit Modbus I/O > Modbus Gerät … etc.

Wenn ja, was bekommst Du da alles vom WR zurück?

[DerStandart]

Ich habe keine MODBUS Geräte, sondern einzelne Instanzen pro Adresse. Damals gab es die MODBUS Geräts noch nicht. Ich habe mir also aus der Dokumentation des Herstellers alles herausgesucht, was für mich interessant sein könnte.

Momentan frage ich folgendes ab:

Export Power (13010-13011)
Load Power (13008)
Export limit min (5622)
Export limit max (5623)
Phase A Voltage (5019)
Phase B Voltage (5020)
Phase C Voltage (5021)
Meter Active Power (5601-5602)
Selfconsumption of today (13029)
Load 1 / On Off (13011)
Total DC Power (5017-5018)
Total active Power (13034-13035)
System State (13000)
Start Charging Power (13084)
MPPT 1 Current (5012)
MPPT 1 Voltage (5011)
MPPT 2 Current (5014)
MPPT 2 Voltage (5013)
Battery Level (13023)
Daily Output Energy (5003)
Daily Charge Energy (13040)
Battery current (13021)
Battery power (13022)
Battery state of healthy (13024)
Battery voltage (13020)
Batterie temperature (13025)
Min SOC (13059)
Max SOC (13058)
EMS mode selection (13050)
Charge / Discharge power (13052)
Charge / Discharge Command (13051)
Start Discharging Power (13085)
Inside Temperature (5008)
SOC for Backup (13100)
Total Output Energy (5004-5005)
Off-grid option (13075)
Global Scan (30230)
Start/Stop (13000)
Load 1 adjustment mode (13002)
Daily battery charge energy from PV (13012)
Daily direct energy consumption (13017) 
Daily battery discharge energy (13026)
Daily Import Energy (13036)
Daily PV Generation (13002)
Daily export power from PV (13005)
Total export energy from PV (13006-13007)
Total PV Generation (13003-13004)
Total direct energy consumption (13018-13019)
Total Import energy (13037-13038)
Total battery charge energy from PV (13013-13014)
Total battery discharge energy (13027-13028)
Running State (13001)

[Bricoleur]

Welche Werte kommen denn mit meinem Modul?

[Bricoleur]

Ich habe mir das mal angesehen, ich denke, dass ich das Richtung Wochenende hinbekommen könnte. Einige Dinge könnte das Modul auch automatisiert ausblenden, z.B. den 2. Bat Port wenn keiner da ist oder den 3. MPPT etc.

Muss mal gucken wann es geht, aber vielen dank schon mal für Deine Hilfe!

[DerStandart]

@Bricoleur

Welche Werte kommen denn mit meinem Modul?

ac_power                 
dev_sn                   
dev_rated_w              
running_state            
dev_type                 
grid_freq                
grid_v1                  
grid_v2                  
grid_v3                  
grid_reactive            
power_factor             
pv_total                 
mppt1_volt               
mppt1_curr               
mppt2_volt               
mppt2_curr               
mppt3_volt               
mppt3_curr               
mppt4_volt               
mppt4_curr               
connected                
e_pv_day                 
e_pv_total               
load_power               
export_power             
mt_l1_pwr                
mt_l2_pwr                
mt_l3_pwr                
backup_total             
backup_freq              
bat_power                
bat_volt                 
bat_curr                 
bat_soc                  
bat_soh                  
bat_temp

Das sind die Werte, die kommen. Zum Teil können sie auch 0 sein oder einen ungültigen Wert haben.

[Bricoleur]

Was denkst Du zum Handling, zur Einrichtung des Moduls. Warst Du bis dahin zufrieden?

[DerStandart]

@Bricoleur

Was denkst Du zum Handling, zur Einrichtung des Moduls

Netzwerk durchsuchen mag ich persönlich nicht. Ich hätte lieber eine IP eingegeben und fertig. Mag aber ein komische Eigenart von mir sein.

Mehr habe ich noch nicht damit angestellt. Werde mich heute Abend ausführlich beschäftigen.

[DerStandart]

grid_reactive, -262145
mt_l1_pwr, -13697025
bat_power, -52690945

Die scheinen mir ungültige Infos zu bekommen.

[Bricoleur]

Sehr wahrscheinlich!

[Bricoleur]

Netzwerk durchsuchen ist kein muss sondern eine Hilfe für so manchen. Generell kann man aber auch das Geräte „Wechselrichter (Multi-Hersteller)“ als Instanz anlegen und kann dann die IP eintippen wie Du es magst.

Nur möchte ich mit dem Modul auch noch eine andere Klasse bedienen und wenn ich da an unsere größte Anlage mit rund 900 Wechselrichtern denke - da möchtest Du dann auch keine Adressen mehr eintippen. Deshalb die Suche und auch die automatische Benennung der Wechselrichter.

[Bricoleur]

Danke für die vielen Rückmeldungen! Es ist einiges passiert, hier der Überblick:

Neue Hersteller

Zu den ursprünglichen sieben (GoodWe, Sungrow, Solis, Growatt, SolaX, SMA, Fronius) sind vier weitere dazugekommen:

• SolarEdge (reines SunSpec)
• Deye (SG04LP3-Serie)
• Solplanet / AISWEI (ASW-Gen-Serie)
• Kostal (PLENTICORE plus Gen. 1)

Bugfixes

• Sungrow und Solis hatten einen systematischen Off-by-one-Adressfehler (jedes Register wurde einen Schritt zu früh gelesen) — behoben, dank eines Testers mit Sungrow SH 6.0RT und seiner eigenen bestätigten Registerliste.
• Bei Sungrow wurde meter_total nie beschrieben — jetzt korrekt aus dem vom Tester bestätigten Register gelesen.
• Fronius: die SunSpec-Feldoffsets waren im empfohlenen Standardpfad (Float-Modell) fast durchgehend falsch (AC-Leistung, Status, Netzspannung, Netzfrequenz, Energiezähler betroffen) — gegen die offizielle SunSpec-Modelldefinition korrigiert.
• SMA komplett neu geschrieben: von herstellereigenen Registern auf SunSpec umgestellt — schließt die vorher offene Lücke bei AC-/Netzwerten.
• Kostal: Ladezustand (SOC) hatte einen Typ-/Profil-Mismatch — behoben, bevor es in freier Wildbahn auffallen konnte.

Discovery-Modul (Netzwerksuche)

• Erkennt jetzt auch die vier neuen Hersteller.
• Deutlich robuster gegen Fehlzuordnungen: mehrere gemeldete Fälle, in denen fremde Geräte fälschlich als Wechselrichter erkannt wurden (ein Janitza-Stromzähler als SolaX, ein Modbus-RTU/TCP-Konverter als GoodWe, zuletzt go-e-Wallboxen als Growatt) sind behoben — die Erkennung verlangt jetzt für jeden Hersteller ein zweites, härteres Kriterium (z. B. ein plausibles Seriennummer-/Text-Register), statt sich auf einen einzelnen Schwellenwert zu verlassen.
• Neu: Fortschrittsanzeige während der Suche — zeigt live den Portscan und danach die Hersteller-Erkennung je gefundener IP, statt einfach nur zu warten, bis alles fertig ist.

InverterHub

• Neu: Checkbox „Kommunikation aktiv" — damit lässt sich die Kommunikation zu einem Wechselrichter vorübergehend abschalten (z. B. bei Wartungsarbeiten), ohne die Instanz zu löschen oder die Konfiguration zu verlieren.

Bitte einmal neu testen

Wer die Fortschrittsanzeige und die verbesserte Erkennung im Discovery-Modul ausprobieren möchte: am einfachsten beide Instanzen (InverterHub und InverterHubDiscovery) einmal löschen und über die aktuelle Beta-Version neu anlegen. Bestehende, bereits laufende Instanzen profitieren von den Datenkorrekturen ohnehin automatisch beim nächsten Kernel-Neustart bzw. Modul-Update — nur die neue Fortschrittsanzeige und die Erkennungs-Verbesserungen selbst zeigen sich naturgemäß erst bei einer neuen Suche.

Wie immer: Rückmeldungen zu falschen/fehlenden Werten sehr willkommen, am besten mit Hersteller, Modell und betroffenem Register/Ident.

[Bricoleur]

Neue Version ist draussen und ich hoffe, dass ich einiges beheben konnte.

Vielleicht löschst Du auch nochmals beide Instanzen und beginnst nochmals mit der Discovery Instanz, auch wenn Du nicht der Scan-Typ bist, Für mich ist aber wichtig was er vermeintlich zu finden gedenkt etc.