مخطط الترموستات ThermostatSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
تنتمي هذه السمة إلى أنواع أجهزة "الترموستات" التي تتيح ضبط درجة الحرارة المستهدفة ونطاق درجة الحرارة.
الحقول
الحقل | الوصف | نوع البيانات |
---|---|---|
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.ThermostatTemperatureSetpoint
" : {
"heatCelsius" : 20.0,
}
}
}
نموذج لطلب واستجابة GET - رائع
الطلب
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 الأمر، يجب أن يكون الترموستات في وضع التدفئة أولاً:
الوضع | Command | الحقول |
---|---|---|
تدفئة | SetHeat | heatCelsius |
رائع | SetCool | coolCelsius |
تدفئة | SetRange | heatCelsius ، coolCelsius |
تجدر الإشارة إلى أن أوامر نقطة الضبط تأخذ درجات مئوية فقط كمعلمة، إلا أن يمكن أن يعرض جهاز 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 |
الحد الأدنى لدرجة الحرارة المُثلى الذي يتم ضبطه عندما يكون الترموستات في وضع "التدفئة" | number مثال: 20.0 |
coolCelsius |
الحد الأقصى لدرجة الحرارة المُثلى الذي يتم ضبطه عندما يكون الترموستات في وضع "التبريد" | number مثال: 22.0 |
الأخطاء
يمكن عرض رموز الخطأ التالية فيما يتعلق بهذه السمة:
رسالة الخطأ | متوسط عائد النقرة | تحديد المشاكل وحلّها |
---|---|---|
لا يُسمح بالطلب في وضع الترموستات الحالي. | FAILED_PRECONDITION |
وفقًا لسمة ThermostatMode لا يمكن تغيير وضع "درجات حرارة اقتصادية" في بعض طُرز الترموستات. يجب تغيير وضع الترموستات إلى "التدفئة" أو "التبريد" أو "التدفئة" قبل تغيير وضع "درجات حرارة اقتصادية". |
يجب أن تكون قيمة التبريد أكبر من قيمة الحرارة. | INVALID_ARGUMENT |
تأكَّد من أنّ الحقل heatCelsius أقل من الحقل coolCelsius في الأمر. |
لا يُسمح بالطلب عند تشغيل الترموستات في وضع MANUAL_ECO. | FAILED_PRECONDITION |
لا يمكن ضبط درجة الحرارة المضبوطة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي. |
يمكنك الاطّلاع على مرجع رمز خطأ واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز أخطاء واجهة برمجة التطبيقات.