
La go-e Gemini flex è una wallbox EV di produzione austriaca disponibile nelle varianti da 11 kW (16 A) e 22 kW (32 A), con il più recente modello Gemini flex 2.0 dotato di modulo 4G LTE integrato. TapHome comunica con il caricatore tramite l’API HTTP v2 locale su Wi-Fi — non è richiesta alcuna connessione cloud. L’API deve essere esplicitamente abilitata nell’app go-e prima che TapHome possa connettersi.
Il template fornisce il monitoraggio dello stato del caricatore, il controllo della corrente e della modalità di carica, la commutazione delle fasi, le letture di tensione e corrente per fase e ingressi in sola scrittura per dati esterni di potenza FV e rete per abilitare la ricarica con surplus.
Configurazione
Abilitazione dell’API HTTP
L’API HTTP v2 locale è disabilitata per impostazione predefinita. Per abilitarla:
- Connettersi al go-e Charger tramite l’app go-e (disponibile per iOS e Android)
- Navigare su Impostazioni > Connessione > Impostazioni API
- Abilitare “Consenti accesso all’API HTTP locale vX”
Una volta abilitata, il caricatore risponde alle richieste HTTP sulla porta 80. Non è richiesta l’autenticazione — l’accesso è controllato esclusivamente da questo interruttore.
Configurazione di rete
La go-e Gemini flex si connette tramite Wi-Fi (802.11b/g/n, solo 2,4 GHz). Non è presente una porta Ethernet. Durante l’importazione del template TapHome, inserire l’indirizzo IP del caricatore.
Il go-e Charger non supporta mDNS. Per prevenire problemi di connettività dopo un rinnovo DHCP, configurare un indirizzo IP statico o una prenotazione DHCP sul router per l’indirizzo MAC del caricatore.
Il caricatore può operare in modalità hotspot (connessione diretta) o unirsi a una rete Wi-Fi esistente. Per l’integrazione con TapHome, il caricatore deve trovarsi sulla stessa rete della CCU TapHome.
Funzionalità del dispositivo
Stato del caricatore
Il dispositivo Stato del caricatore riporta lo stato attuale di connessione e carica come indicatore multi-valore in sola lettura. La chiave API car restituisce uno dei cinque stati: Guasto (0), Disponibile (1), In carica (2), Preparazione (3) o Completato (4). Questo consente alle automazioni TapHome di attivarsi in base al fatto che un veicolo sia connesso, in carica attiva o abbia completato una sessione.
Controllo della corrente e della modalità di carica
Due dispositivi controllabili gestiscono il funzionamento del caricatore:
Corrente di carica — seleziona la corrente di carica richiesta tra sei valori discreti: 6, 8, 10, 12, 14 e 16 A. Il template mappa questi valori alle posizioni dell’interruttore 0–5 utilizzando la formula
amp/2 - 3per la lettura e(position + 3) × 2per la scrittura. I valori vengono inviati al caricatore tramiteapi/set?amp={value}.Modalità di carica — seleziona la logica di carica: Base (carica continua predefinita), Eco (ottimizzata sul prezzo tramite tariffa Awattar) o Viaggio giornaliero (arresto automatico al raggiungimento dell’obiettivo). L’API utilizza i valori 3, 4 e 5; il template li mappa alle posizioni 0, 1 e 2.
Il selettore della corrente di carica mappa solo sei valori (6–16 A con incrementi di 2 A). La variante da 22 kW della Gemini flex supporta fino a 32 A, ma i valori superiori a 16 A non sono coperti da questo template. Per utilizzare correnti più elevate, la chiave API
amppuò essere impostata direttamente al di fuori del template.
Commutazione delle fasi
Il dispositivo Commutazione delle fasi controlla quante fasi utilizza il caricatore: Automatico (0), Monofase (1) o Trifase (2). Il go-e Charger supporta la commutazione delle fasi anche durante una sessione di carica attiva. In modalità automatica, il caricatore seleziona la configurazione ottimale delle fasi in base alla potenza disponibile.
Monitoraggio energetico
Il template legge tensione e corrente per fase dall’array energetico nrg del caricatore, che contiene 16 valori aggiornati ad ogni ciclo di polling:
| Dispositivo | Sorgente | Unità |
|---|---|---|
| L1 Tensione | nrg[0] | V |
| L2 Tensione | nrg[1] | V |
| L3 Tensione | nrg[2] | V |
| L1 Corrente | nrg[5] | A |
| L2 Corrente | nrg[6] | A |
| L3 Corrente | nrg[7] | A |
| Consumo attuale | nrg[12] | W |
Il dispositivo Consumo attuale riporta la potenza di carica attiva totale in watt. Tutti i valori energetici sono in sola lettura.
Ingressi per la ricarica con surplus FV
Due dispositivi in sola scrittura consentono a TapHome di inviare dati energetici esterni al caricatore per i calcoli della ricarica con surplus:
- Potenza verso rete — invia la potenza attuale di esportazione/importazione dalla rete (in kW, convertita in W moltiplicando per 1000) tramite
api/set?ids={"pGrid":value} - Potenza FV — invia la produzione fotovoltaica attuale (in kW, convertita in W moltiplicando per 1000) tramite
api/set?ids={"pPv":value}
Questi dispositivi non leggono dati dal caricatore. Il go-e Charger stesso non misura la potenza di rete o FV — si affida a fonti esterne per fornire queste informazioni. In una configurazione TapHome tipica, i valori da un contatore di energia separato o da un inverter solare (anch’esso integrato in TapHome) vengono inoltrati al caricatore tramite questi dispositivi in sola scrittura, abilitando la modalità di carica Eco per ottimizzare l’autoconsumo.
Per utilizzare la ricarica con surplus FV, impostare la Modalità di carica su Eco, quindi utilizzare le automazioni TapHome per scrivere periodicamente i valori attuali di potenza di rete e produzione FV nei dispositivi Potenza verso rete e Potenza FV. Il caricatore regolerà automaticamente la corrente di carica in base al surplus disponibile.
Funzionalità aggiuntive
L’API go-e Charger v2 espone dati aggiuntivi attualmente non mappati nel template: potenza per fase (W) e fattore di potenza, tensione del neutro, energia totale consumata (eto in Wh), energia per sessione (wh), codici di stato errore, limite di corrente del cavo, sensori di temperatura, frequenza di rete, controllo dello stato di carica forzata, impostazioni del limite di energia e configurazione della corrente minima/massima. Questi possono essere aggiunti in un futuro aggiornamento del template.
Risoluzione dei problemi
Il dispositivo non risponde
- Verificare che il caricatore sia connesso al Wi-Fi e abbia un indirizzo IP valido — controllare nell’app go-e in Impostazioni > Connessione
- Confermare che l’API HTTP sia abilitata (Impostazioni > Connessione > Impostazioni API)
- Aprire
http://{charger-ip}/api/statusin un browser — se risponde con JSON, l’API è raggiungibile - Verificare che la CCU TapHome e il caricatore siano sulla stessa rete / VLAN
La corrente di carica non cambia
- Il template mappa solo sei valori (6, 8, 10, 12, 14, 16 A). Se il caricatore mostra un valore diverso (es. 20 A impostato tramite l’app), TapHome visualizzerà la posizione mappata più vicina
- Verificare che il firmware del caricatore sia versione 051.4 o successiva — il firmware precedente utilizza una sintassi di filtro diversa che può causare problemi di parsing
La ricarica con surplus FV non funziona
- Confermare che la Modalità di carica sia impostata su Eco — la logica del surplus si attiva solo in questa modalità
- Verificare che i valori di Potenza verso rete e Potenza FV vengano scritti regolarmente (almeno ogni 30 secondi)
- Controllare che i valori siano in kW (il template converte automaticamente in W)
- Aprire
http://{charger-ip}/api/status?filter=pgrid,ppvper verificare che il caricatore stia ricevendo i valori
La chiave API
eto(energia totale) è inclusa nel filtro di stato ma non è esposta come dispositivo nel template. Il valore dell’energia totale viene recuperato ma non utilizzato.