ThermostatEco-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Diese Eigenschaft gehört zu den 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 Celsius, bei der der Thermostat im Eco-Modus zu heizen beginnt.	number Beispiel: 20,0
coolCelsius	Höchste Temperatur in Celsius, bei der der Thermostat im Eco-Modus zu 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

Eco-Modus des Thermostats ändern

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:
• Befehle für das Merkmal ThermostatTemperatureSetpoint werden abgelehnt.
• Vom Trait ThermostatTemperatureSetpoint werden keine Temperatursollwerte zurückgegeben.

Laut der Eigenschaft Thermostatmodus kann bei einigen Thermostatmodellen der Eco-Modus nicht geändert werden, wenn der Thermostatmodus ausgeschaltet ist. Der Modus des Thermostats muss vor dem Ändern des Eco-Modus zu HEIZEN, KÜHLEN oder HEIZEN gewechselt werden.

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, auf den der Thermostat umgestellt werden soll.	string Werte: „MANUAL_ECO“, „OFF“

Fehler

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

Fehlermeldung	RPC	Fehlerbehebung
Dieser Befehl ist im aktuellen Thermostatmodus nicht zulässig.	FAILED_PRECONDITION	Laut der Eigenschaft Thermostatmodus kann bei einigen Thermostatmodellen der Eco-Modus nicht geändert werden, wenn der Thermostatmodus ausgeschaltet ist. Der Modus des Thermostats muss vor dem Ändern des Eco-Modus in HEIZEN, KÜHLEN oder HEIZEN geändert werden.
Befehl nicht zulässig, wenn sich der Thermostat im MANUAL_ECO-Modus befindet.	FAILED_PRECONDITION	Der Temperatursollwert kann nicht festgelegt werden, wenn sich der Thermostat im manuellen Eco-Modus befindet.

In der API-Fehlercode-Referenz können Sie nachlesen, die vollständige Liste der API-Fehlercodes.