ThermostatTemperatureSetpoint-Schema

Nest Thermostat 

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.