SolaX X3 Hybrid Ultra (Gen5) je třífázový hybridní PV/bateriový střídač s jmenovitým výkonem od 10 kW do 30 kW. Šablona TapHome komunikuje se střídačem přes Modbus RTU na RS-485 portu COM 1 (piny REMOTE_485A / REMOTE_485B) a implementuje register map protokolu SolaX Modbus V3.29. Čte výkon PV řetězců, stav nabití a teplotu baterie, třífázové napětí a frekvenci sítě, kumulativní a denní energetické součty, výkon dodávky z externího měřiče a vystavuje zapisovatelný režim nabíječky, SOC nočního nabíjení (vlastní spotřeba) a limit max. výkonu dodávky.
X3-Ultra nepodporuje Modbus TCP nativně — TCP je dostupné pouze přes monitorovací modul SolaX (Pocket WiFi 3.0, Pocket LAN nebo DataHub), který přemosťuje RTU na TCP na portu 502. Pro vzdálené instalace lze TapHome připojit také přes bránu RS-485-Ethernet třetí strany (např. Waveshare, USR-DR302) nakonfigurovanou jako Modbus RTU-over-TCP.
Modely
Šablona TapHome pokrývá celou sérii X3-Ultra. Senzory PV3 a SOC baterie 2 jsou funkční pouze na variantě s 3 MPPT / dvěma bateriemi s výkonem 30 kW.
| Model | Jmenovitý AC výkon | MPPT trackery | Poznámky |
|---|---|---|---|
| X3-ULT-15K | 15 kW | 2 | Standardní 2-MPPT |
| X3-ULT-15KP | 15 kW | 3 | 3-MPPT (kód modelu H3BC) |
| X3-ULT-19.9K | 19,9 kW | 2 | Standardní 2-MPPT |
| X3-ULT-20K | 20 kW | 2 | Standardní 2-MPPT (kód modelu H3BD) |
| X3-ULT-20KP | 20 kW | 3 | 3-MPPT |
| X3-ULT-25K | 25 kW | 3 | Kód modelu H3BF |
| X3-ULT-25KW | 25 kW | 3 | — |
| X3-ULT-30K | 30 kW | 3 | Dvě baterie, PV3 aktivní (kód modelu H3BG) |
| X3-ULT-10K-GLV | 10 kW | — | Nízkonapěťová varianta (GLV) |
| X3-ULT-15K-GLV | 15 kW | — | Nízkonapěťová varianta (GLV) |
Kód modelu lze číst za běhu přes modulový atribut Model (registr H:0x000E, 4znakový ASCII řetězec).
Rozsah kompatibility
Šablona implementuje podmnožinu protokolu SolaX Modbus V3.29, která se nejčastěji používá pro domácí řízení energie — 19 zařízení, 2 modulové servisní atributy a jedna servisní akce. Plný protokol vystavuje mnohem více registrů; nejužitečnější neimplementované schopnosti (výkon a proud sítě na jednotlivé fáze, napětí/proud/výkon baterie, stav BMS, doba provozu mimo síť, vzdálené ovládání výkonu atd.) mohou být přidány v budoucí aktualizaci šablony. Opravená komunitní šablona na portálu TapHome už přidává vzdálené ovládání výkonu a zápisy nastavení, které proběhnou jen při změně hodnoty — viz Známé chyby oficiální šablony a Vzdálené ovládání výkonu níže.
Hardwarové připojení
X3-Ultra má jediný víceúčelový port COM 1 (konektor typu RJ45 s označeným kabelovým přípravkem). Tytéž fyzické piny slouží k různým funkcím podle toho, do které označené pozice na kabelovém přípravku zapojíte vodič. Pro integraci Modbus třetí strany použijte pozici RS485 — vodiče REMOTE_485A a REMOTE_485B.
Pinout portu COM 1
Přiřazení pinů pro pozici RS485 (jediná pozice relevantní pro TapHome):
| Pin | Signál | Zapojení TapHome |
|---|---|---|
| 1 | REMOTE_485A | A+ / D+ |
| 2 | REMOTE_485B | B− / D− |
| 3 | PARALLEL_485AA | nepoužívat (pouze pro příslušenství SolaX) |
| 4 | PARALLEL_485AA | nepoužívat (pouze pro příslušenství SolaX) |
| 5 | PARALLEL_485BB | nepoužívat (pouze pro příslušenství SolaX) |
| 6 | PARALLEL_485BB | nepoužívat (pouze pro příslušenství SolaX) |
| 7 | REMOTE_485A | duplikát pinu 1 (pro daisy-chain) |
| 8 | REMOTE_485B | duplikát pinu 2 (pro daisy-chain) |
Piny 3–6 patří proprietárnímu kanálu SolaX PARALLEL_485 a jsou vyhrazeny pro příslušenství SolaX (Adapter Box G2, EV-Charger, DataHub, paralelní střídače). Nepřipojujte k těmto pinům Modbus master třetí strany.
Starší střídače SolaX (Gen4 X3-Hybrid) používaly pin 4 = 485A a pin 5 = 485B. Pinout portu COM 1 X3-Ultra je odlišný — před nakrimpováním vždy zkontrolujte označení kabelového přípravku na vaší jednotce. Některá komunitní dokumentace stále odkazuje na starší pinout Gen4.
Zapojení RS-485
Pravidla zapojení z uživatelského manuálu X3-Ultra (sekce 8.6.4):
- Typ kabelu: standardní kroucený pár Cat5 nebo Cat6 UTP
- Maximální délka: 30 m RS-485 kabelu mezi střídačem a TapHome CCU
- Polarita je důležitá: pokud komunikace neprobíhá, vyměňte A a B
- Jeden Modbus master: na sběrnici je povolen pouze jeden master. Pokud monitorovací modul SolaX sdílí linku, očekávejte konflikty
Kabelový přípravek COM 1 má vyhrazené označené pozice pro každý kanál — kabel Cat5/Cat6 zapojte do otvoru označeného RS485 (ne do Parallel-1, Parallel-2, BMS-1, BMS-2 nebo DRM).
Možnosti připojení
- Přímé Modbus RTU CCU: zapojte dvojici RS485 portu COM 1 přímo do TapHome Modbus RTU CCU. Nejnižší latence, doporučeno pro řízení v reálném čase.
- Brána RS-485-Ethernet (Modbus RTU-over-TCP): pro instalace, kde je střídač daleko od TapHome Core, použijte bránu Waveshare RS485-Ethernet, USR-DR302 nebo podobnou nakonfigurovanou jako Modbus RTU-over-TCP na portu 502. Import parametr šablony
IpAddressto umožňuje. - SolaX Pocket WiFi 3.0 / Pocket LAN / DataHub (Modbus TCP): pokud je monitorovací modul SolaX již nainstalován, přemosťuje RTU na TCP na portu 502 s dotazovacím cyklem přibližně 1 sekunda — pomalejší než přímé RTU a nedoporučuje se pro řídicí smyčky v reálném čase.
Konfigurace
Povolení komunikace Modbus na střídači
Na LCD střídače přejděte na:
| |
Menu Advanced Settings může vyžadovat instalační heslo. Ověřte nebo nastavte následující:
| Parametr | Výchozí hodnoty šablony TapHome | Výchozí hodnoty střídače | Rozsah |
|---|---|---|---|
| Modbus adresa (Slave ID) | 1 | 1 | 1–255 |
| Přenosová rychlost | 19200 | 19200 | 9600 / 19200 / 38400 / 57600 / 115200 |
| Parita | None | None | None / Odd / Even |
| Datové bity | 8 | 8 | — |
| Stop bity | 1 | 1 | 1 nebo 2 |
Přenosová rychlost se musí shodovat mezi střídačem a TapHome. Protokol V3.29 specifikuje 19200 jako výchozí hodnotu X3-Ultra; některé starší šablony a dokumentace SolaX stále uvádějí 9600. Pokud komunikace selže, nejprve zkontrolujte přenosovou rychlost.
Střídač může také vystavit adresu Modbus slave přes holding registr H:0x00AC a přenosovou rychlost přes holding registr H:0x00AD.
Import parametry v TapHome
Při importu šablony do TapHome musí být nastaveny dva parametry:
| Parametr | Účel |
|---|---|
| IpAddress | IP adresa brány RS-485-TCP (nebo monitorovacího modulu SolaX Pocket WiFi / LAN). Ponechte výchozí hodnotu, pokud je střídač připojen přímo k TapHome Modbus RTU CCU. |
| SlaveId | Modbus slave adresa střídače (výchozí 1). Musí se shodovat s nastavením Modbus adresy střídače. |
Časování komunikace
Protokol SolaX Modbus vyžaduje minimální interval mezi po sobě jdoucími požadavky a používá individuální dotazovací intervaly pro každé zařízení v šabloně (od několika sekund pro napětí/frekvenci sítě až po 80 s pro teplotu baterie). Žádné zařízení agresivně nedotazujte — střídač interně omezuje požadavky.
Schopnosti zařízení
Monitorování baterie
- SOC baterie 1 — stav nabití primární baterie jako analogový vstup 0–1 (surový registr v jednotkách 1 %, dělený 100 pro rozsah TapHome 0–1)
- SOC baterie 2 — stav nabití druhé baterie, funkční pouze na X3-ULT-30K s variantou dvou baterií; ostatní modely čtou 0
- Teplota baterie — teplota bateriového balíku ve °C, dotazováno každých 80 sekund
Výkon solárních PV
- Výkon PV1 (východ) — DC výkon z PV řetězce 1 v kW
- Výkon PV2 (východ) — DC výkon z PV řetězce 2 v kW
- Výkon PV3 (západ) — DC výkon z PV řetězce 3 v kW, funkční pouze na modelech s 3 MPPT (viz tabulka modelů); ostatní modely čtou 0
Přípony „východ" / „západ" jsou konvence směrového pojmenování zděděná z původní slovenské šablony — číslo PV řetězce odpovídá fyzickému MPPT vstupu na střídači, ne skutečné orientaci pole.
Měření sítě a energie
- Napětí sítě L1 / L2 / L3 — napětí sítě na jednotlivé fáze ve voltech (registry
A:0x006A,A:0x006E,A:0x0072) - Frekvence sítě L1 / L2 / L3 — frekvence sítě na jednotlivé fáze v hertzech (registry
A:0x006D,A:0x0071,A:0x0075) - Výkon dodávky do sítě (měřič) — měl by ukazovat výkon dodávky z externího SolaX měřiče / CT, ale oficiální šablona čte registr
A:0x0046se špatným pořadím slov (Int32místoLittleEndianInt32), takže hodnota nedává smysl (například −7340,033 místo −0,117 kW). Nejde o alias výkonu odběr / dodávka do sítě — použijte to zařízení, nebo opravte skript podle části Známé chyby oficiální šablony - Výkon odběr / dodávka do sítě — správné čtení výkonu měřiče / CT (
A:0x0046,LittleEndianInt32) v kW; kladné = export, záporné = import - Denní / aktuální výroba střídače — v oficiální šabloně kombinuje dnešní energii střídače (registr
A:0x0050, denní počítadlo, které se každou noc vynuluje) s registremA:0x0002, který SolaX dokumentuje jen pro jednofázové modely X1 — na X3-Ultra čte 0. Opravené skripty najdete v části Známé chyby oficiální šablony - Celková vyrobená energie — celková kumulativní energie dodaná ze střídače přes AC port do sítě v kWh
Ovládání nabíječky a dodávky (zapisovatelné)
- Režim nabíječky — provozní režim nabíječky baterie: Self Use, Feed-in Priority, Backup nebo Manual
- SOC nočního nabíjení (vlastní spotřeba) — horní cílová hodnota SOC (10–100 %) pro noční nabíjení baterie ze sítě v režimu vlastní spotřeby
- Limit max. výkonu dodávky — maximální povolený exportní výkon do sítě v kW (ne v procentech): registr na modelech X3 počítá v krocích po 10 W a šablona ho dělí 100
Limit zápisů do EEprom platí pro všechna tři zapisovatelná zařízení výše (Režim nabíječky →
SH:0x001F, SOC nočního nabíjení →SH:0x0063, Max výkon dodávky →SH:0x0042). Podkladové registry jsou uloženy v EEprom s omezeným počtem zápisů — časté zápisy (každých pár sekund v automatizační smyčce) trvale poškodí EEprom střídače. Používejte pouze manuální změny nebo nízkofrekvenční plánované zápisy.
Modulové atributy a akce
- Provozní režim (servisní atribut) — provozní stav střídače jako text: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle, Standby
- Model (servisní atribut) — kód modelu střídače jako 4znakový ASCII řetězec (H3BC = 15K/15KP, H3BD = 19,9K/20K/20KP, H3BF = 25K, H3BG = 30K)
- Odemknout administrátora (servisní akce) — zapíše konstantu
2014doSH:0x0000pro odemčení pokročilých nastavení střídače (zřídka potřebné, pouze pro diagnostiku)
Detekce chyb
ReadScript modulu monitoruje registr provozního režimu (A:0x0009) a hlásí TapHome systémovou chybu, když střídač vstoupí do stavu 3 (Fault) nebo 4 (Permanent Fault). Dva chybové registry se analyzují bit po bitu:
- Chybové kódy střídače (32-bit,
A:0x0040–A:0x0041) — 31 individuálních chyb včetně chyb napětí/frekvence sítě, chyb napětí PV, chyb baterie, izolačních chyb, přehřívání, ochrany proti přepětí, chyb relé a chyb komunikace - Chybové kódy Manageru (16-bit,
A:0x0043) — 11 chybových bitů včetně chyb typu napájení, chyb EEPROM, problémů senzoru NTC, výstrah teploty baterie, chyb měřiče a chyb ventilátoru
Jednotlivé chyby se zobrazují jako diskrétní chyby v systémovém logu TapHome, takže instalatéři mohou identifikovat selhávající subsystém bez čtení LCD střídače.
Známé chyby oficiální šablony
Oficiální šablona TapHome pro X3-Ultra čte několik registrů nesprávně a jedno nastavení zapisuje periodicky (ověřeno proti protokolu SolaX Modbus V3.29 a V001.02 a proti hodnotám v nainstalovaných systémech). Modul importovaný z oficiální šablony se při změně šablony sám neaktualizuje. Buď ručně opravte skripty existujícího modulu a jeho zařízení, nebo importujte opravenou komunitní šablonu z portálu TapHome: SolaX X3-Ultra Hybrid Inverter — monitoring and power control (přihlaste se, stáhněte XML a importujte ho jako nový modul).
| Kde | Oficiální skript | Opravený skript | Důsledek chyby |
|---|---|---|---|
| Modul — čtecí skript | var x3 := MODBUSR(A, 0x0040, Uint32); | var x3 := MODBUSR(A, 0x0040, LittleEndianUint32); | Dvě poloviny 32bitového chybového kódu jsou prohozené: chyba v bitu 1 (Grid Lost Fault) se hlásí jako bit 17 (Bat Power Low). Parallel Fault (bit 21) a Hard Limit Fault (bit 22) se nehlásí vůbec |
| Výkon dodávky do sítě (měřič) | MODBUSR(A,0x0046, Int32)/1000 | MODBUSR(A, 0x0048, LittleEndianUint32) / 100 — celková energie dodaná do sítě v kWh | Výkon už správně čte Výkon odběr / dodávka do sítě; toto zařízení ukazuje nesmyslné číslo. Celková energie odebraná ze sítě: MODBUSR(A, 0x004A, LittleEndianUint32) / 100 |
| Denní / aktuální výroba střídače — celková spotřeba | MODBUSR(A, 0x50, UInt16) /10 | MODBUSR(A, 0x0094, LittleEndianUint32) / 10 | 0x0050 je denní počítadlo, které každou noc klesne na 0; 0x0094 je celková energie z PV |
| Denní / aktuální výroba střídače — okamžitý odběr | MODBUSR(A,0x02, Int16)/1000 | (MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16) + MODBUSR(A, 0x0124, UInt16)) / 1000 | 0x0002 je výkon sítě jednofázových modelů X1 a na X3-Ultra čte 0 |
| Teplota baterie | MODBUSR(A,0x0018, UInt16) | MODBUSR(A, 0x0018, Int16) | Pod 0 °C oficiální šablona ukazuje přibližně 65535 °C |
| SOC nočního nabíjení (vlastní spotřeba) — zápisový skript | MODBUSW(SH, 0x0063, Uint16, Le * 100) se zapnutým periodickým zápisem | IF(MODBUSR(H, 0x0094, UInt16) != ROUND(Le * 100), MODBUSW(SH, 0x0063, Uint16, ROUND(Le * 100))); | Oficiální zařízení zapisuje cíl nočního nabíjení do střídače při každém dotazování (přibližně každých 55 s) — 0x0063 je registr EEPROM s přibližně 1 milionem zápisových cyklů. S opraveným skriptem zapisuje jen tehdy, když se hodnota opravdu změní |
Registr H:0x0094 je i v protokolu V3.29 cílový stav nabití pro noční nabíjení (SelfUse_NightCharge_UpperSoC); noční nabíjení ze sítě se zapíná v dolním bajtu H:0x0093 (zápisový registr 0x0062).
Vzdálené ovládání výkonu
Opravená komunitní šablona přidává zařízení Remote control - AC power target. Využívá režim 1 vzdáleného ovládání SolaX (VPP): kladný cíl v kW způsobí, že střídač odebírá výkon na svém AC portu (nabíjí baterii, ze sítě, pokud PV nestačí), záporný cíl způsobí, že výkon dodává (vybíjí baterii a co dům nespotřebuje, jde do sítě); 0 vzdálené ovládání ukončí. Šablona v případě potřeby odemkne nastavení střídače výchozím heslem 2014 a příkaz opakuje každých 60 s. Vzdálené ovládání se nespustí, dokud je střídač v pracovním režimu Manual.
SolaX v protokolu neoznačuje registry vzdáleného ovládání (0x007C–0x0088) jako registry EEPROM, ale ani písemně nepotvrzuje opak. Tato šablona se opírá o zkušenosti komunit Home Assistant a openHAB, které tyto registry zapisují každých několik sekund až minut. Výše uvedená nastavení jsou registry EEPROM (SolaX je označuje ★, přibližně 1 milion zápisových cyklů): měňte je zřídka a nikdy z častých automatizací — pro nabíjení a vybíjení podle spotových cen použijte cíl AC výkonu vzdáleného ovládání.
Řešení problémů
Žádná komunikace se střídačem
- Ověřte, že RS-485 zapojení je na pinech REMOTE_485A / REMOTE_485B (1+2 nebo 7+8 na pozici COM 1 RS485), ne na pinech PARALLEL_485 3–6
- Zkontrolujte, že přenosová rychlost se shoduje mezi střídačem (
Menu → Setting → Advance Setting → Modbus) a modulem TapHome — výchozí by mělo být oba 19200 - Potvrďte, že Slave ID se shoduje (výchozí
1) - Ověřte, že na RS-485 sběrnici je připojen pouze jeden Modbus master — Modbus nepodporuje multi-master
- Vyměňte vodiče A a B, pokud je polarita kabelu nejistá
- Potvrďte, že kabel nepřesahuje 30 m celkové délky RS-485 trasy
PV3 nebo SOC baterie 2 čte nulu
Tato zařízení jsou funkční pouze na X3-ULT-30K (3-MPPT / varianta dvou baterií). Na menších modelech registry A:0x0124 (výkon PV3) a A:0x012D (SOC baterie 2) vrátí nulu. Pro instalace bez 30K skryjte nepoužívaná zařízení v UI TapHome.
Teplota baterie čte neočekávaně vysokou hodnotu
Registr teploty baterie (A:0x0018) oficiální šablona čte jako UInt16, ale hodnota je znaménková. Teploty pod nulou (např. −1 °C) se přetočí na velké kladné hodnoty (např. 65535). Změňte skript na MODBUSR(A, 0x0018, Int16) — viz Známé chyby oficiální šablony.
Zápisy do režimu nabíječky / SOC nočního nabíjení / max. výkonu dodávky se neuplatňují
Tyto registry jsou uloženy v EEprom a střídač omezuje zápisy, aby chránil EEprom. Zajistěte, aby byly zápisy zřídka (manuální nebo plánované, ne v těsné automatizační smyčce). Některé verze firmware také vyžadují, aby byl režim nabíječky nastaven na Manual (3), dříve než budou reagovat určité podrežimy nucení nabíjení / vybíjení.
Modbus TCP přes monitorovací modul SolaX je pomalý
Pocket WiFi 3.0 / Pocket LAN / DataHub přemosťují RTU na TCP s dotazovacím cyklem přibližně 1 sekunda a zvládají pouze jednoho Modbus TCP klienta najednou. Pokud monitoring SolaX Cloud také získává data, očekávejte konflikty. Pro řízení v reálném čase (frekvenční odezva, peak shaving) použijte přímé Modbus RTU nebo dedikovanou bránu RS-485-Ethernet třetí strany.
