Schéma du traît de capteurs d'état de la maison connectée

action.devices.traits.SensorState : cette caractéristique concerne les mesures quantitatives et l'état qualitatif.

ATTRIBUTS de l'appareil

Les appareils disposant de cette caractéristique peuvent signaler les attributs suivants lors de l'opération SYNC. Pour en savoir plus sur la gestion des intents SYNC, consultez Traitement des intents.

Attributs Type Description
sensorStatesSupported Array

Obligatoire.

Chaque objet représente les fonctionnalités d'état des capteurs compatibles avec cet appareil. Chaque capteur doit disposer d'au moins une capacité descriptive ou numérique. Les capteurs peuvent également indiquer les deux, auquel cas la valeur numérique est privilégiée.

[item, ...] Objet

Fonctionnalités de capteurs compatibles.

Nécessite au moins un article.

name String

Obligatoire.

Type de capteur compatible. Consultez le tableau des 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 pris en charge lorsque le capteur ne renvoie pas de valeur.

[item, ...] String

Valeur d'état descriptif acceptée.

Nécessite au moins un article.

numericCapabilities Objet

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

rawValueUnit String

Obligatoire.

Unité numérique acceptée.

Pour en savoir plus sur les fonctionnalités et les types de capteurs pris en charge par cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil capteur indiquant une valeur d'état descriptive.

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

Appareil capteur affichant une valeur d'état numérique.

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

Capteur dont la valeur de l'état est descriptif 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 leurs fonctionnalités associées.

Qualité de l'air

Nom Capacités descriptives Capacité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 Capacités descriptives Capacité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 Capacités descriptives Capacité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 Capacités descriptives Capacités numériques

Valeurs acceptées :

FilterCleanliness

Valeurs acceptées :

clean
dirty
needs replacement
unknown
Non compatible.

Fuite d'eau

Nom Capacités descriptives Capacités numériques

Valeurs acceptées :

WaterLeak

Valeurs acceptées :

leak
no leak
unknown
Non compatible.

Détection de la pluie

Nom Capacités descriptives Capacité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 Capacités descriptives Capacité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 du filtre calculé

Nom Capacités descriptives Capacités numériques

Valeurs acceptées :

PreFilterLifeTime
HEPAFilterLifeTime
Max2FilterLifeTime
Non compatible.

Valeurs acceptées :

PERCENTAGE

Niveau de dioxyde de carbone

Nom Capacités descriptives Capacités numériques

Valeurs acceptées :

CarbonDioxideLevel
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

Matières particulaires

Nom Capacités descriptives Capacités numériques

Valeurs acceptées :

PM2.5
PM10
Non compatible.

Valeurs acceptées :

MICROGRAMS_PER_CUBIC_METER

Composants organiques volatils

Nom Capacités descriptives Capacités numériques

Valeurs acceptées :

VolatileOrganicCompounds
Non compatible.

Valeurs acceptées :

PARTS_PER_MILLION

Appareil STATES

Les entités dotées de 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 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. Établit une correspondance avec une valeur sensorStatesSupported.

currentSensorState String

Valeur actuelle de l'état descriptif. Établit une correspondance avec une valeur sensorStatesSupported.

rawValue Number

Valeur actuelle du capteur numérique.

Pour en savoir plus sur les fonctionnalités et les types de capteurs pris en charge par cette caractéristique, consultez la section Capteurs compatibles.

Exemples

Appareil capteur indiquant une valeur d'état descriptive.

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

Appareil capteur affichant une valeur d'état numérique.

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

Capteur dont la valeur de l'état est descriptif et numérique.

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

Appareil COMMANDS

Aucun.

NOTIFICATIONS D'APPAREIL

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

Champs Type Description
SensorState Objet

Obligatoire.

Charge utile de la 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 prononcée à 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 actuelle de l'état descriptif. 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 proposées par chaque type de capteur, consultez la page Capteurs compatibles.

Exemples

Le détecte de la fumée.

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

ERREURS sur l'appareil

Consultez la liste complète des erreurs et exceptions.