TapHome

KEBA KeContact P30 Stazione di ricarica

Modbus TCP
Inviato da
Ultimo aggiornamento: 03. 2026
KEBA KeContact P30 Stazione di ricarica

La KEBA KeContact P30 è una wallbox AC Mode 3 per veicoli elettrici, disponibile nelle varianti c-series e x-series con una potenza di ricarica fino a 32 A / 22 kW. TapHome comunica con la wallbox tramite Modbus TCP su Ethernet, fornendo stato di ricarica in tempo reale, misurazione dell’energia, controllo della corrente e gestione failsafe.

Il template supporta sia la c-series (firmware 3.10.16+) che la x-series (software 1.11+). La e-series e la a-series non supportano Modbus TCP.

Collegamento hardware

La KeContact P30 dispone di due interfacce Ethernet (collegate in parallelo sulla PCB — è possibile utilizzarne solo una alla volta):

  • Ethernet1 (X4) — morsetti LSA+, consigliati per l’installazione permanente (smart home, rete di ricarica)
  • Ethernet2 (X3) — connettore RJ45, previsto per diagnostica/assistenza

Collega la wallbox alla stessa rete locale del TapHome Core utilizzando un cavo Cat 5e o Cat 6 STP.

Schema di collegamento del sistema
Schema di collegamento del sistema KEBA KeContact P30 con morsetti di alimentazione, ingresso enable X1, contatto di commutazione X2 e connessioni Ethernet

Lo schema mostra il concetto generale di collegamento, inclusi i morsetti di alimentazione (L1, L2, L3, N, PE), l’ingresso enable X1, l’uscita del contatto di commutazione X2 e l’interfaccia Ethernet per la comunicazione Modbus TCP.

Morsetto Ethernet LSA+ (X4)
Morsettiera Ethernet LSA+ KEBA KeContact P30 con morsetto schermatura e posizioni dei conduttori

Per installazioni permanenti, utilizza la morsettiera LSA+ (X4). Collega il cavo Ethernet secondo la codifica colori TIA-568A/B per 100BaseT (pin 1-4 più schermatura).

Le correnti di compensazione che fluiscono attraverso la schermatura in sistemi estesi possono danneggiare le interfacce Ethernet. I dispositivi PoE collegati alla wallbox devono essere conformi allo standard IEEE 802.3.

Configurazione

Attivazione della comunicazione Modbus TCP

Il Modbus TCP si attiva tramite il DIP switch DSW1.3 sulla PCB della wallbox. Imposta DSW1.3 su ON e riavvia la stazione di ricarica (premi il pulsante di servizio per ~1 secondo o togli e ripristina l’interruttore automatico).

Layout dei DIP switch KEBA KeContact P30 e panoramica delle funzioni di controllo DSW1
Impostazione DIP switch DSW1.3 per l'attivazione del Modbus TCP su KEBA KeContact P30

L’interfaccia Modbus TCP non può essere utilizzata contemporaneamente all’interfaccia UDP. L’attivazione di DSW1.3 abilita il protocollo utilizzato dall’applicazione di controllo sulla porta 502.

Parametri di connessione

Durante l’importazione del template in TapHome, specifica:

  • Indirizzo IP — l’indirizzo IP della wallbox nella rete locale
  • Porta — 502
  • Unit ID — deve essere impostato su 255 (è non standard e non modificabile)
Configurazione dell’indirizzo IP (c-series)

La c-series ottiene un indirizzo IP tramite DHCP di default (tutti gli switch DSW2.1-DSW2.4 su OFF). In alternativa, è possibile assegnare un indirizzo IP fisso nell’intervallo 192.168.25.11-25 utilizzando i DIP switch DSW2.1-DSW2.4:

DSW2.1DSW2.2DSW2.3DSW2.4Indirizzo IP
OFFOFFOFFOFFDHCP
ONOFFOFFOFF192.168.25.11
ONONOFFOFF192.168.25.13
ONONONON192.168.25.25

Ogni switch aggiunge il proprio valore (1, 2, 4, 8) a una base di 10. La x-series non supporta IP fisso tramite DIP switch.

