TapHome

SolaX Inverter (Cloud API)

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 03. 2026
SolaX Inverter (Cloud API)

A SolaX Cloud API sablon a TapHome-ot bármely SolaX inverterrel összeköti a SolaxCloud monitoring platformon keresztül. A SolaX Hybrid X1/X3 Gen 4 sablontól eltérően, amely Modbus RTU-t használ RS-485-ön keresztül, ez a felhőalapú integráció nem igényel fizikai bekötést az inverterhez. A TapHome a SolaX Cloud szervereket kérdezi le HTTPS-en keresztül, és valós idejű adatokat kap JSON formátumban.

A sablon az összes SolaX invertertípust támogatja (23 modell az X1, X3, A1 és J1 sorozatokból), és 11 monitorozó eszközt biztosít, amelyek lefedik az AC kimenetet, az akkumulátor állapotát, a hálózati energiaáramlást és az MPPT-nkénti PV-termelést. Az egyetlen követelmény egy SolaxCloud fiók, egy internetkapcsolattal rendelkező kommunikációs dongle (Pocket WiFi, LAN vagy 4G) és az API token.

Konfiguráció

SolaxCloud fiók beállítása

Az invertert regisztrálni kell és online állapotban kell lennie a SolaxCloud-on. Az inverteren telepítve kell lennie egy kommunikációs modulnak (Pocket WiFi, LAN vagy 4G dongle), amely csatlakozik az internethez.

Az API token beszerzése (tokenID)
  1. Jelentkezz be a SolaxCloud-ba a www.solaxcloud.com címen
  2. A bal oldali menüben navigálj a Service > Third-party ecosystem (vagy az API szekció) menüpontra
  3. Másold ki a megjelenített tokenID-t — ez egy 23 vagy 24 karakteres karakterlánc

A token ingyenes minden regisztrált SolaxCloud felhasználó számára.

A regisztrációs szám megkeresése (sn)

Az sn paraméter a kommunikációs dongle regisztrációs száma — nem az inverter sorozatszáma. Ez gyakori félreértés forrása.

Hol találod:

  • A donglen — a Pocket WiFi / LAN / 4G modul címkéjén nyomtatva (vonalkód vagy QR-kód)
  • A SolaxCloud-ban — navigálj a Device > Inverter menüpontra, és keresd a Registration No. oszlopot a táblázatban
Importparaméterek

A sablon TapHome-ba importálásakor add meg:

  • Token ID — a tokenID a SolaxCloud-ból
  • Registration No. — a kommunikációs dongle 10 karakteres sorozatszáma
Internetfüggőség

Ez egy kizárólag felhőalapú integráció. Minden adat a SolaX Cloud szervereken (www.solaxcloud.com:9443) keresztül halad. A sablon nem működik aktív internetkapcsolat nélkül sem a TapHome CCU-n, sem az inverter kommunikációs donglján.

Azok számára, akik helyi kommunikációt preferálnak felhőfüggőség nélkül, a SolaX Hybrid X1/X3 Gen 4 (Modbus RTU) sablon közvetlen RS-485 kommunikációt biztosít a Gen 4 hibrid inverterekkel.

Eszközképességek

AC kimenet és energiatermelés

Az AC Output villanyóra méri a teljes AC energiatermelést (yieldtotal kWh-ban) és a valós idejű kimeneti teljesítményt (acpower W-ban, kW-ra konvertálva). Egy szervizattribútum jelzi a napi hozamot (yieldtoday kWh-ban), amely éjfélkor nullázódik.

Akkumulátor monitorozás
  • Battery SOC — az akkumulátor töltöttségi állapota százalékban a soc mezőből. Az érték 100-zal osztva a TapHome 0–1 analóg bemeneti tartományához (pl. 85% → 0,85). Ez a leggyorsabban lekérdezett eszköz 2,5 másodperces intervallummal
  • Battery Power — pillanatnyi töltési/kisütési teljesítmény wattban. Pozitív értékek töltést jeleznek (PV-ből vagy hálózatból), negatív értékek kisütést a terhelésbe
Hálózati teljesítmény és energiamérés

