TapHome

KEBA KeContact P20 Meranie výkonu

Packet Parser → UDP
Pridal
Posledná aktualizácia: 05. 2026
KEBA KeContact P20 Meranie výkonu

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.

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, 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.

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
  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:

DIPFunkciaŠtandardPožadované pre UDP
DSW1.1Externý vstup povolenia [X1] používanýOFF— (ponechať tak, ak nie je zapojený povoľovací kontakt)
DSW1.2Spínací kontaktný výstup [X2] v režime monitorovania stýkačaOFF (zobrazenie stavu)— (pre túto šablónu nerelevantné)
DSW1.3Aktivácia SmartHome Interface cez UDPOFFON — povinné
DSW1.6 / 1.7 / 1.8Max nabíjací prúd prenášaný cez Control Pilot PWMzávisí od variantu— (nastaviť podľa menovitej hodnoty wallboxu)

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:

AdresaDSW2.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

Ak wallbox používa DHCP, priraďte v routeri statickú DHCP rezerváciu, aby sa IP adresa po výpadku napájania nezmenila. TapHome ukladá IP ako import parameter a zariadenie automaticky neobjavuje.

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.

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

Keba KeContact P20 Meranie výkonu Modul
Vlastné premenné

Keba KeContact P20 Power monitoring

Čítanie (modul)
SENDDATA("report 3");
Listener
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

Prúd fázy 1

Listener
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
Prúd fázy 2 Premenná Len na čítanie
numeric Jednotka: A json_path

Prúd fázy 2

Listener
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
Prúd fázy 3 Premenná Len na čítanie
numeric Jednotka: A json_path

Prúd fázy 3

Listener
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

Aktuálny výkon

Listener
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

Celkový výkon

Listener
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

Napätie fázy 1

Listener
Va := PARSEJSON(report3, "$.U1", 1)
Napätie fázy 2 Premenná Len na čítanie
numeric Jednotka: V json_path

Napätie fázy 2

Listener
Va := PARSEJSON(report3, "$.U2", 1)
Napätie fázy 3 Premenná Len na čítanie
numeric Jednotka: V json_path

Napätie fázy 3

Listener
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.

Zdroje

  • 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

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli