SolaX X3-Ultra (X3-ULT-15K, 20K, 25K, 30K) je třífázový hybridní střídač pro FV a baterii. Tato komunitní šablona od Martina Kellera jej připojuje k TapHome přes Modbus RTU na RS-485 portu COM 1 (19200 baud, 8N1) a vychází z čtecích registrů protokolu SolaX Modbus V3.29 a z protokolu SolaX Modbus V001.02. Poskytuje úplnou sadu měřičů pro Energy Dashboard, monitorování baterie, sítě a poruch, nastavení střídače, která se zapisují jen tehdy, když se jejich hodnota skutečně změní, a vzdálené řízení AC výkonu (režim 1 vzdáleného ovládání SolaX) — nabíjení baterie ze sítě nebo její vybíjení do sítě na povel, například podle spotových cen elektřiny.
Jak získat šablonu
Komunitní šablony se v seznamu šablon aplikace TapHome nenabízejí. Přihlaste se na portal.taphome.com, stáhněte XML této šablony a importujte jej do Core na rozhraní Modbus RTU (nebo na rozhraní Modbus TCP, pokud se použije brána RS-485-Ethernet). Pro monitorování bez vzdáleného řízení výkonu je k dispozici oficiální šablona SolaX X3 Hybrid Ultra. Modul importovaný dříve z oficiální šablony se sám neaktualizuje — importujte tuto šablonu jako nový modul a starý odstraňte.
Hardwarové připojení
X3-Ultra má jediný víceúčelový port COM 1 (konektor RJ45 s označeným kabelovým přípravkem). Tytéž fyzické piny slouží k různým funkcím podle toho, která označená pozice kabelového přípravku se použije. 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ů pozice 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 | stejný signál jako pin 1 |
| 8 | REMOTE_485B | stejný signál jako pin 2 |
Piny 3–6 patří kanálu SolaX PARALLEL_485 a jsou vyhrazeny pro produkty SolaX (Adapter Box G2, EV-Charger, DataHub). Piny 1, 2, 7 a 8 jsou určeny pro jiná zařízení než produkty SolaX. K pinům 3–6 nepřipojujte Modbus master třetí strany.
Zapojení RS-485

Pravidla zapojení z uživatelského manuálu X3-Ultra (sekce 8.6.4):
- Typ kabelu: síťový kabel CAT5E nebo CAT6
- Maximální délka: komunikační kabel RS-485 nesmí přesáhnout 30 m
- RJ45 terminál: původní konektor kabelu se odstřihne a podle přiřazení pinů se nakrimpuje nový RJ45 terminál; ne všechna zařízení přijmou plně zapojený 8pinový síťový kabel
- Pozice v kabelovém přípravku: RJ45 terminál patří do otvoru označeného RS485 (ne do Parallel-1, Parallel-2, BMS-1, BMS-2 ani DRM); konektor zacvakne do portu COM 1 a zajistí se převlečnou maticí
- Jeden Modbus master: port smí používat jen jeden Modbus master. Jiné monitorování Modbus na stejném portu odpojte, jinak střídač odpovídá oběma a hodnoty jsou nestabilní
Uživatelský manuál neuvádí pravidlo pro zakončení sběrnice RS-485 na pozici RS485 portu COM 1.
Elektroměr nebo CT pro hodnoty sítě
Zařízení sítě v této šabloně (Grid - power balance, Ze sítě, Do sítě, Spotřeba) čtou výkon dodávky do sítě, který střídač měří vlastním elektroměrem nebo CT. Elektroměr nebo CT se zapojuje do portu COM 2 (Meter/CT: METER_485A na pinu 4, METER_485B na pinu 5, nebo vstupy CT) a nastavuje se na displeji střídače v Menu → Setting → Advance Setting → Meter/CT Setting. Je to samostatná linka RS-485 — TapHome k ní nepřipojujte.
Možnosti připojení
- Přímé Modbus RTU: zapojte pár RS485 portu COM 1 přímo na sběrnici RS-485 řídicí jednotky TapHome Core. Nejnižší latence, doporučeno pro vzdálené řízení výkonu.
- Brána RS-485-Ethernet: pokud je střídač daleko od TapHome Core, lze na pár RS485 portu COM 1 použít bránu RS-485-Ethernet třetí strany; šablona se pak importuje na rozhraní Modbus TCP.
- Monitorovací modul SolaX: samotný střídač Modbus TCP nepodporuje. Modbus TCP (port 502) je dostupný jen přes monitorovací modul SolaX, s dotazovacím cyklem přibližně 1 sekunda (protokol V3.29).
Konfigurace
Povolení komunikace Modbus na střídači
Na LCD střídače přejděte na:
| |
Menu Advance Setting vyžaduje heslo instalátora (podle uživatelského manuálu na začátku 2014; manuál doporučuje heslo změnit). V menu Modbus nastavte Baud Rate a Address externího komunikačního protokolu:
| Parametr | Výchozí hodnota šablony | Výchozí hodnota střídače (protokol V3.29) |
|---|---|---|
| Modbus adresa (Slave ID) | 1 | 1 |
| Přenosová rychlost | 19200 | 19200 |
| Parita | None | None |
| Datové bity | 8 | 8 |
| Stop bity | 1 | 1 |
Přenosová rychlost musí být stejná na střídači i na rozhraní Modbus RTU v TapHome. Pokud komunikace selže, nejprve zkontrolujte přenosovou rychlost.
Střídač hlásí Modbus adresu také v holding registru H:0x00AF a přenosovou rychlost v holding registru H:0x00B0 (protokol V3.29).
Parametr importu
Při importu šablony se parametr importu Modbus Slave ID (výchozí 1) musí shodovat s Modbus adresou nastavenou na displeji střídače.
Schopnosti zařízení
Energy Dashboard
| Zařízení | Čtení |
|---|---|
| FV Výroba | Výkon vstupů PV1 + PV2 + PV3 (A:0x000A, A:0x000B, A:0x0124) v kW; celková energie z FV (A:0x0094–0x0095) v kWh. Výkon PV1–PV3 a celková energie na AC výstupu střídače (A:0x0052) jsou servisní atributy. |
| Ze sítě / Do sítě | Odběrová a dodávková část výkonu sítě z elektroměru nebo CT (A:0x0046–0x0047, nejprve nižší slovo) s počítadly celkové energie (A:0x004A a A:0x0048, 0,01 kWh). |
| Do baterie / Z baterie | Nabíjecí a vybíjecí část výkonu baterie 1 (A:0x0016) s celkovou nabitou a vybitou energií (A:0x0021, A:0x001D). |
| Spotřeba | Vypočtená spotřeba domu: AC výkon střídače mínus dodávka do sítě. SolaX nemá registr spotřeby; zátěž na výstupu EPS (záložním) se nezapočítává. |
| Baterie (SOC) | Stav nabití baterie 1 (A:0x001C). Zbývající a dobíjitelná energie (A:0x0118, A:0x0116) jsou servisní atributy. |
Energetický manažer
Pro smart rule Energetický manažer vyberte Grid - power balance. Hodnota má znaménko: kladná při odběru ze sítě, záporná při dodávce přebytku. Měřiče Ze sítě a Do sítě nikdy nejsou záporné a přebytek neukazují.
Monitorování
- Battery 2 - state of charge — druhý bateriový vstup (BAT 2), jeho výkon a teplota jsou servisní atributy; bez druhé baterie čte 0
- Battery - temperature — čte se jako hodnota se znaménkem, takže teploty pod 0 °C se zobrazují správně
- Inverter - AC power — součet výkonů tří fází na AC portu střídače v kW
- Grid - voltage L1 — napětí sítě L2, L3 a tři frekvence sítě jsou servisní atributy
Nastavení střídače
| Zařízení | Čtení | Zápis |
|---|---|---|
| Settings - work mode | H:0x008B: Self use, Feed-in priority, Backup, Manual, Peak shaving, Time of use (poslední dva závisí na firmwaru) | 0x001F |
| Settings - manual mode | H:0x008C: Stop charge and discharge, Force charge, Force discharge (účinné jen v pracovním režimu Manual) | 0x0020 |
| Settings - self-use minimum SOC | horní bajt H:0x0093 | 0x0061 |
| Settings - night charge from grid | dolní bajt H:0x0093 | 0x0062 |
| Settings - night charge target SOC | H:0x0094 | 0x0063 |
| Settings - export limit | H:0x00B6, v kW (na X3 10 W na jednotku) | 0x0042 |
SolaX tato nastavení čte z jiných adres, než na které je zapisuje, proto nelze použít vestavěnou funkci TapHome „zapisovat jen při změně“. Každý zápisový skript proto nastavení nejprve přečte a zapíše je (funkce 06) jen tehdy, když se nová hodnota liší; když střídač hlásí nastavení jako zamčená, nejprve zapíše heslo nastavení 2014 do registru 0x0000. Minimální SOC a cíl nočního nabíjení nikdy neklesnou pod 10 % (rozsah SolaX). Žádné z těchto zařízení nezapisuje periodicky.
Tato 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 Remote control - AC power target.
Remote control - AC power target
Toto zařízení využívá režim 1 vzdáleného ovládání SolaX (VPP) — řízení výkonu na AC portu střídače.
- Znaménko: kladný cíl znamená, že střídač odebírá výkon na svém AC portu (nabíjí baterii, ze sítě, pokud FV nestačí); záporný cíl znamená, že výkon dodává (vybíjí baterii a co dům nespotřebuje, jde do sítě). Hodnota v kW.
- 0 ukončí vzdálené ovládání: šablona jednou zapíše režim 0 a střídač se vrátí do svého pracovního režimu. Cíle pod 0,5 W se počítají jako 0.
- Jakákoli jiná hodnota: pokud je střídač zamčený, šablona nejprve zapíše heslo nastavení 2014 (odemčení se ztratí po každém restartu střídače), potom zapíše 13 registrů
0x007C–0x0088jedním požadavkem Modbus (funkce 0x10): režim 1, cíl, trvání 120 s a timeout 60 s. Dokud cíl není 0, příkaz se opakuje každých 60 s. Pokud jej TapHome přestane posílat, střídač drží cíl nejvýše 2 minuty, další 1 minutu drží na AC portu 0 W a potom se sám vrátí do svého pracovního režimu. - Pracovní režim Manual blokuje vzdálené ovládání. SolaX nespustí vzdálené ovládání, dokud je střídač v pracovním režimu Manual — nejprve jej přepněte na Self use (nebo jiný režim).
- Střídač omezí cíl na rozsah zobrazený v atributech modulu (minimální a maximální cíl vzdáleného ovládání).
- Akce modulu End remote control okamžitě zapíše režim 0. Dokud cíl není 0, další opakování vzdálené ovládání znovu spustí — pro trvalé zastavení nastavte cíl na 0.
- Toto zařízení nekombinujte se vzdáleným ovládáním ze SolaX Cloud ani od energetického agregátora: dokud je cíl 0, šablona do 60 s ukončí jakýkoli režim vzdáleného ovládání.
- Vzdálené ovládání potřebuje Core, který zapíše všech 13 registrů jedním požadavkem. To platí pro každý Core od roku 2022, pokud modul ponechá
MaxPrefetchGroupSize32 z této šablony. - Servisní atribut Actual AC power ukazuje činný výkon, který střídač hlásí na svém AC portu, ve W (
A:0x0106).
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.
Atributy a akce modulu
- Run mode (servisní atribut) — stav střídače jako text: Waiting, Checking, Normal, Fault, Permanent fault, Update, Off-grid waiting, Off-grid, Self testing, Idle, Standby, Remote control (kód 20); ostatní kódy se zobrazí jako Other
- Machine type (servisní atribut) — X1 (jednofázový) nebo X3 (třífázový), holding registr
H:0x0105 - Settings lock (servisní atribut) — Locked nebo Unlocked (
A:0x0054) - Remote control mode (servisní atribut) — aktivní režim vzdáleného ovládání (
A:0x0100): Off, Power control, Energy target, SOC target - Remote control - maximum target / minimum target (servisní atributy) — povolený rozsah cílového výkonu, který hlásí střídač, ve W (
A:0x010A,A:0x010C) - Unlock settings (password 2014) (servisní akce) — zapíše
2014do registru0x0000 - End remote control (servisní akce) — zapíše režim 0 do registrů vzdáleného ovládání
0x007C–0x0088
Detekce poruch
Čtecí skript modulu hlásí chybu TapHome, když je provozní režim (A:0x0009) 3 (Fault) nebo 4 (Permanent fault). Kromě toho analyzuje bit po bitu dva chybové registry, každou poruchu s vlastním kódem chyby:
- Chybový kód střídače (32bitový,
A:0x0040–A:0x0041, čte se nejprve nižší slovo) — všech 32 bitů, od TZ Protect Fault, poruch napětí sítě, FV, sběrnice a baterie, izolačních poruch a přehřátí až po Parallel Fault, Hard Limit Fault a poruchy relé - Chybový kód správce (16bitový,
A:0x0043) — Power Type Fault, Mgr EEPROM Fault, NTC Sample Invalid, nízká a vysoká teplota baterie, Meter Fault, Bypass Relay Fault a Fan 2 Fault jako chyby, Port OC Warning jako varování
Řešení problémů
Žádná komunikace se střídačem
- Ověřte, že vodiče RS-485 jsou na pinech REMOTE_485A / REMOTE_485B (1 + 2 nebo 7 + 8 v pozici RS485 kabelového přípravku COM 1), ne na pinech PARALLEL_485 3–6 a ne na lince elektroměru portu COM 2
- Zkontrolujte, zda se přenosová rychlost shoduje mezi střídačem (
Menu → Setting → Advance Setting → Modbus) a rozhraním Modbus RTU v TapHome — výchozí 19200 - Ověřte, že parametr importu Modbus Slave ID odpovídá Modbus adrese střídače (výchozí
1) - Ujistěte se, že k portu je připojen jen jeden Modbus master
- Pokud si nejste jisti polaritou kabelu, prohoďte vodiče A a B
- Ověřte, že kabel RS-485 nepřesahuje 30 m
Cíl vzdáleného ovládání se hned po nastavení vrátí na 0
Střídač je v pracovním režimu Manual, firmware nepodporuje režim 1 vzdáleného ovládání nebo je cíl mimo minimální a maximální cíl zobrazený v atributech modulu. Nejprve zkontrolujte pracovní režim.
Zápis nastavení je odmítnut
Střídač je zamčený. Spusťte akci modulu Unlock settings (password 2014); zámek se vrátí po každém restartu střídače (atribut modulu Settings lock).
Hodnoty sítě jsou 0 nebo Spotřeba nesedí
Grid - power balance, Ze sítě, Do sítě a Spotřeba závisí na elektroměru nebo CT střídače. Zkontrolujte jeho zapojení na COM 2 a nastavení v Menu → Setting → Advance Setting → Meter/CT Setting.
Výkon PV3 nebo Battery 2 ukazuje 0
PV3 existuje jen na modelech se třemi trackery (například X3-ULT-25K a X3-ULT-30K, počet MPPT viz uživatelský manuál); Battery 2 jen tehdy, když je k BAT 2 připojena druhá baterie. Nepoužívaná zařízení v TapHome skryjte.
SolaX