Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Termostato

Controllo termostato

Nest Learning Thermostat ™ è un dispositivo connesso a Internet intuitivo e facile da usare, che impara continuamente sui modelli di utilizzo in casa per ottimizzare il comfort e risparmiare energia. Gli utenti possono controllare il riscaldamento e il raffreddamento ovunque abbiano accesso a una connessione Internet.

Il supporto di queste funzionalità richiede un sofisticato sistema di controllo che va oltre i semplici programmi basati su setpoint. Nest offre una vasta gamma di algoritmi (come Early On , True Radiant , Airwave ™ ) che richiedono una notevole quantità di potenza computazionale rispetto alla maggior parte dei termostati. Nest Thermostat ha la potenza necessaria per fornire queste funzionalità avanzate.

L' API Nest è progettata per consentire ai prodotti di controllare il sistema HVAC senza interrompere gli algoritmi Nest o sorprendere l'utente con comportamenti imprevisti. Forniscono l'accesso ai seguenti dati per il termostato Nest:

  • Nome struttura e dispositivo "dove nome" (posizione nella casa)
  • Etichetta termostato personalizzata
  • Stato online e informazioni sull'ultima connessione
  • Temperature correnti e target
  • Modalità di temperatura
  • Eco Temperature
  • Time-to-Temperatura
  • Scala di temperatura (impostare F / C)
  • Stato blocco temperatura e, se bloccato, i valori di temperatura min / max bloccati
  • Durata del timer della ventola e modalità HVAC
  • Umidità
  • sunblock

Autorizzazioni per termostato

Per l'accesso in lettura a tutti i valori dei dati dell'API Thermostat, selezionare l'autorizzazione di lettura Thermostat per il client.

Per l'accesso in lettura a tutti i valori dei dati API Thermostat e l'accesso in scrittura aggiuntivo per selezionare i valori, selezionare l'autorizzazione di lettura / scrittura Thermostat per il client. Questo livello di autorizzazione consente di aggiornare quanto segue:

  • Temperatura target
  • Modalità HVAC
  • Timer del ventilatore

A partire da Thermostat in lettura / scrittura v5, è anche possibile aggiornare quanto segue:

  • Scala di temperatura
  • Etichetta termostato

Identificatori del termostato

Dispositivo

I dispositivi Nest sono elencati per tipo come una matrice di ID, che può essere utilizzata per identificare in modo univoco un dispositivo tramite il percorso del dispositivo. Quindi un ID termostato di "peyiJNo..." significa che è possibile caricare il modello del dispositivo termostato su devices/thermostats/peyiJNo... tramite l'API.

Quando un dispositivo è collegato a più prodotti, ogni sviluppatore vedrà un ID diverso per quel dispositivo. Per un dispositivo che ha installato più prodotti dallo stesso sviluppatore, lo sviluppatore vedrà lo stesso ID.

Nome

Sono forniti due attributi di nome. L'attributo del name più breve viene visualizzato nelle etichette dell'interfaccia utente, mentre name_long viene utilizzato nel testo in formato lungo.

name

In questi esempi, il name è "Corridoio" o "Corridoio (ovest)".

NomeNome lungo

name_long

In questo esempio, name_long è "Office (Upstairs)".

Nome lungo in un messaggio

Etichetta

Dove nome (etichetta)
Dove nome (etichetta)

A partire dalle autorizzazioni versione v5 , è possibile aggiungere un'etichetta termostato personalizzata tramite l'API. Nell'app Nest, l'etichetta appare tra parentesi, dopo il nome del luogo.

A partire dalle autorizzazioni versione v6 , puoi anche leggere l'etichetta del termostato.

Dove

where_id

  • Un identificatore univoco, generato da Nest, che rappresenta il name
  • where_id è di sola lettura e viene creato automaticamente nella chiamata per creare un name dove personalizzato

Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

where_name

Quando si sceglie una delle autorizzazioni del termostato , è possibile accedere al dispositivo where_name dall'oggetto dispositivo ( devices/thermostats ).

Altri metadati

Tutti i valori dei dati sono di sola lettura, se non diversamente specificato.

Valore dei dati Descrizione
locale La lingua e il prefisso internazionale assegnati a questo dispositivo
software_version Una stringa che rappresenta il firmware attualmente installato sul dispositivo
structure_id Una stringa che rappresenta in modo univoco questa struttura; questa è la struttura a cui è associato il dispositivo
last_connection Il timestamp dell'ultima connessione riuscita al servizio Nest
is_online Stato online. Ciò viene determinato da Nest utilizzando l'ora last_connection e una finestra di riconnessione prevista specifica del dispositivo.

Caratteristiche del termostato

Modalità termostato

I sistemi HVAC hanno quattro stati "on" ( heat , cool , heat-cool , eco ) e uno stato "off" ( off ). Usiamo questi stati per gestire il comfort e il risparmio energetico attraverso i valori di dati hvac_mode e temperatura.

  • Quando è selezionata la modalità Riscaldamento o Raffreddamento ( heat , cool ), il termostato regola la casa alla temperatura target.
  • Quando è selezionata la modalità Calore • Raffreddamento ( heat-cool ), il termostato manterrà la casa confortevole, entro un intervallo di temperatura preferito.
  • Quando si seleziona Eco Temperature (eco), il termostato applicherà algoritmi di risparmio energetico per mantenere la casa confortevole e ridurre il consumo di energia. I termostati in questa modalità visualizzano ECO.

Le strutture hanno due stati legati alla presenza: casa o fuori casa. Quando non viene rilevato alcun movimento in casa, la struttura cambierà da Casa a Via e i Termostati in casa abiliteranno automaticamente le Eco Temperature.

Come funzionano insieme i valori di hvac_mode e temperatura

A seconda del valore di hvac_mode , hvac_mode possibile accedere solo a determinati valori dei dati di temperatura:

Modalità HVAC Valori dei dati di temperatura a cui è possibile accedere
heat o cool target_temperature_f o target_temperature_c
heat-cool target_temperature_low_f e target_temperature_high_f
o
target_temperature_low_c e target_temperature_high_c
eco eco_temperature_low_f ed eco_temperature_high_f
o
eco_temperature_low_c ed eco_temperature_high_c
off nessuna

In alcuni scenari, ci sono regole speciali per cambiare la modalità hvac_mode :

Scenario hvac_mode possibile modificare hvac_mode ?
Il blocco della temperatura è abilitato
L'arresto di emergenza è attivo No
Il riscaldamento di emergenza è abilitato No
can_cool valore can_cool o can_heat è false No

Eco Temperature

Le temperature ecologiche consentono all'utente di risparmiare energia, a casa o no. Prendi in considerazione la possibilità di passare da hvac_mode a eco quando hvac_mode comportamenti di risparmio energetico nel tuo prodotto.

Gli endpoint Eco Temperature sono disponibili nell'API Nest a partire dalle autorizzazioni di lettura e scrittura / lettura Thermostat v6.

Passaggio tra le modalità eco e non eco

Non è necessario che il prodotto gestisca le temperature target direttamente in modalità Eco. Quando la casa è impostata su Assente, la temperatura target non viene visualizzata, ma è impostata internamente, in base alla selezione dell'utente. Quando il termostato è impostato su OFF, non si osservano temperature target.

Se devi assolutamente cambiare direttamente le temperature target, assicurati di effettuare la modifica in due chiamate separate:

  1. Cambia hvac_mode in qualsiasi altro valore tranne eco
  2. Modificare i valori dei dati target_temperature appropriati

A partire dalle autorizzazioni di lettura e scrittura / lettura v6 di Thermostat, è possibile accedere a previous_hvac_mode tramite l'API per facilitare le transizioni in modalità HVAC. previous_hvac_mode viene utilizzato per memorizzare la modalità hvac_mode del dispositivo prima che hvac_mode a "eco".

Ad esempio, se Nest Thermostat utilizza Eco Temperature ( hvac_mode = "eco" ), previous_hvac_mode è disponibile e si desidera che il prodotto imposti target_temperature , quindi è necessario innanzitutto:

  1. ottieni previous_hvac_mode
  2. imposta hvac_mode sul valore previous_hvac_mode
  3. confermare che hvac_mode non è più impostato su "eco"

Dopo questi passaggi, impostare le temperature target appropriate.

