סכימה של Thermostat ThermostatSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
התכונה הזו שייכת לסוגי המכשירים של תרמוסטט שתומכים בהגדרה של טמפרטורת יעד וטווח טמפרטורות.
שדות
שדה | תיאור | סוג הנתונים |
---|---|---|
heatCelsius |
טמפרטורת יעד בצלזיוס למצבי חימום ו-HEATCOOL של התרמוסטט. | number דוגמה: 20.0 |
coolCelsius |
טמפרטורת יעד בצלזיוס למצבי COOL ו-HEATCOOL של התרמוסטט. | number דוגמה: 22.0 |
בקשה ותגובה לדוגמה של GET – חימום
בקשה
GET /enterprises/project-id/devices/device-id
תשובה
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
דוגמה של בקשה ותגובה של GET – COOL
בקשה
GET /enterprises/project-id/devices/device-id
תשובה
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"coolCelsius" : 22.0
}
}
}
דוגמה של בקשה ותגובה של GET – HEATCOOL
בקשה
GET /enterprises/project-id/devices/device-id
תשובה
{
"name" : "enterprises/project-id/devices/device-id",
"traits" : {
"sdm.devices.traits.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
}
פקודות
התרמוסטט חייב להיות במצב שתואם לפקודה שמושמעת לפני ההחלפה את הטמפרטורה הקבועה. הפקודה והשדות לשינוי ההגדרות משתנים בהתאם לתרמוסטט במצב תצוגה.
לדוגמה, כדי להנפיק את SetHeat הפקודה, התרמוסטט חייב להיות במצב חימום קודם:
מצב | פקודה | שדות |
---|---|---|
חום | SetHeat | heatCelsius |
מגניב | SetCool | coolCelsius |
חימום | SetRange | heatCelsius , coolCelsius |
שימו לב שפקודות setpoint משתמשות רק במעלות בצלזיוס כפרמטר, Google Nest Thermostat יכול להציג טמפרטורה במעלות צלזיוס או פרנהייט.
SetHeat
המדיניות הזו מגדירה את טמפרטורת היעד כשהתרמוסטט במצב חימום.
בקשת SetHeat ותגובה
בקשה
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetHeat
",
"params" : {
"heatCelsius" : 22.0
}
}
תשובה
{}
שדות הבקשה של SetHeat
שדה | תיאור | סוג הנתונים |
---|---|---|
heatCelsius |
טמפרטורת היעד שיש להגדיר כשהתרמוסטט במצב חימום. | number דוגמה: 22.0 |
SetCool
המדיניות הזו מגדירה את טמפרטורת היעד כשהתרמוסטט במצב קירור.
בקשת SetCool ותגובה
בקשה
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetCool
",
"params" : {
"coolCelsius" : 20.0
}
}
תשובה
{}
שדות הבקשה של SetCool
שדה | תיאור | סוג הנתונים |
---|---|---|
coolCelsius |
טמפרטורת היעד שצריך להגדיר כשהתרמוסטט במצב קירור | number דוגמה: 20.0 |
SetRange
המדיניות הזו מגדירה את הטמפרטורות המינימליות והמקסימליות כשהתרמוסטט במצב HEATCOOL.
בקשה ותגובה של SetRange
בקשה
POST /enterprises/project-id/devices/device-id:executeCommand
{
"command" : "sdm.devices.commands.ThermostatTemperatureSetpoint.SetRange
",
"params" : {
"heatCelsius" : 20.0,
"coolCelsius" : 22.0
}
}
תשובה
{}
שדות בקשה ל-SetRange
שדה | תיאור | סוג הנתונים |
---|---|---|
heatCelsius |
טמפרטורת היעד המינימלית שיש להגדיר כשהתרמוסטט במצב HEATCOOL. | number דוגמה: 20.0 |
coolCelsius |
טמפרטורת היעד המקסימלית שצריך להגדיר כשהתרמוסטט במצב HEATCOOL. | number דוגמה: 22.0 |
שגיאות
יכול להיות שיוחזר קודי השגיאה הבאים בקשר לתכונה הזו:
הודעת שגיאה | הכנסה לקליק | פתרון בעיות |
---|---|---|
אי אפשר להשתמש בפקודה במצב התרמוסטט הנוכחי. | FAILED_PRECONDITION |
בדגמים מסוימים של התרמוסטט אין תמיכה בשינוי מצב 'חיסכון' כשמצב התרמוסטט כבוי, בהתאם לשיטת התרמוסטטמצב . יש לשנות את מצב התרמוסטט ל'חימום', 'קירור' או 'חימום חימום' לפני שמשנים את המצב 'חיסכון'. |
ערך הקירור חייב להיות גדול מערך החימום. | INVALID_ARGUMENT |
צריך לוודא שהשדה heatCelsius קטן מהשדה coolCelsius בפקודה. |
הפקודה לא מותרת כשהתרמוסטט במצב MANUAL_ECO. | FAILED_PRECONDITION |
לא ניתן להגדיר את הטמפרטורה הקבועה כשהתרמוסטט נמצא במצב חיסכון ידני. |
מידע נוסף זמין בחומר העזר בנושא קוד שגיאה של API את הרשימה המלאה של קודי השגיאה של ה-API.