SetbackAndOccupancyComponent: {
    attributes: {
        unoccupiedSetback: WritableAttribute<number | null, any>;
        unoccupiedSetbackMax: FixedAttribute<number | null, any>;
        unoccupiedSetbackMin: FixedAttribute<number | null, any>;
    };
}

A ThermostatCluster supports these elements if it supports features Setback and Occupancy.

Type declaration

  • Readonlyattributes: {
        unoccupiedSetback: WritableAttribute<number | null, any>;
        unoccupiedSetbackMax: FixedAttribute<number | null, any>;
        unoccupiedSetbackMin: FixedAttribute<number | null, any>;
    }
    • ReadonlyunoccupiedSetback: WritableAttribute<number | null, any>

      Indicates the amount that the Thermostat server will allow the Calculated Local Temperature to float above the UnoccupiedCoolingSetpoint (i.e., UnoccupiedCoolingSetpoint + UnoccupiedSetback) or below the UnoccupiedHeatingSetpoint setpoint (i.e., UnoccupiedHeatingSetpoint - UnoccupiedSetback) before initiating a state change to bring the temperature back to the user’s desired setpoint. This attribute is sometimes also referred to as the “span.”

      The purpose of this attribute is to allow remote configuration of the span between the desired setpoint and the measured temperature to help prevent over-cycling and reduce energy bills, though this may result in lower comfort on the part of some users.

      The null value indicates the attribute is unused.

      If the Thermostat client attempts to write UnoccupiedSetback to a value greater than UnoccupiedSetbackMax, the Thermostat server shall set its UnoccupiedSetback value to UnoccupiedSetbackMax and shall send a Write Attribute Response command with a Status Code field enumeration of SUCCESS response.

      If the Thermostat client attempts to write UnoccupiedSetback to a value less than UnoccupiedSetbackMin, the Thermostat server shall set its UnoccupiedSetback value to UnoccupiedSetbackMin and shall send a Write Attribute Response command with a Status Code field enumeration of SUCCESS response.

      MatterSpecification.v13.Cluster § 4.3.9.41

    • ReadonlyunoccupiedSetbackMax: FixedAttribute<number | null, any>

      Indicates the maximum value that the Thermostat server will allow the UnoccupiedSetback attribute to be configured by a user.

      The null value indicates the attribute is unused.

      MatterSpecification.v13.Cluster § 4.3.9.43

    • ReadonlyunoccupiedSetbackMin: FixedAttribute<number | null, any>

      Indicates the minimum value that the Thermostat server will allow the UnoccupiedSetback attribute to be configured by a user.

      The null value indicates the attribute is unused.

      MatterSpecification.v13.Cluster § 4.3.9.42