
go-e Gemini flex je rakúsky EV wallbox dostupný vo variantoch 11 kW (16 A) a 22 kW (32 A), pričom novší model Gemini flex 2.0 obsahuje integrovaný 4G LTE modul. TapHome komunikuje s nabíjačkou cez lokálne HTTP API v2 po Wi-Fi — nie je potrebné cloudové pripojenie. API je potrebné explicitne povoliť v aplikácii go-e pred pripojením TapHome.
Šablóna poskytuje monitorovanie stavu nabíjačky, ovládanie nabíjacieho prúdu a režimu, prepínanie fáz, meranie napätia a prúdu na jednotlivých fázach a zapisovacie vstupy pre externé FV a sieťové dáta umožňujúce prebytkovú nabíjanie.
Konfigurácia
Povolenie HTTP API
Lokálne HTTP API v2 je predvolene vypnuté. Na jeho povolenie:
- Pripojte sa k go-e Charger cez aplikáciu go-e (dostupná pre iOS a Android)
- Prejdite do Nastavenia > Pripojenie > Nastavenia API
- Povoľte „Povoliť prístup k lokálnemu HTTP API vX"
Po povolení nabíjačka odpovedá na HTTP požiadavky na porte 80. Autentifikácia nie je vyžadovaná — prístup sa riadi výlučne týmto prepínačom.
Nastavenie siete
go-e Gemini flex sa pripája cez Wi-Fi (802.11b/g/n, len 2,4 GHz). Ethernetový port nie je k dispozícii. Pri importe šablóny TapHome zadajte IP adresu nabíjačky.
go-e Charger nepodporuje mDNS. Aby ste predišli problémom s pripojením po obnovení DHCP, nakonfigurujte statickú IP adresu alebo DHCP rezerváciu na routeri pre MAC adresu nabíjačky.
Nabíjačka môže pracovať v režime hotspot (priame pripojenie) alebo sa pripojiť k existujúcej Wi-Fi sieti. Pre integráciu s TapHome musí byť nabíjačka v rovnakej sieti ako TapHome CCU.
Možnosti zariadenia
Stav nabíjačky
Zariadenie Stav nabíjačky zobrazuje aktuálny stav pripojenia a nabíjania ako viachodnotový indikátor (len na čítanie). API kľúč car vracia jeden z piatich stavov: Porucha (0), Dostupná (1), Nabíjanie (2), Príprava (3) alebo Dokončené (4). To umožňuje automatizáciám TapHome reagovať na to, či je vozidlo pripojené, aktívne sa nabíja alebo dokončilo reláciu.
Ovládanie nabíjacieho prúdu a režimu
Dve ovládateľné zariadenia riadia spôsob fungovania nabíjačky:
Nabíjací prúd — vyberá požadovaný nabíjací prúd zo šiestich diskrétnych hodnôt: 6, 8, 10, 12, 14 a 16 A. Šablóna mapuje tieto hodnoty na pozície prepínača 0–5 pomocou vzorca
amp/2 - 3pre čítanie a(position + 3) × 2pre zápis. Hodnoty sa odosielajú na nabíjačku cezapi/set?amp={value}.Režim nabíjania — vyberá logiku nabíjania: Základný (predvolené nepretržité nabíjanie), Eco (cenovo optimalizované cez tarif Awattar) alebo Denná cesta (automatické zastavenie po dosiahnutí cieľa). API používa hodnoty 3, 4 a 5; šablóna ich mapuje na pozície 0, 1 a 2.
Selektor nabíjacieho prúdu mapuje len šesť hodnôt (6–16 A v krokoch po 2 A). Variant 22 kW nabíjačky Gemini flex podporuje až 32 A, no hodnoty nad 16 A nie sú pokryté touto šablónou. Pre použitie vyšších prúdov je možné nastaviť API kľúč
amppriamo mimo šablónu.
Prepínanie fáz
Zariadenie Prepínanie fáz riadi počet fáz používaných nabíjačkou: Automaticky (0), 1-fázový (1) alebo 3-fázový (2). go-e Charger podporuje prepínanie fáz aj počas aktívnej nabíjacej relácie. V automatickom režime nabíjačka zvolí optimálnu konfiguráciu fáz podľa dostupného výkonu.
Meranie energie
Šablóna číta napätie a prúd na jednotlivých fázach z poľa nrg nabíjačky, ktoré obsahuje 16 hodnôt aktualizovaných v každom cykle dotazovania:
| Zariadenie | Zdroj | Jednotka |
|---|---|---|
| L1 Napätie | nrg[0] | V |
| L2 Napätie | nrg[1] | V |
| L3 Napätie | nrg[2] | V |
| L1 Prúd | nrg[5] | A |
| L2 Prúd | nrg[6] | A |
| L3 Prúd | nrg[7] | A |
| Aktuálna spotreba | nrg[12] | W |
Zariadenie Aktuálna spotreba zobrazuje celkový aktívny nabíjací výkon vo wattoch. Všetky energetické hodnoty sú len na čítanie.
Vstupy pre prebytkovú FV nabíjanie
Dve zariadenia (len na zápis) umožňujú TapHome zasielať externé energetické dáta do nabíjačky pre výpočty prebytkovej nabíjania:
- Výkon do siete — odosiela aktuálny výkon exportu/importu do siete (v kW, konvertovaný na W násobením 1000) cez
api/set?ids={"pGrid":value} - FV výkon — odosiela aktuálnu fotovoltaickú produkciu (v kW, konvertovanú na W násobením 1000) cez
api/set?ids={"pPv":value}
Tieto zariadenia nečítajú dáta z nabíjačky. go-e Charger sám nemeria výkon siete ani FV — spolieha sa na externé zdroje, ktoré mu tieto informácie poskytujú. V typickej konfigurácii TapHome sa hodnoty zo samostatného elektromeru alebo solárneho striedača (tiež integrovaného v TapHome) preposielajú na nabíjačku cez tieto zapisovacie zariadenia, čím sa aktivuje režim Eco na optimalizáciu vlastnej spotreby.
Pre použitie prebytkovej FV nabíjania nastavte režim nabíjania na Eco a potom pomocou automatizácií TapHome pravidelne zapisujte aktuálne hodnoty výkonu siete a FV produkcie do zariadení Výkon do siete a FV výkon. Nabíjačka automaticky prispôsobí nabíjací prúd podľa dostupného prebytku.
Ďalšie možnosti
API go-e Charger v2 sprístupňuje ďalšie dáta, ktoré momentálne nie sú mapované v šablóne: výkon na fázu (W) a účinník, napätie neutrálneho vodiča, celkovú spotrebovanú energiu (eto vo Wh), energiu za reláciu (wh), kódy chybových stavov, prúdový limit kábla, teplotné senzory, frekvenciu siete, riadenie núteného nabíjania, nastavenia energetického limitu a konfiguráciu minimálneho/maximálneho prúdu. Tieto je možné pridať v budúcej aktualizácii šablóny.
Riešenie problémov
Zariadenie neodpovedá
- Overte, že nabíjačka je pripojená k Wi-Fi a má platnú IP adresu — skontrolujte v aplikácii go-e v časti Nastavenia > Pripojenie
- Potvrďte, že HTTP API je povolené (Nastavenia > Pripojenie > Nastavenia API)
- Otvorte
http://{charger-ip}/api/statusv prehliadači — ak odpovie JSON, API je dostupné - Skontrolujte, že TapHome CCU a nabíjačka sú v rovnakej sieti / VLAN
Nabíjací prúd sa nemení
- Šablóna mapuje len šesť hodnôt (6, 8, 10, 12, 14, 16 A). Ak nabíjačka zobrazuje inú hodnotu (napr. 20 A nastavenú cez aplikáciu), TapHome zobrazí najbližšiu mapovanú pozíciu
- Overte, že firmware nabíjačky je verzia 051.4 alebo novšia — starší firmware používa odlišnú syntax filtra, čo môže spôsobiť problémy s parsovaním
Prebytková FV nabíjanie nefunguje
- Potvrďte, že režim nabíjania je nastavený na Eco — logika prebytku sa aktivuje len v tomto režime
- Overte, že hodnoty Výkon do siete a FV výkon sa zapisujú pravidelne (aspoň každých 30 sekúnd)
- Skontrolujte, že hodnoty sú v kW (šablóna ich automaticky konvertuje na W)
- Otvorte
http://{charger-ip}/api/status?filter=pgrid,ppvna overenie, že nabíjačka prijíma hodnoty
API kľúč
eto(celková energia) je zahrnutý vo filtri stavu, ale nie je exponovaný ako zariadenie v šablóne. Hodnota celkovej energie sa načítava, ale nepoužíva.