A seconda del valore di hvac_mode , ecco come cambia la modalità previous_hvac_mode :

Quando hvac_mode stato hvac_mode è ... Quindi, previous_hvac_mode può essere ...
eco heat , cool , heat-cool o off
heat , cool , heat-cool o off vuoto / vuoto

Temperatura target

La temperatura target è il valore più importante per il sistema HVAC: è la temperatura desiderata, generalmente impostata dall'utente. La maggior parte delle azioni e delle decisioni si basa su di esso. Dall'API, i prodotti Works with Nest possono scrivere la temperatura target nell'ambito di un processo più ampio.

C'è sempre una temperatura target impostata quando il sistema è acceso.

  • Quando è selezionata la modalità Riscaldamento o Raffreddamento ( heat , cool ), viene impostata una singola target_temperature
  • Quando è selezionata la modalità Calore • Raffreddamento ( heat-cool ), vengono impostati due valori target_temperature , che indicano un intervallo target, uno più alto per il raffreddamento e uno più basso per il riscaldamento
  • Quando si seleziona la modalità Eco ( eco ), l'intervallo di temperatura target viene impostato internamente

Ci sono anche temperature di sicurezza che sono un backstop per prevenire il congelamento dei tubi o temperature eccessivamente elevate in casa.

Quando il termostato è spento, non sono impostate temperature target.

Time-to-Temperatura

Time-to-Temperature ti dà accesso a questi valori di dati per il sistema HVAC:

  • time_to_target - Il tempo, in minuti, impiegato dalla struttura per raggiungere la temperatura target
  • time_to_target_training
    • Stato dell'allenamento
    • Mentre il termostato apprende come risponde il sistema HVAC, regola la stima per raggiungere la temperatura target
    • Quando il termostato è ragionevolmente sicuri della stima tempo per raggiungere la temperatura di destinazione, lo stato passerà da training di ready

Temperatura ambiente

La temperatura misurata vicino al termostato. Visualizza il valore corrispondente alla scala di temperatura preferita dell'utente.

Scala di temperatura

Le variabili di temperatura ambiente e target sono organizzate secondo la scala Celsius o Fahrenheit. L'attributo temperature_scale sarà "F" o "C", a seconda delle preferenze dell'utente. Questa proprietà è impostata da ciascun termostato, quindi è possibile che in una singola struttura un utente possa avere due termostati, uno in ciascuna scala di temperatura. Tenere presenti le preferenze dell'utente durante la visualizzazione dei valori di temperatura.

A partire dalle autorizzazioni versione v5 , è possibile modificare la scala di temperatura tramite l'API.

I campi di temperatura ambiente e target hanno varianti _f e _c per adattarsi all'arrotondamento costante quando si visualizzano le temperature.

Visualizzazione della temperatura

Termostato

Quando si visualizzano le informazioni sulla temperatura target, considerare questi tre valori dipendenti: temperature_scale , hvac_mode e lo stato away della struttura.

Molti valori di dati lavorano insieme per determinare cosa viene visualizzato sul display Nest Thermostat e come si comporta.

  • Quando hvac_mode è impostato heat-cool a heat-cool , il termostato Nest visualizza i setpoint bassi e alti separati da un carattere punto hvac_mode (•), altrimenti il ​​termostato Nest visualizza solo la temperatura target
  • Quando hvac_mode è off , la parola "OFF" viene visualizzata sul termostato Nest, nella lingua preferita dell'utente
  • Quando hvac_mode è impostato su eco , la parola "ECO" viene visualizzata sul termostato Nest, nella lingua preferita dell'utente

Il formato della temperatura del display dipende anche dalla scala di temperatura selezionata (F / C).

Le temperature di Fahrenheit sono visualizzate come numeri interi:

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

Le temperature Celsius vengono visualizzate come un numero intero o un valore decimale, con l'ultima cifra impostata su ".5":

  • Temperatura target: 12 ° C
  • Temperatura ambiente: 16,5 ° C

Foglia

Quando l'icona della foglia viene visualizzata sulla parte anteriore del termostato, il termostato viene impostato su una temperatura di risparmio energetico e has_leaf = true .

Foglia

Blocco della temperatura

