--- title: "KEBA KeContact P20 Teljesítménymérés" description: "KEBA KeContact P20 EV wallbox UDP-n: töltési teljesítmény, fázisonkénti áram/feszültség, munkamenet-energia. Csak olvasható TapHome sablon." url: "https://taphome.com/hu/compatibility/keba-kecontact-p20-power-monitoring/" language: hu lastmod: 2026-04-23 generator: hugo ai: topics: ["udp","wallbox","ev-charging","ethernet","power-monitoring","packet-parser"] questions: ["Hogyan integrálható a KEBA KeContact P20 a TapHome rendszerrel?","Mit mér a KEBA KeContact P20 Power Monitoring sablon?","Hogyan aktiválható az UDP kommunikáció a KEBA P20 wallboxon?","A TapHome tudja-e szabályozni a töltési áramot a KEBA KeContact P20-on?","Mely KEBA P20 változatok és firmware verziók támogatják az UDP-t?","Miért nem kap adatot a TapHome a KEBA P20-tól a 7090-es porton?"] --- # KEBA KeContact P20 Teljesítménymérés Kommunikáció: Packet Parser → UDP - [KEBA e-mobility (hivatalos oldal)](https://www.keba.com/en/emobility/products/product-overview) > Hálózati cím > > A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet. > > [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/) ## Integrációs útmutató 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. > [!NOTE] > 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](https://taphome.com/hu/compatibility/keba-kecontact-p30-charging-station/) 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. > [!WARNING] > 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](https://taphome.com/images/compatibility/keba-kecontact-p20-power-monitoring/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg) 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: | DIP | Funkció | Alapértelmezett | Szükséges az UDP-hez | |-----|----------|---------|-------------------| | DSW1.1 | Külső engedélyező bemenet [X1] használva | OFF | — (hagyja, hacsak nincs engedélyező kontaktus bekötve) | | DSW1.2 | Kapcsolókontaktus kimenet [X2] kontaktor-felügyeleti módban | OFF (állapotkijelzés) | — (ehhez a sablonhoz nem releváns) | | **DSW1.3** | **SmartHome Interface aktiválása UDP-n keresztül** | **OFF** | **ON** — **kötelező** | | DSW1.6 / 1.7 / 1.8 | Max. töltőáram Control Pilot PWM-en keresztül továbbítva | változattól függ | — (a wallbox névleges értékére állítva) | > [!WARNING] > 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ím | DSW2.1 (+1) | DSW2.2 (+2) | DSW2.3 (+4) | DSW2.4 (+8) | |---------|-------------|-------------|-------------|-------------| | 192.168.25.11 | ON | OFF | OFF | OFF | | 192.168.25.13 | ON | ON | OFF | OFF | | 192.168.25.17 | ON | ON | ON | OFF | | 192.168.25.25 | ON | ON | ON | ON | ### 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. > [!NOTE] > 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 8 Ezek az eszközök az importálás után jelennek meg a TapHome-ban. Keba KeContact P20 Teljesítménymérés Modul Egyéni változók Olvasás (modul) ```taphome SENDDATA("report 3"); ``` Figyelő ```taphome 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 Figyelő ```taphome Va := PARSEJSON(report3, "$.I1", 1) / 1000.0 ``` 2\. fázis áram Változó Csak olvasható numeric Egység: A json\_path Figyelő ```taphome Va := PARSEJSON(report3, "$.I2", 1) / 1000.0 ``` 3\. fázis áram Változó Csak olvasható numeric Egység: A json\_path Figyelő ```taphome 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 Figyelő ```taphome 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 Figyelő ```taphome 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 Figyelő ```taphome Va := PARSEJSON(report3, "$.U1", 1) ``` 2\. fázis feszültség Változó Csak olvasható numeric Egység: V json\_path Figyelő ```taphome Va := PARSEJSON(report3, "$.U2", 1) ``` 3\. fázis feszültség Változó Csak olvasható numeric Egység: V json\_path Figyelő ```taphome 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. ## Importálási paraméterek Ezeket az értékeket az XML importálásakor adja meg. | Az alkalmazás kéri | Alapérték | |------------------------|---------------| | IP-cím | `192.168.0.1` | | Port | `7090` | | Internal poll interval | `10000` | ## Források - KeContact P20 / P30 UDP Programmers Guide V 2.03 [sollis.de](https://sollis.de/wp-content/uploads/UDP-Programmieranleitung.pdf) 2026-04-23 - KeContact P20 / P30 Installation manual V 3.20 [www.keba.com](https://www.keba.com/file/downloads/e-mobility/KeContact_KCP20_30_ih_en.pdf) 2026-04-23 A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket. ## Kapcsolódó dokumentáció - [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/) - [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/) - [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)