
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-<serial>). 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. |
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
- Inserire lo Smart Dongle-WLAN-FE nella porta USB sul lato inferiore dell’inverter
- Connettere lo Smart Dongle alla rete WiFi locale utilizzando l’app FusionSolar (configurazione iniziale)
- Il dongle otterrà un indirizzo IP dal router tramite DHCP
- Annotare l’indirizzo IP dalla tabella DHCP del router
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
La libreria
huawei-solar-libdi 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 PW 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 |
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).
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).
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
- Verificare che lo Smart Dongle sia inserito nella porta USB dell’inverter e alimentato (LED attivo).
- Confermare l’indirizzo IP del dongle nella tabella DHCP del router.
- Assicurarsi che TapHome Core e lo Smart Dongle siano sulla stessa rete / sottorete.
- Controllare che nessun firewall stia bloccando la porta TCP 502.
- Se si utilizza la modalità WiFi AP, connettersi all’SSID dell’inverter (
SUN2000-<serial>) e usare l’IP192.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:
- Che la versione del firmware dell’inverter supporti la funzione di limitazione dell’esportazione.
- Che lo Smart Dongle sia connesso e non in modalità pass-through utilizzata dai servizi di codice di rete FusionSolar.
- 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.