ThermostatEco のスキーマ
sdm.devices.traits.ThermostatEco
このトレイトは、エコモードをサポートする THERMOSTAT のデバイスタイプに使用します。
フィールド
項目 | 説明 | データ型 |
---|---|---|
availableModes |
サポートされているエコモードのリスト。 | array(string) 値: ["MANUAL_ECO", "OFF"] |
mode |
サーモスタットの現在のエコモード。 | string 値: 「MANUAL_ECO」、「OFF」 |
heatCelsius |
サーモスタットのエコモードで暖房を開始する最低温度(摂氏)。 | number 例: 20.0 |
coolCelsius |
エコモードでサーモスタットの冷房を開始する最高温度(摂氏)。 | number 例: 22.0 |
GET リクエストとレスポンスの例
リクエスト
GET /enterprises/project-id/devices/device-id
レスポンス
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatEco
" : {
"availableModes" : ["MANUAL_ECO", "OFF"],
"mode" : "MANUAL_ECO",
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
コマンド
SetMode
サーモスタットのエコモードを変更する。
サーモスタットのモードを HEAT、COOL、HEATCOOL に変更するには、The ThermostatMode トレイトの SetMode コマンドを使用します。
このコマンドは、エコモードの現在のステータスやエコモードの変更に基づいて、他のトレイトに影響します。
- エコモードがオフの場合、前回アクティブだった標準モード(暖房、冷房、HEATCOOL、オフ)がデフォルトで設定されます。
- エコモードが MANUAL_ECO の場合:
- ThermostatTemperatureSetpoint トレイトのコマンドは拒否されます。
- 温度設定値は、 ThermostatTemperatureSetpoint トレイトでは返されません。
SetMode リクエストとレスポンス
リクエスト
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatEco.SetMode
",
"params" : {
"mode" : "MANUAL_ECO"
}
}
レスポンス
{}
SetMode リクエスト フィールド
項目 | 説明 | データ型 |
---|---|---|
mode |
サーモスタットを切り替えるエコモード。 | string 値: 「MANUAL_ECO」、「OFF」 |
エラー
このトレイトに関連して、次のエラーコードが返されることがあります。
エラー メッセージ | RPC | トラブルシューティング |
---|---|---|
現在のサーモスタット モードではコマンドを使用できません。 | FAILED_PRECONDITION |
ThermostatMode トレイトによれば、一部のサーモスタット モデルでは、サーモスタット モードがオフのときにエコモードを変更できないことがあります。エコモードを変更する前に、サーモスタットのモードを HEAT、COOL、HEATCOOL のいずれかに変更する必要があります。 |
サーモスタットが MANUAL_ECO モードの場合、コマンドは使用できません。 | FAILED_PRECONDITION |
サーモスタットが手動エコモードの場合、温度設定値は設定できません。 |
API エラーコードの完全なリストについては、API エラーコード リファレンスをご覧ください。