סכימה של מצב החיישנים של הבית החכם

action.devices.traits.SensorState - תכונה זו מכסה גם מדידה כמותית וגם מצב איכותני.

ATTRIBUTES במכשיר

מכשירים עם התכונה הזו עשויים לדווח על המאפיינים הבאים כחלק מהפעולה של SYNC. מידע נוסף על טיפול ב-SYNC כוונות זמין בקטע מימוש כוונה.

מאפיינים Type תיאור
sensorStatesSupported מערך

חובה.

כל אובייקט מייצג יכולות של מצב חיישן שנתמכות על ידי המכשיר הספציפי הזה. לכל חיישן צריכה להיות לפחות יכולת תיאורית או מספרית. החיישנים יכולים גם לדווח על שני הערכים, ובמקרה כזה הערך המספרי יקבל עדיפות.

[item, ...] אובייקט

תמיכה ביכולות חיישנים.

נדרשים לפחות פריט אחד.

name String

חובה.

סוג חיישן נתמך. הצגה של טבלת החיישנים הנתמכים.

descriptiveCapabilities אובייקט

תיאור של יכולות החיישן.

availableStates מערך

חובה.

רשימת המדינות הזמינות למכשיר. המצב "לא ידוע" נתמך באופן לא מפורש כאשר החיישן לא מחזיר ערך.

[item, ...] String

ערך מצב התיאור הנתמך.

נדרשים לפחות פריט אחד.

numericCapabilities אובייקט

מתאר את הערכים המספריים האפשריים שהחיישן יכול לדווח עליהם.

rawValueUnit String

חובה.

יחידה מספרית נתמכת.

לפרטים נוספים על היכולות וסוגי החיישנים שנתמכות בתכונה הזו, קראו את המאמר חיישנים נתמכים.

דוגמאות

מכשיר חיישן שמדווח על ערך המצב התיאורי.

{
  "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 כוונות זמין בקטע מימוש כוונה.

מדינות Type תיאור
currentSensorStateData מערך

חובה.

רשימה של מצבי החיישנים הנוכחיים.

[item, ...] אובייקט

המצב הנוכחי של החיישן.

name String

חובה.

שם מצב החיישן. תואם לערך מ-sensorStatesSupported.

currentSensorState String

ערך המצב התיאורי הנוכחי. תואם לערך מ-sensorStatesSupported.

rawValue מספר

ערך החיישן המספרי הנוכחי.

לפרטים נוספים על היכולות וסוגי החיישנים שנתמכות בתכונה הזו, קראו את המאמר חיישנים נתמכים.

דוגמאות

מכשיר חיישן שמדווח על ערך המצב התיאורי.

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

מכשיר חיישן לדיווח על ערך מצב מספרי.

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

מכשיר חיישן לדיווח על ערך תיאורי ומספר מצב.

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

פקודות מכשיר

ללא.

התראות במכשיר

מכשירים עם התכונה הזו עשויים להחזיר את המטען הייעודי (payload) הבא במסגרת שינוי מצב המכשיר. מידע נוסף על הטמעת התראות זמין במאמר התראות על פעולות לבית חכם.

שדות Type תיאור
SensorState אובייקט

חובה.

מטען ייעודי (payload) של התראה.

priority Integer

חובה.

רמת החשיפה. הערך הנתמך כעת הוא 0, דבר שמצביע על כך שיש לומר את ההתראה בקול.

name String

חובה.

שם מצב החיישן. הצגת רשימה של סוגי החיישנים הנתמכים להתראות.

currentSensorState String

חובה.

ערך המצב התיאורי הנוכחי. הצגת רשימה של סוגי החיישנים הנתמכים להתראות.

המטען הייעודי של ההודעה יכול להכיל את סוגי החיישנים הבאים:

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

לפרטים נוספים על היכולות השונות שנתמכות בכל סוג חיישן, אפשר לעיין במאמר חיישנים נתמכים.

דוגמאות

ה- מזהה עשן.

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

ERRORS מכשיר

לצפייה ברשימה המלאה של השגיאות והחריגים