TapHome

KEBA KeContact P20 Power Monitoring

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

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.

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

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

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

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

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

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.

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.

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

Keba KeContact P20 Praćenje snage Modul
Prilagođene varijable

Keba KeContact P20 Power monitoring

Čitanje (modul)
SENDDATA("report 3");
Listener
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

Struja faze 1

Listener
Va := PARSEJSON(report3, "$.I1", 1) / 1000.0
Struja faze 2 Varijabla Samo za čitanje
numeric Jedinica: A json_path

Struja faze 2

Listener
Va := PARSEJSON(report3, "$.I2", 1) / 1000.0
Struja faze 3 Varijabla Samo za čitanje
numeric Jedinica: A json_path

Struja faze 3

Listener
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

Trenutačna snaga

Listener
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

Ukupna snaga

Listener
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

Napon faze 1

Listener
Va := PARSEJSON(report3, "$.U1", 1)
Napon faze 2 Varijabla Samo za čitanje
numeric Jedinica: V json_path

Napon faze 2

Listener
Va := PARSEJSON(report3, "$.U2", 1)
Napon faze 3 Varijabla Samo za čitanje
numeric Jedinica: V json_path

Napon faze 3

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

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