pail23 / stiebel_eltron_isg_component

Stiebel Eltron ISG integration for Home Assistant
MIT License
52 stars 22 forks source link
hacs home-assistant integration python

Stiebel Eltron ISG integration

GitHub Release GitHub Activity Github Downloads Github Downloads License

hacs Project Maintenance BuyMeCoffee

Community Forum

Prerequisite

In order to use this Integration you need:

  1. ISG device connected to the heatpump and your local network
  2. IP address of the ISG device on your local network

For connecting the ISG device to your heatpump refer to the corresponding Stiebel Eltron documentation or ask your installer. There is no need to get the "STIEBEL ELTRON Web-Monitoring" subscription, this is for Stiebel Eltron itself monitoring your Heatpump and NOT needed for this integration to work.

If you are using the ISG with the STIEBEL ELTRON EMI extension make sure that your ISG Firmware is current because this Integration is using Modbus, older versions of ISG Software are not able to do Modbus and EMI at the same time. (ISG Software Version v12.1.2 was tested by @northalpha using this integration to be working). An update may be triggered via Stiebel Eltron Support (Kundendienst).

Installation

Using HACS

This is the preferred installation option. If you are using HACS:

  1. Add the component to your home assistant installation: Open your Home Assistant instance and show the blueprint import dialog with a specific blueprint pre-filled.
  2. Add the Stiebel Eltron ISG Integration in HACS and restart Home Assistant
  3. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Stiebel Eltron ISG"

Manual installation:

  1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
  2. If you do not have a custom_components directory (folder) there, you need to create it.
  3. In the custom_components directory (folder) create a new folder called stiebel_eltron_isg.
  4. Download all the files from the custom_components/stiebel_eltron_isg/ directory (folder) in this repository.
  5. Place the files you downloaded in the new directory (folder) you created.
  6. Restart Home Assistant
  7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "Stiebel Eltron ISG"

Configuration is done in the UI

Contributions are welcome!

If you want to contribute to this please read the Contribution guidelines