NuHeat


The nuheat component 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 Variables

username

(string)(Required)The username for accessing your MyNuHeat account.

password

(string)(Required)The password for accessing your MyNuHeat account.

devices

(string | int)(Required)The serial number/ID of each thermostat you would like to integrate.

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 current_hold_mode

Returns the current temperature hold, if any.

Attribute type Description
String ‘temperature’, ‘temporary_temperature’, ‘auto’, etc.

Attribute current_operation

Returns the current operation of the thermostat.

Attribute type Description
String ‘heat’, ‘idle’

Attribute operation_list

Returns the list of available operation modes.

Attribute type Description
List of String Available operation 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_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 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_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.

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.