SolaX X3 Hybrid Ultra

Modbus RTU

Pridal

Posledná aktualizácia: 10. 2026

SolaX X3 Hybrid Ultra (Gen5) je trojfázový hybridný PV/batériový striedač s menovitým výkonom od 10 kW do 30 kW. Šablóna TapHome komunikuje so striedačom cez Modbus RTU na RS-485 porte COM 1 (piny REMOTE_485A / REMOTE_485B) a implementuje register map protokolu SolaX Modbus V3.29. Číta výkon PV reťazcov, stav nabitia a teplotu batérie, trojfázové napätie a frekvenciu siete, kumulatívne a denné energetické súčty, výkon dodávky z externého merača a vystavuje zapisovateľný režim nabíjačky, SOC nočného nabíjania (vlastná spotreba) a limit max. výkonu dodávky.

X3-Ultra nepodporuje Modbus TCP natívne — TCP je dostupné len cez monitorovací modul SolaX (Pocket WiFi 3.0, Pocket LAN alebo DataHub), ktorý premosťuje RTU na TCP na porte 502. Pre vzdialené inštalácie možno TapHome pripojiť aj cez bránu RS-485-Ethernet tretej strany (napr. Waveshare, USR-DR302) nakonfigurovanú ako Modbus RTU-over-TCP.

Modely

Šablóna TapHome pokrýva celú sériu X3-Ultra. Senzory PV3 a SOC batérie 2 sú funkčné len na variante s 3 MPPT / dvomi batériami s výkonom 30 kW.

Model	Menovitý AC výkon	MPPT trackery	Poznámky
X3-ULT-15K	15 kW	2	Štandardný 2-MPPT
X3-ULT-15KP	15 kW	3	3-MPPT (kód modelu H3BC)
X3-ULT-19.9K	19,9 kW	2	Štandardný 2-MPPT
X3-ULT-20K	20 kW	2	Štandardný 2-MPPT (kód modelu H3BD)
X3-ULT-20KP	20 kW	3	3-MPPT
X3-ULT-25K	25 kW	3	Kód modelu H3BF
X3-ULT-25KW	25 kW	3	—
X3-ULT-30K	30 kW	3	Dve batérie, PV3 aktívne (kód modelu H3BG)
X3-ULT-10K-GLV	10 kW	—	Nízkonapäťový variant (GLV)
X3-ULT-15K-GLV	15 kW	—	Nízkonapäťový variant (GLV)

Kód modelu je možné čítať za behu cez modulový atribút Model (register H:0x000E, 4-znakový ASCII reťazec).

Rozsah kompatibility

Šablóna implementuje podmnožinu protokolu SolaX Modbus V3.29, ktorá sa najčastejšie používa pre domáce energetické riadenie — 19 zariadení, 2 modulové servisné atribúty a jedna servisná akcia. Plný protokol vystavuje oveľa viac registrov; najužitočnejšie nezavedené funkcie (výkon a prúd siete na jednotlivé fázy, napätie/prúd/výkon batérie, stav BMS, doba prevádzky mimo siete, vzdialené ovládanie výkonu atď.) môžu byť pridané v budúcej aktualizácii šablóny. Opravená komunitná šablóna v portáli TapHome už pridáva vzdialené ovládanie výkonu a zápisy nastavení, ktoré prebehnú len pri zmene hodnoty — pozrite Známe chyby oficiálnej šablóny a Vzdialené ovládanie výkonu nižšie.

Hardvérové pripojenie

X3-Ultra má jediný viacúčelový port COM 1 (konektor typu RJ45 s označeným káblovým prípravkom). Tie isté fyzické piny slúžia na rôzne funkcie podľa toho, do ktorej označenej pozície na káblovom prípravku zapojíte vodič. Pre integráciu Modbus tretej strany použite pozíciu RS485 — vodiče REMOTE_485A a REMOTE_485B.

Pinout portu COM 1

Priradenie pinov portu COM 1 SolaX X3-Ultra pre všetkých šesť označených pozícií (Parallel-1, Parallel-2, BMS-1, BMS-2, RS485, DRM)

Priradenie pinov pre pozíciu RS485 (jediná pozícia relevantná pre TapHome):

Pin	Signál	Zapojenie TapHome
1	REMOTE_485A	A+ / D+
2	REMOTE_485B	B− / D−
3	PARALLEL_485AA	nepoužívať (len pre príslušenstvo SolaX)
4	PARALLEL_485AA	nepoužívať (len pre príslušenstvo SolaX)
5	PARALLEL_485BB	nepoužívať (len pre príslušenstvo SolaX)
6	PARALLEL_485BB	nepoužívať (len pre príslušenstvo SolaX)
7	REMOTE_485A	duplikát pinu 1 (pre daisy-chain)
8	REMOTE_485B	duplikát pinu 2 (pre daisy-chain)

Piny 3–6 patria proprietárnemu kanálu SolaX PARALLEL_485 a sú vyhradené pre príslušenstvo SolaX (Adapter Box G2, EV-Charger, DataHub, paralelné striedače). Nepripájajte k týmto pinom Modbus master tretej strany.

Staršie striedače SolaX (Gen4 X3-Hybrid) používali pin 4 = 485A a pin 5 = 485B. Pinout portu COM 1 X3-Ultra je odlišný — pred zalisovaním vždy skontrolujte označenie káblového prípravku na vašej jednotke. Niektorá komunitná dokumentácia stále odkazuje na starší pinout Gen4.

Zapojenie RS-485

Inštalácia RJ45 terminálu do pozície RS485 káblového prípravku COM 1

Pravidlá zapojenia z používateľského manuálu X3-Ultra (sekcia 8.6.4):

Typ kábla: štandardný krútený pár Cat5 alebo Cat6 UTP
Maximálna dĺžka: 30 m RS-485 kábla medzi striedačom a TapHome CCU
Polarita je dôležitá: ak komunikácia neprebieha, vymeňte A a B
Jeden Modbus master: na zbernici je povolený len jeden master. Ak monitorovací modul SolaX zdieľa linku, očakávajte konflikty

Káblový prípravok COM 1 má vyhradené označené pozície pre každý kanál — kábel Cat5/Cat6 zapojte do otvoru označeného RS485 (nie do Parallel-1, Parallel-2, BMS-1, BMS-2 alebo DRM).

Možnosti pripojenia

Priame Modbus RTU CCU: zapojte dvojicu RS485 portu COM 1 priamo do TapHome Modbus RTU CCU. Najnižšia latencia, odporúčané pre riadenie v reálnom čase.
Brána RS-485-Ethernet (Modbus RTU-over-TCP): pre inštalácie, kde je striedač ďaleko od TapHome Core, použite bránu Waveshare RS485-Ethernet, USR-DR302 alebo podobnú nakonfigurovanú ako Modbus RTU-over-TCP na porte 502. Import parameter šablóny IpAddress to umožňuje.
SolaX Pocket WiFi 3.0 / Pocket LAN / DataHub (Modbus TCP): ak je monitorovací modul SolaX už nainštalovaný, premosťuje RTU na TCP na porte 502 s dotazovacím cyklom približne 1 sekunda — pomalšie ako priame RTU a neodporúča sa pre riadiace slučky v reálnom čase.

Konfigurácia

Povolenie komunikácie Modbus na striedači

Na LCD striedača prejdite na:

1
Menu → Setting → Advance Setting → Modbus

Menu Advanced Settings môže vyžadovať inštalačné heslo. Overte alebo nastavte nasledovné:

Parameter	Predvolené hodnoty šablóny TapHome	Predvolené hodnoty striedača	Rozsah
Modbus adresa (Slave ID)	1	1	1–255
Prenosová rýchlosť	19200	19200	9600 / 19200 / 38400 / 57600 / 115200
Parita	None	None	None / Odd / Even
Dátové bity	8	8	—
Stop bity	1	1	1 alebo 2

Prenosová rýchlosť sa musí zhodovať medzi striedačom a TapHome. Protokol V3.29 špecifikuje 19200 ako predvolenú hodnotu X3-Ultra; niektoré staršie šablóny a dokumentácia SolaX stále uvádzajú 9600. Ak komunikácia zlyhá, najprv skontrolujte prenosovú rýchlosť.

Striedač môže tiež vystaviť adresu Modbus slave cez holding register H:0x00AC a prenosovú rýchlosť cez holding register H:0x00AD.

Import parametre v TapHome

Pri importe šablóny do TapHome musia byť nastavené dva parametre:

Parameter	Účel
IpAddress	IP adresa brány RS-485-TCP (alebo monitorovacieho modulu SolaX Pocket WiFi / LAN). Ponechajte predvolenú hodnotu, ak je striedač pripojený priamo k TapHome Modbus RTU CCU.
SlaveId	Modbus slave adresa striedača (predvolene `1`). Musí sa zhodovať s nastavením Modbus adresy striedača.

Časovanie komunikácie

Protokol SolaX Modbus vyžaduje minimálny interval medzi po sebe nasledujúcimi požiadavkami a používa individuálne dotazovacie intervaly pre každé zariadenie v šablóne (od niekoľkých sekúnd pre napätie/frekvenciu siete až po 80 s pre teplotu batérie). Žiadne zariadenie agresívne nedotazujte — striedač interne obmedzuje požiadavky.

