---
title: "SolaX X3 Hybrid Ultra"
description: "Praćenje stringova, SOC-a baterije, napona i frekvencije mreže te upravljanje punjačem i SOC-om noćnog punjenja hibridnog SolaX X3-Ultra preko Modbus RTU."
url: "https://taphome.com/hr/compatibility/solax-hybrid-ultra-x3/"
language: hr
lastmod: 2026-10-14
generator: hugo
ai:
  topics: ["modbus-rtu","inverter","solar","rs485","battery-storage","3-phase","hybrid-inverter","energy-monitoring","gen5"]
  questions: ["Podržava li TapHome izmjenjivač SolaX X3 Hybrid Ultra?","Kako ožičiti RS-485 s priključka COM 1 izmjenjivača SolaX X3-Ultra na TapHome?","Koji modeli SolaX X3-Ultra rade s predloškom TapHome?","Koja je zadana brzina prijenosa Modbus na SolaX X3-Ultra?","Kako preko Modbus RTU očitati SOC baterije s izmjenjivača SolaX X3 Hybrid Ultra?","Zašto PV3 i SOC baterije 2 na mojem SolaX X3-Ultra pokazuju nulu?"]
---

# SolaX X3 Hybrid Ultra

Komunikacija: Modbus RTU

- [Službena stranica SolaX Power](https://www.solaxpower.com)
- [Stranica proizvoda SolaX X3-Ultra](https://www.solaxpower.com/x3-ultra/)

## Upute za integraciju

SolaX X3 Hybrid Ultra (Gen5) trofazni je hibridni izmjenjivač (inverter) za fotonaponske panele i baterije nazivne snage od 10 kW do 30 kW. Predložak TapHome s izmjenjivačem komunicira preko **Modbus RTU na priključku RS-485 COM 1** (pinovi REMOTE_485A / REMOTE_485B) i primjenjuje mapu registara protokola SolaX Modbus V3.29. Očitava snagu fotonaponskih stringova, stanje napunjenosti i temperaturu baterije, trofazni napon i frekvenciju mreže, ukupnu i dnevnu energiju te snagu predaje u mrežu s vanjskog brojila, a omogućuje upis načina rada punjača, SOC-a noćnog punjenja u načinu vlastite potrošnje i ograničenja najveće snage predaje.

X3-Ultra **ne** podržava izvorno Modbus TCP. TCP je dostupan samo preko modula za nadzor SolaX (Pocket WiFi 3.0, Pocket LAN ili DataHub), koji premošćuje RTU na TCP na portu 502. Za udaljene instalacije TapHome se može spojiti i preko pristupnika (gateway) RS-485 na Ethernet drugog proizvođača (npr. Waveshare, USR-DR302) konfiguriranog kao Modbus RTU-over-TCP.

## Modeli

Predložak TapHome pokriva cijelu seriju X3-Ultra. Senzori PV3 i SOC baterije 2 rade samo na varijanti od 30 kW s 3 MPPT i dvije baterije.

| Model | Nazivna AC snaga | MPPT regulatori | Napomene |
|-------|----------------|---------------|-------|
| X3-ULT-15K | 15 kW | 2 | Standardni, 2 MPPT |
| X3-ULT-15KP | 15 kW | 3 | 3 MPPT (kod modela H3BC) |
| X3-ULT-19.9K | 19,9 kW | 2 | Standardni, 2 MPPT |
| X3-ULT-20K | 20 kW | 2 | Standardni, 2 MPPT (kod modela H3BD) |
| X3-ULT-20KP | 20 kW | 3 | 3 MPPT |
| X3-ULT-25K | 25 kW | 3 | Kod modela H3BF |
| X3-ULT-25KW | 25 kW | 3 | — |
| X3-ULT-30K | 30 kW | 3 | Dvije baterije, PV3 aktivan (kod modela H3BG) |
| X3-ULT-10K-GLV | 10 kW | — | Niskonaponska varijanta (GLV) |
| X3-ULT-15K-GLV | 15 kW | — | Niskonaponska varijanta (GLV) |

Kod modela može se očitati tijekom rada preko atributa modula **Model** (registar H:0x000E, ASCII niz od 4 znaka).

## Opseg kompatibilnosti

Predložak primjenjuje onaj dio protokola SolaX Modbus V3.29 koji se najčešće koristi za upravljanje energijom u kući: 19 uređaja, 2 servisna atributa na razini modula i jednu servisnu radnju. Cijeli protokol nudi mnogo više registara; najkorisnije neprimijenjene mogućnosti (snaga i struja mreže po fazama, napon/struja/snaga baterije, stanje BMS-a, vrijeme rada izvan mreže, daljinsko upravljanje snagom itd.) mogu se dodati u budućem ažuriranju predloška. Ispravljeni predložak zajednice na portalu TapHome već dodaje daljinsko upravljanje snagom i upise postavki koji se izvršavaju samo kad se vrijednost promijeni; pogledajte Poznate pogreške službenog predloška i Daljinsko upravljanje snagom u nastavku.

## Hardversko spajanje

X3-Ultra ima jedan višenamjenski **priključak COM 1** (konektor tipa RJ45 s označenim nosačem kabela). Isti fizički pinovi imaju različite funkcije, ovisno o tome na koji označeni položaj nosača spojite kabel. 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 priključka COM 1 na SolaX X3-Ultra za svih šest označenih položaja (Parallel-1, Parallel-2, BMS-1, BMS-2, RS485, DRM)](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/com1-pinout_hu_4124a3cd9e8bc981.jpg)

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** | duplikat pina 1 (za linijsku topologiju) |
| **8** | **REMOTE_485B** | duplikat pina 2 (za linijsku topologiju) |

> [!WARNING]
> Pinovi 3–6 pripadaju vlasničkom kanalu SolaX PARALLEL_485 i rezervirani su za pribor SolaX (Adapter Box G2, EV-Charger, DataHub, paralelni izmjenjivači). Na te pinove **nemojte** spajati Modbus master drugog proizvođača.

> [!NOTE]
> Stariji izmjenjivači SolaX (Gen4 X3-Hybrid) koristili su **pin 4 = 485A** i **pin 5 = 485B**. Raspored pinova COM 1 na X3-Ultra je drukčiji: prije krimpanja uvijek provjerite oznake na nosaču kabela svojeg uređaja. Dio dokumentacije zajednice još navodi stariji raspored Gen4.

### Ožičenje RS-485

![Umetanje konektora RJ45 u položaj RS485 nosača kabela COM 1](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/wiring-rs485_hu_ac07cf89af382c1.jpg)

Pravila ožičenja iz korisničkog priručnika X3-Ultra (odjeljak 8.6.4):

- **Vrsta kabela:** standardna upredena parica Cat5 ili Cat6 UTP
- **Najveća duljina:** **30 m** kabela RS-485 između izmjenjivača i centralne jedinice TapHome (CCU)
- **Polaritet je važan:** ako nema komunikacije, zamijenite A i B
- **Samo jedan Modbus master:** na sabirnici je dopušten samo jedan master. Ako vod dijeli i modul za nadzor SolaX, računajte na sukobe

Nosač kabela COM 1 ima zasebne označene položaje za svaki kanal: kabel Cat5/Cat6 spojite u utor s oznakom **RS485** (ne u Parallel-1, Parallel-2, BMS-1, BMS-2 ni DRM).

### Mogućnosti spajanja

- **Izravno na Modbus RTU centralne jedinice (CCU):** par RS-485 s priključka COM 1 spojite izravno na Modbus RTU centralne jedinice TapHome. Najmanje kašnjenje, preporučeno za upravljanje u stvarnom vremenu.
- **Pristupnik RS-485 na Ethernet (Modbus RTU-over-TCP):** za instalacije u kojima je izmjenjivač daleko od TapHome Core koristite pristupnik Waveshare RS485-to-Ethernet, USR-DR302 ili sličan, konfiguriran kao Modbus RTU-over-TCP na portu 502. Parametar uvoza predloška `IpAddress` predviđen je za takav način spajanja.
- **SolaX Pocket WiFi 3.0 / Pocket LAN / DataHub (Modbus TCP):** ako je modul za nadzor SolaX već ugrađen, on premošćuje RTU na TCP na portu 502 s ciklusom upita od približno 1 sekunde. To je sporije od izravnog RTU i nije prikladno za regulacijske petlje u stvarnom vremenu.

## Konfiguracija

### Uključivanje komunikacije Modbus na izmjenjivaču

Na zaslonu LCD izmjenjivača otvorite:

```
Menu → Setting → Advance Setting → Modbus
```

Izbornik naprednih postavki može tražiti lozinku instalatera. Provjerite ili postavite sljedeće:

| Parametar | Zadano u predlošku TapHome | Zadano na izmjenjivaču | Raspon |
|-----------|--------------------------|------------------|-------|
| Modbus adresa (Slave ID) | 1 | 1 | 1–255 |
| Brzina prijenosa | 19200 | 19200 | 9600 / 19200 / 38400 / 57600 / 115200 |
| Paritet | None | None | None / Odd / Even |
| Podatkovni bitovi | 8 | 8 | — |
| Stop bitovi | 1 | 1 | 1 ili 2 |

> [!WARNING]
> Brzina prijenosa na izmjenjivaču i u sustavu TapHome mora biti ista. Protokol V3.29 navodi **19200** kao zadanu vrijednost za X3-Ultra; neki stariji predlošci i dokumentacija SolaX još spominju 9600. Ako komunikacija ne radi, najprije provjerite brzinu prijenosa.

Izmjenjivač može Modbus slave adresu nuditi i preko holding registra `H:0x00AC`, a brzinu prijenosa preko holding registra `H:0x00AD`.

### Parametri uvoza u sustavu TapHome

Pri uvozu predloška u TapHome treba postaviti dva parametra:

| Parametar | Namjena |
|-----------|---------|
| **IpAddress** | IP adresa pristupnika RS-485 na TCP (ili modula za nadzor SolaX Pocket WiFi / LAN). Ako je izmjenjivač spojen izravno na Modbus RTU centralne jedinice TapHome, ostavite zadanu vrijednost. |
| **SlaveId** | Modbus slave adresa izmjenjivača (zadano `1`). Mora odgovarati postavci Modbus Address na izmjenjivaču. |

### Vremenski raspored komunikacije

Protokol SolaX Modbus zahtijeva najkraći razmak između uzastopnih zahtjeva, a predložak koristi zasebne intervale očitavanja za svaki uređaj (od nekoliko sekundi za napon / frekvenciju mreže do 80 s za temperaturu baterije). Nijedan uređaj nemojte očitavati prečesto: izmjenjivač interno ograničava broj zahtjeva.

## Mogućnosti uređaja

### Praćenje baterije

- **SOC baterije 1** — stanje napunjenosti primarne baterije kao analogni ulaz 0–1 (neobrađena vrijednost registra u jedinicama od 1 % dijeli se sa 100 za raspon 0–1 u sustavu TapHome)
- **SOC baterije 2** — stanje napunjenosti druge baterije, **radi samo na X3-ULT-30K** s dvije baterije; ostali modeli očitavaju 0
- **Temperatura baterije** — temperatura baterijskog paketa u °C, očitava se svakih 80 sekundi

### Fotonaponska snaga

- **Snaga PV1 (istok)** — izlazna DC snaga fotonaponskog stringa 1 u kW
- **Snaga PV2 (istok)** — izlazna DC snaga fotonaponskog stringa 2 u kW
- **Snaga PV3 (zapad)** — izlazna DC snaga fotonaponskog stringa 3 u kW, **radi samo na modelima s 3 MPPT** (pogledajte tablicu modela); ostali modeli očitavaju 0

Dodaci „istok” / „zapad” naslijeđeni su iz nazivlja izvornog slovačkog predloška: broj fotonaponskog stringa odgovara fizičkom MPPT ulazu na izmjenjivaču, a ne stvarnoj orijentaciji polja.

### Mjerenje mreže i energije

- **Napon mreže L1 / L2 / L3** — napon mreže po fazama u voltima (registri `A:0x006A`, `A:0x006E`, `A:0x0072`)
- **Frekvencija mreže L1 / L2 / L3** — frekvencija mreže po fazama u hercima (registri `A:0x006D`, `A:0x0071`, `A:0x0075`)
- **Snaga predaje u mrežu (brojilo)** — zamišljena kao snaga predaje u mrežu s vanjskog brojila SolaX / strujnog transformatora (CT), ali službeni predložak registar `A:0x0046` očitava s pogrešnim redoslijedom riječi (`Int32` umjesto `LittleEndianInt32`), pa vrijednost nema smisla (na primjer −7340,033 umjesto −0,117 kW). To nije drugi naziv za Snagu preuzimanja iz mreže / predaje u mrežu: koristite taj uređaj ili ispravite skriptu kako je opisano u odjeljku Poznate pogreške službenog predloška
- **Snaga preuzimanja iz mreže / predaje u mrežu** — ispravno očitanje snage brojila / CT-a (`A:0x0046`, `LittleEndianInt32`) u kW; pozitivno = predaja, negativno = preuzimanje
- **Dnevna / trenutačna proizvodnja izmjenjivača** — u službenom predlošku objedinjuje današnju energiju izmjenjivača (registar `A:0x0050`, dnevni brojač koji se svake noći poništava) i registar `A:0x0002`, koji SolaX dokumentira samo za jednofazne modele X1; na X3-Ultra očitava 0. Ispravljene skripte nalaze se u odjeljku Poznate pogreške službenog predloška
- **Ukupna proizvedena energija** — ukupna kumulativna energija predana s AC priključka izmjenjivača u mrežu, u kWh

### Upravljanje punjačem i predajom u mrežu (upis)

- **Način rada punjača** — način rada punjača baterije: Vlastita potrošnja, Prednost predaje u mrežu, Rezervno napajanje ili Ručno
- **SOC noćnog punjenja (vlastita potrošnja)** — gornja ciljna vrijednost SOC-a (10–100 %) za noćno punjenje baterije iz mreže u načinu vlastite potrošnje
- **Ograničenje najveće snage predaje** — najveća dopuštena snaga predaje u mrežu **u kW** (ne u postocima): na modelima X3 registar broji u koracima od 10 W, a predložak dijeli sa 100

> [!WARNING]
> **Ograničenje broja upisa u EEprom vrijedi** za sva tri gornja uređaja s upisom (Način rada punjača → `SH:0x001F`, SOC noćnog punjenja → `SH:0x0063`, Najveća snaga predaje → `SH:0x0042`). Ovi registri spremaju se u EEprom s ograničenim brojem ciklusa upisa: česti upisi (svakih nekoliko sekundi u automatizacijskoj petlji) trajno će oštetiti EEprom izmjenjivača. Koristite samo ručne promjene ili rijetke upise po rasporedu.

### Atributi i radnje na razini modula

- **Način rada** (servisni atribut) — radno stanje izmjenjivača kao tekst: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby
- **Model** (servisni atribut) — kod modela izmjenjivača kao ASCII niz od 4 znaka (H3BC = 15K/15KP, H3BD = 19.9K/20K/20KP, H3BF = 25K, H3BG = 30K)
- **Otključaj administratorski način** (servisna radnja) — upisuje konstantu `2014` u `SH:0x0000` radi otključavanja naprednih postavki izmjenjivača (rijetko potrebno, samo za dijagnostiku)

### Otkrivanje kvarova

ReadScript modula prati registar načina rada (`A:0x0009`) i javlja pogrešku sustava TapHome kada izmjenjivač prijeđe u stanje 3 (Fault) ili 4 (Permanent Fault). Dva registra pogrešaka raščlanjuju se bit po bit:

- **Kodovi kvarova izmjenjivača** (32-bitni, `A:0x0040`–`A:0x0041`) — 31 pojedinačni kvar, uključujući kvarove napona / frekvencije mreže, kvarove fotonaponskog napona, kvarove baterije, kvarove izolacije, pregrijavanje, zaštitu od prekomjerne struje, kvarove releja i komunikacijske pogreške
- **Kodovi pogrešaka upravljača (Manager)** (16-bitni, `A:0x0043`) — 11 bitova kvarova, uključujući kvarove vrste napajanja, pogreške EEPROM-a, probleme sa senzorom NTC, upozorenja o temperaturi baterije, kvarove brojila i kvarove ventilatora

Pojedinačni kvarovi prikazuju se kao zasebne pogreške u zapisniku sustava TapHome, pa instalater može pronaći neispravan podsustav bez očitavanja zaslona LCD izmjenjivača.

## Poznate pogreške službenog predloška

Službeni predložak TapHome za X3-Ultra pogrešno očitava nekoliko registara i jednu postavku upisuje periodično (provjereno prema protokolu SolaX Modbus V3.29 i V001.02 te prema vrijednostima u ugrađenim sustavima). Modul uvezen iz službenog predloška **ne ažurira se sam** kad se predložak promijeni. Ili ručno ispravite skripte postojećeg modula i njegovih uređaja, ili uvezite ispravljeni predložak zajednice s portala TapHome: [SolaX X3-Ultra Hybrid Inverter — monitoring and power control](https://portal.taphome.com/portal/community/solax-x3-ultra-power-control-modbus-rtu) (prijavite se, preuzmite XML i uvezite ga kao novi modul).

**[SolaX X3-Ultra Hybrid Inverter — monitoring and power control (Modbus RTU)](https://portal.taphome.com/hr/portal/community/solax-x3-ultra-power-control-modbus-rtu)** — SolaX, Modbus RTU. SolaX X3-Ultra hybrid inverter over Modbus RTU — Energy Dashboard set, corrected readings, settings written only on change, remote AC power control for spot-price charging and discharging.

| Gdje | Službena skripta | Ispravljena skripta | Posljedica pogreške |
|------|------------------|---------------------|---------------------|
| Modul — skripta za čitanje | `var x3 := MODBUSR(A, 0x0040, Uint32);` | `var x3 := MODBUSR(A, 0x0040, LittleEndianUint32);` | Dvije polovice 32-bitnog koda kvara zamijenjene su: kvar u bitu 1 (Grid Lost Fault) javlja se kao bit 17 (Bat Power Low). Parallel Fault (bit 21) i Hard Limit Fault (bit 22) uopće se ne javljaju |
| Snaga predaje u mrežu (brojilo) | `MODBUSR(A,0x0046, Int32)/1000` | `MODBUSR(A, 0x0048, LittleEndianUint32) / 100` — ukupna energija predana u mrežu u kWh | Snagu već ispravno očitava Snaga preuzimanja iz mreže / predaje u mrežu; ovaj uređaj prikazuje besmislen broj. Ukupna energija preuzeta iz mreže: `MODBUSR(A, 0x004A, LittleEndianUint32) / 100` |
| Dnevna / trenutačna proizvodnja izmjenjivača — ukupna potrošnja | `MODBUSR(A, 0x50, UInt16) /10` | `MODBUSR(A, 0x0094, LittleEndianUint32) / 10` | 0x0050 je dnevni brojač koji svake noći padne na 0; 0x0094 je ukupna fotonaponska energija |
| Dnevna / trenutačna proizvodnja izmjenjivača — potražnja | `MODBUSR(A,0x02, Int16)/1000` | `(MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16) + MODBUSR(A, 0x0124, UInt16)) / 1000` | 0x0002 je snaga mreže jednofaznih modela X1 i na X3-Ultra očitava 0 |
| Temperatura baterije | `MODBUSR(A,0x0018, UInt16)` | `MODBUSR(A, 0x0018, Int16)` | Ispod 0 °C službeni predložak prikazuje približno 65535 °C |
| SOC noćnog punjenja (vlastita potrošnja) — skripta za upis | `MODBUSW(SH, 0x0063,  Uint16, Le * 100)` s uključenim periodičnim upisom | `IF(MODBUSR(H, 0x0094, UInt16) != ROUND(Le * 100), MODBUSW(SH, 0x0063, Uint16, ROUND(Le * 100)));` | Službeni uređaj upisuje cilj noćnog punjenja u izmjenjivač pri svakom očitavanju (približno svakih 55 s); 0x0063 je registar EEPROM s približno 1 milijun ciklusa upisa. S ispravljenom skriptom upisuje samo kad se vrijednost stvarno promijeni |

Registar `H:0x0094` i u protokolu V3.29 sadrži ciljno stanje napunjenosti za noćno punjenje (SelfUse_NightCharge_UpperSoC); noćno punjenje iz mreže uključuje se u nižem bajtu registra `H:0x0093` (registar za upis `0x0062`).

## Daljinsko upravljanje snagom

Ispravljeni predložak zajednice dodaje uređaj **Remote control - AC power target**. Koristi način 1 daljinskog upravljanja SolaX (VPP): pozitivan cilj u kW navodi izmjenjivač da preuzima snagu na svojem AC priključku (puni bateriju, iz mreže ako fotonaponska snaga nije dovoljna), a negativan cilj da snagu predaje (prazni bateriju, a ono što kuća ne potroši odlazi u mrežu); 0 završava daljinsko upravljanje. Predložak po potrebi otključava postavke izmjenjivača zadanom lozinkom 2014 i ponavlja naredbu svakih 60 s. Daljinsko upravljanje ne pokreće se dok je izmjenjivač u radnom načinu Ručno.

> [!WARNING]
> 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. Gornje 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 cilj AC snage daljinskog upravljanja.

## Rješavanje problema

### Nema komunikacije s izmjenjivačem

1. Provjerite je li ožičenje RS-485 na pinovima **REMOTE_485A / REMOTE_485B** (1+2 ili 7+8 u položaju RS485 priključka COM 1), a ne na pinovima PARALLEL_485 3–6
2. Provjerite je li brzina prijenosa na izmjenjivaču (`Menu → Setting → Advance Setting → Modbus`) jednaka onoj u modulu TapHome: zadano mora biti 19200 na obje strane
3. Provjerite podudara li se Slave ID (zadano `1`)
4. Provjerite je li na sabirnicu RS-485 spojen samo **jedan** Modbus master: Modbus ne podržava više mastera
5. Ako polaritet kabela nije siguran, zamijenite vodiče A i B
6. Provjerite da ukupna duljina kabela RS-485 ne prelazi **30 m**

### PV3 ili SOC baterije 2 pokazuju nulu

Ovi uređaji rade samo na **X3-ULT-30K** (varijanta s 3 MPPT / dvije baterije). Na manjim modelima registri `A:0x0124` (snaga PV3) i `A:0x012D` (SOC baterije 2) vraćaju nulu. Na instalacijama bez modela 30K sakrijte nekorištene uređaje u korisničkom sučelju TapHome.

### Temperatura baterije pokazuje neočekivano visoku vrijednost

Službeni predložak registar temperature baterije (`A:0x0018`) očitava kao `UInt16`, ali je vrijednost s predznakom. Temperature ispod nule (npr. −1 °C) prelaze u velike pozitivne vrijednosti (npr. 65535). Promijenite skriptu u `MODBUSR(A, 0x0018, Int16)`; pogledajte Poznate pogreške službenog predloška.

### Upisi u Način rada punjača / SOC noćnog punjenja / Najveću snagu predaje ne djeluju

Ovi se registri spremaju u EEprom, a izmjenjivač ograničava broj upisa radi zaštite EEprom-a. Upisujte rijetko (ručno ili po rasporedu, ne u brzoj automatizacijskoj petlji). Neke verzije firmvera traže i da Način rada punjača bude postavljen na **Ručno** (`3`) prije nego što određeni podnačini prisilnog punjenja / pražnjenja počnu reagirati.

### Modbus TCP preko modula za nadzor SolaX je spor

Pocket WiFi 3.0 / Pocket LAN / DataHub premošćuju RTU na TCP s ciklusom upita od približno 1 sekunde i istodobno poslužuju samo jednog klijenta Modbus TCP. Ako podatke preuzima i nadzor SolaX Cloud, računajte na sukobe. Za upravljanje u stvarnom vremenu (odziv na frekvenciju, smanjenje vršnog opterećenja) koristite izravni Modbus RTU ili namjenski pristupnik RS-485 na Ethernet drugog proizvođača.

## Dostupni uređaji 19

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

SolaX X3 Hybrid Ultra Modul

Servisni atributi

|            |                                                                                                                                                |
|------------|------------------------------------------------------------------------------------------------------------------------------------------------|
| Način rada | Radno stanje izmjenjivača — Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby |
| Model      | Kod modela izmjenjivača kao ASCII niz od 4 znaka (H3BC = 15K/15KP, H3BD = 19.9K/20K/20KP, H3BF = 25K, H3BG = 30K)                              |

Servisne radnje

|                                  |                                                                                                                                         |
|----------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------|
| Otključaj administratorski način | Upisuje konstantu 2014 u registar SH:0x0000 radi otključavanja naprednih postavki izmjenjivača — rijetko potrebno, samo za dijagnostiku |

Čitanje (modul)

```taphome
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"));
```

Servisni atributi

Run Mode

```taphome
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

```taphome
MODBUSR(H, 14, String, 4)
```

Servisne radnje

Unlock admin

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

SOC baterije 1 Analogni ulaz Samo za čitanje

Stanje napunjenosti primarne baterije u postocima (0–100 %), u sustavu TapHome prikazano kao analogni ulaz 0–1

Registar: A:0x001C UInt16 Jedinica: % numeric

Čitanje razine ulaza

```taphome
MODBUSR(A, 0x1C, UInt16)/100
```

SOC baterije 2 Analogni ulaz Samo za čitanje

Stanje napunjenosti druge baterije u postocima — radi samo na varijanti X3-ULT-30K s dvije baterije; ostali modeli očitavaju 0

Registar: A:0x012D UInt16 Jedinica: % numeric

Čitanje razine ulaza

```taphome
MODBUSR(A, 0x012D, Uint16) / 100
```

Ukupna proizvedena energija Varijabla Samo za čitanje

Ukupna kumulativna energija predana s AC priključka izmjenjivača u mrežu, u kWh

Registar: A:0x0052 LittleEndianInt32 Jedinica: kWh numeric

Čitanje

```taphome
MODBUSR(A, 0x52,LittleEndianInt32) / 10
```

Dnevna / trenutačna proizvodnja izmjenjivača Brojilo električne energije Samo za čitanje

Službeni predložak: današnja energija izmjenjivača (0x0050, poništava se svake noći) i registar 0x0002, koji je dokumentiran samo za modele X1 i na X3-Ultra očitava 0; ispravljene skripte očitavaju ukupnu fotonaponsku energiju (0x0094) i snagu PV1 + PV2 + PV3

Registar: A:0x0050, A:0x0002 UInt16, Int16 Jedinica: kWh / kW numeric

Čitanje ukupne potrošnje

```taphome
MODBUSR(A, 0x50, UInt16) /10
```

Čitanje zahtjeva

```taphome
MODBUSR(A,0x02, Int16)/1000
```

Snaga predaje u mrežu (brojilo) Varijabla Samo za čitanje

Službeni predložak registar snage brojila / CT-a 0x0046 očitava s pogrešnim redoslijedom riječi (Int32), pa vrijednost nema smisla; koristite Snagu preuzimanja iz mreže / predaje u mrežu ili promijenite skriptu na energiju predanu u mrežu (0x0048, LittleEndianUint32, / 100)

Registar: A:0x0046 Int32 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(A,0x0046, Int32)/1000
```

Frekvencija mreže L1 Varijabla Samo za čitanje

Registar: A:0x006D Int16 Jedinica: Hz numeric

Čitanje

```taphome
MODBUSR(A, 0x006D, Int16)/100
```

Frekvencija mreže L2 Varijabla Samo za čitanje

Registar: A:0x0071 Int16 Jedinica: Hz numeric

Čitanje

```taphome
MODBUSR(A,0x0071, Int16)/100
```

Frekvencija mreže L3 Varijabla Samo za čitanje

Registar: A:0x0075 Int16 Jedinica: Hz numeric

Čitanje

```taphome
MODBUSR(A,0x0075, Int16)/100
```

Način rada punjača Prekidač s više vrijednosti Čitanje i pisanje

Način rada punjača baterije — vlastita potrošnja, prednost predaje u mrežu, rezervno napajanje ili ručno. Vrijednost se sprema u EEprom: nemojte je često mijenjati automatizacijama

Registar: H:0x008B → SH:0x001F UInt16 numeric

Vrijednosti / stanja: Self Use · Feedin Priority · Backup · Manual · Peak Shaving

Čitanje stanja sklopke

```taphome
MODBUSR(H, 0x008B, Uint16)
```

Zapis stanja sklopke

```taphome
MODBUSW(SH, 0x001F, uint16, Mu)
```

Napon mreže L1 Varijabla Samo za čitanje

Registar: A:0x006A Int16 Jedinica: V numeric

Čitanje

```taphome
MODBUSR(A,0x006A, Int16)/10
```

Napon mreže L2 Varijabla Samo za čitanje

Registar: A:0x006E Int16 Jedinica: V numeric

Čitanje

```taphome
MODBUSR(A, 0x006E, Int16)/10
```

Napon mreže L3 Varijabla Samo za čitanje

Registar: A:0x0072 Int16 Jedinica: V numeric

Čitanje

```taphome
MODBUSR(A,0x0072, Int16)/10
```

Snaga preuzimanja iz mreže / predaje u mrežu Varijabla Samo za čitanje

Trenutačna snaga predaje u mrežu / potrošnje iz mreže s vanjskog brojila (0x0046, ispravno očitan kao LittleEndianInt32); pozitivne vrijednosti znače predaju u mrežu, negativne preuzimanje

Registar: A:0x0046 LittleEndianInt32 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(A, 0x46,LittleEndianInt32)/1000
```

Snaga PV1 (istok) Varijabla Samo za čitanje

DC snaga fotonaponskog stringa 1, koji je prema izvornom slovačkom nazivlju predloška obično polje okrenuto prema istoku

Registar: A:0x000A UInt16 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(A,0x0a, UInt16)/1000
```

Snaga PV2 (istok) Varijabla Samo za čitanje

DC snaga fotonaponskog stringa 2, koji je prema izvornom slovačkom nazivlju predloška obično polje okrenuto prema istoku

Registar: A:0x000B UInt16 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(A,0x0b, UInt16)/1000
```

Snaga PV3 (zapad) Varijabla Samo za čitanje

DC snaga fotonaponskog stringa 3 — radi samo na varijanti X3-ULT-30K s 3 MPPT; ostali modeli očitavaju 0

Registar: A:0x0124 UInt16 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(A, 0x0124, Uint16)/1000
```

SOC noćnog punjenja (vlastita potrošnja) Dimer Čitanje i pisanje

Gornja ciljna vrijednost SOC-a (10–100 %) za noćno punjenje baterije iz mreže u načinu vlastite potrošnje. Vrijednost se sprema u EEprom; službeni predložak upisuje je pri svakom očitavanju (približno svakih 55 s) — koristite skriptu za upis koja vrijednost najprije usporedi s 0x0094

Registar: H:0x0094 → SH:0x0063 UInt16 Jedinica: % numeric

Čitanje razine

```taphome
MODBUSR(H, 0x0094, Uint16) / 100
```

Zapis razine

```taphome
MODBUSW(SH, 0x0063,  Uint16, Le * 100)
```

Temperatura baterije Senzor temperature Samo za čitanje

Registar: A:0x0018 UInt16 Jedinica: °C numeric

Čitanje temperature

```taphome
MODBUSR(A,0x0018, UInt16)
```

Ograničenje najveće snage predaje Varijabla Čitanje i pisanje

Najveća dopuštena snaga predaje u mrežu u kW (na modelima X3 registar broji u koracima od 10 W). Vrijednost se sprema u EEprom: nemojte je često mijenjati automatizacijama

Registar: H:0x00B6 → SH:0x0042 UInt16 Jedinica: kW numeric

Čitanje

```taphome
MODBUSR(H, 0x00B6, Uint16)/100
```

Zapis

```taphome
MODBUSW(SH, 0x0042, Uint16, Va*100)
```

**Povezivanje:** Modbus RTU • 19200 baud• 8N1 • Slave ID: $\[SlaveId]

Moguća poboljšanja (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

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| Slave Id             | `1`           |
| IP address           | `192.168.1.0` |

## Izvori

- SolaX X1/X3-IES & X3-Ultra Modbus TCP & RTU Communication Protocol V3.29
  
  [www.gbc-solino.cz](https://www.gbc-solino.cz/files/uploads/FAQ%20SolaX/Hybrid-X1X3-IES-ULTRA-ModbusTCPRTU-V3.29.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/Hybrid-X1X3-IES-ULTRA-ModbusTCPRTU-V3.29.pdf)
- SolaX X3-Ultra Series User Manual (Installation & Wiring)
  
  [www.solaxpower.com](https://www.solaxpower.com/uploads/file/x3-ultra-series-user-manual-en.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/x3-ultra-series-user-manual-en.pdf)
- SolaX X3-Ultra Datasheet (Product Overview & Specs)
  
  [www.solaxpower.com](https://www.solaxpower.com/uploads/file/solax-x3-ultra-datasheet-en.pdf) 2026-05-29
  
  [PDF](https://taphome.com/compatibility/devices/solax-hybrid-ultra-x3/manufacturer/solax-x3-ultra-datasheet-en.pdf)
- Home Assistant SolaX Modbus Integration (X3-Ultra Gen5 Support)
  
  [github.com](https://github.com/wills106/homeassistant-solax-modbus) 2026-05-29
- SolaX KB: How to Get Device Data by Modbus TCP
  
  [kb.solaxpower.com](https://kb.solaxpower.com/solution/detail/ff8080818407e2a701840a22dec20032) 2026-05-29

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [Modbus Integration](https://taphome.com/hr/compatibility/modbus-guide/)
- [Modbus](https://taphome.com/hr/docs/integration/modbus/)
- [Jednostavna konfiguracija pomoću predložaka](https://taphome.com/hr/docs/integration/modbus/templates/)
- [Skripte Modbus i prefetch](https://taphome.com/hr/docs/script/modbus-scripts/)
- [Funkcije Modbus](https://taphome.com/hr/docs/script/modbus/)
- [Tipovi podataka Modbus](https://taphome.com/hr/docs/script/modbus-data-types/)

