ThermostatTemperatureSetpoint 結構定義
sdm.devices.traits.ThermostatTemperatureSetpoint
這項特徵屬於可設定目標溫度和溫度範圍的 THERMOSTAT 裝置類型。
欄位
欄位 | 說明 | 資料類型 |
---|---|---|
heatCelsius |
溫度控制器的加熱和暖氣模式的目標溫度 (以攝氏為單位)。 | 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
在溫度控制器處於 COOL 模式時設定目標溫度。
SetCool 要求與回應
要求
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
回應
{}
SetCool 要求欄位
欄位 | 說明 | 資料類型 |
---|---|---|
coolCelsius |
溫度控制器處於 COOL 模式時設定的目標溫度。 | 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 |
錯誤
系統可能會根據這個特徵傳回以下錯誤代碼:
錯誤訊息 | RPC | 疑難排解 |
---|---|---|
目前的溫度控制器模式不支援指令。 | FAILED_PRECONDITION |
根據 ThermostatMode 特徵,部分溫度控制器型號不支援在溫度控制器關閉時變更節能模式。你必須先將溫度控制器模式變更為「暖氣」、「COOL」或「HEATCOOL」,才能變更節能模式。 |
冷氣值必須大於熱量值。 | INVALID_ARGUMENT |
請確認 heatCelsius 欄位小於指令中的 coolCelsius 欄位。 |
溫度控制器在 MANUAL_ECO 模式下無法使用指令。 | FAILED_PRECONDITION |
如果溫度控制器處於手動節能模式,就無法設定溫度設定點。 |
如需 API 錯誤代碼的完整清單,請參閱 API 錯誤代碼參考資料。