husdata-h66-modbus documentation
- Author:
Jonny Bergdahl
- Date:
2026-11-15
- Version:
0.1.2
husdata-h66-modbus
Async Python library for the Modbus TCP interface of the Husdata H66 heat pump gateway.
It is built on
modbus-connection,
the Modbus layer Home Assistant uses from 2026.9. The library never
opens a connection itself: you give it a ModbusUnit, either from
modbus_connection or from Home Assistant’s async_get_unit. It
has no Home Assistant dependency.
Tested with an H66 on firmware 360801 connected to an IVT Greenline (Rego 600 controller).
Installation
pip install husdata-h66-modbus
Add the cli extra to get the pymodbus backend and the
husdata-h66 command line tool:
pip install "husdata-h66-modbus[cli]"
Documentation
The full library documentation can be found here.
Enable Modbus on the H66
Modbus TCP is off by default. On the H66 web page, open Config >
Modbus, set MODBUS_PORT to 502 and restart the H66.
MODBUS_IP can limit which client may connect. The H66 accepts only
one Modbus client at a time.
Usage
import asyncio
from modbus_connection import ModbusTcpParams
from modbus_connection.pymodbus import ModbusConnection
from husdata_h66 import HusdataH66
async def main() -> None:
connection = ModbusConnection(ModbusTcpParams(host="h66.local"))
try:
device = HusdataH66(connection.for_unit(1))
await device.async_update()
print(device.get("outdoor")) # 3.5 (°C)
print(device.get("compressor")) # True
print(device.values) # everything, keyed by register key
await device.async_set("room_setpoint", 21.5)
finally:
await connection.close()
asyncio.run(main())
In Home Assistant, pass the unit from async_get_unit instead:
unit = async_get_unit(
hass, entry, ModbusTcpParams(host=entry.data[CONF_HOST]), entry.data[CONF_UNIT_ID]
)
entry.runtime_data = HusdataH66(unit)
async_update() reads all registers in three requests and returns an
UpdateReport. It raises ModbusConnectionError or
ModbusTimeoutError when the gateway cannot be reached.
async_set() takes the value in the register’s own unit and checks it
against the register’s range and step. It raises ValueError for an
invalid value and AttributeError for a read-only register.
async_reset_alarm() writes 0 to Alarm reset, which turns the
heat pump off for 10 seconds and then on again.
From the command line (read-only):
husdata-h66 h66.local
Register map
The H66 numbers its Modbus registers one per parameter, in the order its home page lists them. Read-only parameters are INPUT registers, settings are HOLDING registers, and every register is a signed or unsigned 16-bit value. The addresses depend on the heat pump controller and can move after a firmware update or when you add custom registers in the H66.
REGO600_REGISTERS is the default map, for a Rego 600 controller on
firmware 360801. To follow the H66 instead, fetch its home page and
parse it:
from husdata_h66 import HusdataH66, parse_firmware_version, parse_registers
page = await (await session.get("http://h66.local/")).text()
device = HusdataH66(unit, parse_registers(page))
husdata-h66 h66.local --from-web does the same from the command
line.
Each parameter has a Husdata variable ID. Its first hex digit gives the type and scaling:
First digit |
Type |
Scale |
Unit |
|---|---|---|---|
0 |
Temperature |
0.1 |
°C |
1 |
Status |
1 |
on/off |
2 |
Number |
0.1 |
|
3 |
Percent |
0.1 |
% |
5 |
Energy |
0.1 |
kWh |
6 |
Hours |
1 |
h |
7 |
Minutes |
1 |
min |
B |
Integer |
1 |
|
C |
Power |
1 |
W |
Temperatures and numbers are signed, the others unsigned. A temperature
sensor that isn’t connected reads None (the H66 shows −48.3 °C).
Rego 600 (default map)
Address |
Type |
ID |
Key |
Range |
|---|---|---|---|---|
0 |
Input |
0001 |
|
|
1 |
Input |
0002 |
|
|
2 |
Input |
0003 |
|
|
3 |
Input |
0004 |
|
|
4 |
Input |
0005 |
|
|
5 |
Input |
0006 |
|
|
6 |
Input |
0007 |
|
|
7 |
Input |
0008 |
|
|
8 |
Input |
0009 |
|
|
9 |
Input |
000A |
|
|
10 |
Input |
000B |
|
|
11 |
Input |
3104 |
|
|
12 |
Input |
0107 |
|
|
13 |
Input |
0111 |
|
|
14 |
Holding |
0203 |
|
5–29 °C |
15 |
Holding |
2204 |
|
|
16 |
Holding |
2205 |
|
0–10 |
17 |
Holding |
0207 |
|
−10–10 °C |
18 |
Holding |
0208 |
|
20–60 °C |
19 |
Holding |
020B |
|
2–15 °C |
20 |
Holding |
7209 |
|
0–1440 min |
21 |
Holding |
1215 |
|
on/off |
22 |
Holding |
B21B |
|
1 (3 kW), 2 (6 kW) or 4 (9 kW) |
23 |
Holding |
1233 |
|
on/off, write-only |
24 |
Holding |
020A |
|
0–30 °C |
25 |
Holding |
2210 |
|
0–30 days |
26 |
Holding |
12F2 |
|
write 0 to reset |
27 |
Input |
1A01 |
|
|
28 |
Input |
1A02 |
|
|
29 |
Input |
1A03 |
|
|
30 |
Input |
1A04 |
|
|
31 |
Input |
1A05 |
|
|
32 |
Input |
1A06 |
|
|
33 |
Input |
1A07 |
|
off: heating, on: hot water |
34 |
Input |
1A20 |
|
|
35 |
Input |
BA91 |
|
last alarm, see below |
36 |
Input |
6C55 |
|
|
37 |
Input |
6C56 |
|
|
38 |
Input |
6C58 |
|
|
39 |
Input |
6C59 |
|
|
40 |
Input |
CFAA |
|
|
41 |
Input |
5FAB |
|
power_consumption and accumulated_consumption are calculated by
the H66 from the wattages set for each status variable on its web page.
accumulated_consumption restarts at 0 when the H66 boots.
The meanings and ranges come from Husdata’s variable list for Rego 600/637. Some details from it:
alarm_codeis the last alarm that triggered, even if no alarm is active now.alarm_text(code)andALARM_CODESgive its description.external_controlis write-only: the value read back means nothing. Husdata warns it can behave unpredictably on a Rego 600.electric_heater_allowedtakes effect the next time the electric heater would start.holiday_modeis in whole days, stored unscaled (unlike the other 2xxx numbers, which are ×10). While it is active, set it to 0 before setting a new value.extra_hot_water: on a Rego 600, a value written over Modbus shows on the H66 web page for about 20 seconds and is then reset to 0, and no hot water production starts. How to set it is still unknown.
Not yet verified: room_sensor_influence is read unscaled because the
H66 web page shows it that way.
Alarm codes
Code |
Alarm |
|---|---|
1 |
Sensor radiator return (GT1) |
2 |
Outdoor sensor (GT2) |
3 |
Sensor hot water (GT3) |
4 |
Mixing valve sensor (GT4) |
5 |
Room sensor (GT5) |
6 |
Sensor compressor (GT6) |
7 |
Sensor heat fluid out (GT8) |
8 |
Sensor heat fluid in (GT9) |
9 |
Sensor cold fluid in (GT10) |
10 |
Sensor cold fluid out (GT11) |
11 |
Compressor circuit switch |
12 |
Electrical cassette |
13 |
Pump circuit switch (MB2) |
14 |
Low pressure switch (LP) |
15 |
High pressure switch (HP) |
16 |
High return HP (GT9) |
17 |
Heat carrier out max (GT8) |
18 |
Brine in under limit (GT10) |
19 |
Brine out under limit (GT11) |
20 |
Compressor superheat (GT6) |
21 |
3-phase incorrect order |
22 |
Power failure |
23 |
Heat delta exceeded |
Development
uv sync
uv run pytest
uv run ruff check src tests
build.sh publishes a release: it converts this README to
README.rst, builds the documentation, copies it to the
jonnybergdahl.github.io repository and pushes it, then builds the
package and uploads it to PyPI.
License
MIT
Contents: