Notice: We're retiring Works with Nest. See the home page for more information.
Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.
Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Termostat

Kontrol termostat

Nest Learning Thermostat ™ adalah perangkat yang terhubung ke internet yang intuitif dan mudah digunakan, terus belajar tentang pola penggunaan di rumah untuk mengoptimalkan kenyamanan dan menghemat energi. Pengguna dapat mengontrol pemanasan dan pendinginan di mana pun mereka memiliki akses ke koneksi Internet.

Mendukung fitur-fitur ini membutuhkan sistem kontrol canggih yang melampaui program berbasis setpoint sederhana. Nest menyediakan berbagai algoritma (seperti Early On , True Radiant , Airwave ™ ) yang membutuhkan daya komputasi dalam jumlah yang signifikan dibandingkan kebanyakan termostat. Nest Thermostat memiliki kekuatan yang dibutuhkan untuk menyediakan fitur-fitur canggih ini.

Nest API dirancang untuk memungkinkan produk mengontrol sistem HVAC tanpa mengganggu algoritme Nest atau mengejutkan pengguna dengan perilaku yang tidak terduga. Mereka menyediakan akses ke data berikut untuk Nest Thermostat:

  • Nama struktur dan perangkat "di mana nama" (lokasi di rumah)
  • Label termostat khusus
  • Status online dan informasi koneksi terakhir
  • Suhu saat ini dan target
  • Mode suhu
  • Suhu Ramah Lingkungan
  • Waktu-ke-Suhu
  • Skala suhu (set F / C)
  • Status Kunci Suhu , dan jika dikunci, nilai suhu minimum dikunci
  • Durasi timer kipas dan mode HVAC
  • Kelembaban
  • Sunblock

Izin termostat

Untuk akses baca ke semua nilai data Thermostat API, pilih izin baca Thermostat untuk klien Anda.

Untuk akses baca ke semua nilai data Thermostat API dan akses tulis tambahan untuk memilih nilai, pilih izin baca / tulis Thermostat untuk klien Anda. Tingkat izin ini memungkinkan Anda untuk memperbarui yang berikut:

  • Suhu target
  • Mode HVAC
  • Pengatur waktu kipas

Dimulai dengan Thermostat baca / tulis v5, Anda juga dapat memperbarui yang berikut ini:

  • Skala suhu
  • Label termostat

Pengidentifikasi termostat

Alat

Perangkat Nest dicantumkan berdasarkan jenis sebagai array ID, yang dapat digunakan untuk mengidentifikasi perangkat secara unik melalui jalur perangkat. Jadi ID termostat "peyiJNo..." berarti Anda dapat memuat model perangkat termostat di devices/thermostats/peyiJNo... melalui API.

Ketika perangkat terhubung ke beberapa produk, setiap pengembang akan melihat ID yang berbeda untuk perangkat itu. Untuk perangkat yang telah menginstal banyak produk dari pengembang yang sama, pengembang akan melihat ID yang sama.

Nama

Dua atribut nama disediakan. Atribut name lebih pendek ditampilkan dalam label antarmuka pengguna, sementara name_long digunakan dalam teks formulir panjang.

name

Dalam contoh-contoh ini, name adalah "Lorong" atau "Lorong (Barat)".

NamaNama panjang

name_long

Dalam contoh ini, name_long adalah "Office (Atas)".

Nama panjang di pesan

Label

Di mana nama (label)
Di mana nama (label)

Dimulai dengan izin versi v5 , Anda dapat menambahkan label termostat khusus melalui API. Di aplikasi Nest, label muncul di tanda kurung, setelah nama tempat.

Dimulai dengan izin versi v6 , Anda juga dapat membaca label Thermostat.

Dimana

where_id

  • Pengidentifikasi unik yang dibuat oleh Nest yang mewakili name
  • where_id read-only, dan dibuat secara otomatis dalam panggilan untuk membuat custom mana name

Pelajari lebih lanjut tentang di mana nama untuk Termostat Sarang , Perlindungan Sarang , dan Sarang Cams .

where_name

Ketika Anda memilih salah satu izin Thermostat , Anda dapat mengakses perangkat where_name dari objek perangkat ( devices/thermostats ).

Metadata lainnya

Semua nilai data hanya baca, kecuali ditentukan lain.

