Add override switch to geniushub (#16327)

This commit is contained in:
GeoffAtHome 2021-01-29 11:45:30 +00:00 committed by GitHub
parent d41290fa51
commit dff60f7227
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -35,25 +35,28 @@ There are limitations due to the differences between the Genius Hub and Home Ass
### Service Handlers ### Service Handlers
Home Assistant is obligated to place restrictions upon integrations such as **geniushub** to maintain compatibility with other ecosystems (e.g., Google Home) and so not all of the **geniushub** functionality is available via the web UI. Some of this missing functionality is exposed via integration-specific service handlers: Home Assistant is obligated to place restrictions upon integrations such as **geniushub** to maintain compatibility with other ecosystems (e.g., Google Home) and so not all of the **geniushub** functionality is available via the web UI. Some of this missing functionality is exposed via integration-specific service handlers:
- `set_zone_override`: change the zone's setpoint _for a specified duration_ (up to 24h), and
- `set_zone_mode`: change the zone's mode to one of `off`, `timer` or (if supported by the zone) `footprint` - `set_switch_override`: change the switches on time _for a specified duration_ (up to 24h),
- `set_zone_override`: change the zone's setpoint _for a specified duration_ (up to 24h), and
- `set_zone_mode`: change the zone's mode to one of `off`, `timer` or (if supported by the zone) `footprint`
### Climate and Water Heater Entities ### Climate and Water Heater Entities
Climate and Water Heater entities will report their current temperature, setpoint and mode; other properties (e.g., occupied state) are available via their state attributes (see examples below). The Genius Hub mode will be reported as/set to: Climate and Water Heater entities will report their current temperature, setpoint and mode; other properties (e.g., occupied state) are available via their state attributes (see examples below). The Genius Hub mode will be reported as/set to:
GH mode | HA Operation | HA Preset | GH mode | HA Operation | HA Preset |
:---: | :---: | :---: | :-----------: | :----------: | :-------: |
**Off** | Off | N/A | **Off** | Off | N/A |
**Timer** | Heat | None | **Timer** | Heat | None |
**Override** | Heat | Boost | **Override** | Heat | Boost |
**Footprint** | Heat | Activity | **Footprint** | Heat | Activity |
**Footprint** mode is only available to **Radiator** zones that have room sensors. **Footprint** mode is only available to **Radiator** zones that have room sensors.
### Switch Entities ### Switch Entities
Switch entities will report back their state; other properties are available via their state attributes. Currently, HA switches do not have modes/presets, so the Home Assistant `state` will be *reported* as: Switch entities will report back their state; other properties are available via their state attributes. Currently, HA switches do not have modes/presets, so the Home Assistant `state` will be *reported* as:
- `On` for **Override** \ **On**, and - `On` for **Override** \ **On**, and
- `Off` otherwise (NB: the zone could still be 'on', e.g., with **Timer** mode) - `Off` otherwise (NB: the zone could still be 'on', e.g., with **Timer** mode)