home-assistant.io/source/_integrations/incomfort.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_config_flow, ha_dhcp, ha_quality_scale

title	description	ha_category	ha_release	ha_iot_class	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_config_flow	ha_dhcp	ha_quality_scale
Intergas gateway	Instructions on how to integrate an Intergas gateway with Home Assistant.	Binary sensor Climate Sensor Water heater	0.93	Local Polling	@jbouwh	incomfort	binary_sensor climate diagnostics sensor water_heater	integration	true	true	platinum

This integration links Home Assistant with your Intergas gateway, including the boiler and any room thermostats attached to it. The integration uses the incomfort-client library.

Supported devices

The Intergas Gateway connects thermostats based on the OpenTherm standard. An example of such a thermostat is the 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.

Boiler

The boiler is represented as a Water heater device. It will report the boiler's state and current_temperature. The gateway does not expose any means to directly control the boiler or change its configuration.

Note that the current_temperature will switch between the CV (circulating volume) and Tap temperatures according to the current operating mode of the boiler. If the boiler is neither pumping nor tapping, it will be reported as the higher of the two.

Rooms

Any room thermostats (there can be 0, 1 or 2) are represented as Climate devices. They will report the thermostat's target temperature and current_temperature and the target temperature can be changed. This is similar to changing the target temperature override using the Comfort Touch App that comes with the thermostat/gateway. Note that any override will be reset when a new set point is reached on the thermostat's schedule.

{% include integrations/config_flow.md %}

{% configuration_basic %} host: description: "Hostname or IP-address of the Intergas 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 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.

The above configuration can also be adjusted later via {% my integrations title="Settings > Devices & services" %}, select "Intergas gateway" and click {% icon "mdi:dots-vertical" %} and select Reconfigure.

{% important %}

Some older room thermostats might report the wrong setpoint when the setpoint is manually changed on the room thermostat. If you encounter this behavior, you can enable the Legacy setpoint handling option.

{% endimportant %}

{% include integrations/option_flow.md %}

Sensors for diagnostics

Note that all sensors are disabled by default.

• Sensors
  • Boiler Pressure: Indicates the boilers pressure.
  • Boiler Temperature: Indicates the central heating temperature.
  • Boiler Tap temperature: Indicates the tap water temperature.
• Binary sensors
  • Boiler Burner: Indicates if the burner is on.
  • Boiler Fault: Indicates if there is a problem. The fault code is set as an attribute.
  • Boiler Hot water tap: Indicates if the hot water tap is running.
  • Boiler Pump: Indicate the pump is running for cental heating.

Troubleshooting

In case setting up an older gateway type fails, then try to leave username and password fields empty.

Data updates

The Intergas 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 %}.

Removing the integration

This integration follows standard integration removal, no extra steps are required.

{% include integrations/remove_device_service.md %}

Automation

To send an alert if the CV pressure is too low or too high, consider the following example:

{% raw %}

- alias: "Low CV Pressure Alert"
  triggers:
    - trigger: numeric_state
      entity_id: sensor.boiler_pressure
      below: 1.0
  actions:
    - action: notify.pushbullet_notifier
      data:
        title: "Warning: Low CH Pressure"
        message: >-
          {{ trigger.to_state.attributes.friendly_name }}
          is low, {{ trigger.to_state.state }} bar.

{% endraw %}

Other properties are available via each device's attributes.