Huawei SUN2000

Modbus TCP

Submitted by

Last updated: 03. 2026

Huawei FusionSolar

Die Huawei SUN2000 3-10KTL Serie umfasst einphasige und dreiphasige String-Wechselrichter für PV-Anlagen im Wohnbereich mit einer Nennleistung von 3 kW bis 10 kW. TapHome verbindet sich mit dem Wechselrichter über Modbus TCP — entweder direkt über den integrierten WiFi-Zugangspunkt des Wechselrichters oder über einen Huawei Smart Dongle (WLAN-FE oder LAN) im lokalen Netzwerk.

Die Vorlage bietet Wirkleistungsüberwachung, DC-Eingangsleistung, PV-String-Strom- und Spannungswerte für bis zu 4 Strings, tägliche und kumulative Energiezähler, detaillierten Wechselrichterstatus mit Alarmdekodierung, Batteriespeicherübersicht (für LUNA2000) und Leistungssteuerungsaktionen einschließlich Blindleistungskompensation und Wirkleistungsbegrenzung.

Modbus-Kommunikation aktivieren

Der SUN2000 Wechselrichter unterstützt Modbus TCP über seinen WiFi-Zugangspunkt und über den Smart Dongle. Für eine dauerhafte Verbindung mit TapHome wird die Verwendung eines Huawei Smart Dongle-WLAN-FE (oder Smart Dongle-4G) am USB-Port des Wechselrichters empfohlen.

Verbindungsoptionen

Methode	Schnittstelle	Hinweise
Smart Dongle (empfohlen)	Ethernet / WiFi	Verbindet den Wechselrichter mit dem lokalen Netzwerk. Ermöglicht gleichzeitiges Modbus TCP + FusionSolar-App.
WiFi-Zugangspunkt	WiFi	Direktverbindung zum AP des Wechselrichters (SSID: `SUN2000-<serial>`). Nur ein Client gleichzeitig.
RS-485 (Modbus RTU)	COM-Port-Pins RS485A1/B1	Wird von dieser Vorlage nicht verwendet. Kann nicht gleichzeitig mit FusionSolar-Monitoring betrieben werden.

Bei Verwendung der WiFi-Zugangspunkt-Methode kann sich die FusionSolar-App nicht gleichzeitig verbinden. Verwenden Sie für Produktivinstallationen immer den Smart Dongle, damit TapHome und FusionSolar gleichzeitig arbeiten können.

Smart Dongle einrichten

Stecken Sie den Smart Dongle-WLAN-FE in den USB-Port an der Unterseite des Wechselrichters
Verbinden Sie den Smart Dongle über die FusionSolar-App mit dem lokalen WiFi-Netzwerk (Ersteinrichtung)
Der Dongle erhält eine IP-Adresse vom Router per DHCP
Notieren Sie die IP-Adresse aus der DHCP-Zuweisungstabelle des Routers

Weisen Sie dem Smart Dongle eine statische IP-Adresse in den DHCP-Einstellungen des Routers zu, damit sich die Adresse nach einem Stromausfall nicht ändert.

Netzwerkverbindung

Protokoll: Modbus TCP
Port: 502 (Standard-Modbus-TCP-Port)
Standard-Slave-ID: 1
Byte-Reihenfolge: Big-Endian (Standard-Modbus)

Die Huawei Home Assistant-Integration verwendet standardmäßig Port 503 (WiFi-AP-Modus). Bei Verbindung über den Smart Dongle im lokalen Netzwerk verwendet TapHome den Standard-Modbus-TCP-Port 502.

Konfiguration

Beim Import der Vorlage in TapHome geben Sie an:

IP-Adresse — IP-Adresse des Smart Dongle im lokalen Netzwerk (oder WiFi-AP-IP des Wechselrichters, Standard: 192.168.200.1)
Slave-ID — Modbus-Slave-Adresse (Standard: 1)

Gerätefunktionen

Die Vorlage stellt folgende Geräte bereit:

Wirkleistung

Ein Stromzähler-Gerät, das den aktuellen AC-Ausgang des Wechselrichters liest. Dies ist das primäre Leistungsüberwachungsgerät.

Wirkleistung — aktuelle AC-Ausgangsleistung in kW (Register H:32080, Int32)
Leistungsfaktor — Netz-Leistungsfaktor (Register H:32084, Int16)
Spitzen-Wirkleistung des Tages — höchste Leistung heute in kW (Serviceattribut, H:32078)
Blindleistung — aktuelle Blindleistung in kVar (Serviceattribut, H:32082)
Nennleistung / Max. Wirkleistung / Max. Scheinleistung — Typenschildwerte aus Registern H:30073, H:30075, H:30077

Das Gerät bietet zudem drei Serviceaktionen zur Leistungssteuerung:

Blindleistungskompensation (PF) — Leistungsfaktor von -1,0 bis 1,0 einstellen (schreibt in H:40122)
Blindleistungskompensation (Q/S) — Blindleistungsverhältnis einstellen (schreibt in H:40123)
Wirkleistungsbegrenzung (%) — Ausgangsleistung als Prozentsatz 0–100 % begrenzen (schreibt in H:40125)

DC-Eingangsleistung

Nur-Lese-Sensor, der die gesamte DC-Eingangsleistung aller PV-Strings in kW anzeigt (Register H:32064, Int32, geteilt durch 1000).

Serviceattribute zeigen netzseitige Details: Netzfrequenz (H:32085), Phasenspannungen A/B/C (H:32069–32071) und Phasenströme A/B/C (H:32072–32076).

Batterie

Ein Container-Gerät für den Batteriespeicherstatus (Huawei LUNA2000). Zeigt:

Betriebszustand — Offline, Standby, Betrieb, Störung oder Schlafmodus (H:37762)
Heutige Ladung — heute geladene Energie in kWh (H:37784)
Heutige Entladung — heute entladene Energie in kWh (H:37786)

Das Batteriegerät funktioniert nur, wenn eine LUNA2000-Batterie mit dem Wechselrichter verbunden ist. Ohne Batterie zeigt der Betriebszustand „Offline" an.

Gesamtenergie

Kumulative Energie seit Inbetriebnahme in kWh (Register H:32106, UInt32, geteilt durch 100).

Tagesenergie

Heute erzeugte Energie in kWh (Register H:32114, geteilt durch 100).

PV-String-Ströme (PV1–PV4)

Vier separate Sensorgeräte, eines pro PV-String, messen den DC-Strom in Ampere (Register H:32017, H:32019, H:32021, H:32023). Jedes Gerät enthält ein Serviceattribut für die entsprechende String-Spannung (H:32016, H:32018, H:32020, H:32022).

Die Anzahl der aktiven PV-String-Geräte hängt vom Wechselrichtermodell und der Installation ab. Nicht verwendete Strings zeigen 0 A an.

Wechselrichterstatus

Ein Mehrwert-Schalter (nur lesen), der den aktuellen Betriebszustand des Wechselrichters aus Register H:32089 anzeigt:

Wert	Zustand	Beschreibung
0	Wechselrichterzustand	Initial / unbekannt
1	Leerlauf	ISO-, Einstrahlungs- oder Netzerkennung
2	Startvorgang	Wechselrichter startet
3	On Grid	Normale Stromerzeugung
4	Abschaltung	Störung, Befehl, OVGR oder DC-Abschaltung
5	Grid Dispatch	cos(Phi)-P oder Q-U-Kurve aktiv
6	IV-Scan	PV-String-I-V-Kurven-Scan
7	Spot-Check	Netz-Spot-Check läuft
8	Inspektion	Inspektionsmodus
9	DC-Eingangserkennung	DC-Eingang wird erkannt

Serviceattribute liefern detaillierte Zustandsinformationen:

Vollständiger Zustand — erweiterter Status mit allen Unterzuständen (z. B. „Abschaltung: Störung", „On-Grid: Leistungsbegrenzung")
Netzverbindung — Standby, normal, Derating durch Leistungsbegrenzung oder interne Ursachen
Fernmeldung — IEC104-Telesignalisierungszustand
Sperrstatus / PV-Verbindungsstatus — aus Überwachungsregister H:32002
Startzeit / Abschaltzeit — letzte Start- und Abschaltzeitstempel

Alarmüberwachung

Das Leseskript auf Modulebene überwacht die Alarmregister H:32008 und H:32009 (Bitfield16). Jedes Bit entspricht einer bestimmten Störung oder Warnung:

Register	Bit	Alarm
H:32008	0	Hohe String-Spannung
H:32008	1	DC-Lichtbogenfehler
H:32008	2	String verpolt
H:32008	3	Abnormaler String (Warnung)
H:32008	7	Netzausfall
H:32008	8–9	Netzunter-/Überspannung
H:32008	11–13	Netzfrequenzstörungen
H:32008	14–15	Ausgangsüberstrom / DC-Komponente
H:32009	0	Abnormaler Ableitstrom
H:32009	1–2	Erdungs-/Isolationsfehler
H:32009	3–4	Hohe Temperatur / Gerätefehler
H:32009	9	Abnormales Energiespeichergerät
H:32009	10–11	Aktiver/passiver Inselbetrieb

Diagnose auf Modulebene

Das Modul stellt Serviceattribute für Geräteidentifikation und Diagnose bereit:

Attribut	Register	Beschreibung
Modellname	H:30000	Typenschild-Modell
SN	H:30015	Seriennummer
PN	H:30025	Produktcode
Modell-ID	H:30070	Numerische Modellkennung
Anzahl Strings	H:30071	Angeschlossene PV-Strings
MPPT-Anzahl	H:30072	Anzahl MPP-Tracker
Systemzeit	H:40000	Lokale Zeit des Wechselrichters
Zeitzone	H:43006	UTC-Offset
Wechselrichtereffizienz	H:32086	Umwandlungswirkungsgrad (%)
Gehäusetemperatur	H:32087	Innentemperatur
Isolationswiderstand	H:32088	PV-Feld-Isolation
DSP-Datenerfassung	H:32002	Status der Datenerfassung

Die Serviceaktion Zeitzone ermöglicht das Setzen des UTC-Offsets des Wechselrichters (schreibt in H:43006).

Zusätzliche Funktionen

Der SUN2000-Wechselrichter stellt weitere Register bereit, die in der Vorlage noch nicht implementiert sind. Dazu gehören verkettete Spannungen (A-B, B-C, C-A), das Fehlercode-Register, ein schneller aktualisierender Wirkleistungswert, der Gesamt-DC-Eingangsenergie-Zähler, monatliche und jährliche Energiezähler, der Ladezustand (SOC) und die Lade-/Entladeleistung der Batterie, die aktive Netzleistung (Bezug/Einspeisung vom Leistungsmessgerät), eingespeiste und kumulierte Energie sowie Befehle zum Fernein- und -ausschalten. Diese können in einer zukünftigen Vorlagenaktualisierung ergänzt werden.

Der Batterieladezustand (SOC) fehlt in der aktuellen Vorlage trotz vorhandenem Batteriegerät. Wenn Sie eine SOC-Überwachung benötigen, kann diese als benutzerdefiniertes Modbus-Gerät hinzugefügt werden, das Register H:37760 liest (UInt16, durch 10 teilen, Ergebnis in %).

Fehlerbehebung

Keine Modbus-Kommunikation

Überprüfen Sie, ob der Smart Dongle im USB-Port des Wechselrichters steckt und Strom hat (LED aktiv)
Bestätigen Sie die IP-Adresse des Dongle in der DHCP-Zuweisungstabelle des Routers
Stellen Sie sicher, dass TapHome Core und der Smart Dongle im gleichen Netzwerk/Subnetz sind
Prüfen Sie, dass keine Firewall Port 502 blockiert
Bei WiFi-AP-Modus verbinden Sie sich mit der SSID des Wechselrichters (SUN2000-<serial>) und verwenden Sie IP 192.168.200.1

PV-Strings zeigen Nullwerte

Nicht verwendete PV-String-Eingänge lesen immer 0 A / 0 V. Dies ist normal, wenn das Wechselrichtermodell weniger MPPT-Eingänge hat als die Vorlage bereitstellt (z. B. ein 3KTL-Modell verwendet möglicherweise nur PV1 und PV2).

