Szablon SolaX HAC Cloud API łączy TapHome z ładowarką EV SolaX X1-HAC lub X3-HAC przez API SolaX Developer Portal (OpenAPI). Autor szablonu wymienia także ładowarki A1-HAC i C1/C3-HAC. TapHome nie komunikuje się z ładowarką bezpośrednio: ładowarka przesyła dane do SolaXCloud przez Wi-Fi, LAN lub 4G, a TapHome co 60 sekund odczytuje je z chmury SolaX przez HTTPS. Polecenia zapisu (tryb pracy, start i stop, blokada, limit prądu) wracają do ładowarki tą samą drogą przez chmurę.
Przed importem szablonu muszą być spełnione dwa warunki. Ładowarka musi być online na koncie SolaXCloud, a to konto potrzebuje aplikacji w SolaX Developer Portal, która udostępnia Client ID i Client Secret. Jeśli ładowarka pracuje obok falownika solarnego SolaX, w tym samym projekcie TapHome może działać szablon SolaX Inverter (Cloud API). Korzysta on ze starszego API monitoringu SolaxCloud z własnym tokenem.
Podłączenie ładowarki do SolaXCloud
Połączenie sieciowe
Ładowarka ma trzy sposoby połączenia z internetem. Wszystkie korzystają z DHCP, więc router przydziela adres IP automatycznie.
- Wi-Fi: tylko 2,4 GHz (802.11 b/g/n). Sieci 5 GHz nie są obsługiwane.
- Ethernet (LAN): port RJ45 LAN (/ DI). Ethernet wykorzystuje piny 1, 2, 3 i 6 (TX+, TX−, RX+, RX−). Gdy potrzebny jest tylko Ethernet, pozostałe piny zostaw niepodłączone. Przy połączeniu LAN konfigurację Wi-Fi można pominąć.
- 4G: tylko w modelach z „4G” w nazwie (na przykład X3-HAC-22P-B4G). Kartę nano SIM obsługującą Cat-M, NB-IoT lub GSM musi zamontować uprawniony specjalista. SolaX zaleca co najmniej 100 MB danych miesięcznie w scenach Solar i Standard.

Kabel Ethernet do ładowarki musi być zabezpieczony przed wyładowaniami atmosferycznymi. Jeśli potrzebne są zarówno LAN, jak i wejście sygnałowe DI, zaciśnij piny 1, 2, 3 i 6 dla Ethernetu oraz piny 4, 5 i 8 dla DI, a następnie połącz oba kable złączką RJ45 dostarczoną z ładowarką.
Połączenie 4G konfiguruje się w aplikacji SolaXCloud w trybie lokalnym: otwórz Dongle, następnie przycisk ustawień, ustaw Device Networking Mode na 4G, wpisz APN operatora i wybierz typ sieci obsługiwany przez kartę SIM.
Dodanie ładowarki w aplikacji SolaXCloud
- Zainstaluj aplikację SolaXCloud z App Store lub Google Play i zarejestruj konto za pomocą adresu e-mail lub numeru telefonu oraz kodu weryfikacyjnego.
- Przy pierwszym logowaniu utwórz instalację: zezwól na dostęp do lokalizacji, wpisz nazwę instalacji i dokończ pozostałe ustawienia.
- Dodaj ładowarkę, skanując lub wpisując Registration No. z jej tabliczki znamionowej. Kolejne ładowarki dodasz przez stronę Device, ikonę +, a następnie Add Device lub Scan.
- Wpisz nazwę i hasło sieci Wi-Fi, jeśli ładowarka łączy się przez Wi-Fi.

Na tabliczce znamionowej są dwa różne numery. Registration No. służy do dodania ładowarki w aplikacji i do lokalnego logowania. SN (numer seryjny urządzenia) to wartość, której szablon TapHome potrzebuje jako DeviceSN. Aplikacja pokazuje SN urządzenia na stronie Basic information ładowarki (stuknij górną część strony Details ładowarki). Numer jest też podany w Developer Portal w Device > Device List.
Ponowne połączenie Wi-Fi i dostęp lokalny
Jeśli ładowarka przejdzie w stan offline, otwórz w aplikacji stronę Device, stuknij kartę ładowarki oznaczoną jako offline i wybierz Reconfigure. Następnie ponownie wpisz sieć 2,4 GHz i hasło.

