סכימת ThermostatEco

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

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

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