TapHome

SolaX SK-SU Inverter ibrido

Modbus TCP
Inviato da
Ultimo aggiornamento: 03. 2026
SolaX SK-SU Inverter ibrido

La serie SolaX SK-SU (SK-SU3000E, SK-SU3700E, SK-SU5000E, SK-SU3000C, SK-SU5000C) è composta da inverter ibridi monofase della famiglia Gen2 X1 Hybrid. Combinano la conversione solare FV con la gestione dell’accumulo a batteria in un’unica unità. TapHome si collega direttamente all’inverter tramite Modbus TCP su Ethernet — non è necessario alcun gateway aggiuntivo o dongle WiFi.

Il template fornisce monitoraggio in tempo reale: potenza AC in uscita, produzione dei string FV, stato di carica e potenza della batteria, immissione/prelievo dalla rete, produzione energetica giornaliera e totale, e sensori di temperatura per inverter e batteria.

Abilitazione della comunicazione Modbus

La serie SK-SU dispone di un modulo Ethernet integrato con supporto nativo Modbus TCP. Non è necessario hardware aggiuntivo (Pocket WiFi dongle).

  1. Collegare un cavo Ethernet dalla porta Ethernet dell’inverter al router o switch della rete locale
  2. Controllare la tabella DHCP del router per trovare l’indirizzo IP assegnato all’inverter
  3. Verificare che TapHome Core sia sulla stessa rete/sottorete dell’inverter
  • Protocollo: Modbus TCP
  • Porta: 502
  • Slave ID predefinito: 1
  • Codice funzione: 0x04 (Read Input Registers)
  • Ordine dei byte: Little-endian per valori a 32 bit

Assegnare un indirizzo IP statico all’inverter nelle impostazioni DHCP del router per evitare che l’indirizzo cambi dopo un riavvio.

È supportata una sola connessione Modbus TCP attiva all’inverter alla volta. Chiudere tutti gli altri strumenti Modbus (QModMaster, monitoraggio SolaX Cloud tramite dongle) prima di collegare TapHome.

Configurazione

Durante l’importazione del template in TapHome, fornire:

  • Indirizzo IP — l’IP dell’inverter nella rete locale (predefinito: 192.168.1.0)
  • Slave ID — indirizzo Modbus slave (predefinito: 1)

Il ciclo di interrogazione minimo consigliato per l’inverter è circa 1 secondo. Il template utilizza intervalli da 2,5 a 150 secondi a seconda del dispositivo, entro questo limite.

Funzionalità dei dispositivi

Il template espone i seguenti dispositivi:

Produzione solare
  • PV String 1 Power — potenza in tempo reale dello string FV 1 in kW (registro 0x0A, UInt16, diviso per 1000)
  • PV String 2 Power — potenza in tempo reale dello string FV 2 in kW (registro 0x0B, UInt16, diviso per 1000)
  • AC Power — potenza totale AC in uscita dell’inverter in kW (registro 0x02, Int16, diviso per 1000)
Monitoraggio batteria
  • Battery SOC — stato di carica della batteria in percentuale (registro 0x1C, UInt16). Visualizzato come 0–100 % in TapHome tramite AnalogInput con conversione di livello (diviso per 100 per l’intervallo 0,0–1,0).
  • Battery Power — potenza di carica/scarica in kW (registro 0x16, Int16, diviso per 1000). Valori positivi indicano carica, valori negativi indicano scarica.
  • Battery Temperature — temperatura della batteria in °C (registro 0x55, UInt16, diviso per 10). Questo è un registro specifico del Gen2 SK-SU.
Misurazione di rete
  • Grid Feed-in / Consumption — potenza di rete in tempo reale in kW (registri 0x46–0x47, LittleEndianInt32, diviso per 1000). Valori positivi indicano esportazione di energia in rete, valori negativi indicano importazione dalla rete.
  • Daily / Instant Production — contatore elettrico che combina la produzione energetica giornaliera in kWh (registro 0x50, UInt16, diviso per 10) con la potenza AC istantanea in kW (registro 0x02).
