--- title: "Alfen Eve Single Socket" description: "Stato ricarica EV, potenza e tensione per fase, energia e corrente max via Modbus TCP. Template TapHome per Alfen Eve Single S-line / Pro-line." url: "https://taphome.com/it/compatibility/alfen-socket/" language: it lastmod: 2026-03-29 generator: hugo ai: topics: ["modbus-tcp","wallbox","ev-charging","3-phase","ethernet"] questions: ["Come integrare il wallbox Alfen Eve con TapHome?","Cosa monitora e controlla il template Alfen Socket di TapHome?","Come collegare Alfen Eve tramite Modbus TCP a TapHome?","Come abilitare il Modbus slave sul caricatore Alfen Eve?","Come controllare la corrente di ricarica EV con TapHome e Alfen?","Cos'è lo stato Mode 3 sul caricatore Alfen Eve?"] --- # Alfen Eve Single Socket Comunicazione: Modbus TCP - [Sito ufficiale Alfen](https://alfen.com/charging-equipment) > Indirizzo di rete > > TapHome raggiunge il dispositivo all'indirizzo inserito durante l'importazione. Assegna al dispositivo un indirizzo fisso — una prenotazione IP nel router, oppure il suo nome mDNS se lo supporta —, altrimenti l'integrazione smette di funzionare quando il router cambia l'indirizzo. > > [Preparazione della rete](https://taphome.com/it/docs/setup/network-preparation/) ## Guida all'integrazione Le Alfen Eve Single S-line e Pro-line (variante presa) sono stazioni di ricarica EV basate sulla piattaforma NG9xx. TapHome si collega direttamente al wallbox tramite Modbus TCP su Ethernet — non è necessario alcun gateway aggiuntivo. Il template fornisce rilevamento dello stato di ricarica, stato di connessione del veicolo, misurazione di tensione e potenza per fase, monitoraggio del consumo energetico e limitazione dinamica della corrente tramite il registro di controllo Max Current. ## Connessione di rete L'Eve Single ha una porta Ethernet sulla scheda principale. Collegala alla stessa rete locale di TapHome Core con un cavo Ethernet standard. - **Protocollo:** Modbus TCP - **Porta:** 502 - **Ordine dei byte:** Big-endian (ordine dei byte di rete) - **Indirizzamento slave:** 1 per la presa 1, 2 per la presa 2 (stazioni a doppia presa), 200 per i registri a livello di stazione > [!NOTE] > Il template TapHome opera a livello di presa (slave ID 1 o 2). Ogni presa su una stazione a doppia presa richiede una propria istanza dispositivo in TapHome. Per i modelli a presa singola, usa lo slave ID 1. ## Configurazione ### Abilitazione della comunicazione Modbus La funzionalità Modbus slave richiede una licenza **Active Load Balancing** acquistata e attivata sul caricatore. È necessario anche un account Service Installer Application (SIA) — richiedilo su https://support.alfen.com. 1. Apri la Service Installer Application e collegati al caricatore 2. Vai su **Active balancing** nel menu a sinistra 3. Abilita la casella **Active Load Balancing** 4. Abilita **"Allow 1- and 3-phased charging"** se è necessario il controllo della commutazione di fase 5. Seleziona **"Energy Management System"** come Data Source — questo configura la stazione come Modbus slave 6. Nel menu a sinistra appare **"TCP/IP EMS"** — Modbus TCP/IP è selezionato per impostazione predefinita 7. Scegli la modalità di controllo: - **Socket mode** — controllo individuale di ogni presa (consigliato per TapHome) - **SCN mode** — controllo della stazione nel suo insieme Quando importi il template in TapHome, fornisci: - **Indirizzo IP** — l'IP del wallbox nella rete locale - **Slave ID** — 1 per la presa 1, 2 per la presa 2 ### Opzioni di configurazione Modbus | Impostazione | Funzione | Predefinito | |-------------|----------|-------------| | Allow reading | Consentire la lettura dei registri Modbus via TCP/IP | Disattivato | | Allow writing maximum currents | Consentire la scrittura dei registri di corrente massima | Disattivato | | Enable sockets | Considerare i valori di corrente massima scritti | — | | Validity time | Secondi prima del fallback alla corrente sicura | 60 | | IP Address allocation | DHCP o IP fisso | DHCP | > [!WARNING] > Entrambe le opzioni "Allow reading" e "Allow writing maximum currents" devono essere abilitate nella Service Installer Application affinché il template funzioni. Per impostazione predefinita sono disattivate. ## Capacità del dispositivo ### Stato di ricarica e rilevamento veicolo Due sensori booleani derivati dal registro di stato IEC 61851 Mode 3 (H:1201): - **Vehicle Connection** — restituisce true quando un veicolo è fisicamente collegato (stati B1, B2, C1, C2, D1, D2), false quando scollegato (A, E, F). - **Charge State** — restituisce true quando il veicolo sta caricando attivamente (stati C2 o D2), false altrimenti. Lo stato Mode 3 segue la norma IEC 61851: | Stato | Veicolo collegato | Ricarica | Descrizione | |-------|-------------------|----------|-------------| | A | No | No | Nessun veicolo collegato | | B1 / B2 | Sì | No | Veicolo collegato, non in carica | | C1 / C2 | Sì | Solo C2 | Veicolo richiede ricarica (C2 = PWM attivo, in carica) | | D1 / D2 | Sì | Solo D2 | Veicolo con richiesta di ventilazione | | E | No | No | Cortocircuito (CP-PE) | | F | No | No | Errore della stazione di ricarica | Il dispositivo Charge State espone anche un **attributo di servizio** "Number of charging phases" (H:1215) che mostra se il veicolo sta attualmente caricando su 1 o 3 fasi, e un'**azione di servizio** "Charging phases" per commutare tra la modalità di ricarica monofase e trifase. ### Monitoraggio tensione Sensori di tensione trifase fase-neutro: - **Voltage Phase L1-N** — legge H:306 (BigEndianFloat) - **Voltage Phase L2-N** — legge H:308 (BigEndianFloat) - **Voltage Phase L3-N** — legge H:310 (BigEndianFloat) Tutti e tre riportano la tensione in volt con un intervallo di polling di 15 secondi. ### Misurazione della potenza - **Real Power Sum** — potenza attiva totale di tutte le fasi, convertita da W a kW. Include **attributi di servizio** con ripartizione per fase: Phase L1 (H:338), Phase L2 (H:340), Phase L3 (H:342), ciascuno in kW. - **Frequency** — frequenza di rete in Hz dal registro H:336. ### Misurazione dell'energia - **Real Energy Delivered** — energia cumulativa consegnata al veicolo (H:374, Float64), convertita da Wh a kWh. Somma di tutte le fasi. - **Real Energy Consumed** — energia cumulativa consumata dalla presa (H:390, Float64), convertita da Wh a kWh. Somma di tutte le fasi. ### Attributi e azioni a livello di modulo Il modulo espone diversi **attributi di servizio** visibili nella vista dettagliata del dispositivo: | Attributo | Descrizione | |-----------|-------------| | Meter Type | Tipo di comunicazione del contatore (RTU, TCP/IP, UDP, P1) | | State | Flag di stato del contatore — Initialised, Updated, Warning, Error | | Mode 3 State | Stringa grezza dello stato IEC 61851 Mode 3 (A, B1, B2, C1, C2, D1, D2, E, F) | | Max Current | Corrente massima di ricarica attualmente applicata in ampere | | Active Load Balancing Safe Current | Valore di corrente di fallback alla scadenza della validità della corrente max | Il modulo fornisce anche un'**azione di servizio** "Max Current" per scrivere il limite massimo di corrente di ricarica (6–16 A) nel registro H:1210. Il valore scritto deve essere aggiornato entro il timeout di validità configurato (predefinito 60 secondi), altrimenti la stazione torna al valore di corrente sicura. > [!WARNING] > Il valore di corrente max **non viene preservato** durante il riavvio. Dopo un'interruzione di corrente, la stazione torna alla corrente sicura fino a quando un nuovo valore viene scritto tramite Modbus. ### Capacità aggiuntive L'Alfen Eve espone registri Modbus aggiuntivi per tensioni concatenate, correnti per fase e corrente totale, fattore di potenza, potenza apparente, potenza reattiva e ripartizione dell'energia per fase. I registri a livello di stazione (slave 200) forniscono temperatura della scheda, stato OCPP, consumo aggregato della Smart Charging Network (SCN) e controllo della corrente max per fase. Questi possono essere aggiunti al template TapHome in un futuro aggiornamento. ## Risoluzione dei problemi ### Nessuna comunicazione Modbus 1. Verifica che il cavo Ethernet sia collegato e che il caricatore sia nella stessa rete di TapHome Core 2. Conferma che la licenza Active Load Balancing sia attivata 3. Controlla che "Allow reading" sia abilitato nella Service Installer Application 4. Conferma lo slave ID corretto — usa 1 per la presa 1 (non 200, che è l'indirizzo a livello di stazione) 5. Assicurati che nessun firewall blocchi la porta 502 6. Il caricatore supporta un massimo di 2 connessioni Modbus TCP simultanee — verifica che nessun altro sistema stia utilizzando entrambi gli slot ### Corrente max non applicata 1. Verifica che "Allow writing maximum currents" sia abilitato nella Service Installer Application 2. Controlla che la corrente sicura sia configurata (deve essere impostata prima di poter controllare la corrente max tramite Modbus) 3. Assicurati che il valore di corrente venga aggiornato prima della scadenza del timeout di validità (predefinito 60 secondi) 4. Controlla il registro H:1214 (Setpoint accounted for) — il valore 1 conferma che la corrente scritta è stata applicata ### Commutazione di fase non funzionante Assicurati che "Allow 1- and 3-phased charging" sia abilitato nelle impostazioni Active Load Balancing della Service Installer Application. Questa impostazione è necessaria affinché l'azione di servizio di commutazione di fase funzioni. ### Raccomandazione firmware Si raccomanda la versione firmware **6.4.0-4210 o successiva**. Le versioni precedenti hanno un bug per cui il budget di potenza si resetta a 0 A quando nessuna auto è in carica. ## Dispositivi disponibili 9 Questi dispositivi compaiono in TapHome dopo l'importazione. Alfen Socket Modulo Attributi di servizio | | | |---------------------------------------|------------------------------------------------------------------------------------------------------------------------------| | Tipo contatore | Tipo di comunicazione del contatore — RTU, TCP/IP, UDP o P1 | | Stato | Flag di stato del contatore — Initialised, Updated, Warning, Error | | Stato Mode 3 | Stato di ricarica IEC 61851 Mode 3 — A (scollegato), B1/B2 (collegato), C1/C2 (ricarica), D1/D2 (ventilazione), E/F (errore) | | Corrente max | Corrente massima di ricarica attualmente applicata in ampere | | Active Load Balancing corrente sicura | Valore di corrente di fallback alla scadenza della validità della corrente max | Azioni di servizio | | | |--------------|--------------------------------------------------------------------------------------------------------------------| | Corrente max | Impostare il limite massimo di corrente di ricarica (6–16 A) — deve essere aggiornato entro il timeout di validità | Lettura (modulo) ```taphome #warning IF(GETBIT(MODBUSR(H, 300, Uint16), 2)=1, ADDWARNING("Meter in warning state")); #error IF(GETBIT(MODBUSR(H, 300, Uint16), 3)=1, ADDError("Meter in error")); IF(MODBUSR(H, 1201, String, 5)="F", ADDError("Charging error")); ``` Attributi di servizio Meter Type ```taphome SWITCH(MODBUSR(H, 305, Uint16), 0, "RTU", 1, "TCP/IP", 2, "UDP", 3, "P1", "Other"); ``` State ```taphome var reg := MODBUSR(H, 300, Uint16); var string := IF(GETBIT(reg, 0) = 1, "Initialised ", "") + IF(GETBIT(reg, 1) = 1, "Updated ", "") + IF(GETBIT(reg, 2) = 1, "Warning ", "") + IF(GETBIT(reg, 3) = 1, "Error", ""); ``` Mode 3 State ```taphome MODBUSR(H, 1201, String, 5); ``` Max Current ```taphome MODBUSR(H, 1210, Float, 2) + " A" ``` Active Load Balancing Safe Current ```taphome MODBUSR(H, 1212, Float, 2) + " A" ``` Azioni di servizio Max Current Parametri: Max Current \[A] (6–16 cur) ```taphome MODBUSW(H, 1210, Float, cur, 2) ``` Frequenza Variabile Solo lettura Registro: H:336 Float Unità: Hz Lettura ```taphome MODBUSR(H, 336, Float, 2) ``` Stato di ricarica Contatto reed Solo lettura Rilevamento ricarica attiva — true quando il veicolo assorbe energia (stati Mode 3 C2 o D2) Registro: H:1201 String switch-map Attributi di servizio | | | |----------------------------|---------------------------------------------------------------| | Numero di fasi di ricarica | Numero di fasi attualmente utilizzate per la ricarica (1 o 3) | Azioni di servizio | | | |------------------|----------------------------------------------------------| | Fasi di ricarica | Commutazione tra modalità di ricarica monofase e trifase | Lettura ```taphome SWITCH(MODBUSR(H, 1201, String, 5), "A", false, "B1", false, "B2", false, "C1", false, "C2", true, "D1", false, "D2", true, "E", false, "F", false, Nan) ``` Attributi di servizio Number of charging phases ```taphome MODBUSR(H, 1215, Uint16); ``` Azioni di servizio Charging phases Parametri: Charging Phases ```taphome MODBUSW(H, 1215, Uint16, chrg); ``` Energia consumata Variabile Solo lettura Energia cumulativa consumata dalla presa su tutte le fasi (kWh) Registro: H:390 Float Unità: kWh Lettura ```taphome MODBUSR(H, 390, Float, 4)/1000; ``` Energia erogata Variabile Solo lettura Energia cumulativa erogata al veicolo su tutte le fasi (kWh) Registro: H:374 Float Unità: kWh Lettura ```taphome MODBUSR(H, 374, Float, 4)/1000 ``` Potenza attiva totale Variabile Solo lettura Potenza attiva totale di tutte le fasi (kW) con ripartizione per fase negli attributi di servizio Registro: H:344 Float Unità: kW Attributi di servizio | | |---------| | Fase L1 | | Fase L2 | | Fase L3 | Lettura ```taphome MODBUSR(H, 344, Float, 2)/1000 ``` Attributi di servizio Phase L1 ```taphome MODBUSR(H, 338, Float, 2)/1000 + " kW"; ``` Phase L2 ```taphome MODBUSR(H, 340, Float, 2)/1000 + " kW"; ``` Phase L3 ```taphome MODBUSR(H, 342, Float, 2)/1000 + " kW"; ``` Connessione veicolo Contatto reed Solo lettura Rilevamento spina — true quando il cavo EV è collegato (stati Mode 3 B1/B2/C1/C2/D1/D2) Registro: H:1201 String switch-map Lettura ```taphome SWITCH(MODBUSR(H, 1201, String, 5), "A", false, "B1", true, "B2", true, "C1", true, "C2", true, "D1", true, "D2", true, "E", false, "F", false, Nan) ``` Tensione fase L1-N Variabile Solo lettura Registro: H:306 BigEndianFloat Unità: V Lettura ```taphome MODBUSR(H, 306, BigEndianFloat, 2) ``` Tensione fase L2-N Variabile Solo lettura Registro: H:308 BigEndianFloat Unità: V Lettura ```taphome MODBUSR(H, 308, BigEndianFloat, 2) ``` Tensione fase L3-N Variabile Solo lettura Registro: H:310 BigEndianFloat Unità: V Lettura ```taphome MODBUSR(H, 310, BigEndianFloat, 2) ``` **Connessione:** Modbus TCP • Slave ID: $\[SlaveId] • Hostname: `ACE-{SERIAL}.local` Possibili miglioramenti (18) - H:312 Voltage L1-L2 — Float32 (2 words), V, line-to-line voltage - H:314 Voltage L2-L3 — Float32 (2 words), V, line-to-line voltage - H:316 Voltage L3-L1 — Float32 (2 words), V, line-to-line voltage - H:318 Current N — Float32 (2 words), A, neutral current - H:320 Current L1 — Float32 (2 words), A, phase L1 current - H:322 Current L2 — Float32 (2 words), A, phase L2 current - H:324 Current L3 — Float32 (2 words), A, phase L3 current - H:326 Current Sum — Float32 (2 words), A, total current - H:328 Power Factor L1/L2/L3/Sum — Float32 (2 words each), 4 registers at H:328-335 - H:346 Apparent Power L1/L2/L3/Sum — Float32 (2 words each), VA, 4 registers at H:346-353 - H:354 Reactive Power L1/L2/L3/Sum — Float32 (2 words each), VAr, 4 registers at H:354-361 - H:362 Real Energy Delivered per-phase (L1/L2/L3) — Float64 (4 words each), Wh, per-phase breakdown (template only has sum) - H:378 Real Energy Consumed per-phase (L1/L2/L3) — Float64 (4 words each), Wh, per-phase breakdown (template only has sum) - H:394 Apparent Energy L1/L2/L3/Sum — Float64 (4 words each), VAh, 4 registers at H:394-409 - H:410 Reactive Energy L1/L2/L3/Sum — Float64 (4 words each), VArh, 4 registers at H:410-425 - H:1200 Availability — Uint16, 1=Operative - H:1206 Actual Applied Max Current — Float32 (2 words), A, currently applied current after ALB calculation - H:1208 Modbus Slave Max Current Valid Time — Uint32, seconds, remaining validity of written max current ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------|---------------| | Slave ID | `1` | | Indirizzo IP | `192.168.1.0` | ## Fonti - Alfen Modbus Slave TCP/IP — Register Mapping v2.3 [alfresco.alfen.com](https://alfresco.alfen.com/share/s/MF_z6vSJT7y6M0dPOBrOyA) 2026-03-29 [PDF](https://taphome.com/compatibility/devices/alfen-socket/manufacturer/modbus-register-mapping.pdf) - nessnaj/alfen\_eve\_modbus\_tcp — Python Register Map [github.com](https://github.com/nessnaj/alfen_eve_modbus_tcp) 2026-03-29 - Alfen Eve Pro — HA Community Modbus TCP Thread [community.home-assistant.io](https://community.home-assistant.io/t/alfen-eve-pro-ev-chargepoint-interface-via-tcp-modbus/346000) 2026-03-29 I documenti del produttore sono © dei rispettivi proprietari. Sono forniti così come pubblicati dal produttore, solo a titolo informativo. ## Documentazione correlata - [Modbus Integration](https://taphome.com/it/compatibility/modbus-guide/) - [Modbus - Configurazione](https://taphome.com/it/docs/integration/modbus/) - [Configurazione semplice utilizzando modelli](https://taphome.com/it/docs/integration/modbus/templates/) - [Script Modbus e prefetch](https://taphome.com/it/docs/script/modbus-scripts/) - [Funzioni Modbus](https://taphome.com/it/docs/script/modbus/) - [Tipi di dati Modbus](https://taphome.com/it/docs/script/modbus-data-types/)