Thermostat Cluster

Cluster ID: 0x0201  |  Endpoint: Typically on Endpoint 1 (functional endpoint)

Thermostat is the core Cluster for Matter HVAC devices, defining all capabilities including temperature reading, cooling/heating setpoint management, system mode switching, and weekly schedule programming. All thermostat device development revolves around this Cluster.

Commands

Thermostat commands are primarily used to adjust setpoints and manage weekly schedules. Unlike door locks, thermostat commands do not require Timed Interaction and can be sent directly. Click a command ID in the table below to jump to its detailed description.

SetpointRaiseLower — Adjust Setpoint (0x00)

Raise or lower temperature setpoints. This is the most commonly used command for thermostat devices — called when the user taps the "Temperature +" or "Temperature -" buttons in the App. Depending on the Mode parameter, you can adjust only the heating setpoint, only the cooling setpoint, or both simultaneously.

↑ Back to Commands

SetWeeklySchedule — Set Weekly Schedule (0x01)

Set temperature transition schedules for specified days of the week. Multiple days and time points can be set in a single call. Requires device support for the SCH (Schedule) Feature.

↑ Back to Commands

GetWeeklySchedule — Query Weekly Schedule (0x02)

Query configured weekly schedules. Specify the desired days and mode; the device returns the corresponding transition table.

↑ Back to Commands

ClearWeeklySchedule — Clear Weekly Schedule (0x03)

Clear all weekly schedules on the device. No parameters; after execution, the device returns to a no-schedule state.

↑ Back to Commands

Attributes

Thermostat Cluster attributes are organized into five functional groups. Click an attribute ID in the summary table below to jump to its detailed description.

Temperature Information (0x00-0x09)

Basic measurements, absolute limits, and system demand information for the thermostat device.

↑ Back to Attributes

Setpoints (0x10-0x19)

Temperature setpoints are the core of thermostat control — the device determines heating/cooling actions based on the difference between setpoints and current temperature.

↑ Back to Attributes

Mode & Status (0x1A-0x29)

Defines the thermostat system's operating modes, scheduling capabilities, and current running status.

SystemMode Enum Values

ControlSequenceOfOperation Enum Values

ThermostatRunningMode Enum Values

Available only with the AUTO Feature, indicates the system's current actual operating direction:

ThermostatRunningState Bitmap

TemperatureSetpointHold Enum Values

ThermostatProgrammingOperationMode Bitmap

StartOfWeek Enum Values

↑ Back to Attributes

Change Tracking & Energy Saving (0x30-0x3A)

Tracks setpoint change sources and history, as well as energy-saving setback configuration.

SetpointChangeSource Enum Values

↑ Back to Attributes

AC Capabilities (0x40-0x47)

Hardware capabilities and operating parameters for AC units. This group of attributes is primarily used for Mini Split AC devices.

ACType Enum Values

ACRefrigerantType Enum Values

ACCompressorType Enum Values

ACLouverPosition Enum Values

↑ Back to Attributes

Standard Example

Below is a typical attribute data example for a Matter thermostat (JSON format), with each field annotated:

{
  // --- Temperature Info ---
  "0x00": 2150,          // LocalTemperature = 2150 → actual 21.50°C
  "0x01": 3200,          // OutdoorTemperature = 3200 → actual 32.00°C
  "0x02": 1,             // Occupancy = 1 (occupied)

  // --- Setpoints ---
  "0x11": 2400,          // OccupiedCoolingSetpoint = 2400 → 24.00°C
  "0x12": 2000,          // OccupiedHeatingSetpoint = 2000 → 20.00°C
  "0x15": 700,           // MinHeatSetpointLimit = 700 → 7.00°C
  "0x16": 3000,          // MaxHeatSetpointLimit = 3000 → 30.00°C
  "0x17": 1600,          // MinCoolSetpointLimit = 1600 → 16.00°C
  "0x18": 3200,          // MaxCoolSetpointLimit = 3200 → 32.00°C
  "0x19": 25,            // MinSetpointDeadBand = 25 → 2.5°C

  // --- Mode & Status ---
  "0x1B": 4,             // ControlSequenceOfOperation = CoolingAndHeating
  "0x1C": 1,             // SystemMode = Auto
  "0x1E": 3,             // ThermostatRunningMode = Cool
  "0x29": 0x0006,        // ThermostatRunningState = CoolStateOn + FanStateOn

  // --- AC Capabilities ---
  "0x40": 3,             // ACType = CoolingAndInverter
  "0x41": 12000,         // ACCapacity = 12000 (BTU/h)
  "0x42": 2,             // ACRefrigerantType = R410a
  "0x45": 4              // ACLouverPosition = HalfOpen
}

Common Scenarios