TapHome

KEBA KeContact P20 Power Monitoring

Packet Parser → UDP
Trimis de
Ultima actualizare: 04. 2026
KEBA KeContact P20 Power Monitoring

KEBA KeContact P20 este o stație de încărcare AC Mode 3 pentru vehicule electrice (10–32 A, monofazată sau trifazată), produsă între 2012 și 2016. Interfața sa „SmartHome Interface” bazată pe UDP este disponibilă la variantele hardware c-series și c-series+PLC (coduri de produs KC-P20-xxxxxx2x-xxx și KC-P20-xxxxxx3x-xxx) cu firmware 2.5 sau mai nou. Seriile e-series și b-series nu implementează această interfață.

TapHome comunică cu stația de încărcare prin UDP pe portul 7090, folosind protocolul nativ KEBA. La fiecare ciclu de interogare (implicit 10 s), TapHome trimite comanda text report 3 la adresa IP a stației, iar stația răspunde cu un mesaj JSON care conține tensiunile și curenții pe faze, puterea activă instantanee, energia sesiunii și energia totală.

Acest șablon asigură doar monitorizarea puterii (doar citire). Nu pornește și nu oprește încărcarea, nu modulează curentul de încărcare și nu autorizează sesiuni RFID. Dacă aveți nevoie de controlul activ al sarcinii (de exemplu încărcare din surplusul fotovoltaic), folosiți o altă integrare — pentru succesorul KeContact P30 există șablonul dedicat KEBA KeContact P30 Charging Station, care folosește Modbus TCP și oferă controlul complet al încărcării.

Cerințe

  • KEBA KeContact P20 c-series sau c-series+PLC (cifra 2 sau 3 pentru varianta electronicii, în codul de produs de pe plăcuța de identificare)
  • Firmware ≥ 2.5 (firmware-ul mai vechi nu oferă comanda report 3)
  • Stația de încărcare conectată prin Ethernet la aceeași rețea LAN cu TapHome Core (bornele LSA+ X4 sau mufa RJ45 X3)
  • Portul UDP 7090 neblocat de niciun firewall între Core și stația de încărcare
  • Interfața Modbus TCP trebuie să fie dezactivată — la P20, interfețele UDP și Modbus TCP se exclud reciproc

Conectarea hardware

P20 are două interfețe Ethernet fizice. Ele sunt conectate în paralel pe placa electronică și se poate folosi doar una odată — cea nefolosită trebuie deconectată.

  • Ethernet1 (X4) — borne LSA+ cu inserție, recomandate pentru instalațiile fixe, cablate permanent (folosiți unealta de inserție originală KRONE; cablați conform codului de culori TIA-568A/B pentru 100BaseT, îndoiți ecranul înapoi pe aprox. 1 cm și prindeți-l în punctul de împământare [Shd])
  • Ethernet2 (X3) — mufă RJ45, destinată service-ului/depanării, dar utilizabilă dacă în carcasă este deja adus un cablu RJ45

Folosiți cablu Cat 5e sau Cat 6 STP. Blocul de borne (X4) acceptă diametre de conductor de 0,36–0,81 mm (AWG 27–20) pentru cablu rigid și 7 × 0,2 mm (AWG 24) pentru cablu flexibil.

Curenții de egalizare care circulă prin ecranarea Ethernet în instalațiile extinse pot deteriora interfața. Dacă stația de încărcare și Core-ul se află pe subsisteme diferite, discutați extinderea rețelei TN-S cu responsabilii pentru instalațiile clădirii.

Configurare

Activarea interfeței UDP SmartHome

Interfața UDP se activează dintr-un singur comutator DIP de pe placa electronică a stației de încărcare, aflat sub capacul panoului de conexiuni.

Dispunerea comutatoarelor DIP KEBA KeContact P20 — poziția DSW1 / DSW2 pe placa electronică și setarea DSW1.3 ON pentru activarea interfeței UDP SmartHome
  1. Opriți alimentarea stației de încărcare din întrerupătorul automat
  2. Scoateți capacul carcasei și capacul panoului de conexiuni pentru a ajunge la blocurile de comutatoare DIP (DSW1 sus, DSW2 dedesubt)
  3. Setați DSW1.3 = ON pentru a activa interfața SmartHome UDP
  4. Apăsați butonul Service aprox. 1 secundă sau reporniți stația de încărcare prin întreruperea alimentării — modificările comutatoarelor DIP intră în vigoare doar după o repornire