Nilai Data Deskripsi
locale Bahasa dan kode negara yang ditetapkan untuk perangkat ini
software_version Sebuah string yang mewakili firmware yang saat ini diinstal pada perangkat
structure_id String yang secara unik mewakili struktur ini; ini adalah struktur yang dipasangkan dengan perangkat
last_connection Stempel waktu koneksi terakhir yang berhasil ke layanan Nest
is_online Status online. Ini ditentukan oleh Nest menggunakan waktu last_connection dan jendela koneksi ulang yang diharapkan adalah khusus perangkat.

Fitur termostat

Mode termostat

Sistem HVAC memiliki empat status "on" ( heat , cool , heat-cool , eco ) dan satu keadaan "mati" ( off ). Kami menggunakan status ini untuk mengelola kenyamanan dan penghematan energi melalui nilai data hvac_mode dan suhu.

  • Ketika mode Panas atau Dingin ( heat , cool ) dipilih, Thermostat menyesuaikan rumah dengan suhu target.
  • Saat Panas • Mode dingin ( heat-cool ) dipilih, Thermostat akan membuat rumah nyaman, dalam kisaran suhu yang disukai.
  • Ketika Eco Temperatures (eco) dipilih, Thermostat akan menerapkan algoritma hemat energi untuk membuat rumah nyaman dan mengurangi penggunaan energi. Termostat dalam mode ini menampilkan ECO.

Struktur memiliki dua status yang terkait dengan keberadaan: Rumah atau Jauh. Ketika tidak ada gerakan yang dirasakan di rumah, struktur akan berubah dari Rumah ke Jauh, dan Termostat di rumah akan memungkinkan Temperatur Ramah Lingkungan secara otomatis.

Bagaimana nilai hvac_mode dan suhu bekerja bersama

Bergantung pada nilai hvac_mode , hanya nilai data suhu tertentu yang dapat diakses di API:

Mode HVAC Nilai data suhu yang dapat Anda akses
heat atau cool target_temperature_f atau target_temperature_c
heat-cool target_temperature_low_f dan target_temperature_high_f
atau
target_temperature_low_c dan target_temperature_high_c
eco eco_temperature_low_f dan eco_temperature_high_f
atau
eco_temperature_low_c dan eco_temperature_high_c
off tidak ada

Dalam beberapa skenario, ada aturan khusus untuk mengubah hvac_mode :

Skenario Bisakah hvac_mode diubah?
Kunci Suhu diaktifkan Iya
Shutoff Darurat aktif Tidak
Panas Darurat diaktifkan Tidak
can_cool atau can_heat nilai adalah false Tidak

Suhu Ramah Lingkungan

Eco Temperatures memungkinkan pengguna untuk menghemat energi, apakah itu rumah atau tidak. Pertimbangkan untuk mengganti hvac_mode menjadi eco ketika menerapkan perilaku hemat energi dalam produk Anda.

Titik akhir Suhu Ramah Lingkungan tersedia di Nest API yang dimulai dengan izin Thermostat read and read / read v6.

Beralih antara mode eco dan non-eco

Produk Anda seharusnya tidak perlu mengatur suhu target secara langsung dalam mode Eco. Ketika rumah diatur untuk pergi, suhu target tidak ditampilkan, tetapi ditetapkan secara internal, berdasarkan pilihan pengguna. Ketika termostat diatur ke OFF, maka tidak ada suhu target yang diamati.

Jika Anda benar-benar harus mengubah suhu target secara langsung, pastikan untuk melakukan perubahan pada dua panggilan terpisah:

  1. Ubah hvac_mode ke nilai lain apa pun selain eco
  2. Ubah nilai data target_temperature sesuai

Dimulai dengan Thermostat membaca dan membaca / menulis perizinan v6, Anda dapat mengakses previous_hvac_mode melalui API untuk membantu dengan modus HVAC transisi. previous_hvac_mode digunakan untuk menyimpan hvac_mode perangkat sebelum beralih ke "eco".

Sebagai contoh, jika Nest Thermostat menggunakan Eco Suhu ( hvac_mode = "eco" ), previous_hvac_mode tersedia, dan Anda ingin produk Anda untuk set target_temperature , maka Anda harus terlebih dahulu:

  1. dapatkan previous_hvac_mode
  2. set hvac_mode ke previous_hvac_mode nilai
  3. konfirmasi hvac_mode tidak lagi disetel ke "eco"

Setelah langkah-langkah ini, atur suhu target sesuai kebutuhan.

Tergantung pada hvac_mode nilai, ini adalah bagaimana previous_hvac_mode perubahan:

Saat status hvac_mode adalah ... Kemudian, previous_hvac_mode dapat menjadi ...
eco heat , cool , heat-cool atau off
heat , cool , heat-cool atau off kosong / kosong

Suhu target

Suhu target adalah nilai paling penting untuk sistem HVAC - suhu yang diinginkan, biasanya ditetapkan oleh pengguna. Sebagian besar tindakan dan keputusan didasarkan padanya. Dari API, produk Works with Nest dapat menuliskan suhu target sebagai bagian dari proses yang lebih besar.

Selalu ada suhu target yang ditetapkan saat sistem menyala.

  • Ketika mode Panas atau Dingin ( heat , cool ) dipilih, target_temperature tunggal diatur
  • Ketika Panas • Mode dingin ( heat-cool ) dipilih, dua nilai target_temperature diatur, yang menunjukkan kisaran target, yang lebih tinggi untuk pendinginan dan yang lebih rendah untuk pemanasan
  • Ketika mode Eco ( eco ) dipilih, kisaran suhu target ditetapkan secara internal

Ada juga suhu keamanan yang menjadi penghalang untuk mencegah pipa beku atau suhu yang terlalu tinggi di rumah.

Ketika Thermostat OFF, tidak ada suhu target yang ditetapkan.

Waktu-ke-Suhu

Time-to-Temperature memberi Anda akses ke nilai data ini untuk sistem HVAC:

  • time_to_target - Waktu, dalam beberapa menit, yang diperlukan struktur untuk mencapai suhu target
  • time_to_target_training
    • Status pelatihan
    • Ketika Thermostat mempelajari bagaimana sistem HVAC merespons, ia menyesuaikan perkiraan untuk mencapai suhu target
    • Ketika Thermostat cukup yakin dengan perkiraan waktu untuk mencapai suhu target, status akan berubah dari training menjadi ready

Suhu sekitar

Suhu diukur dekat termostat. Tampilkan nilai yang sesuai dengan skala suhu pilihan pengguna.

Skala suhu

Variabel suhu lingkungan dan target diatur oleh skala Celsius atau Fahrenheit. Atribut temperature_scale akan berupa "F" atau "C", tergantung pada preferensi pengguna. Properti ini diatur oleh setiap termostat, jadi ada kemungkinan bahwa dalam struktur tunggal pengguna mungkin memiliki dua termostat, satu di setiap skala suhu. Ingat preferensi pengguna saat menampilkan nilai suhu.

Dimulai dengan izin versi v5 , Anda dapat mengubah skala suhu melalui API.

Bidang Target dan Suhu _f memiliki varian _c dan _c untuk mengakomodasi pembulatan yang konsisten saat menampilkan suhu.

Tampilan suhu

Termostat

Saat Anda menampilkan informasi suhu target, pertimbangkan tiga nilai dependen ini: temperature_scale , hvac_mode , dan state away struktur.

Banyak nilai data bekerja bersama untuk menentukan apa yang ditampilkan pada layar Thermostat Nest, dan bagaimana perilakunya.

  • Ketika hvac_mode diatur ke heat-cool , Nest Thermostat menampilkan setpoint rendah dan tinggi yang dipisahkan oleh karakter bullet (•), jika tidak Thermostat Nest hanya menampilkan suhu target
  • Ketika hvac_mode diatur ke off , kata "OFF" ditampilkan pada Nest Thermostat, dalam bahasa pilihan pengguna
  • Ketika hvac_mode disetel ke eco , kata "ECO" ditampilkan pada Nest Thermostat, dalam bahasa pilihan pengguna

Format suhu tampilan juga tergantung pada skala suhu yang dipilih (F / C).

Suhu Fahrenheit ditampilkan sebagai bilangan bulat:

  • Suhu target: 55 ° F
  • Suhu sekitar: 62 ° F

Temperatur Celsius ditampilkan sebagai bilangan bulat atau nilai desimal, dengan angka terakhir ditetapkan ke ".5":

  • Suhu target: 12 ° C
  • Suhu sekitar: 16,5 ° C

Daun

Ketika ikon daun ditampilkan di bagian depan termostat, termostat diatur ke suhu hemat energi, dan has_leaf = true .

Daun

Kunci Suhu

