Hoval TopTronic E Heating Circuit Module
Hoval module for three heating circuits and hot water with temperatures, pumps, status and setpoints over Modbus TCP.
The Hoval TopTronic E Heating Circuit Module is a controller module that runs up to three heating circuits and a hot water circuit in Hoval TopTronic E systems for buildings, boiler plants and greenhouses. This Modbus TCP template reads flow, return, room and hot water temperatures, pump and circuit status through the Hoval Modbus gateway and writes operating modes, setpoints and heating curves from ModbusCloud.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 178, read and write
- Brand
- Hoval
- Key readings
- Outdoor temperature · Flow and return temperature · Room temperature and setpoint · Hot water temperature · Pump and mixer state · Heating circuit status · Active errors
- Available commands
- Operation choice · Room setpoints · Constant flow setpoints · Hot water setpoint · Heating curve · Hardware outputs
- Compatible models
- TopTronic E heating circuit/hot water module (HKW)
- Last updated
Registers (178)
178 read, 90 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| Outdoor Temperature AF1 | °C | Read | |||
| Outdoor Temperature AF2 | °C | Read | |||
| Heating Circuit 1 Room Temperature | °C | Read and write | |||
| Heating Circuit 1 Flow Temperature | °C | Read | |||
| Heating Circuit 1 Return Temperature | °C | Read | |||
| Heating Circuit 1 Room Setpoint | °C | Read | |||
| Heating Circuit 1 Flow Setpoint | °C | Read | |||
| Heating Circuit 2 Room Temperature | °C | Read and write | |||
| Heating Circuit 2 Flow Temperature | °C | Read | |||
| Heating Circuit 2 Return Temperature | °C | Read | |||
| Heating Circuit 2 Room Setpoint | °C | Read | |||
| Heating Circuit 2 Flow Setpoint | °C | Read | |||
| Heating Circuit 3 Room Temperature | °C | Read and write | |||
| Heating Circuit 3 Flow Temperature | °C | Read | |||
| Heating Circuit 3 Return Temperature | °C | Read | |||
| Heating Circuit 3 Room Setpoint | °C | Read | |||
| Heating Circuit 3 Flow Setpoint | °C | Read | |||
| Hot Water Temperature SF | °C | Read | |||
| Circulation Temperature | °C | Read | |||
| Hot Water Setpoint | °C | Read | |||
| Plant Flow Temperature FAV | °C | Read | |||
| Plant Flow Setpoint FAV | °C | Read | |||
| Info Sensor 1 | °C | Read | |||
| Info Sensor 2 | °C | Read | |||
| Info Sensor 3 | °C | Read | |||
| Info Sensor 4 | °C | Read | |||
| Info Sensor 5 | °C | Read | |||
| Info 1 0-10V | Read | ||||
| Info 2 0-10V | Read | ||||
| Info 3 0-10V | Read | ||||
| Heating Circuit 1 Pump | Read | ||||
| Heating Circuit 1 Mixer | % | Read | |||
| Heating Circuit 1 Status | Read | ||||
| Heating Circuit 2 Pump | Read | ||||
| Heating Circuit 2 Mixer | % | Read | |||
| Heating Circuit 2 Status | Read | ||||
| Heating Circuit 3 Pump | Read | ||||
| Heating Circuit 3 Mixer | % | Read | |||
| Heating Circuit 3 Status | Read | ||||
| Hot Water Circulation Pump | Read | ||||
| Hot Water Charging Pump | Read | ||||
| Hot Water Charging Pump (Duplicate) | Read | ||||
| Hot Water Status | Read | ||||
| AVP Pump | Read | ||||
| YAV Mixer | % | Read | |||
| Heating Circuit 1 Operation Choice | Read and write | ||||
| Heating Circuit 1 Normal Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 1 Eco Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 1 Normal Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 1 Eco Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 1 Manual Mode Set Temperature | °C | Read and write | |||
| Heating Circuit 1 Constant Flow Setpoint Heating | °C | Read and write | |||
| Heating Circuit 1 Constant Flow Setpoint Cooling | °C | Read and write | |||
| Heating Circuit 2 Operation Choice | Read and write | ||||
| Heating Circuit 2 Normal Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 2 Eco Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 2 Normal Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 2 Eco Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 2 Manual Mode Set Temperature | °C | Read and write | |||
| Heating Circuit 2 Constant Flow Setpoint Heating | °C | Read and write | |||
| Heating Circuit 2 Constant Flow Setpoint Cooling | °C | Read and write | |||
| Heating Circuit 3 Operation Choice | Read and write | ||||
| Heating Circuit 3 Normal Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 3 Eco Room Temperature Heating | °C | Read and write | |||
| Heating Circuit 3 Normal Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 3 Eco Room Temperature Cooling | °C | Read and write | |||
| Heating Circuit 3 Manual Mode Set Temperature | °C | Read and write | |||
| Heating Circuit 3 Constant Flow Setpoint Heating | °C | Read and write | |||
| Heating Circuit 3 Constant Flow Setpoint Cooling | °C | Read and write | |||
| Hot Water Operation Choice | Read and write | ||||
| Normal Hot Water Temperature | °C | Read and write | |||
| Eco Hot Water Temperature | °C | Read and write | |||
| Heating Circuit 1 Heating Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Curve Base Point Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 1 Heating Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 1 Heating Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Heating Limit Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 1 Control Strategy | Read and write | ||||
| Heating Circuit 1 Cooling Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Summer Compensation Start Point | °C | Read and write | |||
| Heating Circuit 1 Cooling Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 1 Cooling Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Heat Generator Flow Setpoint Offset | K | Read and write | |||
| Heating Circuit 1 Minimum Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Maximum Flow Temperature | °C | Read and write | |||
| Heating Circuit 1 Minimum Flow Temperature Cooling | °C | Read and write | |||
| Heating Circuit 2 Heating Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Curve Base Point Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 2 Heating Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 2 Heating Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Heating Limit Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 2 Control Strategy | Read and write | ||||
| Heating Circuit 2 Cooling Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Summer Compensation Start Point | °C | Read and write | |||
| Heating Circuit 2 Cooling Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 2 Cooling Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Heat Generator Flow Setpoint Offset | K | Read and write | |||
| Heating Circuit 2 Minimum Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Maximum Flow Temperature | °C | Read and write | |||
| Heating Circuit 2 Minimum Flow Temperature Cooling | °C | Read and write | |||
| Heating Circuit 3 Heating Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Curve Base Point Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 3 Heating Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 3 Heating Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Heating Limit Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 3 Control Strategy | Read and write | ||||
| Heating Circuit 3 Cooling Curve Base Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Summer Compensation Start Point | °C | Read and write | |||
| Heating Circuit 3 Cooling Curve Design Outdoor Temperature | °C | Read and write | |||
| Heating Circuit 3 Cooling Curve Design Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Heat Generator Flow Setpoint Offset | K | Read and write | |||
| Heating Circuit 3 Minimum Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Maximum Flow Temperature | °C | Read and write | |||
| Heating Circuit 3 Minimum Flow Temperature Cooling | °C | Read and write | |||
| Hot Water Switch-On Differential | K | Read and write | |||
| Hot Water Charging Setpoint Increase | K | Read and write | |||
| Hot Water Charging Priority | h | Read and write | |||
| Hot Water Pump Follow-On Time | min | Read and write | |||
| Hot Water Discharge Protection | Read and write | ||||
| Maximum Hot Water Charging Time | h | Read and write | |||
| VA1 Output | Read and write | ||||
| VA2 Output | Read and write | ||||
| VA3 Output | Read and write | ||||
| VA1-FE1 Output | Read and write | ||||
| VA2-FE1 Output | Read and write | ||||
| VA3-FE1 Output | Read and write | ||||
| VA1-FE2 Output | Read and write | ||||
| VA2-FE2 Output | Read and write | ||||
| VA3-FE2 Output | Read and write | ||||
| VA 0-10V/PWM Output | % | Read and write | |||
| VA 0-10V/PWM FE1 Output | % | Read and write | |||
| VA 0-10V/PWM FE2 Output | % | Read and write | |||
| Relay Test Active | Read | ||||
| Active Error 1 Appearance Time | Read | ||||
| Active Error 1 Appearance Date | Read | ||||
| Active Error 1 Disappear Time | Read | ||||
| Active Error 1 Disappear Date | Read | ||||
| Active Error 1 Source | Read | ||||
| Active Error 1 Function Group | Read | ||||
| Active Error 1 Function Number | Read | ||||
| Active Error 1 Error Type | Read | ||||
| Active Error 1 Error Code | Read | ||||
| Active Error 2 Appearance Time | Read | ||||
| Active Error 2 Appearance Date | Read | ||||
| Active Error 2 Disappear Time | Read | ||||
| Active Error 2 Disappear Date | Read | ||||
| Active Error 2 Source | Read | ||||
| Active Error 2 Function Group | Read | ||||
| Active Error 2 Function Number | Read | ||||
| Active Error 2 Error Type | Read | ||||
| Active Error 2 Error Code | Read | ||||
| Active Error 3 Appearance Time | Read | ||||
| Active Error 3 Appearance Date | Read | ||||
| Active Error 3 Disappear Time | Read | ||||
| Active Error 3 Disappear Date | Read | ||||
| Active Error 3 Source | Read | ||||
| Active Error 3 Function Group | Read | ||||
| Active Error 3 Function Number | Read | ||||
| Active Error 3 Error Type | Read | ||||
| Active Error 3 Error Code | Read | ||||
| Active Error 4 Appearance Time | Read | ||||
| Active Error 4 Appearance Date | Read | ||||
| Active Error 4 Disappear Time | Read | ||||
| Active Error 4 Disappear Date | Read | ||||
| Active Error 4 Source | Read | ||||
| Active Error 4 Function Group | Read | ||||
| Active Error 4 Function Number | Read | ||||
| Active Error 4 Error Type | Read | ||||
| Active Error 4 Error Code | Read | ||||
| Active Error 5 Appearance Time | Read | ||||
| Active Error 5 Appearance Date | Read | ||||
| Active Error 5 Disappear Time | Read | ||||
| Active Error 5 Disappear Date | Read | ||||
| Active Error 5 Source | Read | ||||
| Active Error 5 Function Group | Read | ||||
| Active Error 5 Function Number | Read | ||||
| Active Error 5 Error Type | Read | ||||
| Active Error 5 Error Code | Read |
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.
Use cases
- Show flow, return and room temperature of each heating circuit next to its setpoint to see which zone or greenhouse section falls short.
- Get an alert when a heating circuit or the hot water control reports a fault, or when a flow temperature drops below a threshold.
- Keep a 365-day history of flow temperatures and pump states to check the heating curve after a cold week.
- Switch a heating circuit to constant mode and adjust its room or flow setpoint remotely once writing is enabled.
- Lower room setpoints at night or at weekends with an automation on a time schedule.
Installation
Connect the Hoval Modbus gateway of the TopTronic E system to the same network as the ModbusCloud Gateway and give it a fixed IP address.
Check the address of the heating circuit module on its DIP switch or on the TopTronic E operating module. This template is for module address 1.
In ModbusCloud, add a Modbus device with Modbus TCP, the IP address of the Hoval gateway, port 502 and unit ID 1, then import this template.
Check that the flow temperature of a heating circuit in use shows a plausible value. Circuits and sensors that are not installed may not answer.
Keep the reading interval at the default 5 minutes. Hoval advises longer intervals as the number of requests to its gateway grows.
Things to watch for
The Hoval gateway does not answer. What should I check?
Check that the ModbusCloud Gateway reaches the IP address of the Hoval Modbus gateway, and use port 502 and unit ID 1. The Hoval gateway has to be registered in the HovalConnect app. Data points of circuits, sensors or modules that are not installed can time out.
How do I read a second heating circuit module?
Every module has its own address on the TopTronic E bus, set with its DIP switch and shown on the operating module. In the Hoval Modbus data point list the module with address n is HKW UnitId 256 plus n, so address 2 is UnitId 258, with its own register addresses and no fixed offset. Make your own template in ModbusCloud with the addresses Hoval lists for that UnitId.
Why does a setpoint I write have no effect?
Writing is off per gateway until you request it in the portal. Room setpoints only apply when Operation Choice of the circuit is 4 (constant), and the hot water setpoint works the same way. Constant flow setpoints need basic settings by Hoval service first. A written value stays active until a new one is written.
Can I switch the hardware outputs from ModbusCloud?
The VA output registers are writable, and writing one switches that relay or 0-10 V output of the module. Only write them when you know what is connected to the output, for example during a relay test with the heating installer.
How often should ModbusCloud read the Hoval gateway?
The default of every 5 minutes is a good choice. Hoval warns that its Modbus gateway can lock up when it gets too many requests. If you only need a few values, make your own template with just those registers.
Want to see how it works?
