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.
Bu sayfa, Cloud Translation API ile çevrilmiştir.
Switch to English

Termostat

Termostat kontrolü

Nest Learning Thermostat ™ , sezgisel ve kullanımı kolay, rahatlığı optimize etmek ve enerji tasarrufu sağlamak için evdeki kullanım alışkanlıklarını sürekli olarak öğrenen İnternet bağlantılı bir cihazdır. Kullanıcılar, İnternet bağlantısına sahip oldukları her yerden ısıtma ve soğutma sistemlerini kontrol edebilir.

Bu özellikleri desteklemek, basit ayar noktası tabanlı programların ötesine geçen karmaşık bir kontrol sistemi gerektirir. Nest, çoğu termostat ile karşılaştırıldığında önemli miktarda hesaplama gücü gerektiren çok çeşitli algoritmalar ( Early On , True Radiant , Airwave ™ gibi ) sağlar. Nest Thermostat, bu gelişmiş özellikleri sağlamak için gereken güce sahiptir.

Nest API , ürünlerin Nest algoritmalarını bozmadan veya kullanıcıyı beklenmedik davranışlarla şaşırtmadan HVAC sistemini kontrol etmesini sağlamak için tasarlanmıştır. Nest Thermostat için aşağıdaki verilere erişim sağlarlar:

  • Yapı adı ve "nerede ad" cihazı (evdeki konum)
  • Özel termostat etiketi
  • Çevrimiçi durum ve son bağlantı bilgileri
  • Mevcut ve hedef sıcaklıklar
  • Sıcaklık modu
  • Eko Sıcaklıklar
  • Zaman-Sıcaklık
  • Sıcaklık ölçeği (set F / C)
  • Sıcaklık Kilidi durumu ve kilitliyse min / maks kilitli sıcaklık değerleri
  • Fan zamanlayıcı süresi ve HVAC modu
  • Nem
  • Güneş Koruyucu

Termostat izinleri

Tüm Termostat API veri değerlerine okuma erişimi için, istemciniz için Termostat okuma iznini seçin.

Tüm Termostat API veri değerlerine okuma erişimi ve belirli değerlere ek yazma erişimi için, istemciniz için Termostat okuma / yazma iznini seçin. Bu izin düzeyi aşağıdakileri güncellemenizi sağlar:

  • Hedef sıcaklık
  • HVAC modu
  • Fan zamanlayıcıları

Termostat okuma / yazma v5 ile başlayarak, aşağıdakileri de güncelleyebilirsiniz:

  • Sıcaklık ölçeği
  • Termostat etiketi

Termostat tanımlayıcıları

cihaz

Yuva cihazları, bir cihazı cihaz yolu aracılığıyla benzersiz bir şekilde tanımlamak için kullanılabilen bir dizi kimlik olarak türe göre listelenir. Yani "peyiJNo..." termostat kimliği, termostat cihaz modelini API aracılığıyla devices/thermostats/peyiJNo... yükleyebileceğiniz anlamına gelir.

Bir cihaz birden fazla ürüne bağlandığında, her geliştirici o cihaz için farklı bir kimlik görür. Aynı geliştiriciden birden fazla ürün yükleyen bir cihaz için geliştirici aynı kimliği görür.

ad

İki ad özelliği sağlanır. Kullanıcı arabirimi etiketlerinde daha kısa name özniteliği görüntülenirken, uzun form metninde name_long kullanılır.

name

Bu örneklerde, name "Koridor" veya "Koridor (Batı)" dır.

adİsim uzun

name_long

Bu örnekte, name_long "Office (Üst katta)" dir.

Mesajda uzun ad verin

Etiket

Nerede ad (etiket)
Nerede ad (etiket)

Sürümler v5'ten başlayarak, API aracılığıyla özel bir termostat etiketi ekleyebilirsiniz. Nest uygulamasında, etiket, adından sonra parantez içinde görünür.

V6 izin sürümünden başlayarak Termostat etiketini de okuyabilirsiniz.

Nerede

where_id

  • name temsil eden, Nest tarafından oluşturulan benzersiz bir tanımlayıcı
  • where_id salt okunurdur ve özel bir name oluşturmak için çağrıda otomatik olarak oluşturulur

Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

where_name

Termostat izinlerinden herhangi birini seçtiğinizde, aygıta where_name aygıt nesnesinden ( devices/thermostats ) erişebilirsiniz.

Diğer meta veriler

Aksi belirtilmedikçe tüm veri değerleri salt okunurdur.

Veri değeri Açıklama
locale Bu cihaza atanan dil ve ülke kodu
software_version Halihazırda cihaza yüklü olan bellenimi temsil eden bir dize
structure_id Bu yapıyı benzersiz bir şekilde temsil eden bir dize; bu, cihazın eşleştirildiği yapıdır
last_connection Nest hizmetine son başarılı bağlantının zaman damgası
is_online Çevrimiçi durum. Bu, Nest tarafından last_connection süresi ve cihaza özgü beklenen bir yeniden bağlantı penceresi kullanılarak belirlenir.

Termostat özellikleri

Termostat modları

HVAC sistemlerinin dört "açık" durumu ( heat , cool , heat-cool , eco ) ve bir "kapalı" durumu ( off ) vardır. Bu durumları, hvac_mode ve sıcaklık veri değerleri aracılığıyla konfor ve enerji tasarrufunu yönetmek için kullanırız.

  • Isı veya Soğutma modu ( heat , cool ) seçildiğinde, Termostat evi hedef sıcaklığa ayarlar.
  • Isı • Soğutma modu ( heat-cool ) seçildiğinde, Termostat evi tercih edilen bir sıcaklık aralığında konforlu tutar.
  • Eko Sıcaklıklar (eko) seçildiğinde, Termostat evi rahat tutmak ve enerji kullanımını azaltmak için enerji tasarrufu algoritmaları uygulayacaktır. Bu moddaki termostatlar ECO'yu gösterir.

Yapıların mevcudiyetle ilgili iki durumu vardır: Ev veya Dışarıda. Evde herhangi bir hareket algılanmadığında, yapı Evden Dışarıya değişir ve evdeki Termostatlar Eko Sıcaklıkları otomatik olarak etkinleştirir.

hvac_mode ve sıcaklık değerleri birlikte nasıl çalışır?

hvac_mode değerine bağlı olarak, hvac_mode yalnızca belirli sıcaklık veri değerlerine erişilebilir:

HVAC modu Erişebileceğiniz sıcaklık veri değerleri
heat veya cool target_temperature_f veya target_temperature_c
heat-cool target_temperature_low_f ve target_temperature_high_f
veya
target_temperature_low_c ve target_temperature_high_c
eco eco_temperature_low_f ve eco_temperature_high_f
veya
eco_temperature_low_c ve eco_temperature_high_c
off Yok

Bazı senaryolarda, hvac_mode değiştirmeyle ilgili özel kurallar vardır:

senaryo hvac_mode değiştirilebilir mi?
Sıcaklık Kilidi etkin Evet
Acil Durum Kapatma etkin Hayır
Acil Isı etkin Hayır
can_cool veya can_heat değeri false Hayır

Eko Sıcaklıklar

Eko Sıcaklıklar kullanıcının ister evde olsun ister olmasın enerjiden tasarruf etmesini sağlar. hvac_mode enerji tasarrufu davranışları uygularken hvac_mode eco değiştirmeyi düşünün.

Eko Sıcaklık uç noktaları , Termostat okuma ve okuma / yazma v6 izinlerinden başlayarak Nest API'sında kullanılabilir.

Eko ve eko olmayan modlar arasında geçiş yapma

Ürününüzün hedef sıcaklıkları doğrudan Eko modunda yönetmesi gerekmez. Ev uzağa ayarlandığında, hedef sıcaklık görüntülenmez, ancak kullanıcı seçimine göre dahili olarak ayarlanır. Termostat KAPALI olarak ayarlandığında, hedef sıcaklık gözlenmez.

Hedef sıcaklıkları kesinlikle doğrudan değiştirmeniz gerekiyorsa, değişikliği iki ayrı aramada yaptığınızdan emin olun:

  1. hvac_mode eco hariç başka bir değerle değiştirin
  2. Uygun target_temperature veri değerlerini değiştirme

Termostat okuma ve okuma / yazma v6 izinlerinden başlayarak, HVAC modu geçişlerine yardımcı olmak için API üzerinden previous_hvac_mode öğesine erişebilirsiniz. previous_hvac_mode , cihazın "eco" ya geçmeden önce hvac_mode değerini depolamak için kullanılır.

Örneğin, Nest Termostat Eko Sıcaklıklar kullanıyorsa ( hvac_mode = "eco" ), previous_hvac_mode kullanılabilir ve ürününüzün target_temperature ayarlamasını target_temperature , önce şunları yapmalısınız:

  1. previous_hvac_mode
  2. grubu hvac_mode için previous_hvac_mode değeri
  3. hvac_mode artık "eco" olarak ayarlanmadığını onayla

Bu adımlardan sonra, hedef sıcaklıkları uygun şekilde ayarlayın.

Bağlı hvac_mode değeri, bu nasıl previous_hvac_mode değiştirir:

hvac_mode durumu şu olduğunda ... O zaman previous_hvac_mode olabilir ...
eco heat , cool , heat-cool veya off
heat , cool , heat-cool veya off Boş / boş

Hedef sıcaklık

Hedef sıcaklık HVAC sistemi için en önemli değerdir - tipik olarak kullanıcı tarafından ayarlanan istenen sıcaklıktır. Çoğu eylem ve karar buna dayanır. API'den Works ile Nest ürünleri, hedef sıcaklığı daha büyük bir sürecin parçası olarak yazabilir.

Sistem açıkken daima ayarlanan bir hedef sıcaklık vardır.

  • Isı veya Soğutma modu ( heat , cool ) seçildiğinde, tek bir target_temperature ayarlanır
  • Isı • Soğutma modu ( heat-cool ) seçildiğinde, bir hedef aralığı, soğutma için daha yüksek ve ısıtma için daha düşük olan iki target_temperature değeri ayarlanır.
  • Eko modu ( eco ) seçildiğinde, hedef sıcaklık aralığı dahili olarak ayarlanır

Boruların dondurulmasını veya evde aşırı yüksek sıcaklıkların önlenmesi için arka dayanak olan güvenlik sıcaklıkları da vardır.

Termostat KAPALI olduğunda hedef sıcaklık ayarlanmaz.

Zaman-Sıcaklık

Sıcaklık Süresi , HVAC sistemi için şu veri değerlerine erişmenizi sağlar:

  • time_to_target - Yapının hedef sıcaklığa ulaşması için geçmesi gereken dakika time_to_target süre
  • time_to_target_training
    • Eğitim durumu
    • Termostat HVAC sisteminin nasıl tepki verdiğini öğrenirken, hedef sıcaklığa ulaşma tahminini ayarlar
    • Termostat hedef sıcaklığa ulaşmak için tahmini sürenin makul olduğundan emin olduğunda, durum training ready

Ortam sıcaklığı

Termostat yakınında ölçülen sıcaklık. Kullanıcının tercih ettiği sıcaklık ölçeğine karşılık gelen değeri görüntüleyin.

Sıcaklık ölçeği

Ortam ve hedef sıcaklık değişkenleri Santigrat veya Fahrenhayt ölçeğine göre düzenlenmiştir. temperature_scale özelliği, kullanıcının tercihine bağlı olarak "F" veya "C" olacaktır. Bu özellik her termostat tarafından ayarlanır, bu nedenle tek bir yapıda bir kullanıcının her sıcaklık ölçeğinde bir tane olmak üzere iki termostata sahip olması mümkündür. Sıcaklık değerlerini görüntülerken kullanıcı tercihlerini aklınızda bulundurun.

Sürümler v5 sürümünden başlayarak, sıcaklık ölçeğini API aracılığıyla değiştirebilirsiniz.

Hedef ve Ortam Sıcaklığı alanları, sıcaklıkları görüntülerken tutarlı yuvarlamayı sağlamak için _f ve _c varyantlarına sahiptir.

Sıcaklık göstergesi

Termostat

Hedef sıcaklık bilgilerini görüntülerken, şu üç bağımlı değeri göz önünde bulundurun: temperature_scale , hvac_mode ve yapının away durumu.

Birçok veri değeri Nest Termostat ekranında neyin gösterileceğini ve nasıl davrandığını belirlemek için birlikte çalışır.

  • hvac_mode heat-cool ayarlandığında, Nest Thermostat düşük ve yüksek ayar noktalarını madde işareti karakteriyle (•) ayrılmış olarak görüntüler, aksi takdirde Nest Thermostat yalnızca hedef sıcaklığı gösterir
  • hvac_mode off olarak ayarlandığında, Nest Thermostat üzerinde kullanıcının tercih ettiği dilde "OFF" kelimesi görüntülenir
  • hvac_mode eco olarak ayarlandığında, Nest Thermostat üzerinde kullanıcının tercih ettiği dilde "ECO" kelimesi görüntülenir

Gösterge sıcaklığı formatı ayrıca seçilen sıcaklık ölçeğine (F / C) bağlıdır.

Fahrenheit sıcaklıkları tam sayılar olarak görüntülenir:

  • Hedef sıcaklık: 55 ° F
  • Ortam sıcaklığı: 62 ° F

Santigrat sıcaklıkları bir tam sayı veya ondalık bir değer olarak gösterilir ve son basamak ".5" olarak ayarlanır:

  • Hedef sıcaklık: 12 ° C
  • Ortam sıcaklığı: 16.5 ° C

Yaprak

Termostatın önünde yaprak simgesi gösterildiğinde, termostat enerji tasarrufu sıcaklığına ayarlanır ve has_leaf = true has_leaf .

Yaprak

Sıcaklık Kilidi

