ThermostatMode 架构

Nest Thermostat 

sdm.devices.traits.ThermostatMode

此 trait 属于支持不同温控器模式的 THERMOSTAT 设备类型。

字段

字段 说明 数据类型
availableModes 支持的温控器模式列表。 array(string)
值：[“HEAT”“COOL”“HEATCOOL”“OFF”]
mode 温控器的当前模式。 string
值：“HEAT”“COOL”“HEATCOOL”“OFF”

GET 请求和响应示例

请求响应
GET /enterprises/project-id/devices/device-id
 
{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatMode" : {
      "availableModes" : ["HEAT", "COOL", "HEATCOOL", "OFF"],
      "mode" : "COOL"
    }
  }
}

命令

SetMode

更改温控器模式。

SetMode 请求和响应

请求响应
POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatMode.SetMode",
  "params" : {
    "mode" : "HEAT"
  }
}

{}

SetMode 请求字段

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

错误

系统可能会针对此 trait 返回以下错误代码：

错误消息 RPC 问题排查
当前温控器模式不允许执行该命令。 FAILED_PRECONDITION 根据 ThermostatMode trait，某些温控器型号不支持在温控器模式为“关闭”时更改节能模式。必须先将温控器模式更改为“HEAT”“COOL”或“HEATCOOL”，然后才能更改节能模式。

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