TapHome

KEBA KeContact P20 Stav

Packet Parser → UDP
Pridal
Posledná aktualizácia: 05. 2026
KEBA KeContact P20 Stav

KEBA KeContact P20 je AC Mode 3 EV wallbox (10–32 A, jednofázový alebo trojfázový) vyrábaný medzi rokmi 2012 a 2016. Jeho UDP-based „SmartHome Interface" je podporovaný na hardvérových variantoch c-series a c-series+PLC (kódy produktu KC-P20-xxxxxx2x-xxx a KC-P20-xxxxxx3x-xxx) s firmvérom 2.5 alebo vyšším. Série e-series a b-series toto rozhranie neimplementujú.

TapHome komunikuje s wallboxom cez UDP na porte 7090 pomocou natívneho protokolu KEBA. V každom pollovacom cykle (štandardne 10 s) TapHome odošle textový príkaz report 2 na wallbox a parsuje vrátený JSON payload do zapisovateľného spínača povolenia, troch reed kontaktov pre zapojenie/zamknutie, multi-value stavu nabíjania a zapisovateľného limitu užívateľského prúdu. Riadiace príkazy (ena, curr) sa posielajú späť cez rovnaký UDP kanál.

Táto šablóna vystavuje stav a riadenie. Pre elektrické merania (napätia a prúdy po fázach, činný výkon a energiu relácie/celoživotnú) importujte sesterskú šablónu KEBA KeContact P20 Meranie výkonu proti tomu istému wallboxu — obe šablóny používajú rozdielne reporty (report 2 vs. report 3) a môžu bezpečne bežať paralelne pre kompletnú integráciu monitorovania + riadenia.

Požiadavky

  • KEBA KeContact P20 c-series alebo c-series+PLC (číslica elektroniky 2 alebo 3 v kóde produktu na typovom štítku)
  • Firmvér ≥ 2.5 (staršie firmvéry neimplementujú UDP príkaz report 2)
  • Wallbox pripojený do rovnakej LAN siete ako TapHome Core cez Ethernet (LSA+ svorky X4 alebo RJ45 konektor X3)
  • UDP port 7090 nesmie byť blokovaný firewallom medzi Core a wallboxom
  • Modbus TCP rozhranie musí byť vypnuté — UDP a Modbus TCP rozhrania sa na P20 navzájom vylučujú

Hardvérové pripojenie

Zapojenie a Ethernet pripojenie sú zhodné so sesterskou šablónou Meranie výkonu — rovnaké fyzické zariadenie sa adresuje oboma šablónami cez rovnaký UDP kanál. Pozri KEBA KeContact P20 Meranie výkonu → Hardvérové pripojenie pre Cat 5e/STP kabeláž, výber LSA+ (X4) vs. RJ45 (X3) a varovanie o vyrovnávacích prúdoch cez tienenie Ethernetu.

Konfigurácia

Aktivácia UDP SmartHome rozhrania

UDP rozhranie sa aktivuje jedným DIP prepínačom na PCB wallboxu, umiestneným pod krytom konektorového panelu. DSW1.3 = ON je povinné — bez neho wallbox neodpovie na žiadny report príkaz na porte 7090. Zmeny DIP prepínačov sa prejavia až po stlačení servisného tlačidla (~1 s) alebo vypnutí a zapnutí wallboxu.

KEBA KeContact P20 rozloženie DIP prepínačov ukazujúce nastavenie DSW1.3 ON pre aktiváciu UDP SmartHome rozhrania

Kompletná tabuľka DIP prepínačov (adresovanie DSW1 a DSW2) je zdokumentovaná pri sesterskej šablóne — pozri KEBA KeContact P20 Meranie výkonu → Konfigurácia. Nastavenie je zhodné, pretože sa jedná o rovnaký fyzický wallbox.

UDP rozhranie a Modbus TCP rozhranie nemôžu byť aktívne súčasne. Ak bol na tejto stanici predtým zapnutý Modbus TCP, pred používaním TapHome UDP šablóny ho vypnite.

Import parametre TapHome

Pri importe šablóny zadajte:

  • IP Address — IP adresa wallboxu v lokálnej sieti (placeholder 192.168.0.1)
  • Port — 7090 (pevne dané protokolom KEBA)
  • Internal poll interval — štandardne 10000 ms; protokol KEBA toleruje kratšie intervaly, ale odporúča minimálne 5 s medzi opakovaniami rovnakého príkazu

Ak wallbox používa DHCP, priraďte v routeri statickú DHCP rezerváciu, aby sa IP adresa po výpadku napájania nezmenila. TapHome ukladá IP ako import parameter a zariadenie automaticky neobjavuje.

Dostupné zariadenia

Všetky hodnoty sú odvodené z JSON payloadu report 2. Zápisy používajú UDP textové príkazy ena a curr; po každom zápise nasleduje okamžitý poll report 2 pre obnovenie stavu šablóny.

