SolaX X3-Ultra (X3-ULT-15K, 20K, 25K, 30K) je trojfázový hybridný solárny invertor pre FV a batériu. Táto komunitná šablóna od Martina Kellera ho pripája k TapHome cez Modbus RTU na RS-485 porte COM 1 (19200 baud, 8N1) a vychádza z čítacích registrov protokolu SolaX Modbus V3.29 a z protokolu SolaX Modbus V001.02. Poskytuje kompletnú sadu meračov pre Energy Dashboard, monitorovanie batérie, siete a porúch, nastavenia solárneho invertora, ktoré sa zapisujú len vtedy, keď sa ich hodnota naozaj zmení, a vzdialené riadenie AC výkonu (režim 1 vzdialeného ovládania SolaX) — nabíjanie batérie zo siete alebo jej vybíjanie do siete na povel, napríklad podľa spotových cien elektriny.
Ako získať šablónu
Komunitné šablóny sa v zozname šablón aplikácie TapHome neponúkajú. Prihláste sa na portal.taphome.com, stiahnite XML tejto šablóny a importujte ho do Core na rozhraní Modbus RTU (alebo na rozhraní Modbus TCP, ak sa použije brána RS-485-Ethernet). Na monitorovanie bez vzdialeného riadenia výkonu je k dispozícii oficiálna šablóna SolaX X3 Hybrid Ultra. Modul importovaný skôr z oficiálnej šablóny sa sám neaktualizuje — importujte túto šablónu ako nový modul a starý odstráňte.
Hardvérové pripojenie
X3-Ultra má jediný viacúčelový port COM 1 (konektor RJ45 s označeným káblovým prípravkom). Tie isté fyzické piny slúžia na rôzne funkcie podľa toho, ktorá označená pozícia káblového prípravku sa použije. Na integráciu Modbus tretej strany použite pozíciu RS485 — vodiče REMOTE_485A a REMOTE_485B.
Pinout portu COM 1

Priradenie pinov pozície 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 | rovnaký signál ako pin 1 |
| 8 | REMOTE_485B | rovnaký signál ako pin 2 |
Piny 3–6 patria kanálu SolaX PARALLEL_485 a sú vyhradené pre produkty SolaX (Adapter Box G2, EV-Charger, DataHub). Piny 1, 2, 7 a 8 sú určené pre iné zariadenia než produkty SolaX. K pinom 3–6 nepripájajte Modbus master tretej strany.
Zapojenie RS-485

