
go-e Gemini flex to austriacki wallbox EV dostępny w wariantach 11 kW (16 A) i 22 kW (32 A), a nowszy model Gemini flex 2.0 posiada zintegrowany moduł 4G LTE. TapHome komunikuje się z ładowarką poprzez lokalne HTTP API v2 przez Wi-Fi — połączenie z chmurą nie jest wymagane. API należy jawnie włączyć w aplikacji go-e, zanim TapHome będzie mógł się połączyć.
Szablon zapewnia monitorowanie stanu ładowarki, sterowanie prądem, trybem ładowania i wymuszonym stanem, przełączanie faz, odczyty napięcia i prądu na poszczególnych fazach, licznik energii oraz wejścia tylko do zapisu dla zewnętrznych danych mocy FV i sieciowej umożliwiające ładowanie nadwyżką.
Konfiguracja
Włączenie HTTP API
Lokalne HTTP API v2 jest domyślnie wyłączone. Aby je włączyć:
- Połącz się z go-e Charger przez aplikację go-e (dostępna na iOS i Android)
- Przejdź do Ustawienia > Połączenie > Ustawienia API
- Włącz „Zezwól na dostęp do lokalnego HTTP API vX"
Po włączeniu ładowarka odpowiada na żądania HTTP na porcie 80. Uwierzytelnianie nie jest wymagane — dostęp jest kontrolowany wyłącznie przez ten przełącznik.
Konfiguracja sieci
go-e Gemini flex łączy się przez Wi-Fi (802.11b/g/n, tylko 2,4 GHz). Port Ethernet nie jest dostępny. Podczas importu szablonu TapHome wprowadź adres IP ładowarki.
go-e Charger nie obsługuje mDNS. Aby zapobiec problemom z łącznością po odnowieniu DHCP, skonfiguruj statyczny adres IP lub rezerwację DHCP na routerze dla adresu MAC ładowarki.
Ładowarka może działać w trybie hotspot (połączenie bezpośrednie) lub dołączyć do istniejącej sieci Wi-Fi. Do integracji z TapHome ładowarka musi znajdować się w tej samej sieci co TapHome CCU.
Możliwości urządzenia
Stan ładowarki
Urządzenie Stan ładowarki raportuje bieżący stan połączenia i ładowania jako wielowartościowy wskaźnik (tylko do odczytu). Klucz API car zwraca jeden z pięciu stanów: Awaria (0), Dostępna (1), Ładowanie (2), Przygotowanie (3) lub Zakończone (4). Umożliwia to automatyzacjom TapHome reagowanie na to, czy pojazd jest podłączony, aktywnie się ładuje, czy zakończył sesję.
Sterowanie prądem i trybem ładowania
Dwa sterowalne urządzenia zarządzają sposobem działania ładowarki:
Prąd ładowania — wybiera żądany prąd ładowania spośród sześciu dyskretnych wartości: 6, 8, 10, 12, 14 i 16 A. Szablon mapuje je na pozycje przełącznika 0–5 za pomocą wzoru
amp/2 - 3do odczytu i(position + 3) × 2do zapisu. Wartości są wysyłane do ładowarki przezapi/set?amp={value}.Tryb ładowania — wybiera logikę ładowania: Podstawowy (domyślne ciągłe ładowanie), Eco (optymalizacja cenowa przez taryfę Awattar) lub Codzienna trasa (automatyczne zatrzymanie po osiągnięciu celu). API używa wartości 3, 4 i 5; szablon mapuje je na pozycje 0, 1 i 2.
Selektor prądu ładowania mapuje tylko sześć wartości (6–16 A w krokach co 2 A). Wariant 22 kW ładowarki Gemini flex obsługuje do 32 A, ale wartości powyżej 16 A nie są objęte tym szablonem. Aby użyć wyższych prądów, klucz API
ampmożna ustawić bezpośrednio poza szablonem.
Wymuszony stan
Urządzenie Wymuszony stan nadpisuje własną decyzję ładowarki o tym, czy ma ładować. Klucz API frc przyjmuje wartości Neutralny (0 — decyduje ładowarka), Zatrzymane (1 — ładowanie zablokowane) i Ładuj (2 — ładowanie wymuszone). Wartość zapisywana jest przez api/set?frc={value} i odczytywana z odpowiedzi statusu, dlatego ta wersja szablonu dodaje frc do filtra api/status.
Selektor wymienia również pozycje 3–9 z liczbowymi etykietami zastępczymi odziedziczonymi z szablonu. API go-e nie nadaje im żadnego znaczenia — używaj wyłącznie wartości Neutralny, Zatrzymane i Ładuj.
Przełączanie faz
Urządzenie Przełączanie faz kontroluje liczbę faz używanych przez ładowarkę: Automatyczne (0), 1-fazowe (1) lub 3-fazowe (2). go-e Charger obsługuje przełączanie faz nawet podczas aktywnej sesji ładowania. W trybie automatycznym ładowarka wybiera optymalną konfigurację faz na podstawie dostępnej mocy.
Monitorowanie energii
Szablon odczytuje napięcie i prąd na poszczególnych fazach z tablicy energetycznej nrg ładowarki, która zawiera 16 wartości aktualizowanych w każdym cyklu odpytywania:
| Urządzenie | Źródło | Jednostka |
|---|---|---|
| L1 Napięcie | nrg[0] | V |
| L2 Napięcie | nrg[1] | V |
| L3 Napięcie | nrg[2] | V |
| L1 Prąd | nrg[4] | A |
| L2 Prąd | nrg[5] | A |
| L3 Prąd | nrg[6] | A |
Urządzenie Licznik energii ładowarki raportuje całkowitą dostarczoną energię z klucza eto (Wh) oraz chwilowy pobór z nrg[11] podzielony przez 1000. Zastępuje wcześniejsze urządzenie Bieżące zużycie. Wszystkie wartości energetyczne są tylko do odczytu.
Szablon odczytuje prądy fazowe z
nrg[4],nrg[5]inrg[6], a pobór licznika znrg[11]. Dokumentacja API go-e umieszcza prądy fazowe pod indeksami 5, 6 i 7, moc przewodu neutralnego pod indeksem 11, a moc całkowitą pod indeksem 12 — dokładnie tak działała poprzednia wersja szablonu. Przed użyciem do rozliczeń lub automatyzacji sprawdź odczyty na ładowarce.
Wejścia do ładowania nadwyżką FV
Dwa urządzenia tylko do zapisu umożliwiają TapHome przesyłanie zewnętrznych danych energetycznych do ładowarki w celu obliczania ładowania nadwyżką:
- Moc do sieci — wysyła bieżącą moc eksportu/importu sieciowego (w kW, przeliczoną na W przez pomnożenie przez 1000) przez
api/set?ids={"pGrid":value} - Moc FV — wysyła bieżącą produkcję fotowoltaiczną (w kW, przeliczoną na W przez pomnożenie przez 1000) przez
api/set?ids={"pPv":value}
Te urządzenia nie odczytują danych z ładowarki. go-e Charger sam nie mierzy mocy sieciowej ani FV — polega na zewnętrznych źródłach dostarczających te informacje. W typowej konfiguracji TapHome wartości z oddzielnego licznika energii lub falownika solarnego (również zintegrowanego z TapHome) są przekazywane do ładowarki przez te urządzenia tylko do zapisu, umożliwiając tryb ładowania Eco optymalizację samozużycia.
Aby korzystać z ładowania nadwyżką FV, ustaw Tryb ładowania na Eco, a następnie za pomocą automatyzacji TapHome regularnie zapisuj bieżące wartości mocy sieciowej i produkcji FV do urządzeń Moc do sieci i Moc FV. Ładowarka automatycznie dostosuje prąd ładowania na podstawie dostępnej nadwyżki.
Dodatkowe możliwości
API go-e Charger v2 udostępnia dodatkowe dane, które obecnie nie są mapowane w szablonie: moc na fazę (W) i współczynnik mocy, napięcie przewodu neutralnego, moc całkowita (nrg[12]), energia sesji (wh), kody stanów błędów, limit prądu kabla, czujniki temperatury, częstotliwość sieci, ustawienia limitu energii oraz konfiguracja minimalnego/maksymalnego prądu. Mogą zostać dodane w przyszłej aktualizacji szablonu.
Rozwiązywanie problemów
Urządzenie nie odpowiada
- Sprawdź, czy ładowarka jest połączona z Wi-Fi i ma prawidłowy adres IP — sprawdź w aplikacji go-e w sekcji Ustawienia > Połączenie
- Potwierdź, że HTTP API jest włączone (Ustawienia > Połączenie > Ustawienia API)
- Otwórz
http://{charger-ip}/api/statusw przeglądarce — jeśli odpowiada JSON-em, API jest osiągalne - Sprawdź, czy TapHome CCU i ładowarka są w tej samej sieci / VLAN
Prąd ładowania się nie zmienia
- Szablon mapuje tylko sześć wartości (6, 8, 10, 12, 14, 16 A). Jeśli ładowarka pokazuje inną wartość (np. 20 A ustawione przez aplikację), TapHome wyświetli najbliższą zmapowaną pozycję
- Sprawdź, czy firmware ładowarki to wersja 051.4 lub nowsza — starszy firmware używa innej składni filtra, co może powodować problemy z parsowaniem
Ładowanie nadwyżką FV nie działa
- Potwierdź, że Tryb ładowania jest ustawiony na Eco — logika nadwyżki aktywuje się tylko w tym trybie
- Sprawdź, czy wartości Moc do sieci i Moc FV są zapisywane regularnie (co najmniej co 30 sekund)
- Sprawdź, czy wartości są w kW (szablon automatycznie konwertuje na W)
- Otwórz
http://{charger-ip}/api/status?filter=pgrid,ppvaby sprawdzić, czy ładowarka odbiera wartości
Klucz API
eto(całkowita energia) jest teraz udostępniony jako urządzenie Licznik energii ładowarki — wartość pobierana w filtrze stanu nie pozostaje już niewykorzystana.