This page is part of archived documentation for openHAB 2.5. Go to the current stable version

# Keba Binding

This binding integrates the Keba KeContact EV Charging Stations (opens new window).

# Supported Things

The Keba KeContact P20 and P30 stations are supported by this binding, the thing type id is kecontact.

# Thing Configuration

The Keba KeContact P20/30 requires the ip address as the configuration parameter ipAddress. Optionally, a refresh interval (in seconds) can be defined as parameter refreshInterval that defines the polling of values from the charging station.

# Channels

All devices support the following channels:

Channel ID Item Type Read-only Description
state Number yes current operational state of the wallbox
enabled Switch no activation state of the wallbox
maxpresetcurrent Number no maximum current the charging station should deliver to the EV
power Number yes active power delivered by the charging station
wallbox Switch yes plug state of wallbox
vehicle Switch yes plug state of vehicle
locked Switch yes lock state of plug at vehicle
I1/2/3 Number yes current for the given phase
U1/2/3 Number yes voltage for the given phase
output Switch no state of the X1 relais
input Switch yes state of the X2 contact
display String yes display text on wallbox
error1 String yes error code state 1, if in error (see the KeContact FAQ)
error2 String yes error code state 2, if in error (see the KeContact FAQ)
maxsystemcurrent Number yes maximum current the wallbox can deliver
failsafecurrent Number yes maximum current the wallbox can deliver, if network is lost
uptime DateTime yes system uptime since the last reset of the wallbox
sessionconsumption Number yes energy delivered in current session
totalconsumption Number yes total energy delivered since the last reset of the wallbox
authreq Switch yes authentication required
authon Switch yes authentication enabled
sessionrfidtag String yes RFID tag used for the last charging session
sessionrfidclass String yes RFID tag class used for the last charging session
sessionid Number yes session ID of the last charging session
setenergylimit Number no set an energy limit for an already running or the next charging session
authenticate String no authenticate and start a session using RFID tag+RFID class

# Example

demo.Things:

Thing keba:kecontact:1 [ipAddress="192.168.0.64", refreshInterval=30]

demo.items:

Dimmer KebaCurrentRange  {channel="keba:kecontact:1:maxpresetcurrentrange"} 
Number KebaCurrent  {channel="keba:kecontact:1:maxpresetcurrent"}
Number KebaSystemCurrent  {channel="keba:kecontact:1:maxsystemcurrent"} 
Number KebaFailSafeCurrent  {channel="keba:kecontact:1:failsafecurrent"} 
String KebaState  {channel="keba:kecontact:1:state"}
Switch KebaSwitch  {channel="keba:kecontact:1:enabled"}
Switch KebaWallboxPlugged  {channel="keba:kecontact:1:wallbox"}
Switch KebaVehiclePlugged  {channel="keba:kecontact:1:vehicle"}
Switch KebaPlugLocked  {channel="keba:kecontact:1:locked"}
DateTime KebaUptime "Uptime [%1$tY Y, %1$tm M, %1$td D,  %1$tT]"  {channel="keba:kecontact:1:uptime"}
Number KebaI1  {channel="keba:kecontact:1:I1"}
Number KebaI2  {channel="keba:kecontact:1:I2"}
Number KebaI3  {channel="keba:kecontact:1:I3"}
Number KebaU1  {channel="keba:kecontact:1:U1"}
Number KebaU2  {channel="keba:kecontact:1:U2"}
Number KebaU3  {channel="keba:kecontact:1:U3"}
Number KebaPower  {channel="keba:kecontact:1:power"}
Number KebaSessionEnergy  {channel="keba:kecontact:1:sessionconsumption"}
Number KebaTotalEnergy  {channel="keba:kecontact:1:totalconsumption"}
Switch KebaInputSwitch  {channel="keba:kecontact:1:input"}
Switch KebaOutputSwitch  {channel="keba:kecontact:1:output"}
Number KebaSetEnergyLimit {channel="keba:kecontact:1:setenergylimit"}

demo.sitemap:

sitemap demo label="Main Menu"
{
			Text label="Charging Station" {
				Text item=KebaState label="Operating State [%s]"
				Text item=KebaUptime
				Switch item=KebaSwitch label="Enabled" mappings=[ON=ON, OFF=OFF ]
				Switch item=KebaWallboxPlugged label="Plugged into wallbox" mappings=[ON=ON, OFF=OFF ]
				Switch item=KebaVehiclePlugged label="Plugged into vehicle" mappings=[ON=ON, OFF=OFF ]
				Switch item=KebaPlugLocked label="Plug locked" mappings=[ON=ON, OFF=OFF ]
				Slider item=KebaCurrentRange switchSupport label="Maximum supply current [%.1f %%]"
				Text item=KebaCurrent label="Maximum supply current [%.0f mA]"
				Text item=KebaSystemCurrent label="Maximum system supply current [%.0f mA]"
				Text item=KebaFailSafeCurrent label="Failsafe supply current [%.0f mA]"
				Text item=KebaSessionEnergy label="Energy during current session [%.0f Wh]"
				Text item=KebaTotalEnergy label="Energy during all sessions [%.0f Wh]"
				Switch item=KebaSetEnergyLimit label="Set charge energy limit" mappings=[0="off", 20000="20kWh"]
			}
}