Schema für ThermostatTemperatursollwert

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Diese Eigenschaft gehört zu den Gerätetypen von THERMOSTAT, die das Einstellen von Zieltemperatur und Temperaturbereich unterstützen.

Felder

Feld Beschreibung Datentyp
heatCelsius Zieltemperatur in Celsius für die Modi „HEAT“ und „HEATCOOL“ des Thermostats. number
Beispiel: 20,0
coolCelsius Zieltemperatur in Celsius für die Modi KÜHLEN und HEIZEN des Thermostats. number
Beispiel: 22,0

Beispiel für eine 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 eine 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 eine 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 Sie den Thermostat ändern. die Temperatursollwerte. Der Befehl und die Felder zum Ändern der Sollwerte variieren je nach Thermostat .

Um beispielsweise die SetHeat muss sich der Thermostat zuerst im Heizmodus befinden:

Modus Befehl Feld(er)
HEIZUNG SetHeat heatCelsius
KÜHLEN SetCool coolCelsius
HEIZKÜHLEN SetRange heatCelsius, coolCelsius

Beachten Sie, dass die Sollwertbefehle als Parameter nur Grad in Celsius angeben. Der Parameter Der Google Nest Thermostat kann die Temperatur entweder in Grad Celsius oder Fahrenheit anzeigen.

SetHeat

Legt die Zieltemperatur fest, wenn sich der Thermostat im Heizmodus 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

{}

SetHeat-Anfragefelder

Feld Beschreibung Datentyp
heatCelsius Die Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Heizmodus befindet. number
Beispiel: 22,0

SetCool

Legt die Zieltemperatur fest, wenn sich der Thermostat im Kühlmodus 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

{}

SetCool-Anfragefelder

Feld Beschreibung Datentyp
coolCelsius Die Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Kühlmodus befindet. number
Beispiel: 20,0

SetRange

Stellt die Mindest- und Höchsttemperaturen ein, wenn sich der Thermostat im Modus HEATKÜ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

{}

SetRange-Anfragefelder

Feld Beschreibung Datentyp
heatCelsius Die minimale Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Modus HEATCOOL befindet. number
Beispiel: 20,0
coolCelsius Die maximale Zieltemperatur, die eingestellt werden soll, wenn sich der Thermostat im Modus „Heizen Kühlen“ befindet. number
Beispiel: 22,0

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.
Der Kühlwert muss größer als der Heizwert sein. 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 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.