طرحواره ترموستات اکو

ترموستات نست

sdm.devices.traits.ThermostatEco

این ویژگی متعلق به انواع ترموستات‌هایی است که از حالت‌های اقتصادی (ECO) پشتیبانی می‌کنند.

فیلدها

میدان توضیحات نوع داده
availableModes فهرست حالت‌های اقتصادی پشتیبانی‌شده. array(string)
مقدار: ["MANUAL_ECO", "OFF"]
mode حالت اقتصادی (Eco) فعلی ترموستات. string
مقادیر: "MANUAL_ECO"، "OFF"
heatCelsius کمترین دمایی که ترموستات در حالت اقتصادی (اکو) شروع به گرم کردن می‌کند (برحسب سانتیگراد). number
مثال: ۲۰.۰
coolCelsius بالاترین دما بر حسب سانتیگراد که در آن ترموستات در حالت اقتصادی (Eco) شروع به خنک کردن می‌کند. number
مثال: ۲۲.۰

نمونه درخواست و پاسخ 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
    }
  }
}

دستورات

حالت تنظیم

حالت Eco ترموستات را تغییر دهید.

برای تغییر حالت ترموستات به HEAT، COOL یا HEATCOOL، از دستور SetMode در بخش ThermostatMode استفاده کنید.

این دستور بر اساس وضعیت فعلی یا تغییرات حالت Eco، بر سایر ویژگی‌ها تأثیر می‌گذارد:

  • اگر حالت اقتصادی (Eco mode) خاموش باشد، حالت ترموستات به طور پیش‌فرض روی آخرین حالت استاندارد (گرما، سرما، HEATCOOL یا خاموش) که فعال بوده است، قرار می‌گیرد.
  • اگر حالت اقتصادی (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
مقادیر: "MANUAL_ECO"، "OFF"

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیام خطا آر پی سی عیب‌یابی
فرمان در حالت ترموستات فعلی مجاز نیست. FAILED_PRECONDITION طبق گفته، برخی از مدل‌های ترموستات از تغییر حالت Eco هنگام خاموش بودن حالت ترموستات پشتیبانی نمی‌کنند. حالت ترموستات ویژگی. قبل از تغییر حالت اقتصادی (اکو)، حالت ترموستات باید به HEAT، COOL یا HEATCOOL تغییر یابد.
وقتی ترموستات در حالت MANUAL_ECO است، دستور مجاز نیست. FAILED_PRECONDITION وقتی ترموستات در حالت دستی Eco قرار دارد، نمی‌توان نقطه تنظیم دما را تنظیم کرد.

برای مشاهده لیست کامل کدهای خطای API به مرجع کدهای خطای API مراجعه کنید.