Google is committed to advancing racial equity for Black communities. See how.

Thermostat

Contrôle du thermostat

Le thermostat Nest Learning ™ est un appareil connecté à Internet qui est intuitive et facile à utiliser, l' apprentissage continu sur les habitudes d'utilisation dans 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 offre une vaste gamme d'algorithmes (comme Au début , vrai Radiant , Airwave ™ ) qui nécessitent une quantité importante de puissance de calcul par rapport à la plupart des thermostats. Le thermostat Nest a la puissance nécessaire pour fournir ces fonctionnalités avancées.

L' API Nest est conçu pour permettre aux produits de contrôler le système de CVC sans perturber les algorithmes Nest ou surprenant l'utilisateur avec 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
  • Statut en ligne et informations sur la dernière connexion
  • Températures actuelle et cible
  • Mode température
  • Températures éco
  • Temps à la température
  • Échelle de température (réglage F/C)
  • Température de verrouillage d' état, et il est verrouillé, les valeurs de température verrouillées min / max
  • Durée de la minuterie du ventilateur et mode CVC
  • Humidité
  • Crème solaire

Autorisations du thermostat

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

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

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

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

  • Échelle de température
  • Etiquette du thermostat

Identifiants de thermostat

Appareil

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

Lorsqu'un appareil est connecté à plusieurs produits, chaque développeur verra un ID 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. Le plus court name attribut est affiché dans les étiquettes de l' interface utilisateur, alors que name_long est utilisé dans le texte de forme longue.

name

Dans ces exemples, le name est « Hall d' entrée » ou « Hall d' entrée (Ouest) ».

NomNom long

name_long

Dans cet exemple, name_long est « Bureau (étage) ».

Nom long dans un message

Étiqueter

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

En commençant par la version des autorisations v5 , vous pouvez ajouter un thermostat sur mesure étiquette via l'API. Dans l'application Nest, le libellé apparaît entre parenthèses, après le nom where.

En commençant par la version des autorisations v6 , vous pouvez également lire l'étiquette du thermostat.

where_id

  • Un identificateur unique, généré Nest qui représente le name
  • where_id est en lecture seule, et est automatiquement créé dans l'appel pour créer une coutume où le name

En savoir plus sur où les noms pour Nest Thermostats ,Nest Protect et Nest en direct .

where_name

