WLED et xLights : quand en avoir besoin, configuration DDP et reprise du contrôle
Quand WLED seul suffit et quand xLights vaut le coup, comment envoyer xLights vers WLED en DDP ou E1.31, les réglages clés des deux côtés et comment WLED reprend la main après un spectacle.
Écrit par Jamie Conde, qui développe WLED Max chez MeowScript. WLED Max est une app indépendante, sans lien avec le projet officiel WLED, qui ne la soutient ni ne l'approuve.
Réponse rapide : WLED fait tourner des effets tout seul ; xLights sert aux spectacles séquencés sur de la musique avec de nombreux éléments décoratifs. Les deux fonctionnent ensemble : xLights envoie la couleur de chaque pixel sur le réseau, et WLED se contente de l’afficher. Dans xLights, ajoutez la lumière comme contrôleur Ethernet avec le fabricant WLED et le protocole DDP. WLED n’a besoin d’aucun réglage pour DDP. Quand xLights arrête d’envoyer, WLED revient à son propre effet après 2,5 secondes.
Avez-vous vraiment besoin de xLights ?
La plupart des utilisateurs de WLED, non. Une règle empirique du forum WLED résume bien la chose : WLED gère seul beaucoup d’installations LED, et xLights est l’outil qu’il vous faut quand vous voulez piloter tout votre jardin comme un seul spectacle.
| Vous voulez | Utilisez |
|---|---|
| De beaux effets sur un bord de toit, un sapin ou une fenêtre, qui changent selon une programmation | WLED seul, avec des préréglages, des listes de lecture et des minuteurs |
| Des motifs de fêtes comme rouge et blanc ou sucre d’orge | WLED seul, voir les motifs de Noël |
| Plusieurs lumières qui affichent le même effet en synchro | WLED seul, avec la synchronisation UDP |
| Des lumières calées sur une chanson, au temps près | xLights |
| Un méga-sapin, une matrice, des arches et un bord de toit qui forment une seule installation | xLights |
| Un spectacle qui tourne chaque soir selon une programmation, sans ordinateur | xLights pour le créer, Falcon Player (FPP) sur un Raspberry Pi pour le jouer |
xLights est gratuit et puissant, mais c’est aussi un loisir à part entière. Séquencer une seule chanson peut prendre une soirée. Si vous voulez simplement que la maison soit belle en décembre, WLED seul vous mène presque au bout.
Comment les deux s’articulent
Pendant un spectacle, WLED n’est plus le cerveau. xLights (ou FPP qui joue le spectacle) envoie un flux d’images, chacune avec la couleur de chaque pixel. WLED passe en mode temps réel : il efface le ruban, affiche ce qui arrive et ignore ses propres effets, préréglages et minuteurs jusqu’à l’arrêt du flux.
C’est pourquoi la question xLights la plus fréquente sur le forum WLED est en réalité « pourquoi mon WLED ignore-t-il l’app ? » Voir WLED bloqué en mode temps réel pour cet aspect.
DDP ou E1.31 ?
WLED accepte trois protocoles de spectacle. DDP et E1.31 sont activés par défaut. Art-Net demande de régler Type sur Art-Net sous Network DMX input dans Sync Interfaces, ce qui fait passer l’écoute du port 5568 au port 6454 : E1.31 et Art-Net ne peuvent donc pas être actifs en même temps.
| DDP | E1.31 (sACN) | Art-Net | |
|---|---|---|---|
| Port | 4048 | 5568 | 6454 |
| Réglage dans WLED | aucun, toujours actif | Network DMX input, DMX mode | le même, Type Art-Net |
| Univers | aucun, juste un décalage de pixels | 170 pixels RGB par univers | comme E1.31 |
| RGBW | oui dans WLED, mais l’envoi WLED de xLights le refuse | oui, avec DMX mode Multi RGBW | oui |
| Choix par défaut de xLights pour WLED | oui |
Utilisez DDP sauf si vous avez une raison de faire autrement. C’est ce que choisit xLights quand il détecte un contrôleur WLED, il n’y a pas d’univers à aligner, et c’est efficace. Utilisez E1.31 pour des pixels RGBW, ou si votre spectacle est construit autour d’univers dans FPP.
Configurer WLED
Pour DDP, il n’y a presque rien à faire. Vérifiez ces points dans Config›LED & Hardware (LED Preferences sous 0.14 et 0.15) :
- Le nombre de LED et l’ordre des sorties correspondent au câblage réel.
- La lumière a une adresse fixe (une réservation DHCP dans votre routeur).
Pour E1.31, ouvrez Config›Sync Interfaces et trouvez Network DMX input dans la section Realtime :
- Type : E1.31 (sACN).
- Start universe : le premier univers que xLights envoie à cette lumière (1 par défaut).
- DMX mode : Multi RGB pour des pixels RGB, Multi RGBW pour du RGBW. La documentation de WLED décrit Multi RGB comme « le mode à utiliser pour xLights ».
- Multicast : réglez-le comme ce qu’envoie xLights. L’unicast (désactivé) est plus simple en Wi-Fi.
Le reste de la section Realtime compte pour les deux protocoles :
- Timeout (2500 ms par défaut) : le temps que WLED attend après la dernière image avant de revenir à son propre effet.
- Force max brightness : affiche le flux à pleine luminosité au lieu de votre luminosité WLED.
- Use main segment only : le flux ne peint que le segment principal, et les autres gardent leurs effets WLED. Avec cette option, WLED ignore la priorité
lordécrite plus bas. - Respect LED Maps (0.15 et suivants) : applique aussi votre correspondance de LED (ledmap.json) au flux.
Dans WLED Max sur iPhone, les réglages E1.31 et le délai se trouvent dans Réglages de l’appareil, Interfaces de synchronisation, section E1.31 / DMX / Art-Net. Sur Android, c’est au même endroit : Réglages de l’appareil, Interfaces de synchronisation, E1.31 / DMX / Art-Net. Le champ du délai de l’app compte par pas de 100 ms, donc 25 y veut dire 2500 ms.
Configurer xLights
xLights intègre WLED comme fabricant de contrôleurs, avec des modèles pour les cartes ESP8266 et ESP32 génériques et plusieurs cartes QuinLED.
- Ouvrez l’onglet Controllers et cliquez sur Add Ethernet. (Ou essayez Discover : il trouve les lumières WLED sur votre réseau et remplit le reste.)
- Saisissez l’IP Address de la lumière, réglez Vendor sur WLED, puis Model sur WLED avec la Variant Generic ESP32 ou Generic ESP8266, ou choisissez votre carte comme Model (QuinLED Dig-Uno, Dig-Quad, Dig-Octa et d’autres).
- Réglez Protocol sur DDP. Laissez Keep Channel Numbers désactivé.
- Construisez vos éléments dans l’onglet Layout, puis revenez au contrôleur, cliquez sur Visualise et faites glisser chaque élément sur le port auquel il est câblé.
- Avec Auto Size activé, xLights calcule le nombre de canaux à partir des éléments. À la main, c’est nombre de LED × 3 pour du RGB.
- Enregistrez, et activez la sortie vers les lumières (le bouton en forme d’ampoule dans la barre d’outils).
Faut-il laisser xLights envoyer sa configuration à WLED ?
Le bouton Upload Output écrit la configuration des ports (nombre de LED, broches GPIO, type de LED, ordre des couleurs) dans WLED et redémarre la lumière. C’est pratique pour un contrôleur neuf, mais cela écrase les réglages LED de WLED, et des messages sur le forum signalent qu’il a effacé des réglages GPIO. Si votre WLED est déjà configuré et fonctionne, réglez vous-même le nombre de LED dans WLED et sautez l’envoi. Dans tous les cas, faites d’abord une sauvegarde : sauvegarde et restauration WLED.
Deux erreurs d’envoi que vous pourriez voir, et ce qu’elles veulent dire :
- « The DDP ‘Keep Channel Numbers’ option is not support with WLED » : désactivez cette option.
- « Four Channel Pixles and DDP, do not work well in WLED » : vos éléments sont en RGBW. Passez ce contrôleur en E1.31 et réglez le DMX mode de WLED sur Multi RGBW.
Wi-Fi, fréquence d’images et grands spectacles
L’envoi en Wi-Fi fonctionne pour quelques contrôleurs. Cela devient plus difficile à mesure que le spectacle grandit : chaque pixel de chaque image passe par les ondes, et des discussions sur le forum décrivent des spectacles avec une douzaine de contrôleurs Wi-Fi qui tombent à quelques images par seconde.
- Branchez par câble l’ordinateur ou le FPP qui envoie le spectacle, pour que seul le dernier saut soit en Wi-Fi.
- Activez Suppress Duplicate Frames sur le contrôleur dans xLights, pour que les images qui n’ont pas changé ne soient pas renvoyées.
- Pour E1.31, la documentation de WLED recommande au plus 3 univers (510 pixels RGB) par lumière pour un rendu régulier à 40 images par seconde, et 9 univers au maximum sur ESP8266.
- WLED affiche une nouvelle image reçue au plus une fois toutes les 16 ms, ce qui le limite à un peu plus de 60 images par seconde, quoi que vous envoyiez.
- Pour les grandes installations, utilisez des cartes ESP32, et des cartes Ethernet filaires quand c’est possible.
Reprendre le contrôle après le spectacle
Quand le flux s’arrête, WLED attend la fin du délai (2,5 s par défaut) puis reprend exactement ce qu’il faisait : même effet, même luminosité. Le flux ne modifie aucun des réglages propres à WLED.
Quand vous coupez la sortie dans xLights, il envoie d’abord une image toute noire. Les lumières s’éteignent donc pendant la durée du délai, puis l’effet WLED revient.
Si WLED ne revient pas, quelque chose envoie encore des données. Trouvez l’émetteur grâce à /json/info sur la lumière (le champ lip indique l’IP de l’émetteur), ou passez outre :
- Envoyez
{"lor":1}à/json/statepour ignorer le flux jusqu’à ce qu’il s’arrête, ou{"lor":2}pour l’ignorer jusqu’au prochain redémarrage. - Envoyez
{"live":false}pour quitter tout de suite le mode temps réel. Si l’émetteur envoie encore, le paquet suivant remet aussitôt la lumière en mode temps réel, alors arrêtez l’émetteur ou utilisezlor.
Dans WLED Max, l’onglet Contrôle affiche une bannière quand une lumière est pilotée par xLights ou autre chose (« Contrôle externe actif », sur iOS, et sur Android depuis WLED Max 1.1.4). Touchez Prendre le contrôle et choisissez Prioritaire jusqu’à l’arrêt des données ou Prioritaire jusqu’au redémarrage. Ce sont les deux mêmes valeurs de priorité. Sous Android 1.1.2 et versions antérieures, la bannière indique le nom de l’émetteur (« … is controlling this device », l’app n’existait alors qu’en anglais) et les deux boutons s’appellent Until Data Stops et Until Reboot.
Pour garder plutôt la dernière image sur les lumières, réglez le délai sur 65000, que WLED traite comme « jamais ».
FAQ
Ai-je besoin de xLights pour WLED ? Non. WLED fait tourner seul les effets, les préréglages, les listes de lecture et les minuteurs. xLights sert aux spectacles synchronisés sur la musique avec de nombreux éléments.
Quel port xLights utilise-t-il pour WLED ? DDP sur le port 4048, E1.31 sur le 5568, Art-Net sur le 6454.
Dois-je activer DDP dans WLED ? Non. WLED écoute toujours DDP. E1.31 et Art-Net se règlent dans Sync Interfaces sous Network DMX input : Type choisit E1.31 ou Art-Net, et DMX mode ne doit pas être sur Disabled.
Pourquoi WLED reste-t-il éteint après le spectacle ? xLights a envoyé une image noire quand vous avez coupé la sortie, et WLED l’affiche jusqu’à la fin du délai. S’il reste éteint plus longtemps, un autre émetteur envoie encore des données.
Puis-je utiliser les effets WLED et xLights ensemble ? Oui, de deux façons : activez Use main segment only, pour que le spectacle tourne sur un segment et que les autres gardent les effets WLED, ou laissez WLED fonctionner normalement et ne passez à xLights que pendant le spectacle.