Šablóna SolaX HAC Cloud API prepojí TapHome s nabíjačkou elektromobilov SolaX X1-HAC alebo X3-HAC cez API SolaX Developer Portalu (OpenAPI). Autor šablóny uvádza aj nabíjačky A1-HAC a C1/C3-HAC. TapHome s nabíjačkou nekomunikuje priamo: nabíjačka sa hlási do SolaXCloud cez Wi-Fi, LAN alebo 4G a TapHome číta jej dáta zo SolaX cloudu cez HTTPS každých 60 sekúnd. Zapisovacie príkazy (pracovný režim, spustenie a zastavenie, zamknutie, limit prúdu) idú späť do nabíjačky rovnakou cestou cez cloud.
Pred importom šablóny musia byť splnené dve veci. Nabíjačka musí byť online v účte SolaXCloud a tento účet potrebuje v SolaX Developer Portali aplikáciu, ktorá poskytne Client ID a Client Secret. Ak nabíjačka pracuje spolu so solárnym invertorom SolaX, v tom istom projekte TapHome môže bežať aj šablóna SolaX Inverter (Cloud API). Tá používa staršie monitorovacie API SolaxCloud s vlastným tokenom.
Pripojenie nabíjačky k SolaXCloud
Sieťové pripojenie
Nabíjačka sa môže pripojiť na internet tromi spôsobmi. Všetky používajú DHCP, takže IP adresu pridelí router automaticky.
- Wi-Fi: len 2,4 GHz (802.11 b/g/n). Siete 5 GHz nie sú podporované.
- Ethernet (LAN): port RJ45 LAN (/ DI). Ethernet používa piny 1, 2, 3 a 6 (TX+, TX−, RX+, RX−). Ak je potrebný len Ethernet, ostatné piny nechajte nezapojené. Pri pripojení cez LAN sa dá nastavenie Wi-Fi preskočiť.
- 4G: len pre modely s „4G“ v názve (napríklad X3-HAC-22P-B4G). Nano SIM kartu s podporou Cat-M, NB-IoT alebo GSM musí vložiť oprávnený odborník. SolaX odporúča aspoň 100 MB dát mesačne v scenároch Solar a Standard.

Ethernetový kábel k nabíjačke musí byť chránený pred úderom blesku. Ak je potrebný LAN aj signálový vstup DI, nalisujte piny 1, 2, 3 a 6 pre Ethernet a piny 4, 5 a 8 pre DI a oba káble potom spojte spojkou RJ45, ktorá je súčasťou balenia nabíjačky.
Pripojenie 4G sa nastavuje v aplikácii SolaXCloud v lokálnom režime: otvorte Dongle, potom tlačidlo nastavení, nastavte Device Networking Mode na 4G, zadajte APN operátora a zvoľte typ siete, ktorý SIM karta podporuje.
Pridanie nabíjačky v aplikácii SolaXCloud
- Nainštalujte aplikáciu SolaXCloud z App Store alebo Google Play a zaregistrujte účet pomocou e-mailovej adresy alebo telefónneho čísla a overovacieho kódu.
- Pri prvom prihlásení vytvorte elektráreň (plant): povoľte prístup k polohe, zadajte názov elektrárne a dokončite ostatné nastavenia.
- Pridajte nabíjačku naskenovaním alebo zadaním Registration No. z jej typového štítku. Neskôr pridávané nabíjačky sa pridávajú cez stránku Device, ikonu + a potom Add Device alebo Scan.
- Ak sa nabíjačka pripája cez Wi-Fi, zadajte názov a heslo siete Wi-Fi.

Na typovom štítku sú dve rôzne čísla. Registration No. slúži na pridanie nabíjačky v aplikácii a na lokálne prihlásenie. SN (sériové číslo zariadenia) je to, čo šablóna TapHome potrebuje ako DeviceSN. Aplikácia zobrazuje SN zariadenia na stránke nabíjačky Basic information (ťuknite na hornú časť stránky Details nabíjačky). Nájdete ho aj v Developer Portali v časti Device > Device List.
Opätovné pripojenie Wi-Fi a lokálny prístup
Ak je nabíjačka offline, otvorte v aplikácii stránku Device, ťuknite na kartu nabíjačky označenú ako offline a zvoľte Reconfigure. Potom znova zadajte sieť 2,4 GHz a heslo.

