--- title: "Alfen Eve Wallbox" description: "Wallbox Alfen Eve Single e Double (piattaforma NG9xx) integrati con TapHome tramite Modbus TCP." url: "https://taphome.com/it/compatibility/alfen-box/" language: it lastmod: 2026-03-28 generator: hugo ai: topics: ["modbus-tcp","wallbox","ev-charger","ethernet","active-load-balancing"] questions: ["Come integrare il wallbox Alfen Eve con TapHome?","Cosa monitora il template Alfen Box di TapHome?","Come collegare il caricatore Alfen Eve tramite Modbus TCP a TapHome?","Come abilitare il Modbus TCP sul wallbox Alfen Eve?","Qual è il requisito della licenza Active Load Balancing per Alfen Modbus?","Come controllare la corrente di ricarica di Alfen Eve tramite Modbus?"] --- # Alfen Eve Wallbox 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 La serie Alfen Eve (Eve Single S-line, Eve Single Pro-line, Eve Double Pro-line) comprende stazioni di ricarica EV commerciali e residenziali basate sulla piattaforma NG9xx. TapHome si connette al wallbox tramite Modbus TCP via Ethernet sulla porta 502. Il template attuale monitora la temperatura interna della scheda ed espone gli attributi di identificazione del caricatore (nome prodotto, nome stazione, numero di prese). La mappa registri Modbus di Alfen fornisce ampi registri per-socket per la misurazione dell'energia e il controllo della corrente, che potranno essere aggiunti in futuri aggiornamenti del template. ## Collegamento hardware Il wallbox dispone di una porta Ethernet cablata per la connettività di rete. Collegalo alla stessa rete locale di TapHome Core utilizzando un cavo Ethernet standard. - **Protocollo:** Modbus TCP - **Porta:** 502 - **Slave ID predefinito:** 200 (stazione), 1 (presa 1 / sinistra), 2 (presa 2 / destra) - **Ordine dei byte:** Mixed-endian — le parole a 16 bit sono big-endian, le parole a 32 bit sono little-endian (low word first) > [!WARNING] > Il caricatore supporta un massimo di **2 connessioni Modbus TCP simultanee**. Assicurati che nessun altro sistema (es. Home Assistant, OCPP backend) stia utilizzando entrambe le connessioni quando TapHome deve comunicare. ## Configurazione ### Abilitazione della comunicazione Modbus Il Modbus TCP non è abilitato di default sui caricatori Alfen Eve. L'attivazione richiede la licenza **Active Load Balancing (ALB)** — una funzione a pagamento che deve essere acquistata da Alfen. Una volta attivata la licenza, configura il Modbus tramite l'applicazione **ACE Service Installer**: 1. Accedi all'ACE Service Installer e seleziona la stazione di ricarica 2. Vai su **Load Balancing** (icona bilancia) 3. Seleziona **Active balancing** e spunta **Active Load Balancing** 4. Imposta Data Source su **Energy Management System** — questo attiva il ruolo di server Modbus 5. In Protocol Selection, scegli **Modbus TCP/IP** 6. Imposta **Maximum smart meter current** (A) e **Safe current** (A) 7. Vai su **TCP/IP EMS** nella barra laterale 8. Imposta Control mode: **Socket** (per il controllo individuale delle prese) o **SCN** (per il controllo dell'intera stazione) 9. Abilita **Allow reading** per consentire la lettura dei registri Modbus 10. Facoltativamente abilita **Allow writing maximum currents** se si desidera il controllo della corrente | Impostazione | Descrizione | Predefinito | |-------------|-------------|-------------| | Allow reading | Consentire la lettura dei registri Modbus tramite TCP/IP | OFF | | Allow writing maximum currents | Consentire la scrittura dei registri di corrente massima | OFF | | Valid time | Secondi prima del ritorno alla corrente sicura | 60 s | | IP Address allocation | DHCP o IP fisso | DHCP | | Port | Porta Modbus TCP | 502 | > [!WARNING] > La licenza **Active Load Balancing** è una funzione a pagamento. Contatta Alfen per acquistare la chiave di licenza prima di tentare di abilitare la comunicazione Modbus. Durante l'importazione del template in TapHome, fornisci: - **IP Address** — l'indirizzo IP del wallbox nella rete locale - **Slave ID** — 200 (predefinito per i registri a livello di stazione) ## Funzionalità del dispositivo Il template monitora il wallbox a livello di stazione (slave address 200): ### Temperatura della scheda - **Board Temperature** — legge la temperatura PCB interna del wallbox dal registro H:1102 (Float32, °C). Questa è la temperatura della scheda a circuito stampato, non la temperatura ambiente. ### Funzionalità aggiuntive La piattaforma Alfen NG9xx espone un'ampia mappa registri Modbus oltre a quanto implementato dal template attuale. I registri per-socket (slave address 1 o 2) forniscono misurazioni energetiche in tempo reale tra cui tensione, corrente e potenza (attiva, apparente, reattiva) per fase, fattore di potenza, frequenza ed energia cumulativa erogata e consumata. I registri di stato della presa espongono la disponibilità, lo stato di ricarica IEC 61851 Mode 3 e un setpoint di corrente massima scrivibile con tempo di validità configurabile — abilitando la gestione dinamica del carico. I registri a livello di stazione forniscono inoltre uptime, conteggio avvii e identificazione della piattaforma. Queste funzionalità potranno essere aggiunte in un futuro aggiornamento del template. > [!TIP] > Per i caricatori a doppia presa (Eve Double Pro-line), la presa 1 (sinistra) utilizza slave address 1 e la presa 2 (destra) utilizza slave address 2. Ogni presa ha il proprio set indipendente di registri di misurazione e controllo. ## Risoluzione dei problemi ### Nessuna comunicazione Modbus 1. Verifica che la licenza Active Load Balancing sia attiva sul caricatore 2. Conferma che **Allow reading** sia abilitato nell'ACE Service Installer sotto TCP/IP EMS 3. Assicurati che il wallbox e TapHome Core siano sulla stessa rete/sottorete 4. Controlla che nessun firewall blocchi la porta 502 5. Verifica che lo slave ID corrisponda (predefinito: 200 per i registri della stazione) 6. Assicurati che non siano collegati più di 2 client Modbus TCP contemporaneamente ### I valori dei registri restituiscono NaN I caricatori dotati di misuratori Reallin (produzione post-2021) restituiscono NaN per alcuni registri aggregati: Current Sum, Apparent Power Sum, Reactive Power Sum e Real Energy Consumed Sum. I registri per-fase funzionano correttamente. Si tratta di una limitazione hardware del misuratore Reallin, non di un problema di configurazione. ### Il setpoint della corrente massima non viene applicato I valori di corrente massima scritti hanno un timeout di validità (predefinito 60 secondi). Il valore deve essere periodicamente riscritto prima della scadenza, altrimenti il caricatore torna alla corrente sicura configurata. Verifica l'impostazione del validity time nell'ACE Service Installer. ## Dispositivi disponibili 1 Questi dispositivi compaiono in TapHome dopo l'importazione. Alfen Box Modulo Attributi di servizio | | | |-----------------|-----------------------------------------------------------| | Nome | Identificatore del nome prodotto del caricatore | | Nome stazione | Nome della stazione assegnato al wallbox | | Numero di prese | Numero di prese di ricarica disponibili su questo wallbox | Attributi di servizio Name ```taphome MODBUSR(H, 100, String, 6) ``` STN Name ```taphome MODBUSR(H, 1400, String, 4) ``` Number of sockets ```taphome MODBUSR(H, 1105, Uint16); ``` Temperatura della scheda Sensore di temperatura Solo lettura Temperatura PCB interna del wallbox — non la temperatura ambiente Registro: H:1102 Float Unità: °C Lettura temperatura ```taphome MODBUSR(H, 1102, Float, 2) ``` **Connessione:** Modbus TCP • Slave ID: $\[SlaveId] • Hostname: `ACE-{SERIAL}.local` Possibili miglioramenti (11) - H:1100 Uptime — UInt64 (4 words), seconds since last boot - H:1101 Bootups — UInt32 (2 words), number of boot cycles - H:1104 Max Current — Float (2 words), max current per wallbox in A - H:1106 Platform Type — String, hardware platform identifier - H:300 Socket 1 — Real Energy Delivered — Float (2 words), kWh, available on socket slave ID 1 - H:306 Socket 1 — Meter State — UInt16, socket state enum (e.g. 0=Available, 1=Cable connected, 2=Charging) - H:308 Socket 1 — Active Power Total — Float (2 words), W, real-time charging power - H:320 Socket 1 — Voltage L1/L2/L3 — Float (2 words each), V, per-phase voltage on socket slave ID 1 - H:326 Socket 1 — Current L1/L2/L3 — Float (2 words each), A, per-phase current on socket slave ID 1 - H:1210 Max Current Valid Time — UInt16, seconds, R/W — timeout for max current setting - H:1200 Socket 1 — Max Current — Float (2 words), A, R/W — dynamic current limit per socket ## Parametri di importazione Inserisci questi valori quando importi l'XML. | Richiesto nell'app | Predefinito | |--------------------|---------------| | Slave ID | `200` | | Indirizzo IP | `192.168.1.0` | ## Fonti - Alfen Modbus for ACE — Configuration Guide [alfen.com](https://alfen.com/media/1047/download) 2026-03-28 [PDF](https://taphome.com/compatibility/devices/alfen-box/manufacturer/modbus-slave-tcpip.pdf) - 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-28 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/)