Három eszköz fedi le a hálózati energiaáramlást:

  • Grid Power — nyers kétirányú hálózati teljesítmény wattban. Pozitív = betáplálás a hálózatba, negatív = vételezés a hálózatból
  • PV From Grid — villanyóra, amely a hálózatból fogyasztott energiát méri. Teljes fogyasztás (consumeenergy kWh-ban) és valós idejű vételi teljesítmény (a feedinpower-ből kinyerve negatív értéknél, kW-ra konvertálva)
  • PV To Grid — villanyóra, amely a hálózatba betáplált energiát méri. Teljes betáplált energia (feedinenergy kWh-ban) és valós idejű betáplálási teljesítmény (a feedinpower-ből kinyerve pozitív értéknél, kW-ra konvertálva)
PV-termelés monitorozás

A sablon öt PV-termelési eszközt biztosít:

  • PV Production (Total) — számított szenzor, amely összegzi mind a 4 MPPT bemenet DC teljesítményét. Null-biztos — a 4-nél kevesebb stringgel rendelkező inverterek null-t adnak vissza a nem használt MPPT-kre, amit a képlet nullaként kezel
  • PV Production (MPPT 1–4) — egyedi DC teljesítményértékek minden PV string bemenethez wattban
Modulszintű diagnosztika

A modul fő szkriptje minden lekérdezésnél ellenőrzi az inverter állapotát, és jelenti a problémákat:

  • A 100 (Wait Mode) és 110 (Standby) állapotok figyelmeztetéseket váltanak ki a TapHome-ban
  • A 103 (Fault Mode) és 104 (Permanent Fault Mode) állapotok hibákat váltanak ki
  • Ha az API válasz hibát jelez, az exception mezőből származó hibaüzenet kerül jelentésre

