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

בחומר העזר בנושא קודי שגיאה ב-API מופיעה רשימה מלאה של קודי השגיאה ב-API.