Skip to content

Latest commit

 

History

History
155 lines (106 loc) · 9.13 KB

README_fr.md

File metadata and controls

155 lines (106 loc) · 9.13 KB

ha-xsense-component_test

Image

Aperçu

Cette intégration pour Home Assistant permet l'utilisation des appareils Xsense au sein d'un système de maison intelligente. Elle est basée sur le code original de Theo Snel et a été publiée avec son autorisation et en collaboration avec lui.

Jusqu'à ce qu'une intégration officielle pour Home Assistant soit disponible de la part de Theo, cette intégration HACS sera utilisée et mise à jour régulièrement pour ajouter de nouvelles fonctionnalités et résoudre les problèmes existants. Cette intégration permet aux utilisateurs d'intégrer facilement leurs appareils Xsense dans Home Assistant et de les utiliser pour diverses automatisations et surveillances.

Image

Fonctionnalités

  • Intégration de divers appareils Xsense dans Home Assistant.
  • Prise en charge des automatisations basées sur les données des capteurs Xsense.
  • Prise en charge des types d'appareils suivants : stations de base, détecteurs de fumée, détecteurs de monoxyde de carbone, capteurs de chaleur, détecteurs de fuite d'eau et hygromètres.
  • Installation simple via HACS (Home Assistant Community Store).

Conditions préalables

  • Un serveur Home Assistant fonctionnel (la dernière version est recommandée).
  • Un compte Xsense avec des appareils pris en charge.
  • HACS doit être installé dans Home Assistant pour permettre l'installation de l'intégration.

Tutoriel vidéo

Pour un guide détaillé sur l'installation et la configuration de l'intégration, vous pouvez regarder la vidéo suivante :

X-Sense Home Assistant Integration


Préparation

Avant d'installer l'intégration, certaines préparations sont nécessaires :

  • Créez un deuxième compte dans l'application X-Sense (pour l'utilisation avec Home Assistant) : Comme il est impossible d'être connecté simultanément à l'application et à Home Assistant avec le même compte, nous vous recommandons d'utiliser un compte distinct pour Home Assistant. Cela évitera que vous soyez constamment déconnecté de l'application ou de Home Assistant. Le deuxième compte permet une utilisation fluide et continue sans interruptions dues à des connexions et déconnexions répétées.

  • Partagez les appareils pris en charge du compte principal avec le compte Home Assistant : Utilisez l'application X-Sense pour partager uniquement les appareils pris en charge avec le compte nouvellement créé. Ainsi, vous pourrez facilement utiliser l'intégration dans Home Assistant tout en continuant à gérer les appareils via votre compte principal.

image


Installation via HACS

  1. Ouvrir HACS dans Home Assistant : HACS est une extension importante pour Home Assistant qui vous permet d'installer facilement des intégrations personnalisées.

    Download (1)

  2. Accéder aux dépôts personnalisés : Accédez au tableau de bord HACS, allez dans les paramètres et ajoutez le dépôt en tant que source personnalisée.

  3. Ajouter le dépôt : Entrez l'URL du dépôt : https://github.com/Jarnsen/ha-xsense-component_test

    image

  4. Télécharger et installer l'intégration : Recherchez l'intégration dans HACS, téléchargez-la et installez-la. Après l'installation, la configuration peut être effectuée via l'interface de Home Assistant.

    image

    image


Configuration

Après l'installation, une configuration de base est nécessaire pour configurer correctement l'intégration :

  • Nom d'utilisateur et mot de passe : Utilisez les identifiants du compte X-Sense nouvellement créé pour établir la connexion.

    image

  • Aperçu des appareils : Une fois configurés avec succès, les appareils partagés seront disponibles dans Home Assistant et pourront être utilisés pour les automatisations.

    image

Affichage dans Home Assistant

Après une installation et une configuration réussies, l'intégration sera visible dans Home Assistant. Les appareils seront disponibles sur le tableau de bord et pourront être utilisés pour les automatisations, les notifications et d'autres applications.

Форум


Appareils pris en charge

Cette intégration est compatible avec divers appareils Xsense. Voici une liste des appareils confirmés et testés :

  • Station de base (SBS50) : Hub central pour les appareils Xsense.
  • Capteur de chaleur (XH02-M) : Détection de températures anormalement élevées.
  • Détecteur de monoxyde de carbone (XC01-M; XC04-WX) : Détecte les concentrations dangereuses de monoxyde de carbone.
  • Détecteur de fumée (XS01-M, WX; XS03-WX; XS0B-MR) : Détection précoce de fumée.
  • Détecteur combiné de monoxyde de carbone et de fumée (SC07-WX; XP0A-MR (partiellement pris en charge)) : Détecte à la fois le monoxyde de carbone et la fumée.
  • Détecteur de fuite d'eau (SWS51) : Détecte la présence d'eau dans des endroits indésirables.
  • Hygromètre-thermomètre (STH51) : Surveillance de la température et de l'humidité.

Ces appareils, une fois intégrés dans Home Assistant, peuvent être utilisés pour les automatisations et les alertes.


Exemples d'automatisations

Avec cette intégration, vous pouvez créer différentes automatisations. Voici quelques exemples :

Exemple 1 : Alerte de température

Lorsque la température d'un thermomètre Xsense est trop élevée, une notification est envoyée :

automation:
  - alias: "Alerte de température Xsense"
    trigger:
      platform: numeric_state
      entity_id: sensor.xsense_temperature
      above: 30
    action:
      service: notify.notify
      data:
        message: "La température dépasse 30 degrés !"

Exemple 2 : Alarme de détecteur de fuite d'eau

Lorsque le détecteur de fuite d'eau détecte la présence d'eau, une alerte est déclenchée :

automation:
  - alias: "Alarme de détecteur de fuite d'eau"
    trigger:
      platform: state
      entity_id: binary_sensor.xsense_waterleak
      to: "on"
    action:
      service: notify.notify
      data:
        message: "Une fuite d'eau a été détectée !"

Nous avons besoin de votre aide

Nous sommes toujours à la recherche de soutien pour continuer à développer et améliorer cette intégration. Voici quelques façons dont vous pouvez aider :

  1. Tester des appareils : Si vous possédez un appareil Xsense qui fonctionne avec l'intégration, faites-le nous savoir afin que nous puissions l'ajouter à la liste des appareils pris en charge.

  2. Retour sur les appareils non pris en charge : Si un appareil ne fonctionne pas, faites-le nous savoir afin que nous puissions fournir un support ou intégrer l'appareil dans les futures versions de l'intégration.

  3. Partage de dispositifs pour les tests : Le meilleur moyen de tester de nouveaux appareils est de partager l'appareil via l'application X-Sense. Cela nous aidera à assurer la compatibilité d'un maximum d'appareils.

  4. Support communautaire : Participez aux discussions dans notre communauté. Que vous ayez des suggestions d'amélioration ou que vous aidiez d'autres utilisateurs à installer l'intégration, chaque aide est la bienvenue !

Pour des discussions et du support, vous pouvez nous rejoindre sur notre serveur Discord ou sur le forum Home Assistant :

Discord

Forum

Discord

Forum