Predložak SolaX HAC Cloud API povezuje TapHome s punionicom za električna vozila SolaX X1-HAC ili X3-HAC preko API-ja SolaX Developer Portala (OpenAPI). Autor predloška navodi i punionice A1-HAC i C1/C3-HAC. TapHome ne komunicira izravno s punionicom: punionica šalje podatke u SolaXCloud preko Wi-Fi mreže, LAN-a ili 4G mreže, a TapHome ih svakih 60 sekundi očitava iz SolaX oblaka preko HTTPS-a. Naredbe za upis (radni način, pokretanje i zaustavljanje, zaključavanje, ograničenje struje) na isti se način vraćaju punionici preko oblaka.
Prije uvoza predloška moraju biti ispunjena dva uvjeta. Punionica mora biti na mreži u računu SolaXCloud, a taj račun treba aplikaciju u SolaX Developer Portalu koja daje Client ID i Client Secret. Ako punionica radi uz SolaX solarni izmjenjivač (inverter), u istom TapHome projektu može raditi i predložak SolaX Inverter (Cloud API). On koristi stariji SolaxCloud API za nadzor s vlastitim tokenom.
Povezivanje punionice sa SolaXCloudom
Mrežna veza
Punionica se na internet može spojiti na tri načina. Svi koriste DHCP, pa IP adresu automatski dodjeljuje usmjerivač.
- Wi-Fi: samo 2,4 GHz (802.11 b/g/n). Mreže na 5 GHz nisu podržane.
- Ethernet (LAN): priključak RJ45 LAN (/ DI). Ethernet koristi pinove 1, 2, 3 i 6 (TX+, TX−, RX+, RX−). Kad je potreban samo Ethernet, ostale pinove ostavite nespojene. Uz LAN vezu postavljanje Wi-Fi mreže može se preskočiti.
- 4G: samo za modele s oznakom „4G” u nazivu (na primjer X3-HAC-22P-B4G). Ovlašteni stručnjak mora ugraditi nano SIM karticu koja podržava Cat-M, NB-IoT ili GSM. SolaX preporučuje najmanje 100 MB podataka mjesečno u scenarijima Solar i Standard.

Ethernet kabel do punionice mora biti zaštićen od udara groma. Ako su potrebni i LAN i signalni ulaz DI, krimpajte pinove 1, 2, 3 i 6 za Ethernet i pinove 4, 5 i 8 za DI, a zatim spojite oba kabela RJ45 spojnicom koja se isporučuje uz punionicu.
4G veza postavlja se u aplikaciji SolaXCloud u lokalnom načinu rada: otvorite Dongle, zatim gumb postavki, postavite Device Networking Mode na 4G, upišite APN operatera i odaberite vrstu mreže koju SIM kartica podržava.
Dodavanje punionice u aplikaciju SolaXCloud
- Instalirajte aplikaciju SolaXCloud iz App Storea ili Google Playa i registrirajte račun e-adresom ili brojem telefona i kontrolnim kodom.
- Pri prvoj prijavi izradite elektranu (plant): dopustite pristup lokaciji, upišite naziv elektrane i dovršite ostale postavke.
- Dodajte punionicu skeniranjem ili upisom broja Registration No. s njezine natpisne pločice. Punionice koje se dodaju kasnije dodaju se preko stranice Device, ikone +, a zatim Add Device ili Scan.
- Ako se punionica spaja preko Wi-Fi mreže, upišite naziv i lozinku Wi-Fi mreže.

Na natpisnoj pločici nalaze se dva različita broja. Registration No. služi za dodavanje punionice u aplikaciju i za lokalnu prijavu. SN (serijski broj uređaja) je ono što predložak TapHome treba kao DeviceSN. Aplikacija prikazuje SN uređaja na stranici punionice Basic information (dodirnite gornji dio stranice Details punionice). Naveden je i u Developer Portalu pod Device > Device List.
Ponovno spajanje na Wi-Fi i lokalni pristup
Ako punionica nije na mreži, u aplikaciji otvorite stranicu Device, dodirnite karticu punionice označenu kao offline i odaberite Reconfigure. Zatim ponovno upišite mrežu na 2,4 GHz i lozinku.