Jeśli ponowna konfiguracja się nie powiedzie, jest drugi sposób. Połącz telefon lub laptop z własną siecią Wi-Fi ładowarki, nazwaną od jej Registration No. (Wifi_XC…). Następnie otwórz w przeglądarce http://192.168.10.10/ i zaloguj się jako admin, podając Registration No. jako hasło. Tryb lokalny w aplikacji (More > Local Access lub po zalogowaniu Service > Application > Local Access) korzysta z tej samej sieci.
Ładowarka automatycznie wyłącza swoją lokalną sieć Wi-Fi godzinę po udanym połączeniu z siecią. Aby później skorzystać z dostępu lokalnego, włącz tę sieć ponownie w aplikacji w Network > Local Access.
Scena zastosowania i tryby ładowania
Ładowarka pracuje w jednej z trzech scen zastosowania, którą wybierasz w aplikacji w Advanced setting > Application scene:
- Solar (domyślna): dostępne są tryby ładowania Green, Eco i Fast. Green i Eco wymagają komunikacji ładowarki z falownikiem solarnym albo z przekładnikiem prądowym (CT) lub licznikiem na przyłączu sieciowym, aby ładowarka znała nadwyżkę PV.
- Standard: ładowarka tylko uruchamia i zatrzymuje ładowanie. W tej scenie nie ma trybów Green i Eco.
- OCPP: ładowarka jest zarządzana przez serwer OCPP, a aplikacja SolaXCloud ukrywa wybór trybu.