Blocul complet de configurare DSW1 este documentat în manualul de instalare. Aici sunt prezentate doar rândurile relevante pentru integrarea UDP:

DIPFuncțieImplicitNecesar pentru UDP
DSW1.1Se folosește intrarea externă de activare [X1]OFF— (lăsați neschimbat, dacă nu este cablat un contact de activare)
DSW1.2Ieșirea contactului de comutare [X2] în modul de monitorizare a contactoruluiOFF (afișarea stării)— (nu este relevant pentru acest șablon)
DSW1.3Activarea interfeței SmartHome prin UDPOFFON — obligatoriu
DSW1.6 / 1.7 / 1.8Curentul maxim de încărcare transmis prin PWM pe Control Pilotdepinde de variantă— (setați conform valorii nominale a stației)

Interfața UDP și interfața Modbus TCP nu pot fi active în același timp. Dacă pe această stație a fost activată anterior interfața Modbus TCP, dezactivați-o înainte de a vă baza pe șablonul UDP TapHome.

Adresa IP (adresare DSW2)

Pentru o singură stație P20 în rețea este suficientă adresarea DHCP implicită — toate comutatoarele DSW2 pe OFF. Stația de încărcare primește adresa IP de la router.

Pentru instalațiile cu mai multe stații într-o rețea izolată, se poate seta adresarea IP fixă în intervalul 192.168.25.11–192.168.25.26 din DSW2.1–DSW2.4 (cu DSW2.5 = OFF, DSW2.6 = ON). Fiecare comutator adaugă ponderea sa binară (1, 2, 4, 8) la baza 10:

AdresăDSW2.1 (+1)DSW2.2 (+2)DSW2.3 (+4)DSW2.4 (+8)
192.168.25.11ONOFFOFFOFF
192.168.25.13ONONOFFOFF
192.168.25.17ONONONOFF
192.168.25.25ONONONON

Dacă stația de încărcare folosește DHCP, atribuiți-i în router o rezervare DHCP statică, pentru ca adresa IP să nu se schimbe după o pană de curent. TapHome stochează adresa IP ca parametru de import și nu descoperă dispozitivul automat.

Parametrii de import TapHome

La importul șablonului introduceți:

  • IP Address — adresa IP a stației de încărcare în rețeaua locală (valoare exemplificativă: 192.168.0.1)
  • Port — 7090 (fixat de protocolul KEBA)
  • Internal poll interval — implicit 10000 ms; protocolul KEBA tolerează intervale mai scurte, dar recomandă cel puțin 5 s între repetările aceleiași comenzi

Funcțiile dispozitivului

Toate măsurătorile provin din mesajul JSON report 3 returnat de stația de încărcare. Fiecare valoare se actualizează la fiecare ciclu de interogare; toate dispozitivele sunt doar pentru citire.

Tensiunile pe faze
  • Tensiune faza 1, Tensiune faza 2, Tensiune faza 3 — tensiunile de linie în volți, citite direct din câmpurile U1, U2, U3 ale răspunsului report 3. La instalațiile monofazate, doar U1 raportează o valoare relevantă.
Curenții pe faze
  • Curent faza 1, Curent faza 2, Curent faza 3 — curenții de încărcare în amperi, citiți din I1, I2, I3 în miliamperi și convertiți în A (împărțiți la 1000) de șablon. Valorile sunt zero când nu se încarcă niciun vehicul.
Energia sesiunii și energia totală

Șablonul oferă două contoare de energie, care folosesc ambele aceeași citire a puterii active instantanee ($.P din report 3, raportată în mW și convertită în kW):

  • Putere actuală — puterea de încărcare instantanee (kW) plus energia livrată în sesiunea de încărcare curentă. Contorul de energie al sesiunii (E pres, unități de 0,1 Wh convertite în kWh) se resetează la zero de fiecare dată când se conectează un cablu nou.
  • Putere totală — puterea de încărcare instantanee (kW) plus contorul de energie cumulată pe toată durata de viață (E total, unități de 0,1 Wh convertite în kWh). Acest contor se păstrează între sesiuni, reporniri și întreruperi ale alimentării și nu se resetează niciodată.

