
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 i trybem ładowania, przełączanie faz, odczyty napięcia i prądu na poszczególnych fazach 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.
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[5] | A |
| L2 Prąd | nrg[6] | A |
| L3 Prąd | nrg[7] | A |
| Bieżące zużycie | nrg[12] | W |
Urządzenie Bieżące zużycie raportuje całkowitą aktywną moc ładowania w watach. Wszystkie wartości energetyczne są tylko do odczytu.
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, całkowita zużyta energia (eto w Wh), energia sesji (wh), kody stanów błędów, limit prądu kabla, czujniki temperatury, częstotliwość sieci, sterowanie wymuszonym stanem ładowania, 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 zawarty w filtrze stanu, ale nie jest udostępniony jako urządzenie w szablonie. Wartość całkowitej energii jest pobierana, ale nie jest wykorzystywana.