Batteriegerät zeigt „Offline"

Die LUNA2000-Batterieregister werden nur befüllt, wenn eine kompatible Batterie physisch mit dem Wechselrichter verbunden ist. Ohne Batterie zeigt der Betriebszustand „Offline" an und die Lade-/Entladezähler sind null.

Wechselrichterstatus bleibt auf „Leerlauf"

Bei Nacht oder geringer Einstrahlung wechselt der Wechselrichter in den Leerlaufmodus. Dies ist normal — er wechselt zu „On Grid", sobald ausreichende Sonneneinstrahlung erkannt wird.

Verfügbare Geräte

SUN2000 TCP Modul

SUN2000 TCP

Lesen (Modul)

var a1 := MODBUSR(H, 32008, Uint16);
var a2 := MODBUSR(H, 32009, Uint16);
IF(GETBIT(a1,0) = 1, ADDERROR("High String Voltage", 2001));
IF(GETBIT(a1,1) = 1, ADDERROR(${dc_arc_fault}, 2002));
IF(GETBIT(a1,2) = 1, ADDERROR("String Reversed", 2011));
IF(GETBIT(a1,3) = 1, ADDWARNING("PV String Backfeed ", 2012));
IF(GETBIT(a1,4) = 1, ADDWARNING("Abnormal String", 2013));
IF(GETBIT(a1,5) = 1, ADDERROR(${afci_fault}, 2021));
IF(GETBIT(a1,6)= 1, ADDERROR(${short_circ_L-PE}, 2021));
IF(GETBIT(a1,7) = 1, ADDERROR(${power_grid_fail}, 2032));
IF(GETBIT(a1,8) = 1, ADDERROR(${grid_undervoltage}, 2033));
IF(GETBIT(a1,9) = 1, ADDERROR(${grid_overvoltage}, 2034));
IF(GETBIT(a1,10) = 1, ADDERROR(${unbalanced_grid_V}, 2035));
IF(GETBIT(a1,11) = 1, ADDERROR(${grid_overfrequency}, 2036));
IF(GETBIT(a1,12) = 1, ADDERROR(${grid_underfrequency}, 2037));
IF(GETBIT(a1,13) = 1, ADDERROR(${grid_freq_instability}, 2038));
IF(GETBIT(a1,14) = 1, ADDERROR(${output_overcurr}, 2039));
IF(GETBIT(a1,15) = 1, ADDERROR(${out_DC_large}, 2040));
IF(GETBIT(a2,0) = 1, ADDERROR(${abnorm_leak_curr}, 2051));
IF(GETBIT(a2,1) = 1, ADDERROR(${abnorm_gnd}, 2061));
IF(GETBIT(a2,2) = 1, ADDERROR(${low_insul_res}, 2062));
IF(GETBIT(a2,3) = 1, ADDERROR(${high_tempt}, 2063));
IF(GETBIT(a2,4) = 1, ADDERROR(${abnorm_equip}, 2064));
IF(GETBIT(a2,5) = 1, ADDERROR(${upgrade_fail}, 2065));
IF(GETBIT(a2,6) = 1, ADDWARNING(${license_expired}, 2066));
IF(GETBIT(a2,7) = 1, ADDERROR(${abnorm_monitor_unit}, 61440));
IF(GETBIT(a2,8) = 1, ADDERROR(${power_collect_fault}, 2067));
IF(GETBIT(a2,9) = 1, ADDERROR(${abnorm_energy_storage_dev}, 2068));
IF(GETBIT(a2,10) = 1, ADDERROR("Active islanding", 2070));
IF(GETBIT(a2,11) = 1, ADDERROR("Passive islanding", 2071));
IF(GETBIT(a2,12) = 1, ADDERROR(${trans_AC_overvoltage}, 2072));
IF(GETBIT(a2,15) = 1, ADDERROR(${abnorm_PV_module_config}, 2080));

Wirkleistung Stromzähler

