The deconz-push is an extension for the deCONZ REST plugin that provides a push socket and/or creates a tunnel to a local fhem instance in order to instantly push any changes of ZigBee devices (managed by the deCONZ application) to fhem (or the socket). This helps reduce polling load of fhem/home-apps and allow to change poll intervalls to e.g. 3600 seconds (once an hour). Much more important, this extension enables using button devices (e.g. Philips Dimmer Switch, Hue Tap) for home automation. Support for this extension is given at https://forum.fhem.de/index.php/topic,63614.0.html
The figure shows where the extension is located and how it integrates into deCONZ/home automation. ZigBee devices are managed and controlled through deCONZ as the bridge. As soon as something has changed (e.g. a button was pressed, a light has been turned on), the according deCONZ events trigger a message that instantly changes readings (e.g. state, pct, onoff, etc.) of the according HUEDevices in fhem or push message to listeners.
Basically, there is no need anymore for polling cycles between home automation apps and the bridge.
The plugin is available as open source and licensed under the Eclipse Public License - Version 1.0.
- FHEM installation on RaspBerry Pi
- ZigBee devices are managed by deCONZ and included into FHEM as type HUEDevice
- Previous deCONZ versions
3.1 deCONZ 2.04.35
3.2 deCONZ 2.04.18 (checkout branch 2.04.18) - Telnet in fhem is enabled. Password authentication and/or SSL/TLS must be enabled if the FHEM-IP is other than localhost.
- ZigBee devices are managed by deCONZ
1. Open a terminal (bash) to/at the RaspBerry (e.g. SSH)
2. Download the project
git clone https://hcm-lab.de/git/project/deconz-push.git
cd deconz-pushIf you're not using the recent deCONZ release, then checkout a branch that macht your version, e.g. ```bash git checkout 2.04.18 ```
3. OPTIONAL. For FHEM: Path to fhem home
If FHEM is not installed in /opt/fhem, then you must provide the path through the following command:
export FHEM_HOME=/your/path/to/fhem4. Install the plugin
./install.shThe script installs an extension script (99_myDeconz1.pm) into the FHEM folder, creates a backup of the original rest-plugin, and installs the push extension.
5. OPTIONAL. Instead of using the prebuilt binary, you may build the plugin yourself.
The build script automatically installs the plugin. So, if you decide to build the plugin by yourself, you can skip the previous step (4.).
./build.shThe script downloads and installs all necessary packages to build the plugin and invokes a "make" afterwards.
If the build was successful the script invokes install.sh afterwards.
6. For FHEM: Restart FHEM
Enter "shutdown restart" into the fhem commandbox.
Afterwards, it is recommended to create a device using the myDeconz1 module. Otherwise, the module needs to be reloaded in case of a 'rereadcfg' through the fhem commandbox.
define myDeconz myDeconz17. Restart deCONZ
Depending on how you installed deCONZ, you need to stop (if it is still running) and start deCONZ.
Any changes of a rest node result in change of the related readings in the HUEDevices.
Client listeners can connect to the IP of the deCONZ plugin and configured port (default: 7073) to receive push messages. By sending a 'quit' message, the connection terminates. Any changes of a rest node result in a message that follows the following form: Values are seperated by a ^ character. The first value specifies the current session, the second value indicates whether a light (l), sensor (s), or a group (g) has changed, the third value specifies the id of the device, the fourth value names the reading that has changed, and the last value represents the actual value. Afterwards, more readings and values may follow that are related to the given device.
68^l^4^level^254
68^l^4^level^254^xy^0,382037,0,000000In this example, the light node 4 has changed; The level has changed to 254 and the xy reading has changed to 0,382037,0,000000.
The install script automatically creates a backup of the original plugin in the "bkp"-folder. The following command restores the backup and removes the fhem-deconz-push extension.
./uninstall.shBy means of the following readings (if available), the extension can be explicitly configured. The readings have to be available in the HUEBridge that connects to the deCONZ bridge. Boolean values are represented as 1 (true) or 0 (false). The given values here are the default values.
- Enable the push extension.
setreading deCONZBridge push 1- Disable the push listener socket. This is only required, if you are using external push processes. Currently no one is known, so it is safe to disable this option.
setreading deCONZBridge pushSocketListener 0- Enable the fhem tunnel.
setreading deCONZBridge fhemtunnel 1- Telnet port to fhem.
setreading deCONZBridge fhemPort 7072- FHEM telnet enable ssl (mandatory for an IP other than localhost)
setreading deCONZBridge ssl 1- FHEM telnet password (mandatory for an IP other than localhost)
setreading deCONZBridge fpass password- Push (listener) port for client conects.
setreading deCONZBridge pushPort 7073After changing one of theses readings, deCONZ needs to be restarted for the readings to become effective.
The extension can also be configured by means of a configuration file located at
/usr/share/deCONZ/rest_push.confThe following options are available:
# Disable plugin
#disableplugin
# FHEM telnet port
fport 7072
# FHEM telnet IP address
fip 127.0.0.1
# FHEM telnet enable ssl (mandatory for an IP other than localhost)
#ssl
# FHEM telnet password (mandatory for an IP other than localhost)
#fpass password
# Push client socket port
pport 7073
# Disable fhem tunnel
#disablefhem
# Disable push listener socket
#disablepushlistener
nonodeupdateAll the options above relate to the meaning given in the previous section. If an option is not given in the configuration file, then the option translates to the default (or enabled (true)).