Ako ponovno postavljanje ne uspije, postoji drugi način. Spojite telefon ili prijenosno računalo na vlastitu Wi-Fi mrežu punionice, koja nosi naziv prema njezinu broju Registration No. (Wifi_XC…). Zatim u pregledniku otvorite http://192.168.10.10/ i prijavite se kao admin, s brojem Registration No. kao lozinkom. Lokalni način rada u aplikaciji (More > Local Access ili, kad ste prijavljeni, Service > Application > Local Access) koristi istu mrežu.
Punionica automatski isključuje svoju lokalnu Wi-Fi mrežu sat vremena nakon uspješnog spajanja na mrežu. Za kasniji lokalni pristup ponovno uključite mrežu u aplikaciji pod Network > Local Access.
Scenarij primjene i načini punjenja
Punionica radi u jednom od tri scenarija primjene, koji se odabire u aplikaciji pod Advanced setting > Application scene:
- Solar (zadano): dostupni su načini punjenja Green, Eco i Fast. Za Green i Eco punionica mora komunicirati s izmjenjivačem ili sa strujnim transformatorom (CT) odnosno brojilom na priključku na mrežu, kako bi znala višak fotonaponske proizvodnje.
- Standard: punionica samo pokreće i zaustavlja punjenje. Green i Eco u ovom scenariju ne postoje.
- OCPP: punionicom upravlja OCPP poslužitelj, a aplikacija SolaXCloud skriva odabir načina.

