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

Termostat

termostat kontrolü

Nest Learning Termostat ™ sürekli optimize konfor ve enerji tasarrufu evde kullanım alışkanlıklarına öğrenmeye, sezgisel ve kolay kullanımlı etmektir İnternet'e bağlı bir cihazdır. Kullanıcılar, İnternet bağlantısına erişimleri olan her yerde ısıtma ve soğutmalarını kontrol edebilirler.

Bu özellikleri desteklemek, basit ayar noktası tabanlı programların ötesine geçen gelişmiş bir kontrol sistemi gerektirir. Nest (gibi algoritmalar geniş bir yelpazede sağlar Erken On , Gerçek Radyan , Airwave ™ en termostatlara kıyasla hesaplama gücünün önemli miktarda gerektirir). Nest Thermostat, bu gelişmiş özellikleri sağlamak için gereken güce sahiptir.

Nest API ürünleri Nest algoritmaları bozarak veya beklenmedik davranışlar ile kullanıcı şaşırtıcı olmadan HVAC sistemi kontrol etmenizi sağlayacak şekilde tasarlanmıştır. Nest Thermostat için aşağıdaki verilere erişim sağlarlar:

  • Yapı adı ve cihaz "nerede adı" (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
  • Sıcaklık Süresi
  • Sıcaklık ölçeği (F/C'yi ayarlayın)
  • Sıcaklık Kilit durumu ve kilitli durumunda, minimum / maksimum kilitli sıcaklık değerleri
  • Fan zamanlayıcı süresi ve HVAC modu
  • Nem
  • güneş kremi

termostat izinleri

Tüm Termostat API veri değerlerine okuma erişim için, seçmek Termostat okumak müvekkiline izni.

Tüm Termostat API veri değerlerine okuma erişimi ve ek yazma erişimi için, değerleri seçmek için seçmek Termostat okuma / yazma müvekkiline izni. Bu izin düzeyi, aşağıdakileri güncellemenize olanak tanır:

  • 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ı, cihaz yolu aracılığıyla bir cihazı benzersiz bir şekilde tanımlamak için kullanılabilen bir kimlik dizisi olarak türe göre listelenir. Bir termostat kimliği Yani "peyiJNo..." En termostat cihaz modeli yükleyebilmesini vasıtası devices/thermostats/peyiJNo... API üzerinden.

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.

isim

İki ad özelliği sağlanır. Kısa name ise nitelik, kullanıcı arayüzü etiket görüntülenir name_long uzun biçim metinde kullanılır.

name

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

isimisim uzun

name_long

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

Mesajda uzun isim

Etiket

Nerede adı (etiket)
Nerede adı (etiket)

İle başlayan izinler versiyon v5 , API sayesinde, etiket termostat özel bir ekleyebilir. Nest uygulamasında etiket, nerede adından sonra parantez içinde görünür.

İle başlayan izinler versiyon v6 , ayrıca Termostat etiketi okuyabilir.

Nerede

where_id

  • Temsil eden bir tek, Yuva oluşturulan tanımlayıcı name
  • where_id , salt okunur ve nerede bir özel oluşturmak için çağrıda otomatik olarak oluşturulur name

Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

where_name

Eğer herhangi seçtiğinizde Termostat izinleri , cihazı erişebilirsiniz where_name aygıt nesnesi (gelen devices/thermostats ).

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 Cihazda yüklü olan üretici yazılımını temsil eden bir dize
structure_id Bu yapıyı benzersiz ş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 kullanılarak yuva ile belirlenir last_connection zaman ve cihaza özgü olan beklenen bir yeniden bağlanma penceresi.

Termostat özellikleri

termostat modları

HVAC sistemleri devletler ( "açık" dört var heat , cool , heat-cool , eco devlet "kapalı") ve bir ( off ). Biz aracılığıyla konfor ve enerji tasarrufu yönetmek için bu devletleri kullanmak hvac_mode ve sıcaklık veri değerlerinin.

  • Isı veya Soğuk modu (Ne zaman heat , cool ) seçilirse, Termostat hedef sıcaklığa ev ayarlar.
  • Heat • Soğuk modu (Ne zaman heat-cool ) seçilirse, Termostat Tercih sıcaklık aralığında, rahat bir ev tutacak.
  • Ne zaman Eko Sıcaklıklar (eko) seçilirse, Termostat rahat ev tutmak ve enerji kullanımını azaltmak için enerji tasarrufu algoritmaları uygular. Bu moddaki termostatlar EKO gösterir.

Yapıların mevcudiyet ile ilgili iki durumu vardır: Evde veya Dışarıda. Evde herhangi bir hareket algılanmadığında, yapı Evden Uzak'a değişecek ve evdeki Termostatlar otomatik olarak Eko Sıcaklıkları etkinleştirecektir.

Nasıl hvac_mode ve sıcaklık değerleri birlikte çalışmak

Değerine bağlı olarak hvac_mode , sadece belirli sıcaklık veri değerleri API 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, değişen etrafında özel kurallar vardır hvac_mode :

senaryo Can hvac_mode değiştirilebilir?
Sıcaklık Kilidi etkinleştirildiğinde Evet
Acil durdurma aktif Hayır
Acil Isı etkindir Hayır
can_cool veya can_heat değer false Hayır

Eko Sıcaklıklar

Eko Sıcaklıklar, kullanıcının evde olsun veya olmasın enerji tasarrufu yapmasına olanak tanır. Anahtarlama düşünün hvac_mode için eco ürününüz enerji tasarrufu davranışları uygularken.

Eko Sıcaklık bitiş noktaları okumak ve okuma / yazma v6 izinleri Termostat ile başlayan Nest API mevcuttur.

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

Ürününüzün hedef sıcaklıkları doğrudan Eco modunda yönetmesi gerekmez. Ev uzakta olarak 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ıklar gözlemlenmez.

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

  1. Değişim hvac_mode dışında başka bir değere eco
  2. Uygun değiştirme target_temperature veri değerlerini

Termostat ile başlayan okuma ve okuma / yazma v6 izinleri, erişebileceğiniz previous_hvac_mode HVAC modu geçişler ile yardımcı olmak için API üzerinden. previous_hvac_mode saklamak için kullanılır hvac_mode o "eko" geçirildikten önce cihazın.

Örneğin, Nest eğer Termostat Eko Sıcaklıkları (kullanıyor hvac_mode = "eco" ), previous_hvac_mode kullanılabilir ve set ürününüzü istediğiniz target_temperature , o zaman ilk gerekir:

  1. olsun previous_hvac_mode
  2. grubu hvac_mode için previous_hvac_mode değeri
  3. onayla hvac_mode artık ayarlandığında "eko"

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:

Ne zaman hvac_mode halidir ... Ardından, 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. Works with Nest ürünleri API'den hedef sıcaklığı daha büyük bir işlemin parçası olarak yazabilir.

Sistem açıkken her zaman ayarlanmış bir hedef sıcaklık vardır.

  • Isıtma ve soğutma modu (zaman heat , cool ) seçildiğinde, tek target_temperature dizi
  • Isı • Soğuk modu (zaman heat-cool ) seçildiğinde, iki target_temperature değerleri, bir hedef dizi, soğutma için daha yüksek bir tek ve ısıtma için bir alt gösteren, ayarlanır
  • Eko modu (zaman eco ) seçilir, hedef sıcaklık aralığı dahili olarak ayarlanır

Ayrıca, boruların donmasını veya evdeki aşırı yüksek sıcaklıkları önlemek için bir geri dönüş noktası olan güvenlik sıcaklıkları da vardır.

Termostat KAPALI olduğunda, hedef sıcaklıklar ayarlanmaz.

Sıcaklık Süresi

Zaman-Sıcaklık size HVAC sistemi için bu veriler değerlerine erişim sağlar:

  • time_to_target - Zaman, dakika cinsinden, bu yapı için alacağı hedef sıcaklığa ulaşmak için
  • 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 zaman tahmininin oldukça emin olduğunda, durumu değişerek training için 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, Celsius veya Fahrenheit ölçeğine göre düzenlenir. temperature_scale özelliği, kullanıcının tercihine bağlı olarak, ya da "K" ya da "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 termostatı olması mümkündür. Tutun kullanıcı tercihlerini sıcaklık değerlerini gösteren akılda.

İle başlayan izinler versiyon v5 , API aracılığıyla sıcaklık ölçeğini değiştirebilir.

Hedef ve ortam ısısı alanları var _f ve _c sıcaklıklarını gösterirken tutarlı yuvarlama karşılamak için varyantları.

Sıcaklık göstergesi

Termostat

Eğer hedef sıcaklık bilgilerini görüntülemek zaman, bu üç bağımlı değerleri göz önünde bulundurun: temperature_scale , hvac_mode ve yapının away devlet.

Nest Thermostat ekranında nelerin gösterildiğini ve nasıl davrandığını belirlemek için birçok veri değeri birlikte çalışır.

  • Tüm hvac_mode ayarlanır heat-cool , Yuva Termostat görüntüler, düşük ve yüksek ayar noktaları, sadece hedef sıcaklık, bir işaretiyle (•) ile başka Yuvası Termostat görüntüler ayrıldı
  • Ne zaman hvac_mode ayarlandığında off , kelime "KAPALI" kullanıcının tercih ettiği dilde, Nest Termostat görüntülenir
  • Ne zaman hvac_mode ayarlandığında eco , kelime "ECO" kullanıcının tercih ettiği dilde, Nest Termostat görüntülenir

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

Fahrenhayt 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ı, son basamak ".5" olarak ayarlanmış olarak, bir tam sayı veya ondalık değer olarak görüntülenir:

  • Hedef sıcaklık: 12°C
  • Ortam sıcaklığı: 16,5°C

Yaprak

Yaprak simgesi termostat ön gösteren, termostat bir enerji tasarrufu sıcaklığa ayarlanır ve has_leaf = true .

Yaprak

Sıcaklık Kilidi

Kullanıcılar, yalnızca sınırlı bir sıcaklık aralığında ayarlanabilmesi için bir Nest Termostatı kilitleyebilir. İle başlayan izinleri versiyon v5 eğer görebilirsiniz Sıcaklık Kilidi kontrol ederek etkindir is_locked ve sorun olduğu takdirde API aracılığıyla Sıcaklık Kilit min / maks değerleri okuyun:

Kilit sıcaklıkları maksimum ve minimum değerler olarak çiftler halinde belirtilmelidir ve keşke yazılabilir is_locked = true .

Nem

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

güneş kremi

Güneş Koruyucu teknolojisi otomatik olarak ünitenin üzerinde doğrudan güneş ışığından meydana ısı ani telafi etmek Nest Termostat üzerindeki sıcaklığı ayarlar.

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

yelpaze

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

Bununla birlikte, HVAC sistemi uyumluysa, tam HVAC sistemini devreye sokmadan yolcuları daha rahat hale getirmek için fan API aracılığıyla açık bir şekilde açılabilir.

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

  • fan_timer_active - boolean, döner true fan zamanlayıcısı önceden programlanmış süre için devrede olup olmadığını
  • fan_timer_duration - int (dakika olarak) bir zaman uzunluğu fanı çalıştırmak için ayarlandığını

Belirli bir süre için fan zamanlayıcısını başlatmak (fanı açmak) için bu değerleri birlikte kullanın. Ayrıca kullanabilirsiniz fan_timer_timeout fanı çalıştıran durdurmak için ayarlandığında damgası belirlemek için değer.

Hep değişebileceğini Not fan_timer_duration o bağımsızdır - hvac_mode veya yapı doluluk durumuna (uzaklıkta).

Bu yanıtları başarılı veya başarısız olarak bekleyebilirsiniz:

  • 200 TAMAM
  • 400 Hatalı İstek

Fanı açma komutu beklenen sonucu vermiyorsa, bunun nedeni fanın halihazırda devreye girmiş olması olabilir (kullanıcı tarafından manuel olarak veya bir programa göre veya bir HVAC ısıtma/soğutma döngüsü nedeniyle).

Hız sınırlaması

Cihazlara yapılan ve sistem veya pil performansını etkileyebilecek aşırı çağrılara karşı koruma sağlamak için hız sınırlaması uyguluyoruz. Normal şartlar altında Nest cihazları, ısıtma ve soğutma sistemi üzerindeki alçak gerilim kablolarından pili şarj eder. Ancak kısa bir süre içinde aşırı arama yapılırsa ve pil seviyesi düşerse, Nest Thermostat güç tasarrufu yapmak için Wi-Fi'yi kapatır.

Pratikte 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 talebini yerine getirmek için yeterli pil gücüne sahip olmayabilir. Bu durumda, bir hata yanıtı ve cihazın şu anda isteğe hizmet veremeyeceğini belirten bir mesaj alırsınız. Bu olursa, tekrar denemeden önce pilin yeniden şarj olması için biraz zaman verin.

Hakkında daha fazla bilgi Nest Learning Termostat düşük pil koşulları .

Hata mesajları

Bazı eyaletler belirli işlevleri kullanılamaz hale getirir. Bu kurallar, enerji tasarrufu veya konfor ve güvenlik sağlamak için uygulanmaktadır.

API çağrısı hataları anlama ve bunların nasıl işleneceğine, gördükleri hakkında bilgi için Hata Mesajları .

Wi-Fi / bağlantı sorunu

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