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

תֶרמוֹסטָט

בקרת תרמוסטט

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

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

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

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

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

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

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

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

החל מ- Thermostat לקרוא / לכתוב v5, תוכל גם לעדכן את הדברים הבאים:

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

מזהי תרמוסטט

התקן

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

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

מצבי תרמוסטט

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

  • כאשר מחמם או מצב Cool ( 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 להיות שונה?
נעל טמפרטורה מופעל כן
חירום shutoff פעיל לא
חום החירום מופעל לא
can_cool או can_heat ערך היא false לא

טמפרטורות אקו

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

אקו נקודות קצה טמפרטורה זמינים API קן החל טרמוסטט לקרוא ולקרוא / הרשאות V6 כתיבה.

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

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

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

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

החל טרמוסטט לקרוא הרשאות קריאה / כתיבה V6, אתה יכול לגשת previous_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. confirm 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 יכולות לכתוב את טמפרטורת היעד כחלק מתהליך גדול יותר.

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

  • כאשר מחממים או מצב Cool ( heat , cool ) נבחרה, סינגל target_temperature הוא סט
  • כאשר חום • מצב Cool ( heat-cool ) נבחר, שני target_temperature ערכים מוגדרים, המציין מגוון יעד, אחד גבוה לקירור נמוך יותר עבור חימום
  • כאשר מצב Eco ( eco ) נבחר, טווח טמפרטורת היעד מוגדר באופן פנימי

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

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

זמן לטמפרטורה

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

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

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

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

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

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

עלה

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

עלה

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

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

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

לחות

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

חסימת שמש

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

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

אוהד

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

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

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

  • fan_timer_active - בוליאני, מחזירת true אם טיימר אוהד עוסק למשך מתוכנת מראש
  • fan_timer_duration - int, משך הזמן (בדקות) כי המאוורר מוגדר לפעול

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

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

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

  • 200 בסדר
  • בקשה שגויה 400

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

גבול דירוג

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

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

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

אילוצי כוח

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

למידע נוסף על תנאי סוללה חלשים ב"קן למידה טרמוסטט .

הודעות שגיאה

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

לקבלת מידע על מה שגיאות קריאה API אומר ואיך לטפל בהם, לראות הודעות שגיאה .

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

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