Šablona SolaX HAC Cloud API propojí TapHome s nabíječkou elektromobilů SolaX X1-HAC nebo X3-HAC přes API SolaX Developer Portalu (OpenAPI). Autor šablony uvádí také nabíječky A1-HAC a C1/C3-HAC. TapHome s nabíječkou nekomunikuje přímo: nabíječka se hlásí do SolaXCloud přes Wi-Fi, LAN nebo 4G a TapHome čte její data ze SolaX cloudu přes HTTPS každých 60 sekund. Zapisovací příkazy (pracovní režim, spuštění a zastavení, zamknutí, limit proudu) jdou zpět do nabíječky stejnou cestou přes cloud.
Před importem šablony musí být splněny dvě věci. Nabíječka musí být online v účtu SolaXCloud a tento účet potřebuje v SolaX Developer Portalu aplikaci, která poskytne Client ID a Client Secret. Pokud nabíječka pracuje společně se střídačem SolaX, může ve stejném projektu TapHome běžet i šablona SolaX Inverter (Cloud API). Ta používá starší monitorovací API SolaxCloud s vlastním tokenem.
Připojení nabíječky k SolaXCloud
Síťové připojení
Nabíječka se může připojit k internetu třemi způsoby. Všechny používají DHCP, takže IP adresu přidělí router automaticky.
- Wi-Fi: pouze 2,4 GHz (802.11 b/g/n). Sítě 5 GHz nejsou podporovány.
- Ethernet (LAN): port RJ45 LAN (/ DI). Ethernet používá piny 1, 2, 3 a 6 (TX+, TX−, RX+, RX−). Pokud je potřeba jen Ethernet, ostatní piny nechte nezapojené. Při připojení přes LAN lze nastavení Wi-Fi přeskočit.
- 4G: pouze pro modely se „4G“ v názvu (například X3-HAC-22P-B4G). Nano SIM kartu s podporou Cat-M, NB-IoT nebo GSM musí vložit oprávněný odborník. SolaX doporučuje alespoň 100 MB dat měsíčně ve scénářích Solar a Standard.

Ethernetový kabel k nabíječce musí být chráněn před úderem blesku. Pokud je potřeba LAN i signálový vstup DI, nakrimpujte piny 1, 2, 3 a 6 pro Ethernet a piny 4, 5 a 8 pro DI a oba kabely pak spojte spojkou RJ45, která je součástí balení nabíječky.
Připojení 4G se nastavuje v aplikaci SolaXCloud v lokálním režimu: otevřete Dongle, poté tlačítko nastavení, nastavte Device Networking Mode na 4G, zadejte APN operátora a zvolte typ sítě, který SIM karta podporuje.
Přidání nabíječky v aplikaci SolaXCloud
- Nainstalujte aplikaci SolaXCloud z App Store nebo Google Play a zaregistrujte účet pomocí e-mailové adresy nebo telefonního čísla a ověřovacího kódu.
- Při prvním přihlášení vytvořte elektrárnu (plant): povolte přístup k poloze, zadejte název elektrárny a dokončete ostatní nastavení.
- Přidejte nabíječku naskenováním nebo zadáním Registration No. z jejího typového štítku. Později přidávané nabíječky se přidávají přes stránku Device, ikonu + a poté Add Device nebo Scan.
- Pokud se nabíječka připojuje přes Wi-Fi, zadejte název a heslo sítě Wi-Fi.

Na typovém štítku jsou dvě různá čísla. Registration No. slouží k přidání nabíječky v aplikaci a k lokálnímu přihlášení. SN (sériové číslo zařízení) je to, co šablona TapHome potřebuje jako DeviceSN. Aplikace zobrazuje SN zařízení na stránce nabíječky Basic information (klepněte na horní část stránky Details nabíječky). Najdete ho také v Developer Portalu v části Device > Device List.
Opětovné připojení Wi-Fi a lokální přístup
Pokud je nabíječka offline, otevřete v aplikaci stránku Device, klepněte na kartu nabíječky označenou jako offline a zvolte Reconfigure. Poté znovu zadejte síť 2,4 GHz a heslo.

