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

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

Ändern Sie den Eco-Modus des Thermostats.

Verwende den Befehl SetMode der Trait „ThermostatMode“, um den Modus des Thermostats in HEIZEN, KÜHLEN oder HEIZEN zu ändern.

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

  • Wenn der Eco-Modus AUS ist, wird standardmäßig der letzte aktive Standardmodus (HEIZEN, KÜHLEN, HEIZEN oder AUS) verwendet.
  • 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

{}

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 laut dem Attribut ThermostatMode nicht, den Eco-Modus zu ändern, 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.