--- title: "Huawei SUN2000" description: "Modbus TCP per Huawei SUN2000 3-10KTL — potenza attiva, stringhe PV, tensioni di rete, SOC batteria, stato inverter, limite di esportazione." url: "https://taphome.com/it/compatibility/sun2000-tcp/" language: it lastmod: 2026-10-08 generator: hugo ai: topics: ["modbus-tcp","inverter","solar","pv-monitoring","battery-storage","export-power-control"] questions: ["Come integrare l'inverter solare Huawei SUN2000 con TapHome?","Cosa misura e controlla il template Huawei SUN2000 in TapHome?","Come collegare Huawei SUN2000 tramite Modbus TCP usando lo Smart Dongle?","Come limitare la potenza di esportazione su Huawei SUN2000 da TapHome?","Come leggere lo stato di carica della batteria LUNA2000 tramite TapHome?","Perché l'inverter SUN2000 rimane bloccato in stato Idle?"] --- # Huawei SUN2000 Comunicazione: Modbus TCP - [Huawei FusionSolar](https://solar.huawei.com/en/products/residential/inverters) La serie Huawei SUN2000 3-10KTL comprende inverter di stringa monofase e trifase per impianti PV residenziali, con potenze nominali da 3 kW a 10 kW. TapHome si collega all'inverter tramite Modbus TCP — o attraverso un Huawei Smart Dongle (WLAN-FE o 4G) inserito nella porta USB dell'inverter, oppure direttamente al punto di accesso WiFi integrato dell'inverter. Il template fornisce il monitoraggio della potenza attiva di rete, contatori di energia giornaliera e di vita, letture di corrente delle stringhe PV per un massimo di 4 stringhe, sensori di tensione di fase individuali, frequenza di rete, produzione DC aggregata, stato di carica della batteria (per LUNA2000), stato operativo dell'inverter con decodifica dettagliata dei sottostati e limitazione scrivibile dell'esportazione in rete. Le azioni di servizio a livello di modulo consentono la compensazione della potenza reattiva (PF e Q/S) e la limitazione della potenza attiva. ## Abilitazione comunicazione Modbus L'inverter SUN2000 supporta Modbus TCP sia attraverso il punto di accesso WiFi integrato sia tramite lo Smart Dongle. Per una connessione permanente con TapHome, l'approccio consigliato è utilizzare uno **Huawei Smart Dongle-WLAN-FE** (o Smart Dongle-4G) inserito nella porta USB dell'inverter. ### Opzioni di connessione | Metodo | Interfaccia | Note | |--------|-------------|------| | **Smart Dongle (consigliato)** | Ethernet / WiFi | Collega l'inverter alla LAN locale. Consente l'accesso simultaneo Modbus TCP e all'app FusionSolar. | | **Punto di accesso WiFi** | WiFi | Connessione diretta all'AP dell'inverter (SSID: `SUN2000-`). Un solo client alla volta. | | **RS-485 (Modbus RTU)** | Pin COM port RS485A1/B1 | Non utilizzato da questo template. Non può funzionare contemporaneamente al monitoraggio FusionSolar. | > [!WARNING] > Quando si utilizza il metodo punto di accesso WiFi, l'app FusionSolar non può connettersi contemporaneamente. Per installazioni in produzione, utilizzare sempre lo Smart Dongle in modo che TapHome e FusionSolar possano funzionare in parallelo. ### Configurazione Smart Dongle 1. Inserire lo Smart Dongle-WLAN-FE nella porta USB sul lato inferiore dell'inverter 2. Connettere lo Smart Dongle alla rete WiFi locale utilizzando l'app FusionSolar (configurazione iniziale) 3. Il dongle otterrà un indirizzo IP dal router tramite DHCP 4. Annotare l'indirizzo IP dalla tabella DHCP del router > [!TIP] > Assegnare allo Smart Dongle un indirizzo IP statico (o una prenotazione DHCP) nelle impostazioni del router per evitare che l'indirizzo cambi dopo un ciclo di alimentazione. ## Connessione di rete - **Protocollo:** Modbus TCP - **Porta:** 502 (porta Modbus TCP standard) - **Slave ID predefinito:** 1 - **Ordine dei byte:** Big-endian (Modbus standard) - **Intervallo di registri utilizzato:** H:30000 — H:47418 > [!NOTE] > La libreria `huawei-solar-lib` di Home Assistant utilizza la porta 503 per impostazione predefinita in modalità WiFi AP. Quando ci si connette tramite Smart Dongle su una rete locale, TapHome utilizza la porta Modbus TCP standard **502**. ## Configurazione Durante l'importazione del template in TapHome, fornire: - **Indirizzo IP** — l'IP dello Smart Dongle nella rete locale (o l'IP dell'AP WiFi dell'inverter, predefinito: 192.168.200.1) - **Slave ID** — indirizzo slave Modbus (predefinito: 1) ## Capacità del dispositivo Il template espone 16 dispositivi raggruppati per funzione di seguito. ### Monitoraggio potenza ed energia - **Potenza attiva** — contatore elettrico Modbus che legge il rendimento giornaliero cumulativo da H:32114 (kWh) e la potenza attiva di rete istantanea da H:37113 (kW). Include 11 attributi di servizio (potenza attiva di picco del giorno, potenza reattiva, potenza attiva nominale/massima, potenza apparente massima, potenza reattiva massima immessa/assorbita, compensazione potenza reattiva PF e Q/S, limitazione potenza attiva in % e valore fisso) e 3 azioni di servizio (compensazione potenza reattiva PF, compensazione potenza reattiva Q/S, limitazione potenza attiva %). - **Energia totale** — energia cumulativa di vita prodotta dall'inverter dalla messa in servizio, in kWh (H:32106). - **Energia oggi** — energia generata dalla mezzanotte, si azzera giornalmente, in kWh (H:32114). - **Produzione DC** — potenza DC aggregata in ingresso da tutte le stringhe PV in kW (H:32064). Gli attributi di servizio espongono la frequenza di rete (H:32085), le tensioni di fase A/B/C (H:32069–32071) e le correnti di fase A/B/C (H:32072–32076). ### Monitoraggio stringhe PV Quattro dispositivi sensore, uno per stringa PV, riportano la corrente DC in ampere. Ciascun dispositivo include un attributo di servizio per la tensione DC della stringa corrispondente: | Dispositivo | Registro corrente | Attributo tensione | |-------------|-------------------|---------------------| | **PV1 corrente** | H:32017 | H:32016 | | **PV2 corrente** | H:32019 | H:32018 | | **PV3 corrente** | H:32021 | H:32020 | | **PV4 corrente** | H:32023 | H:32022 | > [!NOTE] > Il numero di dispositivi stringa PV attivi dipende dal modello di inverter e dall'installazione. Gli ingressi stringa inutilizzati leggono 0 A — ad esempio, un modello 3KTL utilizza tipicamente solo PV1 e PV2. ### Parametri di rete - **Tensione fase A** — tensione fase-neutro sulla linea A in V (H:32069). - **Tensione fase B** — tensione fase-neutro sulla linea B in V (H:32070). - **Tensione fase C** — tensione fase-neutro sulla linea C in V (H:32071). - **Frequenza di rete** — frequenza della rete AC in uscita dall'inverter in Hz (H:32085). ### Batteria (LUNA2000) - **SOC batteria** — stato di carica della batteria come frazione della capacità disponibile, letto da H:37760. Quando l'inverter riporta un valore superiore a 1 (nessuna batteria presente), il dispositivo aggiunge un messaggio informativo *„Batéria nepripojená"* (Batteria non collegata). > [!WARNING] > Il documento Huawei Modbus Interface Definitions V3.0 specifica gain 10 per il registro H:37760 (percentuale con un decimale). Il template TapHome utilizza gain 1000, che legge il valore come frazione (0,0–1,0). Entrambe le rappresentazioni espongono gli stessi dati sottostanti — interpretare il valore visualizzato di conseguenza. ### Controllo esportazione potenza - **Massima immissione in rete** — limite di esportazione **scrivibile** espresso come percentuale della potenza nominale (H:47418, Int16, gain 10). Impostare questo dispositivo per limitare quanta energia l'inverter immette in rete. - **Massima potenza immissione in rete** — sensore (sola lettura) che riporta il limite di esportazione attualmente effettivo come watt assoluti in kW (H:47416, Int32, gain 1000). > [!WARNING] > I registri H:47416 e H:47418 **non sono documentati** nelle Huawei Solar Inverter Modbus Interface Definitions V3.0 ufficiali (2023-01-16). Sono estensioni del produttore su firmware più recenti e confermati solo tramite test sul campo. Il comportamento può variare in base alla versione del firmware dell'inverter — verificare la risposta dopo la scrittura su H:47418 prima di affidarsi al limite nelle automazioni. ### Stato operativo dell'inverter Un selettore multivalore (letto da H:32089) che mappa gli oltre 20 codici di stato grezzi di Huawei in 10 stati di alto livello: | Valore | Stato | Codici grezzi sottostanti | |--------|-------|---------------------------| | 0 | Standby | 0 | | 1 | Inattivo / Nessuna irradiazione | 1, 2, 3, 40960 | | 2 | Avvio | 256 | | 3 | In rete | 512, 513, 514 | | 4 | Spegnimento | 768–774 | | 5 | Dispacciamento rete | 1025, 1026 | | 6 | IV Scanning | 2048 | | 7 | Controllo a campione | 1280, 1281 | | 8 | Ispezione | 1536 | | 9 | Rilevamento ingresso DC | 2304 | Gli attributi di servizio forniscono una visione più approfondita dello stato: - **Stato completo** — stato completo dell'inverter decodificato da H:32089 con tutti gli oltre 20 sottostati grezzi (Idle: Initializing, Idle: Detecting ISO, On-Grid: Power Limit, Shutdown: Fault, Shutdown: OVGR, Grid dispatch: curva cos(Phi)-P, ecc.). - **Connessione alla rete** — derivata dai bit di H:32000: Standby, Connessione normale alla rete, Connessione con derating per razionamento di potenza, Connessione con derating per cause interne dell'inverter, o Non connesso. - **Teleindicazione** — stato di telesegnalazione IEC 60870-5-104 dai bit di H:32000: Standby, Arresto normale, Arresto per guasti, Arresto per razionamento di potenza, Spegnimento, Controllo a campione, Connesso alla rete. - **Stato di blocco** — Bloccato o Sbloccato, derivato dal bit 0 di H:32002. - **Stato connessione PV** — Connesso o Disconnesso, derivato dal bit 0 di H:32002. - **Orario di avvio** — orario di avvio più recente del giorno (HH:MM) da H:32091. - **Orario di spegnimento** — orario di spegnimento più recente del giorno (HH:MM) da H:32093. ### Diagnostica a livello di modulo Il modulo espone attributi di servizio per l'identificazione del dispositivo e la diagnostica: | Attributo | Registro | Descrizione | |-----------|----------|-------------| | Nome modello | H:30000 | Identificativo modello sulla targhetta dell'inverter | | SN | H:30015 | Numero di serie | | PN | H:30025 | Codice articolo | | Model ID | H:30070 | Identificativo numerico del modello | | Numero di stringhe | H:30071 | Stringhe PV supportate dall'hardware | | Numero MPPT | H:30072 | Numero di tracker MPPT indipendenti | | Ora di sistema | H:40000 | Orologio interno dell'inverter | | Fuso orario | H:43006 | Offset UTC configurato | | Efficienza inverter | H:32086 | Efficienza di conversione AC/DC corrente (%) | | Temperatura cabinet | H:32087 | Temperatura interna del cabinet (°C) | | Resistenza di isolamento | H:32088 | Resistenza di isolamento lato DC (MΩ) | | Raccolta dati DSP | H:32002 | Se il DSP dell'inverter sta raccogliendo telemetria | Un'azione di servizio **Fuso orario** consente di impostare l'offset UTC dell'inverter (scrittura su H:43006). I valori supportati vanno da UTC-12:00 a UTC+14:00. ### Monitoraggio allarmi Lo script di lettura a livello di modulo interroga i registri di allarme H:32008 (Alarm 1) e H:32009 (Alarm 2) e decodifica ciascun bit come un errore o avviso denominato. Allarmi degni di nota: | Registro | Bit | Allarme | |----------|-----|---------| | H:32008 | 0 | Alta tensione stringa | | H:32008 | 1 | Guasto ad arco DC | | H:32008 | 2 | Stringa invertita | | H:32008 | 3 | Stringa anomala (avviso) | | H:32008 | 5 | Guasto AFCI | | H:32008 | 7 | Guasto rete elettrica | | H:32008 | 8–9 | Sotto/Sovratensione di rete | | H:32008 | 11–13 | Guasti di frequenza di rete | | H:32008 | 14–15 | Sovracorrente uscita / Componente DC | | H:32009 | 0 | Corrente di dispersione anomala | | H:32009 | 1–2 | Terra anomala / Isolamento basso | | H:32009 | 3–4 | Alta temperatura / Guasto apparecchiatura | | H:32009 | 9 | Dispositivo di accumulo energia anomalo | | H:32009 | 10–11 | Isolamento attivo/passivo (islanding) | | H:32009 | 15 | Configurazione modulo PV anomala | ## Risoluzione dei problemi ### Nessuna comunicazione Modbus 1. Verificare che lo Smart Dongle sia inserito nella porta USB dell'inverter e alimentato (LED attivo). 2. Confermare l'indirizzo IP del dongle nella tabella DHCP del router. 3. Assicurarsi che TapHome Core e lo Smart Dongle siano sulla stessa rete / sottorete. 4. Controllare che nessun firewall stia bloccando la porta TCP 502. 5. Se si utilizza la modalità WiFi AP, connettersi all'SSID dell'inverter (`SUN2000-`) e usare l'IP `192.168.200.1`. ### I valori delle stringhe PV leggono zero Gli ingressi stringa PV inutilizzati leggono sempre 0 A e 0 V. È normale per i modelli di inverter con meno ingressi MPPT di quelli forniti dal template (ad es. un modello 3KTL utilizza tipicamente solo PV1 e PV2). ### Il SOC batteria mostra „Batéria nepripojená" o valori superiori al 100 % I registri della batteria LUNA2000 vengono popolati solo quando una batteria compatibile è fisicamente collegata. Senza batteria, il registro H:37760 restituisce valori al di fuori dell'intervallo previsto e il template genera il messaggio informativo *„Batéria nepripojená"* (Batteria non collegata). ### Inverter bloccato in Idle Durante le ore notturne o in condizioni di scarsa irradiazione, l'inverter rimane nello stato **Idle** (sottostati „Detecting ISO", „Detecting irradiation", „Grid Detecting" o „No irradiation"). L'inverter passa automaticamente a **On-Grid** una volta rilevata sufficiente irradiazione solare. ### La scrittura su Massima immissione in rete non ha effetto I registri H:47416 e H:47418 sono estensioni del produttore e non sono presenti nella documentazione Modbus V3.0 ufficiale. Se il limite di esportazione non ha effetto, verificare: 1. Che la versione del firmware dell'inverter supporti la funzione di limitazione dell'esportazione. 2. Che lo Smart Dongle sia connesso e non in modalità pass-through utilizzata dai servizi di codice di rete FusionSolar. 3. Che nessun codice di rete o segnale DRM in conflitto stia sovrascrivendo il limite locale. ### Il sottostato Shutdown mostra OVGR / DC Switch OFF Questi sottostati di spegnimento (decodificati da H:32089) indicano che l'inverter è stato arrestato da un segnale di protezione — OVGR tramite il contatto OVGR esterno, o DC Switch OFF tramite il sezionatore DC fisico sull'inverter. Risolvere la condizione fisica sottostante prima di tentare un'accensione remota. ## Dispositivi disponibili SUN2000 TCP Modulo Potenza attiva Contatore elettrico Contatore elettrico — rendimento giornaliero (kWh) e potenza attiva di rete istantanea (kW), con potenza reattiva, fattore di potenza, picco del giorno e azioni di derating scrivibili Registro: H:32114 UInt32 / Int32 Unità: kWh / kW numeric SOC batteria Ingresso analogico Solo lettura Stato di carica della batteria — frazione della capacità disponibile; valori superiori al 100 % attivano il messaggio informativo „Batteria non collegata“ Registro: H:37760 UInt16 numeric Energia totale Variabile Solo lettura Energia cumulativa di vita prodotta dall'inverter dalla messa in servizio (kWh) Registro: H:32106 UInt32 Unità: kWh numeric Energia oggi Variabile Solo lettura Energia generata dalla mezzanotte; si azzera giornalmente (kWh) Registro: H:32114 Int32 Unità: kWh numeric Frequenza di rete Variabile Solo lettura Frequenza della rete AC in uscita dall'inverter (Hz) Registro: H:32085 UInt16 Unità: Hz numeric Massima immissione in rete Dimmer Limite di esportazione scrivibile come percentuale della potenza nominale — limita quanta energia viene immessa in rete Registro: H:47418 Int16 Unità: % numeric Massima potenza immissione in rete Variabile Solo lettura Limite di esportazione attualmente effettivo espresso come potenza assoluta (kW) Registro: H:47416 Int32 Unità: kW numeric Tensione fase A Variabile Solo lettura Tensione fase-neutro sulla linea A (V) Registro: H:32069 UInt16 Unità: V numeric Tensione fase B Variabile Solo lettura Tensione fase-neutro sulla linea B (V) Registro: H:32070 UInt16 Unità: V numeric Tensione fase C Variabile Solo lettura Tensione fase-neutro sulla linea C (V) Registro: H:32071 UInt16 Unità: V numeric PV1 corrente Variabile Solo lettura Registro: H:32017 Int16 Unità: A numeric Attributi di servizio | | |--------------| | PV1 tensione | PV2 corrente Variabile Solo lettura Registro: H:32019 Int16 Unità: A numeric Attributi di servizio | | |--------------| | PV2 tensione | PV3 corrente Variabile Solo lettura Registro: H:32021 Int16 Unità: A numeric Attributi di servizio | | |--------------| | PV3 tensione | PV4 corrente Variabile Solo lettura Registro: H:32023 Int16 Unità: A numeric Attributi di servizio | | |--------------| | PV4 tensione | Stato inverter Interruttore multivalore Stato operativo dell'inverter mappato a 10 codici di alto livello — Standby, Inattivo/Nessuna irradiazione, Avvio, In rete, Spegnimento, Dispacciamento rete, IV Scanning, Controllo a campione, Ispezione, Rilevamento ingresso DC Registro: H:32089 UInt16 numeric Valori / Stati: ON · OFF Produzione DC Variabile Solo lettura Potenza DC aggregata in ingresso da tutte le stringhe PV (kW), con attributi di servizio lato rete — frequenza, tensioni e correnti di fase A/B/C Registro: H:32064 Int32 Unità: kW numeric Attributi di servizio | | |-----------------| | Frequenza | | Tensione fase A | | Tensione fase B | | Tensione fase C | | Corrente fase A | | Corrente fase B | | Corrente fase C | **Connessione:** Modbus TCP • Slave ID: $\[SlaveId] Possibili miglioramenti (24) - H:30035 Firmware Version — STR, 15 regs — useful for diagnostics and version-specific feature gating - H:30050 Software Version — STR, 15 regs — main controller software build - H:31000 Hardware Version — STR, 15 regs — hardware revision identifier - H:32010 Alarm 3 — Bitfield16, additional alarm bits beyond Alarm 1/2 handled by readscript - H:32066 Line Voltage A-B — U16, V, /10 — line-to-line grid voltage - H:32067 Line Voltage B-C — U16, V, /10 — line-to-line grid voltage - H:32068 Line Voltage C-A — U16, V, /10 — line-to-line grid voltage - H:32080 Active Power (instantaneous) — I32, kW, /1000 — instantaneous active power; template now uses H:37113 grid-side power instead - H:32084 Power Factor — I16, /1000 — referenced in legacy Active Power service attributes but not exposed as standalone sensor - H:32090 Fault Code — U16 — specific fault code when device is in shutdown:fault state - H:32108 Total DC Input Energy — U32, kWh, /100 — cumulative DC energy input across all PV strings - H:32116 Monthly Energy — U32, kWh, /100 — energy generated this month - H:32118 Yearly Energy — U32, kWh, /100 — energy generated this year - H:37101 Grid Phase A Voltage (power meter) — I32, V, /10 — phase voltage measured by external power meter (different sensor than H:32069) - H:37107 Grid Phase A Current (power meter) — I32, A, /100 — phase current measured by external power meter - H:37119 Grid Exported Energy (active) — I32, kWh, /100 — energy exported to the grid - H:37121 Grid Exported Energy — U32, kWh, /100 — cumulative grid export counter - H:37123 Grid Accumulated Energy — U32, kWh, /100 — total energy from grid (import) - H:37762 Battery Running Status — U16 enum — 0=Offline, 1=Standby, 2=Running, 3=Fault, 4=Sleep - H:37765 Battery Charge/Discharge Power — I32, W — positive=charging, negative=discharging - H:37784 Battery Daily Charge — U32, kWh, /100 — today's battery charge energy - H:37786 Battery Daily Discharge — U32, kWh, /100 — today's battery discharge energy - H:40200 Power On — WO, E16 — remote inverter power-on command - H:40201 Shutdown — WO, E16 — remote inverter shutdown command ## Fonti - Solar Inverter Modbus Interface Definitions (V3.0) 2026-03-13 [PDF](https://taphome.com/compatibility/devices/sun2000-tcp/manufacturer/modbus-interface-definitions-v3.pdf) - huawei-solar-lib — Python Modbus Library [github.com](https://github.com/wlcrs/huawei-solar-lib) 2026-03-13 ## Documentazione correlata - [Modbus Integration](https://taphome.com/it/compatibility/modbus-guide/) - [Modbus - Configurazione](https://taphome.com/it/docs/integration/modbus/) - [Configurazione semplice utilizzando modelli](https://taphome.com/it/docs/integration/modbus/templates/) - [Script Modbus e prefetch](https://taphome.com/it/docs/script/modbus-scripts/) - [Funzioni Modbus](https://taphome.com/it/docs/script/modbus/) - [Tipi di dati Modbus](https://taphome.com/it/docs/script/modbus-data-types/)