Schopnosti zariadenia

Monitorovanie batérie

SOC batérie 1 — stav nabitia primárnej batérie ako analógový vstup 0–1 (surový register v jednotkách 1 %, delený 100 pre rozsah TapHome 0–1)
SOC batérie 2 — stav nabitia druhej batérie, funkčné len na X3-ULT-30K s variantom dvoch batérií; ostatné modely čítajú 0
Teplota batérie — teplota batériového balíka v °C, dotazované každých 80 sekúnd

Výkon solárnych PV

Výkon PV1 (východ) — DC výkon z PV reťazca 1 v kW
Výkon PV2 (východ) — DC výkon z PV reťazca 2 v kW
Výkon PV3 (západ) — DC výkon z PV reťazca 3 v kW, funkčné len na modeloch s 3 MPPT (pozri tabuľku modelov); ostatné modely čítajú 0

Prípony „východ" / „západ" sú konvencia smerového pomenovania zdedená z pôvodnej slovenskej šablóny — číslo PV reťazca zodpovedá fyzickému MPPT vstupu na striedači, nie skutočnej orientácii poľa.

Meranie siete a energie

Napätie siete L1 / L2 / L3 — napätie siete na jednotlivé fázy vo voltoch (registre A:0x006A, A:0x006E, A:0x0072)
Frekvencia siete L1 / L2 / L3 — frekvencia siete na jednotlivé fázy v hertzoch (registre A:0x006D, A:0x0071, A:0x0075)
Výkon dodávky do siete (merač) — mal by ukazovať výkon dodávky z externého SolaX merača / CT, ale oficiálna šablóna číta register A:0x0046 s nesprávnym poradím slov (Int32 namiesto LittleEndianInt32), takže hodnota nedáva zmysel (napríklad −7340,033 namiesto −0,117 kW). Nie je to alias výkonu odber / dodávka do siete — použite to zariadenie alebo opravte skript podľa časti Známe chyby oficiálnej šablóny
Výkon odber / dodávka do siete — správne čítanie výkonu merača / CT (A:0x0046, LittleEndianInt32) v kW; kladné = export, záporné = import
Denná / aktuálna výroba striedača — v oficiálnej šablóne kombinuje dnešnú energiu striedača (register A:0x0050, denné počítadlo, ktoré sa každú noc vynuluje) s registrom A:0x0002, ktorý SolaX dokumentuje len pre jednofázové modely X1 — na X3-Ultra číta 0. Opravené skripty nájdete v časti Známe chyby oficiálnej šablóny
Celková vyrobená energia — celková kumulatívna energia dodaná zo striedača cez AC port do siete v kWh

Ovládanie nabíjačky a dodávky (zapisovateľné)

Režim nabíjačky — prevádzkový režim nabíjačky batérie: Self Use, Feed-in Priority, Backup alebo Manual
SOC nočného nabíjania (vlastná spotreba) — horná cieľová hodnota SOC (10–100 %) pre nočné nabíjanie batérie zo siete v režime vlastnej spotreby
Limit max. výkonu dodávky — maximálny povolený exportný výkon do siete v kW (nie v percentách): register na modeloch X3 počíta v krokoch po 10 W a šablóna ho delí 100

Limit zápisov do EEprom platí pre všetky tri zapisovateľné zariadenia vyššie (Režim nabíjačky → SH:0x001F, SOC nočného nabíjania → SH:0x0063, Max výkon dodávky → SH:0x0042). Podkladové registre sú uložené v EEprom s obmedzeným počtom zápisov — časté zápisy (každých pár sekúnd v automatizačnej slučke) trvalo poškodia EEprom striedača. Používajte len manuálne zmeny alebo nízkofrekvenčné plánované zápisy.

Modulové atribúty a akcie

Prevádzkový režim (servisný atribút) — prevádzkový stav striedača ako text: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby
Model (servisný atribút) — kód modelu striedača ako 4-znakový ASCII reťazec (H3BC = 15K/15KP, H3BD = 19,9K/20K/20KP, H3BF = 25K, H3BG = 30K)
Odomknúť administrátora (servisná akcia) — zapíše konštantu 2014 do SH:0x0000 na odomknutie pokročilých nastavení striedača (zriedka potrebné, len na diagnostiku)

Detekcia chýb

ReadScript modulu monitoruje register prevádzkového režimu (A:0x0009) a hlási TapHome systémovú chybu, keď striedač vstúpi do stavu 3 (Fault) alebo 4 (Permanent Fault). Dva chybové registre sa analyzujú bit po bite:

Chybové kódy striedača (32-bit, A:0x0040–A:0x0041) — 31 individuálnych chýb vrátane chýb napätia/frekvencie siete, chýb napätia PV, chýb batérie, izolačných chýb, prehrievania, ochrany proti prepätiu, chýb relé a chýb komunikácie
Chybové kódy Managera (16-bit, A:0x0043) — 11 chybových bitov vrátane chýb typu napájania, chýb EEPROM, problémov senzora NTC, výstrah teploty batérie, chýb merača a chýb ventilátora

Jednotlivé chyby sa zobrazujú ako diskrétne chyby v systémovom logu TapHome, takže inštalatéri môžu identifikovať zlyhávajúci podsystém bez čítania LCD striedača.

Známe chyby oficiálnej šablóny

Oficiálna šablóna TapHome pre X3-Ultra číta niekoľko registrov nesprávne a jedno nastavenie zapisuje periodicky (overené voči protokolu SolaX Modbus V3.29 a V001.02 a voči hodnotám v nainštalovaných systémoch). Modul importovaný z oficiálnej šablóny sa pri zmene šablóny sám neaktualizuje. Buď ručne opravte skripty existujúceho modulu a jeho zariadení, alebo importujte opravenú komunitnú šablónu z portálu TapHome: SolaX X3-Ultra Hybrid Inverter — monitoring and power control (prihláste sa, stiahnite XML a importujte ho ako nový modul).

Kde	Oficiálny skript	Opravený skript	Dôsledok chyby
Modul — čítací skript	`var x3 := MODBUSR(A, 0x0040, Uint32);`	`var x3 := MODBUSR(A, 0x0040, LittleEndianUint32);`	Dve polovice 32-bitového chybového kódu sú prehodené: chyba v bite 1 (Grid Lost Fault) sa hlási ako bit 17 (Bat Power Low). Parallel Fault (bit 21) a Hard Limit Fault (bit 22) sa nehlásia vôbec
Výkon dodávky do siete (merač)	`MODBUSR(A,0x0046, Int32)/1000`	`MODBUSR(A, 0x0048, LittleEndianUint32) / 100` — celková energia dodaná do siete v kWh	Výkon už správne číta Výkon odber / dodávka do siete; toto zariadenie ukazuje nezmyselné číslo. Celková energia odobratá zo siete: `MODBUSR(A, 0x004A, LittleEndianUint32) / 100`
Denná / aktuálna výroba striedača — celková spotreba	`MODBUSR(A, 0x50, UInt16) /10`	`MODBUSR(A, 0x0094, LittleEndianUint32) / 10`	0x0050 je denné počítadlo, ktoré každú noc klesne na 0; 0x0094 je celková energia z PV
Denná / aktuálna výroba striedača — odber	`MODBUSR(A,0x02, Int16)/1000`	`(MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16) + MODBUSR(A, 0x0124, UInt16)) / 1000`	0x0002 je výkon siete jednofázových modelov X1 a na X3-Ultra číta 0
Teplota batérie	`MODBUSR(A,0x0018, UInt16)`	`MODBUSR(A, 0x0018, Int16)`	Pod 0 °C oficiálna šablóna ukazuje približne 65535 °C
SOC nočného nabíjania (vlastná spotreba) — zápisový skript	`MODBUSW(SH, 0x0063, Uint16, Le * 100)` so zapnutým periodickým zápisom	`IF(MODBUSR(H, 0x0094, UInt16) != ROUND(Le * 100), MODBUSW(SH, 0x0063, Uint16, ROUND(Le * 100)));`	Oficiálne zariadenie zapisuje cieľ nočného nabíjania do striedača pri každom dotazovaní (približne každých 55 s) — 0x0063 je register EEPROM s približne 1 miliónom zápisových cyklov. S opraveným skriptom zapisuje len vtedy, keď sa hodnota naozaj zmení

Register H:0x0094 je aj v protokole V3.29 cieľový stav nabitia pre nočné nabíjanie (SelfUse_NightCharge_UpperSoC); nočné nabíjanie zo siete sa zapína v dolnom bajte H:0x0093 (zápisový register 0x0062).

Vzdialené ovládanie výkonu

Opravená komunitná šablóna pridáva zariadenie Remote control - AC power target. Využíva režim 1 vzdialeného ovládania SolaX (VPP): kladný cieľ v kW spôsobí, že striedač odoberá výkon na svojom AC porte (nabíja batériu, zo siete, ak PV nestačí), záporný cieľ spôsobí, že výkon dodáva (vybíja batériu a čo dom nespotrebuje, ide do siete); 0 vzdialené ovládanie ukončí. Šablóna v prípade potreby odomkne nastavenia striedača predvoleným heslom 2014 a príkaz opakuje každých 60 s. Vzdialené ovládanie sa nespustí, kým je striedač v pracovnom režime Manual.

