--- title: "SolaX X3 Hybrid Ultra" description: "PV stringek, SOC, hálózati V/F monitorozása és töltési mód vezérlése SolaX X3-Ultra inverteren Modbus RTU-n keresztül." url: "https://taphome.com/hu/compatibility/solax-hybrid-ultra-x3/" language: hu lastmod: 2026-10-14 generator: hugo ai: topics: ["modbus-rtu","inverter","solar","rs485","battery-storage","3-phase","hybrid-inverter","energy-monitoring","gen5"] questions: ["Támogatja a TapHome a SolaX X3 Hybrid Ultra invertert?","Hogyan kell bekötni az RS-485-öt a SolaX X3-Ultra COM 1 portjáról a TapHome-hoz?","Mely SolaX X3-Ultra modellek működnek a TapHome sablonnal?","Mi az alapértelmezett Modbus baudráta a SolaX X3-Ultra-n?","Hogyan olvasható az akkumulátor SOC a SolaX X3 Hybrid Ultra-ról Modbus RTU-n keresztül?","Miért olvas a PV3 és az Akkumulátor 2 SOC nullát a SolaX X3-Ultra-mon?"] --- # SolaX X3 Hybrid Ultra Kommunikáció: Modbus RTU - [SolaX Power hivatalos weboldal](https://www.solaxpower.com) - [SolaX X3-Ultra termékoldal](https://www.solaxpower.com/x3-ultra/) ## Integrációs útmutató A SolaX X3 Hybrid Ultra (Gen5) egy háromfázisú hibrid PV/akkumulátoros inverter 10 kW-tól 30 kW-ig terjedő névleges teljesítménnyel. A TapHome sablon az inverterrel **Modbus RTU-n keresztül kommunikál a COM 1 RS-485 porton** (REMOTE_485A / REMOTE_485B csapok) és a SolaX Modbus V3.29 protokoll regisztertérképét implementálja. Olvassa a PV string teljesítményt, akkumulátor töltöttségi állapotát és hőmérsékletét, háromfázisú hálózati feszültséget és frekvenciát, élettartam és napi energiaösszegeket, betáplálási teljesítményt a külső mérőről, valamint írható módon biztosítja a Töltési módot, Éjszakai töltési SOC-t (saját felhasználás) és Max. betáplálási teljesítményhatárt. Az X3-Ultra **nem támogatja** natívan a Modbus TCP-t — a TCP csak SolaX monitorozó modulon (Pocket WiFi 3.0, Pocket LAN vagy DataHub) keresztül érhető el, amely az RTU-t a 502-es porton TCP-re hidalja. Távoli telepítésekhez a TapHome harmadik féltől származó RS-485-Ethernet átjárón (pl. Waveshare, USR-DR302) is csatlakoztatható, amelyet Modbus RTU-over-TCP-ként konfiguráltak. ## Modellek A TapHome sablon a teljes X3-Ultra sorozatot lefedi. A PV3 és Akkumulátor 2 SOC érzékelők csak a 3-MPPT / kettős akkumulátoros 30 kW-os változaton működnek. | Modell | Névleges AC teljesítmény | MPPT követők | Megjegyzések | |--------|--------------------------|--------------|--------------| | X3-ULT-15K | 15 kW | 2 | Szabványos 2-MPPT | | X3-ULT-15KP | 15 kW | 3 | 3-MPPT (modellkód H3BC) | | X3-ULT-19.9K | 19,9 kW | 2 | Szabványos 2-MPPT | | X3-ULT-20K | 20 kW | 2 | Szabványos 2-MPPT (modellkód H3BD) | | X3-ULT-20KP | 20 kW | 3 | 3-MPPT | | X3-ULT-25K | 25 kW | 3 | Modellkód H3BF | | X3-ULT-25KW | 25 kW | 3 | — | | X3-ULT-30K | 30 kW | 3 | Kettős akkumulátor, PV3 aktív (modellkód H3BG) | | X3-ULT-10K-GLV | 10 kW | — | Alacsony feszültségű változat (GLV) | | X3-ULT-15K-GLV | 15 kW | — | Alacsony feszültségű változat (GLV) | A modellkód futásidőben kiolvasható a **Model** modulattribútumon keresztül (H:0x000E regiszter, 4 karakteres ASCII karakterlánc). ## Kompatibilitási hatókör A sablon a SolaX Modbus V3.29 protokoll azon részhalmazát implementálja, amelyet a leggyakrabban használnak otthoni energiamenedzsmenthez — 19 eszköz, 2 modulszintű szolgáltatási attribútum és egy szolgáltatási művelet. A teljes protokoll sokkal több regisztert tesz közzé; a legjobb nem implementált képességek (fázisonkénti hálózati teljesítmény és áram, akkumulátor feszültség/áram/teljesítmény, BMS állapot, hálózaton kívüli üzemidő, távoli teljesítményvezérlés stb.) egy jövőbeli sablonfrissítésben kerülhetnek hozzáadásra. A TapHome portálon elérhető javított közösségi sablon már tartalmazza a távoli teljesítményvezérlést és a beállítások olyan írását, amely csak az érték változásakor történik meg — lásd lent az Ismert hibák a hivatalos sablonban és a Távoli teljesítményvezérlés részt. ## Hardver csatlakozás Az X3-Ultra egyetlen többfunkciós **COM 1 porttal** rendelkezik (RJ45 stílusú csatlakozó címkézett kábelrögzítővel). Ugyanazok a fizikai csapok különböző funkciókat látnak el attól függően, hogy melyik címkézett pozícióba köti be a kábelrögzítőn. Harmadik féltől származó Modbus integrációhoz használja az **RS485** pozíciót — a **REMOTE_485A** és **REMOTE_485B** vezetékeket. ### COM 1 port pinout ![A SolaX X3-Ultra COM 1 port csap kiosztása mind a hat címkézett pozíció esetében (Parallel-1, Parallel-2, BMS-1, BMS-2, RS485, DRM)](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/com1-pinout_hu_4124a3cd9e8bc981.jpg) A **RS485 pozíció** csap kiosztása (az egyetlen TapHome szempontjából releváns pozíció): | Csap | Jel | TapHome bekötés | |------|-----|-----------------| | **1** | **REMOTE_485A** | A+ / D+ | | **2** | **REMOTE_485B** | B− / D− | | 3 | PARALLEL_485AA | ne használja (csak SolaX kiegészítőkhez) | | 4 | PARALLEL_485AA | ne használja (csak SolaX kiegészítőkhez) | | 5 | PARALLEL_485BB | ne használja (csak SolaX kiegészítőkhez) | | 6 | PARALLEL_485BB | ne használja (csak SolaX kiegészítőkhez) | | **7** | **REMOTE_485A** | az 1. csap duplikátja (daisy-chain-hez) | | **8** | **REMOTE_485B** | a 2. csap duplikátja (daisy-chain-hez) | > [!WARNING] > A 3–6. csapok a SolaX-saját PARALLEL_485 csatornához tartoznak, és SolaX kiegészítők (Adapter Box G2, EV-Charger, DataHub, párhuzamos inverterek) számára vannak fenntartva. **Ne csatlakoztasson** harmadik féltől származó Modbus mastert ezekhez a csapokhoz. > [!NOTE] > A régebbi SolaX inverterek (Gen4 X3-Hybrid) a **4. csap = 485A** és **5. csap = 485B** elrendezést használták. Az X3-Ultra COM 1 pinoutja különböző — krimpelés előtt mindig ellenőrizze a kábelrögzítő címkézését a saját egységén. Egyes közösségi dokumentációk még mindig a régebbi Gen4 pinoutra hivatkoznak. ### RS-485 bekötés ![Az RJ45 terminál telepítése a COM 1 kábelrögzítő RS485 pozíciójába](https://taphome.com/images/compatibility/solax-hybrid-ultra-x3/wiring-rs485_hu_ac07cf89af382c1.jpg) Bekötési szabályok az X3-Ultra felhasználói kézikönyvből (8.6.4. fejezet): - **Kábel típusa:** szabványos Cat5 vagy Cat6 UTP sodrott érpár - **Maximális hossz:** **30 m** RS-485 kábel az inverter és a TapHome CCU között - **A polaritás számít:** ha nincs kommunikáció, cserélje fel A-t és B-t - **Egyetlen Modbus master:** a buszon csak egy master engedélyezett. Ha egy SolaX monitorozó modul osztja a vonalat, ütközésekre számíthat A COM 1 kábelrögzítőn dedikált címkézett pozíciók vannak minden csatornához — kösse be a Cat5/Cat6 kábelt az **RS485** címkével ellátott helyre (ne a Parallel-1, Parallel-2, BMS-1, BMS-2 vagy DRM pozícióba). ### Csatlakozási lehetőségek - **Közvetlen Modbus RTU CCU:** kösse be a COM 1 RS485 párt közvetlenül a TapHome Modbus RTU CCU-ra. Legkisebb késleltetés, valós idejű vezérléshez ajánlott. - **RS-485-Ethernet átjáró (Modbus RTU-over-TCP):** olyan telepítésekhez, ahol az inverter távol van a TapHome Core-tól, használjon Waveshare RS485-Ethernet, USR-DR302 vagy hasonló átjárót, Modbus RTU-over-TCP-ként konfigurálva az 502-es porton. A sablon `IpAddress` importparamétere alkalmas erre a mintázatra. - **SolaX Pocket WiFi 3.0 / Pocket LAN / DataHub (Modbus TCP):** ha a SolaX monitorozó modul már telepítve van, az RTU-t TCP-re hidalja az 502-es porton kb. 1 másodperces lekérdezési ciklussal — lassabb mint a közvetlen RTU, és nem ajánlott valós idejű vezérlési hurkokhoz. ## Konfiguráció ### A Modbus kommunikáció engedélyezése az inverteren Az inverter LCD-jén navigáljon ide: ``` Menu → Setting → Advance Setting → Modbus ``` Az Advanced Settings menü telepítői jelszót igényelhet. Ellenőrizze vagy állítsa be az alábbiakat: | Paraméter | TapHome sablon alapértelmezett | Inverter alapértelmezett | Tartomány | |-----------|--------------------------------|--------------------------|-----------| | Modbus cím (Slave ID) | 1 | 1 | 1–255 | | Baudráta | 19200 | 19200 | 9600 / 19200 / 38400 / 57600 / 115200 | | Paritás | None | None | None / Odd / Even | | Adatbitek | 8 | 8 | — | | Stopbitek | 1 | 1 | 1 vagy 2 | > [!WARNING] > A baudrátának egyeznie kell az inverter és a TapHome között. A V3.29 protokoll **19200**-at ad meg X3-Ultra alapértelmezettnek; egyes régebbi SolaX sablonok és dokumentációk még 9600-at említenek. Ha a kommunikáció sikertelen, először a baudrátát ellenőrizze. Az inverter a Modbus slave címet a `H:0x00AC` holding regiszteren keresztül és a baudrátát a `H:0x00AD` holding regiszteren keresztül is közzéteheti. ### Importparaméterek a TapHome-ban A sablon TapHome-ba történő importálásakor két paramétert kell beállítani: | Paraméter | Cél | |-----------|-----| | **IpAddress** | Az RS-485-TCP átjáró (vagy a SolaX Pocket WiFi / LAN monitorozó modul) IP-címe. Hagyja alapértelmezetten, ha az inverter közvetlenül csatlakozik a TapHome Modbus RTU CCU-hoz. | | **SlaveId** | Az inverter Modbus slave címe (alapértelmezetten `1`). Egyeznie kell az inverter Modbus cím beállításával. | ### Kommunikáció időzítése A SolaX Modbus protokoll minimális intervallumot igényel az egymást követő kérések között, és minden eszközhöz egyéni lekérdezési intervallumot használ a sablonban (néhány másodperctől a hálózati feszültség/frekvencia esetén 80 másodpercig az akkumulátor hőmérséklet esetén). Ne kérdezzen le agresszíven egyetlen eszközt sem — az inverter belsőleg fékezi a kéréseket. ## Eszköz képességek ### Akkumulátor monitorozás - **Akkumulátor 1 SOC** — az elsődleges akkumulátor töltöttségi állapota 0–1 analóg bemenetként (nyers regiszter 1%-os egységekben, osztva 100-zal a TapHome 0–1 tartomány érdekében) - **Akkumulátor 2 SOC** — a második akkumulátor töltöttségi állapota, **csak az X3-ULT-30K** kettős akkumulátoros változaton működik; más modellek 0-t olvasnak - **Akkumulátor hőmérséklete** — az akkumulátor csomag hőmérséklete °C-ban, 80 másodpercenként lekérdezve ### Napelem PV teljesítmény - **PV1 teljesítmény (kelet)** — DC teljesítmény kimenet a PV string 1-ből kW-ban - **PV2 teljesítmény (kelet)** — DC teljesítmény kimenet a PV string 2-ből kW-ban - **PV3 teljesítmény (nyugat)** — DC teljesítmény kimenet a PV string 3-ból kW-ban, **csak 3-MPPT modelleken** (lásd a modelltáblázatot) működik; más modellek 0-t olvasnak A „kelet" / „nyugat" utótagok irányítás-elnevezési konvenció, amelyet az eredeti szlovák sablonból örököltünk — a PV string száma az inverter fizikai MPPT bemenetének felel meg, nem a tényleges mező orientációjának. ### Hálózati és energia mérés - **Hálózati feszültség L1 / L2 / L3** — fázisonkénti hálózati feszültség voltban (regiszterek `A:0x006A`, `A:0x006E`, `A:0x0072`) - **Hálózati frekvencia L1 / L2 / L3** — fázisonkénti hálózati frekvencia hertzben (regiszterek `A:0x006D`, `A:0x0071`, `A:0x0075`) - **Hálózati betáplálási teljesítmény (mérő)** — a külső SolaX mérő / CT betáplálási teljesítményét kellene mutatnia, de a hivatalos sablon az `A:0x0046` regisztert rossz szósorrenddel olvassa (`Int32` a `LittleEndianInt32` helyett), így az érték értelmetlen (például −7340,033 a −0,117 kW helyett). Nem a Hálózati import / export teljesítmény aliasza — használja azt az eszközt, vagy javítsa ki a szkriptet az Ismert hibák a hivatalos sablonban részben leírtak szerint - **Hálózati import / export teljesítmény** — a mérő / CT teljesítményének helyes kiolvasása (`A:0x0046`, `LittleEndianInt32`) kW-ban; pozitív = export, negatív = import - **Napi / aktuális inverter termelés** — a hivatalos sablonban a mai inverterenergiát (`A:0x0050` regiszter, napi számláló, amely minden éjjel nullázódik) kombinálja az `A:0x0002` regiszterrel, amelyet a SolaX csak az egyfázisú X1 modellekhez dokumentál — az X3-Ultra-n 0-t olvas. A javított szkripteket az Ismert hibák a hivatalos sablonban részben találja - **Teljes megtermelt energia** — az inverter AC portjáról a hálózatba szállított teljes kumulatív energia kWh-ban ### Töltő- és betáplálás-vezérlés (írható) - **Töltési mód** — az akkumulátortöltő üzemmódja: Self Use, Feed-in Priority, Backup vagy Manual - **Éjszakai töltési SOC (saját felhasználás)** — felső SOC célérték (10–100%) az akkumulátor hálózatról történő éjszakai töltéséhez saját felhasználási módban - **Max. betáplálási teljesítményhatár** — a hálózatba engedélyezett maximális export teljesítmény **kW-ban** (nem százalékban): a regiszter az X3 modelleken 10 W-os lépésekben számol, és a sablon 100-zal oszt > [!WARNING] > **Az EEprom írási korlát érvényes** a fenti mind a három írható eszközre (Töltési mód → `SH:0x001F`, Éjszakai töltési SOC → `SH:0x0063`, Max. betáplálási teljesítmény → `SH:0x0042`). A mögöttes regiszterek EEprom-alapúak korlátozott írási ciklusokkal — a gyakori írások (néhány másodpercenként egy automatizálási ciklusban) tartósan károsítják az inverter EEprom-ját. Csak manuális változtatásokat vagy alacsony frekvenciájú tervezett írásokat használjon. ### Modulszintű attribútumok és műveletek - **Üzemmód** (szolgáltatási attribútum) — az inverter üzemi állapota szöveges formában: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby - **Modell** (szolgáltatási attribútum) — az inverter modellkódja 4 karakteres ASCII karakterláncként (H3BC = 15K/15KP, H3BD = 19,9K/20K/20KP, H3BF = 25K, H3BG = 30K) - **Adminisztrátor feloldása** (szolgáltatási művelet) — a `2014` konstanst írja az `SH:0x0000` regiszterbe a fejlett inverter beállítások feloldásához (ritkán szükséges, csak diagnosztikához) ### Hibafelismerés A modul ReadScriptje figyeli az Üzemmód regisztert (`A:0x0009`) és TapHome rendszerhibát jelent, amikor az inverter 3. állapotba (Fault) vagy 4. állapotba (Permanent Fault) lép. Két hibaregisztert bitenként elemez: - **Inverter hibakódok** (32 bites, `A:0x0040`–`A:0x0041`) — 31 egyedi hiba, beleértve a hálózati feszültség/frekvencia hibákat, PV feszültség hibákat, akkumulátor hibákat, szigetelési hibákat, túlmelegedést, túláram-védelmet, relé hibákat és kommunikációs hibákat - **Manager hibakódok** (16 bites, `A:0x0043`) — 11 hibabit, beleértve a teljesítmény-típus hibákat, EEPROM hibákat, NTC szenzor problémákat, akkumulátor hőmérséklet figyelmeztetéseket, mérő hibákat és ventilátor hibákat Az egyes hibák diszkrét hibákként jelennek meg a TapHome rendszerlogban, így a telepítők azonosíthatják a hibás alrendszert anélkül, hogy az inverter LCD-jét olvasniuk kellene. ## Ismert hibák a hivatalos sablonban Az X3-Ultra hivatalos TapHome sablonja több regisztert hibásan olvas, és egy beállítást időszakosan ír (a SolaX Modbus V3.29 és V001.02 protokoll, valamint telepített rendszerek értékei alapján ellenőrizve). A hivatalos sablonból importált modul a sablon változásakor **nem frissül magától**. Vagy javítsa ki kézzel a meglévő modul és eszközei szkriptjeit, vagy importálja a javított közösségi sablont a TapHome portálról: [SolaX X3-Ultra Hybrid Inverter — monitoring and power control](https://portal.taphome.com/portal/community/solax-x3-ultra-power-control-modbus-rtu) (jelentkezzen be, töltse le az XML-t, és importálja új modulként). **[SolaX X3-Ultra Hybrid Inverter — monitoring and power control (Modbus RTU)](https://portal.taphome.com/hu/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. | Hol | Hivatalos szkript | Javított szkript | A hiba hatása | |-----|-------------------|------------------|---------------| | Modul — olvasási szkript | `var x3 := MODBUSR(A, 0x0040, Uint32);` | `var x3 := MODBUSR(A, 0x0040, LittleEndianUint32);` | A 32 bites hibakód két fele fel van cserélve: az 1. bit hibája (Grid Lost Fault) 17. bitként (Bat Power Low) jelenik meg. A Parallel Fault (21. bit) és a Hard Limit Fault (22. bit) egyáltalán nem jelenik meg | | Hálózati betáplálási teljesítmény (mérő) | `MODBUSR(A,0x0046, Int32)/1000` | `MODBUSR(A, 0x0048, LittleEndianUint32) / 100` — a hálózatba betáplált teljes energia kWh-ban | A teljesítményt már helyesen olvassa a Hálózati import / export teljesítmény; ez az eszköz értelmetlen számot mutat. A hálózatból vételezett teljes energia: `MODBUSR(A, 0x004A, LittleEndianUint32) / 100` | | Napi / aktuális inverter termelés — teljes fogyasztás | `MODBUSR(A, 0x50, UInt16) /10` | `MODBUSR(A, 0x0094, LittleEndianUint32) / 10` | A 0x0050 napi számláló, amely minden éjjel 0-ra esik; a 0x0094 a teljes PV energia | | Napi / aktuális inverter termelés — igény | `MODBUSR(A,0x02, Int16)/1000` | `(MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16) + MODBUSR(A, 0x0124, UInt16)) / 1000` | A 0x0002 az egyfázisú X1 modellek hálózati teljesítménye, az X3-Ultra-n 0-t olvas | | Akkumulátor hőmérséklete | `MODBUSR(A,0x0018, UInt16)` | `MODBUSR(A, 0x0018, Int16)` | 0 °C alatt a hivatalos sablon kb. 65535 °C-ot mutat | | Éjszakai töltési SOC (saját felhasználás) — írási szkript | `MODBUSW(SH, 0x0063, Uint16, Le * 100)` bekapcsolt időszakos írással | `IF(MODBUSR(H, 0x0094, UInt16) != ROUND(Le * 100), MODBUSW(SH, 0x0063, Uint16, ROUND(Le * 100)));` | A hivatalos eszköz minden lekérdezéskor (kb. 55 másodpercenként) beírja az éjszakai töltési célt az inverterbe — a 0x0063 egy EEPROM regiszter kb. 1 millió írási ciklussal. A javított szkripttel csak akkor ír, ha az érték valóban megváltozik | A `H:0x0094` regiszter a V3.29 protokollban is az éjszakai töltés cél töltöttségi állapota (SelfUse_NightCharge_UpperSoC); a hálózatról történő éjszakai töltést a `H:0x0093` alsó bájtja kapcsolja be (írási regiszter: `0x0062`). ## Távoli teljesítményvezérlés A javított közösségi sablon hozzáadja a **Remote control - AC power target** eszközt. A SolaX távvezérlés (VPP) 1-es üzemmódját használja: pozitív kW-os célérték esetén az inverter teljesítményt vesz fel az AC portján (tölti az akkumulátort, a hálózatból is, ha a PV nem elég), negatív célérték esetén teljesítményt ad le (kisüti az akkumulátort, és amit a ház nem használ fel, az a hálózatba kerül); a 0 befejezi a távvezérlést. A sablon szükség esetén feloldja az inverter beállításait a 2014-es alapértelmezett jelszóval, és 60 másodpercenként megismétli a parancsot. A távvezérlés nem indul el, amíg az inverter Manual üzemmódban van. > [!WARNING] > A SolaX a protokolljában nem jelöli EEPROM regiszterként a távvezérlési regisztereket (0x007C–0x0088), de írásban az ellenkezőjét sem erősíti meg. Ez a sablon a Home Assistant és az openHAB közösségek tapasztalatára támaszkodik, amelyek ezeket a regisztereket néhány másodperctől néhány percig terjedő időközönként írják. A fenti beállítások EEPROM regiszterek (a SolaX ★ jellel jelöli őket, kb. 1 millió írási ciklus): ritkán módosítsa őket, és soha ne gyakori automatizálásokból — a spot árak szerinti töltéshez és kisütéshez használja a távvezérlés AC teljesítmény célértékét. ## Hibaelhárítás ### Nincs kommunikáció az inverterrel 1. Ellenőrizze, hogy az RS-485 bekötés a **REMOTE_485A / REMOTE_485B** csapokon van (1+2 vagy 7+8 a COM 1 RS485 pozícióban), nem a PARALLEL_485 3–6 csapokon 2. Ellenőrizze, hogy a baudráta egyezik az inverter (`Menu → Setting → Advance Setting → Modbus`) és a TapHome modul között — mindkettőnek alapértelmezetten 19200-nak kell lennie 3. Erősítse meg, hogy a Slave ID egyezik (alapértelmezetten `1`) 4. Ellenőrizze, hogy csak **egyetlen** Modbus master van csatlakoztatva az RS-485 buszhoz — a Modbus nem támogatja a multi-mastert 5. Cserélje fel az A és B vezetékeket, ha a kábel polaritása bizonytalan 6. Erősítse meg, hogy a kábel nem haladja meg a **30 m** teljes RS-485 hosszt ### A PV3 vagy az Akkumulátor 2 SOC nullát olvas Ezek az eszközök csak az **X3-ULT-30K**-n (3-MPPT / kettős akkumulátor változat) működnek. Kisebb modelleken az `A:0x0124` (PV3 teljesítmény) és `A:0x012D` (Akkumulátor 2 SOC) regiszterek nullát adnak vissza. Nem 30K-s telepítésekhez rejtse el a nem használt eszközöket a TapHome UI-jában. ### Az akkumulátor hőmérséklet váratlanul magas értéket olvas Az akkumulátor hőmérséklet regiszterét (`A:0x0018`) a hivatalos sablon `UInt16`-ként olvassa, de az érték előjeles. A 0 °C alatti hőmérsékletek (pl. −1 °C) nagy pozitív értékekre csavarodnak vissza (pl. 65535). Módosítsa a szkriptet erre: `MODBUSR(A, 0x0018, Int16)` — lásd az Ismert hibák a hivatalos sablonban részt. ### A Töltési mód / Éjszakai töltési SOC / Max. betáplálás írásai nem érvényesülnek Ezek a regiszterek EEprom-alapúak és az inverter korlátozza az írásokat az EEprom védelme érdekében. Biztosítsa, hogy az írások ritkák legyenek (manuális vagy tervezett, nem szoros automatizálási ciklusban). Egyes firmware verziók azt is megkövetelik, hogy a Töltési mód **Manual** (`3`) értékre legyen állítva, mielőtt bizonyos kényszerített töltési / kisütési alműködési módok reagálnának. ### A Modbus TCP a SolaX monitorozó modulon keresztül lassú A Pocket WiFi 3.0 / Pocket LAN / DataHub az RTU-t TCP-re hidalja kb. 1 másodperces lekérdezési ciklussal, és egyszerre csak egy Modbus TCP klienst kezel. Ha a SolaX Cloud monitorozás is adatokat húz, ütközésekre számíthat. Valós idejű vezérléshez (frekvencia válasz, csúcs simítás) használjon közvetlen Modbus RTU-t vagy dedikált harmadik féltől származó RS-485-Ethernet átjárót. ## Elérhető eszközök 19 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. SolaX X3 Hybrid Ultra Modul Szerviz attribútumok | | | |---------|----------------------------------------------------------------------------------------------------------------------------------------------| | Üzemmód | Inverter üzemi állapota — Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby | | Modell | Inverter modellkód 4 karakteres ASCII karakterláncként (H3BC = 15K/15KP, H3BD = 19,9K/20K/20KP, H3BF = 25K, H3BG = 30K) | Szerviz műveletek | | | |--------------------------|----------------------------------------------------------------------------------------------------------------------------------------| | Adminisztrátor feloldása | A 2014-es konstanst írja az SH:0x0000 regiszterbe a fejlett inverter beállítások feloldásához — ritkán szükséges, csak diagnosztikához | Olvasás (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")); ``` Szerviz attribútumok 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) ``` Szerviz műveletek Unlock admin ```taphome MODBUSW(SH, 0x0000, Uint16, 2014); ``` Akkumulátor 1 SOC Analóg bemenet Csak olvasható Az elsődleges akkumulátor töltöttségi állapota százalékban (0–100%), TapHome-ban 0–1 analóg bemenetként megjelenítve Regiszter: A:0x001C UInt16 Egység: % numeric Bemeneti szint olvasása ```taphome MODBUSR(A, 0x1C, UInt16)/100 ``` Akkumulátor 2 SOC Analóg bemenet Csak olvasható A második akkumulátor töltöttségi állapota százalékban — csak a kétakkumulátoros X3-ULT-30K változaton működik; más modelleknél 0 érték Regiszter: A:0x012D UInt16 Egység: % numeric Bemeneti szint olvasása ```taphome MODBUSR(A, 0x012D, Uint16) / 100 ``` Teljes megtermelt energia Változó Csak olvasható Az inverter AC portjáról a hálózatba szállított teljes kumulatív energia, kWh-ban Regiszter: A:0x0052 LittleEndianInt32 Egység: kWh numeric Olvasás ```taphome MODBUSR(A, 0x52,LittleEndianInt32) / 10 ``` Napi / aktuális inverter termelés Villanyóra Csak olvasható Hivatalos sablon: a mai inverterenergia (0x0050, minden éjjel nullázódik) és a 0x0002 regiszter, amely csak az X1 modellekhez van dokumentálva, és az X3-Ultra-n 0-t olvas; a javított szkriptek a teljes PV energiát (0x0094) és a PV1 + PV2 + PV3 teljesítményt olvassák Regiszter: A:0x0050, A:0x0002 UInt16, Int16 Egység: kWh / kW numeric Összes fogyasztás olvasása ```taphome MODBUSR(A, 0x50, UInt16) /10 ``` Igény olvasása ```taphome MODBUSR(A,0x02, Int16)/1000 ``` Hálózati betáplálási teljesítmény (mérő) Változó Csak olvasható A hivatalos sablon a mérő / CT teljesítményregiszterét (0x0046) rossz szósorrenddel (Int32) olvassa, így az érték értelmetlen; használja a Hálózati import / export teljesítmény eszközt, vagy módosítsa a szkriptet a hálózatba betáplált energiára (0x0048, LittleEndianUint32, / 100) Regiszter: A:0x0046 Int32 Egység: kW numeric Olvasás ```taphome MODBUSR(A,0x0046, Int32)/1000 ``` Hálózati frekvencia L1 Változó Csak olvasható Regiszter: A:0x006D Int16 Egység: Hz numeric Olvasás ```taphome MODBUSR(A, 0x006D, Int16)/100 ``` Hálózati frekvencia L2 Változó Csak olvasható Regiszter: A:0x0071 Int16 Egység: Hz numeric Olvasás ```taphome MODBUSR(A,0x0071, Int16)/100 ``` Hálózati frekvencia L3 Változó Csak olvasható Regiszter: A:0x0075 Int16 Egység: Hz numeric Olvasás ```taphome MODBUSR(A,0x0075, Int16)/100 ``` Töltési mód Többértékű kapcsoló Olvasás és írás Az akkumulátortöltő üzemmódja — Self Use, Feed-in Priority, Backup vagy Manual. Az írás EEprom-alapú: ne módosítsa gyakran automatizációkból Regiszter: H:0x008B → SH:0x001F UInt16 numeric Értékek / Állapotok: Self Use · Feedin Priority · Backup · Manual · Peak Shaving Kapcsoló állapot olvasása ```taphome MODBUSR(H, 0x008B, Uint16) ``` Kapcsoló állapot írása ```taphome MODBUSW(SH, 0x001F, uint16, Mu) ``` Hálózati feszültség L1 Változó Csak olvasható Regiszter: A:0x006A Int16 Egység: V numeric Olvasás ```taphome MODBUSR(A,0x006A, Int16)/10 ``` Hálózati feszültség L2 Változó Csak olvasható Regiszter: A:0x006E Int16 Egység: V numeric Olvasás ```taphome MODBUSR(A, 0x006E, Int16)/10 ``` Hálózati feszültség L3 Változó Csak olvasható Regiszter: A:0x0072 Int16 Egység: V numeric Olvasás ```taphome MODBUSR(A,0x0072, Int16)/10 ``` Hálózati import / export teljesítmény Változó Csak olvasható Valós idejű hálózati betáplálási / fogyasztási teljesítmény a külső mérőről (0x0046, helyesen LittleEndianInt32-ként olvasva); pozitív értékek exportot, negatív értékek importot jeleznek Regiszter: A:0x0046 LittleEndianInt32 Egység: kW numeric Olvasás ```taphome MODBUSR(A, 0x46,LittleEndianInt32)/1000 ``` PV1 teljesítmény (kelet) Változó Csak olvasható DC teljesítmény az 1. PV stringről, jellemzően a keletre néző mező az eredeti szlovák sablon elnevezésében Regiszter: A:0x000A UInt16 Egység: kW numeric Olvasás ```taphome MODBUSR(A,0x0a, UInt16)/1000 ``` PV2 teljesítmény (kelet) Változó Csak olvasható DC teljesítmény a 2. PV stringről, jellemzően a keletre néző mező az eredeti szlovák sablon elnevezésében Regiszter: A:0x000B UInt16 Egység: kW numeric Olvasás ```taphome MODBUSR(A,0x0b, UInt16)/1000 ``` PV3 teljesítmény (nyugat) Változó Csak olvasható DC teljesítmény a 3. PV stringről — csak a 3-MPPT-s X3-ULT-30K változaton működik; más modelleknél 0 érték Regiszter: A:0x0124 UInt16 Egység: kW numeric Olvasás ```taphome MODBUSR(A, 0x0124, Uint16)/1000 ``` Éjszakai töltési SOC (saját felhasználás) Fényerőszabályzó Olvasás és írás Felső SOC célérték (10–100%) az akkumulátor éjszakai töltéséhez a hálózatról saját felhasználási módban. Az írás EEprom-alapú; a hivatalos sablon minden lekérdezéskor (kb. 55 másodpercenként) beírja — használja azt az írási szkriptet, amely előbb összeveti a 0x0094 regiszterrel Regiszter: H:0x0094 → SH:0x0063 UInt16 Egység: % numeric Szint olvasása ```taphome MODBUSR(H, 0x0094, Uint16) / 100 ``` Szint írása ```taphome MODBUSW(SH, 0x0063, Uint16, Le * 100) ``` Akkumulátor hőmérséklete Hőmérséklet-érzékelő Csak olvasható Regiszter: A:0x0018 UInt16 Egység: °C numeric Hőmérséklet olvasása ```taphome MODBUSR(A,0x0018, UInt16) ``` Max. betáplálási teljesítményhatár Változó Olvasás és írás Maximális megengedett export teljesítmény a hálózatba kW-ban (a regiszter az X3 modelleken 10 W-os lépésekben számol). Az írás EEprom-alapú: ne módosítsa gyakran automatizációkból Regiszter: H:0x00B6 → SH:0x0042 UInt16 Egység: kW numeric Olvasás ```taphome MODBUSR(H, 0x00B6, Uint16)/100 ``` Írás ```taphome MODBUSW(SH, 0x0042, Uint16, Va*100) ``` **Kapcsolat:** Modbus RTU • 19200 baud• 8N1 • Slave ID: $\[SlaveId] Lehetséges fejlesztések (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 ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |--------------------|---------------| | Slave Id | `1` | | IP address | `192.168.1.0` | ## Források - 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 A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket. ## Kapcsolódó dokumentáció - [Modbus Integration](https://taphome.com/hu/compatibility/modbus-guide/) - [Modbus útmutató a TapHome készülékekhez](https://taphome.com/hu/docs/integration/modbus/) - [Egyszerű konfiguráció sablonok használatával](https://taphome.com/hu/docs/integration/modbus/templates/) - [Modbus szkriptek és prefetch](https://taphome.com/hu/docs/script/modbus-scripts/) - [Modbus függvények](https://taphome.com/hu/docs/script/modbus/) - [Modbus adattípusok](https://taphome.com/hu/docs/script/modbus-data-types/)