mirror of
https://github.com/openhab/openhab-addons.git
synced 2025-01-11 07:32:11 +01:00
106 lines
6.3 KiB
Markdown
106 lines
6.3 KiB
Markdown
# Keba Binding
|
|
|
|
This binding integrates the [Keba KeContact EV Charging Stations](https://www.keba.com).
|
|
|
|
## 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"]
|
|
}
|
|
}
|
|
```
|