M-TEC Heating & Cooling
Controls M-TEC heat pumps for heating, cooling, and hot water via Modbus TCP.
This template connects M-TEC heat pumps (WPD, WPS, WPL, WPLK) via Modbus TCP for monitoring and control. It reads temperatures, energy consumption, operating states, and compressor data. It also provides write access to setpoints, operating modes, and PV surplus power input.
- Protocol
- Modbus TCP
- Connection
- Ethernet, Modbus TCP
- Registers
- 63, read and write
- Brand
- M-TEC
- Key readings
- Room temperature and humidity HC1-HC3 · Supply/backflow temperatures · Hot water and buffer temperatures · Heatpump electrical and thermal power · Heatpump operating hours and total energy · Compressor speed and error state
- Available commands
- Operating mode HC1-HC3 and hot water · Target supply flow and room temperatures · Heating/cooling requirements HC1-HC3 · PV current surplus power
- Compatible models
- WPD · WPS · WPL · WPLK
- Last updated
Registers (63)
45 read, 26 write
| Name | Unit | Access | Address (Hidden until you enter your email) | Function (hidden) | Type (hidden) |
|---|---|---|---|---|---|
| State Heatpump Operating Hours | h | Read | |||
| Actual Outsidetemperature | °C | Read | |||
| State Hot Water Operatingmode | Read and write | ||||
| Actual Hot Water temperature | °C | Read | |||
| State Target Roomtemperature HC1 | °C | Read | |||
| Actual Operating mode HC1 | Read and write | ||||
| Actual Room Humidity HC1 | % | Read | |||
| Actual Roomtemperature HC1 | °C | Read | |||
| Actual Electrical Heatpump Power | W | Read | |||
| Actual Heatpump Thermal Power | kW | Read | |||
| State Heatpump Operationmode | Read | ||||
| State Heatpump Total Electrical Energy | kWh | Read | |||
| Actual Operating mode HC2 | Read and write | ||||
| Actual Operating mode HC3 | Read and write | ||||
| Actual Room Humidity HC2 | % | Read | |||
| Actual Room Humidity HC3 | % | Read | |||
| Actual Roomtemperature HC2 | °C | Read | |||
| Actual Roomtemperature HC3 | °C | Read | |||
| State Target Roomtemperature HC2 | °C | Read | |||
| State Target Roomtemperature HC3 | °C | Read | |||
| State Heatpump Error | Read | ||||
| State Target Supplyflowtemperature HC1 | °C | Read and write | |||
| Actual Supplyflowtemperature HC1 | °C | Read | |||
| Actual Supplyflowtemperature HC2 | °C | Read | |||
| Actual Supplyflowtemperature HC3 | °C | Read | |||
| State Target Supplyflowtemperature HC2 | °C | Read and write | |||
| State Target Supplyflowtemperature HC3 | °C | Read and write | |||
| Actual Hot Water Targettemperature | °C | Read and write | |||
| Actual Buffertemperature Top | °C | Read | |||
| State Heatpump operation state | Read | ||||
| Actual Heatpump Supplyflowtemperature | °C | Read | |||
| Actual Heatpump Backflowtemperature | °C | Read | |||
| Actual Heatpump Brine IN Temperature | °C | Read | |||
| Actual Heatpump BrineOUT Temperature | °C | Read | |||
| State Heatpump Targetttemperature | °C | Read | |||
| State Compressorspeed | % | Read | |||
| State Coolrequest Buffer | Read | ||||
| State Coolrequest HC1 | Read | ||||
| State Coolrequest HC2 | Read | ||||
| State Coolrequest HC3 | Read | ||||
| State Heatrequest Buffer | Read | ||||
| State Heatrequest HC1 | Read | ||||
| State Heatrequest HC2 | Read | ||||
| State Heatrequest HC3 | Read | ||||
| Actual Buffertemperature Bottom | °C | Read | |||
| HC. 1 normal room temperature | °C | Write | |||
| Set System Operation mode | Write | ||||
| HC. 1 offset room temperature | K | Write | |||
| Set cooling requirement HC1 | Write | ||||
| Set heating requirement HC1 | Write | ||||
| HC. 1 lower room temperature | °C | Write | |||
| Set Outside temperature | °C | Write | |||
| PV. current surplus power | kW | Write | |||
| HC. 2 lower room temperature | °C | Write | |||
| HC. 3 lower room temperature | °C | Write | |||
| Set heating requirement HC2 | Write | ||||
| Set heating requirement HC3 | Write | ||||
| Set cooling requirement HC2 | Write | ||||
| Set cooling requirement HC3 | Write | ||||
| HC. 2 normal room temperature | °C | Write | |||
| HC. 3 normal room temperature | °C | Write | |||
| HC. 2 offset room temperature | K | Write | |||
| HC. 3 offset room temperature | K | Write |
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
- Monitor supply, return, and buffer temperatures across three heating circuits on a live cloud dashboard.
- Create alerts when the compressor enters an error state or when hot water temperature drops below a defined threshold.
- Log total electrical and thermal energy consumption over time to generate seasonal performance reports.
- Write PV surplus power values to the heat pump to optimize self-consumption of solar energy.
- Remotely switch operating modes between heating, cooling, and standby without an on-site visit.
- Track compressor operating hours and cycle counts to schedule preventive maintenance.
Installation
Ensure the M-TEC heat pump is running the ZP022 operating system, which provides native Modbus TCP support.
Contact your M-TEC partner to activate the Modbus TCP interface on the heat pump and confirm the IP address and port settings.
Connect the ModbusCloud Gateway to the same local network as the M-TEC unit using an Ethernet cable.
In the ModbusCloud portal, add a new Modbus TCP device and enter the IP address and port of the M-TEC heat pump.
Import the M-TEC Heating and Cooling template from the ModbusCloud template library and assign it to the device.
Verify data is flowing correctly by checking live values for supply temperature and compressor speed on the dashboard.
Things to watch for
Do I need an external Modbus gateway between the M-TEC unit and the ModbusCloud gateway?
No. M-TEC heat pumps with the ZP022 operating system have a built-in Modbus TCP server. You can connect the ModbusCloud gateway directly over Ethernet on the same LAN.
Some temperature readings appear incorrect or extremely high. What could be wrong?
Registers at addresses 1502 and 1503 use signed 16-bit integers (int16), while most other registers use unsigned 16-bit (uint16). Check that your register configuration matches the correct data type. The total electrical energy register at address 702 is int32 and must be read as two consecutive registers.
How do I activate the Modbus interface on the M-TEC heat pump?
Modbus TCP activation is not available through the standard end-user menu. Contact your M-TEC distribution partner or installer support to enable the interface and configure network parameters.
Can I use this template together with the M-TEC Energy Butler template?
Yes. Import both templates as separate devices in ModbusCloud. Make sure each device has a unique IP address or Modbus unit ID so the gateway can address them independently.
Want to see how it works?
