TapHome

SolaX Inverter (Cloud API)

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 03. 2026
SolaX Inverter (Cloud API)

Šablóna SolaX Cloud API prepojí TapHome s ľubovoľným solárnym invertorom SolaX prostredníctvom monitorovacej platformy SolaxCloud. Na rozdiel od šablóny SolaX Hybrid X1/X3 Gen 4, ktorá používa Modbus RTU cez RS-485, táto cloudová integrácia nevyžaduje žiadne fyzické zapojenie k invertoru. TapHome dopytuje servery SolaX Cloud cez HTTPS a prijíma dáta v reálnom čase vo formáte JSON.

Šablóna podporuje všetky typy invertorov SolaX (23 modelov naprieč sériami X1, X3, A1 a J1) a poskytuje 11 monitorovacích zariadení pokrývajúcich AC výstup, stav batérie, tok energie do siete a FV výrobu na jednotlivých MPPT vstupoch. Jedinou požiadavkou je účet na SolaxCloud, komunikačný dongle s pripojením na internet (Pocket WiFi, LAN alebo 4G) a API token.

Konfigurácia

Nastavenie účtu SolaxCloud

Invertor musí byť zaregistrovaný a online na SolaxCloud. Na invertore musí byť nainštalovaný komunikačný modul (Pocket WiFi, LAN alebo 4G dongle) pripojený k internetu.

Získanie API tokenu (tokenID)
  1. Prihláste sa do SolaxCloud na www.solaxcloud.com
  2. V ľavom bočnom paneli prejdite na Service > Third-party ecosystem (alebo sekciu API)
  3. Skopírujte zobrazený tokenID — ide o 23- alebo 24-znakový reťazec

Token je bezplatný pre všetkých registrovaných používateľov SolaxCloud.

Nájdenie registračného čísla (sn)

Parameter sn je registračné číslo komunikačného donglu — nie sériové číslo invertora. Toto je častý zdroj zámeny.

Kde ho nájsť:

  • Na dongli — vytlačené na štítku modulu Pocket WiFi / LAN / 4G (čiarový kód alebo QR kód)
  • V SolaxCloud — prejdite na Device > Inverter a vyhľadajte stĺpec Registration No. v tabuľke
Importné parametre

Pri importovaní šablóny v TapHome zadajte:

  • Token ID — tokenID zo SolaxCloud
  • Registration No. — 10-znakové sériové číslo komunikačného donglu
Závislosť na internete

Toto je čisto cloudová integrácia. Všetky dáta prúdia cez servery SolaX Cloud (www.solaxcloud.com:9443). Šablóna nebude fungovať bez aktívneho internetového pripojenia na TapHome CCU aj na komunikačnom dongli invertora.

Pre používateľov, ktorí preferujú lokálnu komunikáciu bez závislosti na cloude, šablóna SolaX Hybrid X1/X3 Gen 4 (Modbus RTU) poskytuje priamu komunikáciu cez RS-485 s hybridnými invertormi Gen 4.

Schopnosti zariadenia

AC výstup a energetická produkcia

Elektromer AC Output meria celkovú produkciu AC energie (yieldtotal v kWh) a aktuálny výstupný výkon (acpower vo W, konvertovaný na kW). Servisný atribút zobrazuje denný výnos (yieldtoday v kWh), ktorý sa resetuje o polnoci.

Monitorovanie batérie
  • Battery SOC — stav nabitia batérie v percentách z poľa soc. Hodnota je vydelená 100 pre rozsah analógového vstupu TapHome 0–1 (napr. 85 % → 0,85). Toto je najrýchlejšie dopytované zariadenie s intervalom 2,5 sekundy
  • Battery Power — okamžitý výkon nabíjania/vybíjania batérie vo wattoch. Kladné hodnoty znamenajú nabíjanie (z FV alebo siete), záporné hodnoty znamenajú vybíjanie do záťaže
Výkon siete a meranie energie

