ThermostatEco 架构

Nest Thermostat 

sdm.devices.traits.ThermostatEco

此特征属于支持 ECO 模式的 THERMOSTAT 设备类型。

字段

字段	说明	数据类型
availableModes	支持的节能模式列表。	array(string) 值：["MANUAL_ECO", "OFF"]
mode	温控器当前的节能模式。	string 值：“MANUAL_ECO”“OFF”
heatCelsius	温控器在节能模式下开始供暖时的最低温度（摄氏度）。	number 示例：20.0
coolCelsius	温控器在节能模式下开始制冷时的最高温度（摄氏度）。	number 示例：22.0

示例 GET 请求和响应

请求

GET /enterprises/project-id/devices/device-id

响应

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

命令

SetMode

更改温控器的节能模式。

如需将温控器模式更改为 HEAT、COOL 或 HEATCOOL，请使用 ThermostatMode 特征的 SetMode 命令。

此命令会影响其他特征，具体取决于节能模式的当前状态或对节能模式的更改：

• 如果节能模式已关闭，温控器将默认采用最后启用的标准模式（HEAT、COOL、HEATCOOL 或 OFF）。
• 如果节能模式为 MANUAL_ECO：
• 针对 ThermostatTemperatureSetpoint 特征的命令会被拒绝。
• ThermostatTemperatureSetpoint 特征不会返回温度设定值。

根据 ThermostatMode 特征，某些温控器型号不支持在温控器模式处于关闭状态时更改节能模式。更改节能模式前，必须将温控器更改为 HEAT、COOL 或 HEATCOOL。

SetMode 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

响应

{}

SetMode 请求字段

字段	说明	数据类型
mode	要将温控器切换到的节能模式。	string 值：“MANUAL_ECO”“OFF”

错误数

可能会返回与此 trait 相关的以下错误代码：

错误消息	RPC	问题排查
在当前温控器模式下，系统不允许使用命令。	FAILED_PRECONDITION	根据 ThermostatMode 特征，某些温控器型号不支持在温控器模式处于关闭状态时更改节能模式。您必须先将温控器模式改为“HEAT”（制热）、“COOL”（制冷）或 HEATCOOL（“HEATCOOL”），然后才能更改节能模式。
当温控器处于 MANUAL_ECO 模式时，系统不允许使用命令。	FAILED_PRECONDITION	当温控器处于手动节能模式时，无法设置温度设定值。

如需查看 API 错误代码的完整列表，请参阅 API 错误代码参考。