
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, della modalità di carica e dello stato forzato, la commutazione delle fasi, le letture di tensione e corrente per fase, un contatore di energia 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.
Stato forzato
Il dispositivo Stato forzato sovrascrive la decisione del caricatore sulla ricarica. La chiave API frc accetta Neutro (0 — decide il caricatore), Fermato (1 — ricarica bloccata) e Carica (2 — ricarica forzata). Il valore viene scritto tramite api/set?frc={value} e riletto dalla risposta di stato, motivo per cui questa revisione del template aggiunge frc al filtro api/status.
Il selettore elenca anche le posizioni 3–9 con etichette numeriche segnaposto ereditate dal template. L’API go-e non attribuisce loro alcun significato — usare solo Neutro, Fermato e Carica.
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[4] | A |
| L2 Corrente | nrg[5] | A |
| L3 Corrente | nrg[6] | A |
Il dispositivo Contatore elettrico della wallbox riporta l’energia totale erogata dalla chiave eto (Wh) e la potenza istantanea da nrg[11] diviso 1000. Sostituisce il precedente dispositivo Consumo attuale. Tutti i valori energetici sono in sola lettura.
Il template legge le correnti di fase da
nrg[4],nrg[5]enrg[6]e la potenza del contatore danrg[11]. La documentazione dell’API go-e colloca le correnti di fase agli indici 5, 6 e 7, la potenza del neutro all’indice 11 e la potenza totale all’indice 12 — esattamente come faceva la revisione precedente del template. Verificare le letture sul caricatore prima di usarle per fatturazione o automazioni.
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, potenza totale (nrg[12]), energia per sessione (wh), codici di stato errore, limite di corrente del cavo, sensori di temperatura, frequenza di rete, 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) è ora esposta come dispositivo Contatore elettrico della wallbox — il valore recuperato nel filtro di stato non resta più inutilizzato.