I have created a Python plugin for integrating the ELV/EQ-3 MAX! system into Domoticz. These are pretty affordable radiator valves, wall thermostats, contact switches, etc. which can remotely be controlled if you buy the additional Cube. The Cube's network communication has been reverse engineered, and many home automation solutions now have plugins for the system, except for Domoticz!. That is, until now
I made use of a very well written Python API for the MAX Cube: https://github.com/hackercowboy/python-maxcube-api
All that was left was to "just" integrate it into the Python plugin system, which was quite a rough ride because I had no prior Python experience. But here it is!
One of the easiest ways to install the plugin is by entering the following commands in a terminal to your machine running Domoticz (at least if this machine is a Raspberry Pi or something similar):
Code: Select all
cd ~/domoticz/plugins git clone https://github.com/mvzut/maxcube-Domoticz-plugin MaxCube
Activate the plugin by selecting it from the "Type" drop-down menu, fill in the parameters (on-screen explanation is given) and click "Add".
The plugin automatically creates devices for all your ELV/EQ-3 MAX! components:
- Thermostats and radiator valves are represented as Domoticz thermostat devices
- Temperature sensors reflect the actual temperature retrieved from wall mounted thermostats or radiator valves. Note that radiator valves only report temperature when they are active (i.e. the valve is moving)!
- Valve position of radiator valves is reflected in percentage sensors
- Status of door and window contacts is reflected in contact sensors
- Thermostat modes can be viewed and changed with selector switches (not fully working yet, see below)
- Automatic removal of devices if they are not present anymore, or if you have indicated you don't want them anymore (for e.g. Mode switches) Partly done
- Changing the mode doesn't work well yet, the setpoint doesn't change to what is programmed. I will look into this, but I am largely dependent on what the API provides here.
- Maybe I will make more device types optional (next to the Mode switches), some people might not be interested in temperature sensors or valve positions but just want the thermostats. Just deleting the devices doesn't really help, since they will be recreated the next time the plugin starts. As an intermediate solution, you can set devices to "Unused" if you don't want to see them. Done
P.S. There was already a discussion on early beta versions of this plugin here: viewtopic.php?f=34&t=841&p=192702#p192702. But I felt a new plugin probably deserves a topic of its own