O Google está comprometido em promover a equidade racial para as comunidades negras. Veja como.
Esta página foi traduzida pela API Cloud Translation.
Switch to English

Termostato

Controle de termostato

O Nest Learning Thermostat ™ é um dispositivo conectado à Internet, intuitivo e fácil de usar, aprendendo continuamente sobre os padrões de uso em casa para otimizar o conforto e economizar energia. Os usuários podem controlar seu aquecimento e resfriamento em qualquer lugar onde tenham acesso a uma conexão à Internet.

O suporte a esses recursos requer um sofisticado sistema de controle que vai além dos simples programas baseados em pontos de ajuste. A Nest fornece uma ampla variedade de algoritmos (como Early On , True Radiant , Airwave ™ ) que requerem uma quantidade significativa de energia computacional em comparação com a maioria dos termostatos. O termostato Nest possui a energia necessária para fornecer esses recursos avançados.

A API do Nest foi projetada para permitir que os produtos controlem o sistema HVAC sem interromper os algoritmos do Nest ou surpreender o usuário com comportamentos inesperados. Eles fornecem acesso aos seguintes dados para o termostato Nest:

  • Nome da estrutura e dispositivo "where name" (localização na casa)
  • Etiqueta personalizada do termostato
  • Informações on-line e última conexão
  • Temperaturas atuais e alvo
  • Modo de temperatura
  • Temperaturas ecológicas
  • Tempo até a temperatura
  • Escala de temperatura (conjunto F / C)
  • Status de bloqueio de temperatura e, se bloqueado, os valores mínimo / máximo de temperatura bloqueada
  • Duração do temporizador do ventilador e modo HVAC
  • Umidade
  • Protetor solar

Permissões do termostato

Para acesso de leitura a todos os valores de dados da API do termostato, selecione a permissão de leitura do termostato para seu cliente.

Para acesso de leitura a todos os valores de dados da API do termostato e acesso adicional de gravação para selecionar valores, selecione a permissão de leitura / gravação do termostato para seu cliente. Este nível de permissão permite atualizar o seguinte:

  • Temperatura alvo
  • Modo HVAC
  • Temporizadores de ventilador

Começando com a leitura / gravação do termostato v5, você também pode atualizar o seguinte:

  • Escala de temperatura
  • Etiqueta termostato

Identificadores de termostato

Dispositivo

Os dispositivos aninhados são listados por tipo como uma matriz de IDs, que podem ser usados ​​para identificar exclusivamente um dispositivo pelo caminho do dispositivo. Portanto, um ID de termostato "peyiJNo..." significa que você pode carregar o modelo do devices/thermostats/peyiJNo... em devices/thermostats/peyiJNo... por meio da API.

Quando um dispositivo está conectado a vários produtos, cada desenvolvedor verá um ID diferente para esse dispositivo. Para um dispositivo que instalou vários produtos do mesmo desenvolvedor, o desenvolvedor verá o mesmo ID.

Nome

Dois atributos de nome são fornecidos. O atributo de name mais curto é exibido nos rótulos da interface do usuário, enquanto name_long é usado no texto longo.

name

Nestes exemplos, o name é "Corredor" ou "Corredor (oeste)".

NomeNome longo

name_long

Neste exemplo, name_long é "Office (Upstairs)".

Nome longo em uma mensagem

Rótulo

Onde nome (rótulo)
Onde nome (rótulo)

A partir das permissões da versão v5 , você pode adicionar um rótulo de termostato personalizado por meio da API. No aplicativo Nest, o rótulo aparece entre parênteses, após o nome where.

A partir das permissões da versão v6 , você também pode ler o rótulo do termostato.

Onde

where_id

  • Um identificador exclusivo gerado pelo Nest que representa o name
  • where_id é somente leitura e é criado automaticamente na chamada para criar um name where personalizado

Saiba mais sobre os nomes dos termostatos , Nest Protects e Nest Cams da Nest .

where_name

Ao escolher qualquer uma das permissões do termostato , você pode acessar o dispositivo where_name no objeto do dispositivo ( devices/thermostats ).

