A SolaX HAC Cloud API sablon a TapHome-ot egy SolaX X1-HAC vagy X3-HAC EV töltőhöz kapcsolja a SolaX Developer Portal API-n (OpenAPI) keresztül. A sablon szerzője az A1-HAC és a C1/C3-HAC töltőket is feltünteti. A TapHome nem közvetlenül kommunikál a töltővel: a töltő Wi-Fi-n, LAN-on vagy 4G-n keresztül jelent a SolaXCloudnak, a TapHome pedig 60 másodpercenként HTTPS-en olvassa ki az adatait a SolaX felhőből. Az írási parancsok (üzemmód, indítás és leállítás, zárolás, áramkorlát) ugyanígy, a felhőn keresztül jutnak vissza a töltőhöz.
A sablon importálása előtt két dolognak kell rendben lennie. A töltőnek online kell lennie egy SolaXCloud fiókban, és ehhez a fiókhoz a SolaX Developer Portalon egy alkalmazás kell, amely megadja a Client ID-t és a Client Secret-et. Ha a töltő egy SolaX napelem inverter mellett működik, a SolaX Inverter (Cloud API) sablon ugyanabban a TapHome projektben futhat. Ez a régebbi SolaxCloud monitoring API-t használja, saját tokennel.
A töltő csatlakoztatása a SolaXCloudhoz
Hálózati kapcsolat
A töltő háromféleképpen csatlakozhat az internethez. Mindhárom DHCP-t használ, így az IP-címet automatikusan a router osztja ki.
- Wi-Fi: csak 2,4 GHz (802.11 b/g/n). Az 5 GHz-es hálózatok nem támogatottak.
- Ethernet (LAN): az RJ45 csatlakozó LAN (/ DI). Az Ethernet az 1., 2., 3. és 6. tűt használja (TX+, TX−, RX+, RX−). Ha csak Ethernetre van szükség, a többi tűt hagyd bekötetlenül. LAN-kapcsolat esetén a Wi-Fi beállítása kihagyható.
- 4G: csak azoknál a modelleknél, amelyek nevében szerepel a „4G” (például X3-HAC-22P-B4G). A Cat-M-et, NB-IoT-t vagy GSM-et támogató nano SIM-kártyát csak arra jogosult szakember helyezheti be. A SolaX a Solar és a Standard alkalmazási forgatókönyvben legalább havi 100 MB adatforgalmat javasol.

A töltőhöz vezető Ethernet-kábelt villámcsapás ellen védeni kell. Ha a LAN-ra és a DI jelbemenetre is szükség van, az 1., 2., 3. és 6. tűt krimpeld az Ethernethez, a 4., 5. és 8. tűt a DI-hez, majd a két kábelt kösd össze a töltőhöz mellékelt RJ45 toldóval.
A 4G-kapcsolatot a SolaXCloud alkalmazásban, helyi módban kell beállítani: nyisd meg a Dongle menüt, majd a beállítások gombot, állítsd a Device Networking Mode értékét 4G-re, add meg a szolgáltató APN-jét, és válaszd ki a hálózat azon típusát, amelyet a SIM támogat.
A töltő hozzáadása a SolaXCloud alkalmazásban
- Telepítsd a SolaXCloud alkalmazást az App Store-ból vagy a Google Playről, és regisztrálj fiókot e-mail-címmel vagy telefonszámmal és ellenőrző kóddal.
- Az első bejelentkezéskor hozz létre egy erőművet (plant): engedélyezd a helyhozzáférést, add meg az erőmű nevét, és végezd el a többi beállítást.
- Add hozzá a töltőt a típuscímkén lévő Registration No. beolvasásával vagy beírásával. A később hozzáadott töltőknél az út: Device oldal, + ikon, majd Add Device vagy Scan.
- Ha a töltő Wi-Fi-n csatlakozik, add meg a Wi-Fi-hálózat nevét és jelszavát.

