ThermostatEco-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Dieses Merkmal gehört zu Gerätetypen von THERMOSTAT, die ECO-Modi unterstützen.

Felder

Feld Beschreibung Datentyp
availableModes Liste der unterstützten Eco-Modi. array(string)
Wert: ["MANUAL_ECO", "OFF"]
mode Der aktuelle Eco-Modus des Thermostats. string
Werte: „MANUAL_ECO“, „OFF“
heatCelsius Niedrigste Temperatur in Grad Celsius, bei der der Thermostat im Eco-Modus mit dem Heizen beginnt. number
Beispiel: 20.0
coolCelsius Höchste Temperatur in Grad Celsius, bei der der Thermostat im Eco-Modus mit dem Kühlen beginnt. number
Beispiel: 22.0

Beispiel für GET-Anfrage und -Antwort

Anfrage

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

Antwort

{
  "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
    }
  }
}

Befehle

SetMode

Eco-Modus des Thermostats ändern

Wenn Sie den Thermostatmodus auf HEAT, COOL oder HEATCOOL ändern möchten, verwenden Sie den Befehl SetMode des ThermostatMode-Traits.

Dieser Befehl wirkt sich je nach aktuellem Status oder Änderungen des Öko-Modus auf andere Merkmale aus:

  • Wenn der Eco-Modus deaktiviert ist, wird der Thermostatmodus standardmäßig auf den zuletzt aktiven Standardmodus (HEIZEN, KÜHLEN, HEIZEN/KÜHLEN oder AUS) zurückgesetzt.
  • Wenn der Eco-Modus MANUAL_ECO ist:

SetMode-Anfrage und ‑Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

Antwort

{}

SetMode-Anfragefelder

Feld Beschreibung Datentyp
mode Der Eco-Modus, in den der Thermostat wechseln soll. string
Werte: „MANUAL_ECO“, „OFF“

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Attribut zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Bei einigen Thermostatmodellen kann der Eco-Modus nicht geändert werden, wenn der Thermostatmodus gemäß dem ThermostatMode -Trait auf „Aus“ eingestellt ist. Der Thermostatmodus muss auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN geändert werden, bevor der Eco-Modus geändert werden kann.
Befehl nicht zulässig, wenn sich der Thermostat im Modus MANUAL_ECO befindet. FAILED_PRECONDITION Der Sollwert für die Temperatur kann nicht eingestellt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet.

Eine vollständige Liste der API-Fehlercodes finden Sie in der API-Fehlercode-Referenz.