From 80e87314bbf13bf13daa47caa4c87bba7607d9fd Mon Sep 17 00:00:00 2001 From: mvn23 Date: Fri, 24 Jul 2020 10:42:09 +0200 Subject: [PATCH] Add opentherm_gw.set_central_heating_ovrd documentation (#13082) --- source/_integrations/opentherm_gw.markdown | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/source/_integrations/opentherm_gw.markdown b/source/_integrations/opentherm_gw.markdown index b83247a8b6f..c0cf858114c 100644 --- a/source/_integrations/opentherm_gw.markdown +++ b/source/_integrations/opentherm_gw.markdown @@ -77,6 +77,24 @@ Reset the OpenTherm Gateway. | ---------------------- | -------- | ----------- | | `gateway_id` | no | The `gateway_id` as specified during configuration. +### Service `set_central_heating_ovrd` + +Set the central heating override option on the gateway. +When overriding the control setpoint (via a [set_control_setpoint](#service-opentherm_gwset_control_setpoint) service call with a temperature value other than 0), the gateway automatically enables the central heating override to start heating. This service can then be used to control the central heating override status. +To return control of the central heating to the thermostat, call the [set_control_setpoint](#service-opentherm_gwset_control_setpoint) service with temperature value 0. +**You will only need this if you are writing your own software thermostat.** + +| Service data attribute | Optional | Description | +| ---------------------- | -------- | ----------- | +| `gateway_id` | no | The `gateway_id` as specified during configuration. +| `ch_override` | no | The desired value for the central heating override. Use `0` to disable or `1` to enable. + +
+ +Please read [this information](http://otgw.tclcode.com/standalone.html) from the designer of the OpenTherm Gateway before considering to write your own software thermostat. + +
+ ### Service `opentherm_gw.set_clock` Provide the time and day of week to the OpenTherm Gateway. The value provided here will be forwarded to the thermostat on the next date/time request from the thermostat. The OpenTherm Gateway does not have the ability to accurately keep track of time, so it will only retain the information provided here for a maximum of about 61 seconds.