SolaX v protokole neoznačuje registre vzdialeného ovládania (0x007C–0x0088) ako registre EEPROM, ale ani písomne nepotvrdzuje opak. Táto šablóna sa opiera o skúsenosti komunít Home Assistant a openHAB, ktoré tieto registre zapisujú každých niekoľko sekúnd až minút. Vyššie uvedené nastavenia sú registre EEPROM (SolaX ich označuje ★, približne 1 milión zápisových cyklov): meňte ich zriedka a nikdy z častých automatizácií — na nabíjanie a vybíjanie podľa spotových cien použite cieľ AC výkonu vzdialeného ovládania.

Riešenie problémov

Žiadna komunikácia so striedačom

Overte, že RS-485 zapojenie je na pinoch REMOTE_485A / REMOTE_485B (1+2 alebo 7+8 na pozícii COM 1 RS485), nie na pinoch PARALLEL_485 3–6
Skontrolujte, že prenosová rýchlosť sa zhoduje medzi striedačom (Menu → Setting → Advance Setting → Modbus) a modulom TapHome — predvolene by mali byť obidva 19200
Potvrďte, že Slave ID sa zhoduje (predvolene 1)
Overte, že na RS-485 zbernici je pripojený len jeden Modbus master — Modbus nepodporuje multi-master
Vymeňte vodiče A a B, ak je polarita kábla neistá
Potvrďte, že kábel nepresahuje 30 m celkovej dĺžky RS-485 trasy

PV3 alebo SOC batérie 2 číta nulu

Tieto zariadenia sú funkčné len na X3-ULT-30K (3-MPPT / variant s dvomi batériami). Na menších modeloch registre A:0x0124 (výkon PV3) a A:0x012D (SOC batérie 2) vrátia nulu. Pre inštalácie bez 30K skryte nepoužívané zariadenia v UI TapHome.

Teplota batérie čítá neočakávane vysokú hodnotu

Register teploty batérie (A:0x0018) oficiálna šablóna číta ako UInt16, ale hodnota je znamienková. Teploty pod nulou (napr. −1 °C) sa pretočia na veľké kladné hodnoty (napr. 65535). Zmeňte skript na MODBUSR(A, 0x0018, Int16) — pozrite Známe chyby oficiálnej šablóny.

Zápisy do režimu nabíjačky / SOC nočného nabíjania / max. výkonu dodávky sa neuplatňujú

Tieto registre sú uložené v EEprom a striedač obmedzuje zápisy, aby chránil EEprom. Zabezpečte, aby boli zápisy zriedkavé (manuálne alebo plánované, nie v tesnej automatizačnej slučke). Niektoré verzie firmvéru tiež vyžadujú, aby bol režim nabíjačky nastavený na Manual (3), predtým ako budú reagovať určité podrežimy nútenia nabíjania / vybíjania.

Modbus TCP cez monitorovací modul SolaX je pomalý

Pocket WiFi 3.0 / Pocket LAN / DataHub premosťujú RTU na TCP s dotazovacím cyklom približne 1 sekunda a zvládajú len jedného Modbus TCP klienta naraz. Ak monitoring SolaX Cloud tiež získava údaje, očakávajte konflikty. Pre riadenie v reálnom čase (frekvenčná odozva, peak shaving) použite priame Modbus RTU alebo dedikovanú bránu RS-485-Ethernet tretej strany.

Dostupné zariadenia

SolaX X3 Hybrid Ultra Modul

Servisné atribúty

Prevádzkový režim	Prevádzkový stav striedača — Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby
Model	Kód modelu striedača ako 4-znakový ASCII reťazec (H3BC = 15K/15KP, H3BD = 19,9K/20K/20KP, H3BF = 25K, H3BG = 30K)

Servisné akcie

Odomknúť administrátora

Zapíše konštantu 2014 do registra SH:0x0000 na odomknutie pokročilých nastavení striedača — zriedka potrebné, len na diagnostiku

FVE SOLAX Hybrid Ultra

Čítanie (modul)

