TapHome

KEBA KeContact P20 Teljesítménymérés

Packet Parser → UDP
Beküldő
Utoljára frissítve: 06. 2026
KEBA KeContact P20 Teljesítménymérés

A KEBA KeContact P20 egy AC Mode 3 EV wallbox (10–32 A, egyfázisú vagy háromfázisú), amelyet 2012 és 2016 között gyártottak. UDP-alapú „SmartHome Interface"-ét a c-series és c-series+PLC hardvervariánsok (termékkódok KC-P20-xxxxxx2x-xxx és KC-P20-xxxxxx3x-xxx) támogatják 2.5-ös vagy újabb firmware-rel. Az e-series és b-series ezt az interfészt nem implementálja.

A TapHome a wallboxszal UDP-n keresztül a 7090-es porton kommunikál a natív KEBA protokoll használatával. Minden lekérdezési ciklusban (alapértelmezetten 10 s) a TapHome elküldi a report 3 szöveges parancsot a wallbox IP-jére, a wallbox pedig JSON payloaddal válaszol, amely tartalmazza a fázisonkénti feszültségeket és áramokat, a pillanatnyi hatásos teljesítményt, a munkamenet energiáját és az összes energiát.

Ez a sablon csak olvasható teljesítménymonitorozás. Nem indítja vagy állítja le a töltést, nem modulálja a töltési áramot, és nem hitelesít RFID munkameneteket. Ha aktív terhelésvezérlésre van szüksége (például PV többlet töltésére), használjon másik integrációt — a KeContact P30 utód a külön KEBA KeContact P30 Töltőállomás sablonban található, amely Modbus TCP-t használ és teljes töltésvezérlést biztosít.

Követelmények

  • KEBA KeContact P20 c-series vagy c-series+PLC (elektronikai számjegy 2 vagy 3 a termékkódban az adattáblán)
  • Firmware ≥ 2.5 (a régebbi firmware nem ismeri a report 3 parancsot)
  • A wallbox ugyanazon a LAN-on van, mint a TapHome Core, Etherneten keresztül (LSA+ sorkapcsok X4 vagy RJ45 csatlakozó X3)
  • A 7090-es UDP portot nem blokkolja tűzfal a Core és a wallbox között
  • A Modbus TCP interfésznek letiltottnak kell lennie — az UDP és a Modbus TCP interfészek kölcsönösen kizárják egymást a P20-on

Hardveres csatlakozás

A P20 két fizikai Ethernet interfészt biztosít. Ezek a NYÁK-on párhuzamosan vannak bekötve, és egyszerre csak az egyik használható — a nem használtat le kell kötni.

  • Ethernet1 (X4) — LSA+ lyukasztós kapcsok, ajánlott állandó, rögzített kábelezésű telepítésekhez (eredeti KRONE belenyomó szerszámot használjon; kösse be a TIA-568A/B színkód szerint 100BaseT-hez, az árnyékolást hajtsa vissza ~1 cm-rel, és rögzítse a [Shd] földelési ponton)
  • Ethernet2 (X3) — RJ45 csatlakozó, szerviz/debug célra tervezve, de használható, ha már van RJ45 kábel a szekrénybe vezetve

Használjon Cat 5e vagy Cat 6 STP kábelt. A sorkapocs (X4) 0,36–0,81 mm (AWG 27–20) vezeték átmérőket fogad el tömör vezetékhez és 7 × 0,2 mm (AWG 24) értéket rugalmas vezetékhez.

Az Ethernet árnyékoláson átfolyó kiegyenlítő áramok kiterjedt telepítéseknél károsíthatják az interfészt. A TN-S hálózat bővítését beszélje meg a felelős épületgépész szakemberrel, ha a wallbox és a Core különböző alrendszerekben van.

Konfiguráció

Az UDP SmartHome interfész aktiválása

Az UDP interfészt a wallbox NYÁK-án egyetlen DIP kapcsolóval aktiválhatja, amely a csatlakozópanel fedele alatt található.

KEBA KeContact P20 DIP kapcsoló elrendezése, amely a DSW1 / DSW2 pozícióját mutatja a NYÁK-on és a DSW1.3 ON beállítást az UDP SmartHome interfész aktiválásához
  1. Kapcsolja le a wallboxot a kismegszakítónál
  2. Távolítsa el a burkolat fedelét és a csatlakozópanel fedelét, hogy elérje a DIP kapcsoló bankokat (DSW1 fent, DSW2 lent)
  3. Állítsa a DSW1.3 = ON értékre az UDP SmartHome interfész aktiválásához
  4. Nyomja meg a szerviz gombot ~1 másodpercig, vagy kapcsolja ki-be a wallboxot — a DIP kapcsoló változások csak újraindítás után lépnek életbe

