homematic

homematic

 

This is the page describing the Homematic driver for OGEMA 2.0 and newer. OGEMA Homematic driver consists of two parts. On the one hand there is the low level driver (LLD) that partially implements the  protocol. On the other hand the high level driver provides support for a number of Homematic devices. See also Getting started with your own application in the DemoKit -> Homematic for additional information on usage.

Low Level Driver - LLD

As the coordinator of the Homematic network acts the USB device http://www.elv.de/homematic-usb-konfigurations-adapter-1.html. The LLD is not tested with any other coordinater hardware. The coordinator is controlled by the LLD by the libusb library. As soon as the LLD is activated and the coordinator hardware is connected, the LLD starts with the communication.

To enable new devices you have to pair them with the coordinator. The driver sets the coordinator hardware to the appropriate status for the first 60 seconds (default) after startup. This status can be triggered at any time via the shell command

 hmll:enablePairing

Every device paired to the coordinator is just cached to the current runtime session. To save all actual devices to the persisent device file following shell command can be used

 hmll:cacheDevices USB

For every time the command is called the device file will be overwritten. All devices that are already cached in this way will be contacted by the LLD after a restart of the framework. In other words each device must be paired only once. If the coordinator is not able to communicate with a device it will removed from the current cached devices immediately, but not from the persistent device file. To save the removal the cacheDevice command has to be called.

For instructions how to pair devices head over to the devices official manual. It is also recommended to set up the devices with the official Device Configurator for the first time to avoid missing parameters http://files.elv.de/Assets/Produkte/10/1041/104134/Downloads/hm_cfg_usb_usersoftware_v1_515.zip .

High Level Driver - HLD

HLD periodically sends a request to the LLD which devices are available in  the network environment. As response to this request LLD reports the list of all available devices. Each device is uniquely identified via its hardware address and device type. If the HLD detects a devices which is not yet cached and is supported an appropriate device instance is created. The creation of the device instance ends up creating a set of mandatory channels and creating and activating resources for each channel. Since homematic doesn't support actively polling of the devices, all created channels are updated asynchronously.

Supported Devices

Currently the following devices are supported and tested with the homematic driver and will be shown with their Resource- and Subresource trees.

• HM-ES-PMw1-Pl - Smart Plug
• HM-CC-RT-DN - Radiator Valve
• HM-CC-SCD - CO2 Detector
• HM-RC-4-2 - Remote Control
• HM-WDS-10-TH-O - Temperature and Humidity Sensor
• HM-WDS30-T-O - Temperature Sensor
• HM-SEC-WDS-2 - Water Detection Sensor
• HM-SEN-MDIR-SM - Motion Detector 

Other Homematic devices may also work, but have not been tested yet and are not listed.

HM-ES-PMw1-Pl - Smart Plug

http://www.elv.de/homematic-funk-schaltaktor-1fach-mit-leistungsmessung-zwischenstecker.html

 

HM-CC-RT-DN - Radiator Valve

http://www.elv.de/homematic-heizkoerperthermostat-1.html

HM-CC-SCD - CO2 Sensor

http://www.elv.de/homematic-funk-luftguete-co2-sensor.html

 

HM-RC-4-2 - Remote Control

http://www.elv.de/homematic-funk-handsender-4-tasten.html

 

HM-WDS30-T-O and HM-WDS10-TH-O - Temperature-Humidity-Sensors

http://www.elv.de/homematic-hm-wds30-t-o-funk-temperatursensor-aussen.html http://www.elv.de/homematic-hm-wds10-th-o-funk-temperatur-luftfeuchtesensor-oth.html

 

HM-Sec-WDS-2 - Water Detector

http://www.elv.de/homematic-funk-wassermelder.html

 

HM-Sen-MDIR-SM - Motion Sensor

http://www.elv.de/homematic-hm-sen-mdir-aussen-bewegungsmelder-komplettbausatz.html

group-Id	org.ogema.drivers
artifact-Id	homematic hm-hl
latest release	2.0.1
development version	2.0.2-SNAPSHOT

Attachments:

{width="8" height="8"} Power.PNG (image/png) {width="8" height="8"} Radiator.PNG (image/png) {width="8" height="8"} co2.PNG (image/png) {width="8" height="8"} Remote.PNG (image/png) {width="8" height="8"} THSensor.PNG (image/png) {width="8" height="8"} Water.PNG (image/png) {width="8" height="8"} Motion.PNG (image/png)