ThermostatEco-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Diese Eigenschaft gehört zu Gerätetypen vom Typ 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 Die 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 eine GET-Anfrage und -Antwort

AnfrageAntwort
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
    }
  }
}

Befehle

SetMode

Ändern Sie den Eco-Modus des Thermostats.

Verwenden Sie den Befehl SetMode der Eigenschaft „ThermostatMode“, um den Thermostatmodus in „HEAT“, „COOL“ oder „HEATCOOL“ zu ändern.

Dieser Befehl wirkt sich je nach aktuellem Status oder Änderungen am Eco-Modus auf andere Eigenschaften aus:

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

SetMode-Anfrage und -Antwort

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

{}

Anfragefelder für SetMode

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

Fehler

In Bezug auf dieses Attribut können die folgenden Fehlercodes zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Einige Thermostatmodelle unterstützen gemäß der Eigenschaft ThermostatMode nicht das Ändern des Eco-Modus, wenn der Thermostatmodus deaktiviert ist. Der Thermostatmodus muss auf „HEIZEN“, „KÜHLEN“ oder „HEIZEN/KÜHLEN“ gestellt sein, bevor der Eco-Modus geändert werden kann.
Befehl nicht zulässig, wenn sich der Thermostat im Modus „MANUAL_ECO“ befindet. FAILED_PRECONDITION Der Temperatursollwert kann nicht festgelegt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet.

Eine vollständige Liste der API-Fehlercodes findest du in der API-Fehlercode-Referenz.