TapHome

KEBA KeContact P20 State

Packet Parser → UDP
Autor
Posljednje ažuriranje: 04. 2026
KEBA KeContact P20 State

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.

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

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

Cijela tablica DIP sklopki (DSW1 i adresiranje DSW2) opisana je kod srodnog predloška, u odjeljku KEBA KeContact P20 Power Monitoring → Konfiguracija. Postavljanje je jednako, jer je riječ o istoj fizičkoj punionici.

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

Ako punionica koristi DHCP, u usmjerivaču joj dodijelite stalnu DHCP rezervaciju kako se IP adresa ne bi promijenila nakon nestanka struje. TapHome IP adresu sprema kao parametar uvoza i ne pronalazi uređaj automatski.

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.

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đajBit PlugMaskaZnačenje
Priključeno na punionicu00x01Kabel je utaknut u utičnicu punionice (za kabele koji nisu trajno spojeni)
Kabel zaključan10x02Kabel je mehanički zaključan u utičnici punionice
Priključeno na vozilo20x04Kabel 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 StateZnačenje u protokolu (UDP Programmers Guide V 2.03)Prikaz u predlošku
0PokretanjePokretanje
1Nije spremna za punjenje (nije spojena, zaključana ili blokirana)Nije spremna
2Spremna za punjenje, čeka voziloSpremna
3PunjenjePunjenje
4Postoji greškaGreška
5Punjenje privremeno prekinutoNije autorizirano

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

Keba KeContact P20 Stanje Modul
Prilagođene varijable

Keba KeContact P20 State

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

IF(id = 2)
    report2 := jsonString;
END
Punjenje omogućeno Sklopka

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}

Punjenje omogućeno

Zapis stanja sklopke
SENDDATA("ena " + St);
SENDDATA("report 2");
Listener
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

Kabel zaključan

Listener
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

Priključeno na vozilo

Listener
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

Priključeno na punionicu

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

Stanje punjenja

Listener
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

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

Korisnička struja punjenja

Zapis
SENDDATA("curr " + Va*1000);
SENDDATA("report 2");
Listener
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.

Izvori

  • 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

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu