This page is part of archived documentation for openHAB 3.1. Go to the current stable version
# KM200 Binding
The KM200 Binding is communicating with a Buderus Logamatic web KM200 / KM100 / KM50 (opens new window). It is possible to receive and send parameters like string or float values.
Important: If the communication is not working and you see in the logfile errors like "illegal key size" then you have to change the Java Cryptography Extension to the Unlimited Strength Jurisdiction (opens new window).
# Supported Things
This binding supports 11 different things types
| Thing | UI Only | Description |
|---|---|---|
appliance | The appliance (The heater inside of this heating system). | |
dhwCircuit | A hot water circuit. | |
gateway | The gateway. (The connected KM200/100/50 device). | |
heatingCircuit | A heating circuit. | |
heatSource | The heat source. | |
holidayMode | The holiday modes configuration. | |
sensor | The sensors. | |
solarCircuit | A solar circuit. | |
system | The system without sensors and appliance. | |
notification | The notifications. | |
switchProgram | X | A switch program. |
# KM 50/100/200
This Binding is tested on a KM200 but it should work on KM50 and KM100, too.
# Discovery
This binding discovers KM devices through mDNS in the local network.
# Thing Configuration
# kmdevice
The kmdevice bridge requires the following configuration parameters:
| Parameter Label | Parameter ID | Description | Required | Default | Example |
|---|---|---|---|---|---|
| IP address | ip4_address | The IP address of the KMXXX device | true | 192.168.1.10 | |
| Refresh Interval | refreshInterval | The refresh interval in seconds which is used to poll the device. | true | 30 | 30 |
| Private Key | privKey | Take a look to the internet. Maybe you will find a way for generation. | true | 0000FFFFEEEEDDDDCCCCBBBBAAAA999988887777666655554444333322221111 | |
| Read Delay | readDelay | Delay between two read attempts in ms. | true | 100 | 100 |
| Maximum Number Of Repeats | maxNbrRepeats | Maximum number of repeats in case of a communication error (like HTTP 500 error). | true | 10 | 10 |
# Channels
This binding creates the channels depending on the connected heating system fully automatically. These channels depend on the connected heating system. You can see the complete list of supported channels of the thing in the UI. There is no official documentation for the parameters available from Buderus, so the names of the channels is all that reflects their purpose.
# Full Examples
This example reads different values of items from a KMXXX Device.
things/kmxxx.things:
Bridge km200:kmdevice:0815 "testKMDevice" @ "Room" [ privateKey= "1234567890abcdef1234567890abcdef", maxnbrrepeats=10.0, readDelay=100, refreshInterval=30, maxNbrRepeats=10, ip4Address="192.168.1.111", refreshinterval=30.0, readdelay=100.0 ] {
heatingCircuit 1 "TestHC1"
sensor 1 "TestSensors"
}
items/kmxxx.items:
Number budWater "Water temperature [%.1f °C]" {channel="km200:dhwCircuit:0815:1:actualTemp"}
Number budOutdoor "Outdoor temperature [%.1f °C]" {channel="km200:sensor:0815:1:outdoor_t1"}