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)
Value: ["MANUAL_ECO", "OFF"]
mode Der aktuelle Eco-Modus des Thermostats. string
Values: "MANUAL_ECO", "OFF"
heatCelsius Niedrigste Temperatur in Grad Celsius, bei der der Thermostat im Eco-Modus mit dem Heizen beginnt. number
Example: 20.0
coolCelsius Höchste Temperatur in Grad Celsius, bei der der Thermostat im Eco-Modus mit dem Kühlen beginnt. number
Example: 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.

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

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

  • Wenn der Eco-Modus OFF ist, wird der Thermostatmodus standardmäßig auf den letzten aktiven Standardmodus (HEAT, COOL, HEATCOOL oder OFF) gesetzt.
  • 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 geändert werden soll. string
Values: "MANUAL_ECO", "OFF"

Fehler

Die folgenden Fehlercodes können im Zusammenhang mit diesem Merkmal zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
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 MerkmalThermostatMode OFF ist. Der Thermostatmodus muss in HEAT, COOL oder HEATCOOL geändert werden, bevor der Eco-Modus geändert werden kann.
Befehl ist nicht zulässig, wenn der Thermostat im Modus MANUAL_ECO ist. FAILED_PRECONDITION Der Temperatursollwert kann nicht festgelegt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet.

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