Skip to Content
🚀 We just launched! Please star us on Github!

Thermostat Device

Device Category: thermostat

The Thermostat device represents a climate control system that monitors and adjusts temperature and related environmental factors.


Required Channels

These channels are mandatory for the functionality of the thermostat:

ChannelDescriptionMultipleDetails
temperatureMeasures the current temperature in an environment, reported in degrees Celsius.NoSee details
thermostatManages climate control systems, allowing adjustments of heating, cooling, and fan settings.NoSee details
device_informationProvides metadata about the device, including manufacturer details, model information, and operational statuses.NoSee details

Optional Channels

These channels are optional and provide additional features:

ChannelDescriptionMultipleDetails
contactTracks the open or closed state of a contact point, such as a door, window, or cabinet.NoSee details
coolerControls devices that lower air or liquid temperatures, such as air conditioners or refrigeration systems.NoSee details
heaterManages heating devices, allowing control of temperature settings and modes.NoSee details
humidityMeasures the relative humidity in the environment, reported as a percentage.NoSee details
electrical_energyMeasures the total energy consumption over time, typically reported in kilowatt-hours (kWh).NoSee details
electrical_powerReports real-time power metrics such as voltage, current, and wattage for monitoring and diagnostics.NoSee details

Use Case Scenarios

  1. Temperature Control:

    • Set target temperatures and HVAC modes using the thermostat channel. Monitor current temperature with the temperature channel.
  2. Climate Scheduling:

    • Configure heating and cooling schedules through thermostat modes (home, away, sleep, eco).
  3. Multi-Zone Control:

    • Integrate with heater and cooler channels for precise zone-based climate management.

Developer Notes

  1. Temperature and thermostat channels are required for core functionality.
  2. Optional heater/cooler channels provide direct control when supported.
  3. Contact channel can be used for occupancy-based automation.
Last updated on