TapHome

KEBA KeContact P20 Měření výkonu

Packet Parser → UDP
Přidal
Poslední aktualizace: 06. 2026
KEBA KeContact P20 Měření výkonu

KEBA KeContact P20 je AC Mode 3 EV wallbox (10–32 A, jednofázový nebo třífázový) vyráběný mezi roky 2012 a 2016. Jeho UDP-based „SmartHome Interface" je podporován na hardwarových variantách c-series a c-series+PLC (kódy produktu KC-P20-xxxxxx2x-xxx a KC-P20-xxxxxx3x-xxx) s firmwarem 2.5 nebo vyšším. Série e-series a b-series toto rozhraní neimplementují.

TapHome komunikuje s wallboxem přes UDP na portu 7090 pomocí nativního protokolu KEBA. V každém pollovacím cyklu (standardně 10 s) TapHome odešle textový příkaz report 3 na IP wallboxu a wallbox odpovídá JSON payloadem obsahujícím napětí a proudy po fázích, okamžitý činný výkon, energii relace a celkovou energii.

Tato šablona je určena pro read-only monitorování výkonu. Nespouští ani nezastavuje nabíjení, nemoduluje nabíjecí proud a neautorizuje RFID relace. Pokud potřebujete aktivní řízení zátěže (například nabíjení z přebytku FV), použijte jinou integraci — nástupce KeContact P30 je pokryt samostatnou šablonou KEBA KeContact P30 Nabíjecí stanice, která používá Modbus TCP a poskytuje plné řízení nabíjení.

Požadavky

  • KEBA KeContact P20 c-series nebo c-series+PLC (číslice elektroniky 2 nebo 3 v kódu produktu na typovém štítku)
  • Firmware ≥ 2.5 (starší firmware nemá příkaz report 3)
  • Wallbox připojený do stejné LAN sítě jako TapHome Core přes Ethernet (LSA+ svorky X4 nebo RJ45 konektor X3)
  • UDP port 7090 nesmí být blokován firewallem mezi Core a wallboxem
  • Modbus TCP rozhraní musí být vypnuto — UDP a Modbus TCP rozhraní se na P20 vzájemně vylučují

Hardwarové připojení

P20 poskytuje dvě fyzická Ethernet rozhraní. Jsou na PCB zapojena paralelně a v daný čas lze použít jen jedno — nepoužité musí být odpojeno.

  • Ethernet1 (X4) — LSA+ zařezávací svorky, doporučené pro trvalé pevně zapojené instalace (použijte originální zarážecí nástroj KRONE; zapojte podle TIA-568A/B barevného kódu pro 100BaseT, stínění přeložte ~1 cm a upevněte k uzemňovacímu bodu [Shd])
  • Ethernet2 (X3) — RJ45 konektor, určený pro servis/debug, ale použitelný i pokud je RJ45 kabel již veden do rozvaděče

Použijte kabel Cat 5e nebo Cat 6 STP. Svorkovnice (X4) přijímá průměry vodičů 0,36–0,81 mm (AWG 27–20) pro pevný vodič a 7 × 0,2 mm (AWG 24) pro lanko.

Vyrovnávací proudy tekoucí stíněním Ethernetu u rozsáhlých instalací mohou poškodit rozhraní. Rozšíření sítě TN-S konzultujte se zodpovědným správcem technického zařízení budovy, pokud se wallbox a Core nacházejí v různých podsystémech.

Konfigurace

Aktivace UDP SmartHome rozhraní

UDP rozhraní se aktivuje jedním DIP přepínačem na PCB wallboxu, umístěným pod krytem konektorového panelu.

KEBA KeContact P20 rozložení DIP přepínačů ukazující pozici DSW1 / DSW2 na PCB a nastavení DSW1.3 ON pro aktivaci UDP SmartHome rozhraní
  1. Vypněte wallbox na jističi
  2. Odstraňte kryt skříně a kryt konektorového panelu, abyste se dostali k banku DIP přepínačů (DSW1 nahoře, DSW2 dole)
  3. Nastavte DSW1.3 = ON pro aktivaci UDP SmartHome rozhraní
  4. Stiskněte servisní tlačítko na ~1 sekundu nebo vypněte a zapněte wallbox — změny DIP přepínačů se projeví až po restartu

Kompletní bank DSW1 je zdokumentován v Installation Manual. Zde jsou uvedeny jen řádky relevantní pro UDP integraci:

DIPFunkceVýchozíPožadováno pro UDP
DSW1.1Externí vstup povolení [X1] použitOFF— (ponechat tak, pokud není zapojen povolovací kontakt)
DSW1.2Spínací kontaktní výstup [X2] v režimu monitorování stykačeOFF (zobrazení stavu)— (pro tuto šablonu nerelevantní)
DSW1.3Aktivace SmartHome Interface přes UDPOFFON — povinné
DSW1.6 / 1.7 / 1.8Max nabíjecí proud přenášený přes Control Pilot PWMzávisí na variantě— (nastavit podle jmenovité hodnoty wallboxu)

UDP rozhraní a Modbus TCP rozhraní nemohou být aktivní současně. Pokud byl na této stanici dříve zapnut Modbus TCP, před používáním TapHome UDP šablony jej vypněte.

IP adresa (adresování DSW2)

Pro jeden P20 v síti postačuje standardní DHCP adresování — všechny přepínače DSW2 nastaveny na OFF. Wallbox získá IP z routeru.

Pro vícestaniční instalace v izolované síti lze nastavit pevné IP adresování v rozsahu 192.168.25.11–192.168.25.26 přes DSW2.1–DSW2.4 (s DSW2.5 = OFF, DSW2.6 = ON). Každý přepínač přidává svou binární 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

Pokud wallbox používá DHCP, přiřaďte v routeru statickou DHCP rezervaci, aby se IP adresa po výpadku napájení neměnila. TapHome ukládá IP jako import parametr a zařízení automaticky neobjevuje.

Import parametry TapHome

Při importu šablony zadejte:

  • IP Address — IP adresa wallboxu v lokální síti (placeholder 192.168.0.1)
  • Port — 7090 (pevně daný protokolem KEBA)
  • Internal poll interval — standardně 10000 ms; protokol KEBA toleruje kratší intervaly, ale doporučuje minimálně 5 s mezi opakováními stejného příkazu

Dostupná zařízení

Všechna měření jsou odvozena z JSON payloadu report 3, který wallbox vrací. Každá hodnota se aktualizuje při každém pollovacím cyklu; všechna zařízení jsou read-only.

Napětí po fázích
  • Phase 1 Voltage, Phase 2 Voltage, Phase 3 Voltage — síťová napětí ve voltech, čtená přímo z polí U1, U2, U3 odpovědi report 3. Při jednofázových instalacích má smysluplnou hodnotu jen U1.
Proudy po fázích
  • Phase 1 Current, Phase 2 Current, Phase 3 Current — nabíjecí proudy v ampérech, čtené z I1, I2, I3 v miliampérech a šablonou přepočítané na A (děleno 1000). Když žádné vozidlo nenabíjí, hodnoty jsou nulové.
Energie relace a celková energie

Šablona vystavuje dva měřiče energie, oba sdílí stejné čtení okamžitého činného výkonu ($.P z report 3, hlášeno v mW a přepočítáno na kW):

  • Present Power — okamžitý nabíjecí výkon (kW) plus energie dodaná v aktuální nabíjecí relaci. Počítadlo energie relace (E pres, jednotky 0,1 Wh přepočítané na kWh) se resetuje na nulu při každém zapojení kabelu.
  • Total Power — okamžitý nabíjecí výkon (kW) plus celoživotní kumulativní počítadlo energie (E total, jednotky 0,1 Wh přepočítané na kWh). Toto počítadlo přetrvává napříč relacemi, restarty a cyklováním napájení a nikdy se neresetuje.

Obě energetická zařízení vystavují stejné live čtení výkonu — wallbox KEBA hlásí jen jednu hodnotu okamžitého činného výkonu. Zařízení se liší pouze v tom, které počítadlo energie sledují (za relaci vs. celoživotní). To vám v TapHome umožňuje grafovat průběžný součet relace i dlouhodobý trend energie.

Řešení problémů

