Home

Weishaupt Modbus

This wiki covers the Weishaupt Modbus Home Assistant integration. It reads and controls a Weishaupt heat pump over Modbus TCP: temperatures, operating states, error codes, energy statistics and an estimated heat output, plus the setpoints and operating modes the controller lets you write. An experimental second entry reads the controller's local web interface for values Modbus does not carry or carries only coarsely, and can set the heating power limit.

It is a fork of OStrama/weishaupt_modbus that goes its own way: Modbus first, one shared connection to the controller, entity IDs that stay as you set them (see the repository README).

Supported devices

• Weishaupt heat pumps whose controller offers Modbus TCP in its own settings menu (see Installation and Setup).
• Developed and checked on a WBB with one heating circuit. Power maps ship for models of the WAB, WBB, WEB (Evoblock), WSB and WWP LS series; a model without one works too, only the estimated heat output depends on the map and is off with another model's map until you add your own (see How Data Updates).
• It has not been tested with heat pumps that use the separate Weishaupt Modbus module (WEM-Modbus gateway); Weishaupt_CanApiJson may be what you are looking for.
• The web interface is read only with its language set to Auto, German or English, and its values are those of a WBB; an Evoblock is read with its titles in German.

Requires Home Assistant 2026.9.0 or newer.

Pages

Page	Content
Installation and Setup	Prerequisites at the heat pump, installation, setup parameters, reconfigure, options, removal
Entities	Every entity with its register or web-interface title, unit and range
How Data Updates	Polling, writes and the EEPROM, the power map, known limits of the values
Web Interface	The experimental web-interface entry: switching it on, adding it, what it reads, the heating power limit, how gently it asks
Troubleshooting and Diagnostics	Error messages, repair notices, debug log and diagnostics, untested models
Migration	Upgrading from 1.x and from earlier 2.x releases
Modbus Register Reference (EN)	Every register of the controller, its format and special values (Deutsch)

Where the facts come from

Unless a sentence says it was seen on a heat pump or comes from Weishaupt's documents, it describes how the integration behaves. Observations come from one WBB; another model or firmware may behave differently. Reports from other models are welcome as an issue.

The developers of this integration are not affiliated with Weishaupt. Use is at your own risk.