Domoticz plugin for the EMS Wi-Fi Gateway with Proddy's EMS-ESP firmware.
If you are using the EMS Wi-Fi Gateway (or another setup with) with Proddy's EMS-ESP firmware in combination with Domoticz.
The EMS-ESP firmware communicates via MQTT. Although MQTT is an open format, the required message contents is specific to each home automation system.
The EMS-ESP firmware was intented for integration with Home Assistant (HA).
To communicate with Domoticz you need this plugin that will listen to the topics the Gateway publishes and listens to.
The plugin will basically translate the Home Assistant format to Domoticz format.
This version is compatible with EMS-ESP V2.1 and largely with V2.0.1. I removed all specific support for 1.9.5 in the new plugin so you need to update the firmware of your Gateway (which you should do anyway because the V2.1 firmware is awesome!).
If you are still on 1.9.5 see the wiki on how to safely update from 1.9.5 to 2.1.
The Gateway communicates via MQTT. For this you need a MQTT broker/server installed on your machine. Usually this is Mosquitto.
You can check if your machine has it installed by typing f.i. mosquitto_pub in a terminal.
If it says 'command not found' you need to install Mosquitto first. If you get a list of option Mosquitto is installed and you can continue installing the plugin directly.
If you have Git installed (preferred method):
Go to the domoticz/plugins directory and run git clone https://github.com/bbqkees/ems-esp-domoticz-plugin.git.
Make sure that 'Accept new Hardware Devices' is enabled in settings/system.
Now restart the domoticz service (by typing sudo systemctl restart domoticz in the shell).
Create a new hardware of the type "EMS bus Wi-Fi Gateway" (Do not create a hardware of the type 'MQTT Client Gateway', this is something different). See the image below.
Set the MQTT server and port. Usually the MQTT server is running on the same machine as Domoticz. If so, you can leave the IP and port to its default setting.
The plugin listens to the topics preceded by "ems-esp/".
Also make sure you don't change the host name of the Gateway otherwise the topic will change as well!
In the latest plugin version you can change the topic string to your own preference if needed.
In the MQTT setting of the web interface set the MQTT format to 'nested'. Otherwise the plugin won't work as intended.
The plugin subscribes and publishes to the default MQTT topics of the Gateway.
The plugin captures the messages and updates the Domoticz devices and sensors automatically.
On the first run the plugin will create several devices and sensors in Domoticz.
Go to the 'Devices' tab in Domoticz and search for the devices that are created. You can now add each device to Domoticz by clicking on the small green arrow with 'Add Device'.
If you used the git clone command to initially install the plugin just type git pull when in the plugin folder.
Now restart the domoticz service (by typing sudo systemctl restart domoticz in the shell).
On first run of the plugin (takes a minute maybe) additional devices will be created automatically if they were not defined before. Existing devices will not change.
If you find a problem with the plugin, just open an issue here.
Als if you are missing parameters just let me know.
The mixer logic got a bit more complex in EMS-ESP V2. There are now too many possible ID's and HC's so I need to create an elegant solution for this that fits into the limitations of the Domoticz Python plugin system.
This plugin was based on the beta version version created by Gert05