Hargassner Hargassner boiler control Modbus TCP template

Hargassner boiler control

Monitors and controls Hargassner touch-control biomass boilers via Modbus TCP.

This template connects Hargassner touch-control biomass boilers to ModbusCloud via Modbus TCP. It reads accumulator temperatures and boiler output, and provides write access to heating circuit setpoints, hot water tank targets, and room temperature specifications.

Protocol
Modbus TCP
Connection
Ethernet, Modbus TCP
Registers
48, read and write
Key readings
Accumulator Temperature Top/Middle/Bottom · Boiler Output
Available commands
Boiler temp. set value · Room temp. spec. for HC · HWT target temperature · Set temp. flow heat circuit
Compatible models
Eco-HK · Eco-PK · Nano-PK · Neo-HV · Classic · HSV · HKR
Last updated

Registers (48)

4 read, 44 write

NameUnitAccessAddress (Hidden until you enter your email)Function (hidden)Type (hidden)
Accumulator Temperatur Bottom°CRead
Accumulator Temperatur Middle°CRead
Accumulator Temperatur Top°CRead
Boiler Output%Read
Boiler temp.°CWrite
Boiler temp. - set value°CWrite
Return temperature°CWrite
Set value - return temp.°CWrite
Accum. fill levelWrite
Highest demandWrite
Temp. - external heat°CWrite
Current error numberWrite
Fuel storage levelWrite
Outside temperature°CWrite
Outside temp. - average°CWrite
External heat circuit target temp.°CWrite
Temp. - flow - heat circuit A°CWrite
Set temp. - flow - heat circuit A°CWrite
Room sensor - remote control - HC A°CWrite
Set temp. - room sensor - heat circuit A°CWrite
Status - HC AWrite
Remote Status - HC AWrite
Room temp. spec. for HC A°CWrite
Temp. - flow - heat circuit 1°CWrite
Set temp. - flow - heat circuit 1°CWrite
Room sensor - remote control - HC 1°CWrite
Set temp. - room sensor - heat circuit 1°CWrite
Status - HC 1Write
Remote Status - HC 1Write
Room temp. spec. for HC 1°CWrite
Temperature HWT A°CWrite
HWT A target temperature°CWrite
HWT A statusWrite
Temperature HWT 1°CWrite
HWT 1 target temperature°CWrite
HWT 1 statusWrite
MBUS channel 1 flow temperature°CWrite
MBUS channel 1 return temperature°CWrite
MBUS channel 1 outputWrite
MBUS channel 1 flowWrite
MBUS channel 1 energyWrite
Malfunction%Write
Pump - HC AWrite
Pump - HC 1Write
HWT A pumpWrite
HWT 1 pumpWrite
HWT A circulation pumpkWWrite
HWT 1 circulation pumpkWWrite

Loading registers…

Send your device list

If a device is not in the library yet, we build the template for free as soon as we have the register data.

Number of installations (optional)

Use cases

  • Monitor accumulator temperatures at top, middle, and bottom layers to verify buffer stratification in real time.
  • Adjust heating circuit flow temperature setpoints remotely without visiting the installation site.
  • Create an alert when boiler output drops below a threshold, indicating potential maintenance needs.
  • Log hot water tank target temperatures over time to optimize domestic hot water scheduling.
  • Compare room temperature specifications with actual values across multiple Hargassner installations from one dashboard.
  • Track boiler performance across a portfolio of biomass heating systems for energy reporting purposes.

Installation

  1. Insert the Hargassner Modbus dongle into the touch-control board and activate Modbus by setting parameter D24 on the boiler.

  2. Connect the ModbusCloud Gateway to the same local network as the Hargassner boiler via Ethernet.

  3. Configure the gateway with the boiler's IP address and the correct Modbus TCP port (typically 502).

  4. Import the Hargassner boiler control template in the ModbusCloud platform and assign it to the gateway.

  5. Verify that accumulator temperatures and boiler output values appear correctly on the ModbusCloud dashboard before leaving site.

Things to watch for

I see zero or incorrect values for accumulator temperatures. What is wrong?

The read registers for accumulator temperatures use float32 encoding, spanning two addresses each (e.g. 6149-6150). Make sure your gateway is configured for 32-bit float register reads with the correct byte order. If values still look wrong, try swapping the word order.

How do I enable Modbus on my Hargassner boiler?

You need the Hargassner Modbus dongle inserted into the touch-control board. Then activate the Modbus interface by setting parameter D24 in the boiler's configuration menu.

Which Hargassner models are compatible with this template?

The template works with all Hargassner touch-control boilers that support the Modbus dongle. Confirmed models include Eco-HK, Eco-PK, Nano-PK, Neo-HV, Classic, HSV, and HKR.

Can I write setpoints to the boiler, or is the template read-only?

The template includes write registers for boiler temperature set value, heating circuit flow temperature, hot water tank target temperature, and room temperature specification. These use uint16 encoding and allow remote adjustment from the ModbusCloud dashboard.

Want to see how it works?

Electrician working in an open distribution board