Schéma ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Cette caractéristique 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)
Valeur : ["MANUAL_ECO", "OFF"]
mode Mode Éco actuel du thermostat. string
Valeurs : "MANUAL_ECO", "OFF"
heatCelsius Température minimale en degrés Celsius à partir de laquelle le thermostat commence à chauffer en mode Éco. number
Exemple : 20,0
coolCelsius Température maximale en degrés Celsius à partir de laquelle le thermostat commence à refroidir en mode Éco. number
Exemple: 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

modifier le mode Éco du thermostat ;

Pour définir le mode du thermostat sur CHAUFFAGE, CLIM ou CHAUFFAGE, utilisez la commande SetMode de la caractéristique ThermostatMode.

Cette commande affecte d'autres caractéristiques en fonction de l'état actuel du mode Éco ou des modifications apportées à celui-ci :

  • Si le mode Éco est désactivé, le dernier mode standard activé par défaut (CHAUFFAGE, CLIM, CHAUFFAGE ou ÉTEINDRE) est activé par défaut.
  • 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 requête SetMode

Champ Description Type de données
mode Mode Éco auquel passer le thermostat. string
Valeurs : "MANUAL_ECO", "OFF"

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 dans le mode actuel du thermostat. 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.
Commande non autorisée lorsque le thermostat est en mode MANUAL_ECO. FAILED_PRECONDITION Vous ne pouvez pas définir 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.