Schéma ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Cette caractéristique appartient aux types d'appareils de THERMOSTAT compatibles avec les modes ECO.

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) à laquelle le thermostat active le chauffage en mode Éco. number
Exemple: 20,0
coolCelsius Température maximale en degrés Celsius à laquelle le thermostat démarre la climatisation 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

Modifiez le mode Éco du thermostat.

Pour définir le mode du thermostat sur "Chauffage", "Climatisation" 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é, c'est le dernier mode standard (Chauffage, Climatisation, Climatisation ou Éteint) qui 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 dans lequel activer 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 en mode thermostat actuel. FAILED_PRECONDITION Certains modèles de thermostat ne permettent pas de modifier le mode Éco lorsque le mode du thermostat est désactivé, conformément à la caractéristique ThermostatMode . Vous devez définir le mode du thermostat sur Chauffage, Climatisation ou Climatisation avant de modifier le mode Éco.
Commande non autorisée lorsque le thermostat est en mode MANUAL_ECO. FAILED_PRECONDITION Impossible de régler 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.