Schéma ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

Cette caractéristique appartient aux types d'appareils du thermostat thermostat qui prennent en charge 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) à laquelle le thermostat allume le chauffage en mode Éco. number
Exemple: 20,0
coolCelsius Température maximale en degrés Celsius à laquelle le thermostat lance la climatisation 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

Modifiez 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 a une incidence sur d'autres caractéristiques, en fonction de l'état actuel du mode Éco ou de ses changements:

  • Si le mode Éco est désactivé, le dernier mode standard activé (CHAUFFAGE, CLIM., CHAUFFAGE ou ÉTEINDRE) est activé par défaut.
  • Si le mode Éco est défini sur MANUAL_ECO:

Requête SetMode et réponse

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 pour activer le thermostat. string
Valeurs : "MANUAL_ECO", "OFF"

Erreurs

Le ou les codes d'erreur suivants peuvent être renvoyés pour 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 changer le mode Éco lorsque le thermostat est désactivé, conformément à la caractéristique Mode Thermostat . Vous devez changer le mode du thermostat sur CHAUFFAGE, CLIM ou CHAUFFAGE avant d'activer 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 la liste complète des codes d'erreur de l'API.