ThermostatTemperatureSetpoint 架构

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

此特征属于支持设置目标温度和温度范围的温控器设备类型。

字段

字段 说明 数据类型
heatCelsius 温控器供暖模式和 HEATCOOL 模式时的目标温度(摄氏度)。 number
示例:20.0
coolCelsius 温控器的 COOL 和 HEATCOOL 模式时的目标温度(摄氏度)。 number
示例:22.0

GET 请求和响应示例 - HEAT

请求

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

响应

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

GET 请求和响应示例 - COOL

请求

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

响应

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

GET 请求和响应示例 - HEATCOOL

请求

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

响应

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

命令

在更改温度设定值之前,温控器必须处于与所调用的命令对应的模式。用于更改设定值的命令和字段因温控器模式而异。

例如,如需发出 SetHeat 命令,温控器必须先处于 HEAT 模式:

模式 命令 字段
制热 SetHeat heatCelsius
SetCool coolCelsius
散热 SetRange heatCelsiuscoolCelsius

请注意,setpoint 命令仅接受摄氏度作为参数,但 Google Nest Thermostat 可以用摄氏度或华氏度显示温度。

SetHeat

设置温控器处于供暖模式时的目标温度。

SetHeat 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

响应

{}

SetHeat 请求字段

字段 说明 数据类型
heatCelsius 当温控器处于供暖模式时要设置的目标温度。 number
示例:22.0

SetCool

设置温控器处于制冷模式时的目标温度。

SetCool 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

响应

{}

SetCool 请求字段

字段 说明 数据类型
coolCelsius 当温控器处于制冷模式时要设置的目标温度。 number
示例:20.0

SetRange

设置温控器处于 HEATCOOL 模式时的最低和最高温度。

SetRange 请求和响应

请求

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

响应

{}

SetRange 请求字段

字段 说明 数据类型
heatCelsius 温控器处于 HEATCOOL 模式时要设置的最低目标温度。 number
示例:20.0
coolCelsius 温控器处于 HEATCOOL 模式时要设置的最高目标温度。 number
示例:22.0

错误数

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

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

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