סכימת ThermostatEco
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:
- הפקודות למאפיין ThermostatTemperatureSetpoint נדחות.
- נקודות הטמפרטורה שנקבעות לא מוחזרות על ידי המאפיין ThermostatTemperatureSetpoint .
בקשה ותגובה של 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.