Notice: We're retiring Works with Nest. See the home page for more information.
Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.
Trang này được dịch bởi Cloud Translation API.
Switch to English

Bình giữ nhiệt

Điều khiển nhiệt

Nest Learning Thermostat ™ là một thiết bị kết nối Internet trực quan và dễ sử dụng, liên tục tìm hiểu về các kiểu sử dụng trong nhà để tối ưu hóa sự thoải mái và tiết kiệm năng lượng. Người dùng có thể kiểm soát hệ thống sưởi và làm mát ở bất cứ nơi nào họ có quyền truy cập vào kết nối Internet.

Hỗ trợ các tính năng này đòi hỏi một hệ thống điều khiển tinh vi vượt trên và vượt ra ngoài các chương trình dựa trên điểm đặt đơn giản. Nest cung cấp một loạt các thuật toán (như Early On , True Radiant , Airwave ™ ) đòi hỏi một lượng sức mạnh tính toán đáng kể so với hầu hết các bộ điều nhiệt. Bộ điều nhiệt Nest có sức mạnh cần thiết để cung cấp các tính năng tiên tiến này.

API Nest được thiết kế để cho phép các sản phẩm kiểm soát hệ thống HVAC mà không làm gián đoạn thuật toán Nest hoặc gây ngạc nhiên cho người dùng với các hành vi không mong muốn. Họ cung cấp quyền truy cập vào các dữ liệu sau đây cho Bộ điều nhiệt Nest:

  • Tên cấu trúc và thiết bị "nơi tên" (vị trí trong nhà)
  • Nhãn nhiệt tùy chỉnh
  • Trạng thái trực tuyến và thông tin kết nối cuối cùng
  • Nhiệt độ hiện tại và mục tiêu
  • Chế độ nhiệt độ
  • Nhiệt độ sinh thái
  • Thời gian đến nhiệt độ
  • Thang đo nhiệt độ (đặt F / C)
  • Trạng thái Khóa nhiệt độ và nếu bị khóa, các giá trị nhiệt độ khóa tối thiểu / tối đa
  • Thời gian hẹn giờ của quạt và chế độ HVAC
  • Độ ẩm
  • Kem chống nắng

Quyền điều chỉnh nhiệt

Để truy cập đọc vào tất cả các giá trị dữ liệu API của Bộ điều nhiệt, hãy chọn quyền đọc Bộ điều chỉnh nhiệt cho khách hàng của bạn.

Để truy cập đọc vào tất cả các giá trị dữ liệu API của Bộ điều nhiệt và quyền truy cập ghi bổ sung vào các giá trị được chọn, hãy chọn quyền đọc / ghi của Bộ điều nhiệt cho khách hàng của bạn. Mức cấp phép này cho phép bạn cập nhật các thông tin sau:

  • Nhiệt độ mục tiêu
  • Chế độ HVAC
  • Quạt hẹn giờ

Bắt đầu với Bộ điều nhiệt đọc / ghi v5, bạn cũng có thể cập nhật các thông tin sau:

  • Thang đo nhiệt độ
  • Nhãn nhiệt

Định danh nhiệt

Thiết bị

Các thiết bị Nest được liệt kê theo loại dưới dạng một mảng ID, có thể được sử dụng để nhận dạng duy nhất một thiết bị thông qua đường dẫn thiết bị. Vì vậy, ID bộ điều chỉnh nhiệt của "peyiJNo..." có nghĩa là bạn có thể tải mô hình thiết bị điều chỉnh nhiệt tại devices/thermostats/peyiJNo... thông qua API.

Khi một thiết bị được kết nối với nhiều sản phẩm, mỗi nhà phát triển sẽ thấy một ID khác nhau cho thiết bị đó. Đối với một thiết bị đã cài đặt nhiều sản phẩm từ cùng một nhà phát triển, nhà phát triển sẽ thấy cùng một ID.

Tên

Hai thuộc tính tên được cung cấp. Thuộc tính name ngắn hơn được hiển thị trong nhãn giao diện người dùng, trong khi name_long được sử dụng trong văn bản dạng dài.

name

Trong các ví dụ này, name là "Hành lang" hoặc "Hành lang (Tây)".

TênTên dài

name_long

Trong ví dụ này, name_long là "Office (Tầng trên)".

Tên dài trong một tin nhắn

Nhãn

Tên (nhãn)
Tên (nhãn)

Bắt đầu với phiên bản quyền v5 , bạn có thể thêm nhãn điều chỉnh nhiệt thông qua API. Trong ứng dụng Nest, nhãn xuất hiện trong ngoặc đơn, sau tên nơi.

Bắt đầu với phiên bản quyền v6 , bạn cũng có thể đọc nhãn Bộ điều chỉnh nhiệt.

Ở đâu

where_id

  • Một định danh duy nhất, do Nest tạo ra đại diện cho name
  • where_id ở chế độ chỉ đọc và được tạo tự động trong cuộc gọi để tạo một name tùy chỉnh

Tìm hiểu thêm về nơi đặt tên cho Nest Thermostats , Nest ProtectsNest Cam .

where_name

Khi bạn chọn bất kỳ quyền của Bộ điều chỉnh nhiệt , bạn có thể truy cập vào thiết bị where_name từ đối tượng devices/thermostats ( devices/thermostats ).

Siêu dữ liệu khác

Tất cả các giá trị dữ liệu chỉ được đọc, trừ khi có quy định khác.

Giá trị dữ liệu Sự miêu tả
locale Ngôn ngữ và mã quốc gia được gán cho thiết bị này
software_version Một chuỗi đại diện cho phần sụn hiện được cài đặt trên thiết bị
structure_id Một chuỗi đại diện duy nhất cho cấu trúc này; đây là cấu trúc mà thiết bị được ghép nối với
last_connection Dấu thời gian của kết nối thành công cuối cùng với dịch vụ Nest
is_online Trạng thái trực tuyến. Điều này được Nest xác định bằng cách sử dụng thời gian kết nối last_connection cùng và cửa sổ kết nối lại dự kiến ​​dành riêng cho thiết bị.

Tính năng điều nhiệt

Chế độ nhiệt

Hệ thống HVAC có bốn trạng thái "bật" ( heat , cool , heat-cool , eco ) và một trạng thái "tắt" ( off ). Chúng tôi sử dụng các trạng thái này để quản lý sự thoải mái và tiết kiệm năng lượng thông qua các giá trị dữ liệu nhiệt độ và hvac_mode .

  • Khi chế độ Nhiệt hoặc Mát ( heat , cool ) được chọn, Bộ điều chỉnh nhiệt sẽ điều chỉnh nhà theo nhiệt độ mục tiêu.
  • Khi Nhiệt • Chế độ làm mát ( heat-cool ) được chọn, Bộ điều chỉnh nhiệt sẽ giữ cho ngôi nhà thoải mái, trong phạm vi nhiệt độ ưa thích.
  • Khi chọn Nhiệt độ sinh thái (sinh thái), Bộ điều nhiệt sẽ áp dụng các thuật toán tiết kiệm năng lượng để giữ cho ngôi nhà thoải mái và giảm mức sử dụng năng lượng. Bộ điều nhiệt trong chế độ này hiển thị ECO.

Cấu trúc có hai trạng thái liên quan đến sự hiện diện: Nhà hoặc Đi. Khi không có chuyển động nào được cảm nhận trong nhà, cấu trúc sẽ thay đổi từ Home sang Away và Thermostats trong nhà sẽ tự động kích hoạt Eco Temperatures.

Làm thế nào hvac_mode và giá trị nhiệt độ làm việc cùng nhau

Tùy thuộc vào giá trị của hvac_mode , chỉ có thể truy cập các giá trị dữ liệu nhiệt độ nhất định trong API:

Chế độ HVAC Giá trị dữ liệu nhiệt độ bạn có thể truy cập
heat hoặc cool target_temperature_f hoặc target_temperature_c
heat-cool target_temperature_low_ftarget_temperature_high_f
hoặc là
target_temperature_low_ctarget_temperature_high_c
eco eco_temperature_low_feco_temperature_high_f
hoặc là
eco_temperature_low_ceco_temperature_high_c
off không ai

Trong một số trường hợp, có các quy tắc đặc biệt xung quanh việc thay đổi hvac_mode :

Kịch bản hvac_mode có thể được thay đổi không?
Khóa nhiệt độ được kích hoạt Đúng
Tắt khẩn cấp đang hoạt động Không
Nhiệt khẩn cấp được kích hoạt Không
can_cool hoặc can_heat giá trị là false Không

Nhiệt độ sinh thái

Eco Temperatures cho phép người dùng tiết kiệm năng lượng, cho dù họ có ở nhà hay không. Cân nhắc chuyển đổi hvac_mode thành eco khi thực hiện các hành vi tiết kiệm năng lượng trong sản phẩm của bạn.

Điểm cuối Eco Nhiệt độ có sẵn trong API Nest bắt đầu với quyền đọc và đọc / ghi v6 của Therm Therm.

Chuyển đổi giữa chế độ sinh thái và phi sinh thái

Sản phẩm của bạn không cần phải quản lý nhiệt độ mục tiêu trực tiếp ở chế độ Eco. Khi nhà được đặt ở xa, temp đích không được hiển thị mà được đặt bên trong, dựa trên lựa chọn của người dùng. Khi bộ điều chỉnh nhiệt được đặt thành TẮT, thì không quan sát thấy nhiệt độ mục tiêu.

Nếu bạn hoàn toàn phải thay đổi nhiệt độ mục tiêu trực tiếp, hãy đảm bảo thực hiện thay đổi trong hai cuộc gọi riêng biệt:

  1. Thay đổi hvac_mode thành bất kỳ giá trị nào khác ngoại trừ eco
  2. Sửa đổi các giá trị dữ liệu target_temperature thích hợp

Bắt đầu với quyền đọc nhiệt và đọc / ghi v6, bạn có thể truy cập previous_hvac_mode thông qua API để hỗ trợ chuyển đổi chế độ HVAC. previous_hvac_mode được sử dụng để lưu trữ các hvac_mode của thiết bị trước khi nó chuyển sang "sinh thái".

Ví dụ: nếu Bộ điều nhiệt Nest đang sử dụng Nhiệt độ sinh thái ( hvac_mode = "eco" ), thì previous_hvac_mode hvac_mode = "eco" có sẵn và bạn muốn sản phẩm của mình đặt target_temperature Nhiệt độ, previous_hvac_mode tiên bạn phải:

  1. lấy previous_hvac_mode
  2. bộ hvac_mode đến previous_hvac_mode giá trị
  3. xác nhận hvac_mode không còn được đặt thành "sinh thái"

Sau các bước này, đặt nhiệt độ mục tiêu là phù hợp.

Tùy thuộc vào hvac_mode giá trị, đây là cách previous_hvac_mode thay đổi:

Khi trạng thái hvac_mode là ... Sau đó, previous_hvac_mode có thể ...
eco heat , cool , heat-cool hoặc off
heat , cool , heat-cool hoặc off trống / trống

Nhiệt độ mục tiêu

Nhiệt độ mục tiêu là giá trị quan trọng nhất đối với hệ thống HVAC - đó là nhiệt độ mong muốn, thường được đặt bởi người dùng. Hầu hết các hành động và quyết định đều dựa trên nó. Từ API, Hoạt động với các sản phẩm Nest có thể ghi nhiệt độ mục tiêu như một phần của quy trình lớn hơn.

Luôn có một nhiệt độ mục tiêu được đặt khi hệ thống được bật.

  • Khi nhiệt hoặc chế độ mát ( heat , cool ) được chọn, một đơn target_temperature là bộ
  • Khi nhiệt • Chế độ mát ( heat-cool ) được chọn, hai target_temperature giá trị này được thiết lập, biểu thị một phạm vi mục tiêu, một cao một để làm mát và một phía dưới để sưởi ấm
  • Khi chế độ Eco ( eco ) được chọn, phạm vi nhiệt độ mục tiêu được đặt bên trong

Ngoài ra còn có nhiệt độ an toàn là một điểm dừng để ngăn chặn đường ống đóng băng hoặc nhiệt độ quá cao trong nhà.

Khi Bộ điều chỉnh TẮT, không có nhiệt độ mục tiêu nào được đặt.

Thời gian đến nhiệt độ

Thời gian đến Nhiệt độ cho phép bạn truy cập vào các giá trị dữ liệu này cho hệ thống HVAC:

  • time_to_target - Thời gian, tính bằng phút, sẽ mất thời gian để cấu trúc đạt đến nhiệt độ mục tiêu
  • time_to_target_training
    • Tình trạng đào tạo
    • Khi Bộ điều nhiệt tìm hiểu cách hệ thống HVAC phản ứng, nó sẽ điều chỉnh ước tính để đạt được nhiệt độ mục tiêu
    • Khi Bộ điều chỉnh nhiệt chắc chắn hợp lý về ước tính thời gian để đạt đến nhiệt độ mục tiêu, trạng thái sẽ thay đổi từ training sang ready

Nhiệt độ môi trường

Nhiệt độ đo gần nhiệt. Hiển thị giá trị tương ứng với thang đo nhiệt độ ưa thích của người dùng.

Thang đo nhiệt độ

Các biến nhiệt độ môi trường và mục tiêu được tổ chức theo thang độ C hoặc Fahrenheit. Thuộc tính temperature_scale độ_scale sẽ là "F" hoặc "C", tùy thuộc vào sở thích của người dùng. Thuộc tính này được đặt bởi mỗi bộ điều chỉnh nhiệt, vì vậy có thể trong một cấu trúc duy nhất, người dùng có thể có hai bộ điều nhiệt, một trong mỗi thang đo nhiệt độ. Giữ cho sở thích của người dùng trong tâm trí khi hiển thị các giá trị nhiệt độ.

Bắt đầu với phiên bản quyền v5 , bạn có thể thay đổi thang đo nhiệt độ thông qua API.

Các trường Nhiệt độ Mục tiêu và Nhiệt độ Môi trường có các biến thể _f_c để phù hợp với làm tròn nhất quán khi hiển thị nhiệt độ.

Hiển thị nhiệt độ

Bình giữ nhiệt

Khi bạn hiển thị thông tin nhiệt độ mục tiêu, hãy xem xét ba giá trị phụ thuộc sau: temperature_scale hvac_mode , hvac_mode và trạng thái away của cấu trúc.

Nhiều giá trị dữ liệu phối hợp với nhau để xác định những gì hiển thị trên màn hình Nest Thermostat và cách thức hoạt động của nó.

  • Khi hvac_mode được đặt ở chế heat-cool , Bộ điều nhiệt Nest hiển thị các điểm đặt thấp và cao được phân tách bằng ký tự dấu đầu dòng (•), nếu không, Bộ điều nhiệt Nest chỉ hiển thị nhiệt độ mục tiêu
  • Khi hvac_mode được đặt thành off , từ "TẮT" được hiển thị trên Bộ điều nhiệt Nest, theo ngôn ngữ ưa thích của người dùng
  • Khi hvac_mode được đặt thành eco , từ "ECO" được hiển thị trên Bộ điều nhiệt Nest, theo ngôn ngữ ưa thích của người dùng

Định dạng nhiệt độ hiển thị cũng phụ thuộc vào thang nhiệt độ đã chọn (F / C).

Nhiệt độ Fahrenheit được hiển thị dưới dạng số nguyên:

  • Nhiệt độ mục tiêu: 55 ° F
  • Nhiệt độ môi trường: 62 ° F

Nhiệt độ Celsius được hiển thị dưới dạng toàn bộ hoặc một giá trị thập phân, với chữ số cuối cùng được đặt thành ".5":

  • Nhiệt độ mục tiêu: 12 ° C
  • Nhiệt độ môi trường: 16,5 ° C

Lá cây

Khi biểu tượng chiếc lá hiển thị ở mặt trước của bộ điều chỉnh nhiệt, bộ điều chỉnh nhiệt được đặt ở nhiệt độ tiết kiệm năng lượng và has_leaf = true .

Lá cây

Khóa nhiệt độ

Người dùng có thể khóa Bộ điều nhiệt Nest để chỉ có thể điều chỉnh trong phạm vi nhiệt độ giới hạn. Bắt đầu với phiên bản quyền v5 , bạn có thể xem liệu Khóa nhiệt độ có được bật hay không bằng cách kiểm tra is_locked và nếu có, hãy đọc các giá trị tối thiểu / tối đa của Khóa nhiệt độ thông qua API:

Nhiệt độ khóa phải được chỉ định theo cặp, dưới dạng giá trị tối đa và tối thiểu và chỉ có thể được ghi nếu is_locked = true .

Độ ẩm

Độ ẩm, ở định dạng phần trăm (%), được đo tại thiết bị, được làm tròn đến 5% gần nhất.

Kem chống nắng

Công nghệ chống nắng tự động điều chỉnh nhiệt độ trên Bộ điều nhiệt Nest để bù cho các gai nhiệt xảy ra từ ánh sáng mặt trời trực tiếp trên thiết bị.

Các giá trị dữ liệu này sẽ cho bạn biết nếu Sunblock được bật và / hoặc chủ động điều chỉnh nhiệt độ.

  • sunlight_correction_enabled
    • boolean, trả về true nếu Sunblock được bật
  • sunlight_correction_active - boolean, trả về giá trị true nếu Sunblock hoạt động, biểu thị rằng Bộ điều chỉnh nhiệt được đặt dưới ánh sáng mặt trời trực tiếp

Quạt

Nhiều hệ thống HVAC có quạt tích hợp, có nghĩa là quạt không thể được điều khiển độc lập . Không có chế độ tắt cho quạt tích hợp, vì quạt cần chạy khi bật hoặc làm mát.

Tuy nhiên, nếu hệ thống HVAC tương thích, quạt có thể được bật rõ ràng thông qua API, để giúp người sử dụng thoải mái hơn mà không cần tham gia hệ thống HVAC đầy đủ.

Nếu quạt có thể được điều khiển độc lập, has_fan sẽ được đặt thành true và các giá trị dữ liệu sau có thể được đặt bằng quyền đọc / ghi của Bộ điều chỉnh nhiệt:

  • fan_timer_active - boolean, trả về true nếu bộ đếm thời gian của quạt được kích hoạt trong khoảng thời gian được lập trình sẵn
  • fan_timer_duration - int, khoảng thời gian (tính bằng phút) mà quạt được đặt để chạy

Sử dụng các giá trị này cùng nhau để khởi tạo bộ hẹn giờ quạt (bật quạt) trong một khoảng thời gian cụ thể. Bạn cũng có thể sử dụng giá trị fan_timer_timeout để xác định dấu thời gian khi quạt được đặt để ngừng chạy.

Lưu ý rằng bạn luôn có thể thay đổi fan_timer_duration - nó độc lập với hvac_mode hoặc trạng thái chiếm chỗ cấu trúc (đi).

Bạn có thể mong đợi những phản hồi này thành công hay thất bại:

  • 200 OK
  • 400 yêu cầu xấu

Nếu lệnh bật quạt không tạo ra kết quả như mong đợi, thì đó có thể là do quạt đã được kích hoạt (do người dùng thủ công hoặc theo lịch hoặc do chu trình làm nóng / làm mát HVAC).

Giới hạn tỷ lệ

Chúng tôi áp dụng giới hạn tốc độ để bảo vệ chống lại các cuộc gọi quá mức đến các thiết bị, điều này có thể ảnh hưởng đến hiệu suất của hệ thống hoặc pin. Trong điều kiện bình thường, các thiết bị Nest sạc pin từ dây điện áp thấp trên hệ thống sưởi và làm mát. Nhưng nếu các cuộc gọi quá mức được thực hiện trong một khoảng thời gian ngắn và mức pin yếu, Bộ điều nhiệt Nest sẽ tắt Wi-Fi để tiết kiệm năng lượng.

Trong thực tế, điều này có nghĩa là chúng tôi giới hạn số lượng cuộc gọi có thể được thực hiện cho một thiết bị trong một khoảng thời gian xác định. Nếu bạn vượt quá giới hạn này, bạn sẽ nhận được phản hồi lỗi và thông báo cho biết bạn đã vượt quá giới hạn của mình.

Để biết thêm thông tin, xem Giới hạn tốc độ dữ liệu .

Hạn chế về năng lượng

Trong một số trường hợp, Bộ điều nhiệt có thể không có đủ năng lượng pin để phục vụ yêu cầu sửa đổi. Trong trường hợp này, bạn sẽ nhận được phản hồi lỗi và thông báo cho biết thiết bị không thể phục vụ yêu cầu tại thời điểm này. Nếu điều này xảy ra, hãy cho pin một thời gian để sạc lại trước khi thử lại.

Tìm hiểu thêm về các điều kiện pin yếu trong Bộ điều nhiệt Nest Learning .

Thông báo lỗi

Một số tiểu bang làm cho một số chức năng không có sẵn. Những quy tắc này được đặt ra để bảo tồn năng lượng hoặc cung cấp sự thoải mái và an toàn.

Để biết thông tin về lỗi gọi API có nghĩa là gì và cách xử lý chúng, hãy xem Thông báo lỗi .

Sự cố kết nối / kết nối Wi-Fi

Nếu một thiết bị ngoại tuyến, sửa đổi không được phép. Bạn có thể quan sát trạng thái trực tuyến của thiết bị trong mô hình dữ liệu và hiển thị UI phù hợp.