Boiler integration in Domoticz with Ebusd

1. Introduction

The goal of the project is the integration of a Saunier Duval boiler with a Domoticz home automation system.

2. Hardware

              

– Ebus Adapter : https://ebus.github.io/adapter/index.en.html
– Wemos D1 : https://www.wemos.cc/

3. Software

3.1 Ebus gateway

Download EspTool :

git clone https://github.com/espressif/esptool.git

Go in the folder :

cd esptool/

Download the latest ebus-ESP firmware for our Wemos :

wget https://github.com/john30/ebusd-esp/blob/master/dist/ebus-v2_d1mini.bin

Plug your Wemos and flash the firmware :

python esptool.py --port /dev/ttyUSB0 write_flash 0x00000 ebus-v2_d1mini.bin

Then reboot the Wemos and :
– Connect to the “EBUS” wireless network
– Open a web browser and go to http://192.168.4.1
– Adjust settings as below :

Your Wemos WLAN Ebus gateway should be ready !

3.2 Ebusd : Ebus daemon

Download the Ebusd package (here for Raspberry Pi) :

wget https://github.com/john30/ebusd/releases/download/v3.0/ebusd-3.0_armhf.deb

Install it :

sudo dpkg -i ebusd-3.0_armhf.deb 

Then download the latests configuration files :

git clone https://github.com/john30/ebusd-configuration.git

And copy them :

sudo cp -r ebusd-configuration/ebusd-2.1.x/en/* /etc/ebusd/

Then configure ebusd :

vi /etc/default/ebusd 

Here is my configuration (to be adapted) :

# /etc/default/ebusd:
# config file for ebusd service.

# Options to pass to ebusd (run "ebusd -?" for more info):
EBUSD_OPTS="--scanconfig -d 192.168.10.14:9999 --httpport=9999 --latency=20000 --loglevel=error"

# MULTIPLE EBUSD INSTANCES WITH SYSV
# In order to run multiple ebusd instances on a SysV enabled system, simply
# define several EBUSD_OPTS with a unique suffix for each. Recommended is to
# use a number as suffix for all EBUSD_OPTS settings. That number will then be
# taken as additional "instance" parameter to the init.d script in order to
# start/stop an individual ebusd instance instead of all instances.
# Example: (uncomment the EBUSD_OPTS above)
#EBUSD_OPTS1="--scanconfig -d /dev/serial/by-id/usb-FTDI_FT232R_USB_UART_A50285BI-if00-port0 -p 8888 -l /var/log/ebusd1.log"
#EBUSD_OPTS2="--scanconfig -d /dev/serial/by-id/usb-FTDI_FT232R_USB_UART_A900acTF-if00-port0 -p 8889 -l /var/log/ebusd2.log"
#EBUSD_OPTS3="--scanconfig -d /dev/serial/by-id/usb-FTDI_FT232R_USB_UART_A900beCG-if00-port0 -p 8890 -l /var/log/ebusd3.log"

# MULTIPLE EBUSD INSTANCES WITH SYSTEMD
# In order to run muiltiple ebusd instances on a systemd enabled system, just
# copy the /usr/lib/systemd/system/ebusd.service file to /etc/systemd/system/
# with a different name (e.g. ebusd-2.service), remove the line starting with
# 'EnvironmentFile=', and replace the '$EBUSD_OPTS' with the options for that
# particular ebusd instance.

3.3 Domoticz plugin

First of all, we need to upgrade to the last Domoticz Beta version:

cd domoticz
./updatebeta

Then go in the Domoticz folder for plugins :

cd plugins/

And download files :

git clone https://github.com/guillaumezin/DomoticzEbusd

Set the right permissions :

chmod ugo+x DomoticzEbusd/plugin.py

Restart Domoticz :

sudo /etc/init.d/domoticz.sh restart

Then configure it with the web interface as below :

With this configuration :

All done !