Ambele dispozitive de energie afișează aceeași citire a puterii în timp real — stația de încărcare KEBA raportează o singură valoare a puterii active instantanee. Dispozitivele diferă doar prin contorul de energie pe care îl urmăresc (pe sesiune vs. pe toată durata de viață). Astfel puteți reprezenta grafic în TapHome atât totalul sesiunii curente, cât și tendința energiei pe termen lung.

Depanare

TapHome nu afișează date de la stația de încărcare
  1. Verificați codul de produs al stației de pe plăcuța de identificare. Doar KC-P20-xxxxxx2x-xxx (c-series) și KC-P20-xxxxxx3x-xxx (c-series+PLC) acceptă UDP — e-series și b-series nu pot fi integrate prin UDP, indiferent de firmware
  2. Verificați dacă versiunea firmware este ≥ 2.5. Firmware-ul mai vechi nu răspunde la report 3. Actualizările de firmware sunt disponibile în zona de descărcări de pe keba.com/emobility
  3. Verificați dacă DSW1.3 = ON — aceasta este de departe cea mai frecventă problemă de configurare, deoarece comutatoarele DIP se află sub capacul panoului de conexiuni și sunt ușor de omis la punerea în funcțiune. După comutare, apăsați butonul Service timp de 1 secundă sau opriți și reporniți întrerupătorul automat
  4. Verificați dacă cablul Ethernet este conectat la doar unul dintre conectorii X3 (RJ45) sau X4 (LSA+), nu la amândoi
  5. Asigurați-vă că portul UDP 7090 este deschis între TapHome Core și stația de încărcare (fără blocare prin VLAN / firewall)
  6. Verificați dacă interfața Modbus TCP a stației nu este activă — UDP și Modbus TCP se exclud reciproc
Adresa IP a stației de încărcare se schimbă periodic

Modul de adresare implicit este DHCP. Dacă routerul eliberează și realocă adresele, stația de încărcare poate porni cu o altă adresă IP. Fie setați în router o rezervare DHCP statică pentru adresa MAC a stației, fie treceți pe modul cu IP fix din DSW2 (pentru o singură stație acest lucru este rareori necesar).

Puterea este zero, deși vehiculul se încarcă

Câmpurile P, I1/I2/I3, E pres se completează doar cât timp este activă o sesiune de încărcare validă (Plug = 7, State = 3 în report 2). Dacă cablul este conectat, dar încărcarea nu a început, sau dacă încărcarea este suspendată de vehicul, P va fi zero. Acesta este un comportament normal — verificați LED-ul de stare al stației (verde continuu în timpul încărcării active).

Energia sesiunii nu corespunde unei încărcări

Contorul E pres se resetează la începutul unei sesiuni noi (conectarea cablului). Dacă vehiculul se deconectează și se reconectează în intervalul înregistrării dvs., începe o sesiune nouă și contorul pornește din nou de la zero. Pentru statistici cumulate pe mai multe sesiuni folosiți contorul pe toată durata de viață (Putere totală).

Dispozitive disponibile

Keba KeContact P20 Power monitoring Modul
Variabile personalizate

Keba KeContact P20 Power monitoring

Citire (modul)
SENDDATA("report 3");
Ascultător
VAR jsonString := TOSTRING(RECEIVEDBYTES);
VAR id := PARSEJSON(jsonString, "$.ID", 1);

IF(id = 3)
    report3 := jsonString;
END
Curent faza 1 Variabilă Doar citire
numeric Unitate: A json_path

Curent faza 1

Ascultător
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
Curent faza 2 Variabilă Doar citire
numeric Unitate: A json_path

Curent faza 2

Ascultător
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
Curent faza 3 Variabilă Doar citire
numeric Unitate: A json_path

Curent faza 3

Ascultător
Va := PARSEJSON(report3, "$.I3", 1) / 1000.0
Putere actuală Contor electric Doar citire

Puterea de încărcare instantanee (kW) și energia livrată în sesiunea de încărcare curentă (kWh) — se resetează la conectarea cablului

numeric Unitate: kW / kWh json_path

Putere actuală

