
go-e Gemini flex este o stație de încărcare EV fabricată în Austria, disponibilă în variantele de 11 kW (16 A) și 22 kW (32 A); modelul mai nou Gemini flex 2.0 are 4G LTE integrat. TapHome comunică cu stația de încărcare prin API-ul său HTTP local v2 pe Wi-Fi — nu este necesară conexiunea la cloud. Înainte ca TapHome să se poată conecta, API-ul trebuie activat explicit în aplicația go-e.
Șablonul oferă monitorizarea stării stației de încărcare, controlul curentului de încărcare, al modului și al forțării stării, comutarea fazelor, citirea tensiunii și a curentului pe fiecare fază, un contor electric și intrări doar pentru scriere pentru datele externe despre puterea PV și a rețelei, care permit încărcarea din surplus.
Configurare
Activarea HTTP API
API-ul HTTP local v2 este dezactivat implicit. Pentru a-l activa:
- Conectați-vă la go-e Charger prin aplicația go-e (disponibilă pentru iOS și Android)
- Mergeți la Settings > Connection > API Settings
- Activați „Allow access to local HTTP API vX”
După activare, stația de încărcare răspunde la cererile HTTP pe portul 80. Nu este necesară autentificarea — accesul este controlat exclusiv de acest comutator.
Configurarea rețelei
go-e Gemini flex se conectează prin Wi-Fi (802.11b/g/n, doar 2,4 GHz). Nu dispune de port Ethernet. La importul șablonului în TapHome introduceți adresa IP a stației de încărcare.
go-e Charger nu acceptă descoperirea prin mDNS. Pentru a preveni problemele de conectivitate după reînnoirea DHCP, configurați în router o adresă IP statică sau o rezervare DHCP pentru adresa MAC a stației de încărcare.
Stația de încărcare poate funcționa în modul hotspot (conexiune directă) sau se poate conecta la o rețea Wi-Fi existentă. Pentru integrarea cu TapHome, stația de încărcare trebuie să fie în aceeași rețea ca unitatea de control TapHome.
Funcțiile dispozitivului
Starea stației de încărcare
Dispozitivul Stare stație de încărcare raportează starea actuală a conectării și a încărcării ca indicator multivaloare doar pentru citire. Cheia API car returnează una din cele cinci stări: Defecțiune (0), Disponibilă (1), Încărcare (2), Pregătire (3) sau Finalizată (4). Astfel, automatizările TapHome se pot declanșa în funcție de faptul că un vehicul este conectat, se încarcă activ sau și-a încheiat sesiunea.
Controlul curentului de încărcare și al modului
Două dispozitive controlabile gestionează modul de funcționare al stației de încărcare:
Curent de încărcare — selectează curentul de încărcare solicitat dintre șase valori discrete: 6, 8, 10, 12, 14 și 16 A. Șablonul le mapează pe pozițiile comutatorului 0–5 cu formula
amp/2 - 3la citire și(position + 3) × 2la scriere. Valorile se trimit stației de încărcare prinapi/set?amp={value}.Mod de încărcare — selectează logica de încărcare: De bază (încărcare continuă implicită), Eco (optimizat după preț prin tariful Awattar) sau Călătorie zilnică (oprire automată după atingerea țintei). API-ul folosește valorile 3, 4 și, respectiv, 5; șablonul le mapează pe pozițiile 0, 1 și 2.
Selectorul Curent de încărcare mapează doar șase valori (6–16 A în pași de 2 A). Varianta de 22 kW a Gemini flex acceptă până la 32 A, dar valorile peste 16 A nu sunt acoperite de acest șablon. Pentru curenți mai mari, cheia API
amppoate fi setată direct, în afara șablonului.
Forțarea stării
Dispozitivul Forțare stare are prioritate față de decizia proprie a stației de încărcare de a încărca sau nu. Cheia API frc acceptă Neutru (0 — decide stația de încărcare), Oprită (1 — încărcarea blocată) și Încărcare (2 — încărcarea pornită forțat). Valoarea se scrie prin api/set?frc={value} și se recitește din răspunsul de stare; de aceea această revizie a șablonului adaugă frc în filtrul api/status.
Selectorul afișează și pozițiile 3–9 cu etichete numerice substituente, moștenite din șablon. API-ul go-e nu le atribuie niciun sens — folosiți doar Neutru, Oprită și Încărcare.
Comutarea fazelor
Dispozitivul Comutare faze controlează câte faze folosește stația de încărcare: Automat (0), Monofazat (1) sau Trifazat (2). go-e Charger permite comutarea fazelor chiar și în timpul unei sesiuni de încărcare active. În modul Automat, stația de încărcare alege configurația optimă a fazelor în funcție de puterea disponibilă.
Monitorizarea energiei
Șablonul citește tensiunea și curentul pe fiecare fază din matricea de energie nrg a stației de încărcare, care conține 16 valori actualizate la fiecare ciclu de interogare:
| Dispozitiv | Sursă | Unitate |
|---|---|---|
| Tensiune L1 | nrg[0] | V |
| Tensiune L2 | nrg[1] | V |
| Tensiune L3 | nrg[2] | V |
| Curent L1 | nrg[4] | A |
| Curent L2 | nrg[5] | A |
| Curent L3 | nrg[6] | A |
Dispozitivul Contor electric stație de încărcare raportează energia totală livrată din cheia eto (Wh) și puterea instantanee din nrg[11], împărțită la 1000. Acesta înlocuiește fostul dispozitiv Current Consumption. Toate valorile de energie sunt doar pentru citire.
Șablonul citește curenții pe faze din
nrg[4],nrg[5]șinrg[6], iar puterea raportată de contor dinnrg[11]. Documentația API go-e plasează curenții pe faze la indicii 5, 6 și 7, puterea pe neutru la indicele 11 și puterea totală la indicele 12 — exact aceștia erau folosiți în revizia anterioară a șablonului. Înainte de a vă baza pe aceste valori pentru facturare sau automatizări, verificați-le comparativ cu stația de încărcare.
Intrări pentru încărcarea din surplusul PV
Două dispozitive doar pentru scriere permit TapHome să transmită stației de încărcare date externe despre energie pentru calculul încărcării din surplus:
- Putere spre rețea — trimite puterea actuală exportată în rețea / importată din rețea (în kW, convertită în W prin înmulțire cu 1000) prin
api/set?ids={"pGrid":value} - Putere PV — trimite producția fotovoltaică actuală (în kW, convertită în W prin înmulțire cu 1000) prin
api/set?ids={"pPv":value}
Aceste dispozitive nu citesc date de la stația de încărcare. go-e Charger nu măsoară singur puterea rețelei sau puterea PV — se bazează pe surse externe care îi furnizează aceste informații. Într-o configurație TapHome tipică, valorile de la un contor electric separat sau de la un invertor solar (integrate și ele în TapHome) sunt transmise stației de încărcare prin aceste dispozitive doar pentru scriere, ceea ce permite modului de încărcare Eco să optimizeze autoconsumul.
Pentru încărcarea din surplusul PV setați Mod de încărcare la Eco, apoi folosiți automatizările TapHome pentru a scrie periodic valorile actuale ale puterii rețelei și ale producției PV în dispozitivele Putere spre rețea și Putere PV. Stația de încărcare își va ajusta automat curentul de încărcare în funcție de surplusul disponibil.
Funcții suplimentare
API-ul go-e Charger v2 pune la dispoziție și date care nu sunt mapate în prezent în șablon: puterea (W) și factorul de putere pe fiecare fază, tensiunea pe neutru, puterea totală (nrg[12]), energia pe sesiune (wh), codurile stărilor de eroare, limita de curent a cablului, senzorii de temperatură, frecvența rețelei, setările limitei de energie și configurarea curentului minim/maxim. Acestea pot fi adăugate într-o actualizare viitoare a șablonului.
Rezolvarea problemelor
Dispozitivul nu răspunde
- Verificați dacă stația de încărcare este conectată la Wi-Fi și are o adresă IP validă — verificați în aplicația go-e la Settings > Connection
- Confirmați că HTTP API este activat (Settings > Connection > API Settings)
- Deschideți
http://{charger-ip}/api/statusîntr-un browser — dacă răspunde cu JSON, API-ul este accesibil - Verificați dacă unitatea de control TapHome și stația de încărcare sunt în aceeași rețea / VLAN
Curentul de încărcare nu se schimbă
- Șablonul mapează doar șase valori (6, 8, 10, 12, 14, 16 A). Dacă stația de încărcare afișează o altă valoare (de ex. 20 A setați din aplicație), TapHome va afișa cea mai apropiată poziție mapată
- Verificați dacă firmware-ul stației de încărcare este 051.4 sau mai nou — firmware-ul mai vechi folosește o altă sintaxă a filtrului, care poate cauza probleme la parsare
Încărcarea din surplusul PV nu funcționează
- Confirmați că Mod de încărcare este setat la Eco — logica de surplus se activează doar în acest mod
- Verificați dacă valorile Putere spre rețea și Putere PV se scriu regulat (cel puțin la fiecare 30 de secunde)
- Verificați dacă valorile sunt în kW (șablonul le convertește automat în W)
- Deschideți
http://{charger-ip}/api/status?filter=pgrid,ppvpentru a verifica dacă stația de încărcare primește valorile
Cheia API
eto(energia totală) este acum disponibilă ca dispozitivul Contor electric stație de încărcare — valoarea obținută în filtrul de stare nu mai rămâne nefolosită.