Schéma ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Ce trait appartient aux types d'appareils THERMOSTAT qui sont compatibles avec les modes ECO.

Champs

Champ Description Type de données
availableModes Liste des modes Éco disponibles. array(string)
Valeur : ["MANUAL_ECO", "OFF"]
mode Mode Éco actuel du thermostat. string
Valeurs : "MANUAL_ECO", "OFF"
heatCelsius Température la plus basse en degrés Celsius à partir de laquelle le thermostat commence à chauffer en mode Éco. number
Exemple : 20.0
coolCelsius Température la plus élevée 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ê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, CLIMATISATION ou CHAUFFCLIM, utilisez la commande SetMode du trait ThermostatMode.

Cette commande a un impact sur d'autres caractéristiques, en fonction de l'état actuel du mode Éco ou des modifications apportées à ce mode :

  • Si le mode Éco est désactivé, le mode du thermostat est défini par défaut sur le dernier mode standard (CHAUFFAGE, CLIMATISATION, CHAUFF. • CLIM. ou DÉSACTIVÉ) qui était actif.
  • Si le mode Éco est défini sur 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 sur lequel définir le thermostat. string
Valeurs : "MANUAL_ECO", "OFF"

Erreurs

Les codes d'erreur suivants peuvent être renvoyés en lien avec ce trait :

Message d'erreur RPC Dépannage
La commande n'est pas autorisée dans le mode thermostat actuel. FAILED_PRECONDITION Certains modèles de thermostats ne permettent pas de modifier le mode Éco lorsque le mode du thermostat est DÉSACTIVÉ, conformément au trait ThermostatMode . Le mode du thermostat doit être défini sur CHAUFFAGE, CLIMATISATION ou CHAUFFCLIM avant de pouvoir 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.