Lorsque vous choisissez un des autorisations du where_name devices/thermostats thermostat , vous pouvez accéder au périphérique where_name de l'objet de l' appareil ( 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 firmware actuellement installé sur l'appareil
structure_id Une chaîne qui représente de manière unique cette structure ; il s'agit de la structure avec laquelle l'appareil est associé
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 en utilisant le last_connection temps et une fenêtre de rebranchement prévu qui est spécifique à l' appareil.

Caractéristiques du thermostat

Modes de thermostat

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

  • Lorsque la chaleur ou en mode Cool ( heat , cool ) est sélectionné, le thermostat permet de régler le foyer de la température cible.
  • Lorsque la chaleur de la mode Cool ( heat-cool la heat-cool ) est sélectionné, le thermostat gardera la maison confortable, dans une plage de température préférée.
  • Lorsque les températures Eco (éco) est sélectionné, le thermostat applique des algorithmes d' économie d'énergie pour garder la maison confortable et réduire la consommation d'énergie. Les thermostats de ce mode affichent ECO.

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

Comment hvac_mode valeurs et de température travaillent ensemble

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

Mode CVC 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 alors
target_temperature_low_c et target_temperature_high_c
eco eco_temperature_low_f et eco_temperature_high_f
ou alors
eco_temperature_low_c et eco_temperature_high_c
off rien

Dans certains scénarios, il existe des règles spéciales autour de changer hvac_mode :

Scénario Peut - hvac_mode être changé?
Verrouillage de la température est activée Oui
Urgence d' arrêt est actif Non
La chaleur d' urgence est activée Non
can_cool ou can_heat valeur 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. Pensez à changer le hvac_mode à l' eco lors de la mise en œuvre des comportements d' économie d'énergie dans votre produit.

Eco paramètres de température sont disponibles dans l'API Nest en commençant par thermostat lecture et lecture / écriture des autorisations v6.

Basculement 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 la maison est réglée sur Absence, la température cible n'est pas affichée, mais est réglée 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, assurez-vous d'effectuer la modification en deux appels distincts :

  1. Changement hvac_mode à toute autre valeur que l' eco
  2. Modifier les appropriées target_temperature valeurs de données

En commençant par thermostat lecture et lecture / écriture des autorisations v6, vous pouvez accéder à previous_hvac_mode via l'API pour faciliter la transition du mode CVC. previous_hvac_mode est utilisé pour stocker l' hvac_mode de l'appareil avant qu'il ne la transition à « éco ».

Par exemple, si le thermostat Nest utilise Températures Eco ( hvac_mode = "eco" ), previous_hvac_mode est disponible, et vous voulez que votre produit ensemble target_temperature , vous devez d' abord:

  1. get previous_hvac_mode
  2. ensemble hvac_mode à la previous_hvac_mode valeur
  3. confirment hvac_mode est plus réglé sur « éco »

Après ces étapes, réglez les températures cibles comme il convient.

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

Lorsque hvac_mode état est ... Ensuite, 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 CVC - 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 elle. À partir de l'API, les produits Works with Nest peuvent écrire la température cible dans le cadre d'un processus plus vaste.

Il y a toujours une température cible définie lorsque le système est allumé.

  • Lorsque le mode de chauffage ou de climatisation ( heat , cool ) est sélectionné, un seul target_temperature est réglé
  • Lorsque la chaleur • Mode Cool ( heat-cool ) est sélectionnée, deux target_temperature valeurs sont définies, ce qui dénote une plage cible, un supérieur pour le refroidissement et un inférieur pour le chauffage
  • Lorsque le mode Eco ( eco ) est sélectionnée, la plage de température cible est réglé en interne

Il existe également des températures de sécurité qui constituent un filet de sécurité pour empêcher 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 à la température

Le temps à température vous donne accès à ces valeurs de données pour le système de CVC:

  • time_to_target - Le temps, en quelques minutes, qu'il faudra pour que la structure pour atteindre la température cible
  • time_to_target_training
    • Statut de la formation
    • Au fur et à mesure que le thermostat apprend comment le système CVC réagit, il ajuste l'estimation pour atteindre la température cible
    • Lorsque le thermostat est raisonnablement sûr de l'estimation du temps pour atteindre la température cible, le statut passera de training à 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. Le temperature_scale attribut sera soit « 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 les préférences de l' utilisateur à l' esprit lors de l' affichage des valeurs de température.

En commençant par la version des autorisations v5 , vous pouvez modifier l'échelle de température à travers 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, tenir compte de ces trois valeurs dépendantes: temperature_scale , hvac_mode et de la structure de away État.

De nombreuses valeurs de données fonctionnent ensemble pour déterminer ce qui est affiché sur l'écran du thermostat Nest et comment il se comporte.

  • Lorsque hvac_mode est réglé sur heat-cool , le nid affiche le thermostat de basse et haute séparées par un consignes caractère (•), sinon le thermostat Nest affiche seulement la température cible
  • Lorsque hvac_mode est réglé sur off , le mot « OFF » est affiché sur le thermostat Nest, dans la langue de l'utilisateur
  • Lorsque hvac_mode est réglé sur l' eco , le mot « ECO » est affiché sur le thermostat Nest, dans la langue de l'utilisateur

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

Les températures en degrés 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 défini sur « .5 » :

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

Feuille

Lorsque l'icône de la feuille montre sur la face avant du thermostat, le thermostat est réglé à 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. En commençant par la version des autorisations v5 , vous pouvez voir si la température de is_locked verrouillage est activé en vérifiant is_locked , et si elle est, lire les valeurs de verrouillage de la température min / max via l'API:

Les températures de verrouillage doivent être spécifiées par paires, en tant que valeurs maximales et minimales, et ne peuvent être écrits si is_locked = true .

Humidité

Humidité, en pourcentage (%), mesurée au niveau de l'appareil, arrondie au 5 % le plus proche.

Crème solaire

Sunblock technologie ajuste automatiquement la température du thermostat Nest pour compenser les pics de chaleur qui se produisent de la lumière directe sur l'appareil.

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

Ventilateur

De nombreux systèmes de CVC ont des ventilateurs intégrés, ce qui signifie que le ventilateur ne peut pas être contrôlé de façon indépendante . 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 activé explicitement via l'API, afin de rendre les occupants plus confortables, sans engager le système HVAC complet.

Si le ventilateur peut être contrôlé de façon indépendante, has_fan sera réglé sur true , et les valeurs de données suivantes peuvent être définies avec thermostat autorisations de lecture / écriture:

  • fan_timer_active - booléen, retourne true si la minuterie du ventilateur est engagé pour une durée pré-programmée
  • fan_timer_duration - int, la durée (en minutes) que le ventilateur est configuré pour exécuter

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 fan_timer_timeout valeur pour déterminer l'horodatage lorsque le ventilateur est réglé pour arrêter la course.

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 (loin).

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

  • 200 OK
  • 400 mauvaise demande

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

Limitation de débit

Nous appliquons une limitation de débit pour nous protéger contre les appels excessifs aux appareils, ce qui peut affecter les performances du système ou de la batterie. Dans des conditions normales, les appareils Nest chargent la batterie à partir des fils basse tension du système de chauffage et de climatisation. Mais si des appels excessifs sont passé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 passé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, voir les limites Data Rate .

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 la batterie faible dans le thermostat Nest .

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 ce que les erreurs d'appel de l' API signifient et comment les gérer, voir les 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.