Energia totale
  • Total Energy Production — energia totale cumulativa prodotta dall’inverter in kWh (registri 0x52–0x53, LittleEndianInt32, diviso per 1000).
Monitoraggio temperatura
  • Inverter Temperature — temperatura interna dell’inverter in °C (registro 0x08, Int16).
  • Battery Temperature — vedi sezione Monitoraggio batteria sopra.
Attributi di servizio

Il modulo espone un attributo di servizio:

  • Run Mode — modalità operativa attuale dell’inverter letta dal registro 0x09. Valori: 0=Wait, 1=Check, 2=Normal, 3=Fault, 4=Permanent Fault, 5=Update, 6=Off-grid waiting, 7=Off-grid, 8=Self Test, 9=Idle, 10=Standby.
Allarmi

Il template monitora tre registri di errore e attiva allarmi quando vengono rilevati guasti:

RegistroAllarme
0x40Guasto inverter
0x42Guasto di carica
0x43Guasto di gestione
Funzionalità aggiuntive non incluse nel template

Il SolaX SK-SU espone anche registri Modbus per tensione e corrente di rete, tensioni e correnti dei string FV, frequenza di rete, tensione e corrente della batteria, temperatura BMS della batteria, energia cumulativa importata/esportata dalla rete e l’impostazione Use Mode (Self Use, Feed-in Priority, Backup, Manual). Questi possono essere aggiunti al template TapHome in un futuro aggiornamento.

Risoluzione dei problemi

Nessuna comunicazione Modbus
  1. Verificare che il cavo Ethernet sia collegato alla porta Ethernet dell’inverter (non alla porta del dongle WiFi)
  2. Confermare l’indirizzo IP dell’inverter — controllare la tabella DHCP del router
  3. Assicurarsi che TapHome Core e l’inverter siano sulla stessa rete/sottorete
  4. Verificare che nessun firewall blocchi la porta 502
  5. Chiudere tutte le altre connessioni Modbus TCP all’inverter (è supportata una sola connessione)
I valori mostrano zero di notte / senza luce solare

Questo è normale. Quando la produzione FV è zero, l’inverter entra in modalità Wait o Idle (Run Mode 0 o 9). La potenza AC e la potenza dei string FV saranno zero. I valori di potenza della batteria e della rete continueranno ad aggiornarsi.

Battery SOC mostra valori inattesi

Il template legge il registro 0x1C (Battery Capacity) e divide per 100 per l’intervallo AnalogInput 0,0–1,0. Verificare che la batteria sia collegata e il BMS stia comunicando (il registro BMS_Connect_State 0x11 dovrebbe essere 1).

Dispositivi disponibili

SolaX SK-SU Inverter ibrido Modulo
Attributi di servizio
Modalità operativaModalità operativa attuale dell'inverter — Wait, Check, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Test, Idle, Standby

SOLAX Hybrid SK-SU 5000/3000

Lettura (modulo)
#alarms
IF(MODBUSR(A, 0x40, Uint16) = 1, ADDERROR("Porucha meniča"));
IF(MODBUSR(A, 0x42, Uint16) = 1, ADDERROR("Porucha nabíjania"));
IF(MODBUSR(A, 0x43, Uint16) = 1, ADDERROR("Porucha  riadenia meniča"));
Attributi di servizio
Solax Run Mode
MODBUSR(A, 0x09, Uint16);
Potenza AC Variabile Solo lettura

Potenza AC in uscita dell'inverter (lato rete)

Registro: A:0x02 Int16 Unità: kW numeric

Potenza AC

Lettura
MODBUSR(A,0x02, Int16)/ 1000
SOC batteria Ingresso analogico Solo lettura

Stato di carica della batteria in percentuale (0–100 %)

Registro: A:0x1C UInt16 Unità: % numeric

SOC batteria

Lettura livello ingresso
MODBUSR(A, 0x1C, UInt16)/100
Potenza batteria Variabile Solo lettura

Potenza di carica/scarica della batteria — positivo=carica, negativo=scarica

Registro: A:0x16 Int16 Unità: kW numeric

Potenza batteria

Lettura
MODBUSR(A, 0x16, Int16)/1000
Produzione energetica totale Variabile Solo lettura

