Vaillant eBUSd - Central Heating & Boiler Control (Part 1)

1) You need an ebus to RS232/USB interface such as the one I bought here:
2) You need to connect it to a PC or Raspberry Pi which is Linux-based, preferably Debian or Ubuntu.
3) Connect the USB device, it should mount to /dev/tty/USB0
4) Ensure the driver module is activated by running:
modprobe -v ftdi_sio
5) There are Debian Install packages already compiled for eBUSD, however I prefer to compile my own from the latest source code, so see below:
6) You need to ensure the following packages/features are installed:
autoconf (>=2.63)
automake (>=1.11)
kernel with pselect or ppoll support
glibc with argp support or argp-standalone

This is done by the following:

apt-get install autoconf automake gcc make

7) Now download the source via git and enter the ebusd directory:
git clone
cd ebusd
8) Run ./ to have the directory structure created in /usr/bin/ebusd otherwise you can change the location such as below:

./ --prefix=/usr/local 9) Now compile the source simply by typing:
make install.

This will also create the init scripts so you can have the daemon running at startup, if you choose to.

There now seems to be a make script in the source so I ran ./ What this does is compiles the package into a .deb package for installing via dpkg -i ebusd-1.2.0armhf.deb. I did it this way instead.

10) Now you can run it by typing the following and to get the command syntax:

ebusd --help

11) Now, you want to scan your ebus interface and to get details of your devices. This will help you locate the correct CSV files for your devices.

ebusctl scan full

After a few mins, type in the following and you should see the result of the scan showing your devices:

15;Vaillant;UI ;0501;6201

In the example above the devices are called BAI00 and UI. So now I will want to look for csv's with those devices names such as bai.csv and ui.csv

12) Run the following to get a source of the latest ebusd-configuration (includes the csv's):

git clone
cd ebusd-configuration

13) Now copy the csv file for your devices in your scan result to the ebusd configuration directory:

In my case:

cd ebusd-1.x.x/vaillant_de

cp 350.csv bai.csv common.csv _templates.csv common.csv broadcast.csv /etc/ebusd

^ You will need the last 4 csv files regardless of your scan result, although broadcast.csv may already be included, however I like to make sure it's up to date.

14) For more information please visit

comments powered by Disqus