Riadenie nabíjania
  • Nabíjanie povolené — zapisovateľný on/off spínač. Odosiela ena 1 na povolenie alebo ena 0 na zakázanie stanice. Zrkadlí príznak Enable user z report 2. Zápis OFF trvalo pozastaví nabíjanie, kým sa znova nepovolí alebo sa stanica nereštartuje; KEBA špecifikuje povinnú 2-sekundovú pauzu po ena 0, než je akceptovaný ďalší príkaz.
  • Užívateľský nabíjací prúd — zapisovateľný maximálny nabíjací prúd v ampéroch. Odosiela príkaz curr v miliampéroch (šablóna interne násobí hodnotou 1000). Platný rozsah je 6–63 A; wallbox orezáva efektívnu hodnotu na hardvérový limit (DIP prepínače, kódovanie kábla, tepelné derating) a nové nastavenie sa prejaví v PWM Control Pilota po 6–7 sekundách.

curr je trvalé nastavenie — pretrváva až do ďalšieho zápisu curr alebo do reštartu stanice. KEBA odporúča netrvalý variant currtime pre bežné použitie, pretože sa resetuje pri odpojení. Táto šablóna vystavuje iba curr; pre plánované nabíjanie alebo automatický reset semanticky ovládajte Užívateľský nabíjací prúd z TapHome Smart Rule, ktorý zapíše cieľovú hodnotu tesne pred začiatkom relácie a resetuje ju na požadovanú pokojovú hodnotu po odpojení.

Stav zapojenia a zamknutia

Tri nezávislé reed kontakty, každý odvodený zo samostatného bitu bitmasky Plug v report 2:

ZariadenieBit PlugMaskaVýznam
Zapojené do wallboxu00x01Kábel je zapojený v zásuvke wallboxu (pre nie trvalo pripojené káble)
Kábel zamknutý10x02Kábel je mechanicky zamknutý v zásuvke wallboxu
Zapojené do vozidla20x04Kábel je zapojený v EV

Nabíjanie vyžaduje nastavené všetky tri bity (Plug = 7). Jednotlivé zariadenia umožňujú rozlíšiť, či používateľ odpojil auto, wallbox alebo oboje.

Stav nabíjania
  • Stav nabíjania — multi-value zariadenie vystavujúce prevádzkový režim wallboxu, mapované z poľa State v report 2:
Raw StateVýznam v protokole (UDP Programmers Guide V 2.03)Zobrazenie v šablóne
0ŠtartŠtartuje
1Nepripravené na nabíjanie (nepripojené, zamknuté alebo blokované)Nepripravené
2Pripravené na nabíjanie, čaká na vozidloPripravené
3NabíjanieNabíja
4Prítomná chybaChyba
5Nabíjanie dočasne prerušenéNeautorizované

Šablóna zobrazuje raw State = 5 ako Neautorizované, no KEBA UDP Programmers Guide V 2.03 (§3.2.3) dokumentuje túto hodnotu ako „Nabíjanie dočasne prerušené" (napríklad kvôli prehriatiu alebo odopretiu voterom). Ak sa stav nabíjania zobrazuje ako „Neautorizované" bez prebiehajúcej RFID relácie, považujte to za dočasné prerušenie, nie zlyhanie autorizácie. Raw hodnotu možno overiť priamym čítaním State z dotazu report 2 proti wallboxu na UDP porte 7090.

Riešenie problémov

TapHome nezobrazuje žiadne dáta z wallboxu
  1. Overte kód produktu wallboxu na typovom štítku. UDP podporujú len KC-P20-xxxxxx2x-xxx (c-series) a KC-P20-xxxxxx3x-xxx (c-series+PLC)
  2. Potvrďte, že verzia firmvéru je ≥ 2.5. Aktualizácie firmvéru sú dostupné v download zóne na keba.com/emobility
  3. Potvrďte DSW1.3 = ON — najčastejší problém pri nastavení. DIP prepínače sú pod krytom konektorového panelu a pri uvádzaní do prevádzky sa ľahko prehliadnu. Po prepnutí stlačte servisné tlačidlo na 1 sekundu alebo vypnite a zapnite istič
  4. Uistite sa, že UDP port 7090 je otvorený medzi TapHome Core a wallboxom (žiadne VLAN / firewall blokovanie)
  5. Potvrďte, že Modbus TCP rozhranie na wallboxe nie je aktívne — UDP a Modbus TCP sa navzájom vylučujú
Zápis spínača Nabíjanie povolené nemá účinok

Niektoré konfigurácie stanice prepisujú Enable user cez externý povoľovací vstup X1 alebo cez aktívnu failsafe udalosť. Ak ena 1 nevyvedie stanicu zo stavu vypnutia:

  • Skontrolujte, či je DSW1.1 v polohe ON (používa sa externý povoľovací vstup). Ak áno, overte, že kontakt X1 je zopnutý.
  • Sledujte Enable sys v raw payloade report 2 — ak Enable sys = 0, stanica odmieta povolenie bez ohľadu na Enable user (typicky kvôli failsafe timeoutu alebo tepelnému limitu). Šablóna Enable sys nevystavuje; overte cez stavovú LED wallboxu alebo priamym UDP dotazom.