Tri zariadenia pokrývajú tok energie do/zo siete:

  • Grid Power — surový obojsmerný výkon siete vo wattoch. Kladný = export do siete, záporný = odber zo siete
  • PV From Grid — elektromer sledujúci energiu spotrebovanú zo siete. Celková spotreba (consumeenergy v kWh) a aktuálny výkon odberu (extrahovaný z feedinpower keď záporný, konvertovaný na kW)
  • PV To Grid — elektromer sledujúci energiu exportovanú do siete. Celková energia dodaná do siete (feedinenergy v kWh) a aktuálny výkon dodávky (extrahovaný z feedinpower keď kladný, konvertovaný na kW)
Monitorovanie FV výroby

Šablóna poskytuje päť zariadení pre FV výrobu:

  • PV Production (Total) — vypočítaný senzor sčítajúci DC výkon zo všetkých 4 MPPT vstupov. Odolný voči null hodnotám — invertory s menej ako 4 stringmi vracajú null pre nepoužité MPPT, čo vzorec počíta ako nulu
  • PV Production (MPPT 1–4) — individuálne DC výkony pre každý FV string vstup vo wattoch
Diagnostika na úrovni modulu

Hlavný skript modulu kontroluje stav invertora pri každom dopytovaní a hlási problémy:

  • Stav 100 (Wait Mode) a 110 (Standby) vyvolávajú varovania v TapHome
  • Stav 103 (Fault Mode) a 104 (Permanent Fault Mode) vyvolávajú chyby
  • Ak API odpoveď indikuje zlyhanie, chybová správa z poľa exception je reportovaná

Na module sú dostupné dva servisné atribúty:

  • Inverter status — mapuje stavové kódy 100–113 na čitateľné názvy (Wait Mode, Check Mode, Normal Mode, Fault Mode, Permanent Fault Mode, Update Mode, EPS Check Mode, EPS Mode, Self-Test Mode, Idle Mode, Standby Mode, Pv Wake Up Bat Mode, Gen Check Mode, Gen Run Mode)
  • Inverter type — mapuje kódy typov 1–23 na názvy modelov (X1-LX, X-Hybrid, X1-Boost/Air/Mini, X3-Hybrid-G4 atď.)
Ďalšie možnosti

SolaX Cloud API tiež poskytuje výkon Meter 2 AC (feedinpowerM2), výkon EPS (Emergency Power Supply) pre tri fázy (peps1–peps3), časovú pečiatku nahratia dát, sériové číslo invertora a stav batérie. Tieto je možné pridať v budúcej aktualizácii šablóny.

Riešenie problémov

API vracia chybu alebo žiadne dáta
  1. Overte, že invertor je online na SolaxCloud — prihláste sa na webový portál a skontrolujte stav zariadenia
  2. Skontrolujte, či je tokenID správny a nebol regenerovaný (staré tokeny sa zneplatnia)
  3. Uistite sa, že parameter sn je registračné číslo komunikačného donglu, nie sériové číslo invertora
  4. Skontrolujte, či má komunikačný dongle aktívne internetové pripojenie
Zastarané alebo oneskorené hodnoty

SolaX Cloud API vracia najnovšie dáta nahrané komunikačným donglom. Aktuálnosť dát závisí od intervalu nahrávania donglu (zvyčajne každých 5 minút). Šablóna dopytuje API každých 20 sekúnd, ale podkladové dáta sa môžu aktualizovať menej často.

Chyby limitov API

API povoľuje maximálne 10 požiadaviek za minútu a 10 000 požiadaviek za deň. Šablóna dopytuje v 20-sekundových intervaloch (približne 3 požiadavky za minútu), čo je v rámci limitov. Ak viacero systémov (TapHome, Home Assistant, iné nástroje) zdieľa rovnaký tokenID, kombinovaný počet požiadaviek môže prekročiť limit.

SolaX Cloud API vyžaduje aktívne internetové pripojenie a závisí od dostupnosti serverov SolaX Cloud. Počas výpadkov cloudu alebo prerušenia internetu šablóna nebude prijímať aktualizované dáta. Pre inštalácie vyžadujúce garantované lokálne riadenie zvážte namiesto toho šablónu Modbus RTU.

Dostupné zariadenia

SolaX Inverter Modul
Servisné atribúty
Stav invertoraAktuálny prevádzkový režim — Wait, Check, Normal, Fault, Permanent Fault, Update, EPS Check, EPS, Self-Test, Idle, Standby, Pv Wake Up Bat, Gen Check, Gen Run
Typ invertoraPripojený model invertora — identifikuje nainštalovanú sériu SolaX (X1, X3, A1, J1) a generáciu
Vlastné premenné
tokenID (string)SolaX Cloud API token ID (obtain from your SolaX Cloud account API page)
sn (string)Serial number of the SolaX communication module (Registration No.)

Solax Inverter

Čítanie (modul)
var response := sendhttprequest("/proxy/api/getRealtimeInfo.do?tokenId="+tokenID+"&sn="+sn);

if parsejson(response.Content, "success")
	json := parsejson(response.Content, "result", 1);
	
	var statusCode := parsejson(json,"inverterStatus");
	if statusCode = "100"
	  addwarning("Inverter in waiting - Check DC");
	end
	if statusCode =  "103"
	  adderror("Inverter in fault mode");
	end
	if statusCode = "104"
	  adderror("Inverter in permanent fault mode");
	end
	if statusCode = "110"
	  addwarning("Inverter in standby mode");
	end
else
 	adderror(parsejson(response.Content, "exception"));
end
Servisné atribúty
Inverter status
var statusCode := parsejson(json,"inverterStatus");

IF(statusCode = "100",return("Wait Mode"));
IF(statusCode = "101",return("Check Mode"));
IF(statusCode = "102",return("Normal Mode"));
IF(statusCode = "103",return("Fault Mode"));
IF(statusCode = "104",return("Permanent Fault Mode"));
IF(statusCode = "105",return("Update Mode"));
IF(statusCode = "106",return("EPS Check Mode"));
IF(statusCode = "107",return("EPS Mode"));
IF(statusCode = "108",return("Self-Test Mode"));
IF(statusCode = "109",return("Idle Mode"));
IF(statusCode = "110",return("Standby Mode"));
IF(statusCode = "111",return("Pv Wake Up Bat Mode"));
IF(statusCode = "112",return("Gen Check Mode"));
IF(statusCode = "113",return("Gen Run Mode"));
Inverter type
var type := parsejson(json,"inverterType");

IF(type = "1",return("X1-LX"));
IF(type = "2",return("X-Hybrid"));
IF(type = "3",return("X1-Hybiyd/Fit"));
IF(type = "4",return("X1-Boost/Air/Mini"));
IF(type = "5",return("X3-Hybiyd/Fit"));
IF(type = "6",return("X3-20K/30K"));
IF(type = "7",return("X3-MIC/PRO"));
IF(type = "8",return("X1-Smart"));
IF(type = "9",return("X1-AC"));
IF(type = "10",return("A1-Hybrid"));
IF(type = "11",return("A1-Fit"));
IF(type = "12",return("A1-Grid"));
IF(type = "13",return("J1-ESS"));
IF(type = "14",return("X3-Hybrid-G4"));
IF(type = "15",return("X1-Hybrid-G4"));
IF(type = "16",return("X3-MIC/PRO-G2"));
IF(type = "17",return("X1-SPT"));
IF(type = "18",return("X1-Boost/Mini-G4"));
IF(type = "19",return("A1-HYB-G2"));
IF(type = "20",return("A1-AC-G2"));
IF(type = "21",return("A1-SMT-G2"));
IF(type = "22",return("X3-FTH"));
IF(type = "23",return("X3-MGA-G2"));
AC výstup Elektromer Len na čítanie

Celková a denná produkcia AC energie (kWh) s aktuálnym výstupným výkonom (kW)

numeric Jednotka: kWh / kW JSON parsejson()
Servisné atribúty
Inverter.AC.energy.out.daily [kWh]Denný výnos AC energie — resetuje sa o polnoci

AC výstup

Čítanie celkovej spotreby
parsejson(json, "yieldtotal", 1)
Čítanie odberu
parsejson(json, "acpower", 1) / 1000
Servisné atribúty
Inverter.AC.energy.out.daily [kWh]
parsejson(json, "yieldtoday", 1)
SOC batérie Analógový vstup Len na čítanie

Stav nabitia batérie v percentách — 0 % (prázdna) až 100 % (plná)

numeric Jednotka: % JSON parsejson()

SOC batérie

Čítanie vstupnej úrovne
parsejson(json, "soc", 1) / 100
Výkon batérie Premenná Len na čítanie

Okamžitý výkon batérie vo wattoch — kladný pri nabíjaní, záporný pri vybíjaní

numeric Jednotka: W JSON parsejson()

Výkon batérie

Čítanie
parsejson(json,"batPower",1)
Odber zo siete Elektromer Len na čítanie

Energia spotrebovaná zo siete — celková spotreba (kWh) a aktuálny výkon odberu (kW)

numeric Jednotka: kWh / kW JSON parsejson()

Odber zo siete

Čítanie celkovej spotreby
parsejson(json, "consumeenergy", 1)
Čítanie odberu
var power := parsejson(json, "feedinpower", 1);
if(power < 0, power * -1, 0) / 1000
Výkon siete Premenná Len na čítanie

Obojsmerný výkon siete vo wattoch — kladný pri exporte, záporný pri odbere

numeric Jednotka: W JSON parsejson()

Výkon siete

Čítanie
parsejson(json, "feedinpower", 1)
FV výroba (celková) Premenná Len na čítanie

Kombinovaný DC výkon zo všetkých MPPT vstupov — automaticky sčíta dostupné stringy

numeric Jednotka: W JSON parsejson()

FV výroba (celková)

Čítanie
var PV1 := parsejson(json,"powerdc1",1);
var PV2 := parsejson(json,"powerdc2",1);
var PV3 := parsejson(json,"powerdc3",1);
var PV4 := parsejson(json,"powerdc4",1);

if(isnull(PV1), 0, PV1) +
if(isnull(PV2), 0, PV2) +
if(isnull(PV3), 0, PV3) +
if(isnull(PV4), 0, PV4)
FV výroba (MPPT 1) Premenná Len na čítanie
numeric Jednotka: W JSON parsejson()

FV výroba (MPPT 1)

Čítanie
parsejson(json,"powerdc1",1)
FV výroba (MPPT 2) Premenná Len na čítanie
numeric Jednotka: W JSON parsejson()

FV výroba (MPPT 2)

Čítanie
parsejson(json,"powerdc2",1)
FV výroba (MPPT 3) Premenná Len na čítanie
numeric Jednotka: W JSON parsejson()

FV výroba (MPPT 3)

Čítanie (modul)
parsejson(json,"powerdc3",1)
FV výroba (MPPT 4) Premenná Len na čítanie
numeric Jednotka: W JSON parsejson()

FV výroba (MPPT 4)

Čítanie (modul)
parsejson(json,"powerdc4",1)
Dodávka do siete Elektromer Len na čítanie

Energia exportovaná do siete — celková energia dodaná do siete (kWh) a aktuálny výkon dodávky (kW)

numeric Jednotka: kWh / kW JSON parsejson()

Dodávka do siete

Čítanie celkovej spotreby
parsejson(json, "feedinenergy", 1)
Čítanie odberu
var power := parsejson(json, "feedinpower", 1);
if(power > 0, power, 0) / 1000
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (7)
  • Meter 2 AC Power — Inverter.Meter2.AC.power.total, 1 W. Secondary meter power reading — available for dual-meter setups
  • EPS Phase 1 Power — Inverter.AC.EPS.power.R, 1 W. Emergency Power Supply output phase R
  • EPS Phase 2 Power — Inverter.AC.EPS.power.S, 1 W. Emergency Power Supply output phase S
  • EPS Phase 3 Power — Inverter.AC.EPS.power.T, 1 W. Emergency Power Supply output phase T
  • Upload Time — Last data upload timestamp from inverter to SolaX Cloud. Useful for stale-data detection
  • Inverter Serial Number — Serial number of the inverter hardware (different from communication module SN)
  • Battery Status — Battery status code with mapped states. Documented in HA integration but not in official API V6.1 PDF

Zdroje