ThermostatTemperatureSetpoint-Schema

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Dieses Attribut gehört zu Gerätetypen von THERMOSTAT, die das Festlegen der Zieltemperatur und des Temperaturbereichs unterstützen.

Felder

Feld Beschreibung Datentyp
heatCelsius Zieltemperatur in Grad Celsius für die Thermostatmodi „HEIZEN“ und „HEIZEN/KÜHLEN“. number
Beispiel: 20.0
coolCelsius Soll-Temperatur in Grad Celsius für die Thermostatmodi „KÜHLEN“ und „HEIZEN/KÜHLEN“. number
Beispiel: 22.0

Beispiel für GET-Anfrage und -Antwort – HEAT

Anfrage

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

Anfrage

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 GET-Anfrage und ‑Antwort – HEATCOOL

Anfrage

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 Temperatur-Sollwerte geändert werden. Der Befehl und die Felder zum Ändern der Sollwerte variieren je nach Thermostatmodus.

Wenn Sie beispielsweise den Befehl SetHeat ausgeben möchten, muss sich der Thermostat zuerst im HEIZMODUS befinden:

Modus Befehl Feld(er)
HEIZUNG SetHeat heatCelsius
KÜHL SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Die Sollwertbefehle akzeptieren nur Grad Celsius als Parameter, obwohl der Google Nest Thermostat die Temperatur in Grad Celsius oder Fahrenheit anzeigen kann.

SetHeat

Legt die Zieltemperatur fest, wenn sich der Thermostat im HEIZEN-Modus befindet.

„SetHeat“-Anfrage und -Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat",
  "params" : {
    "heatCelsius" : 22.0
  }
}

Antwort

{}

Felder für SetHeat-Anfrage

Feld Beschreibung Datentyp
heatCelsius Die Soll-Temperatur, die eingestellt werden soll, wenn sich der Thermostat im HEIZ-Modus befindet. number
Beispiel: 22.0

SetCool

Legt die Zieltemperatur fest, wenn sich der Thermostat im Modus „Kühlen“ befindet.

„SetCool“-Anfrage und -Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool",
  "params" : {
    "coolCelsius" : 20.0
  }
}

Antwort

{}

Felder für SetCool-Anfrage

Feld Beschreibung Datentyp
coolCelsius Die Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Modus „Kühlen“ befindet. number
Beispiel: 20.0

SetRange

Legt die Mindest- und Höchsttemperatur fest, wenn sich der Thermostat im Modus „HEIZEN & KÜHLEN“ befindet.

SetRange-Anfrage und -Antwort

Anfrage

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange",
  "params" : {
    "heatCelsius" : 20.0,
    "coolCelsius" : 22.0
  }
}

Antwort

{}

Anfragefelder für „SetRange“

Feld Beschreibung Datentyp
heatCelsius Die niedrigste Zieltemperatur, die eingestellt werden kann, wenn sich der Thermostat im Heiz-/Kühlmodus befindet. number
Beispiel: 20.0
coolCelsius Die maximale Zieltemperatur, die eingestellt werden kann, wenn sich der Thermostat im Heiz-/Kühlmodus befindet. number
Beispiel: 22.0

Fehler

Die folgenden Fehlercodes können in Bezug auf dieses Attribut zurückgegeben werden:

Fehlermeldung RPC Fehlerbehebung
Der Befehl ist im aktuellen Thermostatmodus nicht zulässig. FAILED_PRECONDITION Bei einigen Thermostatmodellen kann der Eco-Modus nicht geändert werden, wenn der Thermostatmodus gemäß dem ThermostatMode -Trait auf „Aus“ eingestellt ist. Der Thermostatmodus muss auf HEIZEN, KÜHLEN oder HEIZENKÜHLEN geändert werden, bevor der Eco-Modus geändert werden kann.
Der Wert für „Kühlen“ muss größer sein als der Wert für „Heizen“. INVALID_ARGUMENT Achten Sie darauf, dass das Feld heatCelsius in Ihrem Befehl kleiner ist als das Feld coolCelsius.
Befehl nicht zulässig, wenn sich der Thermostat im Modus MANUAL_ECO befindet. FAILED_PRECONDITION Der Sollwert für die Temperatur 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.