Zmena Užívateľského nabíjacieho prúdu sa neprejaví

Po zápise nového prúdu stanica potrebuje 6–7 sekúnd na interné uplatnenie zmeny. Ak sa nová hodnota v readbacku nikdy neobjaví:

  • Overte, že cieľ je v platnom rozsahu 6000–63000 mA (6–63 A). Hodnoty mimo tohto rozsahu wallbox potichu odmietne.
  • Potvrďte, že nie je aktívna failsafe udalosť — pri spustení Max curr = Curr FS prepisuje Curr user, kým sa failsafe neresetuje.
  • Pamätajte, že curr je trvalé nastavenie. Ak stále beží predchádzajúci príkaz currtime (vydaný iným klientom), curr je ignorovaný, kým časovač currtime nevyprší alebo ho currtime 0 0 nevynuluje.
Stav nabíjania zostáva zaseknutý na Chybe alebo Neautorizovanom

Chyba (raw State = 4) indikuje chybový stav hlásený stanicou. Polia Error1 a Error2 v report 2 nesú číselný kód chyby, ale šablóna ich nevystavuje — dotazujte wallbox priamo cez UDP port 7090 príkazom report 2 na ich prečítanie alebo si pozrite stavovú LED stanice.

Neautorizované je popis šablóny pre raw State = 5, ktorý KEBA dokumentuje ako „Nabíjanie dočasne prerušené". Bežné príčiny zahŕňajú prehriatie, aktívne odopretie voterom alebo zámerné prerušenie v riadiacom toku KEBA. Vypnutie a zapnutie wallboxu alebo vyčkanie, kým sa podmienka prerušenia neskončí, zvyčajne obnoví stav Nabíja. Táto šablóna nevystavuje RFID autorizačný tok — RFID whitelist zostáva spravovaný cez aplikáciu KEBA a fyzické master karty.

Dostupné zariadenia

Keba KeContact P20 Stav Modul
Vlastné premenné

Keba KeContact P20 State

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

IF(id = 2)
    report2 := jsonString;
END
Nabíjanie povolené Prepínač

Zapisovateľný on/off spínač — povoľuje alebo zakazuje nabíjanie cez UDP príkaz `ena` (platí trvalo až do reštartu alebo opätovného povolenia)

boolean json_path
Hodnoty / Stavy: ${general_enabled} · ${general_disabled}

Nabíjanie povolené

Zápis stavu prepínača
SENDDATA("ena " + St);
SENDDATA("report 2");
Listener
St := PARSEJSON(report2, "$.['Enable user']", 1)
Kábel zamknutý Jazýčkový kontakt Len na čítanie

Indikuje, či je kábel mechanicky zamknutý v zásuvke wallboxu (bit 1 poľa Plug)

boolean bitmask

Kábel zamknutý

Listener
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x02
Zapojené do vozidla Jazýčkový kontakt Len na čítanie

Indikuje, či je nabíjací kábel pripojený k elektrickému vozidlu (bit 2 poľa Plug)

boolean bitmask

Zapojené do vozidla

Listener
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x04
Zapojené do wallboxu Jazýčkový kontakt Len na čítanie

Indikuje, či je kábel zapojený do zásuvky wallboxu (bit 0 poľa Plug)

boolean bitmask

Zapojené do wallboxu

Listener
Rc := PARSEJSON(report2, "$.Plug", 1) & 0x01
Stav nabíjania Viacstavový prepínač Len na čítanie

Prevádzkový stav wallboxu — Štartuje, Nepripravené, Pripravené, Nabíja, Chyba alebo Neautorizované

numeric json_path
Hodnoty / Stavy: ${starting} · ${notReady} · ${ready} · ${charging} · ${error} · ${notAuthorized}

Stav nabíjania

Listener
VAR state := PARSEJSON(report2, "$.State");
Mu := SWITCH(State, 0, 1, 1, 2, 2, 3, 3, 5, 4, 8, 5, 9, 1)
Užívateľský nabíjací prúd Premenná

Zapisovateľný maximálny nabíjací prúd v ampéroch (6–63 A) — odosielaný do wallboxu cez UDP príkaz `curr` v miliampéroch

numeric Jednotka: A json_path

Užívateľský nabíjací prúd

Zápis
SENDDATA("curr " + Va*1000);
SENDDATA("report 2");
Listener
Va := PARSEJSON(report2, "$.['Curr user']", 1) / 1000.0
Pripojenie: Packet Parser → UDP
Možné vylepšenia (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.

Zdroje

  • 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

Našli ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli