Bonjour à tous,
Je vous présente mon nouveau intégration externe free@home pour Gladys Assistant.
Cela permet d’intégrer des appareils du système free@home de Busch-Jaeger / ABB dans Gladys : allumer et éteindre les lumières, contrôler les stores, et utiliser les boutons muraux existants comme déclencheurs pour les scènes Gladys.
La première version stable 1.0.0 est publiée. La communication avec le System Access Point se fait exclusivement localement, sans connexion cloud et sans XMPP.
GitHub et installation :
Que peut faire l’intégration ?
Lumière et sorties de commutation
- Allumer et éteindre les lumières.
- Régler les lumières dimmables à une luminosité spécifique.
- Allumer et éteindre d’autres consommateurs sur des actionneurs de commutation pris en charge – il n’est donc pas nécessaire d’avoir une lampe connectée.
- Afficher les retours d’état de free@home dans Gladys.
Stores et jalousies
- Monter et descendre.
- Arrêter un mouvement en cours.
- Régler une position d’ouverture en pourcentage.
- Contrôler l’ouverture des lamelles séparément avec les actionneurs appropriés.
La représentation de la position utilise 0 % fermé et 100 % ouvert. Les lamelles sont également proposées en pourcentage, pas en angle calibré en degrés. Les fonctions disponibles dépendent des points de données que chaque actionneur fournit via l’API locale.
Boutons muraux et panneaux
Les boutons free@home existants peuvent déclencher des scènes Gladys. Cela permet également de contrôler des appareils et des fonctions en dehors de free@home.
Selon la configuration du bouton, des actions d’allumage/extinction, de dimmage ou de store sont par exemple signalées. Même deux actions identiques et successives sont traitées comme des événements séparés.
Important : ce sont les actions de bouton fournies par free@home, pas une interface universelle de données brutes pour les pressions, les relâchements ou les double-clics.
À quoi cela peut-il servir ?
Quelques applications possibles :
- Éteindre les lumières et consommateurs sélectionnés en quittant la maison.
- Positionner les stores via des scènes Gladys à des heures spécifiques.
- Démarrer une scène de soirée ou d’absence avec un bouton mural free@home existant.
- Contrôler des appareils d’autres systèmes déjà intégrés à Gladys avec un bouton.
- Contrôler la lumière et l’ombrage ensemble via le tableau de bord Gladys.
Vous définissez l’automatisation souhaitée dans vos scènes Gladys. L’intégration fournit les appareils et événements de bouton pris en charge à cet effet.
Comment fonctionne la connexion ?
L’intégration se connecte à l’API REST et WebSocket locale officielle du System Access Point :
- REST sert à lire la configuration et à envoyer des commandes de contrôle.
- WebSocket fournit les changements d’état en cours et les événements de bouton.
Pour la communication locale, aucun Gladys Plus n’est requis. L’interface et la documentation sont disponibles en allemand, anglais et français.
Testé et notes importantes
Avec du matériel réel et firmware SysAP 3.5.3, entre autres, la commutation de lumière, le dimmage avec retour d’état, le positionnement des stores, la montée et l’arrêt ainsi que les événements de bouton répétés en tant que déclencheurs de scène ont été testés.
Toutes les variantes d’appareils ou de firmware ne sont pas couvertes. La commande des lamelles, la commande de descente séparée et l’autre côté du bouton testé ne sont pour l’instant que simulés. Les fonctions de chauffage, d’autres classes de capteurs et les scènes free@home existantes ne font pas encore partie de la portée prise en charge.
De plus, il convient de noter :
- Certains actionneurs ne signalent leur position de store qu’à la fin d’un déplacement.
- Pendant une interruption de connexion, les événements de bouton manqués ne sont pas rattrapés.
- Les commandes de contrôle ne sont pas répétées automatiquement en cas d’erreur. En cas de timeout, vérifiez d’abord l’état réel de l’appareil.
- Ne pas exposer l’API du contrôleur à Internet. HTTPS avec un certificat de confiance est préférable ; HTTP transmet les données d’accès API en clair.
Je me réjouis des retours et des expériences – en particulier concernant d’autres actionneurs, boutons et versions de firmware free@home. Ainsi, nous pouvons développer ensemble l’intégration.