طرحواره ThermostatEco

Nest Thermostat

sdm.devices.traits.ThermostatEco

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

فیلدها

میدان توضیحات نوع داده
availableModes فهرست حالت‌های سازگار با محیط زیست array(string)
مقدار: ["MANUAL_ECO"، "OFF"]
mode حالت Eco فعلی ترموستات. string
مقادیر: "MANUAL_ECO"، "OFF"
heatCelsius کمترین درجه سانتیگراد که در آن ترموستات شروع به گرم شدن در حالت Eco می کند. number
مثال: 20.0
coolCelsius بالاترین درجه سانتیگراد که در آن ترموستات شروع به خنک شدن در حالت Eco می کند. number
مثال: 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 خاموش باشد، حالت ترموستات به آخرین حالت استاندارد (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
مقادیر: "MANUAL_ECO"، "OFF"

خطاها

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

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

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