Se utilizzi DHCP, assegna una prenotazione statica nel router per evitare che l’indirizzo IP cambi dopo un’interruzione di corrente.

Limiti di comunicazione
  • Intervallo di lettura: consigliato > 0,5 secondi
  • Intervallo di scrittura: consigliato > 5 secondi
  • Lunghezza massima di lettura: 2 word per richiesta — i registri non possono essere raggruppati
  • Intervalli IP consentiti: solo indirizzi privati RFC 1918 (192.168.x.x, 172.16-31.x.x, 10.x.x.x)

Funzionalità del dispositivo

Monitoraggio dello stato di ricarica
  • Stato di ricarica — sensore multivalore (sola lettura) che mostra lo stato attuale del processo di ricarica: Avvio, Non pronto, Pronto, In ricarica, Errore, Interrotto. Quando lo stato cambia in Errore, viene automaticamente generato un evento di errore.
  • Stato del cavo — sensore multivalore (sola lettura) che indica lo stato di connessione del cavo/spina: Nessun cavo, Collegato alla stazione, Bloccato, Collegato all’EV, Bloccato e in ricarica. L’azione Sblocca spina consente di sbloccare il cavo quando la ricarica è sospesa.
Misurazione dell’energia
  • Contatore di energia — monitora la potenza attiva (mW convertiti in kW) e il consumo energetico totale (0,1 Wh convertiti in kWh). Tensioni per fase (U1, U2, U3), correnti di ricarica per fase (L1, L2, L3), fattore di potenza (cos phi), corrente di ricarica massima e corrente massima supportata dall’hardware sono disponibili come attributi di servizio.
  • Energia della sessione — monitora l’energia trasferita durante la sessione di ricarica corrente in kWh.
Controllo della ricarica

Il dispositivo Stato di ricarica fornisce due azioni di servizio per la gestione attiva della ricarica:

  • Imposta corrente di ricarica — imposta la corrente di ricarica massima (6-63 A). Il valore viene scritto in milliampere e rimane valido fino al prossimo riavvio.
  • Imposta sessione di ricarica — imposta un limite di energia per la sessione corrente o successiva in Wh. Il processo di ricarica si interrompe automaticamente al raggiungimento del limite.
Gestione della stazione

Le azioni di servizio a livello di modulo forniscono il controllo dell’intera stazione:

  • Attiva/disattiva stazione di ricarica — attiva o disattiva la wallbox. Una stazione disattivata non avvia nuove sessioni di ricarica e la ricarica attiva viene interrotta.
  • Attivazione failsafe — attiva la modalità failsafe con una corrente specificata (6-32 A) e un timeout (10-600 secondi). Se TapHome perde la comunicazione con la wallbox, la ricarica ritorna alla corrente failsafe configurata dopo la scadenza del timeout.
  • Disattivazione failsafe — disattiva la modalità failsafe cancellando il timeout.
Identificazione della stazione

Gli attributi di servizio a livello di modulo forniscono informazioni di identificazione e diagnostica sulla stazione, tra cui numero di serie, versione firmware, tipo di prodotto, tipo di cavo/presa, corrente supportata e serie del dispositivo. È disponibile anche lo stato del contatore di energia integrato.

Funzionalità aggiuntive

La KeContact P30 espone anche registri per la segnalazione dei codici di errore (gruppi di errore decimale-esadecimale), la lettura dell’UID delle carte RFID e la commutazione 1-fase/3-fasi tramite un contattore esterno (contatto X2). Queste funzionalità possono essere aggiunte in un futuro aggiornamento del template.

Risoluzione dei problemi

Nessuna comunicazione Modbus
  1. Verifica che il DIP switch DSW1.3 sia su ON e che la stazione sia stata riavviata
  2. Conferma che l’Unit ID sia impostato su 255 in TapHome — è un valore non standard che viene facilmente trascurato
  3. Controlla che il cavo Ethernet sia correttamente collegato a X3 (RJ45) o X4 (LSA+), non a entrambi
  4. Assicurati che l’indirizzo IP della wallbox sia raggiungibile dal TapHome Core (stessa sottorete, nessun firewall che blocca la porta 502)
  5. Per c-series con DHCP: controlla la tabella dei lease DHCP nel router per l’IP della wallbox
