---
title: "KEBA KeContact P20 Power Monitoring"
description: "Praćenje snage punjenja, struja i napona po fazama te energije sesije na punionici KEBA KeContact P20 preko UDP-a. Predložak TapHome samo za čitanje."
url: "https://taphome.com/hr/compatibility/keba-kecontact-p20-power-monitoring/"
language: hr
lastmod: 2026-04-23
generator: hugo
ai:
  topics: ["udp","wallbox","ev-charging","ethernet","power-monitoring","packet-parser"]
  questions: ["Kako integrirati KEBA KeContact P20 sa sustavom TapHome?","Što mjeri predložak KEBA KeContact P20 Power Monitoring?","Kako uključiti UDP komunikaciju na punionici KEBA P20?","Može li TapHome upravljati strujom punjenja na KEBA KeContact P20?","Koje varijante i verzije firmvera KEBA P20 podržavaju UDP?","Zašto TapHome ne prima podatke s KEBA P20 na portu 7090?"]
---

# KEBA KeContact P20 Power Monitoring

Komunikacija: Packet Parser → UDP

- [KEBA e-mobility (službena stranica)](https://www.keba.com/en/emobility/products/product-overview)

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

KEBA KeContact P20 je zidna AC punionica Mode 3 za električna vozila (10–32 A, jednofazna ili trofazna) proizvođena od 2012. do 2016. Njezino sučelje „SmartHome Interface” temeljeno na UDP-u podržano je na hardverskim varijantama **c-series** i **c-series+PLC** (kodovi proizvoda `KC-P20-xxxxxx2x-xxx` i `KC-P20-xxxxxx3x-xxx`) s firmverom **2.5 ili novijim**. Serije e-series i b-series to sučelje nemaju.

TapHome s punionicom komunicira preko **UDP-a na portu 7090** izvornim protokolom KEBA. U svakom ciklusu očitavanja (zadano 10 s) TapHome šalje tekstnu naredbu `report 3` na IP adresu punionice, a punionica odgovara JSON podacima s naponima i strujama po fazama, trenutačnom djelatnom snagom, energijom sesije i ukupnom energijom.

> [!NOTE]
> Ovaj predložak služi **samo za praćenje snage (samo čitanje)**. Ne pokreće i ne zaustavlja punjenje, ne mijenja struju punjenja i ne autorizira RFID sesije. Ako vam treba aktivno upravljanje opterećenjem (na primjer punjenje viškom solarne energije), koristite drugu integraciju: nasljednika KeContact P30 pokriva zasebni predložak [KEBA KeContact P30 Charging Station](https://taphome.com/hr/compatibility/keba-kecontact-p30-charging-station/), koji koristi Modbus TCP i nudi potpuno upravljanje punjenjem.

## Zahtjevi

- KEBA KeContact P20 **c-series** ili **c-series+PLC** (znamenka `2` ili `3` koja označava izvedbu elektronike u kodu proizvoda na natpisnoj pločici)
- Firmver **≥ 2.5** (stariji firmver nema naredbu `report 3`)
- Punionica spojena Ethernetom u istu lokalnu mrežu kao centralna jedinica TapHome Core (stezaljke LSA+ X4 ili utičnica RJ45 X3)
- UDP port **7090** ne smije biti blokiran vatrozidom između centralne jedinice Core i punionice
- Sučelje Modbus TCP mora biti **isključeno**: sučelja UDP i Modbus TCP na P20 međusobno se isključuju

## Spajanje hardvera

P20 ima dva fizička Ethernet sučelja. Na tiskanoj pločici spojena su paralelno i istodobno se može koristiti samo jedno, a nekorišteno mora biti odspojeno.

- **Ethernet1 (X4)**: stezaljke LSA+ za utiskivanje, preporučene za trajne fiksne instalacije (koristite originalni alat KRONE za utiskivanje; žice spojite prema rasporedu boja TIA-568A/B za 100BaseT, oklop presavijte unatrag oko 1 cm i pričvrstite na točku uzemljenja [Shd])
- **Ethernet2 (X3)**: utičnica RJ45, namijenjena servisu i otklanjanju grešaka, ali upotrebljiva ako je kabel RJ45 već doveden u kućište

Koristite kabel Cat 5e ili Cat 6 STP. Blok stezaljki (X4) prihvaća promjere žica 0,36–0,81 mm (AWG 27–20) za krute kabele i 7 × 0,2 mm (AWG 24) za savitljive kabele.

> [!WARNING]
> Struje izjednačenja koje u većim instalacijama teku kroz oklop Ethernet kabela mogu oštetiti sučelje. Ako su punionica i centralna jedinica Core na različitim podsustavima, proširenje mreže TN-S dogovorite s odgovornim za tehničke instalacije zgrade.

## Konfiguracija

### Uključivanje sučelja UDP SmartHome

Sučelje UDP uključuje se jednom DIP sklopkom na tiskanoj pločici punionice, ispod poklopca ploče s priključcima.

![Raspored DIP sklopki KEBA KeContact P20: položaj DSW1 / DSW2 na tiskanoj pločici i postavka DSW1.3 ON za uključivanje sučelja UDP SmartHome](https://taphome.com/images/compatibility/keba-kecontact-p20-power-monitoring/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg)

1. Isključite punionicu na zaštitnom prekidaču
2. Skinite poklopac kućišta i poklopac ploče s priključcima kako biste došli do blokova DIP sklopki (DSW1 gore, DSW2 ispod)
3. Postavite **DSW1.3 = ON** za uključivanje sučelja SmartHome UDP
4. Pritisnite servisnu tipku oko 1 sekundu ili isključite i ponovno uključite napajanje punionice; promjene DIP sklopki stupaju na snagu tek nakon ponovnog pokretanja

Cijeli blok postavki DSW1 opisan je u uputama za ugradnju. Ovdje su navedeni samo retci važni za integraciju preko UDP-a:

| DIP | Funkcija | Zadano | Potrebno za UDP |
|-----|----------|---------|-------------------|
| DSW1.1 | Koristi se vanjski ulaz za omogućavanje [X1] | OFF | — (ostavite kako jest, osim ako je spojen kontakt za omogućavanje) |
| DSW1.2 | Izlaz sklopnog kontakta [X2] u načinu nadzora sklopnika | OFF (prikaz stanja) | — (nije važno za ovaj predložak) |
| **DSW1.3** | **Uključivanje sučelja SmartHome preko UDP-a** | **OFF** | **ON**: **obavezno** |
| DSW1.6 / 1.7 / 1.8 | Najveća struja punjenja koja se prenosi preko PWM signala Control Pilot | ovisi o varijanti | — (postavite prema nazivnoj vrijednosti punionice) |

> [!WARNING]
> Sučelje UDP i sučelje Modbus TCP ne mogu biti aktivna istodobno. Ako je na ovoj punionici prije bio uključen Modbus TCP, isključite ga prije korištenja predloška TapHome za UDP.

### IP adresa (adresiranje DSW2)

Za jednu punionicu P20 u mreži dovoljno je zadano adresiranje preko DHCP-a, sa svim sklopkama DSW2 na OFF. Punionica dobiva IP adresu od usmjerivača.

Za instalacije s više punionica u izoliranoj mreži fiksne IP adrese u rasponu `192.168.25.11`–`192.168.25.26` mogu se postaviti sklopkama DSW2.1–DSW2.4 (uz DSW2.5 = OFF, DSW2.6 = ON). Svaka sklopka osnovici 10 dodaje svoju binarnu težinu (1, 2, 4, 8):

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

### Parametri uvoza u TapHome

Pri uvozu predloška unesite:

- **IP adresa**: IP adresa punionice u lokalnoj mreži (vrijednost unaprijed upisana u polju: `192.168.0.1`)
- **Port**: `7090` (određen protokolom KEBA)
- **Interni interval očitavanja**: zadano `10000` ms; protokol KEBA podnosi i kraće intervale, ali preporučuje najmanje 5 s između ponavljanja iste naredbe

## Mogućnosti uređaja

Sva mjerenja dobivaju se iz JSON odgovora na naredbu `report 3` koji vraća punionica. Svaka vrijednost ažurira se u svakom ciklusu očitavanja; svi uređaji su samo za čitanje.

### Naponi po fazama

- **Napon faze 1**, **Napon faze 2**, **Napon faze 3**: linijski naponi u voltima, očitani izravno iz polja `U1`, `U2`, `U3` odgovora `report 3`. Kod jednofaznih instalacija smislenu vrijednost javlja samo U1.

### Struje po fazama

- **Struja faze 1**, **Struja faze 2**, **Struja faze 3**: struje punjenja u amperima, očitane iz `I1`, `I2`, `I3` u miliamperima, koje predložak preračunava u A (dijeli s 1000). Kad se vozilo ne puni, vrijednosti su nula.

### Energija sesije i ukupna energija

Predložak nudi dva brojila energije koja dijele isto očitanje trenutačne djelatne snage (`$.P` iz `report 3`, javlja se u mW i preračunava u kW):

- **Trenutačna snaga**: trenutačna snaga punjenja (kW) i energija isporučena u **trenutačnoj sesiji punjenja**. Brojač energije sesije (`E pres`, jedinice od 0,1 Wh preračunate u kWh) vraća se na nulu pri svakom priključivanju kabela.
- **Ukupna snaga**: trenutačna snaga punjenja (kW) i brojač **ukupne kumulativne energije od početka rada uređaja** (`E total`, jedinice od 0,1 Wh preračunate u kWh). Taj brojač ostaje sačuvan između sesija, ponovnih pokretanja i isključivanja napajanja i nikad se ne poništava.

> [!NOTE]
> Oba brojila energije prikazuju isto trenutačno očitanje snage, jer punionica KEBA javlja jednu vrijednost trenutačne djelatne snage. Uređaji se razlikuju samo po tome koji brojač energije prate (po sesiji ili od početka rada uređaja). Tako u sustavu TapHome možete prikazati grafikon ukupne energije tekuće sesije i dugoročni trend energije.

## Rješavanje problema

### TapHome ne prikazuje podatke s punionice

1. Provjerite kod proizvoda na natpisnoj pločici punionice. UDP podržavaju samo `KC-P20-xxxxxx2x-xxx` (c-series) i `KC-P20-xxxxxx3x-xxx` (c-series+PLC); e-series i b-series ne mogu se integrirati preko UDP-a bez obzira na firmver
2. Provjerite je li verzija firmvera **≥ 2.5**. Stariji firmver ne odgovara na `report 3`. Ažuriranja firmvera dostupna su u odjeljku za preuzimanje na keba.com/emobility
3. Provjerite je li **DSW1.3 = ON**; to je daleko najčešći problem pri postavljanju, jer su DIP sklopke ispod poklopca ploče s priključcima i lako ih je previdjeti pri puštanju u rad. Nakon promjene pritisnite servisnu tipku 1 sekundu ili isključite i uključite zaštitni prekidač
4. Provjerite je li Ethernet kabel spojen na **samo jedno** od sučelja X3 (RJ45) ili X4 (LSA+), a ne na oba
5. Provjerite je li UDP port **7090** otvoren između centralne jedinice TapHome Core i punionice (bez blokiranja VLAN-om ili vatrozidom)
6. Provjerite da sučelje Modbus TCP na punionici nije aktivno; UDP i Modbus TCP međusobno se isključuju

### IP adresa punionice povremeno se mijenja

Zadani način adresiranja je DHCP. Ako usmjerivač oslobodi i ponovno dodijeli zakupe, punionica se može pokrenuti s drugom IP adresom. U usmjerivaču postavite stalnu DHCP rezervaciju za MAC adresu punionice ili prijeđite na način s fiksnom IP adresom preko DSW2 (za jednu punionicu to je rijetko potrebno).

### Snaga pokazuje nulu iako se električno vozilo puni

Polja `P`, `I1/I2/I3` i `E pres` popunjena su samo dok je aktivna valjana sesija punjenja (Plug = 7, State = 3 u `report 2`). Ako je kabel priključen, ali punjenje nije započelo, ili je vozilo punjenje pauziralo, `P` je nula. To je očekivano ponašanje; provjerite LED diodu stanja punionice (stalno zeleno svjetlo tijekom aktivnog punjenja).

### Energija sesije ne odgovara događaju punjenja

Brojač `E pres` vraća se na nulu na **početku** nove sesije (priključivanje kabela). Ako se električno vozilo unutar vašeg razdoblja bilježenja odspoji i ponovno spoji, počinje nova sesija i brojač kreće od nule. Za kumulativnu statistiku kroz više sesija koristite brojač od početka rada uređaja (**Ukupna snaga**).

## Dostupni uređaji 8

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Keba KeContact P20 Praćenje snage Modul

Prilagođene varijable

Čitanje (modul)

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

Listener

```taphome
VAR jsonString := TOSTRING(RECEIVEDBYTES);
VAR id := PARSEJSON(jsonString, "$.ID", 1);

IF(id = 3)
    report3 := jsonString;
END
```

Struja faze 1 Varijabla Samo za čitanje

numeric Jedinica: A json\_path

Listener

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

Struja faze 2 Varijabla Samo za čitanje

numeric Jedinica: A json\_path

Listener

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

Struja faze 3 Varijabla Samo za čitanje

numeric Jedinica: A json\_path

Listener

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

Trenutačna snaga Brojilo električne energije Samo za čitanje

Trenutačna snaga punjenja (kW) i energija isporučena u trenutačnoj sesiji punjenja (kWh); poništava se pri priključivanju kabela

numeric Jedinica: kW / kWh json\_path

Listener

```taphome
Ed := PARSEJSON(report3, "$.['E pres']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
```

Ukupna snaga Brojilo električne energije Samo za čitanje

Trenutačna snaga punjenja (kW) i ukupni brojač energije od početka rada uređaja (kWh); ostaje sačuvan između sesija i ponovnih pokretanja

numeric Jedinica: kW / kWh json\_path

Listener

```taphome
Ed := PARSEJSON(report3, "$.['E total']", 1) / 10000.0;
To := PARSEJSON(report3, "$.P", 1) / 1000000.0
```

Napon faze 1 Varijabla Samo za čitanje

numeric Jedinica: V json\_path

Listener

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

Napon faze 2 Varijabla Samo za čitanje

numeric Jedinica: V json\_path

Listener

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

Napon faze 3 Varijabla Samo za čitanje

numeric Jedinica: V json\_path

Listener

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

**Povezivanje:** Packet Parser → UDP

Moguća poboljšanja (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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji   | Zadano        |
|------------------------|---------------|
| IP adresa              | `192.168.0.1` |
| Port                   | `7090`        |
| Internal poll interval | `10000`       |

## Izvori

- 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

Dokumenti proizvođača zaštićeni su autorskim pravom (©) svojih vlasnika. Dostupni su onako kako ih je proizvođač objavio, samo za informaciju.

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

