Schéma de trait SensorState pour la maison connectée

action.devices.traits.SensorState : cette caractéristique couvre à la fois la mesure quantitative et l'état qualitatif.

ATTRIBUTS de l'appareil

Les appareils dotés de cette caractéristique peuvent signaler les attributs suivants dans le cadre de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez la section Traitement des intents.

Attributs Type Description
sensorStatesSupported Array

Obligatoire.

Chaque objet représente les fonctionnalités d'état des capteurs prises en charge par cet appareil spécifique. Chaque capteur doit disposer d'au moins une fonctionnalité descriptive ou numérique. Les capteurs peuvent également signaler les deux, auquel cas la valeur numérique est privilégiée.

[item, ...] Objet

Fonctionnalités des capteurs compatibles.

Vous devez ajouter au moins un élément.

name String

Obligatoire.

Type de capteur compatible. Consultez le tableau "Capteurs compatibles".

descriptiveCapabilities Objet

Description des fonctionnalités du capteur.

availableStates Array

Obligatoire.

Liste des états disponibles pour l'appareil. L'état "inconnu" est implicitement accepté lorsque le capteur ne renvoie pas de valeur.

[item, ...] String

Valeur d'état descriptive acceptée.

Vous devez ajouter au moins un élément.

numericCapabilities Objet

Décrit les valeurs numériques possibles que le capteur peut signaler.

rawValueUnit String

Obligatoire.

Unité numérique acceptée.

Pour en savoir plus sur les différentes fonctionnalités et les différents types de capteurs compatibles avec cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil de capteur qui indique une valeur d'état descriptive.

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

Appareil de capteur qui indique une valeur d'état numérique.

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

Appareil de capteur qui indique une valeur d'état descriptive et numérique.

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

Capteurs compatibles

Les tableaux suivants répertorient les types de capteurs compatibles et les fonctionnalités associées.

Qualité de l'air

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

AirQuality

Valeurs acceptées :

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

Valeurs acceptées :

AQI

Monoxyde de carbone

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

CarbonMonoxideLevel

Valeurs acceptées :

carbon monoxide detected
high
no carbon monoxide detected
unknown

Valeurs acceptées :

PARTS_PER_MILLION

Niveau de fumée

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

SmokeLevel

Valeurs acceptées :

smoke detected
high
no smoke detected
unknown

Valeurs acceptées :

PARTS_PER_MILLION

Propreté du filtre

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

FilterCleanliness

Valeurs acceptées :

clean
dirty
needs replacement
unknown
Non compatible.

Fuite d'eau

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

WaterLeak

Valeurs acceptées :

leak
no leak
unknown
Non compatible.

Détection de la pluie

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

RainDetection

Valeurs acceptées :

rain detected
no rain detected
unknown
Non compatible.

Durée de vie du filtre

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

FilterLifeTime

Valeurs acceptées :

new
good
replace soon
replace now
unknown

Valeurs acceptées :

PERCENTAGE

Durée de vie calculée du filtre

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Non compatible.

Valeurs acceptées :

PERCENTAGE

Niveau de dioxyde de carbone

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

CarbonDioxideLevel
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

Particules en suspension

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

PM2.5
PM10
Non compatible.

Valeurs acceptées :

MICROGRAMS_PER_CUBIC_METER

Composants organiques volatils

Nom Fonctionnalités descriptives Fonctionnalités numériques

Valeurs acceptées :

VolatileOrganicCompounds
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

ÉTATS DE L'APPAREIL

Les entités avec cette caractéristique peuvent signaler les états suivants dans le cadre de l'opération QUERY. Pour en savoir plus sur la gestion des intents QUERY, consultez la section Traitement des intents.

États Type Description
currentSensorStateData Array

Obligatoire.

Liste des états actuels des capteurs.

[item, ...] Objet

État actuel du capteur.

name String

Obligatoire.

Nom de l'état du capteur. Correspond à une valeur de sensorStatesSupported.

currentSensorState String

Valeur d'état descriptive actuelle. Correspond à une valeur de sensorStatesSupported.

rawValue Number

Valeur numérique actuelle du capteur.

alarmState String

État de l'alarme correspondant à la lecture actuelle du capteur. Une pré-alarme ou une alarme peut se déclencher lorsque les mesures des capteurs approchent et atteignent des niveaux dangereux.

Valeurs acceptées :

IDLE
L'alarme est inactive. Les niveaux détectés ne sont pas dangereux.
PRE_ALARM_1
Les niveaux détectés sont élevés, mais n'ont pas encore atteint le niveau d'alerte d'urgence. Ils pourraient bientôt devenir dangereux.
PRE_ALARM_2
Si l'appareil accepte plusieurs alertes avant d'atteindre les niveaux d'urgence, cela indique que les niveaux de détection sont supérieurs à PRE_ALARM_1. Les niveaux continuent d'augmenter et peuvent bientôt atteindre les niveaux d'urgence.
ALARM
Les niveaux détectés ont atteint un niveau d'urgence et une alarme a été déclenchée.
alarmSilenceState String

Indique l'état de la mise sous silence de l'alarme du capteur, y compris si la mise sous silence d'une alarme active est actuellement autorisée. Cet état peut être fourni lorsqu'un état d'alarme ou de pré-alarme est actif.

Valeurs acceptées :

ALLOWED
L'alarme n'est pas coupée, et le fait de la couper est actuellement autorisé.
DISALLOWED
L'alarme n'est pas coupée et la coupure de l'alarme n'est pas autorisée pour le moment.
SILENCED
L'alarme a été mise sous silence.

Pour en savoir plus sur les différentes fonctionnalités et les différents types de capteurs compatibles avec cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil de capteur qui indique une valeur d'état descriptive.

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

Appareil de capteur qui indique une valeur d'état numérique.

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

Appareil de capteur qui indique une valeur d'état descriptive et numérique.

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

Appareil de capteur qui indique une valeur d'état descriptive et numérique et indique qu'une alarme est active.

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

COMMANDES DE L'APPAREIL

Aucune.

Notifications de l'appareil

Les appareils dotés de cette caractéristique peuvent renvoyer la charge utile de notification suivante lors d'un changement d'état de l'appareil. Pour en savoir plus sur l'implémentation des notifications, consultez la section Notifications pour les actions de la maison connectée.

Champs Type Description
SensorState Objet

Obligatoire.

Charge utile de notification.

priority Entier

Obligatoire.

Représente le niveau de notification. La valeur actuellement acceptée est 0, ce qui indique que la notification doit être lue à voix haute.

name String

Obligatoire.

Nom de l'état du capteur. Consultez la liste des types de capteurs compatibles pour les notifications.

currentSensorState String

Obligatoire.

Valeur d'état descriptive actuelle. Consultez la liste des types de capteurs compatibles pour les notifications.

La charge utile de la notification peut contenir les types de capteurs suivants:

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

Pour en savoir plus sur les différentes fonctionnalités compatibles avec chaque type de capteur, consultez la section Capteurs compatibles.

Exemples

Le détecte de la fumée.

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

ERREURS de l'appareil

Consultez la liste complète des erreurs et exceptions.