مخطّط ThermostatTemperatureSetpoint

Nest Thermostat 

sdm.devices.traits.ThermostatTemperatureSetpoint

تنتمي هذه السمة إلى أنواع الأجهزة من النوع THERMOSTAT التي تتيح ضبط درجة الحرارة المستهدَفة ونطاق درجة الحرارة.

الحقول

الحقل الوصف نوع البيانات
heatCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي الترموستات HEAT وHEATCOOL number
مثال: 20.0
coolCelsius درجة الحرارة المستهدَفة بالدرجة المئوية لوضعَي الترموستات COOL وHEATCOOL number
مثال: 22.0

نموذج طلب GET والاستجابة له - HEAT

الطلبالردّ
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
COOL SetCool coolCelsius
HEATCOOL 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 أدنى درجة حرارة مستهدفة يتم ضبطها عندما يكون الترموستات في وضع HEATCOOL number
مثال: 20.0
coolCelsius الحد الأقصى لدرجة الحرارة المستهدفة التي يتم ضبطها عندما يكون الترموستات في وضع HEATCOOL number
مثال: 22.0

الأخطاء

قد يتم عرض رموز الخطأ التالية في ما يتعلّق بهذه السمة:

رسالة الخطأ متوسط عائد النقرة تحديد المشاكل وحلّها
لا يُسمح بهذا الطلب في وضع الترموستات الحالي. FAILED_PRECONDITION لا تتيح بعض طُرز الترموستات تغيير وضع "توفير الطاقة" عندما يكون وضع الترموستات "غير مفعّل"، وذلك وفقًا لسمة ThermostatMode . يجب تغيير وضع الترموستات إلى HEAT أو COOL أو HEATCOOL قبل تغيير وضع Eco.
يجب أن تكون قيمة "التبريد" أكبر من قيمة "التدفئة". INVALID_ARGUMENT تأكَّد من أنّ قيمة الحقل heatCelsius أقل من قيمة الحقل coolCelsius في الأمر.
لا يُسمح بهذا الأمر عندما يكون الترموستات في وضع MANUAL_ECO. FAILED_PRECONDITION لا يمكن ضبط درجة الحرارة عندما يكون الترموستات في وضع "درجات حرارة اقتصادية" اليدوي.

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