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

恆溫器

恆溫控制

鳥巢學習溫控器™是一個互聯網連接的設備是直觀且易於使用,不斷地學習關於在家庭的使用模式,以優化舒適性,節約能源。用戶可以在可以訪問 Internet 連接的任何地方控制他們的加熱和冷卻。

支持這些功能需要一個複雜的控制系統,它超越了簡單的基於設定點的程序。鳥巢提供了廣泛的算法(如在早期是真正的輻射氣波™ )需要相比,大多數恆溫器計算能力的顯著量。 Nest Thermostat 具有提供這些高級功能所需的能力。

巢API被設計為允許產品來控制HVAC系統,而不破壞巢算法或奇與意外行為用戶。它們可以訪問 Nest Thermostat 的以下數據:

  • 結構名稱和設備“where name”(在家中的位置)
  • 自定義恆溫器標籤
  • 在線狀態和上次連接信息
  • 當前和目標溫度
  • 溫度模式
  • 生態溫度
  • 時間到溫度
  • 溫標(設定 F/C)
  • 溫度鎖定狀態,如果鎖定,最小/最大鎖定溫度值
  • 風扇定時器持續時間和 HVAC 模式
  • 濕度
  • 防曬霜

恆溫器權限

對於讀訪問所有溫控器API的數據值,選擇溫控器讀取權限為您的客戶。

對於讀訪問所有溫控器API數據值和額外的寫訪問選擇的值,選擇溫控器的讀/寫權限的客戶端。此權限級別允許您更新以下內容:

  • 目標溫度
  • 暖通空調模式
  • 風扇定時器

從 Thermostat 讀/寫 v5 開始,您還可以更新以下內容:

  • 溫標
  • 溫控器標籤

恆溫器標識符

設備

Nest 設備按類型作為 ID 數組列出,可用於通過設備路徑唯一標識設備。所以恆溫器ID "peyiJNo..."意味著你可以加載在恆溫設備型號devices/thermostats/peyiJNo...通過API。

當一個設備連接到多個產品時,每個開發人員都會看到該設備的不同 ID。對於安裝了同一開發者的多個產品的設備,開發者將看到相同的 ID。

名稱

提供了兩個名稱屬性。較短的name屬性被顯示在用戶界面的標籤,而name_long在長格式文本中使用。

name

在這些例子中, name是“走廊”或“走廊(西)”。

名稱名字長

name_long

在這個例子中, name_long是“辦公室(樓上)”。

消息中的長名稱

標籤

其中名稱(標籤)
其中名稱(標籤)

與年初權限版本V5 ,您可以通過API添加自定義標籤的恆溫。在 Nest 應用程序中,label 出現在括號中,在 where 名稱之後。

與年初權限版本V6 ,你也可以閱讀溫控器標籤。

在哪裡

where_id

  • 代表一個唯一的,巢生成的標識符name
  • where_id是只讀的,並在通話中自動創建創建自定義的地方name

了解更多關於哪裡的名字鳥巢恆溫器巢保護巢凸輪

where_name

當選擇任一的恆溫器的權限,則可以訪問設備where_name從設備對象( devices/thermostats )。

其他元數據

除非另有說明,否則所有數據值都是只讀的。

數據值描述
locale分配給此設備的語言和國家/地區代碼
software_version表示設備上當前安裝的固件的字符串
structure_id唯一表示此結構的字符串;這是設備配對的結構
last_connection上次成功連接到 Nest 服務的時間戳
is_online在線狀態。這是通過使用Nest確定last_connection時間,這是設備特定的預期的重新連接的窗口。

恆溫器特點

恆溫模式

HVAC系統具有四個“接通”狀態( heatcoolheat-cooleco )和一個“關”狀態( off )。我們利用這些國家通過管理舒適度和節能hvac_mode和溫度的數據值。

  • 當加熱或冷卻模式( heatcool被選擇),恆溫器調整家到目標溫度。
  • 當熱•冷模式( heat-cool被選擇),則恆溫器將保持家舒適,優選的溫度範圍之內。
  • 環保溫度(生態)時,恆溫器將採用節能算法來保持房子的舒適和減少能源消耗。此模式下的恆溫器顯示 ECO。

結構有兩種與存在相關的狀態:在家或離開。當房子內沒有感應到任何運動時,結構將從家裡變為外出,並且家中的恆溫器將自動啟用生態溫度。

如何hvac_mode和溫度值共同努力

取決於的值hvac_mode ,只有一定的溫度的數據值可以在API中進行訪問:

暖通空調模式您可以訪問的溫度數據值
heatcool target_temperature_ftarget_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
或者
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
或者
eco_temperature_low_ceco_temperature_high_c
off沒有任何

在某些情況下,大約有變化的特殊規則hvac_mode

設想可以hvac_mode改變?
溫度鎖定啟用是的
緊急切斷活躍
急熱啟動
can_coolcan_heat值是false

生態溫度

生態溫度允許用戶節省能源,無論他們是否在家。考慮切換hvac_modeeco在產品實現節能行為的時候。

生態溫度終點是鳥巢API與溫控器開始在提供讀取和讀/寫權限V6。

在環保和非環保模式之間切換

您的產品應該不需要直接在 Eco 模式下管理目標溫度。當家設置為離開時,不顯示目標溫度,而是根據用戶選擇在內部設置。當恆溫器設置為關閉時,則不會觀察到目標溫度。

如果您絕對必須直接更改目標溫度,請務必在兩個單獨的調用中進行更改:

  1. 更改hvac_mode ,除了任何其他價值eco
  2. 修改相應target_temperature數據值

與溫控器開始讀,讀/寫權限V6,您可以訪問previous_hvac_mode通過API,以幫助暖通空調模式轉換。 previous_hvac_mode用於存儲所述hvac_mode所述裝置的前它轉換到“生態”。

例如,如果Nest Thermostat會使用環保溫度( hvac_mode = "eco" previous_hvac_mode是可用的,並且您希望您的產品集target_temperature ,則必須首先:

  1. GET previous_hvac_mode
  2. hvac_modeprevious_hvac_mode
  3. 確認hvac_mode不再設置為“生態”

在這些步驟之後,根據需要設置目標溫度。

根據hvac_mode值,這是多麼previous_hvac_mode變化:

hvac_mode狀態...然後, previous_hvac_mode可...
eco heatcoolheat-cooloff
heatcoolheat-cooloff空白/空

目標溫度

目標溫度是 HVAC 系統最重要的值 - 它是所需的溫度,通常由用戶設置。大多數行動和決定都基於它。通過 API,Works with Nest 產品可以將目標溫度寫入更大的流程中。

當系統開啟時,總是有一個目標溫度設置。

  • 當加熱或冷卻模式( heatcool被選擇),一個單一的target_temperature是集
  • 當熱•冷模式( heat-cool被選擇),兩個target_temperature值被設定,表示目標範圍,一個更高的用於冷卻和加熱一個較低
  • 當節能模式( eco被選中)時,目標溫度範圍在內部設置

還有一些安全溫度可以作為後備,以防止管道凍結或家中溫度過高。

當恆溫器關閉時,不會設置目標溫度。

時間到溫度

時間-溫度,您可以訪問的HVAC系統這些數據值:

  • time_to_target -的時間,以分鐘為單位,其將採取該結構達到目標溫度
  • time_to_target_training
    • 訓練狀態
    • 當恆溫器了解 HVAC 系統如何響應時,它會調整達到目標溫度的估計值
    • 當溫控器是相當確定的時間估計達到目標溫度,狀態會從trainingready

環境溫度

在恆溫器附近測量的溫度。顯示與用戶首選溫標對應的值。

溫標

環境和目標溫度變量按攝氏或華氏標度組織。該temperature_scale屬性將會是“F”或“C”,這取決於用戶的偏好。此屬性由每個恆溫器設置,因此在單個結構中,用戶可能有兩個恆溫器,每個溫標一個。保持用戶的喜好記住顯示溫度值時。

與年初權限版本V5 ,您可以通過API改變溫標。

目標和環境溫度字段具有_f_c變體顯示的溫度時,以容納一致舍入。

溫度顯示

恆溫器

當顯示目標溫度信息,可以考慮這三個相關的值: temperature_scalehvac_mode和結構的away狀態。

許多數據值共同確定 Nest Thermostat 顯示屏上顯示的內容及其行為方式。

  • hvac_mode被設置為heat-cool ,Nest Thermostat會顯示在低和高設定點分離被子彈字符(•),否則巢恆溫器只顯示目標溫度
  • hvac_mode設置為off ,顯示在Nest Thermostat會單詞“OFF”,在用戶的首選語言
  • hvac_mode設為eco ,顯示在Nest Thermostat會單詞“ECO”,在用戶的首選語言

顯示溫度格式還取決於所選的溫標 (F/C)。

華氏溫度顯示為整數:

  • 目標溫度:55°F
  • 環境溫度:62°F

攝氏溫度顯示為整數或十進制值,最後一位數字設置為“.5”:

  • 目標溫度:12°C
  • 環境溫度:16.5°C

葉子

當葉圖標是顯示在恆溫器的前部,恆溫器被設定為節能溫度,和has_leaf = true

葉子

溫度鎖定

用戶可以鎖定 Nest Thermostat,使其只能在有限的溫度範圍內進行調節。與年初權限版本V5 ,你可以看到,如果溫度鎖定是通過檢查啟用is_locked ,如果是,通過API讀取溫度鎖定最小值/最大值:

鎖的溫度必須在對被指定,作為最大值和最小值,並且如果只能被寫入is_locked = true

濕度

濕度,以百分比 (%) 格式,在設備上測量,四捨五入到最接近的 5%。

防曬霜

防曬霜技術自動調整在巢溫控器的溫度,以補償從所述單元上陽光直射發生熱尖峰。

這些數據值將告訴您是否啟用了防曬霜和/或主動校正溫度。

扇子

許多HVAC系統具有集成的風扇,這意味著風扇不能被獨立控制。集成風扇沒有關閉模式,因為風扇需要在加熱或冷卻時運行。

但是,如果 HVAC 系統兼容,則可以通過 API 明確打開風扇,以使居住者更舒適,而無需使用整個 HVAC 系統。

如果風扇可以獨立地控制, has_fan將被設置為true ,並且以下的數據值可以與恆溫器被設置的讀/寫權限:

  • fan_timer_active -布爾值,返回true ,如果風扇計時器被接合為預編程的持續時間
  • fan_timer_duration - INT,的時間長度(分鐘),所述風扇設置為運行

將這些值一起使用以在特定時間段內啟動風扇計時器(打開風扇)。您也可以使用fan_timer_timeout值來確定當風扇設置停止運行的時間戳。

請注意,您可以隨時更改fan_timer_duration -它是獨立的hvac_mode或結構的佔用狀態(離開)。

您可以期待這些成功或失敗的響應:

  • 200 正常
  • 400 錯誤請求

如果打開風扇的命令沒有產生預期的結果,可能是因為風扇已經啟動(由用戶手動操作,或按計劃進行,或由於 HVAC 加熱/冷卻循環)。

速率限制

我們應用速率限制來防止過度調用設備,這可能會影響系統或電池性能。在正常情況下,Nest 設備通過加熱和冷卻系統上的低壓電線為電池充電。但是,如果在短時間內撥打過多電話並且電池電量變低,Nest Thermostat 將關閉 Wi-Fi 以節省電量。

實際上,這意味著我們限制了在定義的時間段內可以對設備進行的調用次數。如果超出此限制,您將收到錯誤響應和一條消息,表明您已超出限制。

欲了解更多信息,請參閱數據速率限制

功率限制

在某些情況下,恆溫器可能沒有足夠的電池電量來滿足修改請求。在這種情況下,您將收到錯誤響應和一條消息,指示設備此時無法為請求提供服務。如果發生這種情況,請在重試之前給電池一些時間充電。

了解更多關於在鳥巢學習溫控器電池電量不足的條件

錯誤信息

某些狀態導致某些功能不可用。制定這些規則是為了節約能源或提供舒適和安全。

對於哪些API調用錯誤的含義及如何處理這些信息,請參閱錯誤信息

Wi-Fi/連接問題

如果設備離線,則不允許修改。您可以在數據模型中觀察設備的在線狀態並適當地顯示 UI。