Pravidlá zapojenia z používateľského manuálu X3-Ultra (sekcia 8.6.4):
- Typ kábla: sieťový kábel CAT5E alebo CAT6
- Maximálna dĺžka: komunikačný kábel RS-485 nesmie presiahnuť 30 m
- RJ45 terminál: pôvodný konektor kábla sa odstrihne a podľa priradenia pinov sa zalisuje nový RJ45 terminál; nie všetky zariadenia prijmú plne zapojený 8-pinový sieťový kábel
- Pozícia v káblovom prípravku: RJ45 terminál patrí do otvoru označeného RS485 (nie do Parallel-1, Parallel-2, BMS-1, BMS-2 ani DRM); konektor zacvakne do portu COM 1 a zaistí sa prevlečnou maticou
- Jeden Modbus master: port smie používať len jeden Modbus master. Iné monitorovanie Modbus na tom istom porte odpojte, inak solárny invertor odpovedá obom a hodnoty sú nestabilné
Používateľský manuál neuvádza pravidlo pre zakončenie zbernice RS-485 na pozícii RS485 portu COM 1.
Elektromer alebo CT pre hodnoty siete
Zariadenia siete v tejto šablóne (Grid - power balance, Zo siete, Do siete, Spotreba) čítajú výkon dodávky do siete, ktorý solárny invertor meria vlastným elektromerom alebo CT. Elektromer alebo CT sa zapája do portu COM 2 (Meter/CT: METER_485A na pine 4, METER_485B na pine 5, alebo vstupy CT) a nastavuje sa na displeji solárneho invertora v Menu → Setting → Advance Setting → Meter/CT Setting. Je to samostatná linka RS-485 — TapHome k nej nepripájajte.
Možnosti pripojenia
- Priame Modbus RTU: zapojte pár RS485 portu COM 1 priamo na zbernicu RS-485 riadiacej jednotky TapHome Core. Najnižšia latencia, odporúča sa pre vzdialené riadenie výkonu.
- Brána RS-485-Ethernet: ak je solárny invertor ďaleko od TapHome Core, možno na pár RS485 portu COM 1 použiť bránu RS-485-Ethernet tretej strany; šablóna sa potom importuje na rozhraní Modbus TCP.
- Monitorovací modul SolaX: samotný solárny invertor Modbus TCP nepodporuje. Modbus TCP (port 502) je dostupný len cez monitorovací modul SolaX, s dotazovacím cyklom približne 1 sekunda (protokol V3.29).
Konfigurácia
Povolenie komunikácie Modbus na solárnom invertore
Na LCD solárneho invertora prejdite na:
| |
Menu Advance Setting vyžaduje heslo inštalatéra (podľa používateľského manuálu na začiatku 2014; manuál odporúča heslo zmeniť). V menu Modbus nastavte Baud Rate a Address externého komunikačného protokolu:
| Parameter | Predvolená hodnota šablóny | Predvolená hodnota solárneho invertora (protokol V3.29) |
|---|---|---|
| Modbus adresa (Slave ID) | 1 | 1 |
| Prenosová rýchlosť | 19200 | 19200 |
| Parita | None | None |
| Dátové bity | 8 | 8 |
| Stop bity | 1 | 1 |
Prenosová rýchlosť musí byť rovnaká na solárnom invertore aj na rozhraní Modbus RTU v TapHome. Ak komunikácia zlyhá, najprv skontrolujte prenosovú rýchlosť.
Solárny invertor hlási Modbus adresu aj v holding registri H:0x00AF a prenosovú rýchlosť v holding registri H:0x00B0 (protokol V3.29).
Parameter importu
Pri importe šablóny sa parameter importu Modbus Slave ID (predvolene 1) musí zhodovať s Modbus adresou nastavenou na displeji solárneho invertora.
Schopnosti zariadenia
Energy Dashboard
| Zariadenie | Čítanie |
|---|---|
| FV Výroba | Výkon vstupov PV1 + PV2 + PV3 (A:0x000A, A:0x000B, A:0x0124) v kW; celková energia z FV (A:0x0094–0x0095) v kWh. Výkon PV1–PV3 a celková energia na AC výstupe solárneho invertora (A:0x0052) sú servisné atribúty. |
| Zo siete / Do siete | Odberová a dodávková časť výkonu siete z elektromera alebo CT (A:0x0046–0x0047, najprv nižšie slovo) s počítadlami celkovej energie (A:0x004A a A:0x0048, 0,01 kWh). |
| Do batérie / Z batérie | Nabíjacia a vybíjacia časť výkonu batérie 1 (A:0x0016) s celkovou nabitou a vybitou energiou (A:0x0021, A:0x001D). |
| Spotreba | Vypočítaná spotreba domu: AC výkon solárneho invertora mínus dodávka do siete. SolaX nemá register spotreby; záťaž na výstupe EPS (záložnom) sa nezapočítava. |
| Batéria (SOC) | Stav nabitia batérie 1 (A:0x001C). Zostávajúca a dobíjateľná energia (A:0x0118, A:0x0116) sú servisné atribúty. |
Energetický manažér
Pre smart rule Energetický manažér vyberte Grid - power balance. Hodnota má znamienko: kladná pri odbere zo siete, záporná pri dodávke prebytku. Merače Zo siete a Do siete nikdy nie sú záporné a prebytok neukazujú.
Monitorovanie
- Battery 2 - state of charge — druhý batériový vstup (BAT 2), jeho výkon a teplota sú servisné atribúty; bez druhej batérie číta 0
- Battery - temperature — číta sa ako hodnota so znamienkom, takže teploty pod 0 °C sa zobrazujú správne
- Inverter - AC power — súčet výkonov troch fáz na AC porte solárneho invertora v kW
- Grid - voltage L1 — napätie siete L2, L3 a tri frekvencie siete sú servisné atribúty
Nastavenia solárneho invertora
| Zariadenie | Čítanie | Zápis |
|---|---|---|
| Settings - work mode | H:0x008B: Self use, Feed-in priority, Backup, Manual, Peak shaving, Time of use (posledné dva závisia od firmvéru) | 0x001F |
| Settings - manual mode | H:0x008C: Stop charge and discharge, Force charge, Force discharge (účinné len v pracovnom režime Manual) | 0x0020 |
| Settings - self-use minimum SOC | horný bajt H:0x0093 | 0x0061 |
| Settings - night charge from grid | dolný bajt H:0x0093 | 0x0062 |
| Settings - night charge target SOC | H:0x0094 | 0x0063 |
| Settings - export limit | H:0x00B6, v kW (na X3 10 W na jednotku) | 0x0042 |
SolaX tieto nastavenia číta z iných adries, než na ktoré ich zapisuje, preto nemožno použiť vstavanú funkciu TapHome „zapisovať len pri zmene“. Každý zápisový skript preto nastavenie najprv prečíta a zapíše ho (funkcia 06) len vtedy, keď sa nová hodnota líši; keď solárny invertor hlási nastavenia ako zamknuté, najprv zapíše heslo nastavení 2014 do registra 0x0000. Minimálne SOC a cieľ nočného nabíjania nikdy neklesnú pod 10 % (rozsah SolaX). Žiadne z týchto zariadení nezapisuje periodicky.
Tieto 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 Remote control - AC power target.
Remote control - AC power target
Toto zariadenie využíva režim 1 vzdialeného ovládania SolaX (VPP) — riadenie výkonu na AC porte solárneho invertora.
- Znamienko: kladný cieľ znamená, že solárny invertor odoberá výkon na svojom AC porte (nabíja batériu, zo siete, ak FV nestačí); záporný cieľ znamená, že výkon dodáva (vybíja batériu a čo dom nespotrebuje, ide do siete). Hodnota v kW.
- 0 ukončí vzdialené ovládanie: šablóna raz zapíše režim 0 a solárny invertor sa vráti do svojho pracovného režimu. Ciele pod 0,5 W sa počítajú ako 0.
- Akákoľvek iná hodnota: ak je solárny invertor zamknutý, šablóna najprv zapíše heslo nastavení 2014 (odomknutie sa stratí po každom reštarte solárneho invertora), potom zapíše 13 registrov
0x007C–0x0088jednou požiadavkou Modbus (funkcia 0x10): režim 1, cieľ, trvanie 120 s a timeout 60 s. Kým cieľ nie je 0, príkaz sa opakuje každých 60 s. Ak ho TapHome prestane posielať, solárny invertor drží cieľ najviac 2 minúty, ďalšiu 1 minútu drží na AC porte 0 W a potom sa sám vráti do svojho pracovného režimu. - Pracovný režim Manual blokuje vzdialené ovládanie. SolaX nespustí vzdialené ovládanie, kým je solárny invertor v pracovnom režime Manual — najprv ho prepnite na Self use (alebo iný režim).
- Solárny invertor obmedzí cieľ na rozsah zobrazený v atribútoch modulu (minimálny a maximálny cieľ vzdialeného ovládania).
- Akcia modulu End remote control okamžite zapíše režim 0. Kým cieľ nie je 0, ďalšie opakovanie vzdialené ovládanie znova spustí — na trvalé zastavenie nastavte cieľ na 0.
- Toto zariadenie nekombinujte so vzdialeným ovládaním zo SolaX Cloud ani od energetického agregátora: kým je cieľ 0, šablóna do 60 s ukončí akýkoľvek režim vzdialeného ovládania.
- Vzdialené ovládanie potrebuje Core, ktorý zapíše všetkých 13 registrov jednou požiadavkou. To platí pre každý Core od roku 2022, ak modul ponechá
MaxPrefetchGroupSize32 z tejto šablóny. - Servisný atribút Actual AC power ukazuje činný výkon, ktorý solárny invertor hlási na svojom AC porte, vo W (
A:0x0106).
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.
Atribúty a akcie modulu
- Run mode (servisný atribút) — stav solárneho invertora ako text: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle, Standby, Remote control (kód 20); ostatné kódy sa zobrazia ako Other
- Machine type (servisný atribút) — X1 (jednofázový) alebo X3 (trojfázový), holding register
H:0x0105 - Settings lock (servisný atribút) — Locked alebo Unlocked (
A:0x0054) - Remote control mode (servisný atribút) — aktívny režim vzdialeného ovládania (
A:0x0100): Off, Power control, Energy target, SOC target - Remote control - maximum target / minimum target (servisné atribúty) — povolený rozsah cieľového výkonu, ktorý hlási solárny invertor, vo W (
A:0x010A,A:0x010C) - Unlock settings (password 2014) (servisná akcia) — zapíše
2014do registra0x0000 - End remote control (servisná akcia) — zapíše režim 0 do registrov vzdialeného ovládania
0x007C–0x0088
Detekcia porúch
Čítací skript modulu hlási chybu TapHome, keď je prevádzkový režim (A:0x0009) 3 (Fault) alebo 4 (Permanent fault). Okrem toho analyzuje bit po bite dva chybové registre, každú poruchu s vlastným kódom chyby:
- Chybový kód solárneho invertora (32-bit,
A:0x0040–A:0x0041, číta sa najprv nižšie slovo) — všetkých 32 bitov, od TZ Protect Fault, porúch napätia siete, FV, zbernice a batérie, izolačných porúch a prehriatia až po Parallel Fault, Hard Limit Fault a poruchy relé - Chybový kód správcu (16-bit,
A:0x0043) — Power Type Fault, Mgr EEPROM Fault, NTC Sample Invalid, nízka a vysoká teplota batérie, Meter Fault, Bypass Relay Fault a Fan 2 Fault ako chyby, Port OC Warning ako varovanie
Riešenie problémov
Žiadna komunikácia so solárnym invertorom
- Overte, že vodiče RS-485 sú na pinoch REMOTE_485A / REMOTE_485B (1 + 2 alebo 7 + 8 v pozícii RS485 káblového prípravku COM 1), nie na pinoch PARALLEL_485 3–6 a nie na linke elektromera portu COM 2
- Skontrolujte, či sa prenosová rýchlosť zhoduje medzi solárnym invertorom (
Menu → Setting → Advance Setting → Modbus) a rozhraním Modbus RTU v TapHome — predvolene 19200 - Overte, že parameter importu Modbus Slave ID zodpovedá Modbus adrese solárneho invertora (predvolene
1) - Uistite sa, že k portu je pripojený len jeden Modbus master
- Ak si nie ste istí polaritou kábla, vymeňte vodiče A a B
- Overte, že kábel RS-485 nepresahuje 30 m
Cieľ vzdialeného ovládania sa hneď po nastavení vráti na 0
Solárny invertor je v pracovnom režime Manual, firmvér nepodporuje režim 1 vzdialeného ovládania alebo je cieľ mimo minimálneho a maximálneho cieľa zobrazeného v atribútoch modulu. Najprv skontrolujte pracovný režim.
Zápis nastavení je odmietnutý
Solárny invertor je zamknutý. Spustite akciu modulu Unlock settings (password 2014); zámok sa vráti po každom reštarte solárneho invertora (atribút modulu Settings lock).
Hodnoty siete sú 0 alebo Spotreba nesedí
Grid - power balance, Zo siete, Do siete a Spotreba závisia od elektromera alebo CT solárneho invertora. Skontrolujte jeho zapojenie na COM 2 a nastavenie v Menu → Setting → Advance Setting → Meter/CT Setting.
Výkon PV3 alebo Battery 2 ukazuje 0
PV3 existuje len na modeloch s tromi trackermi (napríklad X3-ULT-25K a X3-ULT-30K, počet MPPT pozrite v používateľskom manuáli); Battery 2 len vtedy, keď je k BAT 2 pripojená druhá batéria. Nepoužívané zariadenia v TapHome skryte.
SolaX