A típuscímkén két különböző szám szerepel. A Registration No. a töltő alkalmazásbeli hozzáadására és a helyi bejelentkezésre szolgál. Az SN (a készülék sorozatszáma) az, amelyre a TapHome sablonnak DeviceSN-ként szüksége van. Az alkalmazás a készülék SN-jét a töltő Basic information oldalán mutatja (koppints a töltő Details oldalának felső részére). A Developer Portalon is megtalálod a Device > Device List alatt.
A Wi-Fi újracsatlakoztatása és a helyi hozzáférés
Ha a töltő offline állapotba kerül, nyisd meg az alkalmazásban a Device oldalt, koppints az offline jelölésű töltő kártyájára, és válaszd a Reconfigure lehetőséget. Ezután add meg újra a 2,4 GHz-es hálózatot és a jelszót.

Ha az újrakonfigurálás nem sikerül, van egy második lehetőség. Csatlakoztass egy telefont vagy laptopot a töltő saját Wi-Fi-hálózatához, amelynek neve a Registration No.-ból képződik (Wifi_XC…). Ezután nyisd meg böngészőben a http://192.168.10.10/ címet, és jelentkezz be admin felhasználóként, jelszóként a Registration No.-t megadva. Az alkalmazás helyi módja (More > Local Access, bejelentkezve pedig Service > Application > Local Access) ugyanezt a hálózatot használja.
A töltő a helyi Wi-Fi-hálózatát a sikeres hálózati csatlakozás után egy órával automatikusan kikapcsolja. Ha később helyi hozzáférést szeretnél, kapcsold vissza a hálózatot az alkalmazásban a Network > Local Access alatt.
Alkalmazási forgatókönyv és töltési módok
A töltő a három alkalmazási forgatókönyv egyikében működik, amelyet az alkalmazásban az Advanced setting > Application scene alatt választhatsz ki:
- Solar (alapértelmezett): a Green, az Eco és a Fast töltési mód érhető el. A Green és az Eco módhoz a töltőnek a napelem inverterrel, vagy a hálózati csatlakozási ponton lévő áramváltóval (CT) vagy mérővel kell kommunikálnia, hogy ismerje a PV-többletet.
- Standard: a töltő csak elindítja és leállítja a töltést. Ebben a forgatókönyvben nincs Green és Eco mód.
- OCPP: a töltőt egy OCPP-szerver kezeli, és a SolaXCloud alkalmazás elrejti a módválasztást.