Kullanıcılar bir Nest Thermostat'ı kilitleyebilir, böylece sadece sınırlı bir sıcaklık aralığında ayarlanabilir. V5 izin sürümünden başlayarak, Sıcaklık Kilidinin etkin olup olmadığını is_locked ve varsa API aracılığıyla Sıcaklık Kilidi min / maks değerlerini okuyun:

Kilit sıcaklıkları maksimum ve minimum değerler olarak çift olarak belirtilmelidir ve sadece is_locked = true ise is_locked .

Nem

Cihazda ölçülen yüzde (%) formatında nem, en yakın% 5'e yuvarlanır.

Güneş Koruyucu

Güneş koruyucu teknolojisi, ünitedeki doğrudan güneş ışığından kaynaklanan ısı artışlarını telafi etmek için Nest Termostatındaki sıcaklığı otomatik olarak ayarlar.

Bu veri değerleri, Sunblock'un etkin olup olmadığını ve / veya sıcaklığı etkin bir şekilde düzeltip düzeltmediğini size söyleyecektir.

fan

Birçok HVAC sistemi entegre fanlara sahiptir, yani fan bağımsız olarak kontrol edilemez . Entegre fanlar için kapalı mod yoktur, çünkü ısıtma veya soğutma açıkken fanın çalışması gerekir.

Bununla birlikte, HVAC sistemi uyumluysa, tam HVAC sistemine girmeden yolcuları daha rahat hale getirmek için fan API aracılığıyla açıkça açılabilir.

Fan bağımsız olarak kontrol edilebiliyorsa, has_fan true olarak ayarlanacak ve Termostat okuma / yazma izinleriyle aşağıdaki veri değerleri ayarlanabilir:

  • fan_timer_active - boolean, fan zamanlayıcısı önceden programlanmış bir süre boyunca meşgulse true değerini döndürür
  • fan_timer_duration - int, fanın çalışacak şekilde ayarlandığı süre (dakika olarak)

Fan zamanlayıcısını belirli bir süre başlatmak için bu değerleri birlikte kullanın. Fanın çalışmayı durduracağı zaman damgasını belirlemek için fan_timer_timeout değerini de kullanabilirsiniz.

fan_timer_duration her zaman değiştirebileceğinizi fan_timer_duration - hvac_mode veya yapı doluluk durumundan (dışarıda) bağımsızdır.

Bu yanıtların başarı veya başarısızlıkla sonuçlanmasını bekleyebilirsiniz:

  • 200 TAMAM
  • 400 Hatalı İstek

Fanı açma komutu beklenen sonucu vermezse, bunun nedeni fanın zaten meşgul olması (kullanıcı tarafından manuel olarak veya bir programda veya bir HVAC ısıtma / soğutma döngüsü nedeniyle) olabilir.

Hız sınırlayıcı

Sistem veya pil performansını etkileyebilecek aygıtlara yapılan aşırı çağrılara karşı koruma sağlamak için hız sınırlaması uygularız. Normal koşullar altında Nest cihazları pili ısıtma ve soğutma sistemindeki düşük voltaj kablolarından şarj eder. Ancak kısa bir süre içinde aşırı aramalar yapılırsa ve pil seviyesi düşerse, Nest Thermostat güç tasarrufu için Wi-Fi'yi kapatır.

Uygulamada bu, belirli bir süre içinde bir cihaza yapılabilecek arama sayısını sınırladığımız anlamına gelir. Bu sınırı aşarsanız bir hata yanıtı ve sınırınızı aştığınızı belirten bir mesaj alırsınız.

Daha fazla bilgi için bkz. Veri Hızı Sınırları .

Güç kısıtlamaları

Bazı durumlarda Termostat, bir değişiklik talebine hizmet etmek için yeterli pil gücüne sahip olmayabilir. Bu durumda bir hata yanıtı alırsınız ve cihazın şu anda isteğe hizmet veremediğini belirten bir mesaj alırsınız. Bu durumda, tekrar denemeden önce bataryaya yeniden şarj olması için biraz zaman tanıyın.

Nest Learning Thermostat'ta düşük pil koşulları hakkında daha fazla bilgi edinin.

Hata mesajları

Bazı durumlar belirli işlevleri kullanılamaz hale getirir. Bu kurallar, enerjiyi korumak veya konfor ve güvenlik sağlamak için geçerlidir.

API çağrı hatalarının ne anlama geldiği ve bunların nasıl ele alınacağı hakkında bilgi için, bkz. Hata Mesajları .

Kablosuz / bağlantı sorunu

Bir cihaz çevrimdışıysa, değişiklik yapılmasına izin verilmez. Veri modelinde cihazın çevrimiçi durumunu gözlemleyebilir ve kullanıcı arayüzünü uygun şekilde görüntüleyebilirsiniz.