طرحواره ویژگی حالت سنسور خانه هوشمند

action.devices.traits.SensorState - این ویژگی هم اندازه گیری کمی و هم حالت کیفی را پوشش می دهد.

ویژگی های دستگاه

دستگاه های دارای این ویژگی ممکن است ویژگی های زیر را به عنوان بخشی از عملیات SYNC گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد SYNC ، به تحقق هدف مراجعه کنید.

صفات تایپ کنید توضیحات
sensorStatesSupported آرایه

مورد نیاز.

هر شی نشان دهنده قابلیت های حالت حسگر است که توسط این دستگاه خاص پشتیبانی می شود. هر حسگر باید حداقل دارای قابلیت توصیفی یا عددی باشد. سنسورها همچنین می توانند هر دو را گزارش کنند، در این صورت مقدار عددی ترجیح داده می شود.

[ item, ... ] شیء

قابلیت های سنسور پشتیبانی شده

حداقل به 1 مورد نیاز دارد.

name رشته

مورد نیاز.

نوع سنسور پشتیبانی شده جدول سنسورهای پشتیبانی شده را ببینید.

descriptiveCapabilities شیء

شرح قابلیت های سنسور.

availableStates آرایه

مورد نیاز.

لیست حالت های موجود برای دستگاه. حالت "ناشناخته" به طور ضمنی پشتیبانی می شود زمانی که سنسور مقداری را برنگرداند.

[ item, ... ] رشته

پشتیبانی از مقدار حالت توصیفی.

حداقل به 1 مورد نیاز دارد.

numericCapabilities شیء

مقادیر عددی احتمالی را که حسگر می تواند گزارش کند، توصیف می کند.

rawValueUnit رشته

مورد نیاز.

واحد عددی پشتیبانی شده

برای جزئیات بیشتر در مورد قابلیت‌ها و انواع حسگرهای مختلف که این ویژگی پشتیبانی می‌کند، به حسگرهای پشتیبانی شده مراجعه کنید.

نمونه ها

دستگاه حسگر که مقدار حالت توصیفی را گزارش می‌کند.

{
  "sensorStatesSupported": [
    {
      "name": "AirQuality",
      "descriptiveCapabilities": {
        "availableStates": [
          "healthy",
          "moderate",
          "unhealthy",
          "very unhealthy"
        ]
      }
    }
  ]
}

دستگاه حسگری که مقدار حالت عددی را گزارش می کند.

{
  "sensorStatesSupported": [
    {
      "name": "CarbonMonoxideLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      }
    }
  ]
}

دستگاه حسگر که مقدار حالت توصیفی و عددی را گزارش می‌کند.

{
  "sensorStatesSupported": [
    {
      "name": "SmokeLevel",
      "numericCapabilities": {
        "rawValueUnit": "PARTS_PER_MILLION"
      },
      "descriptiveCapabilities": {
        "availableStates": [
          "smoke detected",
          "high",
          "no smoke detected"
        ]
      }
    }
  ]
}

سنسورهای پشتیبانی شده

جداول زیر انواع سنسورهای پشتیبانی شده و قابلیت های مرتبط با آنها را فهرست می کند.

کیفیت هوا

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

AirQuality

مقادیر پشتیبانی شده:

healthy
moderate
unhealthy
unhealthy for sensitive groups
very unhealthy
hazardous
good
fair
poor
very poor
severe
unknown

مقادیر پشتیبانی شده:

AQI

مونوکسید کربن

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

CarbonMonoxideLevel

مقادیر پشتیبانی شده:

carbon monoxide detected
high
no carbon monoxide detected
unknown

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

سطح دود

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

SmokeLevel

مقادیر پشتیبانی شده:

smoke detected
high
no smoke detected
unknown

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

تمیزی فیلتر

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

FilterCleanliness

مقادیر پشتیبانی شده:

clean
dirty
needs replacement
unknown
 پشتیبانی نمی شود.

نشت آب

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

WaterLeak

مقادیر پشتیبانی شده:

leak
no leak
unknown
 پشتیبانی نمی شود.

تشخیص باران

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

RainDetection

مقادیر پشتیبانی شده:

rain detected
no rain detected
unknown
 پشتیبانی نمی شود.

طول عمر فیلتر

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

FilterLifeTime

مقادیر پشتیبانی شده:

new
good
replace soon
replace now
unknown

مقادیر پشتیبانی شده:

PERCENTAGE

طول عمر فیلتر محاسبه شده

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
 پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PERCENTAGE

سطح دی اکسید کربن

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

CarbonDioxideLevel
 پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

ذرات معلق

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

PM2.5
PM10
 پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

MICROGRAMS_PER_CUBIC_METER

ترکیبات آلی فرار

نام قابلیت های توصیفی قابلیت های عددی

مقادیر پشتیبانی شده:

VolatileOrganicCompounds
 پشتیبانی نمی شود.

مقادیر پشتیبانی شده:

PARTS_PER_MILLION

وضعیت دستگاه

موجودیت های دارای این ویژگی ممکن است وضعیت های زیر را به عنوان بخشی از عملیات QUERY گزارش کنند. برای کسب اطلاعات بیشتر در مورد مدیریت مقاصد QUERY ، به تحقق هدف مراجعه کنید.