La corrente di ricarica non cambia

Il comando Imposta corrente di ricarica accetta solo valori tra 6000 e 63000 mA. I valori al di fuori di questo intervallo vengono ignorati. Il massimo hardware (determinato dai DIP switch, dalla codifica del cavo e dalla temperatura) ha la priorità — la corrente configurata non può superare questo limite.

Il failsafe non si attiva

Il failsafe richiede entrambi i valori — corrente (registro 5016) e timeout (registro 5018). L’invio della sola corrente failsafe non attiva la modalità failsafe — anche il timeout deve essere impostato. Per mantenere le impostazioni failsafe dopo un riavvio, il comando Failsafe Persist deve essere utilizzato separatamente.

La variante con presa mostra un massimo di 6 A

Nelle varianti con presa (senza cavo collegato permanentemente), il registro Corrente max. supportata mostra 6000 mA (6 A) quando nessun cavo è collegato. Questo è un comportamento normale — il valore si aggiorna alla capacità effettiva del cavo una volta collegato.

Dispositivi disponibili

KEBA KeContact P30 Modulo
Attributi di servizio
Numero di serie
Firmware
Tipo di prodotto
Cavo / Presa
Corrente supportata
Serie del dispositivo
Contatore di energia
Azioni di servizio
Attivazione failsafeAttiva la modalità failsafe — la ricarica ritorna alla corrente specificata in caso di perdita di comunicazione
Disattivazione failsafe
Attiva/disattiva stazione di ricaricaAttiva o disattiva la stazione di ricarica — una stazione disattivata non avvia nuove sessioni

KeContact

Attributi di servizio
Serial Number
MODBUSR(H, 1014, Uint32);
Firmware
var reg := MODBUSR(H, 1018, Uint32, 2);
GetByte(reg, 3) + "." + GetByte(reg, 2) + "." + GetByte(reg, 1)
Product Type
var type := Floor(MODBUSR(H, 1016, Uint32,2)/100000);
IF(type = 3,"KC-P30" ,"Unknown")
Cable / Socket
var cable := Floor(MOD(MODBUSR(H, 1016, Uint32,2),100000)/10000);
SWITCH(cable, 0, "Socket", 1, "Cable", "Unknown");
Supported Current
var supcur := Floor(MOD(MODBUSR(H, 1016, Uint32,2),10000)/1000);
SWITCH(supcur, 1, "13 A", 2, "16 A",3, "20 A", 4, "32 A", "Unknown");
Device Series
var series := Floor(MOD(MODBUSR(H, 1016, Uint32,2),1000)/100);
SWITCH(series,0,"x-series", 1, "c-series", "Unknown");
Energy Meter
var meter := Floor(MOD(MODBUSR(H, 1016, Uint32,2),100)/10);
SWITCH(meter, 1, "Standard not calibrated", 2, "Calibrated, MID", 3, "Calibratable measuring instrument for electrical energy with national certification", "Unknown");
Azioni di servizio
Failsafe Activation
Parametri: Failsafe Current(6A - 32A) (6–32 fc), Failsafe Timeout (10s - 600s) (10–600 Ftim)
MODBUSW(H, 5016, Uint16, fc);
MODBUSW(H, 5018, Uint16, ftim);
Failsafe Deactivation
MODBUSW(H, 5018, Uint16, 0);
Charging Station Enable/Disable
Parametri: Charging Station
MODBUSW(H, 5014, Uint16, endis);
Stato del cavo Interruttore multivalore Solo lettura

Stato di connessione del cavo e della spina — Nessun cavo, Collegato alla stazione, Bloccato, Collegato all'EV, Bloccato e in ricarica

Registro: H:1004 Uint32 numeric
Valori / Stati: No cable plugged · Connected to the charging station · Connected to station and locked · Connected to the car · Cable is connected and charging
Azioni di servizio
Sblocca spina

