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", "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.
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 |
Im manuellen Eco-Modus kann der Temperatursollwert nicht festgelegt werden. |
Siehe API-Fehlercode-Referenz für die vollständige Liste der API-Fehlercodes.