Intégration domotique WLED, gratuite et open source
Contrôleurs de rubans LED WLED en réseau local : couleurs, effets, palettes, préréglages, segments.
Publiée par guim31
- Appareils
- Version 1.1.0
- Nécessite Gladys >=5.1.0
- ★ 0
Pilotez vos rubans LED WLED depuis Gladys, sur votre réseau local : couleur, luminosité, effets, palettes, préréglages et segments, mis à jour en temps réel.
Développée sans le matériel : retours bienvenus. Cette intégration a été construite et testée sur de vraies réponses de contrôleurs WLED, pas sur des rubans physiques. Si quelque chose ne fonctionne pas comme décrit, dites-le sur le forum Gladys ou dans les issues.
Ce qu'il vous faut
- Gladys Assistant 5.1.0 ou plus récent.
- Un contrôleur WLED (ESP8266 ou ESP32) connecté au même réseau que Gladys. WLED 0.14 ou plus récent est conseillé ; 0.13 devrait fonctionner.
Ajouter vos contrôleurs
- Installez l'intégration depuis le catalogue Gladys. L'écran d'installation
demande à laisser Gladys chercher les contrôleurs WLED sur le réseau (mDNS,
_wled._tcp) : acceptez. - Ouvrez l'onglet Découverte : chaque contrôleur trouvé y figure, avec le nom réglé dans WLED. Cliquez sur Ajouter, choisissez une pièce, enregistrez.
- Il manque un contrôleur ? Trouvez son adresse IP dans l'application WLED (Config → WiFi Setup) ou dans votre box, saisissez-la dans Configuration → Adresses IP des contrôleurs (plusieurs adresses séparées par des virgules), enregistrez, puis rouvrez Découverte.
Conseil : donnez à chaque contrôleur une adresse IP fixe dans votre box (réservation DHCP). L'intégration reconnaît un contrôleur à son adresse MAC et le suit quand son adresse change, mais une adresse fixe se retrouve plus vite.
Ce que propose chaque appareil
Chaque contrôleur est un appareil :
| Fonctionnalité | Ce qu'elle fait |
|---|---|
| Éclairage | Marche / arrêt |
| Luminosité | De 0 à 100 % (0 éteint le ruban) |
| Couleur | La couleur du ruban (rubans RGB) ; la choisir l'allume |
| Température de couleur | Du blanc chaud (2000 K) au blanc froid (6535 K), sur les rubans à blancs CCT |
| Canal blanc | Les LED blanches des rubans RGBW, de 0 à 100 |
| Effet | La liste des effets de votre contrôleur (Solid, Rainbow, Fire 2012…) |
| Palette | La palette de couleurs utilisée par l'effet |
| Vitesse de l'effet | De 0 à 100 |
| Intensité de l'effet | De 0 à 100 |
| Préréglage | Vos préréglages et playlists WLED ; « Aucun » dès que l'état a changé |
| Veilleuse | Lance la veilleuse WLED (durée et mode réglés dans WLED) |
| Synchro UDP | Envoie les changements aux autres contrôleurs WLED synchronisés |
Seul ce que votre ruban sait faire est proposé : pas de température de couleur sur un simple ruban RGB, pas de canal blanc sans LED blanches.
Les listes d'effets, de palettes et de préréglages sont lues sur le contrôleur. Un préréglage enregistré dans WLED apparaît tout seul dans la liste, en quelques secondes.
Segments
WLED peut découper un ruban en segments. Par défaut, l'appareil du contrôleur pilote les segments sélectionnés dans WLED, exactement comme l'interface de WLED ; sur un ruban à un seul segment, c'est tout le ruban.
Pour piloter chaque segment séparément, choisissez Aussi un appareil par segment dans Configuration → Segments, enregistrez, puis ajoutez les nouveaux appareils depuis Découverte. Ils sont proposés pour les contrôleurs qui ont au moins deux segments, et portent les noms des segments réglés dans WLED. Un appareil de segment a son propre éclairage, sa luminosité, sa couleur, son effet, sa palette, sa vitesse et son intensité ; allumer un segment allume aussi le contrôleur. Les préréglages, la veilleuse et la synchro restent sur l'appareil du contrôleur.
Les noms des fonctionnalités sont donnés à l'ajout d'un appareil, dans la langue choisie dans Configuration → Langue des noms de fonctionnalités : anglais, français, allemand ou espagnol. Les textes de l'intégration (configuration, widget, scènes, messages) suivent la langue de votre Gladys dans ces quatre langues.
Temps réel
Chaque contrôleur signale à Gladys chaque changement dès qu'il a lieu, quelle qu'en soit l'origine : l'application WLED, un bouton physique, une planification, une télécommande infrarouge, ou un autre contrôleur synchronisé. Si la connexion tombe, l'intégration demande son état au contrôleur toutes les 30 secondes pendant qu'elle se reconnecte.
Le badge de chaque appareil indique local quand le contrôleur répond, et injoignable quand il ne répond pas (débranché, Wi-Fi perdu). Une commande envoyée à un contrôleur injoignable échoue avec un message.
Scènes
L'intégration ajoute ses propres cartes à l'éditeur de scènes, dans la catégorie Intégrations :
- Appliquer un préréglage WLED (action) : applique un préréglage ou lance une playlist, désigné par son nom (tel qu'écrit dans WLED, majuscules indifférentes) ou son numéro. Les actions suivantes peuvent lire le numéro et le nom du préréglage.
- Lancer un effet WLED (action) : allume la lumière et lance un effet,
désigné par son nom (par exemple
Rainbow) ou son numéro, avec une palette (par exempleParty), une vitesse et une intensité (de 0 à 100) facultatives. Choisissez un appareil de segment pour lancer l'effet sur ce seul segment. - Préréglage WLED activé (déclencheur) : lance la scène quand un préréglage ou une
playlist est lancé hors de Gladys (application WLED, bouton,
planification, télécommande). Choisissez éventuellement le contrôleur et
saisissez le nom du préréglage ; laissés vides, n'importe quel préréglage convient.
Les actions suivantes peuvent lire
preset(son nom) etpreset_id(son numéro). Les préréglages appliqués par Gladys elle-même ne le déclenchent pas : une scène ne peut pas boucler sur elle-même.
Allumer, la luminosité et la couleur sont les actions d'éclairage habituelles de Gladys.
Tableau de bord
Ajoutez le widget WLED à un tableau de bord et choisissez un contrôleur (ou un appareil de segment) dans ses réglages. Il affiche :
-
la luminosité, en direct ;
-
si la lumière est allumée, l'effet, la palette et le préréglage en cours ;
-
des boutons en un geste, quatre au plus :
- vos préréglages favoris : ceux marqués dans WLED (donnez-leur un Quick load label dans les réglages du préréglage), ou vos premiers préréglages si aucun n'est marqué ;
- les effets choisis dans les réglages du widget, sous Boutons d'effets (Solid et Rainbow tant que vous ne les changez pas ; un effet que votre contrôleur n'a pas est omis). Avec des préréglages sur le widget, deux places restent aux effets.
Le préréglage ou l'effet actif porte une coche. Pour lancer un autre effet, utilisez la liste Effet de l'appareil, ou l'action de scène Lancer un effet WLED.
En cas de problème
- Aucun contrôleur dans Découverte : Gladys et le contrôleur doivent être sur le même réseau (le mDNS ne traverse ni les routeurs ni les VLAN). Saisissez l'adresse IP dans Configuration, puis utilisez Rechercher les contrôleurs : le message sous le bouton liste les contrôleurs trouvés et la façon dont ils sont joints.
- Un contrôleur reste injoignable : vérifiez que sa page web s'ouvre à
http://<son adresse>depuis un ordinateur du même réseau. Les noms en.localne fonctionnent pas dans l'intégration : utilisez l'adresse IP. - Les états arrivent en retard : sur un contrôleur compilé sans WebSocket, les changements faits hors de Gladys mettent jusqu'à 30 secondes à apparaître. WLED accepte aussi un nombre limité de clients WebSocket simultanés : fermez les onglets de l'application WLED inutilisés.
- L'intégration journalise tout ce qu'elle fait : ouvrez les journaux de
l'intégration depuis l'interface de Gladys, avec
LOG_LEVEL=debugpour le détail complet.
Cette intégration n'est pas affiliée au projet WLED.
Paramètres de configuration
Voici les paramètres demandés par WLED dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Trouver vos contrôleurs | section | Non | Les contrôleurs WLED du même réseau que Gladys sont trouvés automatiquement (mDNS) : ouvrez l'onglet Découverte. S'il en manque un, saisissez son adresse IP ci-dessous (affichée dans l'application WLED, Config, WiFi Setup). |
| Adresses IP des contrôleurs | string | Non | Facultatif, séparées par des virgules. Seulement pour les contrôleurs que la découverte automatique ne trouve pas. |
| Segments | select | Non | Chaque contrôleur est un appareil, qui pilote les segments sélectionnés dans WLED (tout le ruban s'il n'y en a qu'un). Vous pouvez aussi obtenir un appareil par segment. |
| Langue des noms de fonctionnalités | select | Non | Noms donnés aux fonctionnalités des nouveaux appareils (Éclairage, Luminosité, Effet…). |
Comment installer WLED dans Gladys
- Dans Gladys, ouvrez Intégrations : WLED apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-wled:1.1.0), 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). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-wled.
WLED 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
WLED 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 externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation