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

Termostato

Controllo del termostato

Il termostato intelligente Nest ™ è un dispositivo connesso a Internet che è intuitivo e facile da usare, l'apprendimento continuo su modelli di utilizzo in casa per il comfort ottimizzare 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 vada oltre i semplici programmi basati su setpoint. Nido fornisce un'ampia gamma di algoritmi (come nella fase iniziale , vero radiante , Airwave ™ ) che richiedono una notevole quantità di potenza di calcolo rispetto alla maggior parte dei termostati. Il termostato Nest ha l'alimentazione necessaria per fornire queste funzionalità avanzate.

L' API Nest è progettato per consentire prodotti destinati al controllo del sistema HVAC senza interrompere algoritmi Nest o sorprendente all'utente comportamenti imprevisti. Consentono di accedere ai seguenti dati per il termostato Nest:

  • Nome struttura e dispositivo "where name" (posizione in casa)
  • Etichetta termostato personalizzata
  • Stato in linea e informazioni sull'ultima connessione
  • Temperature attuali e target
  • Modalità temperatura
  • Temperature Eco
  • Tempo-temperatura
  • Scala temperatura (imposta F/C)
  • Temperatura di blocco di stato e, se bloccato, il min / max valori di temperatura bloccati
  • Durata timer ventola e modalità HVAC
  • Umidità
  • Crema solare

Autorizzazioni termostato

Per l'accesso in lettura a tutti i valori di dati API termostato, selezionare il termostato leggere il permesso per il vostro cliente.

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

  • Temperatura obiettivo
  • Modalità HVAC
  • Timer ventola

A partire da Thermostat read/write v5, puoi anche aggiornare quanto segue:

  • Scala della temperatura
  • Etichetta del termostato

Identificatori del termostato

Dispositivo

I dispositivi Nest sono elencati per tipo come una serie di ID, che possono essere utilizzati 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 a devices/thermostats/peyiJNo... tramite l'API.

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

Nome

Vengono forniti due attributi del nome. Il più breve name attributo viene visualizzato nelle etichette dell'interfaccia utente, mentre name_long è usato in forma di testo lungo.

name

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

NomeNome lungo

name_long

In questo esempio, name_long è "Office (al piano superiore)".

Nome lungo in un messaggio

Etichetta

Dove nome (etichetta)
Dove nome (etichetta)

A partire dalla versione permessi v5 , è possibile aggiungere una consuetudine termostato di un'etichetta tramite l'API. Nell'app Nest, l'etichetta viene visualizzata tra parentesi, dopo il nome where.

A partire dalla versione permessi v6 , si può anche leggere l'etichetta del termostato.

Dove

where_id

  • Un unico, identificatore Nest-generato che rappresenta name
  • where_id è di sola lettura, e viene creato automaticamente nella chiamata per creare un costume in cui name

Scopri di più su dove nomi per Termostato Nest ,Nest Protegge e Nest erotiche .

where_name

Quando si sceglie una delle autorizzazioni di 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 codice del paese 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. Questo è determinato utilizzando il Nest last_connection tempo e una finestra riconnessione atteso che è un dispositivo specifico.

Caratteristiche del termostato

Modalità termostato

Sistemi HVAC hanno quattro "on" stati ( heat , cool , heat-cool , eco ) e una "off" stato ( off ). Usiamo questi stati di gestire comfort e risparmio energetico attraverso hvac_mode valori di dati e di temperatura.

  • Quando la modalità Freddo calore o ( heat , cool è selezionata), il termostato regola la sede della temperatura nominale.
  • Quando il calore • modalità Cool ( heat-cool è selezionata), il termostato mantenere la casa confortevole, in un intervallo di temperatura preferito.
  • Quando Eco Temperature è selezionato (eco), il termostato si applica algoritmi di risparmio energetico per mantenere la casa confortevole e ridurre i consumi energetici. I termostati in questa modalità visualizzano ECO.

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

Come hvac_mode valori di temperatura e di lavorare insieme

A seconda del valore di hvac_mode , solo determinati valori di dati di temperatura possono essere richiamati dal API:

Modalità HVAC Valori dei dati di temperatura a cui puoi accedere
heat o di 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 e eco_temperature_high_f
o
eco_temperature_low_c e eco_temperature_high_c
off nessuna

In alcuni scenari, ci sono regole speciali in giro per cambiare hvac_mode :

Scenario Può hvac_mode essere cambiato?
Blocco di temperatura è abilitato
Emergenza di arresto è attivo No
Emergenza caldo è abilitata No
can_cool o can_heat valore è false No

Temperature Eco

Le Temperature Eco consentono all'utente di risparmiare energia, che si trovi a casa o meno. In considerazione il passaggio al hvac_mode di eco in sede di attuazione dei comportamenti di risparmio energetico nel vostro prodotto.

Eco endpoint di temperatura sono disponibili nelle API Nest inizia con termostato leggere e leggere / permessi di scrittura v6.

Passaggio tra modalità eco e non eco

Il tuo prodotto non dovrebbe aver bisogno di gestire 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 vengono osservate le temperature target.

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

  1. Cambiare hvac_mode a qualsiasi valore ad eccezione di eco
  2. Modificare i appropriato target_temperature valori dei dati

Cominciando con termostato leggere e leggere / scrivere i permessi v6, è possibile accedere previous_hvac_mode tramite l'API per aiutare con le transizioni della modalità HVAC. previous_hvac_mode viene utilizzata per memorizzare il hvac_mode del dispositivo prima che la transizione a "eco".

Ad esempio, se il termostato Nest sta usando Eco Temperature ( hvac_mode = "eco" ), previous_hvac_mode è disponibile, e volete che il vostro prodotto al set target_temperature , allora è necessario:

  1. get previous_hvac_mode
  2. set hvac_mode al previous_hvac_mode valore
  3. Conferma hvac_mode non è impostato su "eco"

Dopo questi passaggi, impostare le temperature target come appropriato.

A seconda del hvac_mode valore, questo è il modo previous_hvac_mode cambia:

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

Temperatura obiettivo

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

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

  • Quando la modalità Cool (calore o heat , cool è selezionato), un singolo target_temperature è insieme
  • Quando il calore • modalità di raffreddamento ( heat-cool è selezionato), due target_temperature vengono impostati valori, denota un intervallo bersaglio, uno più alto per il raffreddamento ed uno inferiore per riscaldamento
  • Quando la modalità Eco ( eco è selezionato), l'intervallo di temperatura di destinazione è impostato internamente

Esistono anche temperature di sicurezza che fungono da antiritorno per evitare il congelamento delle tubazioni o temperature eccessivamente elevate in casa.

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

Tempo-temperatura

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

  • time_to_target - Il tempo, in minuti, che ci vorrà per la struttura di raggiungere la temperatura di destinazione
  • time_to_target_training
    • Stato dell'allenamento
    • Man mano che il termostato apprende come risponde il sistema HVAC, regola la stima per il raggiungimento della 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 che corrisponde alla scala di temperatura preferita dall'utente.

Scala della temperatura

Le variabili della temperatura ambiente e target sono organizzate per scala Celsius o Fahrenheit. Il temperature_scale attributo sarà o "F" o "C", a seconda delle preferenze dell'utente. Questa proprietà è impostata da ciascun termostato, quindi è possibile che in un'unica struttura un utente possa avere due termostati, uno in ciascuna scala di temperatura. Mantenere le preferenze degli utenti in mente quando la visualizzazione di valori di temperatura.

A partire dalla versione permessi v5 , è possibile modificare la scala della temperatura tramite l'API.

Destinatari e ambient campi di temperatura hanno _f e _c varianti per accogliere l'arrotondamento costante durante la visualizzazione di temperature.

Visualizzazione della temperatura

Termostato

