مخطط ضبط درجة الحرارة في الترموستات

Nest Thermostat 

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 لا يمكن ضبط نقطة ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي.

ويمكنك الاطّلاع على مرجع رموز الأخطاء في واجهة برمجة التطبيقات للاطّلاع على القائمة الكاملة لرموز الأخطاء في واجهة برمجة التطبيقات.