סכימת 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

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

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