Guides Comment Faire

Saviez-vous que n'importe quel capteur VisiblAir activé par le cloud peut être intégré avec HomeAssistant ? C'est en fait assez simple et repose sur les données que le capteur envoie périodiquement au portail cloud.

Pour ajouter votre capteur VisiblAir activé par le cloud à votre serveur HomeAssistant, utilisez simplement le YAML suivant dans le fichier de configuration configuration.yaml :

rest:
  resource: https://api.visiblair.com:11000/api/v1/sensor?uuid=YOUR_SENSOR_UUID&viewToken=YOUR_SENSOR_TOKEN
  sensor:
  - name: "Capteur VisiblAir CO2"
    unique_id: a74e63a8-6312-4d72-aeef-152fd21af0c3
    value_template: "{{ value_json.lastSampleCo2 }}"
    unit_of_measurement: "ppm"
    device_class: carbon_dioxide
  - name: "Capteur VisiblAir Température"
    unique_id: 887856eb-04e0-4858-a268-8af74979a486
    value_template: "{{ value_json.lastSampleTemperature }}"
    unit_of_measurement: "°C"
    device_class: temperature
  - name: "Capteur VisiblAir Humidité"
    unique_id: b479e1a4-8c64-4a33-a3e6-e56e633320ee
    value_template: "{{ value_json.lastSampleHumidity }}"
    unit_of_measurement: "%R.H."
    device_class: humidity

Remplacez YOUR_SENSOR_UUID par l'UUID de votre capteur (adresse MAC Wi-Fi) et YOUR_SENSOR_TOKEN par le jeton unique. Ce jeton peut être obtenu depuis le portail en cliquant sur l'icône "Vue publique" :

Ensuite, dans votre interface Web HomeAssistant, allez dans "Outils de développement" et cliquez sur "VÉRIFIER LA CONFIGURATION" pour vous assurer que la configuration que vous avez ajoutée est valide :

Si tout est ok, vous pouvez cliquer sur "REDÉMARRER" et sélectionner "Rechargement rapide"

L'étape suivante consiste à allouer une zone/zone aux données du capteur. Pour cela, cliquez sur "Paramètres" puis sur "Appareils et services"

En haut, cliquez sur "Entités" et vous devriez voir les données du capteur disponibles :

Cliquez sur chacun puis sur l'icône "engrenage"

Sélectionnez ensuite une zone et cliquez sur "Mettre à jour"

Les valeurs de votre capteur devraient maintenant s'afficher dans votre tableau de bord pour la zone sélectionnée. Vous pouvez également ajouter des graphiques et des jauges comme indiqué ci-dessous :

Notez que votre capteur doit être connecté à un réseau Wi-Fi, avoir accès à Internet et être correctement configuré dans le portail pour que votre serveur HomeAssistant puisse récupérer les données.

Saviez-vous que les modèles E et E-Lite VisiblAir disposent d'une API locale que vous pouvez utiliser pour obtenir l'état instantané et les mesures du capteur ?

Cette API peut être activée sur votre capteur en allant dans le menu Configuration, en appuyant sur "Options de gestion des données" et en cochant la case "API locale".

Par la suite, lorsque votre capteur est connecté à votre réseau Wi-Fi, vous pouvez interroger son état. Voici un exemple utilisant curl :

curl -s -H "Accept: application/json" -H "Authorization: Bearer MY_SENSOR_UUID_ALL_CAPS" http://MY_SENSOR_DNS.local:8080/state

MY_SENSOR_UUID_ALL_CAPS est votre UUID de capteur où toutes les lettres sont en majuscules.

MY_SENSOR_DNS est disponible dans l'écran Info de votre capteur et ressemblera à co2click-AABBCC où AABBCC sont les 3 derniers octets de votre UUID de capteur.

L'API retournera un objet JSON qui ressemblera à ceci sur le modèle E-Lite :

{
    "uuid": "MY_SENSOR_UUID_ALL_CAPS",
    "co2": 680,
    "humidity": 58,
    "temperature": 20,
    "pm01": 0,
    "pm03": 0,
    "pm05": 0,
    "pm10": 2.219000101,
    "pm25": 2.328000069,
    "pm50": 0,
    "pm100": 2.328000069,
    "pressure": 1020.398614,
    "voc": 98,
    "firmwareVersion": "1.5.1",
    "model": "E-Lite",
    "pcbVersion": 0,
    "isCharging": true,
    "isACIN": true,
    "battVoltage": 3.913000107,
    "battPct": 71.26999664
}

Vous pouvez utiliser cela pour effectuer l'automatisation de fonctions plus avancées.

Nous espérons que vous apprécierez nos capteurs, et assurez-vous de vous abonner à notre liste de diffusion pour recevoir plus de nouvelles comme celle-ci.