A teljes DSW1 bank az Installation Manualban van dokumentálva. Itt csak az UDP integrációhoz releváns sorok találhatók:

DIPFunkcióAlapértelmezettSzükséges az UDP-hez
DSW1.1Külső engedélyező bemenet [X1] használvaOFF— (hagyja, hacsak nincs engedélyező kontaktus bekötve)
DSW1.2Kapcsolókontaktus kimenet [X2] kontaktor-felügyeleti módbanOFF (állapotkijelzés)— (ehhez a sablonhoz nem releváns)
DSW1.3SmartHome Interface aktiválása UDP-n keresztülOFFON — kötelező
DSW1.6 / 1.7 / 1.8Max. töltőáram Control Pilot PWM-en keresztül továbbítvaváltozattól függ— (a wallbox névleges értékére állítva)

Az UDP interfész és a Modbus TCP interfész nem lehet egyszerre aktív. Ha ezen az állomáson korábban engedélyezve volt a Modbus TCP, tiltsa le, mielőtt a TapHome UDP sablonra támaszkodna.

IP cím (DSW2 címzés)

Egyetlen P20 esetén a hálózaton a szabványos DHCP címzés elegendő — minden DSW2 kapcsoló OFF. A wallbox az IP-jét a routertől kapja.

Többállomásos telepítéseknél elkülönített hálózaton fix IP címzést lehet beállítani a 192.168.25.11–192.168.25.26 tartományban a DSW2.1–DSW2.4 kapcsolókkal (DSW2.5 = OFF, DSW2.6 = ON mellett). Minden kapcsoló hozzáadja a bináris súlyát (1, 2, 4, 8) a 10-es alaphoz:

CímDSW2.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

Ha a wallbox DHCP-t használ, állítson be statikus DHCP foglalást a routerben, hogy az IP áramszünet után ne változzon. A TapHome az IP-t import paraméterként tárolja, és nem fedezi fel automatikusan az eszközt.

TapHome import paraméterek

A sablon importálásakor adja meg:

  • IP Address — a wallbox IP-je a helyi hálózaton (helyőrző 192.168.0.1)
  • Port — 7090 (a KEBA protokoll által rögzítve)
  • Internal poll interval — alapértelmezetten 10000 ms; a KEBA protokoll elviseli a rövidebb intervallumokat, de legalább 5 s-ot ajánl ugyanazon parancs ismétlései között

Elérhető eszközök

Minden mérés a wallbox által visszaadott report 3 JSON payloadból származik. Minden érték frissül minden lekérdezési ciklusban; minden eszköz csak olvasható.

Fázisonkénti feszültségek
  • Phase 1 Voltage, Phase 2 Voltage, Phase 3 Voltage — hálózati feszültségek voltban, közvetlenül a report 3 válasz U1, U2, U3 mezőiből olvasva. Egyfázisú telepítéseknél csak az U1 ad értelmes értéket.
Fázisonkénti áramok
  • Phase 1 Current, Phase 2 Current, Phase 3 Current — töltési áramok amperben, az I1, I2, I3 értékekből milliamperben olvasva és a sablon által A-re konvertálva (1000-rel osztva). Az értékek nullák, ha egyetlen jármű sem tölt.
Munkamenet és teljes energia

A sablon két energiamérőt biztosít, mindkettő ugyanazt a pillanatnyi hatásos teljesítmény értéket ($.P a report 3-ból, mW-ban jelentve és kW-ra konvertálva) használja:

  • Present Power — pillanatnyi töltési teljesítmény (kW) plusz az aktuális töltési munkamenetben átadott energia. A munkamenet-energiaszámláló (E pres, 0,1 Wh egységek kWh-ra konvertálva) minden kábel csatlakoztatásakor nullára áll.
  • Total Power — pillanatnyi töltési teljesítmény (kW) plusz az élettartamon keresztüli kumulatív energiaszámláló (E total, 0,1 Wh egységek kWh-ra konvertálva). Ez a számláló munkameneteken, újraindításokon és áramkimaradásokon át megmarad, és soha nem áll nullára.

Mindkét energiaeszköz ugyanazt az élő teljesítményértéket jeleníti meg — a KEBA wallbox csak egyetlen pillanatnyi hatásos teljesítményértéket jelent. Az eszközök csak abban térnek el, hogy melyik energiaszámlálót követik (munkamenetenként vs. élettartam). Így a TapHome-ban mind a folyamatos munkamenet-összeget, mind a hosszú távú energiatrendet grafikonon jelenítheti meg.

Hibaelhárítás

