[Documentation] Markdown improvements f to m (#13866)
Signed-off-by: Jerome Luckenbach <github@luckenba.ch>
This commit is contained in:
Jerome Luckenbach
committed by
GitHub
GitHub
parent
3c236b3103
commit
0e68936663
@@ -15,94 +15,93 @@ Optionally, a refresh interval (in seconds) can be defined as parameter `refresh
|
||||
|
||||
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:ElectricCurrent | no | maximum current the charging station should deliver to the EV in A |
|
||||
| maxpresetcurrentrange | Number:Dimensionless | no | maximum current the charging station should deliver to the EV in % |
|
||||
| power | Number:Power | 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:ElectricCurrent | yes | current for the given phase |
|
||||
| U1/2/3 | Number:ElectricPotential | yes | voltage for the given phase |
|
||||
| output | Switch | no | state of the X1 relais |
|
||||
| input | Switch | yes | state of the X2 contact |
|
||||
| display | String | no | 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:ElectricCurrent | yes | maximum current the wallbox can deliver |
|
||||
| failsafecurrent | Number:ElectricCurrent | yes | maximum current the wallbox can deliver, if network is lost |
|
||||
| uptime | Number:Time | yes | system uptime since the last reset of the wallbox |
|
||||
| sessionconsumption | Number:Energy | yes | energy delivered in current session |
|
||||
| totalconsumption | Number:Energy | 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:Energy | 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 |
|
||||
| maxpilotcurrent | Number:ElectricCurrent | yes | current offered to the vehicle via control pilot signalization |
|
||||
| maxpilotcurrentdutycyle | Number:Dimensionless | yes | duty cycle of the control pilot signal |
|
||||
|
||||
| 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:ElectricCurrent | no | maximum current the charging station should deliver to the EV in A |
|
||||
| maxpresetcurrentrange | Number:Dimensionless | no | maximum current the charging station should deliver to the EV in % |
|
||||
| power | Number:Power | 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:ElectricCurrent | yes | current for the given phase |
|
||||
| U1/2/3 | Number:ElectricPotential | yes | voltage for the given phase |
|
||||
| output | Switch | no | state of the X1 relais |
|
||||
| input | Switch | yes | state of the X2 contact |
|
||||
| display | String | no | 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:ElectricCurrent | yes | maximum current the wallbox can deliver |
|
||||
| failsafecurrent | Number:ElectricCurrent | yes | maximum current the wallbox can deliver, if network is lost |
|
||||
| uptime | Number:Time | yes | system uptime since the last reset of the wallbox |
|
||||
| sessionconsumption | Number:Energy | yes | energy delivered in current session |
|
||||
| totalconsumption | Number:Energy | 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:Energy | 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 |
|
||||
| maxpilotcurrent | Number:ElectricCurrent | yes | current offered to the vehicle via control pilot signalization |
|
||||
| maxpilotcurrentdutycyle | Number:Dimensionless | yes | duty cycle of the control pilot signal |
|
||||
|
||||
## Example
|
||||
|
||||
demo.Things:
|
||||
|
||||
```
|
||||
```java
|
||||
Thing keba:kecontact:1 [ipAddress="192.168.0.64", refreshInterval=30]
|
||||
```
|
||||
|
||||
demo.items:
|
||||
|
||||
```
|
||||
Number:Dimensionless KebaCurrentRange "Maximum supply current [%.1f %%]" {channel="keba:kecontact:1:maxpresetcurrentrange"}
|
||||
Number:ElectricCurrent KebaCurrent "Maximum supply current [%.3f A]" {channel="keba:kecontact:1:maxpresetcurrent"}
|
||||
Number:ElectricCurrent KebaSystemCurrent "Maximum system supply current [%.3f A]" {channel="keba:kecontact:1:maxsystemcurrent"}
|
||||
Number:ElectricCurrent KebaFailSafeCurrent "Failsafe supply current [%.3f A]" {channel="keba:kecontact:1:failsafecurrent"}
|
||||
Number KebaState "Operating State [%s]" {channel="keba:kecontact:1:state"}
|
||||
Switch KebaSwitch "Enabled" {channel="keba:kecontact:1:enabled"}
|
||||
Switch KebaWallboxPlugged "Plugged into wallbox" {channel="keba:kecontact:1:wallbox"}
|
||||
Switch KebaVehiclePlugged "Plugged into vehicle" {channel="keba:kecontact:1:vehicle"}
|
||||
Switch KebaPlugLocked "Plug locked" {channel="keba:kecontact:1:locked"}
|
||||
DateTime KebaUptime "Uptime [%s s]" {channel="keba:kecontact:1:uptime"}
|
||||
Number:ElectricCurrent KebaI1 {channel="keba:kecontact:1:I1"}
|
||||
Number:ElectricCurrent KebaI2 {channel="keba:kecontact:1:I2"}
|
||||
Number:ElectricCurrent KebaI3 {channel="keba:kecontact:1:I3"}
|
||||
Number:ElectricPotential KebaU1 {channel="keba:kecontact:1:U1"}
|
||||
Number:ElectricPotential KebaU2 {channel="keba:kecontact:1:U2"}
|
||||
Number:ElectricPotential KebaU3 {channel="keba:kecontact:1:U3"}
|
||||
Number:Power KebaPower "Energy during current session [%.1f Wh]" {channel="keba:kecontact:1:power"}
|
||||
Number:Energy KebaSessionEnergy {channel="keba:kecontact:1:sessionconsumption"}
|
||||
Number:Energy KebaTotalEnergy "Energy during all sessions [%.1f Wh]" {channel="keba:kecontact:1:totalconsumption"}
|
||||
Switch KebaInputSwitch {channel="keba:kecontact:1:input"}
|
||||
Switch KebaOutputSwitch {channel="keba:kecontact:1:output"}
|
||||
Number:Energy KebaSetEnergyLimit "Set charge energy limit [%.1f Wh]" {channel="keba:kecontact:1:setenergylimit"}
|
||||
```java
|
||||
Number:Dimensionless KebaCurrentRange "Maximum supply current [%.1f %%]" {channel="keba:kecontact:1:maxpresetcurrentrange"}
|
||||
Number:ElectricCurrent KebaCurrent "Maximum supply current [%.3f A]" {channel="keba:kecontact:1:maxpresetcurrent"}
|
||||
Number:ElectricCurrent KebaSystemCurrent "Maximum system supply current [%.3f A]" {channel="keba:kecontact:1:maxsystemcurrent"}
|
||||
Number:ElectricCurrent KebaFailSafeCurrent "Failsafe supply current [%.3f A]" {channel="keba:kecontact:1:failsafecurrent"}
|
||||
Number KebaState "Operating State [%s]" {channel="keba:kecontact:1:state"}
|
||||
Switch KebaSwitch "Enabled" {channel="keba:kecontact:1:enabled"}
|
||||
Switch KebaWallboxPlugged "Plugged into wallbox" {channel="keba:kecontact:1:wallbox"}
|
||||
Switch KebaVehiclePlugged "Plugged into vehicle" {channel="keba:kecontact:1:vehicle"}
|
||||
Switch KebaPlugLocked "Plug locked" {channel="keba:kecontact:1:locked"}
|
||||
DateTime KebaUptime "Uptime [%s s]" {channel="keba:kecontact:1:uptime"}
|
||||
Number:ElectricCurrent KebaI1 {channel="keba:kecontact:1:I1"}
|
||||
Number:ElectricCurrent KebaI2 {channel="keba:kecontact:1:I2"}
|
||||
Number:ElectricCurrent KebaI3 {channel="keba:kecontact:1:I3"}
|
||||
Number:ElectricPotential KebaU1 {channel="keba:kecontact:1:U1"}
|
||||
Number:ElectricPotential KebaU2 {channel="keba:kecontact:1:U2"}
|
||||
Number:ElectricPotential KebaU3 {channel="keba:kecontact:1:U3"}
|
||||
Number:Power KebaPower "Energy during current session [%.1f Wh]" {channel="keba:kecontact:1:power"}
|
||||
Number:Energy KebaSessionEnergy {channel="keba:kecontact:1:sessionconsumption"}
|
||||
Number:Energy KebaTotalEnergy "Energy during all sessions [%.1f Wh]" {channel="keba:kecontact:1:totalconsumption"}
|
||||
Switch KebaInputSwitch {channel="keba:kecontact:1:input"}
|
||||
Switch KebaOutputSwitch {channel="keba:kecontact:1:output"}
|
||||
Number:Energy KebaSetEnergyLimit "Set charge energy limit [%.1f Wh]" {channel="keba:kecontact:1:setenergylimit"}
|
||||
```
|
||||
|
||||
demo.sitemap:
|
||||
|
||||
```
|
||||
```perl
|
||||
sitemap demo label="Main Menu"
|
||||
{
|
||||
Text label="Charging Station" {
|
||||
Text item=KebaState
|
||||
Text item=KebaUptime
|
||||
Switch item=KebaSwitch
|
||||
Switch item=KebaWallboxPlugged
|
||||
Switch item=KebaVehiclePlugged
|
||||
Switch item=KebaPlugLocked
|
||||
Slider item=KebaCurrentRange
|
||||
Text item=KebaCurrent
|
||||
Text item=KebaSystemCurrent
|
||||
Text item=KebaFailSafeCurrent
|
||||
Text item=KebaSessionEnergy
|
||||
Text item=KebaTotalEnergy
|
||||
Switch item=KebaSetEnergyLimit
|
||||
}
|
||||
Text label="Charging Station" {
|
||||
Text item=KebaState
|
||||
Text item=KebaUptime
|
||||
Switch item=KebaSwitch
|
||||
Switch item=KebaWallboxPlugged
|
||||
Switch item=KebaVehiclePlugged
|
||||
Switch item=KebaPlugLocked
|
||||
Slider item=KebaCurrentRange
|
||||
Text item=KebaCurrent
|
||||
Text item=KebaSystemCurrent
|
||||
Text item=KebaFailSafeCurrent
|
||||
Text item=KebaSessionEnergy
|
||||
Text item=KebaTotalEnergy
|
||||
Switch item=KebaSetEnergyLimit
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
@@ -112,28 +111,32 @@ sitemap demo label="Main Menu"
|
||||
|
||||
Enable `DEBUG` or `TRACE` (even more verbose) logging for the logger named:
|
||||
|
||||
org.openhab.binding.keba
|
||||
```text
|
||||
org.openhab.binding.keba
|
||||
```
|
||||
|
||||
If everything is working fine, you see the cyclic reception of `report 1`, `2` & `3` from the station. The frequency is according to the `refreshInterval` configuration.
|
||||
|
||||
### UDP Ports used
|
||||
|
||||
Send port = UDP 7090
|
||||
```text
|
||||
Send port = UDP 7090
|
||||
```
|
||||
|
||||
The Keba station is the server
|
||||
|
||||
Receive port = UDP 7090
|
||||
```text
|
||||
Receive port = UDP 7090
|
||||
```
|
||||
|
||||
This binding is providing the server
|
||||
|
||||
UDP port 7090 needs to be available/free on the openHAB server.
|
||||
|
||||
|
||||
In order to enable the UDP port 7090 on the Keba station with full functionality, `DIP switch 1.3` must be `ON`.
|
||||
With `DIP switch 1.3 OFF` only ident-data can be read (`i` and `report 1`) but not the other reports as well as the commands needed for the write access.
|
||||
After setting the DIP switch, you need to `power OFF` and `ON` the station. SW-reset via WebGUI seems not to be sufficient in order to apply the new configuration.
|
||||
|
||||
|
||||
The right configuration can be validated as follows:
|
||||
|
||||
- WebGUI DSW Settings:
|
||||
|
||||
Reference in New Issue
Block a user