SolaX X3-Ultra (X3-ULT-15K, 20K, 25K, 30K) trofazni je hibridni izmjenjivač (inverter) za fotonaponske panele i baterije. Ovaj predložak zajednice, autora Martina Kellera, povezuje ga sa sustavom TapHome preko Modbus RTU na priključku RS-485 COM 1 (19200 baud, 8N1), a temelji se na registrima za čitanje protokola SolaX Modbus V3.29 i na protokolu SolaX Modbus V001.02. Nudi cjelovit skup mjernih uređaja za Energy Dashboard, praćenje baterije, mreže i kvarova, postavke izmjenjivača koje se upisuju samo kad se njihova vrijednost stvarno promijeni te daljinsko upravljanje AC snagom (način 1 daljinskog upravljanja SolaX): punjenje baterije iz mreže ili njezino pražnjenje u mrežu na naredbu, na primjer prema spot cijenama električne energije.
Kako preuzeti predložak
Predlošci zajednice ne nude se na popisu predložaka u aplikaciji TapHome. Prijavite se na portal.taphome.com, preuzmite XML ovog predloška i uvezite ga u centralnu jedinicu Core na sučelju Modbus RTU (ili na sučelju Modbus TCP kada se koristi pristupnik RS-485 na Ethernet). Za praćenje bez daljinskog upravljanja snagom dostupan je službeni predložak SolaX X3 Hybrid Ultra. Modul ranije uvezen iz službenog predloška ne ažurira se sam: uvezite ovaj predložak kao novi modul i uklonite stari.
Hardversko spajanje
X3-Ultra ima jedan višenamjenski priključak COM 1 (konektor RJ45 s označenim nosačem kabela). Isti fizički pinovi imaju različite funkcije, ovisno o tome koji se označeni položaj nosača kabela koristi. Za integraciju s Modbus uređajima drugih proizvođača koristite položaj RS485, odnosno vodove REMOTE_485A i REMOTE_485B.
Raspored pinova priključka COM 1

Raspored pinova položaja RS485 (jedini položaj važan za TapHome):
| Pin | Signal | Spajanje na TapHome |
|---|---|---|
| 1 | REMOTE_485A | A+ / D+ |
| 2 | REMOTE_485B | B− / D− |
| 3 | PARALLEL_485AA | ne koristiti (samo za pribor SolaX) |
| 4 | PARALLEL_485AA | ne koristiti (samo za pribor SolaX) |
| 5 | PARALLEL_485BB | ne koristiti (samo za pribor SolaX) |
| 6 | PARALLEL_485BB | ne koristiti (samo za pribor SolaX) |
| 7 | REMOTE_485A | isti signal kao pin 1 |
| 8 | REMOTE_485B | isti signal kao pin 2 |
Pinovi 3–6 pripadaju kanalu SolaX PARALLEL_485 i rezervirani su za proizvode SolaX (Adapter Box G2, EV-Charger, DataHub). Pinovi 1, 2, 7 i 8 namijenjeni su uređajima koji nisu proizvodi SolaX. Na pinove 3–6 nemojte spajati Modbus master drugog proizvođača.
Ožičenje RS-485

