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.

Bộ điều nhiệt

Kiểm soát nhiệt

Các Nest Learning Thermostat ™ là một thiết bị kết nối Internet đó là trực quan và dễ sử dụng, không ngừng tìm hiểu về thói quen sử dụng trong nhà để thoải mái tối ưu hóa 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 của mình ở bất cứ đâu có kết nối Internet.

Việc hỗ trợ các tính năng này đòi hỏi một hệ thống điều khiển phức tạp vượt lên trên 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ư sớm On , Đúng Radiant , Airwave ™ ) đòi hỏi phải có một số lượng đáng kể sức mạnh tính toán so với hầu hết các bộ điều nhiệt. Nest Thermostat có sức mạnh cần thiết để cung cấp các tính năng nâng cao này.

Các 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 phá vỡ thuật toán Nest hay ngạc nhiên cho người dùng những hành vi bất ngờ. Chúng cung cấp quyền truy cập vào dữ liệu sau cho Nest Thermostat:

  • Tên cấu trúc và thiết bị "tên ở đâu" (vị trí trong nhà)
  • Nhãn bộ điều 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)
  • Nhiệt độ Khóa tình trạng, và nếu khóa, min / giá trị nhiệt độ tối đa khóa
  • Thời lượng hẹn giờ của quạt và chế độ HVAC
  • Độ ẩm
  • Sunblock

Quyền điều nhiệt

Để truy cập đọc cho tất cả các giá trị dữ liệu API Thermostat, chọn nhiệt đọc phép khách hàng của bạn.

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

  • Nhiệt độ mục tiêu
  • Chế độ HVAC
  • Bộ hẹn giờ của người hâm mộ

Bắt đầu với Thermostat đọc / ghi v5, bạn cũng có thể cập nhật những điều sau:

  • Thang đo nhiệt độ
  • Nhãn bộ điều nhiệt

Số nhận dạng bộ điều nhiệt

Thiết bị

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ị qua đường dẫn thiết bị. Vì vậy, một ID nhiệt của "peyiJNo..." có nghĩa là bạn có thể tải các mô hình thiết bị điều chỉnh nhiệt ở devices/thermostats/peyiJNo... 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. Ngắn hơn name thuộc tính được hiển thị trong giao diện người dùng nhãn, trong khi name_long được sử dụng trong văn bản dạng dài.

name

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

TênTên dài

name_long

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

Đặt tên dài trong tin nhắn

Nhãn

Tên (nhãn) ở đâu
Tên (nhãn) ở đâu

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

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

Ở đâu

where_id

  • Một độc đáo, định danh Nest tạo đại diện cho name
  • where_id là read-only, và được tạo ra tự động trong các cuộc gọi để tạo ra một phong tục nơi name

Tìm hiểu thêm về nơi tên cho nhiệt Nest ,Nest Bảo vệNest Cams .

where_name

Khi bạn chọn một trong các điều khoản điều chỉnh nhiệt , bạn có thể truy cập vào thiết bị where_name từ đối tượng thiết bị ( 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 chỉ định khác.

Giá trị dữ liệu Sự miêu tả
locale Ngôn ngữ và mã quốc gia được chỉ định 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 lần kết nối thành công gần đây nhất với dịch vụ Nest
is_online Trạng thái trực tuyến. Đây được xác định bởi Nest sử dụng last_connection thời gian và một cửa sổ kết nối lại dự kiến đó là thiết bị cụ thể.

Các tính năng của bộ điều nhiệt

Chế độ điều nhiệt

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

  • Khi nhiệt hoặc chế độ mát ( heat , cool ) được chọn, điều chỉnh nhiệt điều chỉnh quê hương của nhiệt độ mục tiêu.
  • Khi mát nhiệt • Chế độ ( heat-cool ) được chọn, điều chỉnh nhiệt sẽ giữ cho ngôi nhà thoải mái, trong một phạm vi nhiệt độ ưa thích.
  • Khi Eco Nhiệt độ (sinh thái) được chọn, điều chỉnh 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 sử dụng năng lượng. Bộ điều nhiệt ở 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 Vắng. Khi không có chuyển động nào được phát hiện trong nhà, cấu trúc sẽ thay đổi từ Nhà sang Nơi vắng và Bộ điều nhiệt trong nhà sẽ tự động bật Nhiệt độ sinh thái.

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

Tùy thuộc vào giá trị của hvac_mode , chỉ có một số giá trị dữ liệu nhiệt độ có thể được truy cập 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ố tình huống, có những quy tắc đặc biệt xung quanh thay đổi hvac_mode :

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

Nhiệt độ sinh thái

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

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

Chuyển đổi giữa chế độ sinh thái và không 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ế độ Tiết kiệm. Khi ngôi nhà được đặt thành đi vắng, nhiệt độ mục tiêu không được hiển thị, nhưng được đặt bên trong, dựa trên lựa chọn của người dùng. Khi bộ điều 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 lần gọi riêng biệt:

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

Bắt đầu với nhiệt đọc và đọc / ghi cho phép v6, bạn có thể truy cập vào previous_hvac_mode thông qua các API để hỗ trợ quá trình 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 nhiệt Nest đang sử dụng Eco Nhiệt độ ( hvac_mode = "eco" ), previous_hvac_mode có sẵn, và bạn muốn sản phẩm của bạn để thiết lập target_temperature , sau đó bạn phải đầu tiên:

  1. get 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 thiết lập để "sinh thái"

Sau các bước này, hãy đặt nhiệt độ mục tiêu thích hợp.

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

Khi hvac_mode nhà nước là ... Sau đó, previous_hvac_mode có thể ...
eco heat , cool , heat-cool hoặc off
heat , cool , heat-cool hoặc off trống rỗ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 do người dùng đặt. Hầu hết các hành động và quyết định đều dựa trên nó. Từ API, các sản phẩm Hoạt động với 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 đang 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 là trong nội bộ thiết

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

Khi Bộ điều nhiệt ở trạng thái TẮT, không có nhiệt độ mục tiêu nào được đặt.

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

Time-to-Nhiệt độ cung cấp cho bạn truy cập vào các giá trị dữ liệu cho hệ thống HVAC:

  • time_to_target - Hiện, chỉ trong vài phút, mà nó sẽ đưa cho cấu trúc để đạt được nhiệt độ mục tiêu
  • time_to_target_training
    • Tình trạng đào tạo
    • Khi Bộ điều nhiệt học 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 nhiệt là hợp lý chắc chắn về thời gian ước tính để đạt được nhiệt độ mục tiêu, trạng thái sẽ chuyển từ training để ready

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

Nhiệt độ đo gần bộ điều nhiệt. Hiển thị giá trị tương ứng với thang 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 sắp xếp theo thang độ C hoặc độ F. Các temperature_scale thuộc tính sẽ là một trong hai "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 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 bộ ở mỗi thang nhiệt độ. Giữ sở thích người dùng trong tâm trí khi hiển thị các giá trị nhiệt độ.

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

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

Hiển thị nhiệt độ

Bộ điều nhiệt

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

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

  • Khi hvac_mode được thiết lập để heat-cool , ổn nhiệt Nest hiển thị mức thấp nhất và điểm đặt cao ngăn cách bởi một nhân vật đạn (•), nếu không hiển thị nhiệt Nest chỉ nhiệt độ mục tiêu
  • Khi hvac_mode được thiết lập để off , từ "OFF" được hiển thị trên Nest Thermostat, trong ngôn ngữ ưa thích của người dùng
  • Khi hvac_mode được thiết lập để eco , từ "ECO" được hiển thị trên Nest Thermostat, trong 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 độ độ C được hiển thị dưới dạng số nguyên hoặc 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 lá được hiển thị trên mặt trước của nhiệt, nhiệt được thiết lập để mộ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 Nest Thermostat để nó chỉ có thể được điều chỉnh trong một phạm vi nhiệt độ giới hạn. Bắt đầu với quyền phiên bản v5 , bạn có thể thấy nếu nhiệt độ Khóa được kích hoạt bằng cách kiểm tra is_locked , và nếu nó là, đọc Nhiệt độ Khóa min / giá trị tối đa thông qua các API:

Nhiệt độ Khóa phải được xác định theo cặp, như các giá trị tối đa và tối thiểu, và chỉ có thể được viết 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.

Sunblock

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

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

Quạt

Nhiều hệ thống HVAC có tích hợp quạt, có nghĩa là các fan hâm mộ không thể được kiểm soát một cách độc lập . Không có chế độ tắt cho các quạt tích hợp, vì quạt cần chạy khi hệ thống sưởi hoặc làm mát được bậ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, để làm cho người ngồi trong xe thoải mái hơn mà không cần tham gia vào hệ thống HVAC đầy đủ.

Nếu người hâm mộ có thể được kiểm soát một cách độc lập, has_fan sẽ được thiết lập để true , và các giá trị dữ liệu sau đây có thể được thiết lập với nhiệt đọc / ghi cho phép:

  • fan_timer_active - boolean, trả về true nếu quạt hẹn giờ là tham gia trong thời gian lập trình trước
  • fan_timer_duration - int, khoảng thời gian (tính theo phút) mà quạt được thiết lập để chạy

Sử dụng các giá trị này cùng nhau để bắt đầu 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 fan_timer_timeout giá trị để xác định dấu thời gian khi các fan hâm mộ được thiết lập để ngừng chạy.

Lưu ý rằng bạn luôn có thể thay đổi fan_timer_duration - đó là độc lập với hvac_mode hoặc tiểu bang cấu trúc công suất (sân khách).

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

  • 200 được
  • 400 Yêu cầu Không hợp lệ

Nếu lệnh bật quạt không mang lại kết quả như mong đợi, thì có thể là do quạt đã được khởi động (do người dùng thủ công hoặc theo lịch trình hoặc do chu trình nhiệt / 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ệ khỏi các cuộc gọi quá nhiều đến 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, 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 thực hiện quá nhiều cuộc gọi trong một khoảng thời gian ngắn và mức pin yếu, Nest Thermostat sẽ tắt Wi-Fi để tiết kiệm năng lượng.

Trên 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 đến 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 Data Rate .

Ràng buộc quyền lực

Trong một số trường hợp, Bộ điều nhiệt có thể không có đủ pin để đáp ứng 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 vào lúc 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ề điều kiện pin thấp trong Nest Learning Thermostat .

Thông báo lỗi

Một số trạng thái làm cho một số chức năng không khả dụng. Các quy tắc này được đưa ra để tiết kiệm năng lượng hoặc cung cấp sự thoải mái và an toàn.

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

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

Nếu thiết bị ngoại tuyến, không được phép sửa đổi. 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ị giao diện người dùng một cách thích hợp.