Pokud nové nastavení selže, existuje druhý způsob. Připojte telefon nebo notebook k vlastní síti Wi-Fi nabíječky, která je pojmenována podle jejího Registration No. (Wifi_XC…). Poté v prohlížeči otevřete http://192.168.10.10/ a přihlaste se jako admin s Registration No. jako heslem. Lokální režim v aplikaci (More > Local Access, nebo Service > Application > Local Access po přihlášení) používá stejnou síť.
Nabíječka svou lokální síť Wi-Fi automaticky vypne hodinu po úspěšném připojení k síti. Chcete-li lokální přístup použít později, síť znovu zapněte v aplikaci v části Network > Local Access.
Scénář použití a režimy nabíjení
Nabíječka pracuje v jednom ze tří scénářů použití, který se volí v aplikaci v části Advanced setting > Application scene:
- Solar (výchozí): k dispozici jsou režimy nabíjení Green, Eco a Fast. Green a Eco vyžadují, aby nabíječka komunikovala se střídačem nebo s proudovým transformátorem (CT) či elektroměrem na přípojce sítě, aby znala přebytek FV výroby.
- Standard: nabíječka pouze spouští a zastavuje nabíjení. Green a Eco v tomto scénáři neexistují.
- OCPP: nabíječka je řízena přes OCPP server a aplikace SolaXCloud volbu režimu skryje.

