ThermostatEco-Schema
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.
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.