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", "AUS"]
mode	Der aktuelle Eco-Modus des Thermostats.	string Werte: „MANUAL_ECO“, „AUS“
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 mit der Kühlung beginnt.	number Beispiel: 22,0

Beispiel für GET-Anfrage und -Antwort

Anfragen

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

Den Eco-Modus des Thermostats ändern.

Verwenden Sie den Befehl SetMode der Trait „ThermostatMode“, um den Thermostatmodus auf HEIZEN, KÜHLEN oder HEIZKÜHLEN zu ändern.

Dieser Befehl wirkt sich abhängig vom aktuellen Status des Eco-Modus oder von Änderungen am Eco-Modus auf andere Merkmale aus:

• Wenn der Eco-Modus deaktiviert ist, wird standardmäßig der letzte aktive Standardmodus (HEITEN, KÜHLEN, HEIZKÜHLEN oder AUS) verwendet.
• Wenn der Eco-Modus auf MANUAL_ECO gesetzt ist:
• Befehle für die Eigenschaft ThermostatTemperatureSetpoint wurden abgelehnt.
• Temperatursollwerte werden von der Eigenschaft ThermostatTemperatureSetpoint nicht zurückgegeben.

Laut der Eigenschaft ThermostatMode ist es bei einigen Thermostatmodellen nicht möglich, den Eco-Modus zu ändern, wenn der Thermostatmodus ausgeschaltet ist. Der Thermostatmodus muss vor dem Umschalten auf den Eco-Modus auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN umgestellt werden.

SetMode-Anfrage und -Antwort

Anfragen

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 eingestellt werden soll.	string Werte: „MANUAL_ECO“, „AUS“

Fehler

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

Fehlermeldung	RPC	Fehlerbehebung
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig.	FAILED_PRECONDITION	Bei einigen Thermostatmodellen wird es gemäß der Eigenschaft ThermostatMode nicht unterstützt, den Eco-Modus zu ändern, wenn der Thermostatmodus ausgeschaltet ist. Der Thermostatmodus muss vor dem Umschalten auf den Eco-Modus auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN umgestellt werden.
Der Befehl ist nicht zulässig, wenn sich der Thermostat im Modus „MANUAL_ECO“ befindet.	FAILED_PRECONDITION	Der Temperatursollwert 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.