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

RequêteRéponse
GET /enterprises/project-id/devices/device-id
 
{
  "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 HEAT, COOL ou HEATCOOL, utilisez la commande SetMode de la caractéristique ThermostatMode.

Cette commande a une incidence sur 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 mode du thermostat est défini par défaut sur le dernier mode standard (CHAUFFAGE, CLIMATISATION, CHAUFFCLIM ou DÉSACTIVÉ) qui était actif.
  • Si le mode Éco est MANUAL_ECO:

Requête et réponse SetMode

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

{}

Champs de requête SetMode

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

Erreurs

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.