Stato del cavo

Lettura stato interruttore
MODBUSR(H, 1004, Uint32,2)
Azioni di servizio
Unlock Plug
MODBUSW(H, 5012, Uint16, 0)
Contatore di energia Contatore elettrico Solo lettura

Misurazione della potenza e dell'energia — potenza istantanea (kW) ed energia cumulativa (kWh) con tensione e corrente per fase

Registro: H:1036 (total), H:1020 (demand) Uint32 Unità: kW / kWh
Attributi di servizio
Fattore di potenza (cos phi)
Corrente di ricarica max.
Corrente max. supportata
U1
L1
L2
U2
U3
L3

Contatore di energia

Lettura consumo totale
MODBUSR(H, 1036, Uint32,2) / 1000
Lettura domanda
MODBUSR(H, 1020, Uint32,2) / 1000
Attributi di servizio
Power Factor (cos phi)
(MODBUSR(H, 1046, Uint32,2)/10 ) + "%"
Max Charge Current
(MODBUSR(H, 1100, Uint32,2)/1000) + " A";
Max Supported Current
MODBUSR(H, 1110, Uint32, 2)/1000 + " A"
U1
MODBUSR(H, 1040, Uint32,2) + " V"
L1
(MODBUSR(H, 1008, Uint32, 2)/1000) + " A";
L2
(MODBUSR(H, 1010, Uint32, 2)/1000) + " A";
U2
MODBUSR(H, 1042, Uint32,2) + " V"
U3
MODBUSR(H, 1044, Uint32,2) + " V"
L3
(MODBUSR(H, 1012, Uint32,2)/1000) + " A";
Energia della sessione Variabile Solo lettura

Energia trasferita durante la sessione di ricarica corrente in kWh

Registro: H:1502 Uint32 Unità: kWh

Energia della sessione

Lettura
MODBUSR(H, 1502, Uint32)/1000 ;
Stato di ricarica Interruttore multivalore Solo lettura

Stato del processo di ricarica — Avvio, Non pronto, Pronto, In ricarica, Errore, Interrotto

Registro: H:1000 Uint32 numeric
Valori / Stati: Start-up of Charging · Not Ready For Charging · Ready for Charging · Charging · Error · Interrupted · ${error} · ${notAuthorized}
Azioni di servizio
Imposta corrente di ricarica
Imposta sessione di ricarica

Stato di ricarica

Lettura stato interruttore
MODBUSR(H, 1000, Uint32)
Lettura (modulo)
IF(MODBUSR(H, 1000, Uint32) = 4, ADDERROR("An error has occurred with charger"));
Attributi di servizio
Atribút
Azioni di servizio
Set Charging Current
Parametri: Current (6A - 63A) (6–63 curr)
MODBUSW(H, 5004, Uint16, curr*1000);
Set Charging Session
Parametri: Energy Transmisson (Wh) (1–100 wh)
MODBUSW(H, 5010, Uint16, wh/10 );
Connessione: Modbus TCP • Slave ID: $[SlaveId]
Possibili miglioramenti (9)
  • H:1006 Error Code — Uint32, read-only — decimal error code (convert to hex for error group). Could be added as ModbusVariable.
  • H:1500 RFID Card UID — Uint32, first 4 bytes of last RFID tag — only relevant for RFID-equipped models
  • H:1550 Phase Switch Source — Uint32 — 0=none, 1=OCPP, 2=REST, 3=Modbus, 4=UDP
  • H:1552 Phase Switch State — Uint32 — 1=single-phase, 3=three-phase
  • H:1600 Failsafe Current Setting — Uint32, mA — readback of active failsafe current
  • H:1602 Failsafe Timeout Setting — Uint32, seconds — readback of active failsafe timeout
  • H:5050 Phase Switch Toggle — Uint16, write 0–4 — set phase switching source
  • H:5052 Trigger Phase Switch — Uint16, write 0=1-phase, 1=3-phase — requires x2 contact wiring
  • H:5020 Failsafe Persist — Uint16, write 1 — persists failsafe settings across reboots

Fonti