Aller au contenu principal

Intégration domotique Fibaro / Yubii Home, gratuite et open source

Intégration Fibaro / Yubii Home pour Gladys Assistant

Votre Fibaro Home Center 2, HC3 ou Yubii Home dans Gladys : lumières, volets, capteurs…

Voir sur GitHubToutes les intégrations

Cette intégration relie Gladys à votre Fibaro Home Center 2, Home Center Lite, Home Center 3, HC3 Lite ou Nice Yubii Home et propose les appareils de la box dans l'onglet Découverte de Gladys : interrupteurs, variateurs, modules RGBW, volets roulants, thermostats, serrures et capteurs. Une fois un appareil ajouté, ses états suivent la box en direct, et Gladys le pilote à travers la box, qui continue de tourner : votre réseau Z-Wave, vos scènes Fibaro et votre application Yubii restent tels quels. Les télécommandes et boutons poussoirs deviennent des déclencheurs de scène, et une action de scène lance une scène Fibaro. Non officiel, sans lien avec Fibaro ou Nice.

Version de développement (0.1). Écrite d'après la documentation de l'API et des exports de vraies box, pas encore testée sur un vrai Home Center ou une vraie Yubii Home. Vos retours sont les bienvenus sur le dépôt GitHub.

Mise en route​

  1. Trouvez l'adresse IP de la box (dans son interface web, ou dans votre box internet). Donnez-lui une adresse fixe dans votre box internet.
  2. Dans Gladys, ouvrez Intégrations → Fibaro / Yubii Home → Configuration et saisissez :
    • l'adresse : http://192.168.1.50 (une adresse IP seule vaut http://). Un HC3 ou une Yubii Home en HTTPS uniquement : https://…, et désactivez Vérifier le certificat TLS (leur certificat est auto-signé) ;
    • le nom d'utilisateur et le mot de passe de connexion à la box (admin sur un Home Center 2, souvent une adresse e-mail sur un HC3 ou une Yubii Home). Un compte administrateur voit tous les appareils ; un compte utilisateur seulement ceux qui lui ont été attribués.
  3. Cliquez sur Tester la connexion : le modèle, son firmware et le nombre d'appareils proposés s'affichent sous le bouton.
  4. Ouvrez l'onglet Découverte et ajoutez les appareils voulus.

Ce que vous obtenez​

Dans la boxDans Gladys
Relais, prise murale (interrupteur)un interrupteur, avec sa puissance et son énergie quand il les mesure
Variateur (Dimmer 2, Walli Dimmer…)une lumière (marche/arrêt, luminosité) s'il pilote une lampe, sinon un variateur
Module RGBWune lumière : marche/arrêt, luminosité, couleur
Volet roulant (Roller Shutter 2/3, Walli Roller Shutter)un volet : position, ouvrir, fermer, stop
Volet sans positionouvrir, fermer, stop
Tête thermostatique, thermostat, climatisationun thermostat : consigne, mode (arrêt, chauffage, froid, auto), état de chauffe
Serrureune serrure
Capteur d'ouverture, de mouvement, d'inondation, de fumée, de COle capteur Gladys correspondant
Capteurs de température, luminosité, humidité, puissance, énergiele capteur Gladys correspondant
Niveau de pileune fonctionnalité batterie
Télécommande, bouton poussoir, entrées S1/S2 avec activation de scèneun bouton par touche, et le déclencheur « Télécommande ou bouton Fibaro »

Chaque appareil porte le nom de sa pièce, comme dans la box : Prise murale (Salon). Écartés : les appareils désactivés et masqués, les utilisateurs et téléphones de la box, et les appareils des plugins (HC2) et Quick Apps (HC3), sauf si vous activez Proposer aussi les plugins et Quick Apps.

Un appareil que la box signale comme mort (il ne répond plus : pile, portée, alimentation) garde un badge avec un point orange dans Gladys jusqu'à ce qu'il réponde à nouveau.

Télécommandes et boutons dans les scènes​

Une touche d'une télécommande (KeyFob), d'un bouton poussoir (The Button) ou l'entrée S1/S2 d'un interrupteur, variateur ou module volet Fibaro avec l'activation de scène envoie un événement de scène centrale. Deux façons de s'en servir :

  • la fonctionnalité bouton de l'appareil (une par touche) change à chaque appui : « clic », « double clic », « triple clic », « maintenu », « relâché » ;
  • le déclencheur de scène Télécommande ou bouton Fibaro : choisissez la télécommande, le numéro de la touche et le geste. Ses variables donnent la touche, le geste et l'attribut envoyé par la box (Pressed, Pressed2, HeldDown, Released…).

Les touches S1/S2 n'envoient d'événements que si l'activation de scène est activée dans les paramètres du module (paramètre 28 d'un Dimmer 2 ; voir le manuel des autres).

Lancer une scène Fibaro​

Cliquez sur Lister les scènes Fibaro dans la configuration : le numéro de chaque scène visible s'affiche sous le bouton. Dans une scène Gladys, ajoutez l'action Lancer une scène Fibaro et saisissez le numéro. Les scènes protégées par un code PIN ne peuvent pas être lancées ainsi.

Bon à savoir​

  • Temps réel : Gladys garde une requête ouverte avec la box (/api/refreshStates), qui répond dès que quelque chose change.
  • Mesures : une prise murale peut remonter sa puissance toutes les quelques secondes. Gladys garde la dernière mesure toutes les Intervalle minimum entre deux mesures d'un capteur (10 s par défaut) ; interrupteurs, boutons et détecteurs d'ouverture ou de mouvement ne sont jamais retardés.
  • Changements dans la box (un appareil ajouté, renommé, déplacé) : Gladys relit la liste en quelques secondes ; cliquez sur Scanner dans Découverte pour forcer.
  • La box bloque une adresse après plusieurs échecs de connexion : après une erreur de mot de passe, Gladys ne réessaie que toutes les 5 minutes.

Dépannage​

  • « a refusé le nom d'utilisateur ou le mot de passe » : saisissez-les à nouveau ; essayez-les dans l'interface web de la box.
  • « certificate refused » : désactivez Vérifier le certificat TLS, ou utilisez http://.
  • « injoignable » : utilisez l'adresse IP de la box sur le réseau local (pas localhost, pas une adresse d'accès à distance), et vérifiez que la machine Gladys la joint.
  • Un appareil manque : est-il activé et visible dans la box ? Est-ce un plugin ou une Quick App (activez l'option) ? Cliquez sur Tester la connexion : le message compte les appareils écartés et pourquoi.

Paramètres de configuration​

Voici les paramètres demandés par Fibaro / Yubii Home dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Votre box Fibaro ou Yubii dans GladyssectionNonPour un Fibaro Home Center 2, Home Center Lite, Home Center 3, HC3 Lite ou une Nice Yubii Home : chaque appareil activé et visible de la box est proposé dans l'onglet Découverte (interrupteurs, variateurs, modules RGBW, volets, thermostats, serrures, capteurs d'ouverture, de mouvement, d'inondation et de fumée, température, luminosité, humidité, consommation, batterie) et les télécommandes et boutons poussoirs deviennent des déclencheurs de scène. Les états suivent la box en direct et Gladys pilote les appareils à travers elle, qui continue de tourner. Saisissez l'adresse de la box vue depuis la machine Gladys (son adresse IP sur le réseau local) et le compte avec lequel vous vous y connectez. Non officiel, sans lien avec Fibaro ou Nice.
Adresse de la boxstringOuiSon adresse IP sur votre réseau local : http://192.168.1.50, ou https://192.168.1.50 pour un HC3 ou une Yubii Home en HTTPS. Une adresse IP seule vaut http://.
Nom d'utilisateurstringOuiLe compte de connexion à l'interface web de la box (admin, ou une adresse e-mail sur un HC3 ou une Yubii Home). Un administrateur voit tous les appareils.
Mot de passesecretOuiLe mot de passe de ce compte.
Vérifier le certificat TLS (https)booleanNonLe HC3 et la Yubii Home ont un certificat auto-signé : désactivez cette option pour les utiliser en https:// sur votre réseau local.
Proposer aussi les plugins et Quick AppsbooleanNonDésactivé : seulement les appareils physiques (Z-Wave, Zigbee, Nice). Activé : aussi les appareils des plugins (HC2) et des Quick Apps (HC3).
Intervalle minimum entre deux mesures d'un capteur (s)numberNonUne prise remonte sa consommation toutes les quelques secondes : Gladys garde la dernière mesure à ce rythme. Interrupteurs, lumières, boutons, détecteurs de mouvement et d'ouverture ne sont jamais retardés.

Comment installer Fibaro / Yubii Home dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Fibaro / Yubii Home apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-fibaro:0.1.1), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-fibaro.

Fibaro / Yubii Home nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.

Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.

À propos des intégrations externes​

Fibaro / Yubii Home est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par LM1LC3N7, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le