Outros metadados

Todos os valores de dados são somente leitura, a menos que especificado de outra forma.

Valor dos dados Descrição
locale O idioma e o código do país atribuído a este dispositivo
software_version Uma sequência que representa o firmware atualmente instalado no dispositivo
structure_id Uma sequência que representa exclusivamente essa estrutura; essa é a estrutura com a qual o dispositivo está emparelhado
last_connection O registro de data e hora da última conexão bem-sucedida ao serviço Nest
is_online Status online. Isso é determinado pelo Nest usando o tempo da last_connection e uma janela de reconexão esperada específica do dispositivo.

Recursos do termostato

Modos de termostato

Os sistemas HVAC têm quatro estados "ligado" ( heat , cool , heat-cool , eco ) e um estado "desligado" ( off ). Usamos esses estados para gerenciar o conforto e a economia de energia por hvac_mode dos valores de dados hvac_mode e temperatura.

  • Quando o modo Calor ou Frio ( heat , cool ) é selecionado, o termostato ajusta a casa à temperatura desejada.
  • Quando o modo Calor • Frio ( heat-cool ) é selecionado, o termostato mantém a casa confortável, dentro de uma faixa de temperatura preferida.
  • Quando a opção Eco Temperaturas (eco) é selecionada, o termostato aplica algoritmos de economia de energia para manter a casa confortável e reduzir o uso de energia. Os termostatos neste modo exibem ECO.

As estruturas têm dois estados relacionados à presença: Casa ou Fora. Quando nenhum movimento é detectado na casa, a estrutura muda de Casa para Fora, e os Termostatos na casa habilitam as Temperaturas Eco automaticamente.

Como os valores hvac_mode e temperature funcionam juntos

Dependendo do valor de hvac_mode , apenas certos valores de dados de temperatura podem ser acessados ​​na API:

Modo HVAC Valores de dados de temperatura que você pode acessar
heat ou cool target_temperature_f ou target_temperature_c
heat-cool target_temperature_low_f e target_temperature_high_f
ou
target_temperature_low_c e target_temperature_high_c
eco eco_temperature_low_f e eco_temperature_high_f
ou
eco_temperature_low_c e eco_temperature_high_c
off Nenhum

Em alguns cenários, existem regras especiais para alterar o hvac_mode :

Cenário O hvac_mode pode ser alterado?
Bloqueio de temperatura está ativado sim
O desligamento de emergência está ativo Não
Calor de emergência está ativado Não
can_cool valor can_cool ou can_heat é false Não

Temperaturas ecológicas

As temperaturas ecológicas permitem que o usuário economize energia, esteja em casa ou não. Considere mudar o hvac_mode para eco ao implementar comportamentos de economia de energia em seu produto.

Os terminais de temperatura ecológica estão disponíveis na API do Nest, começando com as permissões de leitura e leitura / gravação do termostato v6.

Alternando entre modos econômico e não econômico

Seu produto não precisa gerenciar as temperaturas desejadas diretamente no modo Econômico. Quando a casa está definida como ausente, a temperatura alvo não é exibida, mas é definida internamente, com base na seleção do usuário. Quando o termostato está na posição OFF, nenhuma temperatura alvo é observada.

Se você absolutamente precisar alterar as temperaturas-alvo diretamente, faça a alteração em duas chamadas separadas:

  1. Altere hvac_mode para qualquer outro valor, exceto eco
  2. Modifique os valores de dados target_temperature apropriados

Começando com as permissões de leitura e leitura / gravação do Thermostat v6, você pode acessar previous_hvac_mode por meio da API para ajudar nas transições do modo HVAC. previous_hvac_mode é usado para armazenar o hvac_mode do dispositivo antes de fazer a transição para "eco".

Por exemplo, se o Nest Thermostat estiver usando Eco Temperatures ( hvac_mode = "eco" ), previous_hvac_mode estará disponível e você deseja que seu produto defina target_temperature , primeiro você deve:

  1. obter previous_hvac_mode
  2. defina hvac_mode com o valor previous_hvac_mode
  3. confirme que hvac_mode não está mais definido como "eco"

Após essas etapas, defina as temperaturas desejadas conforme apropriado.

Dependendo do valor hvac_mode , é assim que o previous_hvac_mode muda:

Quando o estado hvac_mode é ... Então, previous_hvac_mode pode ser ...
eco heat , cool , heat-cool ou off
heat , cool , heat-cool ou off em branco / vazio

Temperatura alvo

A temperatura alvo é o valor mais importante para o sistema HVAC - é a temperatura desejada, normalmente definida pelo usuário. A maioria das ações e decisões são baseadas nisso. A partir da API, os produtos Works with Nest podem gravar a temperatura alvo como parte de um processo maior.

Sempre há uma temperatura alvo definida quando o sistema está ligado.

  • Quando o modo Calor ou Frio ( heat , cool ) é selecionado, uma única target_temperature é definida
  • Quando o modo Calor • Frio ( heat-cool ) é selecionado, dois valores de target_temperature são definidos, indicando um intervalo alvo, um maior para o resfriamento e um menor para o aquecimento
  • Quando o modo Eco ( eco ) é selecionado, a faixa de temperatura alvo é definida internamente

Também existem temperaturas de segurança que são um impedimento para impedir o congelamento de tubos ou temperaturas excessivamente altas em casa.

Quando o termostato está desligado, nenhuma temperatura alvo é definida.

Tempo até a temperatura

O Time-to-Temperature fornece acesso a esses valores de dados para o sistema HVAC:

  • time_to_target - O tempo, em minutos, que a estrutura alcançará a temperatura alvo
  • time_to_target_training
    • Status do treinamento
    • À medida que o termostato aprende como o sistema HVAC responde, ele ajusta a estimativa para atingir a temperatura alvo
    • Quando o termostato tiver certeza razoável da estimativa de tempo para atingir a temperatura desejada, o status mudará de training para ready

Temperatura ambiente

A temperatura medida perto do termostato. Exiba o valor que corresponde à escala de temperatura preferida do usuário.

Escala de temperatura

As variáveis ​​de temperatura ambiente e alvo são organizadas em escala Celsius ou Fahrenheit. O atributo temperature_scale será "F" ou "C", dependendo da preferência do usuário. Essa propriedade é definida por cada termostato, portanto, é possível que em uma única estrutura o usuário possa ter dois termostatos, um em cada escala de temperatura. Lembre-se das preferências do usuário ao exibir valores de temperatura.

A partir das permissões da versão v5 , é possível alterar a escala de temperatura por meio da API.

Os campos Alvo e Temperatura ambiente têm variantes _f e _c para acomodar arredondamentos consistentes ao exibir temperaturas.

Indicador de temperatura

Termostato

Ao exibir informações de temperatura de destino, considere estes três valores dependentes: temperature_scale , hvac_mode e o estado away da estrutura.

Muitos valores de dados trabalham juntos para determinar o que é mostrado na tela Nest Thermostat e como ele se comporta.

  • Quando hvac_mode é definido como heat-cool , o Nest Thermostat exibe os pontos de ajuste baixo e alto separados por um caractere de marcador (•); caso contrário, o Nest Thermostat exibe apenas a temperatura alvo
  • Quando hvac_mode está off , a palavra "OFF" é exibida no Nest Thermostat, no idioma preferido do usuário
  • Quando hvac_mode está definido como eco , a palavra "ECO" é exibida no termostato Nest, no idioma preferido do usuário

O formato da temperatura de exibição também depende da escala de temperatura selecionada (F / C).

As temperaturas em graus Fahrenheit são exibidas como números inteiros:

  • Temperatura alvo: 55 ° F
  • Temperatura ambiente: 62 ° F

As temperaturas Celsius são exibidas como um número inteiro ou um valor decimal, com o último dígito definido como ".5":

  • Temperatura alvo: 12 ° C
  • Temperatura ambiente: 16.5 ° C

Folha

Quando o ícone da folha é exibido na frente do termostato, o termostato é definido para uma temperatura de economia de energia e has_leaf = true .

Folha

Bloqueio de temperatura

