Schéma de la température de consigne du thermostat
sdm.devices.traits.ThermostatTemperatureSetpoint
Cette caractéristique appartient aux types d'appareils de THERMOSTAT qui permettent de définir une température cible et une plage de températures.
Champs
Champ | Description | Type de données |
---|---|---|
heatCelsius |
Température cible en degrés Celsius pour les modes Chauffage et Chauffage/Climatisation du thermostat. | number Exemple: 20,0 |
coolCelsius |
Température de consigne en degrés Celsius pour les modes COOL et HEATCOOL du thermostat. | number Exemple: 22,0 |
Exemple de requête et de réponse GET – HEAT
Requête
GET /enterprises/project-id/devices/device-id
Réponse
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
Exemple de requête et de réponse GET – COOL
Requête
GET /enterprises/project-id/devices/device-id
Réponse
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
Exemple de requête et de réponse GET – HEATCOOL
Requête
GET /enterprises/project-id/devices/device-id
Réponse
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
Commandes
Le thermostat doit être dans le mode correspondant à la commande appelée avant de modifier les températures mémorisées. La commande et les champs permettant de modifier les températures mémorisées varient selon le mode du thermostat.
Par exemple, pour que vous puissiez exécuter la commande "SetHeat", le thermostat doit d'abord être en mode Chauffage:
Mode | Commande | Champ(s) |
---|---|---|
AUXILIAIRE | SetHeat | heatCelsius |
FROID | SetCool | coolCelsius |
Climatisation | SetRange | heatCelsius , coolCelsius |
Notez que les commandes de température mémorisée ne prennent en compte que les degrés Celsius comme paramètre, même si le Google Nest Thermostat peut afficher la température en degrés Celsius ou Fahrenheit.
SetHeat
Définit la température de consigne lorsque le thermostat est en mode Chauffage.
Requête et réponse SetHeat
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
Réponse
{}
Champs de requête SetHeat
Champ | Description | Type de données |
---|---|---|
heatCelsius |
Température de consigne à définir lorsque le thermostat est en mode Chauffage. | number Exemple: 22,0 |
SetCool
Définit la température de consigne lorsque le thermostat est en mode climatisation.
Requête et réponse SetCool
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
Réponse
{}
Champs de requête SetCool
Champ | Description | Type de données |
---|---|---|
coolCelsius |
Température de consigne à définir lorsque le thermostat est en mode climatisation. | number Exemple: 20,0 |
SetRange
Définit les températures minimale et maximale lorsque le thermostat est en mode CHAUFFAGE.
Requête et réponse SetRange
Requête
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
Réponse
{}
Champs de requête SetRange
Champ | Description | Type de données |
---|---|---|
heatCelsius |
Température minimale de consigne à définir lorsque le thermostat est en mode Climatisation thermique. | number Exemple: 20,0 |
coolCelsius |
Température maximale de consigne à définir lorsque le thermostat est en mode Climatisation thermique. | number Exemple: 22,0 |
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. |
La valeur de climatisation doit être supérieure à la valeur thermique. | INVALID_ARGUMENT |
Assurez-vous que la valeur du champ heatCelsius est inférieure à celle du champ coolCelsius de votre commande. |
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.