var reg := MODBUSR(A, 0x09, UInt16);
IF(reg = 3, ADDERROR("Run Mode Fault"));
IF(reg = 4, ADDERROR("Run Mode Permanent Fault"));
#error table  2-3 for x3
var x3 := MODBUSR(A, 0x0040, Uint32);
IF(GETBIT(x3, 0) = 1, ADDERROR("TZ Protect Fault"));
IF(GETBIT(x3, 1) = 1, ADDERROR("Grid Lost Fault"));
IF(GETBIT(x3, 2) = 1, ADDERROR("Grid Volt Fault"));
IF(GETBIT(x3, 3) = 1, ADDERROR("Grid Freq Fault"));
IF(GETBIT(x3, 4) = 1, ADDERROR("PV Volt Fault"));
IF(GETBIT(x3, 5) = 1, ADDERROR("Bus Volt Fault"));
IF(GETBIT(x3, 6) = 1, ADDERROR("Bat Volt Fault"));
IF(GETBIT(x3, 7) = 1, ADDERROR("AC10mins Volt Fault"));
IF(GETBIT(x3, 8) = 1, ADDERROR("DCI OCP Fault"));
IF(GETBIT(x3, 9) = 1, ADDERROR("DCV OCP Fault"));
IF(GETBIT(x3, 10) = 1, ADDERROR("SW OCP Fault"));
IF(GETBIT(x3, 11) = 1, ADDERROR("RC OCP Fault"));
IF(GETBIT(x3, 12) = 1, ADDERROR("Isolation Fault"));
IF(GETBIT(x3, 13) = 1, ADDERROR("Temp Over Fault"));
IF(GETBIT(x3, 14) = 1, ADDERROR("BatConnDir Fault"));
IF(GETBIT(x3, 15) = 1, ADDERROR("Off-grid Overload"));
IF(GETBIT(x3, 16) = 1, ADDERROR("Overload"));
IF(GETBIT(x3, 17) = 1, ADDERROR("Bat Power Low"));
IF(GETBIT(x3, 18) = 1, ADDERROR("BMS Lost"));
IF(GETBIT(x3, 19) = 1, ADDERROR("Fan Fault"));
IF(GETBIT(x3, 20) = 1, ADDERROR("Low Temp Fault"));
IF(GETBIT(x3, 23) = 1, ADDERROR("INV Volt Sample Fault"));
IF(GETBIT(x3, 24) = 1, ADDERROR("Inner Comm Fault"));
IF(GETBIT(x3, 25) = 1, ADDERROR("INV EEPROM Fault"));
IF(GETBIT(x3, 26) = 1, ADDERROR("RCD Fault"));
IF(GETBIT(x3, 27) = 1, ADDERROR("Grid Relay Fault"));
IF(GETBIT(x3, 28) = 1, ADDERROR("Off-grid Relay Fault"));
IF(GETBIT(x3, 29) = 1, ADDERROR("PV ConnDir Fault"));
IF(GETBIT(x3, 30) = 1, ADDERROR("Charger Relay Fault"));
IF(GETBIT(x3, 31) = 1, ADDERROR("Earth Relay Fault"));

#error 2-5 Manager error code
var err := MODBUSR(A, 0x0043, Uint16);
IF(GETBIT(err, 0) = 1, ADDERROR("Power Type Fault"));
IF(GETBIT(err, 1) = 1, ADDERROR("Port OC Warning"));
IF(GETBIT(err, 2) = 1, ADDERROR("Mgr EEPROM Fault"));
IF(GETBIT(err, 4) = 1, ADDERROR("NTC Sample Invalid"));
IF(GETBIT(err, 5) = 1, ADDERROR("Battery Temperature Low"));
IF(GETBIT(err, 6) = 1, ADDERROR("Battery Temperature High"));
IF(GETBIT(err, 9) = 1, ADDERROR("Meter Fault"));
IF(GETBIT(err, 10) = 1, ADDERROR("Bypass Relay Fault"));
IF(GETBIT(err, 11) = 1, ADDERROR("Fan 2 Fault"));

Servisné atribúty

Run Mode

SWITCH(MODBUSR(A, 0x09, UInt16), 
0, "Waiting",
1, "Checking",
2, "Normal",
3, "Fault",
4, "Permanent Fault",
5, "Update",
6, "Off-grid waiting",
7, "Off-grid",
8, "Self Testing ",
9, "Idle",
10, "Standby",
"Other"
);

Model

MODBUSR(H, 14, String, 4)

Servisné akcie

Unlock admin

MODBUSW(SH, 0x0000, Uint16, 2014);

SOC batérie 1 Analógový vstup Len na čítanie

Stav nabitia primárnej batérie v percentách (0–100 %), v TapHome zobrazený ako analógový vstup 0–1

SOC batérie 2 Analógový vstup Len na čítanie

Stav nabitia druhej batérie v percentách — funkčné len na variante X3-ULT-30K s dvomi batériami; ostatné modely vrátia 0

Celková vyrobená energia Premenná Len na čítanie

Celková kumulatívna energia dodaná zo striedača cez AC port do siete, v kWh

Denná / aktuálna výroba striedača Elektromer Len na čítanie