Pengguna dapat mengunci Thermostat Nest sehingga hanya dapat disesuaikan dalam kisaran suhu terbatas. Dimulai dengan izin versi v5 , Anda dapat melihat apakah Suhu Kunci diaktifkan dengan memeriksa is_locked , dan jika ya, baca nilai min / maks Penguncian Suhu melalui API:

Suhu kunci harus ditentukan berpasangan, sebagai nilai maksimum dan minimum, dan hanya dapat ditulis jika is_locked = true .

Kelembaban

Kelembaban, dalam format persen (%), diukur pada perangkat, dibulatkan ke 5% terdekat.

Sunblock

Teknologi Sunblock secara otomatis menyesuaikan suhu pada Nest Thermostat untuk mengimbangi lonjakan panas yang terjadi akibat sinar matahari langsung pada unit.

Nilai data ini akan memberi tahu Anda jika Sunblock diaktifkan dan / atau secara aktif mengoreksi suhu.

Kipas

Banyak sistem HVAC memiliki kipas terintegrasi, yang berarti bahwa kipas tidak dapat dikontrol secara independen . Tidak ada mode mati untuk kipas terintegrasi, karena kipas perlu dijalankan ketika pemanasan atau pendinginan menyala.

Namun, jika sistem HVAC kompatibel, kipas dapat diaktifkan secara eksplisit melalui API, untuk membuat penghuni lebih nyaman, tanpa menggunakan sistem HVAC lengkap.

Jika kipas dapat dikontrol secara independen, has_fan akan disetel ke true , dan nilai data berikut ini dapat diatur dengan izin baca / tulis Thermostat:

Gunakan nilai-nilai ini bersama-sama untuk memulai penghitung waktu kipas (nyalakan kipas) untuk periode waktu tertentu. Anda juga dapat menggunakan nilai fan_timer_timeout untuk menentukan timestamp kapan fan diatur untuk berhenti berjalan.

Perhatikan bahwa Anda selalu dapat mengubah fan_timer_duration - tidak tergantung pada hvac_mode atau status hunian struktur (jauh).

Anda dapat mengharapkan respons ini berhasil atau gagal:

  • 200 OK
  • 400 permintaan Buruk

Jika perintah untuk menghidupkan kipas tidak menghasilkan hasil yang diharapkan, itu mungkin karena kipas sudah diaktifkan (baik secara manual oleh pengguna, atau pada jadwal, atau karena siklus panas / dingin HVAC).

Pembatasan nilai

Kami menerapkan pembatasan tarif untuk melindungi terhadap panggilan berlebihan ke perangkat, yang dapat mempengaruhi kinerja sistem atau baterai. Dalam kondisi normal, perangkat Nest mengisi baterai dari kabel bertegangan rendah pada sistem pemanas dan pendingin. Tetapi jika panggilan berlebihan dilakukan dalam waktu singkat dan level baterai hampir habis, Nest Thermostat akan mematikan Wi-Fi untuk menghemat daya.

Dalam praktiknya, ini berarti bahwa kami membatasi jumlah panggilan yang dapat dilakukan ke perangkat dalam periode waktu yang ditentukan. Jika Anda melebihi batas ini, Anda akan menerima respons kesalahan dan pesan yang menunjukkan bahwa Anda telah melampaui batas Anda.

Untuk informasi lebih lanjut, lihat Batas Data Rate .

Kendala daya

Dalam beberapa kasus, Thermostat mungkin tidak memiliki daya baterai yang cukup untuk melayani permintaan modifikasi. Dalam hal ini Anda akan menerima respons kesalahan dan pesan yang menunjukkan perangkat tidak dapat melayani permintaan saat ini. Jika ini terjadi, beri baterai waktu untuk diisi ulang sebelum mencoba lagi.

Pelajari lebih lanjut tentang kondisi baterai rendah di Nest Learning Thermostat .

Pesan kesalahan

Beberapa negara membuat fungsi tertentu tidak tersedia. Aturan-aturan ini ada untuk menghemat energi atau memberikan kenyamanan dan keamanan.

Untuk informasi tentang arti kesalahan panggilan API dan cara menanganinya, lihat Pesan Kesalahan .

Wi-Fi / masalah koneksi

Jika suatu perangkat sedang offline, modifikasi tidak diperbolehkan. Anda dapat mengamati keadaan online perangkat dalam model data dan menampilkan UI dengan tepat.