---
title: "KEBA KeContact P20 Stav"
description: "Riaďte povolenie nabíjania, monitorujte stav zapojenia/zamknutia a stav nabíjania, nastavte limit prúdu na KEBA KeContact P20 wallboxe cez UDP."
url: "https://taphome.com/sk/compatibility/keba-kecontact-p20-state/"
language: sk
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["udp","wallbox","ev-charging","ethernet","packet-parser","charging-control"]
  questions: ["Ako integrovať KEBA KeContact P20 s TapHome?","Čo robí šablóna KEBA KeContact P20 State?","Ako povoliť alebo zakázať nabíjanie na KEBA P20 z TapHome?","Ako nastaviť limit nabíjacieho prúdu na KEBA P20 wallboxe?","Čo znamenajú stavy nabíjania (Štartuje, Pripravené, Nabíja, Chyba) na KEBA P20?","Môžem importovať obe šablóny KEBA P20 State aj Power Monitoring proti tomu istému wallboxu?"]
---

# KEBA KeContact P20 Stav

Komunikácia: Packet Parser → UDP

- [KEBA e-mobility (oficiálna stránka)](https://www.keba.com/en/emobility/products/product-overview)

> Adresa v sieti
> 
> TapHome komunikuje so zariadením na adrese zadanej pri importe. Dajte zariadeniu stálu adresu — rezerváciu IP v routeri, alebo jeho mDNS meno, ak ho podporuje —, inak integrácia prestane fungovať, keď router adresu zmení.
> 
> [Príprava siete](https://taphome.com/sk/docs/setup/network-preparation/)

## Návod na integráciu

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.

> [!NOTE]
> 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](https://taphome.com/sk/compatibility/keba-kecontact-p20-power-monitoring/) 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](https://taphome.com/sk/compatibility/keba-kecontact-p20-power-monitoring/#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](https://taphome.com/images/compatibility/keba-kecontact-p20-state/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg)

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](https://taphome.com/sk/compatibility/keba-kecontact-p20-power-monitoring/#konfigurácia). Nastavenie je zhodné, pretože sa jedná o rovnaký fyzický wallbox.

> [!WARNING]
> 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

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

> [!TIP]
> `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`:

| Zariadenie | Bit Plug | Maska | Význam |
|------------|----------|-------|--------|
| **Zapojené do wallboxu** | 0 | `0x01` | Kábel je zapojený v zásuvke wallboxu (pre nie trvalo pripojené káble) |
| **Kábel zamknutý** | 1 | `0x02` | Kábel je mechanicky zamknutý v zásuvke wallboxu |
| **Zapojené do vozidla** | 2 | `0x04` | Ká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 `State` | Význam v protokole (UDP Programmers Guide V 2.03) | Zobrazenie v šablóne |
|-------------|---------------------------------------------------|----------------------|
| 0 | Štart | Štartuje |
| 1 | Nepripravené na nabíjanie (nepripojené, zamknuté alebo blokované) | Nepripravené |
| 2 | Pripravené na nabíjanie, čaká na vozidlo | Pripravené |
| 3 | Nabíjanie | Nabíja |
| 4 | Prítomná chyba | Chyba |
| 5 | Nabíjanie dočasne prerušené | Neautorizované |

> [!WARNING]
> Š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 6

Tieto zariadenia sa po importe zobrazia v TapHome.

Keba KeContact P20 Stav Modul

Vlastné premenné

Čítanie (modul)

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

Listener

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

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

Nabíjanie povolené Prepínač Čítanie aj zápis

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}

Zápis stavu prepínača

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

Listener

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

Listener

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

Listener

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

Listener

```taphome
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}

Listener

```taphome
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á Čítanie aj zápis

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

Zápis

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

Listener

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

## Parametre importu

Tieto hodnoty zadáte pri importe XML.

| Pýta sa v aplikácii    | Predvolené    |
|------------------------|---------------|
| IP adresa              | `192.168.0.1` |
| Port                   | `7090`        |
| Internal poll interval | `10000`       |

## Zdroje

- 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

Dokumenty výrobcov sú © ich príslušných vlastníkov. Poskytujeme ich tak, ako ich zverejnil výrobca, len na informačné účely.

## Súvisiaca dokumentácia

- [Integrácia Packet Parser](https://taphome.com/sk/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/sk/docs/integration/packet-parser/)
- [Funkcie Packet parsera](https://taphome.com/sk/docs/script/packet-parser/)
- [Parsovacie funkcie](https://taphome.com/sk/docs/script/parsing-functions/)