---
title: "KEBA KeContact P20 State"
description: "Omogućavanje punjenja, priključenost i zaključanost kabela, stanje punjenja i korisničko ograničenje struje na punionici KEBA KeContact P20 preko UDP-a."
url: "https://taphome.com/hr/compatibility/keba-kecontact-p20-state/"
language: hr
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["udp","wallbox","ev-charging","ethernet","packet-parser","charging-control"]
  questions: ["Kako integrirati KEBA KeContact P20 sa sustavom TapHome?","Što radi predložak KEBA KeContact P20 State?","Kako iz sustava TapHome omogućiti ili onemogućiti punjenje na KEBA P20?","Kako postaviti ograničenje struje punjenja na punionici KEBA P20?","Što znače stanja punjenja (Pokretanje, Spremna, Punjenje, Greška) na KEBA P20?","Mogu li za istu punionicu uvesti oba predloška, KEBA P20 State i Power Monitoring?"]
---

# KEBA KeContact P20 State

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 punionici tekstnu naredbu `report 2` i iz vraćenih JSON podataka puni sklopku za omogućavanje s mogućnošću upisa, tri reed kontakta za priključenost i zaključanost kabela, stanje punjenja s više vrijednosti i korisničko ograničenje struje s mogućnošću upisa. Upravljačke naredbe (`ena`, `curr`) šalju se natrag istim UDP kanalom.

