Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Termostat

Kontrol termostat

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

Mendukung fitur ini memerlukan sistem kontrol canggih yang melampaui dan melampaui program berbasis setpoint sederhana. Nest menyediakan berbagai macam algoritma (seperti Awal Pada , Benar Radiant , Airwave ™ ) yang memerlukan sejumlah besar daya komputasi dibandingkan dengan kebanyakan termostat. Nest Thermostat memiliki daya yang dibutuhkan untuk menyediakan fitur-fitur canggih ini.

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

  • Struktur nama dan perangkat "where name" (lokasi di rumah)
  • Label termostat khusus
  • Status online dan informasi koneksi terakhir
  • Suhu saat ini dan target
  • Mode suhu Temperature
  • Suhu Ramah Lingkungan
  • Waktu-ke-Suhu
  • Skala suhu (atur F/C)
  • Suhu Lock status, dan jika terkunci, min / max nilai suhu terkunci
  • Durasi pengatur waktu kipas dan mode HVAC
  • Kelembaban
  • tabir surya

Izin termostat

Untuk akses baca untuk semua nilai API Data Thermostat, pilih Thermostat membaca izin untuk klien Anda.

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

  • Suhu sasaran
  • Modus HVAC
  • Pengatur waktu kipas

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

  • Skala suhu
  • Label termostat

Pengidentifikasi termostat

Alat

Perangkat Nest dicantumkan menurut jenisnya sebagai larik ID, yang dapat digunakan untuk mengidentifikasi perangkat secara unik melalui jalur perangkat. Jadi ID thermostat dari "peyiJNo..." berarti bahwa Anda dapat memuat model perangkat termostat di devices/thermostats/peyiJNo... melalui API.

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

Nama

Dua atribut nama disediakan. Semakin pendek name atribut ditampilkan dalam label antarmuka pengguna, sementara name_long digunakan dalam bentuk teks panjang.

name

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

NamaNama panjang

name_long

Dalam contoh ini, name_long adalah "Office (lantai atas)".

Nama panjang dalam pesan

Label

Dimana nama (label)
Dimana nama (label)

Dimulai dengan versi izin v5 , Anda dapat menambahkan kustom thermostat label melalui API. Di aplikasi Nest, label muncul dalam tanda kurung, setelah nama where.

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

Dimana

where_id

  • Yang unik,-Nest dihasilkan identifier 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 Nest ,Nest Melindungi dan Nest Cams .

where_name

Bila Anda memilih salah satu hak akses Thermostat , Anda dapat mengakses perangkat where_name dari objek perangkat ( devices/thermostats ).

Metadata lainnya

Semua nilai data hanya dapat dibaca, kecuali ditentukan lain.

Nilai Data Deskripsi
locale Bahasa dan kode negara yang ditetapkan untuk perangkat ini
software_version String yang mewakili firmware yang saat ini diinstal pada perangkat
structure_id Sebuah 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 daring. Hal ini ditentukan oleh Nest menggunakan last_connection waktu dan diharapkan rekoneksi jendela yang khusus perangkat.

Fitur termostat

Mode termostat

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

  • Ketika panas atau mode dingin ( heat , cool ) dipilih, Thermostat menyesuaikan rumah untuk target suhu.
  • Ketika Panas • Keren modus ( heat-cool ) dipilih, Thermostat akan menjaga rumah yang nyaman, dalam suhu yang lebih disukai.
  • Ketika Eco Suhu (eko) dipilih, Thermostat akan menerapkan algoritma hemat energi untuk menjaga rumah nyaman dan mengurangi penggunaan energi. Termostat dalam mode ini menampilkan ECO.

Struktur memiliki dua status yang terkait dengan kehadiran: Home atau Away. Saat tidak ada gerakan yang dirasakan di dalam rumah, struktur akan berubah dari Rumah ke Tamu, dan Termostat di rumah akan mengaktifkan Suhu Hemat Energi secara otomatis.

Bagaimana hvac_mode dan suhu nilai-nilai bekerja sama

Tergantung pada nilai hvac_mode , hanya suhu nilai-nilai data tertentu dapat diakses dalam API:

Modus 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 di sekitar berubah hvac_mode :

Skenario Dapat hvac_mode diubah?
Lock suhu diaktifkan Iya
Darurat Sakelar 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, baik di rumah atau tidak. Pertimbangkan beralih hvac_mode untuk eco ketika menerapkan perilaku hemat energi pada produk Anda.

Eco endpoint Suhu tersedia di API Nest dimulai dengan Thermostat membaca dan membaca / menulis perizinan v6.

Beralih antara mode ramah lingkungan dan non-eko

Produk Anda tidak perlu mengelola suhu target secara langsung dalam mode Eco. Saat rumah diatur ke jauh, suhu target tidak ditampilkan, tetapi diatur 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 dalam dua panggilan terpisah:

  1. Perubahan hvac_mode ke nilai lain kecuali eco
  2. Memodifikasi sesuai target_temperature nilai data

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. get previous_hvac_mode
  2. set hvac_mode ke previous_hvac_mode nilai
  3. confirm hvac_mode tidak lagi diatur ke "eco"

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

Tergantung pada hvac_mode nilai, ini adalah bagaimana previous_hvac_mode perubahan:

Ketika hvac_mode negara adalah ... Kemudian, previous_hvac_mode bisa ...
eco heat , cool , heat-cool atau off
heat , cool , heat-cool atau off kosong/kosong

Suhu sasaran

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

Selalu ada target suhu yang disetel saat sistem menyala.

  • Ketika panas atau mode dingin ( heat , cool ) dipilih, satu target_temperature adalah set
  • Ketika Panas • Modus Keren ( heat-cool ) dipilih, dua target_temperature nilai-nilai yang ditetapkan, yang menunjukkan berbagai sasaran, yang lebih tinggi untuk pendinginan dan lebih rendah untuk pemanasan
  • Ketika mode Eco ( eco ) dipilih, kisaran suhu target yang ditetapkan secara internal

Ada juga suhu keselamatan yang merupakan penghalang untuk mencegah pipa membeku atau suhu yang terlalu tinggi di rumah.

Saat Termostat MATI, tidak ada suhu target yang ditetapkan.

Waktu-ke-Suhu

Waktu-ke-Suhu memberi Anda akses ke nilai-nilai data ini untuk sistem HVAC:

  • time_to_target - Waktu, dalam hitungan menit, bahwa ia akan mengambil struktur untuk mencapai target suhu
  • time_to_target_training
    • Status pelatihan
    • Saat Thermostat mempelajari bagaimana sistem HVAC merespons, itu menyesuaikan perkiraan untuk mencapai suhu target
    • Ketika Thermostat cukup yakin perkiraan waktu untuk mencapai target suhu, status akan berubah dari training ke ready

Suhu sekitar

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

Skala suhu

Variabel suhu sekitar dan target diatur oleh skala Celsius atau Fahrenheit. The temperature_scale atribut akan baik "F" atau "C", tergantung pada preferensi pengguna. Properti ini diatur oleh setiap termostat, jadi mungkin saja dalam satu struktur pengguna mungkin memiliki dua termostat, satu di setiap skala suhu. Menjaga preferensi pengguna dalam pikiran ketika menampilkan nilai suhu.

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

Target dan Ambient bidang Suhu memiliki _f dan _c varian untuk mengakomodasi pembulatan konsisten ketika menampilkan suhu.

Tampilan suhu

Termostat

Ketika Anda menampilkan informasi suhu sasaran, mempertimbangkan tiga nilai-nilai yang tergantung: temperature_scale , hvac_mode , dan struktur ini away negara.

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

  • Ketika hvac_mode diatur untuk heat-cool , Nest Thermostat menampilkan rendah dan setpoints tinggi dipisahkan oleh karakter bullet (•), jika tidak menampilkan Nest Thermostat hanya target suhu
  • Ketika hvac_mode diatur untuk off , kata "OFF" ditampilkan pada Nest Thermostat, dalam bahasa pilihan pengguna
  • Ketika hvac_mode diatur untuk 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

Suhu Celcius ditampilkan sebagai bilangan bulat atau nilai desimal, dengan digit terakhir diatur ke ".5":

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

Daun

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

Daun

Kunci Suhu

Pengguna dapat mengunci Nest Thermostat sehingga hanya dapat disesuaikan dalam rentang suhu yang terbatas. Dimulai dengan versi izin v5 , Anda dapat melihat apakah Suhu Lock diaktifkan oleh checking is_locked , dan jika itu adalah, membaca Lock Suhu min / max nilai-nilai melalui API:

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

Kelembaban

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

tabir surya

Sunblock teknologi secara otomatis menyesuaikan suhu pada Nest Thermostat untuk mengimbangi lonjakan panas yang terjadi dari 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 telah terintegrasi fans, yang berarti bahwa fan tidak dapat dikontrol secara independen . Tidak ada mode mati untuk kipas terintegrasi, karena kipas harus bekerja saat pemanasan atau pendinginan menyala.

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

Jika kipas dapat dikontrol secara independen, has_fan akan diatur ke true , dan nilai-nilai data berikut dapat diatur dengan Thermostat membaca / menulis perizinan:

  • fan_timer_active - boolean, mengembalikan true jika fan waktu bergerak untuk durasi pra-diprogram
  • fan_timer_duration - int, panjang waktu (dalam menit) bahwa kipas diatur untuk berjalan

Gunakan nilai-nilai ini bersama-sama untuk memulai timer kipas (nyalakan kipas) untuk jangka waktu tertentu. Anda juga dapat menggunakan fan_timer_timeout nilai untuk menentukan timestamp ketika kipas diatur untuk berhenti berjalan.

Perhatikan bahwa Anda selalu dapat mengubah fan_timer_duration - itu adalah independen dari hvac_mode atau negara struktur hunian (jauh).

Anda dapat mengharapkan tanggapan ini pada keberhasilan atau kegagalan:

  • 200 oke
  • 400 permintaan Buruk

Jika perintah untuk menyalakan kipas tidak memberikan hasil yang diharapkan, mungkin karena kipas telah diaktifkan (baik secara manual oleh pengguna, atau sesuai jadwal, atau karena siklus panas/dingin HVAC).

Pembatasan tarif

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

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

Untuk informasi lebih lanjut, lihat Batas Data Rate .

Kendala daya

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

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

Pesan kesalahan

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

Untuk informasi tentang apa kesalahan API panggilan berarti dan bagaimana untuk menangani mereka, lihat Pesan Kesalahan .

Masalah Wi-Fi / koneksi

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