Izmjenjivač se spaja na priključak COM1-S- (A1/B1). Brojilo ili CT spaja se na priključak COM2-M- (A2/B2, CT ulazi na ostalim pinovima). Razina struje punjenja za način Green (3 A ili 6 A) i za način Eco (6, 10, 16, 20 ili 25 A) postavlja se u aplikaciji pod Details > Function Control > Charge Level. Na modelima od 11 kW Eco nudi samo 6 A i 10 A. Punjenje u načinima Green i Eco zahtijeva i vozilo koje je u skladu s normom IEC 61851.
Postavljanje pristupa API-ju u SolaX Developer Portalu
- Prijavite se u SolaX Developer Portal i otvorite Quick Start ili Application.
- Izradite aplikaciju za elektranu SolaXCloud u kojoj je punionica. Aplikacija mora imati barem jednu autoriziranu elektranu.
- Na kartici Authorization aplikacije kopirajte Client ID i Client Secret.
- Pod Service API > Authorize uključite usluge nadzora Data Monitoring Service (
API_Telemetry_V2) i Information Access Service (API_Info_V2). Uključite i uslugu upravljanja punionicom, koju trebaju prekidač radnog načina i servisne radnje. Sam nadzor radi i bez nje. - Serijski broj punionice pronađite pod Device > Device List. To je isti SN kao u aplikaciji SolaXCloud.
Predložak je postavljen na europski API poslužitelj
openapi-eu.solaxcloud.com. SolaX ima zasebne poslužitelje za Kinu (openapi-cn.solaxcloud.com) i Indiju (openapi-in.solaxcloud.com). Regija računa prikazana je u Developer Portalu. S aplikacijom iz druge regije predložak u uvezenom obliku ne radi.
Parametri uvoza
U sustavu TapHome uvezite predložak i ispunite tri parametra navedena u nastavku. Sve ostalo (token, očitavanje, ponovni pokušaji) obavlja modul.
| Parametar | Opis | Gdje ga pronaći |
|---|---|---|
ClientId | Client ID aplikacije u Developer Portalu | Application > Authorization |
ClientSecret | Client Secret iste aplikacije | Application > Authorization |
DeviceSN | Serijski broj punionice (ne Registration No.) | Developer Portal Device > Device List ili Basic information u aplikaciji SolaXCloud |
Jedan par Client ID i Client Secret koristite samo za jednog klijenta. Svaka aplikacija ima samo jedan važeći pristupni token, pa novi zahtjev za token poništava prethodni. Druga instanca predloška TapHome ili drugi alat koji očitava s istim pristupnim podacima stalno poništava token ovog predloška. Za drugu punionicu ili za drugi sustav izradite zasebnu aplikaciju u Developer Portalu.
Mogućnosti uređaja
Nazivi uređaja u predlošku su na slovačkom. Svaki je u nastavku naveden s nazivom u aplikaciji u zagradi.
Snaga i energija punjenja
Snaga punjenja (Nabíjací výkon) je brojilo. Prikazuje trenutačnu snagu punjenja u kW i ukupnu napunjenu energiju u kWh. Njegovi servisni atributi prikazuju energiju tekuće sesije (Energia aktuálnej relácie [kWh]), fazne struje L1, L2 i L3 (Prúd L1 [A], Prúd L2 [A], Prúd L3 [A]) i jednofaznu struju (Jednofázový prúd [A]).
Stanje punjenja i statusni kod
- Punjenje u tijeku (
Nabíjanie prebieha) je kontakt. Uključen je (Nabíja) samo dok punionica javlja status Charging. U svakom drugom statusu isključen je (Nenabíja), uključujući Suspended EV i Suspended EVSE. - Status punionice (
Stav nabíjačky) je izvorni statusni kod punionice:
| Kod | Status | Kod | Status |
|---|---|---|---|
| 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 |
Radni način
Radni način (Pracovný režim) je uređaj Prekidač s više vrijednosti s četiri stanja: STOP, FAST, ECO i GREEN. Očitava trenutačni način punionice i postavlja novi iz sustava TapHome. ECO i GREEN ponašaju se kako je opisano gore kod scenarija Solar i ovise o komunikaciji punionice s izmjenjivačem ili brojilom.
Servisne radnje
Uređaj statusa punionice ima četiri servisne radnje:
- Pokretanje punjenja (
Spustiť nabíjanie) i Zaustavljanje punjenja (Zastaviť nabíjanie). - Zaključavanje / omogućavanje (
Zamknúť / sprístupniť nabíjačku), s vrijednostima Zaključaj (Zamknúť) i Omogući (Sprístupniť). - Postavljanje ograničenja struje (
Nastaviť limit prúdu): 6–32 A na modelima od 7 kW i 22 kW, 6–16 A na modelu od 11 kW.
Naredbe su asinkrone. Odgovor „OK, príkaz odoslaný” znači da je SolaX oblak prihvatio naredbu, a ne da ju je punionica već izvršila. Rezultat se vidi u očitanjima sljedećih ciklusa.
Povijest kartica i sesija u grafikonima
- RFID kartica (
RFID karta) prikazuje broj kartice koja je pokrenula sesiju ili 0 kad se kartica ne koristi. - Trajanje punjenja u sesiji (
Čas nabíjania relácie) prikazuje trajanje tekuće sesije u minutama.
SolaX API ne daje povijest kartica. Kad su na ove dvije varijable uključeni grafikoni (Charts), TapHome sam gradi povijest: koja je kartica punila, kada i koliko dugo, s razlučivošću od 60 sekundi. Kartice se koriste samo kad je način aktivacije punionice u aplikaciji SolaXCloud postavljen na RFID (Charger setting > Activation mode). Zadani način Plug & Charge ne koristi karticu.
Rješavanje problema
Nema podataka ili greška autentifikacije na modulu
- Provjerite je li punionica na mreži u aplikaciji SolaXCloud. Ikona poslužitelja na zaslonu punionice pokazuje je li spojena na SolaXCloud.
- Provjerite
ClientIdiClientSecretprema kartici Authorization. Tajni ključ ponovno generiran u portalu treba ponovno upisati. - Provjerite je li
DeviceSNserijski broj punionice, a ne Registration No. - Provjerite ima li aplikacija autoriziranu elektranu s punionicom i jesu li autorizirane usluge nadzora. API kod 10403 znači da usluga API-ja nema prava pristupa. Kod 10500 znači da aplikacija nema dopuštenje za podatke ovog uređaja.
- Kodovi 10400 i 10402 znače da token nije valjan. Modul zatraži novi token i ponovi očitavanje u istom ciklusu. Ako modul i dalje javlja grešku s tekstom „aj po obnove tokenu” („čak i nakon obnove tokena”), pogrešni su pristupni podaci ili autorizirane usluge.
Očitanja se prestaju mijenjati
Kodovi 10405 i 10406 znače da je dosegnuto ograničenje broja API poziva. Modul prikazuje upozorenje i zadržava vrijednosti iz posljednjeg uspješnog ciklusa. Predložak šalje jedan zahtjev u minuti. Drugi alati koji očitavaju isti SolaX račun troše isto ograničenje.
Radni način ili radnje ne rade
- Servisna radnja vraća tekst
SolaX API kód <code>kad oblak odbije naredbu. Kod 10403 (nema prava pristupa sučelju) može značiti da usluga upravljanja punionicom nije autorizirana za aplikaciju. - ECO i GREEN rade samo u scenariju Solar i trebaju ispravnu vezu s izmjenjivačem ili CT-om odnosno brojilom. U scenariju Standard punionica samo pokreće i zaustavlja punjenje.
Komercijalne instalacije
Predložak očitava punionicu kao dio kućne elektrane (businessType=1). Prema autoru predloška punionica u komercijalnoj i industrijskoj elektrani treba vrijednost 4, a njezine se vrijednosti snage tada iskazuju u kW umjesto u W.
