
SolaX X1-HYBRID a X3-HYBRID Gen 4 jsou střídače s akumulací energie, které podporují jednofázové (3–7,5 kW) i třífázové (5–15 kW) konfigurace. Šablona TapHome komunikuje přes Modbus RTU po RS-485 a čte vstupní a holding registry pro stav nabití baterie, výkon FV řetězce, tok výkonu sítě, celkové množství energie, režim nabíječky a SOC nočního nabíjení. Všechny zápisy jsou zakomentovány, šablona je tedy efektivně pouze pro čtení.
Šablona také implementuje komplexní detekci poruch parsováním 32-bitových chybových kódů střídače a 16-bitových chybových kódů správce, které hlásí jako chyby v TapHome.
Zapojení hardwaru
Střídač SolaX Gen 4 poskytuje COM port RS-485 pro komunikaci Modbus RTU na spodním panelu. COM port používá konektor RJ45.

Přiřazení pinů COM terminálu (RJ45):
| Pin | Přiřazení | Popis |
|---|---|---|
| 1 | Drycontact_A(in) | Připojení systémového spínače |
| 2 | Drycontact_B(in) | Připojení systémového spínače |
| 3 | +13V | — |
| 4 | 485A | RS-485 data+ (pro TapHome) |
| 5 | 485B | RS-485 data− (pro TapHome) |
| 6 | GND | Uzemnění |
| 7 | Drycontact_A(out) | Připojení generátoru |
| 8 | Drycontact_B(out) | Připojení generátoru |
Připojte TapHome k COM portu střídače:
- Pin 4 (485A) na COM portu střídače k A+/D+ na RS-485 TapHome
- Pin 5 (485B) na COM portu střídače k B-/D- na RS-485 TapHome
- Pin 6 (GND) — doporučuje se připojit pro spolehlivou komunikaci
Střídač sám o sobě nativně nepodporuje Modbus TCP. Modbus TCP je dostupný pouze přes monitorovací modul SolaX (Wi-Fi dongle) a šablona TapHome jej nepoužívá.
Pro instalace, kde zapojení RS-485 není praktické, šablona SolaX Inverter (Cloud API) poskytuje monitoring přes platformu SolaxCloud prostřednictvím HTTPS — bez fyzického připojení. Podporuje všechny typy invertorů SolaX, nejen Gen 4 Hybrid.
Některé holding registry jsou označeny omezeným počtem zápisových cyklů EEprom. Nadměrné zápisové operace mohou způsobit nenapravitelné poškození hardwaru. Šablona TapHome má všechny zápisové skripty zakázány, takže při aktuální šabloně to není problém.
Konfigurace
Aktivace komunikace Modbus
Modbus RTU je standardně dostupný na COM portu RS-485 střídače. Následující parametry se musí shodovat mezi střídačem a modulem TapHome:
- Slave ID – výchozí hodnota je 1, nastavitelné na displeji střídače
- Baud rate – střídač má výchozích 19200 baud, ale šablona TapHome používá 9600 baud. Upravte jeden z nich tak, aby se shodoval
- Formát dat – 8 datových bitů, bez parity, 1 stop bit
Konfigurace na displeji střídače: Menu > Setting > Advance Setting > Modbus. Nastavte slave adresu a baud rate. Baud rate lze přečíst i z holding registru H:0x00B0 a zapsat přes registr 0x00CA (hodnoty: 0=115200, 1=57600, 2=56000, 3=38400, 4=19200, 5=14400, 6=9600).
Aby jste nemuseli měnit nastavení střídače, upravte baud rate v nastavení modulu TapHome na 19200, čímž se shoduje s výchozí hodnotou střídače.
Časování komunikace
Protokol vyžaduje minimální interval 1 sekundy mezi po sobě jdoucími instrukcemi Modbus a timeout mezery mezi znaky alespoň 100 ms. Timeout odpovědi je 1 sekunda. Šablona TapHome používá individuální intervaly pollingu pro každé zařízení (2,5 s až 150 s), což tyto podmínky splňuje.
Funkce COM portu RS-485
Registr H:0x013E (485CommFunSelect) určuje, zda se port RS-485 používá pro komunikaci Modbus (hodnota 0) nebo komunikaci nabíječky EV (hodnota 1). Pro integraci TapHome musí být nastaven na 0 (Modbus 485).
Možnosti zařízení
Monitorování baterie
- Battery SOC – čte stav nabití baterie (A:0x1C) v procentech. Hodnota registru v jednotkách 1 % se dělí číslem 100 pro rozsah analogového vstupu TapHome 0–1 (např. 85 % se zobrazí jako 0,85)
- Battery Temperature – čte teplotu baterie (A:0x18) ve stupních Celsia. Polling každých 80 sekund. Oficiální šablona čte registr jako bezznaménkový, takže teploty pod 0 °C zobrazuje chybně (viz Známé chyby v oficiální šabloně níže)
Solární výkon FV
- PV1 Power – stejnosměrný výkon FV řetězce 1 (A:0x0A), zobrazený v kW po dělení 1000 z wattů
- PV2 Power – stejnosměrný výkon FV řetězce 2 (A:0x0B), zobrazený v kW po dělení 1000 z wattů
Výkon sítě a měření energie
- Grid Feed-in Power – okamžitý výkon sítě (A:0x46, LittleEndianInt32) v kW. Kladné hodnoty označují export do sítě, záporné hodnoty označují odběr ze sítě
- Daily / Actual Energy – v oficiální šabloně kombinuje denní produkci energie ze střídače přes AC port (A:0x50, čítač, který se každou noc nuluje) a výkon sítě jednofázových modelů X1 (A:0x02). Obě hodnoty jsou chybné pro měřič energie s typem FV Výroba — viz Známé chyby v oficiální šabloně níže
- Total Energy – celková kumulativní produkce energie ze střídače přes AC port (A:0x52). Registr počítá v jednotkách 0,1 kWh; oficiální šablona dělí hodnotu 1000, takže je 100× menší, než má být (viz Známé chyby v oficiální šabloně níže)
Režim nabíječky a noční nabíjení
- Charger Use Mode – čte aktivní režim solární nabíječky (H:0x8B): Self Use Mode (0), Feedin Priority (1), Backup Mode (2) nebo Manual Mode (3). Hodnoty 4–9 jsou rezervovány. Zápisový registr (H:0x1F) v šabloně existuje, ale je zakomentován, takže je to pouze pro čtení
- Self-Use Night Charge SOC – čte horní cílovou hodnotu SOC pro noční nabíjení v režimu Self-Use (H:0x94) v procentech. Zápisový registr (H:0x63) i aktivační registr (H:0x62) jsou zakomentovány, takže konfiguraci nočního nabíjení nelze měnit přes TapHome
Detekce poruch
ReadScript na úrovni modulu monitoruje provozní režim střídače (A:0x09) a dva chybové registry:
- Run Mode poruchy – vyvolá chybu při Run Mode 3 (Porucha) nebo 4 (Trvalá porucha)
- Chybové kódy střídače (A:0x40) – 32-bitová bitmapa (nižší slovo jako první) parsovaná pro 30 individuálních poruch včetně poruch napětí/frekvence sítě, poruch napětí FV, poruch baterie, izolačních poruch, přehřátí, ochrany před přetížením, poruch relé a komunikačních chyb
- Chybové kódy správce (A:0x43) – 16-bitová bitmapa parsovaná pro poruchy typu výkonu, chyby EEPROM, problémy NTC senzorů, varování teploty baterie, poruchy měřiče a poruchy ventilátoru
Atribut služby Run Mode na modulu zobrazuje aktuální stav střídače jako text: Waiting, Checking, Normal, Fault, Permanent Fault, Update, Off-grid waiting, Off-grid, Self Testing, Idle nebo Standby.
Další možnosti
Střídač poskytuje komplexní mapu registrů s více než 300 holding registry a 200 vstupními registry. Pozoruhodné možnosti, které ještě nejsou implementovány v šabloně, zahrnují monitorování napětí a proudu pro každý FV řetězec (A:0x03–0x06), měření napětí/proudu/výkonu baterie, stav připojení BMS, stav sítě on/off, X3 napětí/proud/výkon sítě pro každou fázi (12 registrů na A:0x6A–0x75), kumulativní energie dodaná do sítě a odebraná ze sítě (přes měřič), celková produkce solární energie, BMS SOC a SOH uživatele a min/max teplota a napětí článků baterie. Možnosti zápisů zahrnují ovládání zapnutí/vypnutí systému, výběr režimu nabíječky, manuální nucené nabíjení/vybíjení, minimální SOC vybíjení, konfiguraci nočního nabíjení a vzdálené řízení výkonu s cílovými hodnotami činného/jalového výkonu. Tyto funkce lze doplnit v budoucí aktualizaci šablony.
Oficiální šablona čte výkon sítě X1 (jednofázový) na A:0x02 jako výkon svého měřiče energie. Opravené skripty níže místo toho čtou výrobu FV, což funguje stejně na modelech X1 i X3.
Známé chyby v oficiální šabloně
Oficiální šablona TapHome pro tento střídač čte několik registrů chybně (ověřeno podle protokolu SolaX Modbus V3.21 a V001.02 a podle hodnot 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 stávajícího modulu a jeho zařízení, nebo importujte opravenou komunitní šablonu z portálu TapHome: SolaX X1/X3-Hybrid G4 — corrected monitoring (přihlaste se, stáhněte XML a importujte ho jako nový modul).
| Kde | Oficiální skript | Opravený skript | Důsledek chyby |
|---|---|---|---|
| Modul — ReadScript | var x3 := MODBUSR(A, 0x0040, Uint32); | var x3 := MODBUSR(A, 0x0040, LittleEndianUint32); | Dvě poloviny 32-bitového chybového kódu jsou prohozené: porucha v bitu 1 (Grid Lost Fault) se hlásí jako bit 17 (Bat Power Low) |
| Total Energy | MODBUSR(A, 0x52, LittleEndianInt32) / 1000 | MODBUSR(A, 0x0052, LittleEndianUint32) / 10 | Hodnota 100× menší (registr počítá v jednotkách 0,1 kWh) |
| Daily / Actual Energy — celková spotřeba | MODBUSR(A, 0x50, UInt16) /10 | MODBUSR(A, 0x0094, LittleEndianUint32) / 10 | 0x0050 je denní čítač, který každou noc klesne na 0; 0x0094 je celková energie FV |
| Daily / Actual Energy — poptávka | MODBUSR(A,0x02, Int16)/1000 | (MODBUSR(A, 0x000A, UInt16) + MODBUSR(A, 0x000B, UInt16)) / 1000 | 0x0002 je výkon sítě jednofázových modelů X1, ne výroba FV; na mnoha jednotkách X3 čte 0 |
| Battery Temperature | MODBUSR(A,0x0018, UInt16) | MODBUSR(A, 0x0018, Int16) | Pod 0 °C zobrazuje oficiální šablona přibližně 65535 °C |
| Rychlost rozhraní | 9600 baud | 19200 baud | 19200 je tovární nastavení SolaX |
S opravenými skripty měří Daily / Actual Energy výrobu FV (PV1 + PV2), což odpovídá jeho typu energie v přehledu Energy Dashboard. Opravená komunitní šablona má stejně jako oficiální všechny zápisy zakázané.
Řešení problémů
Žádná komunikace se střídačem
- Ověřte zapojení kabelu RS-485: A+ na A+, B- na B-, GND na GND
- Zkontrolujte, zda je registr H:0x013E nastaven na 0 (režim Modbus 485, ne EV Charger)
- Potvrďte, že baud rate se shoduje mezi střídačem a TapHome – střídač má výchozích 19200, šablona má výchozích 9600
- Ověřte, že Slave ID v TapHome se shoduje s nastavením střídače (výchozí hodnota: 1)
- Ujistěte se, že žádný jiný Modbus master není připojen na stejné sběrnici RS-485 – Modbus podporuje pouze jednoho mastera
Nesprávné čtení Battery SOC
Registr Battery SOC (A:0x1C) hlásí hodnoty v jednotkách 1 %. Šablona dělí číslem 100 pro rozsah analogového vstupu TapHome 0–1. Pokud se zobrazená hodnota zdá nesprávná, ověřte, že zařízení TapHome je nakonfigurováno jako AnalogInput (rozsah 0–1, ne 0–100).
Znaménková konvence výkonu sítě
Grid Feed-in Power (A:0x46) používá znaménkovou konvenci, kde kladné hodnoty označují export (výroba/dodávka do sítě) a záporné hodnoty označují import (odběr ze sítě). Registr výkonu sítě Daily/Actual Energy (A:0x02) může také zobrazovat záporné hodnoty při odběru ze sítě.
Rozdíly registrů X1 vs X3
Některé registry jsou specifické pro model. Napětí sítě (A:0x00), proud (A:0x01) a výkon (A:0x02) jsou registry X1 pro jednofázové modely. Pro třífázové modely X3 jsou ekvivalentní hodnoty pro každou fázi na A:0x6A–0x75. Šablona používá registr výkonu sítě X1, který nemusí správně hlásit na modelech X3.