ایالات تایپ کنید توضیحات
currentSensorStateData آرایه

مورد نیاز.

فهرست حالات حسگر فعلی

[ item, ... ] شیء

وضعیت سنسور فعلی

name رشته

مورد نیاز.

نام وضعیت سنسور با یک مقدار از sensorStatesSupported مطابقت دارد.

currentSensorState رشته

مقدار وضعیت توصیفی فعلی با یک مقدار از sensorStatesSupported مطابقت دارد.

rawValue شماره

مقدار سنسور عددی فعلی

alarmState رشته

وضعیت هشدار مربوط به قرائت سنسور فعلی. هنگامی که قرائت سنسور نزدیک می شود و به سطوح خطرناک می رسد، ممکن است یک زنگ هشدار یا هشدار اولیه فعال شود.

مقادیر پشتیبانی شده:

IDLE
زنگ بیکار است. سطوح شناسایی شده خطرناک نیستند.
PRE_ALARM_1
سطوح شناسایی شده افزایش یافته است اما هنوز به سطح اضطراری نرسیده است. سطوح ممکن است به زودی خطرناک شوند.
PRE_ALARM_2
اگر دستگاه قبل از رسیدن به سطوح اضطراری از چندین هشدار پشتیبانی کند، این نشان دهنده سطوح تشخیص بالاتر از PRE_ALARM_1 است. این سطوح همچنان در حال افزایش هستند و ممکن است به زودی به سطوح اضطراری نزدیک شوند.
ALARM
سطوح شناسایی شده به سطح اضطراری رسیده و زنگ هشدار به صدا درآمده است.
alarmSilenceState رشته

وضعیت سکوت را برای زنگ سنسور نشان می دهد، از جمله اینکه آیا خاموش کردن زنگ فعال در حال حاضر مجاز است یا خیر. این حالت ممکن است زمانی ارائه شود که یک حالت پیش هشدار یا هشدار فعال باشد.

مقادیر پشتیبانی شده:

ALLOWED
زنگ بی صدا نیست و خاموش کردن زنگ در حال حاضر مجاز است.
DISALLOWED
زنگ بی صدا نیست و خاموش کردن زنگ در حال حاضر مجاز نیست.
SILENCED
زنگ هشدار خاموش شده است.

برای جزئیات بیشتر در مورد قابلیت‌ها و انواع حسگرهای مختلف که این ویژگی پشتیبانی می‌کند، به حسگرهای پشتیبانی شده مراجعه کنید.

نمونه ها

دستگاه حسگر که مقدار حالت توصیفی را گزارش می‌کند.

{
  "currentSensorStateData": [
    {
      "name": "AirQuality",
      "currentSensorState": "healthy"
    }
  ]
}

دستگاه حسگری که مقدار حالت عددی را گزارش می کند.

{
  "currentSensorStateData": [
    {
      "name": "CarbonMonoxideLevel",
      "rawValue": 200
    }
  ]
}

دستگاه حسگر که مقدار حالت توصیفی و عددی را گزارش می‌کند.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200
    }
  ]
}

دستگاه حسگر که مقدار حالت توصیفی و عددی را گزارش می‌کند و هشدار فعال بودن را نشان می‌دهد.

{
  "currentSensorStateData": [
    {
      "name": "SmokeLevel",
      "currentSensorState": "smoke detected",
      "rawValue": 200,
      "alarmState": "ALARM",
      "alarmSilenceState": "DISALLOWED"
    }
  ]
}

دستورات دستگاه

هیچ کدام.

اعلان های دستگاه

دستگاه‌های دارای این ویژگی ممکن است بار اعلان زیر را به عنوان بخشی از تغییر وضعیت دستگاه برگردانند. برای کسب اطلاعات بیشتر در مورد اجرای اعلان‌ها، به اطلاعیه‌ها برای اقدامات خانه هوشمند مراجعه کنید.

فیلدها تایپ کنید توضیحات
SensorState شیء

مورد نیاز.

بار اعلان.

priority عدد صحیح

مورد نیاز.

سطح اعلان را نشان می دهد. مقدار پشتیبانی شده در حال حاضر 0 است، که نشان می دهد اعلان باید با صدای بلند گفته شود.

name رشته

مورد نیاز.

نام وضعیت سنسور لیست انواع سنسورهای پشتیبانی شده را برای اطلاعیه ها ببینید.

currentSensorState رشته

مورد نیاز.

مقدار وضعیت توصیفی فعلی لیست انواع سنسورهای پشتیبانی شده را برای اطلاعیه ها ببینید.

محموله اعلان می تواند شامل انواع سنسورهای زیر باشد:

  • AirQuality
  • CarbonMonoxideLevel
  • SmokeLevel
  • FilterCleanliness
  • WaterLeak
  • RainDetection
  • FilterLifeTime

برای جزئیات بیشتر در مورد قابلیت های مختلف پشتیبانی شده توسط هر نوع سنسور، به سنسورهای پشتیبانی شده مراجعه کنید.

نمونه ها

این دود را تشخیص می دهد

{
  "SensorState": {
    "priority": 0,
    "name": "SmokeLevel",
    "currentSensorState": "high"
  }
}

خطاهای دستگاه

لیست کامل خطاها و استثناها را ببینید.