This is a binding for the openHAB / eclipse Smart Home home automation system. It aims to make the data available to the user, which is already sent by lots of modern metering hardware (e.g. heat cost allocators, electricity/gas/water/heat meters) already widely deployed in houses and especially flats.
Development is still in progress, but the binding is already working quite nicely. Because the only device I have access to is the Techem heat cost allocators, the binding currently focuses on them. Also you need a device to receive the transmissions. The underlying library jMBus supports transceivers of Amber and Radiocrafts, the binding is developed and tested only with the Amber Wireless AMB8465-M.
This is intended to show it around to other people who might be interested and collect testers, reviewers and contributors who have other OSes than Linux, other recieving hardware (e.g. a CUL) or other metering devices which would be interesting to include.
What is already working:
- manually add the receive stick as a thing, set serial console device (e.g. /dev/ttyUSB0)
- populate inbox with discovery results for Techem heat cost allocators
- add discovery results as new things
- display and update data in channels/linked thing items
Work in progress:
- general smoothness
- more receiver sticks
- more parsed devices
There is some more information and discussion in the forum.
- Run
mvn packagein thesrcdirectory.. - The compilation result will be at
src/de.unidue.stud.sehawagn.openhab.binding.wmbus/target/de.unidue.stud.sehawagn.openhab.binding.wmbus-2.0.0-SNAPSHOT.jar. - Drop this .jar into your openHAB2 Karaf deploy directory, e.g.
openhab2/addons. 3a. Native librxtxSerial.so needs to be placed in /etc/openhab2/rxtx/ with openhab user as the owner. This is where the binding will look for it. Native library is part of building jRXTX. File from Ubuntu/Debian packa rxtx-java may also work. - It should get automatically picked up and started by Karaf.
- Run
bundle:listin the OSGi console, it should show awmbusbundle in active state. - Open PaperUI in the browser.
- Check that Configuration -> Bindings lists the WMBus Binding.
- Go to Configuration -> Things.
- Add new WMBus Binding Thing -> Amber Wireless WMBus Stick (exactly one).
- Enter name of Serial Device (e.g. /dev/ttyUSB0, check via dmesg when plugging in the stick) as configuration parameter.
- The Thing should show
ONLINEas status. If not, edit the Thing, this screen should include some more error details, also check OSGi console and userdata/logs/openhab.log. - If everything is working correctly, heat cost allocators should be discovered automatically and turn up as new Things in the Inbox as soon as a message is received from them.
- Search for the devices in your flat by typing in the 4 digit ID shown on the display into the search field of the Inbox and add those devices via the checkmark button.
- Under Control, the Thing with it's different channels should display, readings should be updated regularly about every 10 minutes or so:
- Room and radiator temperature are always current (at the time of sending/receiving the message).
- "Current Reading" will only update once every day.
- If a Persistence Add-on is installed, the readings will also be stored into the database.
- In HABmin or HABPanel, diagrams/charts/graphs can be configured to have a look at the latest values in comparison.
- If any Exceptions or other messages turn up in the logs or console, please let me know and open an issue here.
- Install OpenHAB IDE according to their webpage. This is basically Eclipse IDE + Oomph + OpenHAB dev addons via Oomph.
- Clone this repository.
- File - Import - Maven - Existing Maven Projects. Give path to this git repository, select all three projects, add project to working set "WMBus" or similar.
This binding is released under EPL-1.0, though the included patched version of outdated jmbus-2.2.2 is under GPL-3.0. (Newer versions of it, to which we intend to switch to soon, are under MPL-2.0)