ThermostatTemperatureSetpoint 架构
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 | heatCelsius 、coolCelsius |
请注意,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 错误代码参考。