A napelem inverter a COM1-S- portra csatlakozik (A1/B1). A mérő vagy a CT a COM2-M- portra csatlakozik (A2/B2, a CT-bemenetek a többi tűn). A Green mód (3 A vagy 6 A) és az Eco mód (6, 10, 16, 20 vagy 25 A) töltőáram-szintjét az alkalmazásban a Details > Function Control > Charge Level alatt állíthatod be. A 11 kW-os modelleken az Eco csak 6 A-t és 10 A-t kínál. A Green és az Eco töltéshez emellett az IEC 61851 szabványnak megfelelő jármű is szükséges.
API-hozzáférés beállítása a SolaX Developer Portalon
- Jelentkezz be a SolaX Developer Portal oldalra, és nyisd meg a Quick Start vagy az Application menüt.
- Hozz létre egy alkalmazást ahhoz a SolaXCloud erőműhöz, amelyben a töltő van. Az alkalmazásnak legalább egy engedélyezett erőművel kell rendelkeznie.
- Az alkalmazás Authorization fülén másold ki a Client ID-t és a Client Secret-et.
- A Service API > Authorize alatt engedélyezd a Data Monitoring Service (
API_Telemetry_V2) és az Information Access Service (API_Info_V2) monitorozó szolgáltatást. Engedélyezd az EV töltő vezérlési szolgáltatását is, amelyre az üzemmód-kapcsolónak és a szervizakcióknak szükségük van. A puszta monitorozás enélkül is működik. - A töltő sorozatszámát a Device > Device List alatt találod. Ez ugyanaz az SN, mint a SolaXCloud alkalmazásban.
A sablon az európai API-hosztra (
openapi-eu.solaxcloud.com) van beállítva. A SolaX külön hosztokat üzemeltet Kína (openapi-cn.solaxcloud.com) és India (openapi-in.solaxcloud.com) számára. A fiók régióját a Developer Portal mutatja. Importált állapotában a sablon más régióbeli alkalmazással nem működik.
Importálási paraméterek
A TapHome-ban importáld a sablont, és töltsd ki az alábbi három paramétert. Minden mást (token, lekérdezés, újrapróbálkozások) a modul kezel.
| Paraméter | Leírás | Hol találod |
|---|---|---|
ClientId | A Developer Portal alkalmazás Client ID-ja | Application > Authorization |
ClientSecret | Ugyanannak az alkalmazásnak a Client Secret-je | Application > Authorization |
DeviceSN | A töltő sorozatszáma (nem a Registration No.) | Developer Portal Device > Device List, vagy Basic information a SolaXCloud alkalmazásban |
Egy Client ID és Client Secret párt csak egyetlen kliens használjon. Minden alkalmazásnak csak egy érvényes hozzáférési tokenje van, így egy új tokenkérés érvényteleníti az előzőt. Egy második TapHome sablonpéldány, vagy egy másik, ugyanazokkal a hitelesítő adatokkal lekérdező eszköz folyamatosan érvényteleníti ennek a sablonnak a tokenjét. Második töltőhöz vagy más rendszerhez hozz létre külön alkalmazást a Developer Portalon.
Az eszköz képességei
A sablonban az eszközök nevei szlovákul vannak. Alább mindegyik szerepel, zárójelben az alkalmazásban látható nevével.
Töltési teljesítmény és energia
A Töltési teljesítmény (Nabíjací výkon) egy villamosenergia-mérő. Az aktuális töltési teljesítményt mutatja kW-ban és az összes töltött energiát kWh-ban. Szervizattribútumai az aktuális töltési munkamenet energiáját (Energia aktuálnej relácie [kWh]), az L1, L2 és L3 fázisáramot (Prúd L1 [A], Prúd L2 [A], Prúd L3 [A]) és az egyfázisú áramot (Jednofázový prúd [A]) mutatják.
Töltési állapot és állapotkód
- A Töltés folyamatban (
Nabíjanie prebieha) egy kontaktus. Csak addig van bekapcsolva (Nabíja), amíg a töltő Charging állapotot jelent. Minden más állapotban ki van kapcsolva (Nenabíja), a Suspended EV és a Suspended EVSE állapotot is beleértve. - A Töltő állapota (
Stav nabíjačky) a töltő nyers állapotkódja:
| Kód | Állapot | Kód | Állapot |
|---|---|---|---|
| 0 | Available | 7 | Suspended EV |
| 1 | Preparing | 8 | Suspended EVSE |
| 2 | Charging | 9 | Update |
| 3 | Finishing | 10 | Card Activation |
| 4 | Faulted | 11 | Start Delay |
| 5 | Unavailable | 12 | Charge Pause |
| 6 | Reserved | 13 | Stopping |
Üzemmód
Az Üzemmód (Pracovný režim) egy többértékű kapcsoló négy értékkel: STOP, FAST, ECO és GREEN. Kiolvassa a töltő aktuális üzemmódját, és a TapHome-ból újat állít be. Az ECO és a GREEN a fenti Solar forgatókönyvnél leírtak szerint működik, és attól függ, hogy a töltő kommunikál-e a napelem inverterrel vagy a mérővel.
Szervizakciók
A töltő állapotát jelző eszköz négy szervizakciót tartalmaz:
- Töltés indítása (
Spustiť nabíjanie) és Töltés leállítása (Zastaviť nabíjanie). - Zárolás / elérhetővé tétel (
Zamknúť / sprístupniť nabíjačku), a Zárolás (Zamknúť) és az Elérhetővé tétel (Sprístupniť) értékkel. - Áramkorlát beállítása (
Nastaviť limit prúdu): 6–32 A a 7 kW-os és a 22 kW-os modelleken, 6–16 A a 11 kW-os modellen.
A parancsok aszinkronok. Az „OK, príkaz odoslaný” válasz azt jelenti, hogy a SolaX felhő elfogadta a parancsot, nem azt, hogy a töltő már végre is hajtotta. Az eredmény a következő ciklusok értékeiben jelenik meg.
Kártya- és munkamenet-előzmények a diagramokban
- Az RFID-kártya (
RFID karta) a munkamenetet elindító kártya számát mutatja, vagy 0-t, ha nem használtak kártyát. - A Munkamenet töltési ideje (
Čas nabíjania relácie) az aktuális munkamenet időtartamát mutatja percben.
A SolaX API nem ad kártyaelőzményeket. Ha erre a két változóra bekapcsolod a diagramokat (Charts), a TapHome maga építi fel az előzményeket: melyik kártya töltött, mikor és mennyi ideig, 60 másodperces felbontással. Kártyát a töltő csak akkor használ, ha az aktiválási módja a SolaXCloud alkalmazásban RFID-re van állítva (Charger setting > Activation mode). Az alapértelmezett Plug & Charge mód nem használ kártyát.
Hibaelhárítás
Nincs adat, vagy hitelesítési hiba a modulon
- Ellenőrizd, hogy a töltő online-e a SolaXCloud alkalmazásban. A töltő kijelzőjén lévő szerver ikon mutatja, hogy csatlakozik-e a SolaXCloudhoz.
- Ellenőrizd a
ClientIdés aClientSecretértékét az Authorization fülön. A portálon újragenerált secretet újra meg kell adni. - Ellenőrizd, hogy a
DeviceSNa töltő sorozatszáma-e, nem pedig a Registration No. - Ellenőrizd, hogy az alkalmazásnak van-e engedélyezett erőműve a töltővel, és hogy a monitorozó szolgáltatások engedélyezve vannak-e. A 10403 API-kód azt jelenti, hogy az API-szolgáltatásnak nincs hozzáférési joga. A 10500 kód azt jelenti, hogy az alkalmazásnak nincs jogosultsága ennek az eszköznek az adataihoz.
- A 10400 és a 10402 kód azt jelenti, hogy a token érvénytelen. A modul új tokent kér, és ugyanabban a ciklusban megismétli az olvasást. Ha a modul ezután is „aj po obnove tokenu” („a token megújítása után is”) szövegű hibát jelez, a hitelesítő adatok vagy az engedélyezett szolgáltatások hibásak.
Az értékek nem változnak
A 10405 és a 10406 kód azt jelenti, hogy betelt az API-hívások korlátja. A modul figyelmeztetést jelez, és megtartja az utolsó sikeres ciklus értékeit. A sablon percenként egy kérést küld. Az ugyanazt a SolaX fiókot olvasó más eszközök is ugyanebbe a korlátba számítanak bele.
Az üzemmód vagy a műveletek nem működnek
- Egy szervizakció a
SolaX API kód <code>szöveget adja vissza, ha a felhő elutasítja a parancsot. A 10403 kód (nincs hozzáférési jog az interfészhez) azt jelentheti, hogy az EV töltő vezérlési szolgáltatása nincs engedélyezve az alkalmazás számára. - Az ECO és a GREEN csak a Solar forgatókönyvben működik, és működő kapcsolatot igényel a napelem inverterrel vagy a CT-vel/mérővel. A Standard forgatókönyvben a töltő csak elindítja és leállítja a töltést.
Kereskedelmi telepítések
A sablon a töltőt egy lakossági erőmű részeként olvassa (businessType=1). A sablon szerzője szerint egy kereskedelmi és ipari erőműben lévő töltőhöz a 4-es érték kell, és ilyenkor a teljesítményértékek W helyett kW-ban vannak.