Ak nové nastavenie zlyhá, existuje druhý spôsob. Pripojte telefón alebo notebook k vlastnej sieti Wi-Fi nabíjačky, ktorá je pomenovaná podľa jej Registration No. (Wifi_XC…). Potom v prehliadači otvorte http://192.168.10.10/ a prihláste sa ako admin s Registration No. ako heslom. Lokálny režim v aplikácii (More > Local Access, alebo Service > Application > Local Access po prihlásení) používa tú istú sieť.
Nabíjačka svoju lokálnu sieť Wi-Fi automaticky vypne hodinu po úspešnom pripojení k sieti. Ak chcete lokálny prístup použiť neskôr, sieť znova zapnite v aplikácii v časti Network > Local Access.
Scenár použitia a režimy nabíjania
Nabíjačka pracuje v jednom z troch scenárov použitia, ktorý sa volí v aplikácii v časti Advanced setting > Application scene:
- Solar (predvolený): k dispozícii sú režimy nabíjania Green, Eco a Fast. Green a Eco vyžadujú, aby nabíjačka komunikovala so solárnym invertorom alebo s prúdovým transformátorom (CT) či elektromerom na prípojke siete, aby poznala prebytok FV výroby.
- Standard: nabíjačka len spúšťa a zastavuje nabíjanie. Green a Eco v tomto scenári neexistujú.
- OCPP: nabíjačka je riadená cez OCPP server a aplikácia SolaXCloud voľbu režimu skryje.

