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

For Part 2 you will either need two seperate machines, one with the ebusd configured in part 1 and a second with the LAMP stack installed. Or you can just have one machine with both, however I would suggest you use the Raspberry PI 2 or better or use a Raspberry PI for the ebus interface and ebusd software and a 2nd faster machine running Debian or Ubuntu for the Web/MySQL server with the full LAMP stack installed.

1) git clone https://github.com/john30/vwmon
2) cd vwmon
3) gcc vwmon-client.c httpfetcher.c httperror_codes.c -o vwmon-client
4) mkdir /usr/bin/vwmon
5) cp vwmon-client /usr/bin/vwmon
6) mkdir /etc/vwmon
7) cp vwmon-client.cfg /etc/vwmon
8) Now edit vwmon-clieng.cfg. You now need to change the following values:

ErrorEmail (Your email address to send errors to, you need to install and configure postfix to relay emails first!),
VWMonServer
URL (URL of the server with Apache/LAMP stack installed and php configured), VWMonServer_Key (this server key is a passcode that needs to match the key in vwmon-server.php, so you need to change the key in both!)

At the bottom are commands for your device that will be queried. These will need to be amended for your own devices. HINT: look at your csv files. However, the same named field needs to exist in your MySQL Database table vwmon_history. So if you change the name you need to add/change the field in that table as well otherwise it won't work.

9) Import the sql database file into MySQL. You will need to create the vwmon database and give the vwmon user permissions to read and write to it. Then import the sql database from

10) Now run vwmon-client to test with verbose output:

/usr/bin/vwmon/vwmon-client -v -c /etc/vwmon/vwmon-client.cfg -r 0

11) Now, if everything has been configured correctly, ebusd should now be run by vwmon-client and you should get data in the MySQL table. If it all works, you can then let it run in the background:

/usr/bin/vwmon/vwmon-client -c /etc/vwmon/vwmon-client.cfg &

You will want to configure vwmon-client to start at boot time, perhaps via a cron job.

12) Now you want to copy the vwmon-control.php and vwmon-server.php files to your web server, the one you specified in the vwmon-client.cfg file. You will need to edit the php files to enter the correct information such as

$dbhost, $dbname, $dbuser, $dbpass, mypass (you need to set passwords for user1 and user2 or it will fail)

$serverkey (Set it to the same key that you set on vwmon-client.cfg)

Then in your Web Browser enter the URL:

http://yourservername/vwmon-control.php

Then enter your credentials you set.

comments powered by Disqus