Schéma de la température de consigne du thermostat

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Cette caractéristique appartient aux types d'appareils THERMOSTAT qui permettent de définir la température cible et la plage de température.

Champs

Champ Description Type de données
heatCelsius Température de consigne en degrés Celsius pour les modes HEAT et HEATCOOL du thermostat. number
Exemple: 20,0
coolCelsius Température de consigne en degrés Celsius pour les modes COOL et HEATCOOL du thermostat. number
Exemple : 22,0

Exemple de requête et de réponse GET - HEAT

Requête

GET /enterprises/project-id/devices/device-id

Réponse

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
    }
  }
}

Exemple de requête et de réponse GET – COOL

Requête

GET /enterprises/project-id/devices/device-id

Réponse

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "coolCelsius" : 22.0
    }
  }
}

Exemple de requête et de réponse GET : HEATCOOL

Requête

GET /enterprises/project-id/devices/device-id

Réponse

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatTemperatureSetpoint" : {
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Commandes

Le thermostat doit être en mode correspondant à la commande appelée avant de modifier les points de consigne de température. La commande et les champs permettant de modifier les températures mémorisées varient en fonction du mode du thermostat.

Par exemple, pour émettre la commande SetHeat, le thermostat doit d'abord être en mode CHAUFFAGE :

Mode Commande Champ(s)
AUXILIAIRE SetHeat heatCelsius
FROID SetCool coolCelsius
HEATCOOL SetRange heatCelsius, coolCelsius

Notez que les commandes de température mémorisée ne prennent en compte que les degrés Celsius en tant que paramètres, alors que le Google Nest Thermostat peut afficher la température en degrés Celsius ou Fahrenheit.

SetHeat

Définit la température de consigne lorsque le thermostat est en mode CHAUFFAGE.

Requête et réponse SetHeat

Requête

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

Réponse

{}

Champs de requête SetHeat

Champ Description Type de données
heatCelsius Température de consigne à définir lorsque le thermostat est en mode CHAUFFAGE. number
Exemple : 22,0

SetCool

Définit la température de consigne lorsque le thermostat est en mode CLIMATISATION.

Requête et réponse SetCool

Requête

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

Réponse

{}

Champs de requête SetCool

Champ Description Type de données
coolCelsius Température de consigne à définir lorsque le thermostat est en mode CLIM. number
Exemple : 20,0

SetRange

Définit les températures minimale et maximale lorsque le thermostat est en mode HEATCOOL.

Requête et réponse SetRange

Requête

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

Réponse

{}

Champs de requête SetRange

Champ Description Type de données
heatCelsius Température de consigne minimale à définir lorsque le thermostat est en mode CHAUFFAGE. number
Exemple : 20,0
coolCelsius Température de consigne maximale à définir lorsque le thermostat est en mode HEATCOOL. number
Exemple : 22,0

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés en lien avec cette caractéristique:

Message d'erreur RPC Dépannage
Commande non autorisée en mode thermostat actuel. FAILED_PRECONDITION Certains modèles de thermostats ne permettent pas de modifier le mode Éco lorsque le mode du thermostat est ÉTEINT, selon le trait ThermostatMode . Vous devez définir le mode du thermostat sur CHAUFFAGE, CLIMATISATION ou CHAUFFAGE/CLIMATISATION avant de modifier le mode Éco.
La valeur de refroidissement doit être supérieure à la valeur de chauffage. INVALID_ARGUMENT Assurez-vous que le champ heatCelsius est inférieur au champ coolCelsius dans votre commande.
Commande non autorisée lorsque le thermostat est en mode MANUAL_ECO. FAILED_PRECONDITION Impossible de régler la température mémorisée lorsque le thermostat est en mode Éco manuel.

Consultez la documentation de référence sur les codes d'erreur de l'API pour obtenir la liste complète des codes d'erreur de l'API.