‫ThermostatEco Schema

‫Nest Thermostat 

sdm.devices.traits.ThermostatEco

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

שדות

שדה תיאור סוג הנתונים
availableModes רשימה של מצבי חיסכון באנרגיה נתמכים. ‫array(string)
Value: ["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"

שגיאות

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

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

רשימה מלאה של קודי השגיאה של ה-API מפורטת בדף קודי השגיאה.