Skip to content

Latest commit

 

History

History
111 lines (80 loc) · 6.11 KB

README.md

File metadata and controls

111 lines (80 loc) · 6.11 KB
Raw

1.0.3:

  • Quickfix for name issue of devices

New in Version 1.0.2:

  • Translations (not yet enabled due to naming issue..): Currently German and English is supported. Please contact us if you want to contribute further languages.
  • Power Map files are now moved into the integration's folder "/custom_components/weishaupt_modbus". At setup or at configuration one of the existing files or a generic file called "weishaupt_wbb_kennfeld.json" can be choosen
  • Several bugfixes etc.

With version 1.0.0 we consolidate both versions.

In this version this will have the following impact:

(For updates from 1.0.0 to newer versions, this procedure is not longer needed.)

For users of MadOne's original weishaupt_modbus integration:

  • Remove the Heatpump configuration.
  • In HACS remove the integration completely
  • Restart Home Assistant
  • Add this Repository to HACS as descriped in Installation
  • When doing nothing than simply installing the integration, the long term statistics will be split into new entities, since the sensor domain is different.
  • To avoid this, change the default prefix entry in the configuration dialog from weishaupt_wbb to weishaupt_modbus

For users of OStrama's weishaupt_wbb integration:

  • Uninstall existing "weishaupt_wbb" installation, answer "integration and all entities of it will be deleted" with"yes"
  • Restart home assistant
  • Install new weishaupt_wbb integration
  • You will get a new integration with the same name
  • the sensor entities will be the same than before

All modbus parameters of this integration are concentrated in the file hpconst.py as a set of object lists. This allows generic setup of all entities and a more easy completion of messages and entity behavior

Weishaupt_modbus

This integration lets you monitor and control your weishaupt heatpump through modbus. This is how it might look: image

Installation

Start Config Flow

HACS (manually add Repository)

Add this repository to HACS.

  • In the HACS GUI, select "Custom repositories"
  • Enter the following repository URL: https://github.com/OStrama/weishaupt_modbus/releases
  • Category: Integration
  • After adding the integration, restart Home Assistant.
  • Now under Configuration -> Integrations, "Weishaupt Modbus Integration" should be available.

Manual install

Create a directory called weishaupt_modbus in the <config directory>/custom_components/ directory on your Home Assistant instance. Install this component by copying all files in /custom_components/weishaupt_modbus/ folder from this repo into the new <config directory>/custom_components/weishaupt-modbus/ directory you just created.

This is how your custom_components directory should look like:

custom_components
├── weishaupt_modbus
│   ├── __init__.py
│   ├── ...
│   ├── ...
│   ├── ...
│   └── wp.py

Configuration

image

The only mandatory parameter is the IP-Address of your heatpump. The port should be ok at default unless you changed it in the Heatpump configuration.

The "prefix" should only be changed when migrating from MadOnes original integration to this one to avoid splitting of sensor history

The "Device Postfix" has a default value of "". It can be used to add multiple heat pumps to one home assistant. For compatibility this should be left empty. If you want to add another heat pump, use a name that help to identify the devices.

The power mapping file

The "Kennfeld-File" can be choosen to read in the right power mapping according to your type of heat pump:

The heat power "Wärmeleistung" is calculated from the "Leistungsanforderung" in dependency of outside temperature and water temperature. This is type specific. The data stored in the integration fit to a WBB 12. If the file you've parameterized does not exist, the integration will create a file that fits for a WBB12. If you have another heat pump please update the Kennfeld-File file according to the graphs found in the documentation of your heat pump and change the name of the used file by reconfiguring the integration and change only the file name. It may be necessary to restart home assistant after changing the filename. When no file is available, a new file with the defined name will be created that contains the parameters read out from the graphs found in the documentation of WBB 12 in a manual way. Thsi file can be used as a template for another typer of heatpump. (Note: It would be great if you could provide files from other types of heatpumps to us, so that we can integrate them in further versions ;-))

You have to enable modbus in your heatpump settings.

Setting up the HeatPump

In order to use this integration you have to enable modbus in your heatpump. Go to: User -> Settings (second Page) -> Modbus TCP

Parameter: On

Network: Here you have 2 options. Either you place the IP of your HomeAssistent to exclusively allow this ip to connect to the heatpump via ModBus or you place your network to allow all the IPs in that range. For example: 192.168.178.123 (Home Assistant IP) or 192.168.178.0 for all ips between 192.168.178.1 and 192.167.178.254. Option 1 is the savest but Option 2 enables you to connect to the heatpump from multiple devices(developing machine, or maybe my possibly upcomming dedicated android app?). I suggest to go for option 1 (HomeAssistant IP).

Netmask: Select the netmask of your network. This will be 255.255.255.000 for you otherwise you would know the correct one ;)

Disclaimer

The developers of this integration are not affiliated with Weishaupt. They have created the integration as open source in their spare time on the basis of publicly accessible information. The use of the integration is at the user's own risk and responsibility. The developers are not liable for any damages arising from the use of the integration.