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

منظم الحراره

التحكم في درجة الحرارة

في عش التعلم ترموستات ™ هو جهاز متصل بالإنترنت التي هي بديهية وسهلة الاستخدام، والتعلم باستمرار حول أنماط الاستخدام في المنزل لراحة الأمثل وتوفير الطاقة. يمكن للمستخدمين التحكم في التدفئة والتبريد في أي مكان لديهم اتصال بالإنترنت.

يتطلب دعم هذه الميزات نظام تحكم متطورًا يتجاوز البرامج البسيطة القائمة على نقطة الضبط. يوفر عش مجموعة واسعة من خوارزميات (مثل المرحلة المبكرة ، صحيح مشع ، الموجات الهوائية ™ ) التي تتطلب قدرا كبيرا من القوة الحسابية بالمقارنة مع معظم الحرارة. يتمتع Nest Thermostat بالطاقة اللازمة لتوفير هذه الميزات المتقدمة.

و API عش تم تصميمها لتسمح للمنتجات للسيطرة على نظام HVAC دون تعطيل خوارزميات عش أو المستغرب المستخدم مع السلوكيات غير متوقعة. أنها توفر الوصول إلى البيانات التالية الخاصة بـ Nest Thermostat:

أذونات الترموستات

من أجل الوصول للقراءة إلى كل قيم البيانات API الحرارة، وحدد ترموستات قراءة إذن لعميلك.

من أجل الوصول للقراءة إلى كل قيم البيانات API الحرارة والوصول للكتابة إضافية لتحديد القيم، حدد الحرارة القراءة / الكتابة إذن لعميلك. يسمح لك مستوى الإذن هذا بتحديث ما يلي:

  • درجة الحرارة المستهدفة
  • وضع HVAC
  • مؤقتات المروحة

بدءًا من الإصدار 5 من Thermostat read / write ، يمكنك أيضًا تحديث ما يلي:

  • مقياس درجة الحرارة
  • تسمية الترموستات

معرفات الترموستات

جهاز

يتم سرد أجهزة 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.

الهياكل لها حالتان مرتبطتان بالوجود: المنزل أو بالخارج. عندما لا يتم استشعار أي حركة في المنزل ، سيتغير الهيكل من المنزل إلى الخارج ، وستعمل الترموستات في المنزل على تمكين درجات الحرارة البيئية تلقائيًا

كيف 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.

التبديل بين الوضع الاقتصادي وغير الاقتصادي

يجب ألا يحتاج منتجك إلى إدارة درجات الحرارة المستهدفة مباشرةً في الوضع الاقتصادي. عندما يتم تعيين المنزل على بعيد ، لا يتم عرض درجة الحرارة المستهدفة ، ولكن يتم ضبطها داخليًا ، بناءً على اختيار المستخدم. عند ضبط منظم الحرارة على OFF ، فلن يتم ملاحظة درجات الحرارة المستهدفة.

إذا كان يجب عليك تغيير درجات الحرارة المستهدفة بشكل مباشر ، فتأكد من إجراء التغيير في مكالمتين منفصلتين:

  1. تغيير hvac_mode إلى أي قيمة أخرى غير eco
  2. تعديل مناسبا target_temperature قيم البيانات

بدءا الحرارة القراءة وأذونات القراءة / الكتابة V6، يمكنك الوصول إلى previous_hvac_mode من خلال API لمساعدة مع التحولات وضع HVAC. 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 فارغ / فارغ

درجة الحرارة المستهدفة

درجة الحرارة المستهدفة هي القيمة الأكثر أهمية لنظام التدفئة والتهوية وتكييف الهواء - إنها درجة الحرارة المرغوبة ، التي يحددها المستخدم عادةً. تستند معظم الإجراءات والقرارات على ذلك. من API ، يمكن لمنتجات Works with Nest كتابة درجة الحرارة المستهدفة كجزء من عملية أكبر.

هناك دائمًا درجة حرارة مستهدفة يتم ضبطها عند تشغيل النظام.

  • عندما الحرارة أو وضع رائعا ( heat ، cool يتم تحديد)، واحدة target_temperature هو مجموعة
  • عندما الحراري • وضع رائعا ( heat-cool يتم تحديد)، وهما target_temperature يتم تعيين القيم، تدل على النطاق المستهدف، وهو أعلى واحد للتبريد وأقل واحد لأغراض التدفئة
  • عندما وضع طبيعي ( 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 ، عش يعرض الحرارة منخفضة وعالية setpoints مفصولة حرف رصاصة (•)، وإلا يعرض عش الحرارة فقط درجة الحرارة المستهدفة
  • عندما hvac_mode ومن المقرر أن off ، يتم عرض كلمة "OFF" في عش الحرارة، في اللغة المفضلة للمستخدم
  • عندما hvac_mode ومن المقرر أن eco ، يتم عرض كلمة "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 إذا تم تمكين ريحلات
  • sunlight_correction_active - منطقية، يعود true إذا ريحلات نشطة، مشيرا إلى أن الحرارة يقع في أشعة الشمس المباشرة

معجب

العديد من أنظمة HVAC ودمج المشجعين، وهو ما يعني أن المروحة لا يمكن التحكم بشكل مستقل . لا يوجد وضع إيقاف للمراوح المدمجة ، لأن المروحة تحتاج إلى العمل عند تشغيل التدفئة أو التبريد.

ومع ذلك ، إذا كان نظام التدفئة والتهوية وتكييف الهواء (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 للحفاظ على الطاقة.

في الممارسة العملية ، هذا يعني أننا نحد من عدد المكالمات التي يمكن إجراؤها على جهاز خلال فترة زمنية محددة. إذا تجاوزت هذا الحد ، فستتلقى ردًا على خطأ ورسالة تشير إلى أنك تجاوزت الحد المسموح به.

لمزيد من المعلومات، راجع حدود معدل البيانات .

قيود الطاقة

في بعض الحالات ، قد لا يكون لدى منظم الحرارة طاقة بطارية كافية لخدمة طلب تعديل. في هذه الحالة ، ستتلقى ردًا على خطأ ورسالة تشير إلى أن الجهاز لا يمكنه خدمة الطلب في الوقت الحالي. إذا حدث هذا ، فامنح البطارية بعض الوقت لإعادة الشحن قبل المحاولة مرة أخرى.

معرفة المزيد عن انخفاض ظروف البطارية في عش التعلم الحرارة .

رسائل خاطئة

بعض الدول تجعل بعض الوظائف غير متاحة. تم وضع هذه القواعد للحفاظ على الطاقة أو توفير الراحة والأمان.

للحصول على معلومات حول ما تعني أخطاء دعوة API وكيفية التعامل معها، انظر رسائل خطأ .

مشكلة اتصال Wi-Fi

إذا كان الجهاز غير متصل بالإنترنت ، فلن يُسمح بإجراء تعديلات. يمكنك مراقبة حالة الجهاز عبر الإنترنت في نموذج البيانات وعرض واجهة المستخدم بشكل مناسب.