Improvements to incomfort documentation (#37101)

* Add basic configuration

* Give the supported devices info its own header

* Remove `intergas` term

* Update source/_integrations/incomfort.markdown

* Add troubleshooing section
This commit is contained in:
Jan Bouwhuis 2025-01-27 08:56:18 +01:00 committed by GitHub
parent 6e29ef52fd
commit 98d1d835d8
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -20,8 +20,10 @@ ha_integration_type: integration
ha_config_flow: true
---
The `incomfort` {% term integration %} links Home Assistant with your Intergas Lan2RF gateway, including the boiler and any room thermostats attached to it.
The integration uses the [incomfort](https://pypi.org/project/incomfort-client/) client library.
This integration links Home Assistant with your Intergas Lan2RF gateway, including the boiler and any room thermostats attached to it.
The integration uses the [incomfort-client](https://pypi.org/project/incomfort-client/) library.
### Supported devices
The Intergas Lan2RF Gateway connects thermostats based on the OpenTherm standard. An example of such a thermostat is the [Comfort Touch Thermostat](https://www.intergas-verwarming.nl/en/consumer/products/comfort-touch-thermostat/). The thermostats and LAN2RF gateway are often sold as a set. The gateway is suitable for use with Intergas Kombi Kompakt HRE and HReco appliances from year of manufacture 2014. If the Comfort Touch thermostat is used together with the gateway, then this will work in combination with Intergas Kombi Kompakt HRE, HReco, or Xtreme devices from year of manufacture 2017.
@ -39,11 +41,30 @@ Any room thermostats (there can be 0, 1 or 2) are represented as **Climate** dev
{% include integrations/config_flow.md %}
{% configuration_basic %}
host:
description: "Hostname or IP-address of the Intergas InComfort Lan2RF Gateway."
required: true
type: string
username:
description: "The username to log into the gateway. This is `admin` in most cases."
required: false
type: string
password:
description: "The password to log into the gateway, is printed at the bottom of the Lan2RF Gateway or is `intergas` for some older devices."
required: false
type: string
{% endconfiguration_basic %}
The hub does not have to be in the same network as HA, but must be reachable via port 80/HTTP.
## Troubleshooting
In case setting up an older gateway type fails, then try to leave `username` and `password` fields empty.
## Data updates
The `incomfort` {% term integration %} will fetch state data from the gateway every 30 seconds. When the target temperature on the thermostat is changed, it might take some time for the set point to be updated on the Home Assistant climate {% term entity %}.
The Intergas Lan2RF Gateway will fetch state data from the gateway every 30 seconds. When the target temperature on the thermostat is changed, it might take some time for the set point to be updated on the Home Assistant climate {% term entity %}.
## Remove integration