طرحواره فن

ترموستات نست

sdm.devices.traits.Fan

این ویژگی متعلق به هر دستگاهی است که توانایی سیستمی کنترل فن را داشته باشد.

فیلدها

میدان توضیحات نوع داده
timerMode حالت تایمر فعلی. string
مقادیر: "روشن"، "خاموش"
timerTimeout مهر زمان، با فرمت RFC 3339، که در آن حالت تایمر خاموش می‌شود. string
مثال: "2019-05-10T03:22:54Z"

نمونه درخواست و پاسخ GET

درخواست 

GET /enterprises/project-id/devices/device-id

پاسخ 

{
  "name" : "enterprises/project-id/devices/device-id",
  "traits" : {
    "sdm.devices.traits.Fan" : {
      "timerMode" : "ON",
      "timerTimeout" : "2019-05-10T03:22:54Z"
    }
  }
}

دستورات

تنظیم تایمر

تایمر فن را عوض کنید.

درخواست و پاسخ SetTimer

درخواست 

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.Fan.SetTimer",
  "params" : {
    "timerMode" : "ON",
    "duration" : "3600s"
  }
}

پاسخ 

{}

فیلدهای درخواست SetTimer

میدان توضیحات نوع داده
timerMode حالت تنظیم تایمر فن. string
مقادیر: "روشن"، "خاموش"
duration اختیاری. مدت زمانی را که تایمر برای اجرا تنظیم شده است، بر حسب ثانیه مشخص می‌کند. string
محدوده: از «۱ ثانیه» تا «۴۳۲۰۰ ثانیه»
پیش‌فرض: "900s"

خطاها

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

پیام خطا آر پی سی عیب‌یابی
فن ترموستات موجود نیست. FAILED_PRECONDITION این ترموستات قابلیت فن ندارد. نمی‌توان از ویژگی‌ها و دستورات مربوط به فن برای این دستگاه استفاده کرد.

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