TapHome nezobrazuje žádná data z wallboxu
  1. Ověřte kód produktu wallboxu na typovém štítku. UDP podporují jen KC-P20-xxxxxx2x-xxx (c-series) a KC-P20-xxxxxx3x-xxx (c-series+PLC) — série e-series a b-series nelze integrovat přes UDP bez ohledu na firmware
  2. Potvrďte, že verze firmwaru je ≥ 2.5. Starší firmware neodpovídá na report 3. Aktualizace firmwaru jsou dostupné v download zóně na keba.com/emobility
  3. Potvrďte DSW1.3 = ON — toto je zdaleka nejčastější problém při nastavení, protože DIP přepínače jsou pod krytem konektorového panelu a při uvádění do provozu se snadno přehlédnou. Po přepnutí stiskněte servisní tlačítko na 1 sekundu nebo vypněte a zapněte jistič
  4. Zkontrolujte, že Ethernet kabel je připojen jen k jednomu z X3 (RJ45) nebo X4 (LSA+), ne k oběma
  5. Ujistěte se, že UDP port 7090 je otevřen mezi TapHome Core a wallboxem (žádné VLAN / firewall blokování)
  6. Potvrďte, že Modbus TCP rozhraní na wallboxu není aktivní — UDP a Modbus TCP se vzájemně vylučují
IP adresa wallboxu se periodicky mění

Standardní režim adresování je DHCP. Pokud router uvolňuje a přeřazuje leasy, wallbox se může přihlásit s jinou IP. Buď nastavte v routeru statickou DHCP rezervaci pro MAC adresu wallboxu, nebo přepněte do režimu pevné IP přes DSW2 (u jednotlivých stanic je to jen zřídka nutné).

Výkon ukazuje nulu, přestože EV nabíjí

Pole P, I1/I2/I3, E pres jsou naplněna jen během platné nabíjecí relace (Plug = 7, State = 3 v report 2). Pokud je kabel zapojen, ale nabíjení nezačalo, nebo je-li nabíjení pozastaveno vozidlem, P bude nula. Toto je očekávané chování — potvrďte to sledováním stavové LED wallboxu (svítí zeleně při aktivním nabíjení).

Energie relace neodpovídá nabíjecí události

Počítadlo E pres se resetuje na začátku nové relace (zapojení kabelu). Pokud se EV ve vašem logovacím okně odpojí a znovu připojí, začíná nová relace a počítadlo se vynuluje. Pro kumulativní statistiky napříč relacemi použijte celoživotní počítadlo (Total Power).

Dostupná zařízení

Keba KeContact P20 Měření výkonu Modul
Vlastní proměnné

Keba KeContact P20 Power monitoring

Čtení (modul)
SENDDATA("report 3");
Listener
VAR jsonString := TOSTRING(RECEIVEDBYTES);
VAR id := PARSEJSON(jsonString, "$.ID", 1);

IF(id = 3)
    report3 := jsonString;
END
Proud fáze 1 Proměnná Pouze ke čtení
numeric Jednotka: A json_path

Proud fáze 1

Listener
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
Proud fáze 2 Proměnná Pouze ke čtení
numeric Jednotka: A json_path

Proud fáze 2

Listener
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
Proud fáze 3 Proměnná Pouze ke čtení
numeric Jednotka: A json_path

Proud fáze 3

Listener
Va := PARSEJSON(report3, "$.I3", 1) / 1000.0
Aktuální výkon Elektroměr Pouze ke čtení

Okamžitý nabíjecí výkon (kW) a energie dodaná v aktuální nabíjecí relaci (kWh) — resetuje se při zapojení kabelu

numeric Jednotka: kW / kWh json_path

Aktuální výkon

Listener
Ed := PARSEJSON(report3, "$.['E pres']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
Celkový výkon Elektroměr Pouze ke čtení

Okamžitý nabíjecí výkon (kW) a celoživotní kumulativní počítadlo energie (kWh) — přetrvává napříč relacemi a restarty

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ětí fáze 1 Proměnná Pouze ke čtení
numeric Jednotka: V json_path

Napětí fáze 1

Listener
Va := PARSEJSON(report3, "$.U1", 1)
Napětí fáze 2 Proměnná Pouze ke čtení
numeric Jednotka: V json_path

Napětí fáze 2

Listener
Va := PARSEJSON(report3, "$.U2", 1)
Napětí fáze 3 Proměnná Pouze ke čtení
numeric Jednotka: V json_path

Napětí fáze 3

Listener
Va := PARSEJSON(report3, "$.U3", 1)
Připojení: Packet Parser → UDP
Možná vylepšení (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 jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu