
ترموستات آموزشی Nest ™ یک دستگاه متصل به اینترنت است که بصری و آسان برای استفاده، به طور مداوم یادگیری در مورد الگوهای مصرف در خانه به راحتی بهینه سازی و صرفه جویی انرژی است. کاربران می توانند گرمایش و سرمایش خود را در هر جایی که به اتصال اینترنت دسترسی دارند کنترل کنند.
پشتیبانی از این ویژگی ها مستلزم یک سیستم کنترل پیچیده است که فراتر از برنامه های ساده مبتنی بر تعیین نقطه است. آشیانه فراهم می کند طیف گسترده ای از الگوریتم (مانند اوایل ، درست تابشی ، Airwave به ™ ) که نیاز به مقدار قابل توجهی از قدرت محاسباتی در مقایسه با اکثر ترموستات. Nest Thermostat قدرت لازم برای ارائه این ویژگی های پیشرفته را دارد.
API آشیانه طراحی شده است که اجازه می دهد محصولات برای کنترل سیستم تهویه مطبوع بدون اخلال در الگوریتم های آشیانه و یا تعجب آور که کاربر با رفتارهای غیر منتظره. آنها دسترسی به داده های زیر را برای Nest Thermostat فراهم می کنند:
- نام ساختار و دستگاه "where name" (مکان در خانه)
- برچسب ترموستات سفارشی
- وضعیت آنلاین و آخرین اطلاعات اتصال
- دمای فعلی و هدف
- حالت دما
- دمای محیط زیست
- زمان تا دما
- مقیاس دما (تنظیم F/C)
- قفل دما وضعیت، و اگر قفل شده است، دقیقه / ارزش درجه حرارت قفل شده حداکثر
- مدت زمان تایمر فن و حالت HVAC
- رطوبت
- ضد آفتاب
مجوزهای ترموستات
برای دسترسی خواندن به همه ارزش داده های API ترموستات ها ترموستات به عنوان خوانده شده اجازه برای مشتری خود را.
برای دسترسی خواندن به همه ارزش داده های API ترموستات و دسترسی نوشتن اضافی برای انتخاب مقادیر، انتخاب ترموستات خواندن / نوشتن اجازه برای مشتری خود را. این سطح مجوز به شما امکان می دهد موارد زیر را به روز کنید:
- دمای مورد نظر
- حالت HVAC
- تایمرهای فن
با شروع خواندن/نوشتن ترموستات نسخه 5، می توانید موارد زیر را نیز به روز کنید:
- مقیاس دما
- برچسب ترموستات
شناسه های ترموستات
دستگاه
دستگاههای Nest بر اساس نوع بهعنوان آرایهای از شناسهها فهرستبندی میشوند که میتوانند برای شناسایی منحصربهفرد دستگاه از طریق مسیر دستگاه استفاده شوند. بنابراین یک ID ترموستات از "peyiJNo..."
بدان معنی است که شما می توانید مدل دستگاه ترموستات در بار devices/thermostats/peyiJNo...
از طریق API.
هنگامی که یک دستگاه به چندین محصول متصل می شود، هر توسعه دهنده یک شناسه متفاوت برای آن دستگاه می بیند. برای دستگاهی که چندین محصول را از یک برنامهنویس نصب کرده است، توسعهدهنده همان شناسه را میبیند.
نام
دو ویژگی نام ارائه شده است. کوتاه تر name
مشخصه در برچسب رابط کاربر نمایش داده شده، در حالی که name_long
در متن فرم بلند استفاده می شود.
name
در این مثال، name
"راهرو" یا "راهرو (غرب)" است.


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

برچسب


با آغاز مجوز نسخه V5 ، شما می توانید سفارشی ترموستات برچسب از طریق API اضافه کنید. در برنامه Nest، برچسب در داخل پرانتز، پس از نام Where ظاهر میشود.
با آغاز مجوز نسخه 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 را نمایش می دهند.
ساختارها دو حالت مربوط به حضور دارند: خانه یا دور. وقتی هیچ حرکتی در خانه احساس نشود، ساختار از خانه به دور تغییر میکند و ترموستاتهای خانه بهطور خودکار دمای اکو را فعال میکنند.
چگونه 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 دمای هدف را مدیریت کند. هنگامی که خانه روی دور تنظیم می شود، دمای هدف نمایش داده نمی شود، اما براساس انتخاب کاربر به صورت داخلی تنظیم می شود. هنگامی که ترموستات روی OFF تنظیم می شود، دمای مورد نظر مشاهده نمی شود.
اگر حتماً باید دمای مورد نظر را مستقیماً تغییر دهید، مطمئن شوید که این تغییر را در دو تماس جداگانه انجام دهید:
- تغییر
hvac_mode
به هر مقدار دیگر به جزeco
- اصلاح مناسب
target_temperature
مقادیر داده
با آغاز ترموستات خواندن و خواندن / نوشتن و ویرایش V6، شما می توانید دسترسی داشته باشید previous_hvac_mode
از طریق API برای کمک به تهویه مطبوع انتقال حالت. previous_hvac_mode
است مورد استفاده برای ذخیره hvac_mode
از دستگاه قبل از آن به "اکو" انتقال یافتند.
به عنوان مثال، اگر ترموستات آشیانه است با استفاده از درجه حرارت محیط زیست ( hvac_mode = "eco"
)، previous_hvac_mode
در دسترس است، و شما می خواهید محصول خود را به مجموعه ای target_temperature
، سپس شما باید اول:
- دریافت
previous_hvac_mode
- مجموعه ای
hvac_mode
بهprevious_hvac_mode
ارزش - تایید
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، محصولات Works with 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 Thermostat نشان داده می شود و چگونه رفتار می کند.
- هنگامی که
hvac_mode
تنظیم شده استheat-cool
است، ترموستات آشیانه نمایش کم و setpoints بالا از هم جدا شده یک کاراکتر گلوله (•)، در غیر این صورت نمایش ترموستات آشیانه فقط دمای هدف - هنگامی که
hvac_mode
تنظیم شده استoff
، کلمه "خاموش" است ترموستات آشیانه نمایش داده شده، در زبان مورد نظر کاربر - هنگامی که
hvac_mode
تنظیم شده استeco
، کلمه "اکو" بر ترموستات آشیانه نمایش داده شده، در زبان مورد نظر کاربر
فرمت دمای نمایشگر نیز به مقیاس دمای انتخابی (F/C) بستگی دارد.
دمای فارنهایت به صورت اعداد کامل نمایش داده می شود:
- دمای مورد نظر: 55 درجه فارنهایت
- دمای محیط: 62 درجه فارنهایت
دماهای سلسیوس به صورت یک عدد کامل یا یک مقدار اعشاری نمایش داده میشوند و آخرین رقم روی ".5" تنظیم شده است:
- دمای مورد نظر: 12 درجه سانتی گراد
- دمای محیط: 16.5 درجه سانتی گراد
برگ
وقتی نماد برگ در حال نمایش است که در جلوی ترموستات، ترموستات به دمای صرفه جویی در انرژی، تعیین و has_leaf
= true
.

قفل دما
کاربران میتوانند ترموستات Nest را قفل کنند تا فقط در محدوده دمایی محدودی قابل تنظیم باشد. با آغاز مجوز نسخه V5 ، شما می توانید ببینید که اگر قفل دما با چک کردن فعال is_locked
، و اگر از آن است، به عنوان خوانده شده قفل دما حداقل / حداکثر ارزش از طریق API:
دمای قفل باید به صورت جفت مشخص می شود، به عنوان حداقل و حداکثر ارزش ها، و تنها می تواند اگر نوشته شود is_locked
= true
.
رطوبت
رطوبت، در قالب درصد (%)، اندازهگیری شده در دستگاه، گرد شده به نزدیکترین 5%.
ضد آفتاب
ضد آفتاب به طور خودکار درجه حرارت بر روی ترموستات آشیانه را تنظیم می کنند برای خوشه گرمایی که از نور مستقیم خورشید در واحد رخ می دهد را جبران کند.
این مقادیر داده به شما می گوید که آیا Sunblock فعال است و/یا به طور فعال دما را تصحیح می کند.
-
sunlight_correction_enabled
- بولی، برمی گرداند
true
اگر SUNBLOCK فعال است
- بولی، برمی گرداند
-
sunlight_correction_active
- بولی، بازدهtrue
اگر SUNBLOCK فعال است، نشان می دهد که ترموستات در نور مستقیم خورشید واقع
پنکه
بسیاری از سیستم های تهویه مطبوع طرفداران یکپارچه شده است، که بدان معنی است که فن می تواند به طور مستقل نمی تواند کنترل شود . هیچ حالت خاموشی برای فن های یکپارچه وجود ندارد، زیرا فن باید زمانی که گرمایش یا سرمایش روشن است کار کند.
با این حال، اگر سیستم تهویه مطبوع سازگار باشد، می توان فن را به صراحت از طریق 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 Thermostat برای صرفهجویی در مصرف برق، Wi-Fi را خاموش میکند.
در عمل، این بدان معناست که ما تعداد تماسهایی را که میتوان با یک دستگاه در یک بازه زمانی تعریفشده برقرار کرد، محدود میکنیم. اگر از این حد تجاوز کنید، یک پاسخ خطا و پیامی دریافت خواهید کرد که نشان می دهد از حد مجاز خود فراتر رفته اید.
برای اطلاعات بیشتر، نگاه کنید به محدودیت سرعت داده .
محدودیت های قدرت
در برخی موارد ممکن است ترموستات قدرت باتری کافی برای ارائه درخواست تغییر را نداشته باشد. در این صورت یک پاسخ خطا و پیامی دریافت خواهید کرد که نشان می دهد دستگاه در حال حاضر نمی تواند درخواست را انجام دهد. اگر این اتفاق افتاد، قبل از تلاش مجدد، مدتی به باتری فرصت دهید تا شارژ شود.
اطلاعات بیشتر در مورد شرایط باتری کم در ترموستات آموزشی Nest .
پیغام خطا
برخی از ایالت ها عملکردهای خاصی را غیرقابل دسترس می کنند. این قوانین برای صرفه جویی در انرژی یا تامین آسایش و ایمنی وضع شده اند.
برای کسب اطلاعات در چه اشتباهات تماس API چیست و چگونه به آنها رسیدگی، و پیغام های خطا .
مشکل Wi-Fi / اتصال
اگر دستگاهی آفلاین است، تغییرات مجاز نیست. می توانید وضعیت آنلاین دستگاه را در مدل داده مشاهده کنید و UI را به طور مناسب نمایش دهید.