---
title: "KEBA KeContact P20 Állapot"
description: "Vezérelje a töltést, felügyelje a csatlakozás/reteszelés és töltési állapotot, állítsa be az áramkorlátot a KEBA KeContact P20-on UDP-n keresztül."
url: "https://taphome.com/hu/compatibility/keba-kecontact-p20-state/"
language: hu
lastmod: 2026-04-24
generator: hugo
ai:
  topics: ["udp","wallbox","ev-charging","ethernet","packet-parser","charging-control"]
  questions: ["Hogyan integrálható a KEBA KeContact P20 a TapHome-mal?","Mit csinál a KEBA KeContact P20 State sablon?","Hogyan lehet engedélyezni vagy tiltani a töltést a KEBA P20-on a TapHome-ból?","Hogyan állítható be a töltőáram-korlát a KEBA P20 wallboxon?","Mit jelentenek a töltési állapotok (Indítás, Kész, Tölt, Hiba) a KEBA P20-on?","Importálhatom a KEBA P20 State és Power Monitoring sablonokat is ugyanarra a wallboxra?"]
---

# KEBA KeContact P20 Állapot

Kommunikáció: Packet Parser → UDP

- [KEBA e-mobility (hivatalos oldal)](https://www.keba.com/en/emobility/products/product-overview)

> Hálózati cím
> 
> A TapHome az importáláskor megadott címen éri el az eszközt. Adjon az eszköznek állandó címet — IP-foglalást a routerben, vagy az mDNS-nevét, ha támogatja —, különben az integráció leáll, amikor a router megváltoztatja a címet.
> 
> [A hálózat előkészítése](https://taphome.com/hu/docs/setup/network-preparation/)

## Integrációs útmutató

A KEBA KeContact P20 egy AC Mode 3 EV wallbox (10–32 A, egyfázisú vagy háromfázisú), amelyet 2012 és 2016 között gyártottak. UDP-alapú „SmartHome Interface" felülete a **c-series** és **c-series+PLC** hardvervariánsokon (termékkódok `KC-P20-xxxxxx2x-xxx` és `KC-P20-xxxxxx3x-xxx`) támogatott, **2.5 vagy magasabb** firmware-rel. Az e-series és b-series sorozatok nem implementálják ezt a felületet.

A TapHome a wallboxszal **UDP-n keresztül a 7090-es porton** kommunikál a natív KEBA protokollal. Minden lekérdezési ciklusban (alapértelmezés 10 s) a TapHome elküldi a `report 2` szöveges parancsot a wallboxnak, és az érkező JSON adatokat írható engedélyező kapcsolóvá, három csatlakozás/reteszelés reed kontaktussá, egy többértékű töltési állapottá és egy írható felhasználói áramkorláttá elemzi. A vezérlő parancsok (`ena`, `curr`) ugyanazon az UDP csatornán térnek vissza.

> [!NOTE]
> Ez a sablon **állapotot és vezérlést** tesz elérhetővé. Az elektromos mérésekhez (fázisonkénti feszültségek és áramok, hatásos teljesítmény, munkamenet/élettartam energia) importálja a testvér [KEBA KeContact P20 Teljesítménymérés](https://taphome.com/hu/compatibility/keba-kecontact-p20-power-monitoring/) sablont ugyanarra a wallboxra — a két sablon különböző reportokat használ (`report 2` vs. `report 3`), és biztonságosan futhatnak párhuzamosan a teljes felügyelet + vezérlés integrációjához.

## Követelmények

- KEBA KeContact P20 **c-series** vagy **c-series+PLC** (elektronikai számjegy `2` vagy `3` a termékkódban a típustáblán)
- Firmware **≥ 2.5** (régebbi firmware nem implementálja az UDP `report 2` parancsot)
- A wallbox ugyanabba a LAN hálózatba csatlakoztatva, mint a TapHome Core, Etherneten keresztül (LSA+ sorkapcsok X4 vagy RJ45 csatlakozó X3)
- Az UDP **7090-es portot** tűzfal nem blokkolhatja a Core és a wallbox között
- A Modbus TCP felületnek **le kell lennie tiltva** — az UDP és Modbus TCP felületek kölcsönösen kizárják egymást a P20-on

## Hardveres csatlakoztatás

A kábelezés és az Ethernet csatlakozás azonos a testvér Teljesítménymérés sablonéval — ugyanazt a fizikai eszközt címzi mindkét sablon ugyanazon az UDP csatornán. Lásd [KEBA KeContact P20 Teljesítménymérés → Hardveres csatlakoztatás](https://taphome.com/hu/compatibility/keba-kecontact-p20-power-monitoring/#hardveres-csatlakoztatás) a Cat 5e/STP kábelezéshez, az LSA+ (X4) vs. RJ45 (X3) választáshoz és az Ethernet árnyékoláson átfolyó kiegyenlítő áramokkal kapcsolatos figyelmeztetéshez.

## Konfiguráció

### Az UDP SmartHome felület aktiválása

Az UDP felületet egyetlen DIP-kapcsoló aktiválja a wallbox PCB-jén, a csatlakozó-panel fedél alatt. A **DSW1.3 = ON** kötelező — enélkül a wallbox nem válaszol semmilyen `report` parancsra a 7090-es porton. A DIP-kapcsoló változások csak a szerviz gomb megnyomása (~1 s) vagy tápfeszültség ki-be kapcsolása után lépnek érvénybe.

![KEBA KeContact P20 DIP-kapcsoló elrendezés a DSW1.3 ON beállítással az UDP SmartHome felület aktiválásához](https://taphome.com/images/compatibility/keba-kecontact-p20-state/dip-switch-udp-activation_hu_56d2d7e4a149f687.jpg)

A teljes DIP-kapcsoló táblázat (DSW1 és DSW2 címzés) a testvér sablonnál található — lásd [KEBA KeContact P20 Teljesítménymérés → Konfiguráció](https://taphome.com/hu/compatibility/keba-kecontact-p20-power-monitoring/#konfiguráció). A beállítás azonos, mert ugyanarról a fizikai wallboxról van szó.

> [!WARNING]
> Az UDP felület és a Modbus TCP felület nem lehet egyszerre aktív. Ha korábban a Modbus TCP volt engedélyezve ezen az állomáson, tiltsa le, mielőtt a TapHome UDP sablonra támaszkodna.

### TapHome importálási paraméterek

A sablon importálásakor adja meg:

- **IP Address** — a wallbox IP-címe a helyi hálózaton (helyőrző `192.168.0.1`)
- **Port** — `7090` (a KEBA protokoll rögzíti)
- **Internal poll interval** — alapértelmezés szerint `10000` ms; a KEBA protokoll rövidebb intervallumokat is tolerál, de legalább 5 s-ot javasol ugyanazon parancs ismétlései között

## Elérhető eszközök

Minden érték a `report 2` JSON adataiból származik. Az írások az `ena` és `curr` UDP szöveges parancsokat használják; minden írást azonnali `report 2` lekérdezés követ a sablon állapotának frissítéséhez.

### Töltésvezérlés

- **Töltés engedélyezve** — írható be/ki kapcsoló. Küldi az `ena 1` parancsot az állomás engedélyezéséhez vagy `ena 0`-t a letiltásához. Tükrözi az `Enable user` zászlót a `report 2`-ből. OFF írása tartósan szünetelteti a töltést az újbóli engedélyezésig vagy az állomás újraindításáig; a KEBA kötelező 2 másodperces szünetet ír elő az `ena 0` után, mielőtt a következő parancs elfogadható lenne.
- **Felhasználói töltőáram** — írható maximális töltőáram amperben. Küldi a `curr` parancsot milliamperben (a sablon belsőleg 1000-rel szoroz). Érvényes tartomány **6–63 A**; a wallbox korlátozza a tényleges értéket a hardveres határra (DIP-kapcsolók, kábelkódolás, termikus derating), és az új beállítás 6–7 másodperc múlva jelenik meg a Control Pilot PWM-en.

> [!TIP]
> A `curr` **tartós** beállítás — fennmarad a következő `curr` írásig vagy az állomás újraindításáig. A KEBA a nem tartós `currtime` változatot ajánlja a mindennapi használatra, mert az kihúzáskor visszaáll. Ez a sablon csak a `curr`-t teszi elérhetővé; ütemezett töltéshez vagy automatikus visszaállítási szemantikához vezérelje a Felhasználói töltőáramot egy TapHome Smart Rule-ból, amely a munkamenet kezdete előtt írja be a célértéket, és kihúzás után visszaállítja a kívánt alapértelmezett értékre.

### Csatlakoztatási és reteszelési állapot

Három független reed kontaktus, mindegyik a `report 2` `Plug` bitmaszkjának külön bitjéből származtatva:

| Eszköz | Plug bit | Maszk | Jelentés |
|--------|----------|-------|----------|
| **Wallboxba csatlakoztatva** | 0 | `0x01` | A kábel be van dugva a wallbox aljzatába (nem állandóan csatlakoztatott kábelek esetén) |
| **Kábel reteszelve** | 1 | `0x02` | A kábel mechanikusan reteszelve van a wallbox aljzatában |
| **Járműbe csatlakoztatva** | 2 | `0x04` | A kábel be van dugva az EV-be |

A töltéshez **mind a három bit beállítása** szükséges (`Plug = 7`). Az egyes eszközök lehetővé teszik megkülönböztetni, hogy a felhasználó az autót, a wallboxot vagy mindkettőt húzta-e ki.

### Töltési állapot

- **Töltési állapot** — többértékű eszköz, amely a wallbox üzemmódját jeleníti meg, a `report 2` `State` mezőjéből leképezve:

| Raw `State` | Protokoll jelentés (UDP Programmers Guide V 2.03) | Sablon megjelenítés |
|-------------|----------------------------------------------------|---------------------|
| 0 | Indítás | Indítás |
| 1 | Nem kész a töltésre (nincs csatlakoztatva, reteszelve vagy blokkolva) | Nem kész |
| 2 | Töltésre kész, vár a járműre | Kész |
| 3 | Töltés | Tölt |
| 4 | Hiba áll fenn | Hiba |
| 5 | Töltés átmenetileg megszakítva | Nem engedélyezett |

> [!WARNING]
> A sablon a raw `State = 5` értéket **Nem engedélyezett**-ként jeleníti meg, de a KEBA UDP Programmers Guide V 2.03 (§3.2.3) ezt az értéket „Töltés átmenetileg megszakítva" néven dokumentálja (például túlmelegedés vagy voter általi elutasítás miatt). Ha a Töltési állapot „Nem engedélyezett"-et mutat folyamatban lévő RFID munkamenet nélkül, ezt tekintse átmeneti megszakításnak, nem engedélyezési hibának. A nyers értéket közvetlen `report 2` lekérdezéssel lehet ellenőrizni a wallbox UDP 7090-es portján.

## Hibaelhárítás

### A TapHome nem mutat adatokat a wallboxból

1. Ellenőrizze a wallbox termékkódját a típustáblán. Csak a `KC-P20-xxxxxx2x-xxx` (c-series) és `KC-P20-xxxxxx3x-xxx` (c-series+PLC) támogatja az UDP-t
2. Erősítse meg, hogy a firmware verziója **≥ 2.5**. A firmware-frissítések a keba.com/emobility letöltési területén érhetők el
3. Erősítse meg a **DSW1.3 = ON**-t — a leggyakoribb beállítási hiba. A DIP-kapcsolók a csatlakozó-panel fedél alatt vannak, és üzembe helyezéskor könnyen észrevétlenek maradnak. Átkapcsolás után nyomja meg a szerviz gombot 1 másodpercig, vagy kapcsolja le és fel a megszakítót
4. Győződjön meg arról, hogy az UDP **7090-es port** nyitva van a TapHome Core és a wallbox között (nincs VLAN / tűzfal blokkolás)
5. Erősítse meg, hogy a Modbus TCP felület a wallboxon nem aktív — az UDP és a Modbus TCP kölcsönösen kizárják egymást

### A Töltés engedélyezve kapcsoló írásának nincs hatása

Egyes állomás-konfigurációk felülírják az `Enable user`-t a külső engedélyező bemeneten X1 keresztül vagy egy aktív failsafe eseményen keresztül. Ha az `ena 1` nem hozza ki az állomást a letiltott állapotból:

- Ellenőrizze, hogy a DSW1.1 ON állású-e (külső engedélyező bemenet használatban). Ha igen, ellenőrizze, hogy az X1 érintkező zárva van-e.
- Figyelje az `Enable sys`-t a nyers `report 2` adatokban — ha `Enable sys = 0`, az állomás megtagadja az engedélyezést az `Enable user`-től függetlenül (tipikusan failsafe timeout vagy termikus határérték miatt). A sablon nem teszi elérhetővé az `Enable sys`-t; erősítse meg a wallbox állapot LED-én vagy közvetlen UDP lekérdezéssel.

### A Felhasználói töltőáram változtatása nem terjed tovább

Új áram írása után az állomásnak **6–7 másodpercre** van szüksége a változás belső alkalmazásához. Ha az új érték soha nem jelenik meg a visszaolvasásban:

- Ellenőrizze, hogy a cél a **6000–63000 mA** (6–63 A) érvényes tartományon belül van-e. A tartományon kívüli értékeket a wallbox csendben elutasítja.
- Erősítse meg, hogy nincs aktív failsafe esemény — aktiváláskor a `Max curr = Curr FS` felülírja a `Curr user`-t, amíg a failsafe nem alaphelyzetbe áll.
- Ne feledje, hogy a `curr` **tartós** beállítás. Ha egy korábbi `currtime` parancs még fut (egy másik kliens által kiadva), a `curr` figyelmen kívül marad, amíg a `currtime` időzítő le nem jár, vagy a `currtime 0 0` nullázza.

### A Töltési állapot Hibán vagy Nem engedélyezetten ragadt

**Hiba** (raw `State = 4`) az állomás által jelentett hibaállapotot jelzi. A `report 2` `Error1` és `Error2` mezői hordozzák a numerikus hibakódot, de a sablon nem teszi elérhetővé őket — kérdezze le a wallboxot közvetlenül UDP 7090-es porton a `report 2` paranccsal, vagy nézze meg az állomás állapot LED-jét.

**Nem engedélyezett** a sablon megjelenítése a raw `State = 5` értékhez, amelyet a KEBA „Töltés átmenetileg megszakítva"-ként dokumentál. Gyakori okok a túlmelegedés, aktív voter-elutasítás vagy szándékos megszakítás a KEBA vezérlési folyamatban. A wallbox áramtalanítása és újraindítása, vagy a megszakítási feltétel elmúlására való várakozás általában helyreállítja a Tölt állapotot. Ez a sablon nem tesz elérhetővé RFID autorizációs folyamatot — az RFID whitelist továbbra is a KEBA alkalmazáson és fizikai master kártyákon keresztül kezelendő.

## Elérhető eszközök 6

Ezek az eszközök az importálás után jelennek meg a TapHome-ban.

Keba KeContact P20 Állapot Modul

Egyéni változók

Olvasás (modul)

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

Figyelő

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

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

Töltés engedélyezve Kapcsoló Olvasás és írás

Írható be/ki kapcsoló — a töltést az \`ena\` UDP paranccsal engedélyezi vagy tiltja (tartós, újraindításig vagy újbóli engedélyezésig)

boolean json\_path

Értékek / Állapotok: ${general\_enabled} · ${general\_disabled}

Kapcsoló állapot írása

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

Figyelő

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

Kábel reteszelve Reed kontaktus Csak olvasható

Jelzi, hogy a kábel mechanikusan reteszelve van-e a wallbox aljzatában (Plug 1. bit)

boolean bitmask

Figyelő

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

Járműbe csatlakoztatva Reed kontaktus Csak olvasható

Jelzi, hogy a töltőkábel csatlakoztatva van-e az elektromos járműhöz (Plug 2. bit)

boolean bitmask

Figyelő

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

Wallboxba csatlakoztatva Reed kontaktus Csak olvasható

Jelzi, hogy a kábel csatlakoztatva van-e a wallbox aljzatába (Plug 0. bit)

boolean bitmask

Figyelő

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

Töltési állapot Többértékű kapcsoló Csak olvasható

A wallbox üzemállapota — Indítás, Nem kész, Kész, Tölt, Hiba vagy Nem engedélyezett

numeric json\_path

Értékek / Állapotok: ${starting} · ${notReady} · ${ready} · ${charging} · ${error} · ${notAuthorized}

Figyelő

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

Felhasználói töltőáram Változó Olvasás és írás

Írható maximális töltőáram amperben (6–63 A) — a \`curr\` UDP paranccsal küldve a wallboxnak milliamperben

numeric Egység: A json\_path

Írás

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

Figyelő

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

**Kapcsolat:** Packet Parser → UDP

Lehetséges fejlesztések (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.

## Importálási paraméterek

Ezeket az értékeket az XML importálásakor adja meg.

| Az alkalmazás kéri     | Alapérték     |
|------------------------|---------------|
| IP-cím                 | `192.168.0.1` |
| Port                   | `7090`        |
| Internal poll interval | `10000`       |

## Források

- 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

A gyártói dokumentumok © a mindenkori tulajdonosaikat illetik. A gyártó által közzétett formában, kizárólag tájékoztatásul tesszük elérhetővé őket.

## Kapcsolódó dokumentáció

- [Packet Parser integráció](https://taphome.com/hu/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hu/docs/integration/packet-parser/)
- [Packet parser függvények](https://taphome.com/hu/docs/script/packet-parser/)
- [Elemző függvények](https://taphome.com/hu/docs/script/parsing-functions/)