Gli utenti possono bloccare un termostato Nest in modo che possa essere regolato solo entro un intervallo di temperatura limitato. A partire dalle autorizzazioni versione v5 , puoi vedere se il blocco della temperatura è abilitato controllando is_locked e, se lo è, leggi i valori min / max del blocco della temperatura tramite l'API:

Le temperature di blocco devono essere specificate in coppia, come valori massimi e minimi, e possono essere scritte solo se is_locked = true .

Umidità

Umidità, in formato percentuale (%), misurata sul dispositivo, arrotondata al 5% più vicino.

sunblock

La tecnologia Sunblock regola automaticamente la temperatura sul termostato Nest per compensare i picchi di calore che si verificano dalla luce solare diretta sull'unità.

Questi valori di dati ti diranno se Sunblock è abilitato e / o correggendo attivamente la temperatura.

Fan

Molti sistemi HVAC hanno ventole integrate, il che significa che la ventola non può essere controllata in modo indipendente . Non esiste alcuna modalità di spegnimento per i ventilatori integrati, poiché il ventilatore deve funzionare quando il riscaldamento o il raffreddamento sono attivi.

Tuttavia, se il sistema HVAC è compatibile, la ventola può essere esplicitamente accesa tramite l'API, al fine di rendere più confortevoli gli occupanti, senza coinvolgere l'intero sistema HVAC.

Se il ventilatore può essere controllato in modo indipendente, has_fan sarà impostato su true e i seguenti valori di dati possono essere impostati con le autorizzazioni di lettura / scrittura di Thermostat:

  • fan_timer_active - booleano, restituisce true se il timer della ventola è attivato per una durata preprogrammata
  • fan_timer_duration - int, il periodo di tempo (in minuti) in cui il ventilatore è impostato per funzionare

Utilizzare questi valori insieme per avviare il timer della ventola (accendere la ventola) per un periodo di tempo specifico. Puoi anche utilizzare il valore fan_timer_timeout per determinare il timestamp di quando la ventola è impostata per interrompere l'esecuzione.

Nota che puoi sempre cambiare fan_timer_duration - è indipendente da hvac_mode o hvac_mode stato di occupazione della struttura (assente).

Puoi aspettarti queste risposte in caso di successo o fallimento:

  • 200 OK
  • 400 Richiesta non valida

Se il comando per accendere la ventola non produce il risultato atteso, potrebbe essere perché la ventola è già inserita (manualmente dall'utente o su un programma o a causa di un ciclo di riscaldamento / raffreddamento HVAC).

Limitazione della velocità

Applichiamo la limitazione della velocità per proteggere da chiamate eccessive ai dispositivi, che possono influire sulle prestazioni del sistema o della batteria. In condizioni normali, i dispositivi Nest caricano la batteria dai cavi a bassa tensione sul sistema di riscaldamento e raffreddamento. Ma se vengono effettuate chiamate eccessive in un breve periodo di tempo e il livello della batteria si abbassa, il termostato Nest disattiverà il Wi-Fi per risparmiare energia.

In pratica, ciò significa che limitiamo il numero di chiamate che è possibile effettuare su un dispositivo entro un periodo di tempo definito. Se superi questo limite, riceverai una risposta di errore e un messaggio che indica che hai superato il limite.

Per ulteriori informazioni, consultare Limiti della velocità dei dati .

Vincoli di potenza

In alcuni casi il termostato potrebbe non avere abbastanza carica della batteria per soddisfare una richiesta di modifica. In questo caso riceverai una risposta di errore e un messaggio che indica che il dispositivo non può soddisfare la richiesta in questo momento. In questo caso, concedi alla batteria un po 'di tempo per ricaricarsi prima di riprovare.

Scopri di più sulle condizioni di batteria scarica nel Nest Learning Thermostat .

Messaggio di errore

Alcuni stati rendono alcune funzioni non disponibili. Queste regole sono in atto per conservare energia o fornire comfort e sicurezza.

Per informazioni sul significato degli errori di chiamata API e su come gestirli, vedere Messaggi di errore .

Problema Wi-Fi / connessione

Se un dispositivo è offline, non sono consentite modifiche. È possibile osservare lo stato online del dispositivo nel modello dati e visualizzare l'interfaccia utente in modo appropriato.