Nexia

The nexia component lets you control thermostats connected to Nexia (Trane/American Standard).

As of version 1.0.0 this library uses asyncio and aiohttp. The last version to use requests was 0.9.13.

All the set functions are no coroutines.

Supported XL950, XL1050, XL824 Not supported XL624, others

By connecting this component, you will have access to all thermostats and zones in your associated home.

Concepts

The Nexia Thermostat supports the following key concepts.

Attributes

The following attributes are provided by the Nexia Thermostat aux_heat, away_mode, current_humidity, current_temperature, fan_list, fan_mode, firmware, friendly_name, hold_mode, humidity, humidify_supported, dehumidify_supported, humidify_setpoint, dehumidify_setpoint max_humidity, max_temp, min_humidity, min_temp, model, operation_list, operation_mode, setpoint_status, target_temp_high, target_temp_low, target_temp_step, temperature, thermostat_id, thermostat_name, zone_id, zone_status

aux_heat

Indicates whether or not aux heat / emergency heat is enabled.

away_mode

Indicates whether the 'away' preset is selected.

Attribute current_humidity

Provides you with the main thermostat's relative humidity. Outdoor humidity or zone specific humidity is not currently available via Nexia's published data.

Attribute current_temperature

Provides you with the current zone's temperature.

Attribute fan_list

This is a list of all available fan modes you can select, separated by commas.

Attribute fan_mode

The currently selected fan mode.

Attribute firmware

Provides you with the current firmware version of the main thermostat.

Attribute hold_mode

Indicates if a hold is currently in place on this zone. Examples of such are 'away', 'home', 'sleep', or 'evening'

Attribute humidity

The target dehumidify set point (%) of the system.

Attribute humidify_supported

Indicates if the system supports humidification.

Attribute dehumidify_supported

Indicates if the system supports dehumidification.

Attribute humidify_setpoint

The target humidify set point (%) of the system.

Attribute dehumidify_setpoint

Same as humidity The target dehumidify set point (%) of the system.

Attribute max_humidity

Hard-coded value indicating the maximum dehumidify set point (%) you can set, as an integer.

Attribute max_temp

The maximum temperature set point of the zone. This can change based on the thermostat's settings.

Attribute min_humidity

Hard-coded value indicating the minimum dehumidify set point (%) you can set, as an integer.

Attribute min_temp

The minimum temperature set point of the zone. This can change based on the thermostat's settings.

Attribute model

The thermostat model, such as 'TZON1050AC52ZAA'

Attribute operation_list

List of available operation modes such as 'AUTO,COOL,HEAT,OFF'

Attribute operation_mode

The current operation mode, such as 'AUTO', 'COOL', 'HEAT', or 'OFF'

Attribute setpoint_status

This provides you with a system set point status, such as 'Holding Permanently', 'Following Schedule - Away', or 'Following Schedule - Home'. This is not an exhaustive list.

Attribute target_temp_high

The target cooling (upper-bound) temperature for the current zone.

Attribute target_temp_low

The target heating (lower-bound) temperature for the current zone.

Attribute target_temp_step

The step at which the temperature can be increased or decreased. For Fahrenheit, this is 1.0 degrees per step, and for Celsius, this is 0.5 degrees per step.

Attribute temperature

Based on the current system mode, this is the target temperature for the zone.

Attribute thermostat_id

This is the main thermostat's ID, here for reference. This will match up with the 'id' in the JSON data provided by Nexia.

Attribute thermostat_name

The name of the system. This will be shared across all zones of your Trane / American Standard system.

Attribute zone_id

The zone ID for this particular zone, here for reference. This will match up with the 'id' in the JSON data provided by Nexia under the 'zones' list.

Attribute zone_status

The status of the zone, such as 'Cooling', or 'Heating"

Services

The following climate services are provided by the Nexia Thermostat: set_aux_heat, set_away_mode, set_fan_mode, set_hold_mode, set_humidity, set_operation_mode, set_temperature, turn_on, turn_off

The service set_swing_mode offered by the Climate component is not implemented for this thermostat.

The following nexia climate service is provided by the Nexia Thermostat: set_aircleaner_mode

Service set_aux_heat

Enable the aux / emergency heat for the system. This is a system-wide setting.

Service set_away_mode

Turns the away mode on or off for the thermostat.

Service set_fan_mode

Sets the fan mode for the system. See the fan_list attribute for options. This is a system-wide setting.

Service set_hold_mode

Puts the thermostat into the given hold mode. For 'home', 'away', 'sleep', and any other hold based on a reference climate, the target temperature is taken from the reference climate.

Service set_humidity

Sets the dehumidify set point of the system. Range from 35-65. This is a system-wide setting.

Service set_temperature

Puts the thermostat into a temporary hold at the given temperature.

Only the target temperatures relevant for the current operation mode need to be provided.

Service set_operation_mode

Sets the current operation mode of the thermostat. See attribute operation_list for options.

Service turn_on

Turns the zone on.

Service turn_off

Turns the zone off.

Service set_aircleaner_mode

Part of the nexia. services. Sets the air cleaner mode. Options include 'AUTO', 'QUICK', and 'ALLERGY'. This is a system-wide setting.

Service set_humidify_setpoint

Part of the nexia. services. Sets the humidify setpoint. This is a system-wide setting.