Schéma ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Ce trait appartient aux types d'appareils THERMOSTAT compatibles avec les modes Éco.

Champs

Champ Description Type de données
availableModes Liste des modes Éco compatibles. array(string)
Value: ["MANUAL_ECO", "OFF"]
mode Mode Éco actuel du thermostat. string
Values: "MANUAL_ECO", "OFF"
heatCelsius Température la plus basse en degrés Celsius à laquelle le thermostat commence à chauffer en mode Éco. number
Example: 20.0
coolCelsius Température la plus élevée en degrés Celsius à laquelle le thermostat commence à refroidir en mode Éco. number
Example: 22.0

Exemple de requête GET et de réponse

Requête

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

Réponse

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

Commandes

SetMode

Modifiez le mode Éco du thermostat.

Pour modifier le mode du thermostat sur CHAUFFAGE, CLIMATISATION ou CHAUFFAGE ET CLIMATISATION, utilisez la commande SetMode du trait ThermostatMode.

Cette commande a une incidence sur d'autres traits, en fonction de l'état actuel du mode Éco ou des modifications apportées à celui-ci :

  • Si le mode Éco est DÉSACTIVÉ, le mode du thermostat est défini par défaut sur le dernier mode standard (CHAUFFAGE, CLIMATISATION, CHAUFFAGE ET CLIMATISATION ou DÉSACTIVÉ) qui était actif.
  • Si le mode Éco est MANUAL_ECO :

Requête et réponse SetMode

Requête

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

Réponse

{}

Champs de la requête SetMode

Champ Description Type de données
mode Mode Éco à définir sur le thermostat. string
Values: "MANUAL_ECO", "OFF"

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés en lien 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 thermostats ne permettent pas de modifier le mode Éco lorsque le mode du thermostat est DÉSACTIVÉ. Le mode du thermostat doit être défini sur CHAUFFAGE, CLIMATISATION ou CHAUFFAGE ET CLIMATISATION avant de pouvoir modifier le mode Éco.
Commande non autorisée lorsque le thermostat est en mode MANUAL_ECO. FAILED_PRECONDITION La température mémorisée ne peut pas être définie 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.