סכימת ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

התכונה הזו שייכת לסוגי המכשירים של תרמוסטט שתומכים במצבי 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

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

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

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

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

מידע נוסף זמין בחומר העזר בנושא קוד שגיאה של API את הרשימה המלאה של קודי השגיאה של ה-API.