--- title: "KEBA KeContact P20 Meranie výkonu" description: "Monitorujte nabíjací výkon, prúdy a napätia po fázach a energiu relácie na KEBA KeContact P20 EV wallboxe cez UDP — read-only šablóna TapHome." url: "https://taphome.com/sk/compatibility/keba-kecontact-p20-power-monitoring/" language: sk lastmod: 2026-04-23 generator: hugo ai: topics: ["udp","wallbox","ev-charging","ethernet","power-monitoring","packet-parser"] questions: ["Ako integrovať KEBA KeContact P20 s TapHome?","Čo meria šablóna KEBA KeContact P20 Power Monitoring?","Ako aktivovať UDP komunikáciu na KEBA P20 wallboxe?","Dokáže TapHome riadiť nabíjací prúd na KEBA KeContact P20?","Ktoré varianty KEBA P20 a verzie firmvéru podporujú UDP?","Prečo TapHome neprijíma dáta z KEBA P20 na porte 7090?"] --- # KEBA KeContact P20 Meranie výkonu Komunikácia: Packet Parser → UDP - [KEBA e-mobility (oficiálna stránka)](https://www.keba.com/en/emobility/products/product-overview) > Adresa v sieti > > TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení. > > [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/) ## Návod na integráciu KEBA KeContact P20 je AC Mode 3 EV wallbox (10–32 A, jednofázový alebo trojfázový) vyrábaný medzi rokmi 2012 a 2016. Jeho UDP-based „SmartHome Interface" je podporovaný na hardvérových variantoch **c-series** a **c-series+PLC** (kódy produktu `KC-P20-xxxxxx2x-xxx` a `KC-P20-xxxxxx3x-xxx`) s firmvérom **2.5 alebo vyšším**. Série e-series a b-series toto rozhranie neimplementujú. TapHome komunikuje s wallboxom cez **UDP na porte 7090** pomocou natívneho protokolu KEBA. V každom pollovacom cykle (štandardne 10 s) TapHome odošle textový príkaz `report 3` na IP wallboxu a wallbox odpovedá JSON payloadom obsahujúcim napätia a prúdy po fázach, okamžitý činný výkon, energiu relácie a celkovú energiu. > [!NOTE] > Táto šablóna je určená na **read-only monitorovanie výkonu**. Nespúšťa ani nezastavuje nabíjanie, nemoduluje nabíjací prúd a neautorizuje RFID relácie. Ak potrebujete aktívne riadenie záťaže (napríklad nabíjanie z prebytku FV), použite inú integráciu — nástupca KeContact P30 je pokrytý samostatnou šablónou [KEBA KeContact P30 Nabíjacia stanica](https://taphome.com/sk/compatibility/keba-kecontact-p30-charging-station/), ktorá používa Modbus TCP a poskytuje plné riadenie nabíjania. ## Požiadavky - KEBA KeContact P20 **c-series** alebo **c-series+PLC** (číslica elektroniky `2` alebo `3` v kóde produktu na typovom štítku) - Firmvér **≥ 2.5** (staršie firmvéry nemajú príkaz `report 3`) - Wallbox pripojený do rovnakej LAN siete ako TapHome Core cez Ethernet (LSA+ svorky X4 alebo RJ45 konektor X3) - UDP port **7090** nesmie byť blokovaný firewallom medzi Core a wallboxom - Modbus TCP rozhranie musí byť **vypnuté** — UDP a Modbus TCP rozhrania sa na P20 navzájom vylučujú ## Hardvérové pripojenie P20 poskytuje dve fyzické Ethernet rozhrania. Sú na PCB zapojené paralelne a v danom čase sa dá použiť len jedno — nepoužité musí byť odpojené. - **Ethernet1 (X4)** — LSA+ prepichovacie svorky, odporúčané pre trvalé pevne zapojené inštalácie (použite originálny zarážací nástroj KRONE; zapojte podľa TIA-568A/B farebného kódu pre 100BaseT, tienenie preložte ~1 cm a upnite k uzemňovaciemu bodu [Shd]) - **Ethernet2 (X3)** — RJ45 konektor, určený pre servis/debug, ale použiteľný aj ak je RJ45 kábel už vedený do rozvádzača Použite kábel Cat 5e alebo Cat 6 STP. Svorkovnica (X4) akceptuje priemery vodičov 0,36–0,81 mm (AWG 27–20) pre pevný vodič a 7 × 0,2 mm (AWG 24) pre lanko. > [!WARNING] > Vyrovnávacie prúdy tečúce tienením Ethernetu pri rozsiahlych inštaláciách môžu poškodiť rozhranie. Rozšírenie siete TN-S konzultujte so zodpovedným správcom technických zariadení budovy, ak sa wallbox a Core nachádzajú v rôznych podsystémoch. ## Konfigurácia ### Aktivácia UDP SmartHome rozhrania UDP rozhranie sa aktivuje jedným DIP prepínačom na PCB wallboxu, umiestneným pod krytom konektorového panelu. ![KEBA KeContact P20 rozloženie DIP prepínačov ukazujúce pozíciu DSW1 / DSW2 na PCB a nastavenie DSW1.3 ON pre aktiváciu UDP SmartHome rozhrania](https://taphome.com/images/compatibility/keba-kecontact-p20-power-monitoring/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg) 1. Vypnite wallbox na ističi 2. Odstráňte kryt skrine a kryt konektorového panelu, aby ste sa dostali k banku DIP prepínačov (DSW1 hore, DSW2 dole) 3. Nastavte **DSW1.3 = ON** na aktiváciu UDP SmartHome rozhrania 4. Stlačte servisné tlačidlo na ~1 sekundu alebo vypnite a zapnite wallbox — zmeny DIP prepínačov sa prejavia až po reštarte Kompletný bank DSW1 je zdokumentovaný v Installation Manual. Tu sú uvedené len riadky relevantné pre UDP integráciu: | DIP | Funkcia | Štandard | Požadované pre UDP | |-----|----------|---------|-------------------| | DSW1.1 | Externý vstup povolenia [X1] používaný | OFF | — (ponechať tak, ak nie je zapojený povoľovací kontakt) | | DSW1.2 | Spínací kontaktný výstup [X2] v režime monitorovania stýkača | OFF (zobrazenie stavu) | — (pre túto šablónu nerelevantné) | | **DSW1.3** | **Aktivácia SmartHome Interface cez UDP** | **OFF** | **ON** — **povinné** | | DSW1.6 / 1.7 / 1.8 | Max nabíjací prúd prenášaný cez Control Pilot PWM | závisí od variantu | — (nastaviť podľa menovitej hodnoty wallboxu) | > [!WARNING] > UDP rozhranie a Modbus TCP rozhranie nemôžu byť aktívne súčasne. Ak bol na tejto stanici predtým zapnutý Modbus TCP, pred používaním TapHome UDP šablóny ho vypnite. ### IP adresa (adresovanie DSW2) Pre jeden P20 v sieti postačuje štandardné DHCP adresovanie — všetky prepínače DSW2 nastavené na OFF. Wallbox získa IP z routera. Pre viacstaničné inštalácie v izolovanej sieti možno nastaviť pevné IP adresovanie v rozsahu `192.168.25.11`–`192.168.25.26` cez DSW2.1–DSW2.4 (s DSW2.5 = OFF, DSW2.6 = ON). Každý prepínač pridáva svoju binárnu váhu (1, 2, 4, 8) k základu 10: | Adresa | 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 | ### Import parametre TapHome Pri importe šablóny zadajte: - **IP Address** — IP adresa wallboxu v lokálnej sieti (placeholder `192.168.0.1`) - **Port** — `7090` (pevne dané protokolom KEBA) - **Internal poll interval** — štandardne `10000` ms; protokol KEBA toleruje kratšie intervaly, ale odporúča minimálne 5 s medzi opakovaniami rovnakého príkazu ## Dostupné zariadenia Všetky merania sú odvodené z JSON payloadu `report 3`, ktorý wallbox vracia. Každá hodnota sa aktualizuje pri každom pollovacom cykle; všetky zariadenia sú read-only. ### Napätia po fázach - **Phase 1 Voltage**, **Phase 2 Voltage**, **Phase 3 Voltage** — sieťové napätia vo voltoch, čítané priamo z polí `U1`, `U2`, `U3` odpovede `report 3`. Pri jednofázových inštaláciách má zmysluplnú hodnotu len U1. ### Prúdy po fázach - **Phase 1 Current**, **Phase 2 Current**, **Phase 3 Current** — nabíjacie prúdy v ampéroch, čítané z `I1`, `I2`, `I3` v miliampéroch a šablónou prepočítané na A (delené 1000). Keď žiadne vozidlo nenabíja, hodnoty sú nulové. ### Energia relácie a celková energia Šablóna vystavuje dva merače energie, oba zdieľajú rovnaké čítanie okamžitého činného výkonu (`$.P` z `report 3`, hlásené v mW a prepočítané na kW): - **Present Power** — okamžitý nabíjací výkon (kW) plus energia dodaná v **aktuálnej nabíjacej relácii**. Počítadlo energie relácie (`E pres`, jednotky 0,1 Wh prepočítané na kWh) sa resetuje na nulu pri každom zapojení kábla. - **Total Power** — okamžitý nabíjací výkon (kW) plus **celoživotné kumulatívne počítadlo energie** (`E total`, jednotky 0,1 Wh prepočítané na kWh). Toto počítadlo pretrváva cez relácie, reštarty a cyklovanie napájania a nikdy sa neresetuje. > [!NOTE] > Obe energetické zariadenia vystavujú rovnaké live čítanie výkonu — wallbox KEBA hlási len jednu hodnotu okamžitého činného výkonu. Zariadenia sa líšia iba v tom, ktoré počítadlo energie sledujú (za reláciu vs. celoživotné). To vám v TapHome umožňuje grafovať priebežný súčet relácie aj dlhodobý trend energie. ## Riešenie problémov ### TapHome nezobrazuje žiadne dáta z wallboxu 1. Overte kód produktu wallboxu na typovom štítku. UDP podporujú len `KC-P20-xxxxxx2x-xxx` (c-series) a `KC-P20-xxxxxx3x-xxx` (c-series+PLC) — série e-series a b-series nemožno integrovať cez UDP bez ohľadu na firmvér 2. Potvrďte, že verzia firmvéru je **≥ 2.5**. Staršie firmvéry neodpovedajú na `report 3`. Aktualizácie firmvéru sú dostupné v download zóne na keba.com/emobility 3. Potvrďte **DSW1.3 = ON** — toto je zďaleka najčastejší problém pri nastavení, pretože DIP prepínače sú pod krytom konektorového panelu a pri uvádzaní do prevádzky sa ľahko prehliadnu. Po prepnutí stlačte servisné tlačidlo na 1 sekundu alebo vypnite a zapnite istič 4. Skontrolujte, že Ethernet kábel je pripojený **len k jednému** z X3 (RJ45) alebo X4 (LSA+), nie k obom 5. Uistite sa, že UDP port **7090** je otvorený medzi TapHome Core a wallboxom (žiadne VLAN / firewall blokovanie) 6. Potvrďte, že Modbus TCP rozhranie na wallboxe nie je aktívne — UDP a Modbus TCP sa navzájom vylučujú ### IP adresa wallboxu sa periodicky mení Štandardný režim adresovania je DHCP. Ak router uvoľňuje a preraďuje leasy, wallbox sa môže prihlásiť s inou IP. Buď nastavte v routeri statickú DHCP rezerváciu pre MAC adresu wallboxu, alebo prepnite do režimu pevnej IP cez DSW2 (pri jednotlivých staniciach to je len zriedka potrebné). ### Výkon ukazuje nulu, hoci EV nabíja Polia `P`, `I1/I2/I3`, `E pres` sú naplnené len počas platnej nabíjacej relácie (Plug = 7, State = 3 v `report 2`). Ak je kábel zapojený, ale nabíjanie sa nezačalo, alebo ak je nabíjanie pozastavené vozidlom, `P` bude nula. Toto je očakávané správanie — potvrďte to sledovaním stavovej LED wallboxu (svieti zeleno počas aktívneho nabíjania). ### Energia relácie nezodpovedá nabíjacej udalosti Počítadlo `E pres` sa resetuje na **začiatku** novej relácie (zapojenie kábla). Ak sa EV vo vašom logovacom okne odpojí a znova pripojí, začína sa nová relácia a počítadlo sa vynuluje. Pre kumulatívne štatistiky naprieč reláciami použite celoživotné počítadlo (**Total Power**). ## Dostupné zariadenia 8 Tieto zariadenia sa po importe zobrazia v TapHome. Keba KeContact P20 Meranie výkonu Modul Vlastné premenné Čítanie (modul) ```taphome SENDDATA("report 3"); ``` Listener ```taphome VAR jsonString := TOSTRING(RECEIVEDBYTES); VAR id := PARSEJSON(jsonString, "$.ID", 1); IF(id = 3) report3 := jsonString; END ``` Prúd fázy 1 Premenná Len na čítanie numeric Jednotka: A json\_path Listener ```taphome Va := PARSEJSON(report3, "$.I1", 1) / 1000.0 ``` Prúd fázy 2 Premenná Len na čítanie numeric Jednotka: A json\_path Listener ```taphome Va := PARSEJSON(report3, "$.I2", 1) / 1000.0 ``` Prúd fázy 3 Premenná Len na čítanie numeric Jednotka: A json\_path Listener ```taphome Va := PARSEJSON(report3, "$.I3", 1) / 1000.0 ``` Aktuálny výkon Elektromer Len na čítanie Okamžitý nabíjací výkon (kW) a energia dodaná v aktuálnej nabíjacej relácii (kWh) — resetuje sa pri zapojení kábla numeric Jednotka: kW / kWh json\_path Listener ```taphome Ed := PARSEJSON(report3, "$.['E pres']", 1) / 10000.0; To := PARSEJSON(report3, "$.P", 1) / 1000000.0 ``` Celkový výkon Elektromer Len na čítanie Okamžitý nabíjací výkon (kW) a celoživotné kumulatívne počítadlo energie (kWh) — pretrváva cez relácie a reštarty numeric Jednotka: kW / kWh json\_path Listener ```taphome Ed := PARSEJSON(report3, "$.['E total']", 1) / 10000.0; To := PARSEJSON(report3, "$.P", 1) / 1000000.0 ``` Napätie fázy 1 Premenná Len na čítanie numeric Jednotka: V json\_path Listener ```taphome Va := PARSEJSON(report3, "$.U1", 1) ``` Napätie fázy 2 Premenná Len na čítanie numeric Jednotka: V json\_path Listener ```taphome Va := PARSEJSON(report3, "$.U2", 1) ``` Napätie fázy 3 Premenná Len na čítanie numeric Jednotka: V json\_path Listener ```taphome Va := PARSEJSON(report3, "$.U3", 1) ``` **Pripojenie:** Packet Parser → UDP Možné vylepšenia (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. ## Parametre importu Tieto hodnoty zadáte pri importe XML. | Pýta sa v aplikácii | Predvolené | |------------------------|---------------| | IP adresa | `192.168.0.1` | | Port | `7090` | | Internal poll interval | `10000` | ## Zdroje - 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 Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely. ## Súvisiaca dokumentácia - [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/) - [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/) - [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/) - [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)