Home Automation Integration #
The ClimateControl module is designed for flexibility, offering native support for various platforms via MQTT and a HTTP REST API.
- Home Assistant: Experience seamless “plug-and-play” integration using the built-in Auto Discovery feature.
- Homey: Use the community developed ClimateControl app from the Homey app store.
- Other systems: The module is widely used with systems including Loxone, Nodered and other custom automation platforms. For these platforms, use either MQTT or HTTP REST API for communication.
MQTT Client
ClimateControl functions as a MQTT client and requires a connection to an MQTT broker (such as Mosquitto).
- Compatibility: Supports both MQTT v5 and v3.1.1.
- Setup: Enter your broker’s URL, port and credentials via the local web interface.
- Security Note: Secure MQTT (TLS/SSL) is currently not supported.
- Topic Base: /climacontrol/HVAC_XXXXXX
- Retain: topic retain flag is enabled
Note: While alle possible commands are listed below, some might not be available on your unit.
MQTT Command Reference
Reading
Settings and status can be read from the base topic + specific topic.
For example: /climacontrol/HVAC_XXXXXX/heatpump/power
Writing
Settings can be changed using the base topic + specific topic + set.
For example: /climacontrol/HVAC_XXXXXX/heatpumpt/power/set -> on
Status / Sensors
| Description | Value | Endpoint |
|---|---|---|
| Restart ClimateControl | any value | device/command/restart |
| Zone 1 room temperature setpoint | float, 10–30°C | heatpump/zone1/room_target_temperature/set |
| Zone 2 room temperature setpoint | float, 10–30°C | heatpump/zone2/room_target_temperature/set |
| Zone 1 flow target temperature | float, 5–60°C | heatpump/zone1/flow_target_temperature/set |
| Zone 2 flow target temperature | float, 5–60°C | heatpump/zone2/flow_target_temperature/set |
| DHW (hot water) target temperature | float | heatpump/dhw/flow_target_temperature/set |
| DHW mode | normal, eco | heatpump/dhw/mode/set |
| DHW force (boost hot water now) | on, off | heatpump/dhw/forced_active/set |
| Holiday mode | on, off | heatpump/holiday_mode/set |
| Power | on, off | heatpump/power/set |
| Zone 1 operation mode | off HEAT_ROOM_TEMP HEAT_FLOW_TEMP HEAT_COMPENSATION_CURVE COOL_ROOM_TEMP COOL_FLOW_TEMP FLOOR_DRYUP | heatpump/zone1/mode/set |
| Zone 2 operation mode | same set as above | heatpump/zone2/mode/set |
| Prohibit DHW | on, off | heatpump/prohibit/dhw/set |
| Prohibit Zone 1 heating | on, off | heatpump/prohibit/heating_zone1/set |
| Prohibit Zone 1 cooling | on, off | heatpump/prohibit/cooling_zone1/set |
| Prohibit Zone 2 heating | on, off | heatpump/prohibit/heating_zone2/set |
| Prohibit Zone 2 cooling | on, off | heatpump/prohibit/cooling_zone2/set |
| Prohibit server control | on, off | heatpump/prohibit/server_control/set |
Controls
| Description | Value | Endpoint |
|---|---|---|
| Controller date/time | string (YYYY-MM-DD HH:MM:SS) | heatpump/controller_datetime |
| Power | on, off | heatpump/power |
| Operating state | off, dhw_on, heat_on, cool_on, frost_protect, legionella_prevention | heatpump/operation |
| Holiday mode | on, off | heatpump/holiday_mode |
| Controller firmware version | integer | heatpump/controller_version |
| Fault code | string | heatpump/fault_code |
| Multizone status | integer | heatpump/multizone_status |
| Defrost active | true, false | heatpump/defrost_active |
| Compressor on | true, false | heatpump/compressor_on |
| Compressor frequency | Hz | heatpump/compressor_frequency |
| Heat source | integer (enum) | heatpump/heat_source |
| Output power | kW | heatpump/output_power |
| Indicative output power | kW | heatpump/indicative_output_power |
| Runtime | hours | heatpump/runtime |
| Primary flow rate | L/min | heatpump/flowrate |
Temperatures & water circuit
| Description | Value | Endpoint |
|---|---|---|
| Outside air temperature | °C | heatpump/outside_temperature |
| Feed temperature | °C | heatpump/feed_temperature |
| Return temperature | °C | heatpump/return_temperature |
| Boiler flow temperature | °C | heatpump/boiler_flow_temperature |
| Boiler return temperature | °C | heatpump/boiler_return_temperature |
| Mixing tank temperature | °C | heatpump/mixing_tank_temperature |
| Max/min allowed flow temperature | °C | heatpump/max_flow_temperatureheatpump/min_flow_temperature |
| Refrigerant liquid / condensing temperature | °C | heatpump/refrigerant_liquid_temperatureheatpump/refrigerant_condensing_temperature |
| Advanced refrigerant circuit diagnostics (discharge, suction, heat-sink, compressor surface, subcool, superheat temps) | °C | heatpump/rcdischargeTempheatpump/rcouliquidpipetempheatpump/rcoutwoPhasepipetempheatpump/rcousuctionpipetempheatpump/rcouheatsinktempheatpump/rcoucompressorsurfacetemp heatpump/rcdischargesuperheattempheatpump/rcsubcooltemp |
Actuators / inputs
| Description | Value | Endpoint |
|---|---|---|
| Water pump 1/2/3 active | true, false | heatpump/waterpump_activeheatpump/waterpump2_activeheatpump/waterpump3_active |
| Three-way valve 1/2 active | true, false | heatpump/threeway_valve_activethreeway_valve2_active |
| Mixing valve step / status | integer | heatpump/mixing_valve_stepheatpump/mixing_valve_status |
| Booster active | true, false | heatpump/booster_active |
| Immersion heater active | true, false | heatpump/immersion_active |
| IN1/IN5/IN6 thermostat request | true, false | heatpump/in1_thermostat_requestin5_thermostat_requestin6_thermostat_request |
| DIP switch positions (SW1–SW6) | binary string | heatpump/dipswitch/sw1 … sw6 |
Zone 1 / Zone 2 (same set for each zone, zone1/zone2)
| Description | Value | Endpoint |
|---|---|---|
| Room temperature | °C | heatpump/zone{1,2}/room_temperature |
| Room target temperature | °C | heatpump/zone{1,2}/room_target_temperature |
| Flow target temperature | °C | heatpump/zone{1,2}/flow_target_temperature |
| Feed / return temperature | °C | heatpump/zone{1,2}/feed_temperatureheatpump/zone{1,2}/return_temperature |
| Operation mode | HEAT_ROOM_TEMP HEAT_FLOW_TEMP HEAT_COMPENSATION_CURVE COOL_ROOM_TEMP COOL_FLOW_TEMP FLOOR_DRYUP | heatpump/zone{1,2}/mode |
DHW (hot water)
| Description | Value | Endpoint |
|---|---|---|
| DHW temperature (primary/secondary) | °C | heatpump/dhw/temperatureheatpump/dhw/temperature_secondary |
| DHW target temperature | °C | heatpump/dhw/flow_target_temperature |
| Legionella prevention target temp | °C | heatpump/dhw/legionella_prevention_target_temp |
| Flow temperature drop | °C | heatpump/dhw/flow_temperature_drop |
| DHW mode | normal, eco | heatpump/dhw/mode |
| DHW force active | on, off | heatpump/dhw/forced_active |
Prohibit flags & energy
| Description | Value | Endpoint |
|---|---|---|
| Prohibit DHW / Z1 heating / Z1 cooling / Z2 heating / Z2 cooling / server control | on, off | heatpump/prohibit/dhwheatpump/prohibit/heating_zone1heatpump/prohibit/cooling_zone1heatpump/prohibit/heating_zone2heatpump/prohibit/cooling_zone2heatpump/prohibit/server_control |
| Energy consumed (heating/cooling/DHW) | kWh | heatpump/energy/consumed_heatingconsumed_coolingconsumed_dhw |
| Energy delivered (heating/cooling/DHW) | kWh | heatpump/energy/delivered_heatingdelivered_coolingdelivered_dhw |
HTTP REST API
For direct control and status monitoring, you can interface with the module via standard HTTP requests.
- Status Inquiry: Perform a
GETrequest to: http://heatpump.local/control - Response: Returns a JSON string containing module, heat pump, and sensor telemetry.
HTTP Command Reference
| Description | Value | Example |
|---|---|---|
| Restart ClimateControl | no value needed | ?cmd=restart |
| Room temperature setpoint | zone:temperatureZone is: – zone1– zone2– bothTemperature is: – float, 0–100 | ?cmd=heatpump&set_room_temperature=zone1:21.5 |
| Flow target temperature | zone:temperaturezone is – zone1– zone2– bothTemperature is: – float, 0–100 | ?cmd=heatpump&set_flow_target_temperature=zone1:45.0 |
| DHW (hot water) target temperature | float, 0–100 | ?cmd=heatpump&set_dhw_target_temperature=50.0 |
| DHW mode | normaleco | ?cmd=heatpump&set_dhw_mode=eco |
| DHW force (boost hot water now) | onoff | ?cmd=heatpump&set_dhw_force=on |
| Holiday mode | onoff | ?cmd=heatpump&set_holiday=off |
| Power mode | onoff (anything else → standby) | ?cmd=heatpump&set_power_mode=on |
| Heatpump operating mode | zone:mode Zone is: – zone1– zone2– bothmode is: – off– HEAT_ROOM_TEMP– HEAT_FLOW_TEMP– HEAT_COMPENSATION_CURVE– COOL_ROOM_TEMP– COOL_FLOW_TEMP– FLOOR_DRYUP | ?cmd=heatpump&set_heatpump_mode=zone1:HEAT_ROOM_TEMP |
| MRC mode | disabledfunctiontemperaturerunning_modesystem_on_off | ?cmd=heatpump&mrc_mode=disabled |
| Controller mode flag | flag:on/offflag is: – forced_dhw– holiday_mode– prohibit_dhw– prohibit_zone1_heating– prohibit_zone1_cooling– prohibit_zone2_heating– prohibit_zone2_cooling– server_control | ?cmd=heatpump&set_controller_mode=forced_dhw:on |