مخطط ThermostatEco

Nest Thermostat 

sdm.devices.traits.ThermostatEco

تنتمي هذه السمة إلى أنواع أجهزة THERMOSTAT التي تتيح أوضاع ECO.

الحقول

الحقل الوصف نوع البيانات
availableModes قائمة بأوضاع Eco المتوافقة array(string)
Value: ["MANUAL_ECO", "OFF"]
mode وضع Eco الحالي في الترموستات string
Values: "MANUAL_ECO", "OFF"
heatCelsius أدنى درجة حرارة بالدرجة المئوية يبدأ عندها الترموستات بالتدفئة في وضع Eco number
Example: 20.0
coolCelsius أعلى درجة حرارة بالدرجة المئوية يبدأ عندها الترموستات بالتبريد في وضع Eco number
Example: 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

تغيير وضع Eco في الترموستات

لتغيير وضع الترموستات إلى HEAT أو COOL أو HEATCOOL، استخدِم الأمر SetMode في سمة ThermostatMode.

يؤثّر هذا الأمر في السمات الأخرى استنادًا إلى الحالة الحالية لوضع Eco أو التغييرات التي تطرأ عليه:

  • إذا كان وضع Eco هو OFF، سيتم ضبط وضع الترموستات تلقائيًا على آخر وضع عادي (HEAT أو COOL أو HEATCOOL أو OFF) كان نشطًا.
  • إذا كان وضع Eco هو MANUAL_ECO:

طلب SetMode واستجابته

طلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.ThermostatEco.SetMode",
  "params" : {
    "mode" : "MANUAL_ECO"
  }
}

الردّ

{}

حقول طلب SetMode

الحقل الوصف نوع البيانات
mode وضع Eco الذي سيتم تغيير الترموستات إليه string
Values: "MANUAL_ECO", "OFF"

الأخطاء

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

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

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