Ascultător
Ed := PARSEJSON(report3, "$.['E pres']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
Putere totală Contor electric Doar citire

Puterea de încărcare instantanee (kW) și contorul de energie cumulată pe toată durata de viață (kWh) — se păstrează între sesiuni și reporniri

numeric Unitate: kW / kWh json_path

Putere totală

Ascultător
Ed := PARSEJSON(report3, "$.['E total']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
Tensiune faza 1 Variabilă Doar citire
numeric Unitate: V json_path

Tensiune faza 1

Ascultător
Va := PARSEJSON(report3, "$.U1", 1)
Tensiune faza 2 Variabilă Doar citire
numeric Unitate: V json_path

Tensiune faza 2

Ascultător
Va := PARSEJSON(report3, "$.U2", 1)
Tensiune faza 3 Variabilă Doar citire
numeric Unitate: V json_path

Tensiune faza 3

Ascultător
Va := PARSEJSON(report3, "$.U3", 1)
Conexiune: Packet Parser → UDP
Îmbunătățiri posibile (17)
  • Power Factor — Power factor (cosphi) reported as 0.1% units (0–1000). Present in the `report 3` JSON response but not mapped to any device in the template.
  • Serial Number — 8-character device serial. Available in `report 3` (and `report 1` / `report 2`) but not exposed by the template.
  • System Uptime — System clock seconds since last startup. Useful for reboot detection but not surfaced by the template.
  • Firmware / Product / Backend / timeQ — Basic device identification (Product, Serial, Firmware, COM-module, Backend, timeQ). Template polls only `report 3`; `report 1` would need to be added for identification diagnostics.
  • Charging State / Plug / Error / Max Curr / Input — Full operating state (State 0–5 = Startup/Not ready/Ready/Charging/Error/Interrupted, Plug 0/1/3/5/7, Error1/Error2, Max curr, Curr HW, Enable sys/user, Input X1). Required for any status-aware automation — template is measurement-only.
  • Charging Session History — Last 30 charging sessions (Session ID, E start, E pres, start/end timestamps, termination reason, RFID tag). Not applicable to real-time monitoring.
  • Set Charging Current (with delay) — Primary active-load-control command (non-permanent). Would allow TapHome to modulate charging current based on PV surplus. Template is read-only — no service action exposed.
  • Set Charging Current (permanent) — Permanent current override (6000–63000 mA). KEBA recommends `currtime` instead for regular use.
  • Enable / Disable Charging — Permanently disable (0) or enable (1) the station until reboot. Not implemented — template cannot pause charging.
  • RFID Start / Stop — Programmatic RFID authorization. Relevant only if AuthON = 1 and a whitelist is configured.
  • Set Energy Limit — Sets an energy limit for the active/next charging session (0.1 Wh units). Charging stops when reached.
  • Auxiliary Relay Output (X2) — Controls auxiliary relay terminal X2 (open / close / pulse). Requires DIP DSW1.2 = ON.
  • Unlock Socket — Unlocks the charging socket (requires charging to be stopped first). Useful after an interrupted session.
  • Show Display Text — P30 only — not functional on P20 (no display). Listed for reference.
  • Set Station Clock — Set the station clock via Unix epoch. Useful when NTP is unavailable.
  • Failsafe Configuration — Fallback current when communication is lost. Valuable safety feature for any load-control integration but not exposed by the read-only template.
  • Push Notifications on State Change — Station can push State, Plug, Input, Enable sys, Max curr and E pres changes to the last UDP sender without polling. Template uses polling only.

Surse

  • KeContact P20 / P30 UDP Programmers Guide V 2.03
    sollis.de 2026-04-23
  • KeContact P20 / P30 Installation manual V 3.20
    www.keba.com 2026-04-23

Ați găsit o problemă la acest șablon de dispozitiv?

Spuneți-ne ce nu funcționează, ce lipsește sau cum ar trebui să se comporte șablonul. Feedbackul dvs. ne ajută să păstrăm catalogul corect.

Verificat de TapHome

Doriți să folosiți acest șablon în TapHome Core?

Deschideți acest șablon în Customer Portal pentru a-l aplica într-una dintre locuințele dvs. sau pentru a propune o îmbunătățire și a o trimite înapoi în catalog.

Deschideți în portal