mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-24 17:57:14 +00:00
🚜 Merges/Redirect NuHeat component pages (#8737)
This commit is contained in:
Klaas Schoute
Fabian Affolter
parent
1b6e72168c
commit
9c03e231ed
@ -1,139 +0,0 @@
|
|||||||
---
|
|
||||||
layout: page
|
|
||||||
title: "NuHeat Thermostat"
|
|
||||||
description: "Instructions on 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.61
|
|
||||||
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` and `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 `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`, `set_hold_mode`, `nuheat_resume_program`.
|
|
||||||
|
|
||||||
The services `fan_min_on_time`, `set_aux_heat`, `set_away_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 an indefinite 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 `set_hold_mode` %}
|
|
||||||
|
|
||||||
Sets the thermostat's hold mode. The NuHeat thermostat supports "auto" (to run the thermostat's programmed schedule), "temperature" (to indefinitely hold the thermostat's current target temperature), or "temporary_temperature" (to hold the thermostat's current target temperature until the thermostat's next scheduled event).
|
|
||||||
|
|
||||||
| 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.
|
|
||||||
| `hold_mode` | no | New value of hold mode.
|
|
||||||
|
|
||||||
### {% linkable_title Service `nuheat_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.
|
|
||||||
@ -8,12 +8,19 @@ comments: false
|
|||||||
sharing: true
|
sharing: true
|
||||||
footer: true
|
footer: true
|
||||||
logo: nuheat.png
|
logo: nuheat.png
|
||||||
ha_category: Hub
|
ha_category:
|
||||||
|
- Climate
|
||||||
ha_release: 0.61
|
ha_release: 0.61
|
||||||
ha_iot_class: "Cloud Polling"
|
ha_iot_class: "Cloud Polling"
|
||||||
|
redirect_from:
|
||||||
|
- /components/climate.nuheat/
|
||||||
---
|
---
|
||||||
|
|
||||||
The `nuheat` component lets you control connected floor heating thermostats from [NuHeat](http://www.nuheat.com/).
|
The `nuheat` component lets control your connected [NuHeat Signature]([NuHeat Signature](http://www.nuheat.com/products/thermostats/signature-thermostat)) floor heating thermostats from [NuHeat](http://www.nuheat.com/).
|
||||||
|
|
||||||
|
There is currently support for the following device types within Home Assistant:
|
||||||
|
|
||||||
|
- Climate
|
||||||
|
|
||||||
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).
|
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).
|
||||||
|
|
||||||
@ -49,3 +56,124 @@ devices:
|
|||||||
required: true
|
required: true
|
||||||
type: [string, int]
|
type: [string, int]
|
||||||
{% endconfiguration %}
|
{% endconfiguration %}
|
||||||
|
|
||||||
|
## {% 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` and `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 `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`, `set_hold_mode`, `nuheat_resume_program`.
|
||||||
|
|
||||||
|
The services `fan_min_on_time`, `set_aux_heat`, `set_away_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 an indefinite 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 `set_hold_mode` %}
|
||||||
|
|
||||||
|
Sets the thermostat's hold mode. The NuHeat thermostat supports "auto" (to run the thermostat's programmed schedule), "temperature" (to indefinitely hold the thermostat's current target temperature), or "temporary_temperature" (to hold the thermostat's current target temperature until the thermostat's next scheduled event).
|
||||||
|
|
||||||
|
| 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.
|
||||||
|
| `hold_mode` | no | New value of hold mode.
|
||||||
|
|
||||||
|
### {% linkable_title Service `nuheat_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.
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user