Střídač se připojuje na port COM1-S- (A1/B1). Elektroměr nebo proudový transformátor (CT) se připojuje na port COM2-M- (A2/B2, vstupy CT na ostatních pinech). Úroveň nabíjecího proudu pro režim Green (3 A nebo 6 A) a pro režim Eco (6, 10, 16, 20 nebo 25 A) se nastavuje v aplikaci v části Details > Function Control > Charge Level. U modelů 11 kW nabízí Eco pouze 6 A a 10 A. Nabíjení v režimech Green a Eco navíc vyžaduje vozidlo, které splňuje normu IEC 61851.
Nastavení přístupu k API v SolaX Developer Portalu
- Přihlaste se do SolaX Developer Portalu a otevřete Quick Start nebo Application.
- Vytvořte aplikaci pro elektrárnu SolaXCloud, která obsahuje nabíječku. Aplikace musí mít alespoň jednu autorizovanou elektrárnu.
- Na kartě aplikace Authorization zkopírujte Client ID a Client Secret.
- V části Service API > Authorize zapněte monitorovací služby Data Monitoring Service (
API_Telemetry_V2) a Information Access Service (API_Info_V2). Zapněte také službu ovládání nabíječky elektromobilů, kterou potřebuje přepínač pracovního režimu a servisní akce. Samotné monitorování funguje i bez ní. - Sériové číslo nabíječky najdete v části Device > Device List. Je to stejné SN jako v aplikaci SolaXCloud.
Šablona je nastavena na evropský API host
openapi-eu.solaxcloud.com. SolaX provozuje samostatné hosty pro Čínu (openapi-cn.solaxcloud.com) a Indii (openapi-in.solaxcloud.com). Region účtu je uveden v Developer Portalu. S aplikací v jiném regionu šablona v importované podobě nefunguje.
Parametry importu
V TapHome importujte šablonu a vyplňte tři parametry uvedené níže. Vše ostatní (token, dotazování, opakované pokusy) řeší modul.
| Parametr | Popis | Kde ho najít |
|---|---|---|
ClientId | Client ID aplikace v Developer Portalu | Application > Authorization |
ClientSecret | Client Secret stejné aplikace | Application > Authorization |
DeviceSN | Sériové číslo nabíječky (ne Registration No.) | Developer Portal Device > Device List nebo Basic information v aplikaci SolaXCloud |
Jednu dvojici Client ID a Client Secret používejte pouze pro jednoho klienta. Každá aplikace má jen jeden platný přístupový token, takže nová žádost o token zruší předchozí. Druhá instance šablony TapHome nebo jiný nástroj, který se dotazuje se stejnými přístupovými údaji, bude token této šablony neustále rušit. Pro druhou nabíječku nebo pro jiný systém vytvořte v Developer Portalu samostatnou aplikaci.
Možnosti zařízení
Názvy zařízení v šabloně jsou ve slovenštině. Každé je níže uvedeno s názvem v aplikaci v závorce.
Nabíjecí výkon a energie
Nabíjecí výkon (Nabíjací výkon) je elektroměr. Zobrazuje aktuální nabíjecí výkon v kW a celkovou nabitou energii v kWh. Jeho servisní atributy zobrazují energii aktuální relace (Energia aktuálnej relácie [kWh]), fázové proudy L1, L2 a L3 (Prúd L1 [A], Prúd L2 [A], Prúd L3 [A]) a jednofázový proud (Jednofázový prúd [A]).
Stav nabíjení a stavový kód
- Probíhá nabíjení (
Nabíjanie prebieha) je kontakt. Je zapnutý (Nabíja) pouze tehdy, když nabíječka hlásí stav Charging. Při každém jiném stavu je vypnutý (Nenabíja), včetně Suspended EV a Suspended EVSE. - Stav nabíječky (
Stav nabíjačky) je surový stavový kód nabíječ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 (Pracovný režim) je vícehodnotový přepínač se čtyřmi hodnotami: STOP, FAST, ECO a GREEN. Čte aktuální režim nabíječky a z TapHome nastavuje nový. ECO a GREEN se chovají tak, jak je popsáno u scénáře Solar výše, a závisí na komunikaci nabíječky se střídačem nebo elektroměrem.
Servisní akce
Zařízení stavu nabíječky má čtyři servisní akce:
- Spustit nabíjení (
Spustiť nabíjanie) a Zastavit nabíjení (Zastaviť nabíjanie). - Zamknout / zpřístupnit (
Zamknúť / sprístupniť nabíjačku) s hodnotami Zamknout (Zamknúť) a Zpřístupnit (Sprístupniť). - Nastavit limit proudu (
Nastaviť limit prúdu): 6–32 A u modelů 7 kW a 22 kW, 6–16 A u modelu 11 kW.
Příkazy jsou asynchronní. Odpověď „OK, príkaz odoslaný“ znamená, že SolaX cloud příkaz přijal, ne že ho nabíječka už provedla. Výsledek se projeví v hodnotách následujících cyklů.
Historie karet a relací v grafech
- RFID karta (
RFID karta) zobrazuje číslo karty, která relaci spustila, nebo 0, když se karta nepoužívá. - Čas nabíjení relace (
Čas nabíjania relácie) zobrazuje dobu trvání aktuální relace v minutách.
SolaX API historii karet neposkytuje. Když jsou u těchto dvou proměnných zapnuté grafy, TapHome si historii vytvoří sám: která karta nabíjela, kdy a jak dlouho, s rozlišením 60 sekund. Karty se používají pouze tehdy, když je režim aktivace nabíječky v aplikaci SolaXCloud nastaven na RFID (Charger setting > Activation mode). Výchozí režim Plug & Charge kartu nepoužívá.
Řešení problémů
Žádná data nebo chyba ověření na modulu
- Zkontrolujte, zda je nabíječka online v aplikaci SolaXCloud. Ikona serveru na displeji nabíječky ukazuje, zda je připojena k SolaXCloud.
- Zkontrolujte
ClientIdaClientSecretvůči kartě Authorization. Secret, který byl v portálu znovu vygenerován, je nutné zadat znovu. - Zkontrolujte, zda je
DeviceSNsériové číslo nabíječky, ne Registration No. - Zkontrolujte, zda má aplikace autorizovanou elektrárnu s nabíječkou a zda jsou autorizovány monitorovací služby. Kód API 10403 znamená, že služba API nemá přístupová práva. Kód 10500 znamená, že aplikace nemá oprávnění k datům tohoto zařízení.
- Kódy 10400 a 10402 znamenají, že token není platný. Modul si vyžádá nový token a čtení zopakuje ve stejném cyklu. Pokud modul i potom hlásí chybu s textem „aj po obnove tokenu“ („i po obnovení tokenu“), přístupové údaje nebo autorizované služby jsou chybné.
Hodnoty se přestanou měnit
Kódy 10405 a 10406 znamenají, že byl dosažen limit volání API. Modul zobrazí upozornění a ponechá hodnoty z posledního úspěšného cyklu. Šablona posílá jeden požadavek za minutu. Do stejného limitu se započítávají i další nástroje, které čtou stejný účet SolaX.
Pracovní režim nebo akce selhávají
- Servisní akce vrátí text
SolaX API kód <code>, když cloud příkaz odmítne. Kód 10403 (žádná přístupová práva k rozhraní) může znamenat, že pro aplikaci není autorizována služba ovládání nabíječky elektromobilů. - ECO a GREEN fungují pouze ve scénáři Solar a potřebují funkční spojení se střídačem nebo s proudovým transformátorem (CT) či elektroměrem. Ve scénáři Standard nabíječka pouze spouští a zastavuje nabíjení.
Komerční instalace
Šablona čte nabíječku jako součást rezidenční elektrárny (businessType=1). Podle autora šablony potřebuje nabíječka v komerční a průmyslové elektrárně hodnotu 4 a její hodnoty výkonu jsou pak v kW místo W.
