home-assistant.io/source/_components/nuheat.markdown

title, description, logo, ha_category, ha_release, ha_iot_class, redirect_from

title	description	logo	ha_category	ha_release	ha_iot_class	redirect_from
NuHeat	Instructions on how to integrate your NuHeat Signature thermostats within Home Assistant.	nuheat.png	Climate	0.61	Cloud Polling	/components/climate.nuheat/

The nuheat integration lets control your connected NuHeat Signature floor heating thermostats from NuHeat.

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 and selecting your thermostat(s).

Once you have the Thermostat ID(s), add the following information to your configuration.yaml file:

# Example configuration.yaml entry
nuheat:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD
  devices: 12345

# Example configuration.yaml entry with multiple thermostats
nuheat:
  username: YOUR_USERNAME
  password: YOUR_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. required: true type: [string, integer] {% endconfiguration %}

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.

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.

Attribute name

Returns the name of the NuHeat Thermostat.

Attribute type	Description
String	Name of the thermostat

Attribute temperature_unit

Returns the unit of measurement used for temperature by the thermostat.

Attribute type	Description
String	Name of the temperature unit

Attribute current_temperature

Returns the current temperature measured by the thermostat.

Attribute type	Description
Integer	Currently measured temperature

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

Attribute preset_mode

Returns the current temperature hold, if any.

Attribute type	Description
String	'temperature', 'temporary_temperature', 'auto', etc.

Attribute hvac_action

Returns the current HVAC mode of the thermostat.

Attribute type	Description
String	'heat', 'idle'

Attribute preset_modes

Returns the list of available preset modes.

Attribute type	Description
List of String	Available preset modes

Attribute min_temp

Returns the minimum supported temperature by the thermostat

Attribute type	Description
Integer	Minimum supported temperature

Attribute max_temp

Returns the maximum supported temperature by the thermostat

Attribute type	Description
Integer	Maximum supported temperature

Services

The following services are provided by the NuHeat Thermostat: set_temperature, set_hvac_mode, set_preset_mode, resume_program.

The services fan_min_on_time, set_aux_heat, set_away_mode, set_humidity, set_fan_mode, and set_swing_mode offered by the Climate component are not implemented for this thermostat.

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.

Service set_preset_mode

Sets the thermostat's preset mode. Without a preset mode set it 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.

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.