הסכימה של מאפיין Smart Home SensorState

action.devices.traits.SensorState – המאפיין הזה מכסה גם מדידה כמותית וגם מצב איכותי.

מאפייני המכשיר

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

מאפיינים סוג תיאור
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, ראו ביצוע כוונות.

מדינות סוג תיאור
currentSensorStateData מערך

חובה.

רשימה של מצבי החיישן הנוכחיים.
[item, ...] אובייקט

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

חובה.

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

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

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

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

ערכים נתמכים:

IDLE
האזעקה לא פועלת, הרמות שזוהו לא מסוכנות.
PRE_ALARM_1
רמות הזיהוי גבוהות אבל עדיין לא הגיעו לרמות חירום. ייתכן שהרמות יהיו מסוכנות בקרוב.
PRE_ALARM_2
אם המכשיר תומך במספר התראות לפני הגעה לרמות חירום, המשמעות היא שרמות הזיהוי גבוהות יותר מ-PRE_ALARM_1. הרמות ממשיכות לעלות ועשויות להתקרב לרמות חירום בקרוב.
ALARM
רמות הזיהוי הגיעו לרמות חירום והתעוררה אזעקה.
alarmSilenceState String

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

ערכים נתמכים:

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 אובייקט

חובה.

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

חובה.

מייצג את רמת ההתראה. הערך הנתמך כרגע הוא 0, והוא מציין שההתראה צריכה להיאמר בקול.
name String

חובה.

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

חובה.

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

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

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

מידע נוסף על היכולות השונות שנתמכות בכל סוג חיישן זמין במאמר חיישנים נתמכים.

דוגמאות

מזהה עשן.

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

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

הרשימה המלאה של השגיאות והחריגות