Oficiálna šablóna: dnešná energia striedača (0x0050, nuluje sa každú noc) a register 0x0002, ktorý je zdokumentovaný len pre modely X1 a na X3-Ultra číta 0; opravené skripty čítajú celkovú energiu z PV (0x0094) a výkon PV1 + PV2 + PV3

Výkon dodávky do siete (merač) Premenná Len na čítanie

Oficiálna šablóna číta register výkonu merača / CT 0x0046 s nesprávnym poradím slov (Int32), takže hodnota nedáva zmysel; použite Výkon odber / dodávka do siete alebo zmeňte skript na energiu dodanú do siete (0x0048, LittleEndianUint32, / 100)

Frekvencia siete L1 Premenná Len na čítanie

Frekvencia siete L2 Premenná Len na čítanie

Frekvencia siete L3 Premenná Len na čítanie

Režim nabíjačky Viacstavový prepínač

Prevádzkový režim nabíjačky batérie — Self Use, Feed-in Priority, Backup alebo Manual. Zápis je uložený v EEprom: nemeňte často z automatizácií

Hodnoty / Stavy: ON · OFF

Napätie siete L1 Premenná Len na čítanie

Napätie siete L2 Premenná Len na čítanie

Napätie siete L3 Premenná Len na čítanie

Výkon odber / dodávka do siete Premenná Len na čítanie

Aktuálny výkon dodávky / odberu z externého merača (0x0046, správne čítaný ako LittleEndianInt32); kladné hodnoty označujú export do siete, záporné odber

Výkon PV1 (východ) Premenná Len na čítanie

Jednosmerný výkon z PV reťazca 1, typicky východne orientované pole v pôvodnom slovenskom pomenovaní šablóny

Výkon PV2 (východ) Premenná Len na čítanie

Jednosmerný výkon z PV reťazca 2, typicky východne orientované pole v pôvodnom slovenskom pomenovaní šablóny

Výkon PV3 (západ) Premenná Len na čítanie

Jednosmerný výkon z PV reťazca 3 — funkčné len na variante X3-ULT-30K s 3 MPPT; ostatné modely vrátia 0

SOC nočného nabíjania (vlastná spotreba) Stmievač

Horná cieľová hodnota SOC (10–100 %) pre nočné nabíjanie batérie zo siete v režime vlastnej spotreby. Zápis je uložený v EEprom; oficiálna šablóna ju zapisuje pri každom dotazovaní (približne každých 55 s) — použite zápisový skript, ktorý hodnotu najprv porovná s 0x0094

Teplota batérie Teplotný senzor Len na čítanie

Limit max. výkonu dodávky Premenná

Maximálny povolený výkon exportu do siete v kW (register na modeloch X3 počíta v krokoch po 10 W). Zápis je uložený v EEprom: nemeňte často z automatizácií

Pripojenie: Modbus RTU • 19200 baud• 8N1 • Slave ID: $[SlaveId]

Možné vylepšenia (40)

A:0x0017 BMS Connect State — 0=Disconnected, 1=Connected. Critical for battery health monitoring
A:0x001A Grid Status — 0=On-grid, 1=Off-grid. Important for backup/off-grid scenarios
A:0x0014, A:0x0015, A:0x0016 Battery Voltage / Current / Power — Battery 1 pack telemetry: 0.1V int16, 0.1A int16, 1W int16. Positive current/power = charge, negative = discharge
A:0x0127, A:0x0128, A:0x0129 Battery 2 Voltage / Current / Power — Battery 2 pack telemetry. X3-ULT-30K only
A:0x0131 Battery 2 Temperature — 1°C, int16. Battery 2 temperature. X3-ULT-30K only
A:0x0008 Radiator Temperature — 1°C, int16. Inverter internal radiator/heatsink temperature
A:0x0003, A:0x0004 PV1 / PV2 Voltage — 0.1V, uint16. Useful for string-level diagnostics
A:0x0005, A:0x0006 PV1 / PV2 Current — 0.1A, uint16. Useful for string-level diagnostics
A:0x0122, A:0x0123 PV3 Voltage / Current — 0.1V uint16 / 0.1A uint16. X3-ULT-30K only
A:0x006B, A:0x006F, A:0x0073 Per-Phase Grid Current L1/L2/L3 — 0.1A, int16 each. Per-phase current for 3-phase monitoring
A:0x006C, A:0x0070, A:0x0074 Per-Phase Grid Power L1/L2/L3 — 1W, int16 each. Per-phase grid power — essential for 3-phase load balancing
A:0x0082–0x0087 Per-Phase Feed-in Power L1/L2/L3 (Meter) — 1W, int32 LE × 3 phases. Per-phase feed-in from meter/CT
A:0x0048–0x0049 Feed-in Energy Total (Meter) — 0.01kWh, uint32 LE. Lifetime energy exported via meter
A:0x004A–0x004B Consumed Energy Total (Meter) — 0.01kWh, uint32 LE. Lifetime energy consumed from grid via meter
A:0x0094–0x0095 Solar Energy Total — 0.1kWh, uint32 LE. Cumulative PV production (all strings combined)
A:0x0096 Solar Energy Today — 0.1kWh, uint16. Today's PV production
A:0x0091, A:0x0092–0x0093 Charged Energy Today / Total — 0.1kWh, uint16 / uint32 LE. Energy charged to battery via inverter AC port
A:0x001D–0x001E, A:0x0020 Battery Discharge Energy Today / Total — 0.1kWh, uint32 LE / uint16. Battery discharge energy
A:0x0021–0x0022, A:0x0023 Battery Charge Energy Today / Total — 0.1kWh, uint32 LE / uint16. Battery charge energy
A:0x00BA, A:0x00BB Battery Temp High / Low — 0.1°C, int16. Min/max battery cell temperatures
A:0x00BC, A:0x00BD Cell Voltage High / Low — 0.001V, uint16. Min/max individual cell voltages — important for battery health
A:0x00BE, A:0x00BF BMS User SOC / SOH — 1%, uint16. SOC and state-of-health as reported by BMS (may differ from A:0x001C)
A:0x00B8, A:0x00B9 Meter 1 / Meter 2 Communication State — 0=Com Error, 1=Normal. Diagnostic for meter/CT connectivity
A:0x0019 BDC Status — 0=discharge, 1=charge, 2=stop. Battery DC converter status
A:0x008E–0x008F, A:0x0090 Off-grid Yield Total / Today — 0.1kWh, uint32 LE / uint16. Energy delivered in off-grid mode
A:0x0088–0x008B On-grid / Off-grid Running Time — 0.1h, uint32 LE each. Lifetime runtime counters
A:0x012F–0x0130 Inverter Total AC Power — 1W, int32. Sum of all 3 phases AC output. X3-ULT-30K only
A:0x0042 Manager Error Code (as Value) — Note: register A:0x0043 is parsed in module readscript for bit-level fault decoding (11 manager fault bits). V3.29 protocol places Manager error at A:0x0042 and BMS error at A:0x0043 — template uses A:0x0043 as 'Manager error code' which may actually be BMS Warning Code (Table 2-6). Potential mismatch — verify
Write SH:0x0020 Manual Mode — 0=Stop charge & discharge, 1=Force charge, 2=Force discharge. Requires Charger Use Mode = 3 (Manual)
Write SH:0x0061 Self-Use Discharge Min SOC — 10–100%. Minimum SOC before discharge stops in Self-Use mode
Write SH:0x0062 Self-Use Night Charge Enable — 0=Disable, 1=Enable night charging from grid. Currently always-on assumption in template — explicit enable would allow user toggle
H:0x0093 Self-Use Discharge Min SOC (Read) — Readback of discharge min SOC limit
H:0x008C Manual Mode Readback — 0=Stop, 1=Force charge, 2=Force discharge. Readback of current manual sub-mode
H:0x008D Battery Type — 0=Lead Acid, 1=Lithium. Battery chemistry diagnostic
H:0x0100–0x011F Modbus Power Control (Remote) — Active/reactive power targets, SOC targets, time-of-duration. Enables advanced energy management and grid services (peak shaving, FCR, etc.)
A:0x0120, A:0x0121 BMS Relay State / Restart Flag — 0/1 each. BMS relay status and restart indicator
H:0x001D Safety Code (Country Standard) — 0–39 enum. Grid safety standard (VDE0126, VDE4105, AS4777, G98/G99, EN50549, etc.) — useful for installation diagnostics
H:0x0023 Power Limits Percent — 0–100%, uint16. Inverter output power limit
H:0x00BA Inverter Power Type — Model variant code (15K/20K/25K/30K). Useful for runtime model detection
H:0x0000–0x0006 Inverter Serial Number — 14-character ASCII string across 7 registers. Service attribute candidate

Stiahnuť šablónu

Zdroje

SolaX X1/X3-IES & X3-Ultra Modbus TCP & RTU Communication Protocol V3.29
www.gbc-solino.cz 2026-05-29
PDF
SolaX X3-Ultra Series User Manual (Installation & Wiring)
www.solaxpower.com 2026-05-29
PDF
SolaX X3-Ultra Datasheet (Product Overview & Specs)
www.solaxpower.com 2026-05-29
PDF
Home Assistant SolaX Modbus Integration (X3-Ultra Gen5 Support)
github.com 2026-05-29
SolaX KB: How to Get Device Data by Modbus TCP
kb.solaxpower.com 2026-05-29

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli