Merge pull request #3962 from broox/nuheat

add initial NuHeat documentation
This commit is contained in:
Lukas Barth 2017-12-28 09:16:14 +01:00 committed by GitHub
commit f945537103
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 199 additions and 0 deletions

View File

@ -0,0 +1,148 @@
---
layout: page
title: "NuHeat Thermostat"
description: "Instructions how to integrate your NuHeat Signature thermostats within Home Assistant."
date: 2017-11-11 18:00
sidebar: true
comments: false
sharing: true
footer: true
logo: nuheat.png
ha_category: Climate
ha_release: 0.58
ha_iot_class: "Cloud Polling"
---
<p class='note'>
To get your [NuHeat Signature](http://www.nuheat.com/products/thermostats/signature-thermostat) thermostats working within Home Assistant, please follow the instructions for the general [NuHeat component](/components/nuheat)
</p>
## {% linkable_title Concepts %}
The NuHeat Thermostat supports the following key concepts.
The _target temperature_ is the temperature that the device attempts to achieve. The target temperature is either determined by the schedule programmed into the thermostat (_auto mode_) or may be overridden. When the target temperature is set by home assistant, the thermostat will hold this temperature until the schedule is resumed.
## {% linkable_title Attributes %}
The following attributes are provided by the NuHeat thermostat: `name`, `temperature_unit`, `current_temperature`, `target_temperature`, `current_hold_mode`, `current_operation`, `operation_list`, `min_temp`, `max_temp`
### {% linkable_title Attribute `name` %}
Returns the name of the NuHeat Thermostat.
| Attribute type | Description |
| ---------------| ----------- |
| String | Name of the thermostat
### {% linkable_title Attribute `temperature_unit` %}
Returns the unit of measurement used for temperature by the thermostat.
| Attribute type | Description |
| ---------------| ----------- |
| String | Name of the temperature unit
### {% linkable_title Attribute `current_temperature` %}
Returns the current temperature measured by the thermostat.
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Currently measured temperature
### {% linkable_title Attribute `target_temperature` %}
Returns the target temperature of the thermostat, when the thermostat is
not in auto operation mode.
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Target temperature
### {% linkable_title Attribute `target_temperature_low` %}
Returns the desired heating temperature set in the thermostat when in
auto operation mode.
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Target temperature
### {% linkable_title Attribute `target_temperature_high` %}
Returns the desired cooling temperature set in the thermostat when in
auto operation mode.
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Target temperature
### {% linkable_title Attribute `current_hold_mode` %}
Returns the current temperature hold, if any.
| Attribute type | Description |
| ---------------| ----------- |
| String | 'temperature', 'temporary_temperature', 'auto', etc.
### {% linkable_title Attribute `current_operation` %}
Returns the current operation of the thermostat.
| Attribute type | Description |
| ---------------| ----------- |
| String | 'heat', 'idle'
### {% linkable_title Attribute `operation_list` %}
Returns the list of available operation modes.
| Attribute type | Description |
| ---------------| ----------- |
| List of String | Available operation modes
### {% linkable_title Attribute `min_temp` %}
Returns the minimum supported temperature by the thermostat
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Minimum supported temperature
### {% linkable_title Attribute `max_temp` %}
Returns the maximum supported temperature by the thermostat
| Attribute type | Description |
| ---------------| ----------- |
| Integer | Maximum supported temperature
## {% linkable_title Services %}
The following services are provided by the NuHeat Thermostat: `set_temperature`, `resume_program`.
The services `fan_min_on_time`, `set_aux_heat`, `set_away_mode`, `set_hold_mode`, `set_humidity`, `set_fan_mode`, `set_operation_mode` and `set_swing_mode` offered by the [Climate component](/components/climate/) are not implemented for this thermostat.
### {% linkable_title Service `set_temperature` %}
Puts the thermostat into a temporary hold at the given temperature.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.
| `temperature` | no | Desired target temperature (when not in auto mode)
Only the target temperatures relevant for the current operation mode need to
be provided.
### {% linkable_title Service `resume_program` %}
Resumes the currently active schedule.
| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `entity_id` | yes | String or list of strings that point at `entity_id`'s of climate devices to control. Else targets all.

View File

@ -0,0 +1,51 @@
---
layout: page
title: "NuHeat"
description: "Instructions how to integrate your NuHeat Signature thermostats within Home Assistant."
date: 2017-11-11 18:00
sidebar: true
comments: false
sharing: true
footer: true
logo: nuheat.png
ha_category: Hub
ha_release: 0.58
ha_iot_class: "Cloud Polling"
---
The `nuheat` component lets you control connected floor heating thermostats from [NuHeat](http://www.nuheat.com/).
First, you will need to obtain your thermostat's numeric serial number or ID by logging into [MyNuHeat.com](https://mynuheat.com/) and selecting your thermostat(s).
Once you have the Thermostat ID(s), add the following information to your `configuration.yaml` file:
```yaml
# Example configuration.yaml entry
nuheat:
username: you@example.com
password: very-secure-password
devices: 12345
# Example configuration.yaml entry with multiple thermostats
nuheat:
username: you@example.com
password: very-secure-password
devices:
- 12345
- 67890
```
{% configuration %}
username:
description: The username for accessing your MyNuHeat account.
required: true
type: string
password:
description: The password for accessing your MyNuHeat account.
required: true
type: string
devices:
description: The serial number / ID of each thermostat you would like to integrate with Home Assistant.
required: true
type: [string, int]
{% endconfiguration %}

Binary file not shown.

After

Width:  |  Height:  |  Size: 4.0 KiB