ThermostatTemperatureSetpoint-Schema
sdm.devices.traits.ThermostatTemperatureSetpoint
Diese Eigenschaft gehört zu den Gerätetypen von THERMOSTAT, die das Festlegen von Zieltemperaturen und Zieltemperaturen unterstützen.
Felder
Feld | Beschreibung | Datentyp |
---|---|---|
heatCelsius |
Die Zieltemperatur in Celsius für die Modi „Heizen“ und „Kühlen“ des Thermostats. | number Beispiel: 20,0 |
coolCelsius |
Die Zieltemperatur in Celsius für die Modi „KÜHLEN“ und „HEIZKÜHLEN“ des Thermostats. | number Beispiel: 22,0 |
Beispiel für GET-Anfrage und -Antwort – HEAT
Anfragen
GET /enterprises/project-id/devices/device-id
Antwort
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
Beispiel für GET-Anfrage und -Antwort – COOL
Anfragen
GET /enterprises/project-id/devices/device-id
Antwort
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
Beispiel für eine GET-Anfrage und -Antwort – HEATCOOL
Anfragen
GET /enterprises/project-id/devices/device-id
Antwort
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Befehle
Der Thermostat muss sich in dem Modus befinden, der dem aufgerufenen Befehl entspricht, bevor die Temperatursollwerte geändert werden. Befehl und Feld(e) zum Ändern der Sollwerte variieren je nach Thermostatmodus.
Für den Befehl „SetHeat“ muss sich der Thermostat beispielsweise zuerst im Heizmodus befinden:
Modus | Befehl | Feld(er) |
---|---|---|
HEIZUNG | SetHeat | heatCelsius |
KÜHLEN | SetCool | coolCelsius |
HEIZKÜHLEN | SetRange | heatCelsius , coolCelsius |
Beachte, dass für die Sollwertbefehle nur Grad Celsius als Parameter verwendet wird. Der Google Nest Thermostat kann die Temperatur aber auch in Grad Celsius oder Fahrenheit anzeigen.
SetHeat
Legt die Zieltemperatur fest, wenn sich der Thermostat im Heizmodus befindet.
SetHeat-Anfrage und -Antwort
Anfragen
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
Antwort
{}
SetHeat-Anfragefelder
Feld | Beschreibung | Datentyp |
---|---|---|
heatCelsius |
Die Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im HEIZEN-Modus befindet. | number Beispiel: 22,0 |
SetCool
Legt die Zieltemperatur fest, wenn sich der Thermostat im Modus KÜHLEN befindet.
SetCool-Anfrage und -Antwort
Anfragen
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
Antwort
{}
SetCool-Anfragefelder
Feld | Beschreibung | Datentyp |
---|---|---|
coolCelsius |
Die Zieltemperatur, die festgelegt werden soll, wenn sich der Thermostat im Modus KÜHLEN befindet. | number Beispiel: 20,0 |
SetRange
Legt die Mindest- und Höchsttemperaturen fest, wenn sich der Thermostat im Modus HEIZKÜHLEN befindet.
SetRange-Anfrage und -Antwort
Anfragen
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
Antwort
{}
SetRange-Anfragefelder
Feld | Beschreibung | Datentyp |
---|---|---|
heatCelsius |
Die minimale Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Modus HEIZENKÜHLEN befindet. | number Beispiel: 20,0 |
coolCelsius |
Die maximale Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Modus HEIZKÜHLEN befindet. | number Beispiel: 22,0 |
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. |
Kühlwert muss größer als Heizwert sein. | INVALID_ARGUMENT |
Achten Sie darauf, dass das Feld heatCelsius kleiner als das Feld coolCelsius im Befehl ist. |
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.