OpenTherm Gateway


The opentherm_gw climate platform is used to control the OpenTherm Gateway from Home Assistant.

Configuration

# Example configuration.yaml entry
climate:
  - platform: opentherm_gw
    device: /dev/ttyUSB0

Configuration Variables

device

(string)(Required)Path to OpenTherm Gateway device as supported by PySerial.

name

(string)(Optional)The name for the device within Home Assistant.

Default value: OpenTherm Gateway

precision

(float)(Optional)The desired precision for this device. Can be used to match your actual thermostat’s precision. Supported values are 0.1, 0.5 and 1.0.

Default value: 0.5 for Celsius and 1.0 for Fahrenheit.

floor_temperature

(boolean)(Optional)Some thermostats round all temperatures down to the lower value according to their precision. Default behaviour for Home Assistant is to round temperatures to the nearest value. Set this to true to override Home Assistant and round to the lower value according to the configured precision.

The OpenTherm protocol is based on polling. The thermostat sends requests to the boiler at specific intervals. As a result, it may take some time for changes to propagate between Home Assistant and the thermostat.

Example

A full configuration example with the OpenTherm Gateway connected to a remote host running ser2net looks like the one below.

# Full example configuration.yaml entry
climate:
  - platform: opentherm_gw
    device: socket://otgw.example.org:2345
    name: Thermostat
    precision: 0.5
    floor_temperature: true