Pravila ožičenja iz korisničkog priručnika X3-Ultra (odjeljak 8.6.4):
- Vrsta kabela: mrežni kabel CAT5E ili CAT6
- Najveća duljina: komunikacijski kabel RS-485 ne smije biti dulji od 30 m
- Konektor RJ45: postojeći konektor kabela odreže se, a novi konektor RJ45 krimpa se prema rasporedu pinova; ne prihvaćaju svi uređaji potpuno ožičen mrežni kabel s 8 pinova
- Položaj u nosaču kabela: konektor RJ45 ide u utor s oznakom RS485 (ne u Parallel-1, Parallel-2, BMS-1, BMS-2 ni DRM); konektor uskoči u priključak COM 1 i osigura se okretnom maticom
- Samo jedan Modbus master: priključak smije koristiti samo jedan Modbus master. Odspojite drugi Modbus nadzor na istom priključku, inače izmjenjivač odgovara obojici i očitanja postaju nestabilna
Korisnički priručnik ne navodi pravilo za zaključenje (terminaciju) sabirnice RS-485 na položaju RS485 priključka COM 1.
Brojilo ili CT za vrijednosti mreže
Uređaji mreže ovog predloška (Grid - power balance, Iz mreže, Na mrežu, Potrošnja) očitavaju snagu predaje u mrežu koju izmjenjivač mjeri vlastitim brojilom ili strujnim transformatorom (CT). Brojilo ili CT spaja se na priključak COM 2 (Meter/CT: METER_485A na pinu 4, METER_485B na pinu 5 ili ulazi CT) i postavlja se na zaslonu izmjenjivača u Menu → Setting → Advance Setting → Meter/CT Setting. To je zaseban vod RS-485: na njega ne spajajte TapHome.
Mogućnosti spajanja
- Izravno Modbus RTU: par RS485 priključka COM 1 spojite izravno na sabirnicu RS-485 centralne jedinice Core. Najmanje kašnjenje, preporučeno za daljinsko upravljanje snagom.
- Pristupnik RS-485 na Ethernet: kada je izmjenjivač daleko od centralne jedinice Core, na par RS485 priključka COM 1 može se spojiti pristupnik RS-485 na Ethernet drugog proizvođača; predložak se tada uvozi na sučelju Modbus TCP.
- Modul za nadzor SolaX: sam izmjenjivač ne podržava Modbus TCP. Modbus TCP (port 502) dostupan je samo preko modula za nadzor SolaX, s ciklusom upita od približno 1 sekunde (protokol V3.29).
Konfiguracija
Uključivanje komunikacije Modbus na izmjenjivaču
Na zaslonu LCD izmjenjivača otvorite:
| |
Izbornik Advance Setting traži lozinku instalatera (prema korisničkom priručniku početno 2014; priručnik preporučuje da je promijenite). U izborniku Modbus postavite Baud Rate i Address vanjskog komunikacijskog protokola:
| Parametar | Zadano u predlošku | Zadano na izmjenjivaču (protokol V3.29) |
|---|---|---|
| Modbus adresa (Slave ID) | 1 | 1 |
| Brzina prijenosa | 19200 | 19200 |
| Paritet | None | None |
| Podatkovni bitovi | 8 | 8 |
| Stop bitovi | 1 | 1 |
Brzina prijenosa na izmjenjivaču i na sučelju Modbus RTU sustava TapHome mora biti ista. Ako komunikacija ne radi, najprije provjerite brzinu prijenosa.
Izmjenjivač Modbus adresu javlja i u holding registru H:0x00AF, a brzinu prijenosa u holding registru H:0x00B0 (protokol V3.29).
Parametar uvoza
Pri uvozu predloška parametar uvoza Modbus Slave ID (zadano 1) mora odgovarati Modbus adresi postavljenoj na zaslonu izmjenjivača.
Mogućnosti uređaja
Energy Dashboard
| Uređaj | Očitanje |
|---|---|
| PV proizvodnja | Ulazna snaga PV1 + PV2 + PV3 (A:0x000A, A:0x000B, A:0x0124) u kW; ukupna fotonaponska energija (A:0x0094–0x0095) u kWh. Snaga PV1–PV3 i ukupna AC izlazna energija izmjenjivača (A:0x0052) servisni su atributi. |
| Iz mreže / Na mrežu | Dio snage mreže koji se preuzima i dio koji se predaje, s brojila ili CT-a (A:0x0046–0x0047, niža riječ prva), s ukupnim brojačima energije (A:0x004A i A:0x0048, 0,01 kWh). |
| Na bateriju / Od baterije | Dio snage baterije 1 pri punjenju i pri pražnjenju (A:0x0016), s ukupnom energijom punjenja i pražnjenja (A:0x0021, A:0x001D). |
| Potrošnja | Izračunata potrošnja kuće: AC snaga izmjenjivača umanjena za predaju u mrežu. SolaX nema registar potrošnje; trošila na izlazu EPS (rezervno napajanje) nisu uključena. |
| Baterija (SOC) | Stanje napunjenosti baterije 1 (A:0x001C). Preostala energija i energija koja se još može napuniti (A:0x0118, A:0x0116) servisni su atributi. |
Energy Manager
Za smart rule Energy Manager odaberite Grid - power balance. Vrijednost ima predznak: pozitivna je pri preuzimanju iz mreže, negativna pri predaji viška. Uređaji Iz mreže i Na mrežu nikad nisu negativni i ne prikazuju višak.
Praćenje
- Battery 2 - state of charge — drugi priključak baterije (BAT 2), sa snagom i temperaturom kao servisnim atributima; bez druge baterije očitava 0
- Battery - temperature — očitava se kao vrijednost s predznakom, pa se temperature ispod 0 °C prikazuju ispravno
- Inverter - AC power — zbroj triju faznih snaga na AC priključku izmjenjivača u kW
- Grid - voltage L1 — s naponima mreže L2 i L3 te trima frekvencijama mreže kao servisnim atributima
Postavke izmjenjivača
| Uređaj | Čitanje | Upis |
|---|---|---|
| Settings - work mode | H:0x008B: Self use, Feed-in priority, Backup, Manual, Peak shaving, Time of use (posljednja dva ovise o firmveru) | 0x001F |
| Settings - manual mode | H:0x008C: Stop charge and discharge, Force charge, Force discharge (djeluje samo u radnom načinu Manual) | 0x0020 |
| Settings - self-use minimum SOC | viši bajt registra H:0x0093 | 0x0061 |
| Settings - night charge from grid | niži bajt registra H:0x0093 | 0x0062 |
| Settings - night charge target SOC | H:0x0094 | 0x0063 |
| Settings - export limit | H:0x00B6, u kW (10 W po koraku na X3) | 0x0042 |
SolaX ove postavke čita s drugih adresa od onih na koje ih upisuje, pa se ugrađena funkcija sustava TapHome „upiši samo ako je različito” ne može koristiti. Zato svaka skripta za upis najprije pročita postavku i upisuje (funkcija 06) samo kad se nova vrijednost razlikuje; kad izmjenjivač javlja da su postavke zaključane, najprije upiše lozinku postavki 2014 u registar 0x0000. Najmanji SOC i cilj noćnog punjenja nikad ne padaju ispod 10 % (raspon SolaX). Nijedan od ovih uređaja ne upisuje periodično.
Ove postavke su registri EEPROM (SolaX ih označava sa ★, približno 1 milijun ciklusa upisa). Mijenjajte ih rijetko i nikad iz čestih automatizacija: za punjenje i pražnjenje prema spot cijenama koristite Remote control - AC power target.
Remote control - AC power target
Ovaj uređaj koristi način 1 daljinskog upravljanja SolaX (VPP), odnosno upravljanje snagom na AC priključku izmjenjivača.
- Predznak: pozitivan cilj znači da izmjenjivač preuzima snagu na svojem AC priključku (puni bateriju, iz mreže ako fotonaponska snaga nije dovoljna); negativan cilj znači da snagu predaje (prazni bateriju, a ono što kuća ne potroši odlazi u mrežu). Vrijednost u kW.
- 0 završava daljinsko upravljanje: predložak jednom upiše način 0 i izmjenjivač se vraća u svoj radni način. Ciljevi manji od 0,5 W računaju se kao 0.
- Bilo koja druga vrijednost: ako je izmjenjivač zaključan, predložak najprije upiše lozinku postavki 2014 (otključavanje se gubi nakon svakog ponovnog pokretanja izmjenjivača), a zatim jednim Modbus zahtjevom (funkcija 0x10) upiše 13 registara
0x007C–0x0088: način 1, cilj, trajanje 120 s i vremensko ograničenje 60 s. Naredba se ponavlja svakih 60 s dok cilj nije 0. Ako je TapHome prestane slati, izmjenjivač zadržava cilj najviše 2 minute, još 1 minutu drži 0 W na svojem AC priključku, a zatim se sam vraća u svoj radni način. - Radni način Manual blokira daljinsko upravljanje. SolaX ne pokreće daljinsko upravljanje dok je izmjenjivač u radnom načinu Manual: najprije ga prebacite na Self use (ili drugi način).
- Izmjenjivač ograničava cilj na raspon prikazan u atributima modula (najmanji i najveći cilj daljinskog upravljanja).
- Radnja modula End remote control odmah upisuje način 0. Dok cilj nije 0, sljedeće ponavljanje ponovno pokreće daljinsko upravljanje: za trajno zaustavljanje postavite cilj na 0.
- Ovaj uređaj nemojte kombinirati s daljinskim upravljanjem iz oblaka SolaX Cloud ili od agregatora energije: dok je cilj 0, predložak u roku od 60 s završava svaki način daljinskog upravljanja.
- Daljinsko upravljanje treba centralnu jedinicu Core koja svih 13 registara upisuje jednim zahtjevom. To vrijedi za svaku centralnu jedinicu Core od 2022. ako modul zadrži
MaxPrefetchGroupSize32 iz ovog predloška. - Servisni atribut Actual AC power prikazuje djelatnu snagu koju izmjenjivač javlja na svojem AC priključku, u W (
A:0x0106).
SolaX u svojem protokolu ne označava registre daljinskog upravljanja (
0x007C–0x0088) kao registre EEPROM, ali ni pisanim putem ne potvrđuje suprotno. Ovaj se predložak oslanja na iskustvo zajednica Home Assistant i openHAB, koje te registre upisuju svakih nekoliko sekundi do nekoliko minuta.
Atributi i radnje modula
- Run mode (servisni atribut) — stanje izmjenjivača kao tekst: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle, Standby, Remote control (kod 20); ostali kodovi prikazuju se kao Other
- Machine type (servisni atribut) — X1 (single-phase) ili X3 (three-phase), holding registar
H:0x0105 - Settings lock (servisni atribut) — Locked ili Unlocked (
A:0x0054) - Remote control mode (servisni atribut) — aktivni način daljinskog upravljanja (
A:0x0100): Off, Power control, Energy target, SOC target - Remote control - maximum target / minimum target (servisni atributi) — dopušteni raspon ciljne snage koji javlja izmjenjivač, u W (
A:0x010A,A:0x010C) - Unlock settings (password 2014) (servisna radnja) — upisuje
2014u registar0x0000 - End remote control (servisna radnja) — upisuje način 0 u registre daljinskog upravljanja
0x007C–0x0088
Otkrivanje kvarova
Skripta za čitanje modula javlja pogrešku sustava TapHome kada je način rada (Run mode, A:0x0009) 3 (Fault) ili 4 (Permanent fault). Osim toga bit po bit raščlanjuje dva registra pogrešaka, svaki kvar s vlastitim kodom pogreške:
- Kod kvara izmjenjivača (32-bitni,
A:0x0040–A:0x0041, čita se niža riječ prva) — sva 32 bita, od TZ Protect Fault, kvarova napona mreže, fotonaponskog napona, napona sabirnice i napona baterije, kvarova izolacije i pregrijavanja do Parallel Fault, Hard Limit Fault i kvarova releja - Kod pogreške upravljača (Manager) (16-bitni,
A:0x0043) — Power Type Fault, Mgr EEPROM Fault, NTC Sample Invalid, niska i visoka temperatura baterije, Meter Fault, Bypass Relay Fault i Fan 2 Fault kao pogreške, Port OC Warning kao upozorenje
Rješavanje problema
Nema komunikacije s izmjenjivačem
- Provjerite jesu li vodiči RS-485 na pinovima REMOTE_485A / REMOTE_485B (1 + 2 ili 7 + 8 u položaju RS485 nosača kabela COM 1), a ne na pinovima PARALLEL_485 3–6 ni na vodu brojila na COM 2
- Provjerite podudara li se brzina prijenosa na izmjenjivaču (
Menu → Setting → Advance Setting → Modbus) i na sučelju Modbus RTU sustava TapHome: zadano je 19200 - Provjerite odgovara li parametar uvoza Modbus Slave ID Modbus adresi izmjenjivača (zadano
1) - Provjerite je li na priključak spojen samo jedan Modbus master
- Ako polaritet kabela nije siguran, zamijenite vodiče A i B
- Provjerite da kabel RS-485 nije dulji od 30 m
Cilj daljinskog upravljanja vraća se na 0 odmah nakon postavljanja
Izmjenjivač je u radnom načinu Manual, firmver ne podržava način 1 daljinskog upravljanja ili je cilj izvan najmanjeg i najvećeg cilja prikazanog u atributima modula. Najprije provjerite radni način.
Upis postavki se odbija
Izmjenjivač je zaključan. Pokrenite radnju modula Unlock settings (password 2014); zaključavanje se vraća nakon svakog ponovnog pokretanja izmjenjivača (atribut modula Settings lock).
Vrijednosti mreže su 0 ili Potrošnja izgleda pogrešno
Grid - power balance, Iz mreže, Na mrežu i Potrošnja ovise o brojilu ili CT-u izmjenjivača. Provjerite njegovo ožičenje na COM 2 i postavke u Menu → Setting → Advance Setting → Meter/CT Setting.
Snaga PV3 ili Battery 2 pokazuje 0
PV3 postoji samo na modelima s tri MPPT ulaza (na primjer X3-ULT-25K i X3-ULT-30K, broj MPPT ulaza pogledajte u korisničkom priručniku); Battery 2 samo kada je druga baterija spojena na BAT 2. Nekorištene uređaje sakrijte u sustavu TapHome.
SolaX