ThermostatMode 架构
sdm.devices.traits.ThermostatMode
此特征属于支持不同温控器模式的温控器设备类型。
字段
字段 | 说明 | 数据类型 |
---|---|---|
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 特征,某些温控器型号不支持在温控器模式处于关闭状态时更改节能模式。您必须先将温控器模式改为“HEAT”(制热)、“COOL”(制冷)或 HEATCOOL(“HEATCOOL”),然后才能更改节能模式。 |
如需查看 API 错误代码的完整列表,请参阅 API 错误代码参考。