---
title: "KEBA KeContact P20 Měření výkonu"
description: "Monitorujte nabíjecí výkon, proudy a napětí po fázích a energii relace na KEBA KeContact P20 EV wallboxu přes UDP — read-only šablona TapHome."
url: "https://taphome.com/cs/compatibility/keba-kecontact-p20-power-monitoring/"
language: cs
lastmod: 2026-04-23
generator: hugo
ai:
  topics: ["udp","wallbox","ev-charging","ethernet","power-monitoring","packet-parser"]
  questions: ["Jak integrovat KEBA KeContact P20 s TapHome?","Co měří šablona KEBA KeContact P20 Power Monitoring?","Jak aktivovat UDP komunikaci na KEBA P20 wallboxu?","Dokáže TapHome řídit nabíjecí proud na KEBA KeContact P20?","Které varianty KEBA P20 a verze firmwaru podporují UDP?","Proč TapHome nepřijímá data z KEBA P20 na portu 7090?"]
---

# KEBA KeContact P20 Měření výkonu

Komunikace: Packet Parser → UDP

- [KEBA e-mobility (oficiální stránka)](https://www.keba.com/en/emobility/products/product-overview)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

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.

> [!NOTE]
> 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](https://taphome.com/cs/compatibility/keba-kecontact-p30-charging-station/), 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.

> [!WARNING]
> 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í](https://taphome.com/images/compatibility/keba-kecontact-p20-power-monitoring/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg)

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:

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

> [!WARNING]
> 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:

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

> [!NOTE]
> 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í 8

Tato zařízení se po importu zobrazí v TapHome.

Keba KeContact P20 Měření výkonu Modul

Vlastní proměnné

Čtení (modul)

```taphome
SENDDATA("report 3");
```

Listener

```taphome
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

Listener

```taphome
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
```

Proud fáze 2 Proměnná Pouze ke čtení

numeric Jednotka: A json\_path

Listener

```taphome
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
```

Proud fáze 3 Proměnná Pouze ke čtení

numeric Jednotka: A json\_path

Listener

```taphome
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

Listener

```taphome
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

Listener

```taphome
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

Listener

```taphome
Va := PARSEJSON(report3, "$.U1", 1)
```

Napětí fáze 2 Proměnná Pouze ke čtení

numeric Jednotka: V json\_path

Listener

```taphome
Va := PARSEJSON(report3, "$.U2", 1)
```

Napětí fáze 3 Proměnná Pouze ke čtení

numeric Jednotka: V json\_path

Listener

```taphome
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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci      | Výchozí       |
|------------------------|---------------|
| 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ýrobců jsou © jejich příslušných vlastníků. Poskytujeme je tak, jak je výrobce zveřejnil, pouze pro informaci.

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)