blog/data/2022-03-12-hargassner-mqtt.txt

   1 Title: Publish Hargassner wood chip boiler state to MQTT
   2 Tags: english
   3 Date: 2022-03-12 06:30
   4
   5 <p>Recently I had a look at a
   6 <a href="https://www.hargassner.at/">Hargassner</a>
   7 <a href="https://www.hargassner.at/en/products/wood-chip-boiler.html">wood
   8 chip boiler</a>, and what kind of free software can be used to monitor
   9 and control it.  The boiler can be connected to some cloud service via
  10 what the producer call an Internet Gateway, which seem to be a
  11 computer connecting to the boiler and passing the information gathered
  12 to the cloud.  I discovered the boiler controller got an IP address on
  13 the local network and listen on TCP port 23 to provide status
  14 information as a text line of numbers.  It also provide a HTTP server
  15 listening on port 80, but I have not yet figured out what it can do
  16 beside return an error code.</p>
  17
  18 <p>If I am to believe various free software implementations talking to
  19 such boiler, the interpretation of the line of numbers differ between
  20 type of boiler and software version on the boiler.  By comparing the
  21 list of numbers on the front panel of the boiler with the numbers
  22 returned via TCP, I have been able to figure out several of the
  23 numbers, but there are a lot left to understand.  I've located several
  24 temperature measurements and hours running values, as well as oxygen
  25 measurements and counters.</p>
  26
  27 I decided to write a simple parser in Python for the values I figured
  28 out so far, and a simple MQTT injector publishing both the interpreted
  29 and the unknown values on a MQTT bus to make collecting and graphing
  30 simpler.  The end result is available from the
  31 <a href="https://gitlab.com/petterreinholdtsen/hargassner2mqtt">hargassner2mqtt
  32 project page</a> on gitlab.  I very much welcome patches extending the
  33 parser to understand more values, boiler types and software versions.
  34 I do not really expect very few free software developers got their
  35 hands on such unit to experiment, but it would be fun if others too find
  36 this project useful.</p>
  37
  38 <p>As usual, if you use Bitcoin and want to show your support of my
  39 activities, please send Bitcoin donations to my address
  40 <b><a href="bitcoin:15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b">15oWEoG9dUPovwmUL9KWAnYRtNJEkP1u1b</a></b>.</p>