Solárny invertor sa pripája na port COM1-S- (A1/B1). Elektromer alebo prúdový transformátor (CT) sa pripája na port COM2-M- (A2/B2, vstupy CT na ostatných pinoch). Úroveň nabíjacieho prúdu pre režim Green (3 A alebo 6 A) a pre režim Eco (6, 10, 16, 20 alebo 25 A) sa nastavuje v aplikácii v časti Details > Function Control > Charge Level. Pri modeloch 11 kW ponúka Eco len 6 A a 10 A. Nabíjanie v režimoch Green a Eco tiež vyžaduje vozidlo, ktoré spĺňa normu IEC 61851.
Nastavenie prístupu k API v SolaX Developer Portali
- Prihláste sa do SolaX Developer Portalu a otvorte Quick Start alebo Application.
- Vytvorte aplikáciu pre elektráreň SolaXCloud, ktorá obsahuje nabíjačku. Aplikácia musí mať aspoň jednu autorizovanú elektráreň.
- Na karte aplikácie Authorization skopírujte Client ID a Client Secret.
- V časti Service API > Authorize zapnite monitorovacie služby Data Monitoring Service (
API_Telemetry_V2) a Information Access Service (API_Info_V2). Zapnite aj službu ovládania nabíjačky elektromobilov, ktorú potrebuje prepínač pracovného režimu a servisné akcie. Samotné monitorovanie funguje aj bez nej. - Sériové číslo nabíjačky nájdete v časti Device > Device List. Je to to isté SN ako v aplikácii SolaXCloud.
Šablóna je nastavená na európsky API host
openapi-eu.solaxcloud.com. SolaX prevádzkuje samostatné hosty pre Čínu (openapi-cn.solaxcloud.com) a Indiu (openapi-in.solaxcloud.com). Región účtu je uvedený v Developer Portali. S aplikáciou v inom regióne šablóna v importovanej podobe nefunguje.
Parametre importu
V TapHome importujte šablónu a vyplňte tri parametre uvedené nižšie. Všetko ostatné (token, dopytovanie, opakované pokusy) rieši modul.
| Parameter | Popis | Kde ho nájsť |
|---|---|---|
ClientId | Client ID aplikácie v Developer Portali | Application > Authorization |
ClientSecret | Client Secret tej istej aplikácie | Application > Authorization |
DeviceSN | Sériové číslo nabíjačky (nie Registration No.) | Developer Portal Device > Device List alebo Basic information v aplikácii SolaXCloud |
Jednu dvojicu Client ID a Client Secret používajte len pre jedného klienta. Každá aplikácia má len jeden platný prístupový token, takže nová žiadosť o token zruší predchádzajúci. Druhá inštancia šablóny TapHome alebo iný nástroj, ktorý dopytuje s tými istými prístupovými údajmi, bude token tejto šablóny neustále rušiť. Pre druhú nabíjačku alebo pre iný systém vytvorte v Developer Portali samostatnú aplikáciu.
Možnosti zariadenia
Názvy zariadení v šablóne sú v slovenčine. Nižšie je každé uvedené presne tak, ako ho zobrazí aplikácia.
Nabíjací výkon a energia
Nabíjací výkon je elektromer. Zobrazuje aktuálny nabíjací výkon v kW a celkovú nabitú energiu v kWh. Jeho servisné atribúty zobrazujú energiu aktuálnej relácie (Energia aktuálnej relácie [kWh]), fázové prúdy L1, L2 a L3 (Prúd L1 [A], Prúd L2 [A], Prúd L3 [A]) a jednofázový prúd (Jednofázový prúd [A]).
Stav nabíjania a stavový kód
Nabíjanie prebiehaje kontakt. Je zapnutý (Nabíja) len vtedy, keď nabíjačka hlási stav Charging. Pri každom inom stave je vypnutý (Nenabíja), vrátane Suspended EV a Suspended EVSE.Stav nabíjačkyje surový stavový kód nabíjačky:
| Kód | Stav | Kód | Stav |
|---|---|---|---|
| 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 |
Pracovný režim
Pracovný režim je viachodnotový prepínač so štyrmi hodnotami: STOP, FAST, ECO a GREEN. Číta aktuálny režim nabíjačky a z TapHome nastavuje nový. ECO a GREEN sa správajú tak, ako je opísané pri scenári Solar vyššie, a závisia od komunikácie nabíjačky so solárnym invertorom alebo elektromerom.
Servisné akcie
Zariadenie stavu nabíjačky má štyri servisné akcie:
Spustiť nabíjanieaZastaviť nabíjanie.Zamknúť / sprístupniť nabíjačkus hodnotamiZamknúťaSprístupniť.Nastaviť limit prúdu: 6–32 A pri modeloch 7 kW a 22 kW, 6–16 A pri modeli 11 kW.
Príkazy sú asynchrónne. Odpoveď „OK, príkaz odoslaný“ znamená, že SolaX cloud príkaz prijal, nie že ho nabíjačka už vykonala. Výsledok sa prejaví v hodnotách nasledujúcich cyklov.
História kariet a relácií v grafoch
RFID kartazobrazuje číslo karty, ktorá reláciu spustila, alebo 0, keď sa karta nepoužíva.Čas nabíjania reláciezobrazuje trvanie aktuálnej relácie v minútach.
SolaX API históriu kariet neposkytuje. Keď sú pri týchto dvoch premenných zapnuté grafy, TapHome si históriu vytvorí sám: ktorá karta nabíjala, kedy a ako dlho, s rozlíšením 60 sekúnd. Karty sa používajú len vtedy, keď je režim aktivácie nabíjačky v aplikácii SolaXCloud nastavený na RFID (Charger setting > Activation mode). Predvolený režim Plug & Charge kartu nepoužíva.
Riešenie problémov
Žiadne dáta alebo chyba overenia na module
- Skontrolujte, či je nabíjačka online v aplikácii SolaXCloud. Ikona servera na displeji nabíjačky ukazuje, či je pripojená k SolaXCloud.
- Skontrolujte
ClientIdaClientSecretvoči karte Authorization. Secret, ktorý bol v portáli vygenerovaný znova, treba zadať znova. - Skontrolujte, či je
DeviceSNsériové číslo nabíjačky, nie Registration No. - Skontrolujte, či má aplikácia autorizovanú elektráreň s nabíjačkou a či sú autorizované monitorovacie služby. Kód API 10403 znamená, že služba API nemá prístupové práva. Kód 10500 znamená, že aplikácia nemá oprávnenie na dáta tohto zariadenia.
- Kódy 10400 a 10402 znamenajú, že token nie je platný. Modul si vyžiada nový token a čítanie zopakuje v tom istom cykle. Ak modul aj potom hlási chybu s textom „aj po obnove tokenu“, prístupové údaje alebo autorizované služby sú nesprávne.
Hodnoty sa prestanú meniť
Kódy 10405 a 10406 znamenajú, že sa dosiahol limit volaní API. Modul zobrazí upozornenie a ponechá hodnoty z posledného úspešného cyklu. Šablóna posiela jednu požiadavku za minútu. Do toho istého limitu sa započítavajú aj ďalšie nástroje, ktoré čítajú ten istý účet SolaX.
Pracovný režim alebo akcie zlyhávajú
- Servisná akcia vráti text
SolaX API kód <code>, keď cloud príkaz odmietne. Kód 10403 (žiadne prístupové práva k rozhraniu) môže znamenať, že pre aplikáciu nie je autorizovaná služba ovládania nabíjačky elektromobilov. - ECO a GREEN fungujú len v scenári Solar a potrebujú funkčné spojenie so solárnym invertorom alebo s prúdovým transformátorom (CT) či elektromerom. V scenári Standard nabíjačka len spúšťa a zastavuje nabíjanie.
Komerčné inštalácie
Šablóna číta nabíjačku ako súčasť rezidenčnej elektrárne (businessType=1). Podľa autora šablóny potrebuje nabíjačka v komerčnej a priemyselnej elektrárni hodnotu 4 a jej hodnoty výkonu sú potom v kW namiesto W.