> [!NOTE]
> Ovaj predložak nudi **stanje i upravljanje**. Za električna mjerenja (naponi i struje po fazama, djelatna snaga te energija sesije i ukupna energija) za istu punionicu uvezite srodni predložak [KEBA KeContact P20 Power Monitoring](https://taphome.com/hr/compatibility/keba-kecontact-p20-power-monitoring/). Dva predloška koriste različita izvješća (`report 2` i `report 3`) i mogu sigurno raditi istodobno, za potpunu integraciju praćenja i upravljanja.

## 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 UDP naredbu `report 2`)
- 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

Ožičenje i Ethernet veza jednaki su kao kod srodnog predloška Power Monitoring, jer oba predloška istim UDP kanalom adresiraju isti fizički uređaj. Kabliranje Cat 5e/STP, izbor između LSA+ (X4) i RJ45 (X3) te upozorenje o strujama izjednačenja kroz oklop Ethernet kabela opisani su u odjeljku [KEBA KeContact P20 Power Monitoring → Spajanje hardvera](https://taphome.com/hr/compatibility/keba-kecontact-p20-power-monitoring/#spajanje-hardvera).

## 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. **DSW1.3 = ON** je obavezno; bez toga punionica ne odgovara ni na jednu naredbu `report` na portu 7090. Promjene DIP sklopki stupaju na snagu tek nakon pritiska servisne tipke (oko 1 s) ili isključivanja i ponovnog uključivanja napajanja.

![Raspored DIP sklopki KEBA KeContact P20 s postavkom DSW1.3 ON za uključivanje sučelja UDP SmartHome](https://taphome.com/images/compatibility/keba-kecontact-p20-state/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg)

Cijela tablica DIP sklopki (DSW1 i adresiranje DSW2) opisana je kod srodnog predloška, u odjeljku [KEBA KeContact P20 Power Monitoring → Konfiguracija](https://taphome.com/hr/compatibility/keba-kecontact-p20-power-monitoring/#konfiguracija). Postavljanje je jednako, jer je riječ o istoj fizičkoj punionici.

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

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

Sve vrijednosti dobivaju se iz JSON odgovora na naredbu `report 2`. Upisi koriste UDP tekstne naredbe `ena` i `curr`; nakon svakog upisa odmah slijedi očitavanje `report 2` koje osvježava stanje predloška.

### Upravljanje punjenjem

- **Punjenje omogućeno**: sklopka za uključivanje i isključivanje s mogućnošću upisa. Šalje `ena 1` za omogućavanje ili `ena 0` za onemogućavanje punionice. Prati oznaku `Enable user` iz `report 2`. Upis OFF trajno zaustavlja punjenje dok se ponovno ne omogući ili dok se punionica ponovno ne pokrene; KEBA propisuje obaveznu stanku od 2 sekunde nakon `ena 0` prije nego što se prihvati sljedeća naredba.
- **Korisnička struja punjenja**: najveća struja punjenja u amperima s mogućnošću upisa. Šalje naredbu `curr` u miliamperima (predložak vrijednost interno množi s 1000). Valjani raspon je **6–63 A**; punionica stvarnu vrijednost ograničava hardverskim ograničenjem (DIP sklopke, kodiranje kabela, toplinsko smanjenje snage), a nova postavka prenosi se na PWM signal control pilot nakon 6–7 sekundi.

> [!TIP]
> `curr` je **trajna** postavka: vrijedi do sljedećeg upisa `curr` ili do ponovnog pokretanja punionice. KEBA za redovitu upotrebu preporučuje netrajnu varijantu `currtime`, koja se poništava pri odspajanju kabela. Ovaj predložak nudi samo `curr`; za punjenje prema rasporedu ili automatsko poništavanje upravljajte Korisničkom strujom punjenja pomoću smart rule u sustavu TapHome: on ciljnu vrijednost upisuje neposredno prije početka sesije, a nakon odspajanja kabela vraća je na željenu vrijednost mirovanja.

### Priključenost i zaključanost kabela

Tri neovisna reed kontakta, svaki izveden iz zasebnog bita bitovne maske `Plug` u `report 2`:

| Uređaj | Bit Plug | Maska | Značenje |
|--------|----------|------|---------|
| **Priključeno na punionicu** | 0 | `0x01` | Kabel je utaknut u utičnicu punionice (za kabele koji nisu trajno spojeni) |
| **Kabel zaključan** | 1 | `0x02` | Kabel je mehanički zaključan u utičnici punionice |
| **Priključeno na vozilo** | 2 | `0x04` | Kabel je utaknut u električno vozilo |

Za punjenje moraju biti **postavljena sva tri bita** (`Plug = 7`). Pojedinačni uređaji omogućuju razlikovanje je li korisnik odspojio automobil, punionicu ili oboje.

### Stanje punjenja

- **Stanje punjenja**: uređaj s više vrijednosti koji prikazuje način rada punionice, preslikan iz neobrađenog polja `State` u `report 2`:

| Neobrađeni `State` | Značenje u protokolu (UDP Programmers Guide V 2.03) | Prikaz u predlošku |
|-------------|--------------------------------------------------|------------------|
| 0 | Pokretanje | Pokretanje |
| 1 | Nije spremna za punjenje (nije spojena, zaključana ili blokirana) | Nije spremna |
| 2 | Spremna za punjenje, čeka vozilo | Spremna |
| 3 | Punjenje | Punjenje |
| 4 | Postoji greška | Greška |
| 5 | Punjenje privremeno prekinuto | Nije autorizirano |

> [!WARNING]
> Predložak neobrađenu vrijednost `State = 5` prikazuje kao **Nije autorizirano**, ali KEBA UDP Programmers Guide V 2.03 (§3.2.3) tu vrijednost opisuje kao „Charging temporarily interrupted” (punjenje privremeno prekinuto, na primjer zbog pregrijavanja ili zato što je uvjet za punjenje, tzv. voter, zabranio punjenje). Ako Stanje punjenja pokazuje „Nije autorizirano” bez RFID sesije u tijeku, smatrajte to privremenim prekidom, a ne neuspjelom autorizacijom. Neobrađenu vrijednost možete provjeriti izravnim čitanjem polja `State` upitom `report 2` prema punionici na UDP portu 7090.

## 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)
2. Provjerite je li verzija firmvera **≥ 2.5**. Ažuriranja firmvera dostupna su u odjeljku za preuzimanje na keba.com/emobility
3. Provjerite je li **DSW1.3 = ON**; to je najčešći problem pri postavljanju. DIP sklopke su 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 UDP port **7090** otvoren između centralne jedinice TapHome Core i punionice (bez blokiranja VLAN-om ili vatrozidom)
5. Provjerite da sučelje Modbus TCP na punionici nije aktivno; UDP i Modbus TCP međusobno se isključuju

### Promjena sklopke Punjenje omogućeno nema učinka

Neke konfiguracije punionice nadjačavaju `Enable user` preko vanjskog ulaza za omogućavanje X1 ili preko aktivnog događaja failsafe. Ako `ena 1` ne izvede punionicu iz onemogućenog stanja:

- Provjerite je li DSW1.1 na ON (koristi se vanjski ulaz za omogućavanje). Ako jest, provjerite je li kontakt X1 zatvoren.
- Pratite `Enable sys` u neobrađenom odgovoru `report 2`: ako je `Enable sys = 0`, punionica odbija omogućavanje bez obzira na `Enable user` (obično zbog isteka vremena failsafe ili toplinskog ograničenja). Predložak ne nudi `Enable sys`; provjerite to preko LED diode stanja punionice ili izravnim UDP upitom.

### Promjena korisničke struje punjenja ne primjenjuje se

Nakon upisa nove struje punionici treba **6–7 sekundi** da promjenu interno primijeni. Ako se nova vrijednost nikad ne pojavi u povratnom očitanju:

- Provjerite je li ciljna vrijednost u valjanom rasponu **6000–63000 mA** (6–63 A). Vrijednosti izvan tog raspona punionica odbija bez dojave.
- Provjerite da nema aktivnog događaja failsafe: kad se aktivira, `Max curr = Curr FS` nadjačava `Curr user` dok se failsafe ne poništi.
- Imajte na umu da je `curr` **trajna** postavka. Ako je još aktivna prethodna naredba `currtime` (poslana iz drugog klijenta), `curr` se zanemaruje dok mjerač vremena `currtime` ne istekne ili ga `currtime 0 0` ne poništi.

### Stanje punjenja ostaje na Greška ili Nije autorizirano

**Greška** (neobrađeni `State = 4`) označava stanje greške koje javlja punionica. Polja `Error1` i `Error2` u `report 2` sadrže brojčani kod greške, ali ih predložak ne nudi; da biste ih očitali, pošaljite punionici izravni upit `report 2` preko UDP porta 7090 ili pogledajte LED diodu stanja punionice.

**Nije autorizirano** je oznaka koju predložak prikazuje za neobrađeni `State = 5`, a KEBA ga opisuje kao „Charging temporarily interrupted”. Česti uzroci su pregrijavanje, aktivna zabrana punjenja koju postavlja uvjet za punjenje (voter) ili namjerni prekid u upravljačkoj logici punionice KEBA. Isključivanje i ponovno uključivanje napajanja punionice ili čekanje da uvjet prekida nestane obično vraća stanje Punjenje. Ovaj predložak ne nudi postupak RFID autorizacije; popisom dopuštenih RFID kartica i dalje se upravlja preko aplikacije KEBA i fizičkih glavnih kartica.

## Dostupni uređaji 6

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Keba KeContact P20 Stanje Modul

Prilagođene varijable

Čitanje (modul)

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

Listener

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

IF(id = 2)
    report2 := jsonString;
END
```

Punjenje omogućeno Sklopka Čitanje i pisanje

Sklopka za uključivanje i isključivanje s mogućnošću upisa; omogućuje ili onemogućuje punjenje UDP naredbom \`ena\` (vrijedi do ponovnog pokretanja ili ponovnog omogućavanja)

boolean json\_path

Vrijednosti / stanja: ${general\_enabled} · ${general\_disabled}

Zapis stanja sklopke

```taphome
SENDDATA("ena " + St);
SENDDATA("report 2");
```

Listener

```taphome
St := PARSEJSON(report2, "$.['Enable user']", 1)
```

Kabel zaključan Magnetski kontakt Samo za čitanje

Pokazuje je li kabel mehanički zaključan u utičnici punionice (bit 1 maske Plug)

boolean bitmask

Listener

```taphome
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x02
```

Priključeno na vozilo Magnetski kontakt Samo za čitanje

Pokazuje je li kabel za punjenje spojen na električno vozilo (bit 2 maske Plug)

boolean bitmask

Listener

```taphome
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x04
```

Priključeno na punionicu Magnetski kontakt Samo za čitanje

Pokazuje je li kabel utaknut u utičnicu punionice (bit 0 maske Plug)

boolean bitmask

Listener

```taphome
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x01
```

Stanje punjenja Prekidač s više vrijednosti Samo za čitanje

Radno stanje punionice: pokretanje, nije spremna, spremna, punjenje, greška ili nije autorizirano

numeric json\_path

Vrijednosti / stanja: ${starting} · ${notReady} · ${ready} · ${charging} · ${error} · ${notAuthorized}

Listener

```taphome
VAR state := PARSEJSON(report2, "$.State");
Mu := SWITCH(State, 0, 1, 1, 2, 2, 3, 3, 5, 4, 8, 5, 9, 1)
```

Korisnička struja punjenja Varijabla Čitanje i pisanje

Najveća struja punjenja u amperima (6–63 A) s mogućnošću upisa; šalje se punionici UDP naredbom \`curr\` u miliamperima

numeric Jedinica: A json\_path

Zapis

```taphome
SENDDATA("curr " + Va*1000);
SENDDATA("report 2");
```

Listener

```taphome
Va := PARSEJSON(report2, "$.['Curr user']", 1) / 1000.0
```

**Povezivanje:** Packet Parser → UDP

Moguća poboljšanja (24)

- Error Codes — Decimal error codes indicating the cause of an error state. Not exposed by the template — only the generic Error state is surfaced through the \`State\` device.
- RFID Authorization Flags — AuthON (authorization function enabled) and Authreq (RFID authorization pending). Useful only when the wallbox whitelist is in use; template has no RFID flow.
- System Enable — Separate enable flag managed by the station (distinct from \`Enable user\`). Goes to 0 when failsafe triggers or on thermal/hardware limits.
- Actual Charging Current Limit — Effective current offered to the vehicle via PWM (mA) and the duty cycle (0.1% units). Different from \`Curr user\` — this is the resolved minimum of user setting, hardware limit, failsafe, and thermal derating.
- Hardware Current Limit — Maximum current the hardware supports based on DIP switch amperage setting, cable coding, and temperature monitoring. Static upper bound.
- Failsafe Current / Timeout — Fallback current and communication timeout configured via the \`failsafe\` command. Exposes current safety configuration; template has no diagnostic device.
- Pending Current Setting (currtime) — Queued current value and remaining countdown from an active \`currtime\` command. Useful for scheduled charging but not surfaced.
- Session Energy Limit — Active energy limit for the current/next charging session (0.1 Wh units). Set via \`setenergy\` command — template does not read or write it.
- Aux Relay Output State — Last \`output\` command setting for the X2 auxiliary relay. Template does not mirror relay state.
- External Enable Input (X1) — Current state of the external enable input X1 (ripple control / time switch contact). Requires DIP DSW1.1 = ON. Could be exposed as an independent reed contact.
- Serial Number — Device serial (8 chars) present in \`report 2\` JSON. Not mapped to a service attribute by the template.
- System Uptime — System clock seconds since startup. Useful for reboot detection but not surfaced.
- Set Charging Current with Delay — Non-permanent, delayed current setting — the KEBA-recommended primary current control command (preferred over \`curr\`). Allows scheduled current adjustments and safe \`currtime 0 1\` stop.
- Set Energy Limit — Sets a per-session energy limit (0.1 Wh units). Charging stops automatically when the limit is reached.
- Auxiliary Relay Output (X2) — Control the auxiliary relay at terminal X2 (open/close/pulse). Requires DIP DSW1.2 = ON.
- RFID Start / Stop — Programmatic RFID authorization when AuthON = 1 and a whitelist is configured.
- Set Station Clock — Set the station clock via Unix epoch. Useful when NTP is unavailable.
- Show Display Text — P30 only — not functional on P20 (no display). Listed for reference.
- Unlock Socket — Unlocks the charging socket (requires charging to be stopped first). Useful after an interrupted session.
- Failsafe Configuration — Fallback current when communication is lost. Important safety feature — template does not expose it.
- Device Identification — Basic identification: Product name, Serial, Firmware, COM-module flag, Backend flag, timeQ. Template polls only \`report 2\`.
- Power Monitoring — Voltage (U1/U2/U3), current (I1/I2/I3), active power (P), power factor (PF), present/total energy. Covered by the sibling \`keba-kecontact-p20-power-monitoring\` template.
- 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 state monitoring.
- 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/)

