Intégration domotique PowerView, gratuite et open source

Stores motorisés Hunter Douglas / Luxaflex PowerView, en local : position, lamelles, scènes.

• Publiée par guim31
• Appareils
• Version 1.0.1
• Nécessite Gladys >=5.1.0
• ★ 0

Voir sur GitHubToutes les intégrations

Pilotez vos stores motorisés Hunter Douglas / Luxaflex PowerView depuis Gladys, en local, par votre hub PowerView : ouvrir, fermer, arrêter, régler une position, orienter les lamelles, suivre les batteries et lancer les scènes enregistrées dans l'application PowerView. Ni compte cloud, ni connexion Internet : Gladys parle au hub sur votre réseau, comme le fait l'application PowerView.

Développée sans le matériel : vos retours sont les bienvenus. L'intégration a été écrite d'après l'API PowerView publiée et les vraies réponses de hubs utilisées par les tests de l'intégration Home Assistant, sans hub sous la main. Si quelque chose ne se comporte pas comme décrit, ouvrez une issue sur GitHub en précisant la génération du hub et le modèle du store.

Cette intégration n'est ni affiliée à Hunter Douglas ou Luxaflex, ni approuvée par eux. PowerView est une marque de Hunter Douglas.

Ce qu'il vous faut

• Un hub PowerView : le hub de génération 2 (rond, appelé « PowerView Hub »), ou une passerelle de génération 3 (PowerView Gen 3, « Pro » ou « Gateway »). L'ancien hub de génération 1 fonctionne aussi, sans la commande d'arrêt.
• Des stores déjà appairés au hub dans l'application PowerView. Les pièces et les scènes se créent aussi dans l'application : Gladys les lit.
• Gladys 5.1 ou plus récent, sur le même réseau que le hub. Le hub ne demande aucun mot de passe : son API locale est ouverte au réseau de la maison.

Configuration

1. Installez l'intégration depuis Intégrations → Installer depuis GitHub, ou depuis le store.
2. Ouvrez son onglet Configuration. Les hubs du même réseau que Gladys sont trouvés automatiquement (mDNS). S'il manque le vôtre, saisissez son adresse IP dans Adresses IP des hubs (plusieurs adresses séparées par des virgules). Pour une maison de génération 3 à plusieurs passerelles, la passerelle principale suffit : les autres ne font que relayer la radio.
3. Choisissez la langue des noms de fonctionnalités (le français par défaut) : Gladys garde un nom une fois l'appareil ajouté.
4. Laissez l'intervalle de rafraîchissement à 60 secondes sauf raison particulière : c'est la fréquence de lecture des positions sur le hub (de 30 à 600 secondes).
5. Ouvrez l'onglet Découverte : chaque store et chaque scène PowerView y figure. Ajoutez ceux que vous voulez.

Donnez au hub une adresse IP fixe dans votre box : si son adresse change, l'intégration le recherche par mDNS, mais une adresse fixe reste le plus sûr.

Ce que fait chaque appareil

Stores

Chaque store est un appareil de la catégorie Volet (ou Rideau pour les stores qui se déplacent sur le côté : panneaux Skyline, rideaux, bandes verticales) :

• Ouvrir / fermer : les boutons ouvrir, arrêter et fermer de Gladys. Le store s'affiche ouvert dès qu'il est en partie ouvert, fermé une fois complètement descendu.
• Position : 0 % est fermé, 100 % est ouvert. Pour un store qui descend du haut (top-down), 100 % reste « ouvert » : l'intégration inverse la valeur pour vous.

Après une commande, Gladys affiche aussitôt la position visée ; l'intégration demande ensuite au store où il en est réellement, une fois son moteur arrêté (environ 40 secondes pour une course complète).

Lamelles

Les stores à lamelles (Silhouette, Pirouette, Twist, stores vénitiens, bandes verticales, volets Palm Beach…) ont un second curseur, Inclinaison des lamelles, de 0 à 100 % :

• lamelles qui tournent de 90° (Silhouette, Pirouette) : 0 % fermé, 100 % ouvert ;
• lamelles qui tournent de 180° (vénitiens, Twist, bandes verticales, volets) : 50 % est ouvert (à plat), 0 % et 100 % sont fermés dans un sens ou dans l'autre.

Certains stores n'orientent leurs lamelles qu'une fois complètement fermés (Silhouette, Pirouette) : le hub s'en charge. Les stores à lamelles seules (Palm Beach, Everwood) n'ont pas de curseur de position : ouvrir et fermer orientent les lamelles.

Stores à deux rails et stores doubles

• Stores haut-bas / bas-haut (Duette TDBU) : Position du rail bas (100 % = rail bas en haut) et Position du rail haut (100 % = rail haut en bas). Un rail ne croise jamais l'autre : l'intégration l'arrête contre l'autre.
• Stores doubles (Duolite, Vignette Duolite, Silhouette Duolite : un voilage devant et un occultant derrière, sur un seul moteur) : Position combinée (0-50 % l'occultant, 51-100 % le voilage, ouvert à 100 %), plus Position du voilage (avant) et Position de l'occultant (arrière). Le voilage ne s'ouvre qu'une fois l'occultant complètement remonté.

Batterie

Les stores sur batteries (ou baguettes rechargeables) ont Batterie (%) et Batterie faible (oui à 20 % ou moins, pratique pour déclencher un rappel). Un hub de génération 2 indique la tension du bloc, une passerelle de génération 3 un niveau en quatre paliers (100, 50, 20 et 0 %). Les stores alimentés sur secteur n'ont pas de fonctionnalité batterie.

Scènes PowerView

Chaque scène de l'application PowerView est un appareil nommé « scène (scène PowerView) », avec un bouton Lancer la scène. Ajoutez celles que vous utilisez : elles se placent sur un tableau de bord et s'utilisent dans les scènes Gladys.

Actions

Dans l'onglet Configuration :

• Rechercher les hubs : recherche à nouveau les hubs (après l'ajout d'un store ou d'une scène dans l'application PowerView, par exemple) et indique ce que chacun a : génération, adresse, nombre de stores et de scènes. Une passerelle secondaire de génération 3, une adresse qui ne répond pas, une adresse mal saisie sont signalées aussi.
• Identifier un store : choisissez un store, il monte et descend un peu pour savoir de quelle fenêtre il s'agit.

Scènes

L'intégration ajoute l'action Lancer une scène PowerView à l'éditeur de scènes (catégorie Intégrations). Choisissez la scène parmi vos appareils (ceux nommés « (scène PowerView) ») ; l'action renvoie Stores déplacés, le nombre de stores que le hub fait bouger, pour les actions suivantes.

Les stores eux-mêmes sont des appareils Gladys ordinaires : l'action Contrôler un appareil ouvre, ferme ou règle une position, et le déclencheur Changement d'état de l'appareil réagit à une position ou à une batterie faible.

Exemples :

• Réveil en douceur : à 7 h 30 en semaine, mettre le store de la chambre à 30 %, puis à 100 % un quart d'heure plus tard.
• Après-midi d'été : quand la température extérieure dépasse 28 °C, lancer la scène PowerView « Fermer Sud » ; rouvrir les stores au coucher du soleil.
• Rappel de batterie : quand Batterie faible d'un store passe à oui, vous envoyer un message pour le recharger.

Tableau de bord

Pas de widget dédié : les stores et les scènes sont des appareils, et la boîte Appareils de Gladys les affiche avec leurs boutons et leurs curseurs.

Rafraîchissement et charge du hub

• À chaque intervalle de rafraîchissement (60 secondes par défaut), l'intégration lit la liste des stores de chaque hub qui a au moins un store ajouté à Gladys. Le hub répond de mémoire : les stores ne sont pas réveillés, leurs batteries sont épargnées.
• Les stores alimentés sur secteur sont aussi interrogés par radio sur leur position réelle, toutes les 10 minutes, un store à la fois (comme Home Assistant). Les stores sur batteries ne sont jamais interrogés à intervalle régulier : cela les viderait en quelques jours. Un store sur batteries manœuvré avec une télécommande n'affiche donc sa nouvelle position qu'une fois que le hub l'apprend (une passerelle de génération 3 entend en général ses stores, un hub de génération 2 souvent pas).
• Après une commande, le store est interrogé une fois son moteur arrêté.
• Les opérations radio (mouvements, arrêts, scènes) partent une à la fois par hub : les hubs sont connus pour planter quand ils en reçoivent plusieurs à la fois.

L'API PowerView n'a pas de quota publié ; ces rythmes sont ceux que Home Assistant utilise depuis des années.

Dépannage

• Aucun hub trouvé : vérifiez que Gladys et le hub sont sur le même réseau (même sous-réseau), puis saisissez l'adresse IP du hub dans la configuration et lancez Rechercher les hubs. Certaines box filtrent le mDNS entre le Wi-Fi et le réseau filaire.
• L'état indique que le hub ne répond pas : un hub de génération 2 redémarre chaque nuit pendant quelques minutes ; l'intégration l'attend en silence. Si cela dure, débranchez et rebranchez le hub.
• Une position ne suit pas la télécommande : voir « Rafraîchissement et charge du hub » ci-dessus. Ouvrir une fois le store depuis Gladys le resynchronise.
• Un nouveau store ou une nouvelle scène manque : lancez Rechercher les hubs, puis ouvrez l'onglet Découverte.
• Plus de détails : l'intégration ne journalise que son cycle de vie (démarrage, hubs trouvés, perdus et revenus, une ligne par commande). Réglez LOG_LEVEL=debug sur le conteneur pour tout voir.

Limites

• Développée sans le matériel : les réponses des hubs viennent des tests de Home Assistant. Vos retours sont les bienvenus.
• La lumière intégrée des stores éclairants Aura n'est pas pilotée.
• Les programmations PowerView (automatisations) restent dans l'application PowerView.
• Gladys n'a pas de fonctionnalité « inclinaison » : les lamelles sont un second curseur de position, et les assistants vocaux ne voient que la position principale.
• Le hub de génération 1 ne sait pas arrêter un store.
• Les passerelles de génération 3 s'annoncent en _PowerView-G3._tcp, alors que Gladys ne peut chercher que _powerview-g3._tcp (en minuscules) : elles risquent de ne pas être trouvées automatiquement. Saisissez alors l'adresse IP de la passerelle.
• Gladys garde les noms et les fonctionnalités d'un appareil une fois ajouté : un store réappairé dans l'application PowerView reçoit un nouvel identifiant, donc un nouvel appareil.

Paramètres de configuration

Voici les paramètres demandés par PowerView dans son écran de configuration dans Gladys.

Paramètre	Type	Obligatoire	Description
Trouver votre hub	section	Non	Les hubs PowerView (génération 2) et passerelles (génération 3) du même réseau que Gladys sont trouvés automatiquement : ouvrez l'onglet Découverte. S'il manque le vôtre, saisissez son adresse IP ci-dessous (visible dans votre box, ou dans l'application PowerView).
Adresses IP des hubs	string	Non	Facultatif, séparées par des virgules. Seulement pour les hubs que la découverte automatique ne trouve pas. Pour une maison de génération 3 à plusieurs passerelles, la passerelle principale suffit.
Intervalle de rafraîchissement (secondes)	number	Non	Fréquence de lecture des positions des stores sur le hub, de 30 à 600 secondes. Le hub répond de mémoire sans réveiller les stores : leurs batteries sont épargnées.
Langue des noms de fonctionnalités	select	Non	Utilisée pour les noms des appareils ajoutés à partir de maintenant (Gladys garde un nom une fois l'appareil ajouté).

Comment installer PowerView dans Gladys

1. Dans Gladys, ouvrez Intégrations : PowerView 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/guim31/gladys-powerview:1.0.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/guim31/gladys-powerview.

PowerView 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

PowerView 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 guim31, et non par l'équipe cœur de Gladys.

• Parcourir toutes les intégrations, natives et communautaires
• Créer et publier votre propre intégration externe
• Code source sur GitHub — source de cette documentation

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 🙂