TapHome

KEBA KeContact P20 Állapot

Packet Parser → UDP
Beküldő
Utoljára frissítve: 06. 2026
KEBA KeContact P20 Állapot

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.

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

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ó. A beállítás azonos, mert ugyanarról a fizikai wallboxról van szó.

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

Ha a wallbox DHCP-t használ, rendeljen hozzá statikus DHCP-foglalást a routeren, hogy az IP-cím ne változzon áramszünet után. A TapHome az IP-t importálási paraméterként tárolja, és nem ismeri fel automatikusan az eszközt.

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.

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özPlug bitMaszkJelentés
Wallboxba csatlakoztatva00x01A kábel be van dugva a wallbox aljzatába (nem állandóan csatlakoztatott kábelek esetén)
Kábel reteszelve10x02A kábel mechanikusan reteszelve van a wallbox aljzatában
Járműbe csatlakoztatva20x04A 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 StateProtokoll jelentés (UDP Programmers Guide V 2.03)Sablon megjelenítés
0IndításIndítás
1Nem kész a töltésre (nincs csatlakoztatva, reteszelve vagy blokkolva)Nem kész
2Töltésre kész, vár a járműreKész
3TöltésTölt
4Hiba áll fennHiba
5Töltés átmenetileg megszakítvaNem engedélyezett

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

Keba KeContact P20 Állapot Modul
Egyéni változók

Keba KeContact P20 State

Olvasás (modul)
SENDDATA("report 2");
Figyelő
VAR jsonString := TOSTRING(RECEIVEDBYTES);
VAR id := PARSEJSON(jsonString, "$.ID", 1);

IF(id = 2)
    report2 := jsonString;
END
Töltés engedélyezve Kapcsoló

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

Töltés engedélyezve

Kapcsoló állapot írása
SENDDATA("ena " + St);
SENDDATA("report 2");
Figyelő
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

Kábel reteszelve

Figyelő
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

Járműbe csatlakoztatva

Figyelő
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

Wallboxba csatlakoztatva

Figyelő
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}

Töltési állapot

Figyelő
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ó

Í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

Felhasználói töltőáram

Írás
SENDDATA("curr " + Va*1000);
SENDDATA("report 2");
Figyelő
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.

Források

  • 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

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

TapHome által hitelesítve

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon