مخطط ضبط درجة الحرارة في الترموستات
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 - 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، يجب أن يكون الترموستات في وضع "التدفئة" أولاً:
الوضع | 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
لضبط الحد الأدنى والأقصى لدرجات الحرارة عندما يكون الترموستات في وضع "التدفئة والتبريد".
طلب 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 |
لا تتيح بعض طُرز الترموستات تغيير وضع "درجات حرارة اقتصادية" عند إيقاف وضع الترموستات، وذلك وفقًا لسمة وضع الترموستات . يجب تغيير وضع الترموستات إلى "تدفئة" أو "بارد" أو "تدفئة" قبل تغيير وضع "درجات حرارة اقتصادية". |
يجب أن تكون قيمة التبريد أكبر من قيمة الحرارة. | INVALID_ARGUMENT |
تأكَّد من أنّ الحقل heatCelsius أقل من الحقل coolCelsius في الأمر. |
لا يُسمح بتنفيذ الأمر عندما يكون الترموستات في وضع MANUAL_ECO. | FAILED_PRECONDITION |
لا يمكن ضبط نقطة ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي. |
ويمكنك الاطّلاع على مرجع رموز الأخطاء في واجهة برمجة التطبيقات للاطّلاع على القائمة الكاملة لرموز الأخطاء في واجهة برمجة التطبيقات.