Stromzähler mit Wirkleistung, Blindleistung, Leistungsfaktor und Spitzenleistung des Tages

DC-Eingangsleistung Variable Nur lesen

Gesamte DC-Leistung aller PV-Strings kombiniert (kW) mit netzseitigen Messungen — Phasenspannungen, Ströme und Frequenz

Serviceattribute

Frequenz

Spannung Phase A

Spannung Phase B

Spannung Phase C

Strom Phase A

Strom Phase B

Strom Phase C

DC-Eingangsleistung

Lesen

MODBUSR(H, 32064, Int32, 2)/1000

Serviceattribute

Frequency

MODBUSR(H, 32085, Uint16)/100 + " Hz"

A Voltage

MODBUSR(H, 32069, Int16)/10 + " V"

B Voltage

MODBUSR(H, 32070, Int16)/10 + " V"

C Voltage

MODBUSR(H, 32071, Int16)/10 + " V"

A Current

MODBUSR(H, 32072, Int32, 2)/1000 + " A"

B Current

MODBUSR(H, 32074, Int32, 2)/1000 + " A"

C Current

MODBUSR(H, 32076, Int32, 2)/1000 + " A"

Batterie Dimmer Nur lesen

Batteriespeicherstatus und tägliche Lade-/Entladeenergiezähler

Serviceattribute

Betriebsstatus

Heutige Ladung

Heutige Entladung

Batterie

Level lesen

MODBUSR(H, 37760, Uint16)/1000

Serviceattribute

Running Status

SWITCH(MODBUSR(H, 37762, Uint16),
0, "Offline", 
1, "Standby",
2, "Running",
3, "Fault",
4, "Sleep mode",
"Error"
);

Current Day Charge

MODBUSR(H, 37784, Uint32)/100 + " kWh";

Current Day Discharge

MODBUSR(H, 37786, Uint32)/100 + " kWh";

Gesamtenergie Variable Nur lesen

Kumulierte Gesamtenergie seit Inbetriebnahme

Tagesenergie Variable Nur lesen

PV1 Strom Variable Nur lesen

Serviceattribute

PV1 Spannung

PV2 Strom Variable Nur lesen

Serviceattribute

PV2 Spannung

PV3 Strom Variable Nur lesen

Serviceattribute

PV3 Spannung

PV4 Strom Variable Nur lesen

Serviceattribute

PV4 Spannung

Wechselrichterstatus Mehrwertschalter Nur lesen

Betriebszustand des Wechselrichters — Leerlauf, Startvorgang, Am Netz, Abschaltung, Netzdispatch, IV-Scan, Stichprüfung, Inspektion, DC-Eingangserkennung

Werte / Zustände: ${inverter_state} · ${idle} · ${starting} · On Grid · Shutdown · Grid Dispatch · IV scanning · Spot-Check · ${inspecting} · ${dc_input_det }

Wechselrichterstatus

Schaltzustand lesen

var reg := MODBUSR(H, 32089, Uint16);
IF(reg = 0, 0,
IF(reg < 4 OR reg = 40960,1,
IF(reg = 256, 2, 
IF(reg < 515, 3, 
IF(reg < 775, 4,
IF(reg = 1025 OR reg = 1026, 5, 
IF(reg = 1280 OR reg = 1281, 7,
IF(reg = 1536, 8, 
IF(reg = 2048, 6,
IF(reg = 2304, 9
))))))))))

Serviceattribute

Full State

var state := MODBUSR(H, 32089, Uint16);
SWITCH(state, 0, "Idle: Initializing",
 1,"Idle: Detecting ISO", 
 2,"Idle: Detecting irradiation", 
 3, "Idle: Grid Detecting", 
 256, "Starting", 
 512, "On-Grid", 
 513, "On-Grid: Power Limit", 
 514, "On-Grid: self-derating", 
 768, "Shutdown: Fault", 
 769, "Shutdown: Command", 
 770, "Shutdown: OVGR", 
 771,"Shutdown: Communication disconnected", 
 772, "Shutdown: Power Limit", 
 773, "Shutdown: Start manually", 
 774, "Shutdown: DC Switch OFF",
 1025, "Grid dispatch:cos(Phi)-P curve",
 1026, "Grid dispatch:Q-U curve",
40960, "Idle: No irradiation",
1280, "Spot-check",
1281, "Spot-checking",
1536, "Inspecting",
1792, "SFCI self-check",
2048, "IV scanning",
2304, "DC input detection",
"Unknown"
 );

