Intégration domotique Lutron, gratuite et open source

Lutron Caséta, RA2 Select, RadioRA 3, HomeWorks QSX, 100 % local : lumières, stores, Pico.

• Publiée par LM1LC3N7
• Appareils
• Version 0.1.2
• Nécessite Gladys >=5.1.1
• ★ 0

Voir sur GitHubToutes les intégrations

Pilotez vos lumières, stores et ventilateurs Lutron depuis Gladys, et utilisez vos télécommandes Pico et vos claviers dans les scènes Gladys. Tout fonctionne sur votre réseau local, avec le protocole LEAP de Lutron : aucun compte Lutron, aucun cloud, aucune connexion Internet nécessaire à l'intégration.

Première version, en test. Tout ce qui suit est développé et testé sur des bridges simulés ; la vérification sur du vrai matériel est en cours (Caséta d'abord). Signalez toute anomalie avec le bouton Diagnostic. Les évolutions sont listées dans le journal des modifications.

Systèmes compatibles

Système	État
Caséta Smart Hub (L-BDG2, vendu dans les kits de départ)	compatible
Caséta Smart Bridge PRO (L-BDGPRO2)	compatible
RA2 Select (RR-SEL-REP2)	compatible
RadioRA 3, HomeWorks QSX	compatible, testeurs recherchés
Ancien Smart Bridge (L-BDG, avant LEAP)	non compatible
RadioRA 2, HomeWorks QS (telnet)	non compatible

Appareils : variateurs (Caséta, Diva, Sunnata, à brancher, en ligne), interrupteurs et modules à brancher, relais, stores, rideaux et stores à lames, commandes de ventilateur, détecteurs de présence, télécommandes Pico ; sur RadioRA 3 et HomeWorks QSX aussi les claviers et leurs voyants, les lumières à blanc réglable et en couleur (Ketra, Lumaris).

Ce qui reste local, ce qui ne l'est pas

• Gladys ↔ bridge : 100 % local. L'association, la découverte, le pilotage et les événements passent directement de Gladys au bridge sur votre réseau. Ils continuent de fonctionner sans Internet.
• L'ajout d'appareils au bridge se fait une fois dans l'application Lutron, qui demande un compte Lutron. C'est l'installation propre à Lutron, en dehors de Gladys. Ensuite, l'intégration n'a plus jamais besoin ni de l'application ni d'Internet. Une télécommande Pico peut aussi être associée directement à un variateur, sans application.

Installation

1. Branchez le bridge sur votre box avec son câble réseau et ajoutez-y vos appareils dans l'application Lutron.
2. Donnez au bridge une adresse IP fixe (réservation DHCP dans votre box) pour que Gladys le retrouve toujours.
3. Dans Gladys, installez l'intégration Lutron et ouvrez sa configuration.
4. Laissez l'adresse IP vide (le bridge est cherché sur votre réseau) ou saisissez-la, puis cliquez sur Associer le bridge.
5. Dans les 60 secondes, appuyez sur le petit bouton noir au dos du bridge. L'état passe à « Connecté ».
6. Ouvrez l'onglet Découverte et créez les appareils voulus.

Si la recherche ne trouve rien, saisissez l'adresse IP : certains réseaux (VLAN, Wi-Fi maillé, installations Docker) bloquent les annonces de découverte, pas la connexion elle-même.

Appareils

Chaque appareil Lutron devient un appareil Gladys nommé d'après sa pièce Lutron (« Salon Plafonnier »), prêt à ranger dans la pièce Gladys correspondante :

Lutron	Dans Gladys
Variateur (Diva, Caséta, Sunnata…)	Lumière : marche/arrêt et luminosité
Lumière à blanc réglable ou couleur	Lumière : aussi température de couleur (K), couleur et un interrupteur « Warm dim »
Interrupteur, module à brancher, relais	Interrupteur : marche/arrêt
Commande de ventilateur	Ventilateur : vitesse en % (0 arrêt, 25 lent, 50 moyen, 75 moyen-rapide, 100 rapide)
Store, store enrouleur, store plissé	Volet : ouvrir / fermer / stop et position
Rideau	Rideau : ouvrir / fermer / stop et position
Store vénitien en bois (lames seules)	Volet : la position oriente les lames (50 = ouvertes, 0 = fermées)
Détecteurs de présence d'une pièce	Présence : occupée / libre
Scène Lutron (Caséta)	Bouton « Activer »
Bridge	Interrupteur « Smart Away »
Clavier (RadioRA 3, QSX)	Un bouton par touche (sa gravure) et un interrupteur par voyant
Store ou détecteur à piles	« Pile faible » (Lutron indique seulement bonne ou faible)

« Marche » rallume une lumière à son dernier niveau. Les états suivent le bridge en temps réel, et sont relus toutes les 15 minutes et après chaque reconnexion. Le badge de l'appareil indique « local », ou « injoignable » quand le bridge ne répond plus depuis 2 minutes.

Télécommandes Pico

Chaque Pico devient un appareil Gladys avec un bouton par bouton physique (On, Off, Monter, Descendre, Favori…). Dans une scène, utilisez le déclencheur « Changement d'état de l'appareil », choisissez le bouton et le type d'appui.

L'option Boutons des télécommandes Pico règle la détection des appuis :

• Instantané : un clic est signalé dès l'appui, sans aucun délai. Les doubles clics et appuis longs ne sont pas détectés.
• Normal (par défaut) : clic, double clic et appui long sont détectés. Un clic simple est signalé environ 0,3 s plus tard, le temps de vérifier qu'aucun second appui ne suit.
• Lent : comme Normal, avec des délais plus larges (0,45 s pour un double clic, 0,75 s pour un appui long), pour ceux qui appuient lentement.

Exemples avec le déclencheur « Changement d'état de l'appareil » sur un bouton de Pico :

Bouton et type d'appui	Scène
« On », Clic	allumer les lumières du salon
« On », Double clic	lancer la scène « Cinéma »
« Off », Appui long	éteindre toutes les lumières de la maison
« Raise », Appui long puis Appui long relâché	démarrer, puis arrêter, une variation

Les boutons Raise et Lower (monter, descendre) répètent tant qu'on les tient : leur appui long est détecté 0,25 s plus tard que les autres boutons, pour qu'un appui court reste un clic. Deux clics identiques à la suite sont deux événements : chacun lance la scène. La Pico n'indique pas le niveau de sa pile (Lutron ne le transmet pas). Les noms des boutons restent en anglais (On, Off, Favorite, Raise, Lower…), comme sur la télécommande.

Claviers (RadioRA 3, HomeWorks QSX)

Chaque clavier devient un appareil Gladys : ses touches sont des boutons comme ceux des Pico (nommés d'après leur gravure), et chaque voyant un interrupteur. Une touche lance sa programmation Lutron comme d'habitude ; Gladys voit l'appui. Un voyant suit la programmation du clavier : Lutron peut le rebasculer juste après un changement fait par Gladys (un voyant suit sa scène ou ses zones).

• Action « Lutron : appuyer sur un bouton de clavier » (clavier, gravure ou numéro) : appuie sur une touche comme un doigt, ce qui lance sa programmation Lutron. Un bridge Caséta ne sait pas le faire avec une Pico : pilotez directement la lumière ou la scène.
• Déclencheur « Lutron : scène de pièce activée » : quand la scène d'une pièce change (clavier, application, horloge), avec les noms de la pièce et de la scène en variables et en filtres facultatifs. Pas déclenché pour une touche appuyée par Gladys elle-même.

Scènes

Les appareils Lutron s'utilisent avec les blocs de scène habituels de Gladys : « Changement d'état de l'appareil » comme déclencheur (appuis sur les Pico, présence, Smart Away, pile faible), « Contrôler un appareil » comme action (lumières, stores, ventilateurs, scènes Lutron). L'intégration n'ajoute que ce que ces blocs ne savent pas faire :

• action « Lutron : régler un niveau avec fondu » : un variateur atteint un niveau en un temps choisi, jusqu'à 4 heures (un réveil progressif, une baisse lente pour un film) ; 0 l'éteint ;
• action « Lutron : orienter les lames » : les lames d'un store qui a montée et inclinaison (Gladys n'a pas de réglage d'inclinaison) ;
• déclencheurs « Lutron : bridge hors ligne » (pas de réponse depuis 2 minutes : coupure de courant, réseau, réinitialisation ; variable « Raison ») et « Lutron : bridge de retour en ligne » (variable « Durée hors ligne »).

La durée de fondu par défaut (configuration) s'applique à chaque niveau envoyé par Gladys à un variateur ; 0 garde le fondu propre au variateur.

Widget du tableau de bord

Le widget Aperçu Lutron montre ce que les boîtes d'appareils ne montrent pas : le bridge et sa connexion, Smart Away, le nombre d'appareils, les pièces occupées, les piles faibles et les derniers appuis sur les Pico (télécommande, bouton, type d'appui, heure). Ses boutons activent ou arrêtent Smart Away, et reconnectent le bridge quand il est hors ligne. Pour piloter les lumières d'une pièce, utilisez la boîte pièce de Gladys.

Bon à savoir

• La présence est indiquée par pièce (tous ses détecteurs ensemble) ; le délai avant « libre » se règle sur le détecteur lui-même.
• Lutron ne publie pas LEAP : une mise à jour du bridge peut le modifier. Signalez tout problème avec le bouton Diagnostic.
• Les événements natifs « maintien » et « multi-appui » dépendent du système (programmations RadioRA 3 et HomeWorks) : sur Caséta, l'intégration détecte elle-même doubles clics et appuis longs.
• L'association peut échouer sur un réseau en « jumbo frames » : associez depuis un réseau standard.

Options

• Boutons des télécommandes Pico : la détection des appuis (voir « Télécommandes Pico »).
• Durée de fondu par défaut : voir « Scènes ».
• Masquer de l'onglet Découverte : les types d'appareils que vous ne voulez pas créer dans Gladys (Pico utilisées seulement avec Lutron, scènes, Smart Away…). Les appareils déjà créés continuent de fonctionner.

Un seul bridge par Gladys pour l'instant.

Sécurité

Le bridge n'accepte Gladys qu'après l'appui sur son bouton. Le certificat qu'il signe est conservé dans la configuration de Gladys (incluse dans les sauvegardes Gladys, jamais affichée dans l'interface), et chaque connexion vérifie le certificat du bridge : une autre machine ne peut pas se faire passer pour votre bridge.

Dépannage

• « Bouton non pressé à temps » : cliquez à nouveau sur Associer, puis appuyez sur le bouton du bridge dans les 60 secondes.
• « Certificat refusé » : le bridge a été réinitialisé. Cliquez sur Oublier le bridge, puis associez-le à nouveau.
• États qui ne se mettent plus à jour : cliquez sur Tester la connexion ; l'intégration se reconnecte et relit aussi tous les états d'elle-même.
• Pour signaler un problème : voir « Diagnostic » ci-dessous.

Diagnostic

Le bouton Diagnostic lit auprès du bridge la description de votre système Lutron (pièces, appareils, boutons, scènes, niveaux actuels) et l'écrit dans les journaux de l'intégration. Il ne fait que lire : rien n'est modifié sur le bridge.

1. Cliquez sur Diagnostic (quelques secondes, jusqu'à une minute sur une grosse installation).
2. Ouvrez l'onglet Journaux de l'intégration.
3. Copiez toutes les lignes de LUTRON DIAGNOSTICS BEGIN à LUTRON DIAGNOSTICS END et joignez-les à votre signalement.

L'export est anonymisé : les numéros de série sont remplacés par serial-1, serial-2…, les adresses MAC et IP et toute position géographique sont masquées, et aucun certificat ni aucune clé n'y figure jamais. Les noms des pièces et des appareils sont conservés, car ils expliquent votre installation ; renommez-les dans l'export si vous préférez. Quand le bridge n'est pas connecté, seul l'état de la connexion est écrit.

Non affilié à Lutron Electronics. Lutron, Caséta, Pico, RadioRA et HomeWorks sont des marques de Lutron Electronics Co., Inc.

Paramètres de configuration

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

Paramètre	Type	Obligatoire	Description
Bridge Lutron	section	Non	Tout reste sur votre réseau local : aucun compte Lutron, aucun cloud, aucun accès Internet nécessaire. 1. Laissez l'adresse IP vide pour chercher sur le réseau, ou saisissez-la (une IP fixe est préférable). 2. Cliquez sur « Associer le bridge » ci-dessous. 3. Dans les 60 secondes, appuyez sur le petit bouton noir au dos du bridge. Vos appareils doivent déjà être ajoutés au bridge.
Adresse IP du bridge (facultative)	string	Non	Vide : le bridge est cherché sur le réseau lors de l'association, puis son adresse est enregistrée ici.
Options	section	Non
Boutons des télécommandes Pico	select	Non	Instantané : un clic est signalé dès l'appui, sans aucun délai, mais les doubles clics et appuis longs ne sont pas détectés. Normal : clic, double clic et appui long sont détectés ; un clic simple est signalé environ 0,3 s plus tard (le temps de vérifier qu'aucun second appui ne suit). Lent : comme Normal avec des délais plus larges (0,45 s pour un double clic, 0,75 s pour un appui long), pour ceux qui appuient lentement.
Durée de fondu par défaut (s)	number	Non	Temps que met un variateur pour atteindre un nouveau niveau quand Gladys le change. 0 garde le fondu propre à l'appareil.
Masquer de l'onglet Découverte	multi_select	Non	Types d'appareils que vous ne voulez pas créer dans Gladys (par exemple les Pico, si vous ne les utilisez qu'avec Lutron). Les appareils déjà créés continuent de fonctionner.

Comment installer Lutron dans Gladys

1. Dans Gladys, ouvrez Intégrations : Lutron 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-lutron:0.1.2), 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-lutron.

Lutron nécessite Gladys >=5.1.1. 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

Lutron 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.

• 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 🙂