Két szervizattribútum érhető el a modulon:

  • Inverter status — állapotkódokat (100–113) olvasható nevekre képezi le (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 — típuskódokat (1–23) modellnevekre képezi le (X1-LX, X-Hybrid, X1-Boost/Air/Mini, X3-Hybrid-G4 stb.)
További lehetőségek

A SolaX Cloud API ezenfelül biztosítja a Meter 2 AC teljesítményt (feedinpowerM2), háromfázisú EPS (Emergency Power Supply) teljesítményt (peps1–peps3), az adatfeltöltés időbélyegét, az inverter sorozatszámát és az akkumulátor állapotát. Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az API hibát ad vagy nem szolgáltat adatokat
  1. Ellenőrizd, hogy az inverter online a SolaxCloud-on — jelentkezz be a webportálon és ellenőrizd az eszköz állapotát
  2. Győződj meg róla, hogy a tokenID helyes és nem lett újragenerálva (a régi tokenek érvénytelenné válnak)
  3. Bizonyosodj meg, hogy az sn paraméter a kommunikációs dongle regisztrációs száma, nem az inverter sorozatszáma
  4. Ellenőrizd, hogy a kommunikációs dongle aktív internetkapcsolattal rendelkezik
Elavult vagy késleltetett értékek

A SolaX Cloud API a kommunikációs dongle által legutóbb feltöltött adatokat adja vissza. Az adatok frissessége a dongle feltöltési intervallumától függ (jellemzően 5 percenként). A sablon 20 másodpercenként kérdezi le az API-t, de a mögöttes adatok ritkábban frissülhetnek.

API-korlát hibák

Az API legfeljebb 10 lekérdezést engedélyez percenként és 10 000 lekérdezést naponta. A sablon 20 másodperces intervallumal kérdez le (körülbelül 3 lekérdezés percenként), ami a korlátokon belül van. Ha több rendszer (TapHome, Home Assistant, egyéb eszközök) ugyanazt a tokenID-t használja, az összkérdezésszám meghaladhatja a korlátot.

A SolaX Cloud API aktív internetkapcsolatot igényel, és a SolaX Cloud szerverek elérhetőségétől függ. Felhőkiesések vagy internetszakadások esetén a sablon nem kap frissített adatokat. Garantált helyi vezérlést igénylő telepítéseknél fontold meg a Modbus RTU sablon használatát.

Elérhető eszközök

SolaX Inverter Modul
Szerviz attribútumok
Inverter állapotaAktuális üzemmód — Wait, Check, Normal, Fault, Permanent Fault, Update, EPS Check, EPS, Self-Test, Idle, Standby, Pv Wake Up Bat, Gen Check, Gen Run
Inverter típusaCsatlakoztatott invertermodell — azonosítja a telepített SolaX sorozatot (X1, X3, A1, J1) és generációt
Egyéni változók
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

Olvasás (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
Szerviz attribútumok
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 kimenet Villanyóra Csak olvasható

Teljes és napi AC energiatermelés (kWh) valós idejű kimeneti teljesítménnyel (kW)

numeric Egység: kWh / kW JSON parsejson()
Szerviz attribútumok
Inverter.AC.energy.out.daily [kWh]Napi AC energiahozam — éjfélkor nullázódik

AC kimenet

Összes fogyasztás olvasása
parsejson(json, "yieldtotal", 1)
Igény olvasása
parsejson(json, "acpower", 1) / 1000
Szerviz attribútumok
Inverter.AC.energy.out.daily [kWh]
parsejson(json, "yieldtoday", 1)
Akkumulátor SOC Analóg bemenet Csak olvasható

Akkumulátor töltöttségi állapot százalékban — 0% (üres) – 100% (tele)

numeric Egység: % JSON parsejson()

Akkumulátor SOC

Bemeneti szint olvasása
parsejson(json, "soc", 1) / 100
Akkumulátor teljesítmény Változó Csak olvasható

Pillanatnyi akkumulátor-teljesítmény wattban — pozitív töltéskor, negatív kisütéskor

numeric Egység: W JSON parsejson()

Akkumulátor teljesítmény

Olvasás
parsejson(json,"batPower",1)
Hálózatból vételezett Villanyóra Csak olvasható

Hálózatból fogyasztott energia — teljes fogyasztás (kWh) és valós idejű vételi teljesítmény (kW)

numeric Egység: kWh / kW JSON parsejson()

Hálózatból vételezett

Összes fogyasztás olvasása
parsejson(json, "consumeenergy", 1)
Igény olvasása
var power := parsejson(json, "feedinpower", 1);
if(power < 0, power * -1, 0) / 1000
Hálózati teljesítmény Változó Csak olvasható

Kétirányú hálózati teljesítmény wattban — pozitív exportnál, negatív importnál

numeric Egység: W JSON parsejson()

Hálózati teljesítmény

Olvasás
parsejson(json, "feedinpower", 1)
FV-termelés (összesen) Változó Csak olvasható

Összesített DC teljesítmény az összes MPPT bemenetből — automatikusan összegzi az elérhető stringeket

numeric Egység: W JSON parsejson()

FV-termelés (összesen)

Olvasás
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-termelés (MPPT 1) Változó Csak olvasható
numeric Egység: W JSON parsejson()

FV-termelés (MPPT 1)

Olvasás
parsejson(json,"powerdc1",1)
FV-termelés (MPPT 2) Változó Csak olvasható
numeric Egység: W JSON parsejson()

FV-termelés (MPPT 2)

Olvasás
parsejson(json,"powerdc2",1)
FV-termelés (MPPT 3) Változó Csak olvasható
numeric Egység: W JSON parsejson()

FV-termelés (MPPT 3)

Olvasás (modul)
parsejson(json,"powerdc3",1)
FV-termelés (MPPT 4) Változó Csak olvasható
numeric Egység: W JSON parsejson()

FV-termelés (MPPT 4)

Olvasás (modul)
parsejson(json,"powerdc4",1)
Hálózatba betáplált Villanyóra Csak olvasható

Hálózatba betáplált energia — teljes betáplált energia (kWh) és valós idejű betáplálási teljesítmény (kW)

numeric Egység: kWh / kW JSON parsejson()

Hálózatba betáplált

Összes fogyasztás olvasása
parsejson(json, "feedinenergy", 1)
Igény olvasása
var power := parsejson(json, "feedinpower", 1);
if(power > 0, power, 0) / 1000
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (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

Források