Skip to content

Domoticz plugin for the EMS Wi-Fi Gateway with Proddy's EMS-ESP firmware

License

Notifications You must be signed in to change notification settings

bobzomer/ems-esp-domoticz-plugin

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ems-esp-domoticz-plugin

Domoticz plugin for the EMS Wi-Fi Gateway with Proddy's EMS-ESP firmware.

When do you need this?

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.

Compatibility

The plugin works with all versions of EMS-ESP. So the old versions with the Telnet interface are supported but also the new versions with the web interface (1.9.0 and onwards).
In firmware 1.9.2 the MQTT topics have changed though. I am going to provide a major update. Its recommended to stay on 1.9.1 until further notice. If you are on 1.9.2 or later, hc1 will work.

There have been a lot of additions in the EMS-ESP firmware lately particularly regarding support for multiple heating circuit.
There is no support for multiple heating circuits in the plugin yet.
At this point 24 devices and sensors are created by the plugin.

Installation and configuration

Check if you have a MQTT broker/server

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.

Installing the plugin

Stop the Domoticz service (by typing sudo systemctl stop domoticz in the shell).
Now do one of the following actions:
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.

Or as an alternative you can do the following:
Create a new directory 'ems-gateway' in the folder domoticz/plugins.
Copy the files mqtt.py and plugin.py to this new domoticz/plugins/ems-gateway directory.

Make sure that 'Accept new Hardware Devices' is enabled in settings/system.
Now start the domoticz service (by typing sudo systemctl start 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.

Setting the correct topics

The plugin listens to the topics preceded by "home/ems-esp/". In the latest EMS-ESP firmware versions the default topic is just "ems-esp". To change this go to the Gateway web interface and to the MQTT settings. Now set the Base parameter to "home".

Also make sure you don't change the host name of the Gateway otherwise the topic will change as well!

Set the right MQTT update frequency

By default the Gateway will publish the set of MQTT messages every 120 seconds.
For temperature and general logging this is a good update frequency. However, this is too slow if you also want to capture short events like turning on the warm water for 30 seconds.
If needed you can change the frequency in the web interface in 'Custom Settings' -> 'Publish Time'. Don't set it too low as it will bombard Domoticz with messages.

Using the plugin

On the first run the plugin will create several devices and sensors in Domoticz.
The plugin then subscribes and publishes to the default MQTT topics of the Gateway.
The plugin captures the messages and updates the Domoticz devices and sensors automatically.
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'.

Updating the plugin

To update the plugin, stop the Domoticz service (by typing sudo systemctl stop domoticz in the shell).
Then copy the new plugin.py file to the plugin folder and overwrite the existing file.
Or if you used the git clone command to initially install the plugin just type git pull when in the plugin folder.
Now start the domoticz service (by typing sudo systemctl start 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.

Issues

If you find a problem with the plugin, just open an issue here.
As I do not have an EMS thermostat myself, I would like to know if this works as intended.

To Do List

  • Add the solar/mixer module devices.
  • Add support for the DS18B20 temperature sensors.
  • Add the additional topics for controlling thermostat night/day settings.
  • Add support for multiple heating circuits.
  • Make the topics configurable.

Credits

This plugin is based on the beta version version created by Gert05

About

Domoticz plugin for the EMS Wi-Fi Gateway with Proddy's EMS-ESP firmware

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%