ترموستات

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

پشتیبانی از این ویژگی ها نیاز به یک سیستم کنترل پیچیده دارد که فراتر از برنامه های مبتنی بر تنظیم ساده است. Nest طیف گسترده ای از الگوریتم ها (مانند Early On ، True Radiant ، Airwave ™ ) را فراهم می کند که نسبت به بیشتر ترموستات ها به مقدار قابل توجهی از قدرت محاسباتی احتیاج دارند. Nest Thermostat از قدرت لازم برای تهیه این ویژگی های پیشرفته برخوردار است.

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

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

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

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

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

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

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

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

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

دستگاه

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

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

نام

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

`name`

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

`name_long`

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

برچسب

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

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

جایی که

`where_id`

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

در مورد نام های Nest Thermostats ، Nest Protects و Nest Cams اطلاعات بیشتری کسب کنید.

`where_name`

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

ابرداده دیگر

تمام مقادیر داده فقط خوانده می شوند ، مگر اینکه مواردی دیگر تعریف شده باشد.

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

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

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

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

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

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

چگونه `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`	نه

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

Eco Temperators به کاربر اجازه می دهد انرژی ، در خانه یا غیر خود ، در مصرف انرژی صرفه جویی کند. هنگام اجرای رفتارهای صرفه جویی در مصرف انرژی در محصول خود ، hvac_mode به eco تغییر دهید.

نقاط انتهایی درجه حرارت Eco در ابتدای API Nest با ترموستات مجوزهای خواندن و خواندن و نوشتن v6 در دسترس است.

جابجایی بین حالت های اکو و غیر اکو

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

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

hvac_mode به هر مقدار دیگری تغییر دهید ، بجز eco
مقادیر مناسب target_temperature را تغییر دهید

با شروع مجوزهای خواندن و خواندن / نوشتن v6 ترموستات ، می توانید از طریق API به previous_hvac_mode دسترسی پیدا کنید تا در انتقال حالت HVAC کمک کنید. previous_hvac_mode قبل از انتقال به "eco" برای ذخیره hvac_mode دستگاه استفاده می شود.

به عنوان مثال ، اگر Nest hvac_mode = "eco" از Eco Temperators ( hvac_mode = "eco" ) استفاده می کند ، previous_hvac_mode در دسترس است و شما می خواهید محصول شما target_temperature تنظیم target_temperature ، ابتدا باید:

دریافت حالت previous_hvac_mode
مجموعه ای hvac_mode به previous_hvac_mode ارزش
تأیید کنید hvac_mode دیگر روی "eco" تنظیم نشده است

بعد از این مراحل دمای مورد نظر را مطابق با شرایط تنظیم کنید.

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

وقتی حالت `hvac_mode` است ...	سپس، `previous_hvac_mode` می تواند ...
`eco`	`heat` ، `cool` ، `heat-cool` یا `off`
`heat` ، `cool` ، `heat-cool` یا `off`	خالی / خالی

دمای هدف

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

همیشه هنگام تنظیم سیستم دمای هدف تنظیم می شود.

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

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

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

زمان تا دما

زمان به دما به شما امکان دسترسی به این مقادیر داده را برای سیستم HVAC می دهد:

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

دمای محیط

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

مقیاس دما

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

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

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

نمایش دما

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

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

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

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

درجه فارنهایت به صورت تمام شماره ها نمایش داده می شود:

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

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

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

برگ

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

قفل دما

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

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

رطوبت

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

ضد آفتاب

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

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

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

پنکه

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

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

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

fan_timer_active - boolean ، اگر تایمر فن برای مدت زمان از پیش برنامه ریزی شده درگیر true ، true است
fan_timer_duration - int ، مدت زمانی که فن برای اجرای آن تنظیم شده است

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

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

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

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

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

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

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

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

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

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

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

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

پیغام خطا

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

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

مسئله اتصال Wi-Fi / اتصال

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