A TapHome nem mutat adatokat a wallboxról
  1. Ellenőrizze a wallbox termékkódját az adattáblán. Csak a KC-P20-xxxxxx2x-xxx (c-series) és a KC-P20-xxxxxx3x-xxx (c-series+PLC) támogatja az UDP-t — az e-series és b-series firmware-től függetlenül nem integrálható UDP-n keresztül
  2. Erősítse meg, hogy a firmware verziója ≥ 2.5. A régebbi firmware nem válaszol a report 3-ra. Firmware frissítések a keba.com/emobility letöltési területén érhetők el
  3. Erősítse meg a DSW1.3 = ON értéket — ez messze a leggyakoribb beállítási probléma, mert a DIP kapcsolók a csatlakozópanel fedele alatt vannak, és üzembe helyezéskor könnyen figyelmen kívül hagyhatók. Átkapcsolás után nyomja meg a szerviz gombot 1 másodpercig, vagy kapcsolja le-fel a kismegszakítót
  4. Ellenőrizze, hogy az Ethernet kábel csak egyhez csatlakozik-e a X3 (RJ45) vagy X4 (LSA+) közül, nem mindkettőhöz
  5. Győződjön meg arról, hogy a 7090-es UDP port nyitva van a TapHome Core és a wallbox között (nincs VLAN / tűzfal blokkolás)
  6. Erősítse meg, hogy a wallboxon a Modbus TCP interfész nem aktív — az UDP és a Modbus TCP kölcsönösen kizárják egymást
A wallbox IP címe időnként változik

Az alapértelmezett címzési mód a DHCP. Ha a router felszabadítja és újra kiosztja a lease-eket, a wallbox másik IP-n indulhat. Vagy állítson be a routerben statikus DHCP foglalást a wallbox MAC címéhez, vagy váltson fix-IP módra a DSW2-n keresztül (egyedi állomásoknál ez ritkán szükséges).

A teljesítmény nullát mutat, pedig az EV tölt

A P, I1/I2/I3, E pres mezők csak érvényes töltési munkamenet alatt töltődnek fel (Plug = 7, State = 3 a report 2-ben). Ha a kábel be van dugva, de a töltés még nem kezdődött el, vagy a jármű felfüggesztette a töltést, P nulla lesz. Ez várható viselkedés — erősítse meg a wallbox állapotjelző LED-jének figyelésével (aktív töltés közben folyamatos zöld).

A munkamenet-energia nem egyezik egy töltési eseménnyel

Az E pres számláló új munkamenet kezdetén (csatlakoztatáskor) nullára áll. Ha az EV a naplózási ablakában lecsatlakozik és újra csatlakozik, új munkamenet indul, és a számláló nulláról kezdődik. A munkameneteken átívelő kumulatív statisztikákhoz használja az élettartam számlálót (Total Power).

Elérhető eszközök

Keba KeContact P20 Teljesítménymérés Modul
Egyéni változók

Keba KeContact P20 Power monitoring

Olvasás (modul)
SENDDATA("report 3");
Figyelő
VAR jsonString := TOSTRING(RECEIVEDBYTES);
VAR id := PARSEJSON(jsonString, "$.ID", 1);

IF(id = 3)
    report3 := jsonString;
END
1. fázis áram Változó Csak olvasható
numeric Egység: A json_path

1. fázis áram

Figyelő
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
2. fázis áram Változó Csak olvasható
numeric Egység: A json_path

2. fázis áram

Figyelő
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
3. fázis áram Változó Csak olvasható
numeric Egység: A json_path

3. fázis áram

Figyelő
Va := PARSEJSON(report3, "$.I3", 1) / 1000.0
Aktuális teljesítmény Villanyóra Csak olvasható

Pillanatnyi töltési teljesítmény (kW) és az aktuális töltési munkamenetben átadott energia (kWh) — csatlakoztatáskor nullázódik

numeric Egység: kW / kWh json_path

Aktuális teljesítmény

Figyelő
Ed := PARSEJSON(report3, "$.['E pres']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
Teljes teljesítmény Villanyóra Csak olvasható

Pillanatnyi töltési teljesítmény (kW) és az élettartamon keresztüli kumulatív energiaszámláló (kWh) — munkameneteken és újraindításokon át megmarad

numeric Egység: kW / kWh json_path

Teljes teljesítmény

Figyelő
Ed := PARSEJSON(report3, "$.['E total']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
1. fázis feszültség Változó Csak olvasható
numeric Egység: V json_path

1. fázis feszültség

Figyelő
Va := PARSEJSON(report3, "$.U1", 1)
2. fázis feszültség Változó Csak olvasható
numeric Egység: V json_path

2. fázis feszültség

Figyelő
Va := PARSEJSON(report3, "$.U2", 1)
3. fázis feszültség Változó Csak olvasható
numeric Egység: V json_path

3. fázis feszültség

Figyelő
Va := PARSEJSON(report3, "$.U3", 1)
Kapcsolat: Packet Parser → UDP
Lehetséges fejlesztések (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.

Források

  • 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

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

TapHome által hitelesítve

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon