Thermostat Controller

From Hubitat Documentation
Jump to: navigation, search
Go to the top of the page

In many circumstances a properly located thermostat will work well to maintain comfortable temperatures. However, the performance of a heating and cooling system may suffer when the thermostat is not in the right location, or there is significant heat gain or loss in parts of the your home. Some thermostats also lack an Auto mode, which may result in difficulties during conditions that require both heating and cooling. The Thermostat Controller app allows more control of your connected thermostat by creating a virtual thermostat device to manipulate the set-points of the controlled thermostat, thus taking over most of its functionality and becoming the Controller Thermostat for establishing set-points of your heating and cooling system.


  • Supports additional temperature sensors, allowing any connected device with temperature readings available to Hubitat Elevation, to also participate as a remote sensor.
  • Allows control of thermostat hysteresis to set the difference between the temperature at which the thermostat switches OFF, and the temperature at which it switches ON again.
  • Auto mode is available to the Controller Thermostat for conditions where both heating and cooling may be needed
  • OFF function for when manually disabling the heating and cooling system is desired.

Additional Temperature Sensors

Improperly located thermostats are an all too common issue, but the powerful features in Thermostat Controller can help keep the temperature in your living space even by averaging multiple temperature sensors, rather than just using the sensor built into the thermostat. Many motion sensors and some door/windows sensors include temperature readings, that can be combined with the sensor in the thermostat, providing the capability to offset a given sensor's readings, or place more or less weight toward the average from each sensor.

Control of Hysteresis

Hysteresis is the difference between the temperature at which a thermostat switches OFF, and the temperature at which it switches ON again. By careful adjustment of the hysteresis value, the efficiency of the heating and cooling system can be optimized, ensuring maximum comfort in the conditioned space. With a lower hysteresis value, the system will cycle more frequently and the temperature swings in your living space will be lower. A wider hysteresis will result in the heating and cooling system cycling less frequently, thus resulting in correspondingly larger temperature swings. For example, with a default hysteresis value of 1.0 ˚F, and a thermostat setting to 75 °F, cooling will be called for when the temperature exceeds the 75 °F plus half of the hysteresis, or 75.5 °F. Once cooling begins. The system will remain ON until the average temperature has been reduced to 75 °F minus half the hysteresis value, or 74.5 °F.

Auto Mode Thermostat

Once the Thermostat Controller app takes control of a thermostat, its heating and cooling operation becomes automatic and will be dependent on the established setting of the Controller Thermostat. A heating and cooling system will typically move at least 3° F between ON and OFF cycles. As an example, when the average temperature falls below the thermostat setting (less half the hysteresis), heating will be called for. Should the temperature rise above the heat setting (plus half the hysteresis), the system will return to idle. If the temperature continues to rise and reaches the cooling set-point (plus half the hysteresis), cooling would be called for.

If Auto mode is not desired, and you only want the system to operate cooling or heating independently, simply adjust the set-point for the unwanted mode well out of a meaningful range.

WARNING! The Thermostat Controller app takes over control and most safeguards of the existing thermostat. Be sure to set the minimum and maximum values so that if the hub were to fail, the actual thermostat will not end up in a run-away condition.

Use with Thermostat Scheduler

To add scheduling for the Controller Thermostat, it may be selected in the Thermostat Scheduler app.

WARNING! Do not use the Thermostat Scheduler app directly on an actual thermostat that is already under the control of the Thermostat Controller app.

Thermostat Fan Mode

The Controller Thermostat created by the Thermostat Controller app will inherit fan modes from the actual thermostat. Fan speed adjustments made to either the actual or virtual thermostats will mirror each other.

NOTE: Thermostat fan mode may also be set on the Controller Thermostat by the Thermostat Scheduler app, which would then set it on the actual thermostat that the Thermostat Controller app is manipulating.

Installing Thermostat Controller

  1. From the sidebar of your hub, select Apps and press the Add Built-In App button.
    Install Built-In App 2.0.png
  2. Choose Thermostat Controller from the list of Hubitat Elevation Built-In Apps
    Install Thermostat Controller.png

Creating a Controller Thermostat

  1. Select the actual thermostat to take over its control, with the creation of a virtual Controller Thermostat device.
    Thermostat Controller - Select and name.png
  2. Select the temperature sensors to use. If you select more than one temperature sensor, the average between them will be used.
    • WARNING! You may select the real thermostat to be controlled if it contains a temperature sensor, but DO NOT select the virtual Controller Thermostat.
      Thermostat Controller - Select temp sensor.png
  3. If a temperature sensor's readings are out of balance with the other temperature sensors used, it may be necessary to enter a Temperature Offset value, or adjust the Weighting to place more or less weight toward the average for each sensor. This Weighting becomes the controlling value for determining when to call for heating or cooling.
    Thermostat Controller - Weighting and Offsets.png
    Enter Weighting and Offsets.png
  4. Press on the Controlled Thermostat and enter a Required Set-Point Separation value for Auto mode, then enable the Controller Thermostat to take over control of the actual thermostat selected in Step 1.
    Thermostat Controller - Select Controlled Thermostat.png
  5. Set the Free/Controlled switch to Controlled to enable the virtual Controller Thermostat to take over control of functions from the actual thermostat.
    Set Thermostat Controller to Controlled.png
  6. If you are using Auto mode, press on the Controlled Thermostat and enter the Required Set-point Separation. This will prevent endless cycling between cooling and heating when their respective set-points have been reached, but slightly exceeded.
    Enter Set-point separation.png

Using the Thermostat Controller virtual device

  1. From the Devices page, you can access the Controller Thermostat device to manually adjust settings, or control device attributes with Rule Machine rules.
    Thermostat Controller device.png