Grid Connection

var reg := MODBUSR(H, 32000,Uint16);
IF(GETBIT(reg,0) = 1, "Standby",
IF(GETBIT(reg,2) = 1 , "Normal Grid Connection",
IF(GETBIT(reg,3) = 1, "Grid connection with derating due to power rationing",
IF(GETBIT(reg,4) = 1, "Grid connection with derating due to inverter internal causes", "Not Connected"
)
)
)
)

Teleindication

var reg := MODBUSR(H, 32000,Uint16);
IF(GETBIT(reg,0) = 1, "Standby",
IF(GETBIT(reg,5) = 1 , "Normal Stop",
IF(GETBIT(reg,6) = 1, "Stop due to faults",
IF(GETBIT(reg,7) = 1, "Stop due to power rationing",
IF(GETBIT(reg,8) = 1, "Shutdown",
IF(GETBIT(reg,9) = 1, "Spot check",
IF(GETBIT(reg,1) = 1, "Grid Connected",
"Unknown State")
)
)
)
)
)
)

Locking Status

IF(GETBIT(MODBUSR(H, 32002, Uint16),0) = 1, "Unlocked", "Locked");

PV Connection Status

IF(GETBIT(MODBUSR(H, 32002, Uint16),0) = 1, "Connected", "Disconnected");

Startup time

var reg := MODBUSR(H, 32091, Uint32, 2);
var min := FLOOR(MOD(reg, 3600)/60);
var ho := FLOOR(MOD(reg,86400)/3600);
var minutes := IF(min<10, "0" + min, min);
var hours := IF(ho<10, "0" + ho, ho);
hours + ":" + minutes;

Shutdown time

var reg := MODBUSR(H, 32093, Uint32, 2);
var min := FLOOR(MOD(reg, 3600)/60);
var ho := FLOOR(MOD(reg,86400)/3600);
var minutes := IF(min<10, "0" + min, min);
var hours := IF(ho<10, "0" + ho, ho);
hours + ":" + FLOOR(minutes);

Verbindung: Modbus TCP • Slave ID: $[SlaveId]

Mögliche Verbesserungen (17)

H:30035 Firmware Version — STR, 15 regs, read-only — useful for diagnostics
H:32010 Alarm 3 — Bitfield16, additional alarm bits not decoded in template readscript
H:32066 Line Voltage A-B — U16, V, /10, grid line-to-line voltage
H:32067 Line Voltage B-C — U16, V, /10, grid line-to-line voltage
H:32068 Line Voltage C-A — U16, V, /10, grid line-to-line voltage
H:32090 Fault Code — U16, specific fault code when device is in fault state
H:32095 Active Power (fast) — I32, kW, /1000, faster-updating active power reading
H:32108 Total DC Input Energy — U32, kWh, /100, cumulative DC energy input
H:32116 Monthly Energy — U32, kWh, /100, electricity generated this month
H:32118 Yearly Energy — U32, kWh, /100, electricity generated this year
H:37760 Battery SOC — U16, %, /10, battery state of charge — notably absent from template despite Battery device existing
H:37765 Battery Charge/Discharge Power — I32, W, positive=charging negative=discharging
H:37113 Active Grid Power — I32, W, power meter active power (grid import/export)
H:37119 Grid Exported Energy — I32, kWh, /100, energy exported to grid
H:37123 Grid Accumulated Energy — U32, kWh, /100, total energy from grid
H:40200 Power On — WO, E16, remote inverter power-on command
H:40201 Shutdown — WO, E16, remote inverter shutdown command

Vorlage herunterladen

Quellen

Solar Inverter Modbus Interface Definitions (V3.0)
community.symcon.de 2026-03-13
PDF
huawei-solar-lib — Python Modbus Library
github.com 2026-03-13