Quando si visualizzano le informazioni temperatura target, prendere in considerazione questi tre valori dipendenti: temperature_scale , hvac_mode , e della struttura away statale.

Molti valori dei dati interagiscono per determinare cosa viene mostrato sul display del termostato Nest e come si comporta.

  • Quando hvac_mode è impostato heat-cool , il nido termostato visualizza il bassi e alti valori di riferimento separati da un carattere di punto (•), altrimenti i display termostato Nest appena la temperatura bersaglio
  • Quando hvac_mode è impostato su off , la parola "OFF" viene visualizzato sul termostato Nest, nella lingua preferita dell'utente
  • Quando hvac_mode è impostato su eco , la parola "ECO" è visualizzato sul termostato Nest, nella lingua preferita dell'utente

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

Le temperature Fahrenheit vengono 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 obiettivo: 12°C
  • Temperatura ambiente: 16,5°C

Foglia

Quando l'icona foglia sta mostrando sul fronte del termostato, il termostato è impostato su una temperatura di risparmio energetico, e has_leaf = true .

Foglia

Blocco temperatura Temperature

Gli utenti possono bloccare un termostato Nest in modo che possa essere regolato solo entro un intervallo di temperatura limitato. A partire dalla versione V5 permessi , si può vedere se temperatura di blocco è attivato controllando is_locked , e se lo è, Blocco lettura di temperatura valori min / max attraverso l'API:

Le temperature di blocco devono essere specificati in coppie, come valori massimi e minimi, e possono essere scritti solo se is_locked = true .

Umidità

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

Crema solare

Crema solare tecnologia 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 corregge attivamente la temperatura.

Fan

Molti sistemi HVAC hanno integrato ventilatori, il che significa che il ventilatore non può essere controllato indipendentemente . Non esiste una modalità di spegnimento per le ventole integrate, perché la ventola deve funzionare quando il riscaldamento o il raffreddamento sono attivi.

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

Se la ventola può essere controllata in modo indipendente, has_fan sarà impostato a true , ei seguenti valori di dati può essere impostato con termostato lettura / permessi di scrittura:

  • fan_timer_active - booleano, restituisce true se il timer della ventola è impegnata per una durata pre-programmato
  • fan_timer_duration - Int, l'intervallo di tempo (in minuti) che il ventilatore è impostato per eseguire

Utilizzare questi valori insieme per avviare il timer della ventola (accendere la ventola) per un periodo di tempo specifico. È inoltre possibile utilizzare il fan_timer_timeout valore per determinare il timestamp di quando il ventilatore è impostato per interrompere l'esecuzione.

Si noti che si può sempre cambiare fan_timer_duration - è indipendente hvac_mode o lo stato di occupazione struttura (distanza).

Puoi aspettarti queste risposte in caso di successo o fallimento:

  • 200 OK
  • 400 cattiva richiesta

Se il comando di accensione del ventilatore non dà il risultato sperato, potrebbe essere perché il ventilatore è già impegnato (o manualmente dall'utente, o programmato, o per un ciclo HVAC caldo/freddo).

Limitazione della velocità

Applichiamo la limitazione della velocità per proteggerci 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 dell'impianto di riscaldamento e raffreddamento. Ma se vengono effettuate chiamate eccessive in un breve periodo di tempo e il livello della batteria si scarica, il termostato Nest disattiva il Wi-Fi per risparmiare energia.

In pratica, ciò significa che limitiamo il numero di chiamate che possono essere effettuate a 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, vedere Limiti di Velocità dati .

Limiti di potenza

In alcuni casi il termostato potrebbe non avere una carica della batteria sufficiente 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. Se ciò accade, dare alla batteria un po' di tempo per ricaricarsi prima di riprovare.

Ulteriori informazioni su condizioni di batteria scarica del termostato intelligente Nest .

Messaggio di errore

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

Per informazioni su quali errori chiamata API significano e come gestirli, vedere Messaggi di errore .

Wi-Fi/problema di connessione

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