Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

Thermostat

Contrôle du thermostat

Le Nest Learning Thermostat ™ est un appareil connecté à Internet qui est intuitif et facile à utiliser, qui apprend en permanence sur les habitudes d'utilisation à la maison pour optimiser le confort et économiser de l'énergie. Les utilisateurs peuvent contrôler leur chauffage et leur refroidissement partout où ils ont accès à une connexion Internet.

La prise en charge de ces fonctionnalités nécessite un système de contrôle sophistiqué qui va au-delà des simples programmes basés sur des points de consigne. Nest propose une large gamme d’algorithmes (comme Early On , True Radiant , Airwave ™ ) qui nécessitent une quantité importante de puissance de calcul par rapport à la plupart des thermostats. Le thermostat Nest dispose de la puissance nécessaire pour fournir ces fonctionnalités avancées.

L' API Nest est conçue pour permettre aux produits de contrôler le système HVAC sans perturber les algorithmes Nest ou surprendre l'utilisateur par des comportements inattendus. Ils donnent accès aux données suivantes pour le thermostat Nest:

  • Nom de la structure et appareil "où nom" (emplacement dans la maison)
  • Étiquette de thermostat personnalisée
  • État en ligne et dernières informations de connexion
  • Températures actuelles et cibles
  • Mode température
  • Températures éco
  • Temps de mise en température
  • Échelle de température (régler F / C)
  • Statut de verrouillage de la température et, s'il est verrouillé, les valeurs de température verrouillées min / max
  • Durée de la minuterie du ventilateur et mode HVAC
  • Humidité
  • Écran solaire

Autorisations du thermostat

Pour un accès en lecture à toutes les valeurs de données de l'API Thermostat, sélectionnez l'autorisation de lecture du thermostat pour votre client.

Pour un accès en lecture à toutes les valeurs de données de l'API Thermostat et un accès en écriture supplémentaire pour sélectionner des valeurs, sélectionnez l'autorisation de lecture / écriture du thermostat pour votre client. Ce niveau d'autorisation vous permet de mettre à jour les éléments suivants:

  • Température cible
  • Mode HVAC
  • Minuteries de ventilateur

À partir de la version 5 de lecture / écriture du thermostat, vous pouvez également mettre à jour les éléments suivants:

  • Échelle de température
  • Étiquette du thermostat

Identifiants de thermostat

Dispositif

Les appareils Nest sont répertoriés par type sous la forme d'un ensemble d'identifiants, qui peuvent être utilisés pour identifier de manière unique un appareil via le chemin de l'appareil. Ainsi, un identifiant de thermostat "peyiJNo..." signifie que vous pouvez charger le modèle d' devices/thermostats/peyiJNo... dans les devices/thermostats/peyiJNo... via l'API.

Lorsqu'un appareil est connecté à plusieurs produits, chaque développeur verra un identifiant différent pour cet appareil. Pour un appareil qui a installé plusieurs produits du même développeur, le développeur verra le même ID.

Nom

Deux attributs de nom sont fournis. L'attribut de name plus court est affiché dans les étiquettes de l'interface utilisateur, tandis que name_long est utilisé dans le texte au name_long long.

name

Dans ces exemples, le name est «Hallway» ou «Hallway (West)».

NomNom long

name_long

Dans cet exemple, name_long est "Office (Upstairs)".

Nom long dans un message

Étiquette

Où nom (étiquette)
Où nom (étiquette)

À partir de la version d'autorisations v5 , vous pouvez ajouter une étiquette de thermostat personnalisée via l'API. Dans l'application Nest, le libellé apparaît entre parenthèses, après le nom du lieu.

À partir de la version des autorisations v6 , vous pouvez également lire l'étiquette du thermostat.

where_id

  • Un identifiant unique généré par Nest qui représente le name
  • where_id est en lecture seule et est créé automatiquement dans l'appel pour créer un name where personnalisé

En savoir plus sur les noms des thermostats Nest , des Nest Protect et des Nest Cam .

where_name

Lorsque vous choisissez l'une des autorisations Thermostat , vous pouvez accéder à l'appareil where_name partir de l'objet devices/thermostats ( devices/thermostats ).

Autres métadonnées

Toutes les valeurs de données sont en lecture seule, sauf indication contraire.

Valeur des données La description
locale La langue et le code de pays attribués à cet appareil
software_version Une chaîne qui représente le micrologiciel actuellement installé sur l'appareil
structure_id Une chaîne qui représente de manière unique cette structure; c'est la structure avec laquelle l'appareil est appairé
last_connection L'horodatage de la dernière connexion réussie au service Nest
is_online Statut en ligne. Ceci est déterminé par Nest à l’aide de l’heure last_connection et d’une fenêtre de reconnexion attendue propre à l’appareil.

Caractéristiques du thermostat

Modes de thermostat

Les systèmes HVAC ont quatre états «marche» ( heat , cool , heat-cool , eco ) et un état «arrêt» ( off ). Nous utilisons ces états pour gérer le confort et les économies d'énergie grâce hvac_mode valeurs des données hvac_mode et température.

  • Lorsque le mode Chauffage ou Refroidissement ( heat , cool ) est sélectionné, le thermostat ajuste la maison à la température cible.
  • Lorsque le mode Chauffage • Refroidissement ( heat-cool ) est sélectionné, le thermostat gardera la maison confortable, dans une plage de température préférée.
  • Lorsque Températures éco (éco) est sélectionné, le thermostat appliquera des algorithmes d'économie d'énergie pour garder la maison confortable et réduire la consommation d'énergie. Les thermostats dans ce mode affichent ECO.

Les structures ont deux états liés à la présence: Chez moi ou Absent. Lorsqu'aucun mouvement n'est détecté dans la maison, la structure passe de Chez soi à Absent et les thermostats de la maison activent automatiquement les températures éco.

Comment les valeurs de hvac_mode et de température fonctionnent ensemble

En fonction de la valeur de hvac_mode , seules certaines valeurs de données de température sont accessibles dans l'API:

Mode HVAC Valeurs des données de température auxquelles vous pouvez accéder
heat ou cool target_temperature_f ou target_temperature_c
heat-cool target_temperature_low_f et target_temperature_high_f
ou
target_temperature_low_c et target_temperature_high_c
eco eco_temperature_low_f et eco_temperature_high_f
ou
eco_temperature_low_c et eco_temperature_high_c
off aucun

Dans certains scénarios, il existe des règles spéciales concernant le changement de hvac_mode :

Scénario hvac_mode peut- hvac_mode être modifié?
Le verrouillage de la température est activé Oui
L'arrêt d'urgence est actif Non
Le chauffage d'urgence est activé Non
can_cool valeur can_cool ou can_heat est false Non

Températures éco

Les températures éco permettent à l'utilisateur d'économiser de l'énergie, qu'il soit à la maison ou non. Envisagez de basculer le hvac_mode sur eco lorsque vous implémentez des comportements d'économie d'énergie dans votre produit.

Les points de terminaison Eco Temperature sont disponibles dans l'API Nest à partir des autorisations de lecture et de lecture / écriture du thermostat v6.

Basculer entre les modes éco et non éco

Votre produit ne devrait pas avoir besoin de gérer les températures cibles directement en mode Eco. Lorsque le domicile est réglé sur absent, la température cible n'est pas affichée, mais est définie en interne, en fonction de la sélection de l'utilisateur. Lorsque le thermostat est réglé sur OFF, aucune température cible n'est observée.

Si vous devez absolument modifier directement les températures cibles, veillez à effectuer la modification en deux appels distincts:

  1. Remplacez hvac_mode par une autre valeur sauf eco
  2. Modifiez les valeurs de données target_temperature appropriées

En commençant par les autorisations de lecture et de lecture / écriture du thermostat v6, vous pouvez accéder au previous_hvac_mode via l'API pour vous aider avec les transitions du mode HVAC. previous_hvac_mode est utilisé pour stocker le hvac_mode de l'appareil avant qu'il ne passe à "eco".

Par exemple, si le thermostat Nest utilise des températures éco ( hvac_mode = "eco" ), previous_hvac_mode est disponible et que vous souhaitez que votre produit définisse target_temperature , vous devez d'abord:

  1. get previous_hvac_mode
  2. définir hvac_mode sur la valeur previous_hvac_mode
  3. confirmer que hvac_mode n'est plus défini sur "eco"

Après ces étapes, définissez les températures cibles comme il convient.

En fonction de la valeur hvac_mode , hvac_mode comment change previous_hvac_mode :

Lorsque l'état hvac_mode est ... Alors, previous_hvac_mode peut être ...
eco heat , cool , heat-cool ou off
heat , cool , heat-cool ou off vide / vide

Température cible

La température cible est la valeur la plus importante pour le système HVAC - c'est la température souhaitée, généralement définie par l'utilisateur. La plupart des actions et des décisions sont basées sur cela. À partir de l'API, les produits Works with Nest peuvent écrire la température cible dans le cadre d'un processus plus large.

Une température cible est toujours définie lorsque le système est en marche.

  • Lorsque le mode Chauffage ou Refroidissement ( heat , cool ) est sélectionné, une seule target_temperature est définie
  • Lorsque le mode Chauffage • Refroidissement ( heat-cool ) est sélectionné, deux valeurs target_temperature sont définies, indiquant une plage cible, une plus élevée pour le refroidissement et une plus basse pour le chauffage
  • Lorsque le mode Eco ( eco ) est sélectionné, la plage de température cible est réglée en interne

Il existe également des températures de sécurité qui constituent un filet de sécurité pour éviter le gel des tuyaux ou des températures excessivement élevées dans la maison.

Lorsque le thermostat est éteint, aucune température cible n'est définie.

Temps de mise en température

Time-to-Temperature vous donne accès à ces valeurs de données pour le système HVAC:

  • time_to_target - Le temps, en minutes, qu'il faudra à la structure pour atteindre la température cible
  • time_to_target_training
    • Statut de la formation
    • Lorsque le thermostat apprend comment le système HVAC répond, il ajuste l'estimation pour atteindre la température cible
    • Lorsque le thermostat est raisonnablement sûr du temps estimé pour atteindre la température cible, l'état passe de la training à l'état ready

Température ambiante

La température mesurée près du thermostat. Affichez la valeur qui correspond à l'échelle de température préférée de l'utilisateur.

Échelle de température

Les variables de température ambiante et cible sont organisées par échelle Celsius ou Fahrenheit. L'attribut temperature_scale sera "F" ou "C", selon les préférences de l'utilisateur. Cette propriété est définie par chaque thermostat, il est donc possible que dans une même structure un utilisateur puisse avoir deux thermostats, un dans chaque échelle de température. Gardez à l'esprit les préférences de l'utilisateur lors de l'affichage des valeurs de température.

À partir de la version des autorisations v5 , vous pouvez modifier l'échelle de température via l'API.

Les champs de température cible et ambiantes ont _f et _c variantes pour tenir compte lors de l' affichage arrondi cohérente des températures.

Affichage de la température

Thermostat

Lorsque vous affichez les informations de température cible, hvac_mode compte de ces trois valeurs dépendantes: temperature_scale , hvac_mode et l'état d' away la structure.

De nombreuses valeurs de données fonctionnent ensemble pour déterminer ce qui s'affiche sur l'écran du thermostat Nest et son comportement.

  • Lorsque hvac_mode est réglé sur heat-cool , le thermostat Nest affiche les points de consigne bas et haut séparés par une puce (•), sinon le thermostat Nest n’affiche que la température cible
  • Lorsque hvac_mode est off , le mot «OFF» s'affiche sur le thermostat Nest, dans la langue préférée de l'utilisateur
  • Lorsque hvac_mode est défini sur eco , le mot "ECO" s'affiche sur le thermostat Nest, dans la langue préférée de l'utilisateur

Le format de la température d'affichage dépend également de l'échelle de température sélectionnée (F / C).

Les températures Fahrenheit sont affichées sous forme de nombres entiers:

  • Température cible: 55 ° F
  • Température ambiante: 62 ° F

Les températures Celsius sont affichées sous forme de nombre entier ou de valeur décimale, le dernier chiffre étant réglé sur "0,5":

  • Température cible: 12 ° C
  • Température ambiante: 16,5 ° C

Feuille

Lorsque l'icône en forme de feuille apparaît à l'avant du thermostat, le thermostat est réglé sur une température d'économie d'énergie et has_leaf = true .

Feuille

Verrouillage de la température

Les utilisateurs peuvent verrouiller un thermostat Nest afin qu’il ne puisse être réglé que dans une plage de température limitée. À partir de la version des autorisations v5 , vous pouvez voir si le verrouillage de la température est activé en vérifiant is_locked , et si tel est le cas, lisez les valeurs min / max du verrouillage de température via l'API:

Les températures de verrouillage doivent être spécifiées par paires, sous forme de valeurs maximale et minimale, et ne peuvent être écrites que si is_locked = true .

Humidité

Humidité, au format pour cent (%), mesurée sur l'appareil, arrondie aux 5% près.

Écran solaire

La technologie Sunblock ajuste automatiquement la température du thermostat Nest pour compenser les pointes de chaleur causées par la lumière directe du soleil sur l’unité.

Ces valeurs de données vous indiqueront si Sunblock est activé et / ou corrige activement la température.

Ventilateur

De nombreux systèmes HVAC ont des ventilateurs intégrés, ce qui signifie que le ventilateur ne peut pas être contrôlé indépendamment . Il n'y a pas de mode d'arrêt pour les ventilateurs intégrés, car le ventilateur doit fonctionner lorsque le chauffage ou le refroidissement est activé.

Cependant, si le système HVAC est compatible, le ventilateur peut être explicitement activé via l'API, afin de rendre les occupants plus confortables, sans engager le système HVAC complet.

Si le ventilateur peut être contrôlé indépendamment, has_fan sera défini sur true et les valeurs de données suivantes peuvent être définies avec les autorisations de lecture / écriture du thermostat:

  • fan_timer_active - booléen, renvoie true si la minuterie du ventilateur est engagée pendant une durée préprogrammée
  • fan_timer_duration - int, la durée (en minutes) pendant laquelle le ventilateur est configuré pour fonctionner

Utilisez ces valeurs ensemble pour lancer la minuterie du ventilateur (allumer le ventilateur) pendant une période de temps spécifique. Vous pouvez également utiliser la valeur fan_timer_timeout pour déterminer l'horodatage du moment où le ventilateur est configuré pour s'arrêter.

Notez que vous pouvez toujours changer fan_timer_duration - il est indépendant de hvac_mode ou de l'état d'occupation de la structure (absent).

Vous pouvez vous attendre à ces réponses en cas de succès ou d'échec:

  • 200 OK
  • 400 Mauvaise demande

Si la commande d'allumer le ventilateur ne produit pas le résultat escompté, cela peut être dû au fait que le ventilateur est déjà engagé (soit manuellement par l'utilisateur, soit selon un programme, soit à cause d'un cycle chauffage / refroidissement HVAC).

Limitation de débit

Nous appliquons une limitation de débit pour nous protéger contre les appels excessifs aux appareils, qui peuvent affecter les performances du système ou de la batterie. Dans des conditions normales, les appareils Nest chargent la batterie à partir des câbles basse tension du système de chauffage et de climatisation. Mais si des appels excessifs sont effectués sur une courte période et que le niveau de la batterie devient faible, le thermostat Nest désactivera le Wi-Fi pour économiser l’énergie.

En pratique, cela signifie que nous limitons le nombre d'appels pouvant être effectués vers un appareil dans une période de temps définie. Si vous dépassez cette limite, vous recevrez une réponse d'erreur et un message indiquant que vous avez dépassé votre limite.

Pour plus d'informations, consultez Limites de débit de données .

Contraintes de puissance

Dans certains cas, le thermostat peut ne pas avoir assez de batterie pour répondre à une demande de modification. Dans ce cas, vous recevrez une réponse d'erreur et un message indiquant que l'appareil ne peut pas traiter la demande pour le moment. Si cela se produit, laissez à la batterie le temps de se recharger avant de réessayer.

En savoir plus sur les conditions de batterie faible dans le Nest Learning Thermostat .

Messages d'erreur

Certains états rendent certaines fonctions indisponibles. Ces règles sont en place pour économiser l'énergie ou assurer le confort et la sécurité.

Pour plus d'informations sur la signification des erreurs d'appel d'API et sur la manière de les gérer, consultez Messages d'erreur .

Problème Wi-Fi / connexion

Si un appareil est hors ligne, les modifications ne sont pas autorisées. Vous pouvez observer l'état en ligne de l'appareil dans le modèle de données et afficher l'interface utilisateur de manière appropriée.