
go-e Gemini flex je zidna punionica za električna vozila austrijske proizvodnje, dostupna u varijantama 11 kW (16 A) i 22 kW (32 A), a noviji model Gemini flex 2.0 ima ugrađen 4G LTE. TapHome s punionicom komunicira preko njezina lokalnog HTTP API v2 putem Wi-Fi mreže, bez potrebe za vezom s oblakom. API je potrebno izričito uključiti u aplikaciji go-e prije nego što se TapHome može spojiti.
Predložak omogućuje praćenje stanja punionice, upravljanje strujom punjenja, načinom punjenja i prisilnim stanjem, preklapanje faza, očitanje napona i struje po fazama, brojilo energije te ulaze samo za upis za vanjske podatke o snazi solarne elektrane i mreže, koji omogućuju punjenje viškom energije.
Konfiguracija
Uključivanje HTTP API-ja
Lokalni HTTP API v2 zadano je isključen. Za uključivanje:
- Spojite se na go-e Charger aplikacijom go-e (dostupna za iOS i Android)
- Otvorite Settings > Connection > API Settings
- Uključite „Allow access to local HTTP API vX”
Nakon uključivanja punionica odgovara na HTTP zahtjeve na portu 80. Autentifikacija nije potrebna, pristup se kontrolira isključivo ovim prekidačem.
Mrežne postavke
go-e Gemini flex spaja se preko Wi-Fi mreže (802.11b/g/n, samo 2,4 GHz). Žičani Ethernet priključak nema. Pri uvozu predloška u TapHome unesite IP adresu punionice.
go-e Charger ne podržava otkrivanje preko mDNS-a. Kako biste izbjegli probleme s povezivanjem nakon obnove DHCP zakupa, u usmjerivaču za MAC adresu punionice postavite statičku IP adresu ili DHCP rezervaciju.
Punionica može raditi u načinu hotspot (izravna veza) ili se spojiti na postojeću Wi-Fi mrežu. Za integraciju s TapHome punionica mora biti u istoj mreži kao TapHome CCU.
Mogućnosti uređaja
Stanje punionice
Uređaj Stanje punionice prikazuje trenutačno stanje priključenosti i punjenja kao indikator s više vrijednosti, samo za čitanje. API ključ car vraća jedno od pet stanja: Kvar (0), Dostupna (1), Punjenje (2), Priprema (3) ili Završeno (4). Tako se automatizacije u sustavu TapHome mogu pokretati ovisno o tome je li vozilo priključeno, puni li se ili je punjenje završeno.
Upravljanje strujom i načinom punjenja
Dva upravljiva uređaja određuju rad punionice:
Struja punjenja — odabire traženu struju punjenja između šest diskretnih vrijednosti: 6, 8, 10, 12, 14 i 16 A. Predložak ih preslikava na položaje prekidača s više vrijednosti 0–5 formulom
amp/2 - 3pri čitanju i(position + 3) × 2pri upisu. Vrijednosti se punionici šalju prekoapi/set?amp={value}.Način punjenja — odabire logiku punjenja: Osnovni (zadano neprekidno punjenje), Eco (optimizirano prema cijeni preko tarife Awattar) ili Dnevna vožnja (automatsko zaustavljanje nakon postizanja cilja). API koristi redom vrijednosti 3, 4 i 5, a predložak ih preslikava na položaje 0, 1 i 2.
Uređaj Struja punjenja preslikava samo šest vrijednosti (6–16 A u koracima od 2 A). Varijanta Gemini flex od 22 kW podržava do 32 A, ali vrijednosti iznad 16 A ovaj predložak ne pokriva. Za veće struje API ključ
ampmože se postaviti izravno, izvan predloška.
Prisilno stanje
Uređaj Prisilno stanje ima prednost pred odlukom punionice o tome hoće li puniti. API ključ frc prihvaća Neutralno (0 — odlučuje punionica), Zaustavljeno (1 — punjenje blokirano) i Punjenje (2 — punjenje prisilno uključeno). Vrijednost se upisuje preko api/set?frc={value} i čita natrag iz odgovora o stanju, zbog čega ova revizija predloška dodaje frc u filtar api/status.
Uređaj prikazuje i položaje 3–9 s brojčanim privremenim oznakama naslijeđenima iz predloška. API go-e za njih ne definira nikakvo značenje, pa koristite samo Neutralno, Zaustavljeno i Punjenje.
Preklapanje faza
Uređaj Preklapanje faza određuje koliko faza punionica koristi: Automatski (0), Jednofazno (1) ili Trofazno (2). go-e Charger podržava preklapanje faza čak i tijekom aktivnog punjenja. U automatskom načinu punionica odabire optimalnu konfiguraciju faza prema raspoloživoj snazi.
Praćenje energije
Predložak čita napon i struju po fazama iz podatkovnog polja nrg punionice, koje sadrži 16 vrijednosti osvježenih u svakom ciklusu očitavanja:
| Uređaj | Izvor | Jedinica |
|---|---|---|
| Napon L1 | nrg[0] | V |
| Napon L2 | nrg[1] | V |
| Napon L3 | nrg[2] | V |
| Struja L1 | nrg[4] | A |
| Struja L2 | nrg[5] | A |
| Struja L3 | nrg[6] | A |
Uređaj Brojilo punionice prikazuje ukupnu isporučenu energiju iz ključa eto (Wh) i trenutačnu snagu iz nrg[11] podijeljenu s 1000. Zamjenjuje dosadašnji uređaj Current Consumption. Sve vrijednosti energije su samo za čitanje.
Predložak čita fazne struje iz
nrg[4],nrg[5]inrg[6], a snagu brojila iznrg[11]. Prema dokumentaciji API-ja go-e fazne struje nalaze se na indeksima 5, 6 i 7, snaga neutralnog vodiča na indeksu 11, a ukupna snaga na indeksu 12. Upravo njih je koristila prethodna revizija predloška. Prije nego što se na očitanja oslonite za obračun ili automatizacije, usporedite ih s vrijednostima na punionici.
Ulazi za punjenje viškom solarne energije
Dva uređaja samo za upis omogućuju sustavu TapHome da punionici šalje vanjske podatke o energiji za izračun punjenja viškom energije:
- Snaga prema mreži — šalje trenutačnu snagu predaje u mrežu ili preuzimanja iz mreže (u kW, pretvara se u W množenjem s 1000) preko
api/set?ids={"pGrid":value} - Snaga solarne elektrane — šalje trenutačnu proizvodnju fotonaponskog sustava (u kW, pretvara se u W množenjem s 1000) preko
api/set?ids={"pPv":value}
Ovi uređaji ne čitaju podatke s punionice. go-e Charger sam ne mjeri snagu mreže ni solarne elektrane, nego se oslanja na vanjske izvore tih podataka. U uobičajenoj instalaciji TapHome vrijednosti iz zasebnog brojila ili solarnog izmjenjivača (također integriranih u TapHome) prosljeđuju se punionici preko ovih uređaja samo za upis, pa način punjenja Eco može optimizirati vlastitu potrošnju.
Za punjenje viškom solarne energije postavite Način punjenja na Eco, a zatim automatizacijama u sustavu TapHome periodički upisujte trenutačnu snagu mreže i proizvodnju solarne elektrane u uređaje Snaga prema mreži i Snaga solarne elektrane. Punionica će struju punjenja automatski prilagođavati raspoloživom višku.
Dodatne mogućnosti
go-e Charger API v2 daje i dodatne podatke koji trenutačno nisu mapirani u predlošku: snagu po fazama (W) i faktor snage, napon neutralnog vodiča, ukupnu snagu (nrg[12]), energiju po sesiji (wh), kodove stanja pogreške, ograničenje struje kabela, temperaturne senzore, frekvenciju mreže, postavke ograničenja energije i konfiguraciju najmanje/najveće struje. Mogu se dodati u budućem ažuriranju predloška.
Rješavanje problema
Uređaj ne odgovara
- Provjerite je li punionica spojena na Wi-Fi i ima li valjanu IP adresu — u aplikaciji go-e pod Settings > Connection
- Provjerite je li HTTP API uključen (Settings > Connection > API Settings)
- U pregledniku otvorite
http://{charger-ip}/api/status— ako odgovori u formatu JSON, API je dostupan - Provjerite jesu li TapHome CCU i punionica u istoj mreži / VLAN-u
Struja punjenja se ne mijenja
- Predložak preslikava samo šest vrijednosti (6, 8, 10, 12, 14, 16 A). Ako punionica prikazuje drugu vrijednost (npr. 20 A postavljenih u aplikaciji), TapHome prikazuje najbliži preslikani položaj
- Provjerite ima li punionica firmver 051.4 ili noviji — stariji firmver koristi drugačiju sintaksu filtra, što može uzrokovati probleme pri raščlambi
Punjenje viškom solarne energije ne radi
- Provjerite je li Način punjenja postavljen na Eco — logika viška aktivira se samo u tom načinu
- Provjerite upisuju li se vrijednosti Snaga prema mreži i Snaga solarne elektrane redovito (najmanje svakih 30 sekundi)
- Provjerite jesu li vrijednosti u kW (predložak ih automatski pretvara u W)
- Otvorite
http://{charger-ip}/api/status?filter=pgrid,ppvi provjerite prima li punionica vrijednosti
API ključ
eto(ukupna energija) sada je dostupan kao uređaj Brojilo punionice, pa se vrijednost dohvaćena u filtru stanja više ne ostavlja neiskorištenom.