Os usuários podem bloquear um termostato Nest para que ele possa ser ajustado apenas dentro de uma faixa de temperatura limitada. Começando com a versão de permissões v5 , você pode ver se o Bloqueio de temperatura está ativado marcando is_locked e, se estiver, leia os valores mínimo / máximo de bloqueio de temperatura por meio da API:

As temperaturas de bloqueio devem ser especificadas em pares, como valores máximo e mínimo, e só podem ser gravadas se is_locked = true .

Umidade

A umidade, no formato de porcentagem (%), medida no dispositivo, arredondada para os 5% mais próximos.

Protetor solar

A tecnologia Sunblock ajusta automaticamente a temperatura no termostato Nest para compensar os picos de calor que ocorrem com a luz solar direta na unidade.

Esses valores de dados informam se o Sunblock está ativado e / ou corrigindo ativamente a temperatura.

Ventilador

Muitos sistemas HVAC possuem ventiladores integrados, o que significa que o ventilador não pode ser controlado de forma independente . Não há modo desativado para ventiladores integrados, porque o ventilador precisa funcionar quando o aquecimento ou o resfriamento está ligado.

No entanto, se o sistema HVAC for compatível, o ventilador poderá ser ligado explicitamente por meio da API, a fim de tornar os ocupantes mais confortáveis, sem a necessidade de usar o sistema HVAC completo.

Se o ventilador puder ser controlado independentemente, has_fan será configurado como true e os seguintes valores de dados poderão ser configurados com permissões de leitura / gravação do termostato:

  • fan_timer_active - booleano, retorna true se o temporizador do ventilador estiver ativado por uma duração pré-programada
  • fan_timer_duration - int, o período de tempo (em minutos) que o ventilador está configurado para executar

Use esses valores juntos para iniciar o temporizador do ventilador (ligue o ventilador) por um período específico. Você também pode usar o valor fan_timer_timeout para determinar o registro de data e hora de quando o ventilador está configurado para parar de funcionar.

Observe que você sempre pode alterar fan_timer_duration - é independente do hvac_mode ou do estado de ocupação da estrutura (ausente).

Você pode esperar essas respostas com êxito ou com falha:

  • 200 OK
  • 400 Solicitação incorreta

Se o comando para ligar o ventilador não produzir o resultado esperado, pode ser porque o ventilador já está engatado (manualmente pelo usuário, ou em um horário, ou devido a um ciclo de aquecimento / resfriamento de HVAC).

Limitação de taxa

Aplicamos um limite de taxa para proteger contra chamadas excessivas a dispositivos, que podem afetar o desempenho do sistema ou da bateria. Sob condições normais, os dispositivos Nest carregam a bateria dos fios de baixa tensão no sistema de aquecimento e refrigeração. Mas se chamadas excessivas forem feitas em um curto período de tempo e o nível da bateria ficar baixo, o Nest Thermostat desligará o Wi-Fi para economizar energia.

Na prática, isso significa que limitamos o número de chamadas que podem ser feitas para um dispositivo dentro de um período de tempo definido. Se você exceder esse limite, receberá uma resposta de erro e uma mensagem indicando que excedeu seu limite.

Para mais informações, consulte Limites de taxa de dados .

Restrições de energia

Em alguns casos, o termostato pode não ter energia suficiente para atender a uma solicitação de modificação. Nesse caso, você receberá uma resposta de erro e uma mensagem indicando que o dispositivo não pode atender à solicitação no momento. Se isso acontecer, aguarde algum tempo para recarregar a bateria antes de tentar novamente.

Saiba mais sobre as condições de bateria fraca no Nest Learning Thermostat .

Mensagens de erro

Alguns estados tornam determinadas funções indisponíveis. Essas regras existem para economizar energia ou proporcionar conforto e segurança.

Para obter informações sobre o significado dos erros de chamada da API e como lidar com eles, consulte Mensagens de erro .

Problema de conexão / Wi-Fi

Se um dispositivo estiver offline, não serão permitidas modificações. Você pode observar o estado online do dispositivo no modelo de dados e exibir a interface do usuário adequadamente.