Schéma ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

Ce trait appartient aux types d'appareils THERMOSTAT qui permettent de définir une température de consigne et une plage de températures.

Champs

Champ Description Type de données
heatCelsius Température de consigne en degrés Celsius pour les modes CHAUFFAGE et CHAUFFAGE/CLIMATISATION du thermostat. number
Exemple : 20.0
coolCelsius Température de consigne en degrés Celsius pour les modes CLIMATISATION et CHAUFFAGE/CLIMATISATION du thermostat. number
Exemple : 22.0

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

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 GET et de réponse – CLIMATISATION

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 GET et de réponse – CHAUFFAGE/CLIMATISATION

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 dans le mode correspondant à la commande appelée avant de modifier les températures de consigne. La commande et le ou les champs permettant de modifier la ou les températures de consigne 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)
CHAUFFAGE SetHeat heatCelsius
COOL SetCool coolCelsius
CHAUFFAGE/CLIMATISATION SetRange heatCelsius, coolCelsius

Notez que les commandes de température de consigne n'acceptent que les degrés Celsius comme paramètre, bien que le thermostat Google Nest puisse 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 la 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 la requête SetCool

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

SetRange

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

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 la requête SetRange

Champ Description Type de données
heatCelsius Température de consigne minimale à définir lorsque le thermostat est en mode CHAUFFAGE/CLIMATISATION. number
Exemple : 20.0
coolCelsius Température de consigne maximale à définir lorsque le thermostat est en mode CHAUFFAGE/CLIMATISATION. number
Exemple : 22.0

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés en relation avec ce trait :

Message d'erreur RPC Dépannage
Commande non autorisée dans le mode actuel du thermostat. FAILED_PRECONDITION Selon le trait ThermostatMode , certains modèles de thermostat ne permettent pas de modifier le mode Éco lorsque le thermostat est éteint. Le mode du thermostat doit être défini sur CHAUFFAGE, CLIMATISATION ou CHAUFFAGE/CLIMATISATION avant de pouvoir modifier le mode Éco.
La valeur de climatisation doit être supérieure à la valeur de chauffage. INVALID_ARGUMENT Assurez-vous que le heatCelsius champ est inférieur au coolCelsius champ dans votre commande.
Commande non autorisée lorsque le thermostat est en mode ÉCO MANUEL. FAILED_PRECONDITION La température de consigne ne peut pas être définie lorsque le thermostat est en mode Éco manuel.

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