Google致力於提高黑人社區的種族平等。 怎麼看。
本頁面由 Cloud Translation API 翻譯而成。
Switch to English

溫控器

溫控器控制

Nest Learning Thermostat™是一種互聯網連接的設備,直觀易用,可不斷學習家庭使用方式,以優化舒適度並節省能源。用戶可以在任何可以訪問Internet連接的地方控制其加熱和冷卻。

要支持這些功能,就需要一個複雜的控制系統,該系統必須超越簡單的基於設定點的程序。 Nest提供了多種算法(例如Early OnTrue RadiantAirwave™ ),與大多數恆溫器相比,它們需要大量的計算能力。 Nest Thermostat具有提供這些高級功能所需的功能。

Nest API旨在允許產品控制HVAC系統,而不會中斷Nest算法或使用戶感到意外行為。他們可以訪問Nest Thermostat的以下數據:

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

溫控器權限

要對所有恆溫器API數據值進行讀取訪問, 為您的客戶端選擇恆溫器讀取權限。

要對所有恆溫器API數據值進行讀取訪問,並對選擇值進行其他寫入訪問, 為客戶端選擇恆溫器讀/寫權限。此權限級別使您可以更新以下內容:

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

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

  • 溫標
  • 溫控器標籤

恆溫器標識符

設備

嵌套設備按類型列出為ID數組,可用於通過設備路徑唯一標識設備。因此,恆溫器ID為"peyiJNo..."意味著您可以通過API在devices/thermostats/peyiJNo...加載恆溫器設備模型。

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

名稱

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

name

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

名稱名字長

name_long

在此示例中, name_long是“辦公室(樓上)”。

在消息中長名稱

標籤

姓名(標籤)
姓名(標籤)

權限版本v5開始,您可以通過API添加自定義恆溫器標籤。在Nest應用中,標籤會在where名稱後的括號中顯示。

權限版本v6開始,您還可以閱讀恆溫器標籤。

哪裡

where_id

  • 由Nest生成的唯一標識符,代表name
  • where_id是只讀的,並且會在調用中自動創建以創建自定義where name

詳細了解Nest ThermostatsNest ProtectsNest Cams的名稱

where_name

選擇任何恆溫器權限時 ,可以從設備對象( devices/thermostats )訪問設備where_name

其他元數據

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

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

溫控器功能

溫控器模式

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

  • 選擇“加熱”或“冷卻”模式(“ heat ,“ cool )時,恆溫器會將房屋調節到目標溫度。
  • 選擇“加熱• heat-cool模式(“ heat-cool )時,溫控器將在理想的溫度範圍內保持居家舒適。
  • 選擇“ 環保溫度” (eco Temperatures )時,恆溫器將應用節能算法,以保持房屋舒適並減少能源消耗。在此模式下的恆溫器顯示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_mode切換為eco

在Nest API中,可從恆溫器讀取權限和讀取/寫入v6權限開始使用Eco Temperature端點

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

您的產品無需在Eco模式下直接管理目標溫度。當房屋設置為離開時,基於用戶選擇,不顯示目標溫度,而是在內部設定目標溫度。當恆溫器設置為OFF時,則不會觀察到目標溫度。

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

  1. hvac_mode更改為eco以外的任何其他值
  2. 修改適當的target_temperature數據值

從恆溫器讀取和讀取/寫入v6權限開始,您可以通過API來訪問previous_hvac_mode ,以協助進行HVAC模式轉換。 previous_hvac_mode用於在過渡到“ eco”之前存儲設備的hvac_mode

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

  1. 獲取previous_hvac_mode
  2. hvac_mode設置為previous_hvac_mode
  3. 確認hvac_mode不再設置為“ eco”

完成這些步驟後,適當設置目標溫度。

根據hvac_mode值,這是previous_hvac_mode變化方式:

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

目標溫度

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

打開系統電源時,始終會設置目標溫度。

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

還有一些安全溫度可作為後盾,以防止管道凍結或房屋內溫度過高。

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

到達溫度

溫度變化使您可以訪問HVAC系統的以下數據值:

  • time_to_target結構達到目標溫度time_to_target的時間(以分鐘為單位)
  • time_to_target_training
    • 培訓狀況
    • 當恆溫器了解HVAC系統的響應方式時,它會調整估算值以達到目標溫度
    • 當恆溫器有足夠的把握確保達到目標溫度所需的時間時,狀態會從training變為ready

環境溫度

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

溫標

環境溫度和目標溫度變量按攝氏度或華氏度來組織。根據用戶的喜好, temperature_scale屬性將為“ F”或“ C”。此屬性由每個恆溫器設置,因此,在單個結構中,用戶可能有兩個恆溫器,每個溫度範圍一個。在顯示溫度值時,請記住用戶的偏好

權限版本v5開始,您可以通過API更改溫度範圍。

“目標溫度”和“環境溫度”字段具有_f_c變體,以適應顯示溫度時的四捨五入。

溫度顯示

溫控器

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

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

  • 如果將hvac_mode設置為heat-cool ,則Nest Thermostat會顯示上下限設定值,並以項目符號(•)分隔,否則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%。

防曬霜

Sunblock技術會自動調節Nest Thermostat上的溫度,以補償由於陽光直射在設備上而產生的熱量峰值。

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

風扇

許多HVAC系統都集成了風扇,這意味著無法獨立控制風扇 。集成風扇沒有關閉模式,因為在加熱或冷卻打開時風扇需要運行。

但是,如果兼容HVAC系統,則可以通過API顯式打開風扇,以使乘員更舒適,而無需使用整個HVAC系統。

如果可以獨立控制風扇,則has_fan將設置為true ,並可以通過恆溫器讀/寫權限設置以下數據值:

  • fan_timer_active布爾值,如果使用了風扇定時器達預編程的持續時間,則返回true
  • fan_timer_duration -int,風扇設置為運行的時間長度(以分鐘為單位)

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

請注意,您始終可以更改fan_timer_duration它與hvac_mode或結構佔用狀態(離開)無關。

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

  • 200 OK
  • 400錯誤的要求

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

限速

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

實際上,這意味著我們限制了在定義的時間段內可以撥打設備的電話數量。如果超過此限制,您將收到錯誤響應和一條消息,指出您已超過限制。

有關更多信息,請參見數據速率限制

功率限制

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

在Nest Learning Thermostat中了解有關電池電量不足的更多信息。

錯誤訊息

有些狀態使某些功能不可用。這些規則是為了節約能源或提供舒適性和安全性而製定的。

有關什麼是API調用錯誤的含義以及如何處理錯誤的信息 ,請參見錯誤消息

WLAN /連接問題

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