גוגל מחויבת לקדם הון גזעי עבור קהילות שחורות. תראה איך.
דף זה תורגם על ידי Cloud Translation API.
Switch to English

תֶרמוֹסטָט

בקרת תרמוסטט

ה- Nest Learning Thermostat ™ הוא מכשיר המחובר לאינטרנט אינטואיטיבי וקל לשימוש, ולומד באופן רציף על דפוסי השימוש בבית בכדי לייעל את הנוחות ולחסוך אנרגיה. משתמשים יכולים לשלוט על החימום והקירור שלהם בכל מקום שיש להם גישה לחיבור אינטרנט.

תמיכה בתכונות אלה דורשת מערכת בקרה מתוחכמת החורגת מתכניות פשוטות מבוססות נקודה. Nest מספקת מגוון רחב של אלגוריתמים (כמו Early On , True Radiant , Airwave ™ ) הדורשים כמות משמעותית של כוח חישובי בהשוואה לרוב התרמוסטטים. התרמוסטט של קן יש את הכוח הדרוש כדי לספק תכונות מתקדמות אלה.

ממשק API של Nest נועד לאפשר למוצרים לשלוט במערכת ה- HVAC מבלי להפריע לאלגוריתמים של Nest או להפתיע את המשתמש בהתנהגויות בלתי צפויות. הם מספקים גישה לנתונים הבאים עבור התרמוסטט Nest:

  • שם המבנה והמכשיר "איפה שם" (מיקום בבית)
  • תווית תרמוסטט אישית
  • סטטוס מקוון ומידע חיבור אחרון
  • טמפרטורות נוכחיות ויעד
  • מצב טמפרטורה
  • טמפרטורות אקו
  • זמן לטמפרטורה
  • סולם טמפרטורה (סט F / C)
  • מצב נעילת טמפרטורה , ואם נעול, ערכי הטמפרטורה הנעולים במינימום / מקסימום
  • משך טיימר המאוורר ומצב HVAC
  • לחות
  • שמש-שמש

הרשאות תרמוסטט

לגישה לקריאה לכל ערכי הנתונים של טרמוסטט API, בחר את הרשאת הקריאה של התרמוסטט עבור הלקוח שלך.

לגישה לקריאה לכל ערכי נתוני ה- API של טרמוסטט וגישה נוספת לכתיבה לערכי בחירה, בחר בהרשאת הקריאה / הכתיבה של התרמוסטט עבור הלקוח שלך. רמת הרשאה זו מאפשרת לך לעדכן את הדברים הבאים:

  • טמפרטורת יעד
  • מצב HVAC
  • טיימרים למעריצים

החל מקריאה / כתיבה v5 של תרמוסטט, באפשרותך גם לעדכן את הדברים הבאים:

  • סולם טמפרטורה
  • תווית תרמוסטט

מזהים תרמוסטט

התקן

התקני קן רשומים לפי סוג כמערך של מזהים, בהם ניתן להשתמש כדי לזהות התקן באופן ייחודי דרך נתיב ההתקן. אז מזהה תרמוסטט של "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 חותמת הזמן של החיבור המוצלח האחרון לשירות הקן
is_online סטטוס מקוון. זה נקבע על ידי קן באמצעות last_connection הזמן וחלון מחודש צפוי כי הוא ספציפי למכשיר.

תכונות התרמוסטט

מצבי תרמוסטט

מערכות HVAC כוללות ארבע מצבי "מופעל" ( heat , cool , cool heat-cool , eco ) ומצב אחד "כבוי" ( off ). אנו משתמשים במצבים אלו כדי לנהל נוחות וחיסכון באנרגיה באמצעות ערכי נתוני טמפרטורה של hvac_mode וטמפרטורה.

  • כאשר נבחר מצב חום או מגניב ( heat , cool ), התרמוסטט מתאים את הבית לטמפרטורת היעד.
  • כאשר נבחר מצב קירור • קירור 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 של התרמוסטט.

מעבר בין מצבי אקולוגי למצב שאינו אקו

המוצר שלך לא צריך להזדקק לניהול טמפרטורות יעד ישירות במצב Eco. כאשר הבית מוגדר לחלל, זמני היעד אינם מוצגים, אלא מוגדרים באופן פנימי, על סמך בחירת המשתמש. כאשר התרמוסטט מוגדר למצב OFF, אז לא נצפות טמפרטורות יעד.

אם אתה חייב לשנות באופן ישיר את טמפרטורות היעד, הקפד לבצע את השינוי בשתי שיחות נפרדות:

  1. שנה hvac_mode לכל ערך אחר פרט eco
  2. שנה את ערכי הנתונים target_temperature המתאימים

החל מהרשאות קריאה וקריאה / כתיבה של V6 תרמוסטט, אתה יכול לגשת previous_hvac_mode קודמת_hvac_mode דרך ה- API כדי לסייע במעברים במצב HVAC. previous_hvac_mode משמש לאחסון hvac_mode של המכשיר בטרם יועבר אל "אקו".

לדוגמא, אם את התרמוסטט של Nest משתמש טמפרטורות אקו ( hvac_mode = "eco" ), previous_hvac_mode נגיש, ואתה רוצה את המוצר שלך כדי להגדיר target_temperature , אז עליך:

  1. קבל previous_hvac_mode
  2. סט hvac_mode אל previous_hvac_mode ערך
  3. אשר 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, מוצרי עבודה עם מוצרי Nest יכולים לכתוב את טמפרטורת היעד כחלק מתהליך גדול יותר.

תמיד מוגדרת טמפרטורת יעד כאשר המערכת פועלת.

  • כאשר נבחר מצב חום או מגניב ( heat , cool ), מוגדרת target_temperature בודדת
  • כאשר נבחר מצב קירור • קירור heat-cool ( heat-cool ), target_temperature שני ערכי target_temperature , 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 , התרמוסטט של הקן מציג את hvac_mode הגדרה hvac_mode המופרדות על ידי תו כדור (•), אחרת התרמוסטט של הקן מציג רק את טמפרטורת היעד
  • כאשר hvac_mode מוגדר off , המילה "OFF" מוצגת hvac_mode הקן, בשפה המועדפת על המשתמש.
  • כאשר hvac_mode מוגדר eco , המילה "ECO" מוצגת על התרמוסטט Nest, בשפה המועדפת של המשתמש.

פורמט טמפרטורת התצוגה תלוי גם בסולם הטמפרטורות שנבחר (F / C).

טמפרטורות פרנהייט מוצגות כמספרים שלמים:

  • טמפרטורת יעד: 55 מעלות צלזיוס
  • טמפרטורת הסביבה: 62 ° F

הטמפרטורות של צלזיוס מוצגות כמספר שלם או כערך עשרוני, כשהספרה האחרונה מוגדרת ".5":

  • טמפרטורת יעד: 12 מעלות צלזיוס
  • טמפרטורת הסביבה: 16.5 מעלות צלזיוס

עלה

כאשר סמל העלה מוצג בחזית התרמוסטט, התרמוסטט מוגדר לטמפרטורה חוסכת אנרגיה, ויש has_leaf = true .

עלה

נעילת טמפרטורה

משתמשים יכולים לנעול תרמוסטט של קן כך שניתן יהיה לכוונן אותו רק בטווח טמפרטורה מוגבל. החל מההרשאות גרסת v5 , אתה יכול לראות אם נעילת טמפרטורה מופעלת על ידי בדיקת is_locked , ואם כן, קרא ערכי נעילת טמפרטורה / min / max דרך ה- API:

יש לציין טמפרטורות נעילה בזוגות, כערכים מקסימליים ומינימליים, וניתן לכתוב אותם רק אם is_locked = true .

לחות

לחות, בפורמט אחוזים (%), שנמדדה במכשיר, מעוגלת ל -5% הקרוב.

שמש-שמש

טכנולוגיית Sunblock מכוונת אוטומטית את הטמפרטורה בטרמוסטט Nest כדי לפצות על קוצים החום המתרחשים מאור שמש ישיר על היחידה.

ערכי נתונים אלה יגידו לך אם Sunblock מופעל ו / או מתקנים את הטמפרטורה באופן פעיל.

אוהד

במערכות HVAC רבות יש מאווררים משולבים, מה שאומר שלא ניתן לשלוט במאוורר באופן עצמאי . אין מצב כבוי עבור מאווררים משולבים, מכיוון שהאוורר צריך לפעול כאשר החימום או הקירור פועלים.

עם זאת, אם מערכת ה- HVAC תואמת, ניתן להפעיל את המאוורר באופן מפורש באמצעות ה- API, על מנת להקל על הנוסעים, מבלי להפעיל את מערכת ה- HVAC המלאה.

אם המאוורר ניתן לשלוט באופן עצמאי, has_fan יוגדר true , ואת הערכים הנתונים הבאים ניתן להגדיר עם טרמוסטט לקרוא / הרשאות כתיבה:

השתמש בערכים אלה יחד כדי להפעיל את טיימר המאוורר (הפעל את המאוורר) לפרק זמן מסוים. אתה יכול גם להשתמש בערך fan_timer_timeout כדי לקבוע את חותמת הזמן של המאוורר כך שיפסיק להפעיל.

שימו לב שתמיד תוכלו לשנות את fan_timer_duration - זה לא תלוי במצב התפוסה של hvac_mode או מבנה (משם).

אתה יכול לצפות לתגובות אלה על הצלחה או כישלון:

  • 200 אישור
  • בקשה שגויה 400

אם הפקודה להפעיל את המאוורר אינה מניבה את התוצאה הצפויה, ייתכן שהסיבה לכך היא שהאוורר כבר פעיל (באופן ידני על ידי המשתמש, או בלוח זמנים, או בגלל מחזור חום / קירור HVAC).

גבול דירוג

אנו מיישמים הגבלת תעריף להגנה מפני שיחות מוגזמות למכשירים, אשר עשויים להשפיע על ביצועי המערכת או הסוללה. בתנאים רגילים, מכשירי Nest טוענים את הסוללה מחוטי המתח הנמוך במערכת החימום והקירור. אבל אם שיחות מופרזות מתבצעות תוך פרק זמן קצר ורמת הסוללה יורדת, התרמוסטט של Nest יכבה את ה- Wi-Fi כדי לחסוך בחשמל.

בפועל זה אומר שאנחנו מגבילים את מספר השיחות שניתן לבצע למכשיר בפרק זמן מוגדר. אם אתה חורג ממגבלה זו, תקבל תשובת שגיאה והודעה המציינת כי חרגת מהמגבלה שלך.

למידע נוסף ראה מגבלות שיעור נתונים .

אילוצי כוח

במקרים מסוימים יתכן שלתרמוסטט אין מספיק סוללה בכדי לתת שירות לבקשת שינוי. במקרה זה תקבל תשובת שגיאה והודעה המציינת שהמכשיר לא יכול לספק את הבקשה בשלב זה. אם זה קורה, תן לסוללה זמן לטעון לפני שתנסה שוב.

למידע נוסף על תנאי סוללה חלשה ב- Nest Learning Thermostat .

הודעות שגיאה

מדינות מסוימות הופכות פונקציות מסוימות לא זמינות. כללים אלה קיימים כדי לחסוך באנרגיה או לספק נוחות ובטיחות.

למידע על המשמעות של שגיאות קריאת API וכיצד לטפל בהן, עיין בהודעות שגיאה .

בעיית Wi-Fi / חיבור

אם מכשיר במצב לא מקוון, אין לבצע שינויים. אתה יכול לראות את המצב המקוון של המכשיר במודל הנתונים ולהציג את ממשק המשתמש בצורה המתאימה.