Schéma ThermostatEco
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:
- Les commandes pour la caractéristique ThermostatTemperatureSetpoint sont refusées.
- Les températures mémorisées ne sont pas renvoyées par la caractéristique ThermostatTemperatureSetpoint .
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.