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

ترموستات

کنترل ترموستات

ترموستات آموزشی Nest ™ یک دستگاه متصل به اینترنت است که بصری و آسان برای استفاده، به طور مداوم یادگیری در مورد الگوهای مصرف در خانه به راحتی بهینه سازی و صرفه جویی انرژی است. کاربران می توانند در هر مکانی که به اتصال اینترنت دسترسی دارند ، گرمایش و سرمایش را کنترل کنند.

پشتیبانی از این ویژگی ها به یک سیستم کنترل پیچیده نیاز دارد که فراتر از برنامه های ساده مبتنی بر تنظیم باشد. آشیانه فراهم می کند طیف گسترده ای از الگوریتم (مانند اوایل ، درست تابشی ، Airwave به ™ ) که نیاز به مقدار قابل توجهی از قدرت محاسباتی در مقایسه با اکثر ترموستات. ترموستات Nest قدرت لازم برای ارائه این ویژگی های پیشرفته را دارد.

API آشیانه طراحی شده است که اجازه می دهد محصولات برای کنترل سیستم تهویه مطبوع بدون اخلال در الگوریتم های آشیانه و یا تعجب آور که کاربر با رفتارهای غیر منتظره. آنها دسترسی به داده های زیر را برای ترموستات Nest فراهم می کنند:

  • نام ساختار و دستگاه "Where name" (مکان در خانه)
  • برچسب ترموستات سفارشی
  • وضعیت آنلاین و آخرین اطلاعات اتصال
  • دمای فعلی و هدف
  • حالت دما
  • دمای محیط زیست
  • زمان به دما
  • مقیاس دما (تنظیم F / C)
  • قفل دما وضعیت، و اگر قفل شده است، دقیقه / ارزش درجه حرارت قفل شده حداکثر
  • مدت زمان تایمر فن و حالت HVAC
  • رطوبت
  • ضد آفتاب

مجوزهای ترموستات

برای دسترسی خواندن به همه ارزش داده های API ترموستات ها ترموستات به عنوان خوانده شده اجازه برای مشتری خود را.

برای دسترسی خواندن به همه ارزش داده های API ترموستات و دسترسی نوشتن اضافی برای انتخاب مقادیر، انتخاب ترموستات خواندن / نوشتن اجازه برای مشتری خود را. این سطح اجازه به شما امکان می دهد موارد زیر را به روز کنید:

  • دمای هدف
  • حالت HVAC
  • تایمرهای فن

با شروع خواندن / نوشتن ترموستات v5 ، می توانید موارد زیر را نیز به روز کنید:

  • مقیاس دما
  • برچسب ترموستات

شناسه های ترموستات

دستگاه

دستگاه های Nest بر اساس نوع به عنوان آرایه ای از شناسه ها لیست می شوند ، که می توانند برای شناسایی منحصر به فرد دستگاه از طریق مسیر دستگاه استفاده شوند. بنابراین یک ID ترموستات از "peyiJNo..." بدان معنی است که شما می توانید مدل دستگاه ترموستات در بار devices/thermostats/peyiJNo... از طریق API.

وقتی دستگاه به چندین محصول متصل است ، هر توسعه دهنده شناسه متفاوتی را برای آن دستگاه می بیند. برای دستگاهی که چندین محصول از یک توسعه دهنده نصب کرده است ، توسعه دهنده شناسه مشابهی را می بیند.

نام

دو ویژگی نام ارائه شده است. کوتاه تر name مشخصه در برچسب رابط کاربر نمایش داده شده، در حالی که name_long در متن فرم بلند استفاده می شود.

name

در این مثال، name "راهرو" یا "راهرو (غرب)" است.

نامنام طولانی است

name_long

در این مثال، name_long است "اداری (طبقه بالا)".

نام طولانی را در یک پیام ارسال کنید

برچسب

نام (برچسب)
نام (برچسب)

با آغاز مجوز نسخه V5 ، شما می توانید سفارشی ترموستات برچسب از طریق API اضافه کنید. در برنامه Nest ، برچسب بعد از نام مکان در پرانتز نشان داده می شود.

با آغاز مجوز نسخه V6 ، شما همچنین می توانید برچسب ترموستات به عنوان خوانده شده.

جایی که

where_id

  • منحصر به فرد، شناسه آشیانه تولید شده است که نشان دهنده name
  • where_id فقط خواندنی است، و به طور خودکار در پاسخ ایجاد شده است برای ایجاد یک سفارشی که در آن name

اطلاعات بیشتر در مورد که در آن نام برای دما آشیانه ،آشیانه محافظت و آشیانه کم .

where_name

هنگامی که یکی از را انتخاب کنید مجوز ترموستات ، شما می توانید دستگاه دسترسی داشته باشید where_name از جسم دستگاه ( devices/thermostats ).

فراداده دیگر

همه مقادیر داده فقط خواندنی هستند ، مگر اینکه خلاف آن مشخص شده باشد.

مقدار داده شرح
locale زبان و کد کشور اختصاص داده شده به این دستگاه
software_version رشته ای که نشان دهنده سیستم عامل فعلی نصب شده روی دستگاه است
structure_id رشته ای که منحصر به فرد این ساختار را نشان می دهد. این ساختاری است که دستگاه با آن جفت می شود
last_connection مهر زمان آخرین اتصال موفقیت آمیز به سرویس Nest
is_online وضعیت آنلاین این است که با استفاده از آشیانه تعیین last_connection زمان و پنجره اتصال مجدد انتظار می رود این است که دستگاه خاص.

ویژگی های ترموستات

حالت های ترموستات

سیستم های تهویه مطبوع چهار "در" ایالت ( heat ، cool ، heat-cool ، eco ) و یک "خاموش" دولت ( off ). ما با استفاده از این کشورها به مدیریت آسایش و صرفه جویی انرژی از طریق hvac_mode ارزش داده و درجه حرارت.

  • هنگامی که حرارت و یا حالت سرد ( heat ، cool ) انتخاب شده است، ترموستات خانه را به دمای هدف تنظیم می کند.
  • هنگامی که حرارت • حالت داغ ( heat-cool ) انتخاب شده است، ترموستات خانه را حفظ خواهد کرد راحت، به اندازه درجه حرارت ارجح است.
  • هنگامی که درجه حرارت محیط زیست (ECO) انتخاب شده است، ترموستات خواهد الگوریتم صرفه جویی در انرژی اعمال می شود به نگه داشتن خانه راحت و کاهش مصرف انرژی. ترموستات ها در این حالت ECO را نمایش می دهند.

سازه ها دارای دو حالت مربوط به حضور هستند: خانه یا دور. وقتی هیچ حرکتی در خانه احساس نشود ، ساختار از Home به Away تغییر می کند و ترموستات در خانه به طور خودکار دمای Eco را فعال می کند.

چگونه hvac_mode ارزش ها و درجه حرارت با هم کار کنند

بسته به ارزش hvac_mode ، فقط برخی از مقادیر داده درجه حرارت می تواند در API قابل دسترسی است:

حالت HVAC مقادیر داده های دما که می توانید به آنها دسترسی پیدا کنید
heat و یا cool target_temperature_f یا target_temperature_c
heat-cool target_temperature_low_f و target_temperature_high_f
یا
target_temperature_low_c و target_temperature_high_c
eco eco_temperature_low_f و eco_temperature_high_f
یا
eco_temperature_low_c و eco_temperature_high_c
off هیچ یک

در برخی از حالات، مقررات ویژه ای در اطراف تغییر وجود دارد hvac_mode :

سناریو می توانید hvac_mode تغییر کند؟
قفل دما فعال است آره
سیستم خاموش شدن اضطراری فعال است نه
حرارت اضطراری فعال است نه
can_cool یا can_heat ارزش است false نه

دمای محیط زیست

دمای محیط زیست به کاربر امکان صرفه جویی در انرژی را می دهد ، چه در خانه باشد چه نباشد. در نظر بگیرید تغییر hvac_mode به eco در هنگام پیاده سازی رفتارهای صرفه جویی در انرژی در محصول خود را.

سازگار با محیط زیست نقاط پایانی دما در API آشیانه شروع با ترموستات در دسترس هستند خواندن و خواندن / نوشتن و ویرایش V6.

جابجایی بین حالت eco و غیر eco

محصول شما نیازی به مدیریت دمای هدف مستقیماً در حالت Eco ندارد. هنگامی که خانه به خارج از منزل تنظیم می شود ، دمای هدف نمایش داده نمی شود ، بلکه براساس انتخاب کاربر تنظیم می شود. وقتی ترموستات روی حالت خاموش تنظیم شود ، هیچ دمای هدف مشاهده نمی شود.

اگر کاملاً باید دمای هدف را مستقیماً تغییر دهید ، حتماً این تغییر را در دو تماس جداگانه انجام دهید:

  1. تغییر hvac_mode به هر مقدار دیگر به جز eco
  2. اصلاح مناسب target_temperature مقادیر داده

با آغاز ترموستات خواندن و خواندن / نوشتن و ویرایش V6، شما می توانید دسترسی داشته باشید previous_hvac_mode از طریق API برای کمک به تهویه مطبوع انتقال حالت. previous_hvac_mode است مورد استفاده برای ذخیره hvac_mode از دستگاه قبل از آن به "اکو" انتقال یافتند.

به عنوان مثال، اگر ترموستات آشیانه است با استفاده از درجه حرارت محیط زیست ( hvac_mode = "eco"previous_hvac_mode در دسترس است، و شما می خواهید محصول خود را به مجموعه ای target_temperature ، سپس شما باید اول:

  1. دریافت previous_hvac_mode
  2. مجموعه ای hvac_mode به previous_hvac_mode ارزش
  3. تایید hvac_mode دیگر به مجموعه "اکو"

بعد از این مراحل ، دمای هدف را به میزان مناسب تنظیم کنید.

بسته به hvac_mode ارزش، این است چگونه previous_hvac_mode تغییر:

هنگامی که hvac_mode دولت است ... سپس، previous_hvac_mode می تواند ...
eco heat ، cool ، heat-cool و یا off
heat ، cool ، heat-cool و یا off خالی / خالی

دمای هدف

دمای هدف مهمترین مقدار برای سیستم HVAC است - دمای مطلوب است ، که معمولاً توسط کاربر تنظیم می شود. اکثر اقدامات و تصمیمات براساس آن است. از طریق API ، محصولات با Nest می توانند دمای هدف را به عنوان بخشی از یک فرآیند بزرگتر بنویسند.

همیشه هنگام روشن بودن سیستم یک دمای هدف تعیین می شود.

  • هنگامی که حرارت و یا حالت سرد ( heat ، cool ) انتخاب شده است، یک target_temperature مجموعه ای است
  • هنگامی که حرارت • حالت داغ ( heat-cool ) انتخاب شده است، دو target_temperature ارزش ها تعیین می کنند، دلالت محدوده هدف، یک بالاتر برای خنک کننده و یک پایین تر برای گرم
  • هنگامی که حالت سازگار با محیط زیست ( eco ) انتخاب شده است، محدوده دمای هدف داخلی مجموعه

همچنین دمای ایمنی وجود دارد که برای جلوگیری از یخ زدگی لوله ها یا دمای بیش از حد زیاد در خانه پشت صحنه است.

وقتی ترموستات خاموش است ، هیچ دمای هدف تعیین نمی شود.

زمان به دما

زمان به دما به شما می دهد دسترسی به این مقادیر داده برای سیستم تهویه مطبوع:

  • time_to_target - ساعت، در دقیقه، که آن را برای ساختار را برای رسیدن به درجه حرارت مورد نظر
  • time_to_target_training
    • وضعیت آموزش
    • همانطور که ترموستات از نحوه واکنش سیستم HVAC مطلع می شود ، تخمین را برای رسیدن به دمای هدف تنظیم می کند
    • وقتی ترموستات منطقی مطمئن از تخمین زمان است برای رسیدن به دمای مورد نظر، وضعیت تغییر خواهد کرد از training به ready

دمای محیط

دما در نزدیکی ترموستات اندازه گیری می شود. مقداری را نشان می دهد که با مقیاس دمایی مورد نظر کاربر مطابقت دارد.

مقیاس دما

متغیرهای دمای محیط و هدف توسط مقیاس سانتیگراد یا فارنهایت سازماندهی می شوند. temperature_scale ویژگی خواهد بود یا "F" یا "C"، بسته به اولویت کاربر. این ویژگی توسط هر ترموستات تنظیم می شود ، بنابراین ممکن است که در یک ساختار واحد کاربر دارای دو ترموستات باشد ، یکی در هر مقیاس دما. نگه دارید تنظیمات کاربر در ذهن در هنگام نمایش مقادیر دمای.

با آغاز مجوز نسخه V5 ، شما می توانید مقیاس درجه حرارت از طریق API را تغییر دهید.

زمینه دما هدف و محیط دارند _f و _c انواع به جای گرد سازگار هنگام نمایش درجه حرارت.

نمایش دما

ترموستات

هنگامی که شما نمایش هدف اطلاعات دما، نظر گرفتن این سه ارزش های وابسته: temperature_scale ، hvac_mode ، و ساختار را away دولت است.

بسیاری از مقادیر داده با هم کار می کنند تا آنچه را در صفحه نمایش ترموستات Nest نشان داده شده و نحوه رفتار آن را تعیین کنند.

  • هنگامی که hvac_mode تنظیم شده است heat-cool است، ترموستات آشیانه نمایش کم و setpoints بالا از هم جدا شده یک کاراکتر گلوله (•)، در غیر این صورت نمایش ترموستات آشیانه فقط دمای هدف
  • هنگامی که hvac_mode تنظیم شده است off ، کلمه "خاموش" است ترموستات آشیانه نمایش داده شده، در زبان مورد نظر کاربر
  • هنگامی که hvac_mode تنظیم شده است eco ، کلمه "اکو" بر ترموستات آشیانه نمایش داده شده، در زبان مورد نظر کاربر

قالب دمای نمایشگر نیز به مقیاس درجه حرارت انتخاب شده (F / C) بستگی دارد.

دمای فارنهایت به صورت اعداد کامل نمایش داده می شود:

  • دمای هدف: 55 درجه فارنهایت
  • دمای محیط: 62 درجه فارنهایت

دمای سانتیگراد به عنوان یک عدد کامل یا یک مقدار اعشاری نمایش داده می شود که آخرین رقم روی ".5" تنظیم شده است:

  • دمای هدف: 12 درجه سانتی گراد
  • دمای محیط: 16.5 درجه سانتی گراد

برگ

وقتی نماد برگ در حال نمایش است که در جلوی ترموستات، ترموستات به دمای صرفه جویی در انرژی، تعیین و has_leaf = true .

برگ

قفل دما

کاربران می توانند Nest Thermostat را قفل کنند تا فقط در محدوده دما محدود شود. با آغاز مجوز نسخه V5 ، شما می توانید ببینید که اگر قفل دما با چک کردن فعال is_locked ، و اگر از آن است، به عنوان خوانده شده قفل دما حداقل / حداکثر ارزش از طریق API:

دمای قفل باید به صورت جفت مشخص می شود، به عنوان حداقل و حداکثر ارزش ها، و تنها می تواند اگر نوشته شود is_locked = true .

رطوبت

رطوبت ، در قالب درصد (٪) ، اندازه گیری شده در دستگاه ، تا نزدیکترین 5٪ گرد می شود.

ضد آفتاب

ضد آفتاب به طور خودکار درجه حرارت بر روی ترموستات آشیانه را تنظیم می کنند برای خوشه گرمایی که از نور مستقیم خورشید در واحد رخ می دهد را جبران کند.

این مقادیر داده به شما اطلاع می دهد که آیا Sunblock فعال است و یا به طور فعال دما را اصلاح می کند.

  • sunlight_correction_enabled
    • بولی، برمی گرداند true اگر SUNBLOCK فعال است
  • sunlight_correction_active - بولی، بازده true اگر SUNBLOCK فعال است، نشان می دهد که ترموستات در نور مستقیم خورشید واقع

پنکه

بسیاری از سیستم های تهویه مطبوع طرفداران یکپارچه شده است، که بدان معنی است که فن می تواند به طور مستقل نمی تواند کنترل شود . برای فن های یکپارچه حالت خاموش وجود ندارد ، زیرا هنگام روشن شدن یا گرم شدن یا خنک کردن ، فن باید کار کند.

با این حال ، اگر سیستم HVAC سازگار باشد ، می توان فن را از طریق API روشن کرد تا بتواند بدون درگیر شدن سیستم کامل HVAC ، از راحتی بیشتری برخوردار شود.

اگر فن را می توان به طور مستقل کنترل، has_fan تنظیم خواهد شد true ، و ارزش داده های زیر را می توان با ترموستات تنظیم خواندن / مجوز نوشتن:

  • fan_timer_active - بولی، برمی گرداند true اگر تایمر فن برای مدت زمان از پیش برنامه ریزی شده درگیر
  • fan_timer_duration - هوشمند، طول زمان (در دقیقه) که فن قرار است به اجرا

برای شروع تایمر فن (روشن کردن فن) برای مدت زمان مشخصی از این مقادیر استفاده کنید. شما همچنین می توانید استفاده از fan_timer_timeout ارزش برای تعیین زمان از زمانی که فن قرار است به توقف در حال اجرا.

توجه داشته باشید که شما همیشه می توانید تغییر fan_timer_duration - آن را مستقل از است hvac_mode یا دولت ساختار اشغال (دور).

شما می توانید این موفقیت ها را در صورت موفقیت یا شکست انتظار داشته باشید:

  • 200 خوب
  • 400 درخواست بد

اگر دستور روشن کردن فن نتیجه مورد انتظار را ایجاد نمی کند ، ممکن است به این دلیل باشد که فن از قبل درگیر شده است (یا به صورت دستی توسط کاربر ، یا طبق یک برنامه یا به دلیل چرخه گرم / خنک کننده HVAC).

محدود کردن نرخ

ما برای محافظت در برابر تماس بیش از حد با دستگاه ها ، که ممکن است بر عملکرد سیستم یا باتری تأثیر بگذارد ، محدودیت نرخ را اعمال می کنیم. در شرایط عادی ، دستگاه های Nest باتری را از سیم های ولتاژ پایین سیستم گرمایش و سرمایش شارژ می کنند. اما اگر تماس های بیش از حد در مدت زمان کوتاهی برقرار شود و میزان باتری کم شود ، ترموستات Nest برای صرفه جویی در مصرف برق ، Wi-Fi را خاموش می کند.

در عمل ، این بدان معنی است که ما می توانیم تعداد تماس هایی را که می توان در یک بازه زمانی مشخص با دستگاه برقرار کرد ، محدود کنیم. اگر از این حد فراتر بروید ، پاسخ خطا و پیامی مبنی بر بیش از حد مجاز دریافت خواهید کرد.

برای اطلاعات بیشتر، نگاه کنید به محدودیت سرعت داده .

محدودیت های قدرت

در برخی موارد ممکن است ترموستات باتری کافی برای ارائه درخواست اصلاح را نداشته باشد. در این حالت شما پاسخ خطا و پیامی دریافت خواهید کرد که نشان می دهد دستگاه نمی تواند درخواست را در حال حاضر سرویس دهد. اگر این اتفاق افتاد ، قبل از تلاش مجدد ، به باتری کمی وقت بدهید تا دوباره شارژ شود.

اطلاعات بیشتر در مورد شرایط باتری کم در ترموستات آموزشی Nest .

پیغام خطا

برخی از ایالات عملکردهای خاصی را غیرقابل دسترس می کنند. این قوانین برای صرفه جویی در مصرف انرژی یا تأمین آسایش و ایمنی موجود است.

برای کسب اطلاعات در چه اشتباهات تماس API چیست و چگونه به آنها رسیدگی، و پیغام های خطا .

مشکل Wi-Fi / اتصال

اگر دستگاهی آفلاین باشد ، تغییرات مجاز نیستند. می توانید وضعیت آنلاین دستگاه را در مدل داده مشاهده کرده و UI را به طور مناسب نمایش دهید.