مخطّط ThermostatEco
sdm.devices.traits.ThermostatEco
تنتمي هذه السمة إلى أنواع الأجهزة من النوع THERMOSTAT التي تتيح أوضاع ECO.
الحقول
الحقل | الوصف | نوع البيانات |
---|---|---|
availableModes |
قائمة أوضاع Eco المتوافقة | 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.
يؤثّر هذا الأمر في السمات الأخرى، استنادًا إلى الحالة الحالية للوضع "توفير الطاقة" أو التغييرات التي تطرأ عليه:
- إذا كان وضع "درجات الحرارة الاقتصادية" غير مفعَّل، سيتم ضبط وضع الترموستات تلقائيًا على آخر وضع عادي (HEAT أو COOL أو HEATCOOL أو OFF) كان نشطًا.
- إذا تم ضبط وضع "درجات حرارة اقتصادية" على 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 |
لا يمكن ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي. |
اطّلِع على مرجع رموز الخطأ في واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز الخطأ في واجهة برمجة التطبيقات.