{"id":206,"date":"2023-04-19T22:49:14","date_gmt":"2023-04-19T20:49:14","guid":{"rendered":"https:\/\/gilbert.busana.lu\/?p=206"},"modified":"2025-03-10T10:10:03","modified_gmt":"2025-03-10T09:10:03","slug":"integrating-a-buderus-boiler-into-openhab","status":"publish","type":"post","link":"https:\/\/www.homeserver.lu\/?p=206","title":{"rendered":"Integrating a Buderus boiler into openHAB"},"content":{"rendered":"\n

In search to connect our Buderus boiler (heating, warm water system, hot water solar panels) to openHAB<\/a>, I stumbled over an EMS gateway<\/a> developed by a dutch engineer. <\/p>\n\n\n\n

1. Installing the EMS gateway<\/h2>\n\n\n\n

I ordered the Wifi edition and connected it via the mini-jack cable to the boiler system. The boiler system also delivers power to the gateway over this cable.<\/p>\n\n\n\n

\"\"
EMS gateway dashboard<\/figcaption><\/figure>\n\n\n\n

The connection to the WIFI network was straight forward (chapter 8.1 of the manual<\/a>) and the gateway automatically detected all the devices connected to our boiler. It immediately started displaying live data from the boiler.<\/p>\n\n\n\n

2. Setting up an MQTT broker<\/h2>\n\n\n\n

We will use MQTT<\/a> to send the boiler data to the openHAB system: the EMS gateway will send the boiler data to the MQTT broker which relays it onto the network. openHAB then needs to listen to this telegrams and interpret them.<\/p>\n\n\n\n

Installing Mosquitto in an ubuntu VM was straight forward:<\/p>\n\n\n\n

sudo apt-get install mosquitto mosquitto-clients<\/code><\/pre><\/div>\n\n\n\n
If you run the MQTT broker behind a firewall, it might not be necessary to force authentication. Entering the IP address<\/em> and port<\/em> of the MQTT broker in the gateway was straight forward. Do not forget to define a base<\/em>, a kind of a channel on which MQTT will broadcast your telegrams. I chose ems-esp<\/em>. The gateway then immediately began sending the boiler data to the broker.<\/p>\n\n\n\n
3. prepare openHAB to receive and treat the incoming data<\/h2>\n\n\n\n
3a: Go to openHAB’s administration<\/em> settings<\/em>, Add-ons: Bindings<\/em> and install the MQTT binding<\/a><\/em>.<\/p>\n\n\n\n
3b. Go to openHAB’s administration settings<\/em>, Add-ons: Other Add-ons<\/em>, Transformation Add-ons <\/em>and install the JSONPATH Transformation<\/em><\/a>.<\/p>\n\n\n\n
4. Configure openHAB to receive the MQTT telegrams<\/h2>\n\n\n\n
4a.1: From this step on, you can either add a “HomeAssistant MQTT Component<\/a>” which auto-detects all EMS things. In order for this to work, you need to activate the “MQTT Discovery (Home Assistant, Domoticz)<\/em>” in the MQTT settings<\/em> in the EMS gateway.<\/p>\n\n\n\n
4a.2: I decided to go the manual way to have full control over the things and items to add to openHAB.
You need to add an MQTT Broker bridge<\/em>. Go to the things<\/em> tab and add a thing based on the MQTT binding<\/em>. Select MQTT Broker<\/em>. Enter the IP address<\/em> of the MQTT broker. Save.<\/p>\n\n\n\n
4b. Then add a Generic MQTT Thing<\/em>. I linked it to the above created bridge. To have a better overview, I created a generic thing for the boiler, one for the warm water and one for the solar data.<\/p>\n\n\n\n
4c: Now you have to add the data points that you want to import into openHAB as items. If you don’t know which data points are available, use an MQTT Explorer to get a better insight into your data.<\/p>\n\n\n\n
\"\"
MQTT Explorer showing warm water telegrams<\/figcaption><\/figure>\n\n\n\n
\"\"
MQTT Explorer showing warm water telegrams (EMS-ESP version 3.7.1)<\/figcaption><\/figure>\n\n\n\n
4d: For each data point, you need to define a channel in openHAB. Open the MQTT generic<\/em> thing<\/em> that you created, click on the channel tab<\/em>, and click add channel<\/em>. Add the channel identifier<\/em>, the label<\/em> and select the corresponding channel type<\/em>. In our example, we select Number Value<\/em>, as we want to catch a temperature value.<\/p>\n\n\n\n
\"\"
First step creating the channel<\/figcaption><\/figure>\n\n\n\n
The MQTT State Topic<\/em>‘s first part is the base<\/em> that you defined in the MQTT broker settings in the EMS gateway. In our case: ems-esp<\/em>. The second part of the topic<\/a> gives more details about the object you want to catch. Your MQTT explorer will help you determine which information telegrams are available.<\/p>\n\n\n\n
In order to precise which value of the current object you want to import, you have to click the Show advanced<\/em> check box.<\/p>\n\n\n\n
\"\"
Second step to precise the value you want to catch<\/figcaption><\/figure>\n\n\n\n
As the object information is received in JSON<\/a> format, you have to use JSONPATH<\/a> Transformation<\/a> to catch the exact value that you need (do not forget to install the JSONPATH tranformation, see 3b above). In our case, enter JSONPATH:$.curflowtemp<\/em> under Transformation Values: Incoming Value transformations.<\/em> This will extract the value for the current flow temperature<\/em> object in the ems-esp\/boiler_data <\/em>telegram. As this is a temperature, you can add the Unit of Measurement<\/em> if you want. In our case it is in Celsius degrees, so we add \u00b0C<\/em> here.
Click CREATE<\/em> if you have entered all the necessary information.<\/p>\n\n\n\n
Note: Since EMS-ESP firmware version 3.6.5<\/a>, the data structure has partially changed. The boiler_data_ww<\/em> does not stipulate WW<\/em> anymore, but it adds a nested folder called DHW<\/em>. Adapt the JSONPATH like this: JSONPATH:$.dhw.flowtempoffset<\/em> .<\/p>\n\n\n\n
Now you have to link the channel to an item (click: Add link to Item<\/em>). This is standard openHAB procedure. As soon as you save the item that you created\/linked, the value will show up!<\/p>\n\n\n\n
You have to repeat the step 4d for each data point you want to import.<\/p>\n","protected":false},"excerpt":{"rendered":"
In search to connect our Buderus boiler (heating, warm water system, hot water solar panels) to openHAB, I stumbled over an EMS gateway developed by a dutch engineer. 1. Installing the EMS gateway I ordered the Wifi edition and connected it via the mini-jack cable to the boiler system. The boiler system also delivers power […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[22,5,21,7],"tags":[],"class_list":["post-206","post","type-post","status-publish","format-standard","hentry","category-ems_bus","category-iot","category-mqtt","category-openhab"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/posts\/206","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=206"}],"version-history":[{"count":57,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/posts\/206\/revisions"}],"predecessor-version":[{"id":1213,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=\/wp\/v2\/posts\/206\/revisions\/1213"}],"wp:attachment":[{"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=206"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=206"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.homeserver.lu\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=206"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}