Energia totale cumulativa prodotta dall'inverter

Registro: A:0x52 LittleEndianInt32 Unità: kWh numeric

Produzione energetica totale

Lettura
MODBUSR(A, 0x52,LittleEndianInt32) / 1000
Produzione giornaliera / istantanea Contatore elettrico Solo lettura

Contatore elettrico — produzione energetica giornaliera e potenza AC istantanea

Registro: A:0x50 (total), A:0x02 (demand) UInt16 / Int16 Unità: kWh / kW numeric

Produzione giornaliera / istantanea

Lettura consumo totale
MODBUSR(A, 0x50, UInt16) /10
Lettura domanda
MODBUSR(A,0x02, Int16)/1000
Immissione / prelievo dalla rete Variabile Solo lettura

Potenza di rete — positivo=esportazione in rete, negativo=importazione dalla rete

Registro: A:0x46 LittleEndianInt32 Unità: kW numeric

Immissione / prelievo dalla rete

Lettura
MODBUSR(A, 0x46,LittleEndianInt32)/1000
Potenza string FV 1 Variabile Solo lettura

Potenza in tempo reale dello string solare 1

Registro: A:0x0A UInt16 Unità: kW numeric

Potenza string FV 1

Lettura
MODBUSR(A,0x0a, UInt16)/1000
Potenza string FV 2 Variabile Solo lettura

Potenza in tempo reale dello string solare 2

Registro: A:0x0B UInt16 Unità: kW numeric

Potenza string FV 2

Lettura
MODBUSR(A,0x0b, UInt16)/1000
Temperatura batteria Sensore di temperatura Solo lettura

Sensore di temperatura della batteria

Registro: A:0x55 UInt16 Unità: °C numeric

Temperatura batteria

Lettura temperatura
MODBUSR(A, 0x55, UInt16) /10
Temperatura inverter Sensore di temperatura Solo lettura

Temperatura interna dell'inverter

Registro: A:0x08 Int16 Unità: °C numeric

Temperatura inverter

Lettura temperatura
MODBUSR(A, 0x08, Int16)
Connessione: Modbus TCP • Slave ID: $[SlaveId]
Possibili miglioramenti (15)
  • A:0x00 Grid Voltage — UInt16, 0.1V, read-only — grid voltage measurement
  • A:0x01 Grid Current — Int16, 0.1A, read-only — grid current measurement
  • A:0x03 PV1 Voltage — UInt16, 0.1V — PV string 1 voltage
  • A:0x04 PV2 Voltage — UInt16, 0.1V — PV string 2 voltage
  • A:0x05 PV1 Current — UInt16, 0.1A — PV string 1 current
  • A:0x06 PV2 Current — UInt16, 0.1A — PV string 2 current
  • A:0x07 Grid Frequency — UInt16, 0.01Hz — grid frequency
  • A:0x0E Battery Voltage — UInt16, 0.1V — battery voltage
  • A:0x0F Battery Current — Int16, 0.1A — battery current (positive=charge, negative=discharge)
  • A:0x10 Battery Power — Int16, 1W — battery power
  • A:0x12 Battery Temperature (BMS) — Int16, 1°C — BMS-reported battery temperature
  • A:0x48 Total Energy to Grid — UInt32, 0.01kWh — cumulative energy exported to grid (from meter)
  • A:0x4A Total Energy from Grid — UInt32, 0.01kWh — cumulative energy imported from grid (from meter)
  • H:0x7B Use Mode — UInt16, R/W — 0=Self Use, 1=Feed-in Priority, 2=Backup, 3=Manual. Writable holding register for mode selection
  • A:0x40 Inverter Fault Code — UInt32 (2 registers), bitmask — inverter error codes. Template uses this for ADDERROR alarms but not as a readable device

Fonti

  • SolaX Hybrid X1/X3 — Modbus TCP & RTU Communication Protocol V3.21
    PDF
  • Home Assistant SolaX Modbus Integration — Gen2 Register Map
    github.com 2026-03-29
  • SolaX KB: How to Get Device Data by Modbus TCP