‫ThermostatEco Schema

‫Nest Thermostat 

sdm.devices.traits.ThermostatEco

המאפיין הזה שייך לסוגי מכשירים של THERMOSTAT שתומכים במצבי ECO.

שדות

שדה תיאור סוג הנתונים
availableModes רשימה של מצבי חיסכון באנרגיה נתמכים. array(string)
ערך: [‎"MANUAL_ECO", "OFF"‎]
mode מצב החיסכון הנוכחי של התרמוסטט. string
ערכים: MANUAL_ECO,‏ OFF
heatCelsius הטמפרטורה הכי נמוכה במעלות צלזיוס שבה התרמוסטט מתחיל לחמם במצב חיסכון. number
דוגמה: 20.0
coolCelsius הטמפרטורה הגבוהה ביותר במעלות צלזיוס שבה התרמוסטט מתחיל לקרר במצב חיסכון. number
דוגמה: 22.0

דוגמה לבקשת GET ותגובה

בקשה

GET /enterprises/project-id/devices/device-id

תשובה

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.ThermostatEco" : {
      "availableModes" : ["MANUAL_ECO", "OFF"],
      "mode" : "MANUAL_ECO",
      "heatCelsius" : 20.0,
      "coolCelsius" : 22.0
    }
  }
}

פקודות

SetMode

לשנות את מצב החיסכון של התרמוסטט.

כדי לשנות את מצב התרמוסטט לחימום, קירור או חימום וקירור, משתמשים בפקודה SetMode של מאפיין ThermostatMode.

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

  • אם מצב החיסכון באנרגיה מושבת, מצב התרמוסטט יהיה כברירת מחדל המצב הרגיל האחרון שהיה פעיל (חימום, קירור, חימום וקירור או השבתה).
  • אם מצב החיסכון הוא MANUAL_ECO:

בקשה ותגובה של SetMode

בקשה

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

תשובה

{}

שדות של בקשת SetMode

שדה תיאור סוג הנתונים
mode מצב החיסכון באנרגיה שאליו רוצים להעביר את התרמוסטט. string
ערכים: MANUAL_ECO,‏ OFF

שגיאות

יכול להיות שיוחזרו קודי השגיאה הבאים שקשורים למאפיין הזה:

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

רשימה מלאה של קודי שגיאה של API זמינה במאמר API Error Code Reference.