jeans/home-assistant.io
jeans/home-assistant.io
1
0
Fork 0
mirror of https://github.com/home-assistant/home-assistant.io.git synced 2025-07-19 07:17:14 +00:00
Code Issues Packages Projects Releases Wiki Activity

[climate] Migrate geniushub docs for climate-1.0 (#9818)

Browse Source 
* initial commit

* manual rebase

* manual rebase

* manual rebase 2

* add modes
This commit is contained in:
David Bonnes 2019-07-10 11:40:51 +01:00 committed by Franck Nijhof
parent 451dd96e75
commit 8d87a621c9
1 changed files with 18 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
source/_components/geniushub.markdown
View File

@ -17,9 +17,11 @@ ha_release: 0.92
ha_iot_class: Local Polling
---
The `geniushub` integration links Home Assistant with your Genius Hub for controlling its Zones and Devices, and visibility of any Issues. Currently, there is no support for Zone schedules.
The `geniushub` integration links Home Assistant with your Genius Hub CH/DHW system, including its Zones, Devices, and Issues.
It uses the [geniushub-client](https://pypi.org/project/geniushub-client/) library.
Currently, there is no support for Zone schedules.
It uses the [geniushub](https://pypi.org/project/geniushub-client/) client library.
### Zones
@ -30,9 +32,16 @@ Each Zone controlled by your Genius hub will be exposed as either a:
Other Zone types, such as **On / Off** Zones, are not currently supported.
Each such entity will report back its mode, state, setpoint and current temperature; other properties are available via its attributes (see below).
Each such entity will report back its mode, state, setpoint and current temperature; other properties are available via its attributes (see below). The Zone's mode can changed as below.
In addition, the entity's mode and setpoint can be changed. The entity's `operating_mode` can be set to one of `off`, `timer`, `on` (i.e. **Override** mode) or `eco`. The `eco` mode is a proxy for the **Footprint** mode and so is only available to **Radiator** Zones that have room sensors.
GH mode | HA Operation | HA Preset
:---: | :---: | :---:
**Off** | Off | N/A
**Timer** | Heat | None
**Override** | Heat | Boost
**Footprint** | Heat | Activity
Note that **Footprint** mode is only available to **Radiator** Zones that have room sensors.
### Devices
@ -102,7 +111,7 @@ value_template: "{{ state_attr('climate.main_room', 'status').occupied }}"
## Configuration
To add your Genius Hub into your Home Assistant installation, add one of the following to your `configuration.yaml` file.
To set up this integration, add one of the following to your **configuration.yaml** file.
### Option 1: hub token only
@ -122,6 +131,8 @@ geniushub:
- uses the v3 API - unofficial, but there are additional features (e.g., battery levels)
- polls the hub directly (so is faster, say ~1s response time)
The hub does not have to be in the same network as HA.
```yaml
# Example configuration.yaml entry, directly polling the Hub
geniushub:
@ -130,8 +141,6 @@ geniushub:
password: GENIUS_HUB_PASSWORD
```
Note that if a `host` is used instead of `token`, then the `username` and `password` are also required.
{% configuration %}
token:
description: The Hub Token of the Genius Hub.
@ -150,3 +159,5 @@ password:
required: false
type: string
{% endconfiguration %}
Note that if a `host` is used instead of `token`, then the `username` and `password` are also required.