Falownik solarny podłącza się do portu COM1-S- (A1/B1). Licznik lub CT podłącza się do portu COM2-M- (A2/B2, wejścia CT na pozostałych pinach). Poziom prądu ładowania dla trybu Green (3 A lub 6 A) i dla trybu Eco (6, 10, 16, 20 lub 25 A) ustawiasz w aplikacji w Details > Function Control > Charge Level. W modelach 11 kW tryb Eco oferuje tylko 6 A i 10 A. Ładowanie w trybach Green i Eco wymaga też pojazdu zgodnego z IEC 61851.
Konfiguracja dostępu do API w SolaX Developer Portal
- Zaloguj się do SolaX Developer Portal i otwórz Quick Start lub Application.
- Utwórz aplikację dla instalacji SolaXCloud, do której należy ładowarka. Aplikacja musi mieć co najmniej jedną autoryzowaną instalację.
- Na karcie Authorization aplikacji skopiuj Client ID i Client Secret.
- W Service API > Authorize włącz usługi monitoringu Data Monitoring Service (
API_Telemetry_V2) i Information Access Service (API_Info_V2). Włącz także usługę sterowania ładowarką EV, której potrzebują przełączanie trybu pracy i działania serwisowe. Sam monitoring działa bez niej. - Numer seryjny ładowarki znajdziesz w Device > Device List. To ten sam SN co w aplikacji SolaXCloud.
Szablon jest ustawiony na europejski host API
openapi-eu.solaxcloud.com. SolaX prowadzi osobne hosty dla Chin (openapi-cn.solaxcloud.com) i Indii (openapi-in.solaxcloud.com). Region konta jest widoczny w Developer Portal. Po imporcie, bez zmian, szablon nie działa z aplikacją z innego regionu.
Parametry importu
W TapHome zaimportuj szablon i wypełnij trzy poniższe parametry. Wszystko inne (token, odpytywanie, ponowienia) obsługuje moduł.
| Parametr | Opis | Gdzie znaleźć |
|---|---|---|
ClientId | Client ID aplikacji w Developer Portal | Application > Authorization |
ClientSecret | Client Secret tej samej aplikacji | Application > Authorization |
DeviceSN | Numer seryjny ładowarki (nie Registration No.) | Developer Portal Device > Device List lub Basic information w aplikacji SolaXCloud |
Jednej pary Client ID i Client Secret używaj tylko dla jednego klienta. Każda aplikacja ma tylko jeden ważny token dostępu, więc nowe żądanie tokenu unieważnia poprzedni. Druga instancja szablonu TapHome lub inne narzędzie odpytujące z tymi samymi danymi uwierzytelniającymi stale unieważnia token tego szablonu. Dla drugiej ładowarki lub dla innego systemu utwórz osobną aplikację w Developer Portal.
Możliwości urządzenia
Nazwy urządzeń w szablonie są po słowacku. Poniżej przy każdym z nich podano w nawiasie jego nazwę w aplikacji.
Moc i energia ładowania
Moc ładowania (Nabíjací výkon) to licznik elektryczny. Pokazuje bieżącą moc ładowania w kW i całkowitą energię ładowania w kWh. Jego atrybuty serwisowe pokazują energię bieżącej sesji (Energia aktuálnej relácie [kWh]), prądy fazowe L1, L2 i L3 (Prúd L1 [A], Prúd L2 [A], Prúd L3 [A]) oraz prąd jednofazowy (Jednofázový prúd [A]).
Stan ładowania i kod stanu
- Ładowanie w toku (
Nabíjanie prebieha) to kontaktron. Jest włączony (Nabíja) tylko wtedy, gdy ładowarka zgłasza stan Charging. W każdym innym stanie jest wyłączony (Nenabíja), także w stanach Suspended EV i Suspended EVSE. - Stan ładowarki (
Stav nabíjačky) to surowy kod stanu ładowarki:
| Kod | Stan | Kod | Stan |
|---|---|---|---|
| 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 |
Tryb pracy
Tryb pracy (Pracovný režim) to przełącznik wielowartościowy z czterema wartościami: STOP, FAST, ECO i GREEN. Odczytuje bieżący tryb ładowarki i ustawia nowy z TapHome. ECO i GREEN działają tak, jak opisano wyżej przy scenie Solar, i zależą od komunikacji ładowarki z falownikiem solarnym lub licznikiem.
Działania serwisowe
Urządzenie stanu ładowarki ma cztery działania serwisowe:
- Uruchom ładowanie (
Spustiť nabíjanie) i Zatrzymaj ładowanie (Zastaviť nabíjanie). - Zablokuj / udostępnij (
Zamknúť / sprístupniť nabíjačku), z wartościami Zablokuj (Zamknúť) i Udostępnij (Sprístupniť). - Ustaw limit prądu (
Nastaviť limit prúdu): 6–32 A w modelach 7 kW i 22 kW, 6–16 A w modelu 11 kW.
Polecenia są asynchroniczne. Odpowiedź „OK, príkaz odoslaný” oznacza, że chmura SolaX przyjęła polecenie, a nie że ładowarka już je wykonała. Wynik pojawia się w odczytach kolejnych cykli.
Historia kart i sesji na wykresach
- Karta RFID (
RFID karta) pokazuje numer karty, która rozpoczęła sesję, lub 0, gdy karta nie jest używana. - Czas ładowania sesji (
Čas nabíjania relácie) pokazuje czas trwania bieżącej sesji w minutach.
API SolaX nie udostępnia historii kart. Gdy włączysz wykresy dla tych dwóch zmiennych, TapHome sam zbuduje historię: która karta ładowała, kiedy i jak długo, z rozdzielczością 60 sekund. Karty są używane tylko wtedy, gdy tryb aktywacji ładowarki w aplikacji SolaXCloud jest ustawiony na RFID (Charger setting > Activation mode). Domyślny tryb Plug & Charge nie używa karty.
Rozwiązywanie problemów
Brak danych lub błąd uwierzytelniania na module
- Sprawdź, czy ładowarka jest online w aplikacji SolaXCloud. Ikona serwera na wyświetlaczu ładowarki pokazuje, czy jest połączona z SolaXCloud.
- Porównaj
ClientIdiClientSecretz kartą Authorization. Secret wygenerowany ponownie w portalu trzeba wpisać od nowa. - Sprawdź, czy
DeviceSNto numer seryjny ładowarki, a nie Registration No. - Sprawdź, czy aplikacja ma autoryzowaną instalację z ładowarką i czy usługi monitoringu są autoryzowane. Kod API 10403 oznacza, że usługa API nie ma praw dostępu. Kod 10500 oznacza, że aplikacja nie ma uprawnień do danych tego urządzenia.
- Kody 10400 i 10402 oznaczają, że token jest nieważny. Moduł żąda nowego tokenu i powtarza odczyt w tym samym cyklu. Jeśli moduł nadal zgłasza błąd z tekstem „aj po obnove tokenu” („nawet po odnowieniu tokenu”), dane uwierzytelniające lub autoryzowane usługi są błędne.
Odczyty przestają się zmieniać
Kody 10405 i 10406 oznaczają, że osiągnięto limit wywołań API. Moduł wyświetla ostrzeżenie i zachowuje wartości z ostatniego udanego cyklu. Szablon wysyła jedno zapytanie na minutę. Inne narzędzia odczytujące to samo konto SolaX liczą się do tego samego limitu.
Tryb pracy lub działania serwisowe kończą się błędem
- Działanie serwisowe zwraca tekst
SolaX API kód <code>, gdy chmura odrzuci polecenie. Kod 10403 (brak praw dostępu do interfejsu) może oznaczać, że usługa sterowania ładowarką EV nie jest autoryzowana dla aplikacji. - ECO i GREEN działają tylko w scenie Solar i wymagają działającego połączenia z falownikiem solarnym lub z CT/licznikiem. W scenie Standard ładowarka tylko uruchamia i zatrzymuje ładowanie.
Instalacje komercyjne
Szablon odczytuje ładowarkę jako część instalacji domowej (businessType=1). Według autora szablonu ładowarka w instalacji komercyjnej i przemysłowej wymaga wartości 4, a jej wartości mocy są wtedy podawane w kW zamiast w W.
