WLED tourne sur des cartes ESP32 et ESP8266 et pilote des rubans et matrices LED adressables. Pixel LED Animator 3 peut envoyer des images de pixels à WLED par le réseau en temps réel : l’animation se joue donc en direct au lieu d’être copiée sur une carte.
Cela change le flux de travail. Vous pouvez régler un effet en regardant la vraie matrice, tester le câblage immédiatement et faire tourner une séquence tant que le flux reste connecté.
Comment fonctionne la connexion
Pixel LED Animator envoie des paquets UDP contenant les données de pixels. WLED les reçoit, passe en mode live et écrit les valeurs sur les LED. L’éditeur fait le rendu ; WLED fait la sortie.
Plusieurs protocoles peuvent transporter les mêmes images :
| Protocole | Port par défaut | Adressage | Idéal pour |
|---|---|---|---|
| DDP | 4048 | Décalage de pixel, pas d’univers | WLED, configuration la plus simple |
| E1.31 / sACN | 5568 | 510 canaux par univers | Installations à contrôleurs mixtes, FPP |
| Art-Net | 6454 | 512 canaux par univers | Consoles d’éclairage, MADRIX |
| TPM2.net | 65506 | Données pixel séquentielles | Jinx, FPP, versions de WLED compatibles |
| KiNet | 6038 | Données pixel séquentielles | Matériel Color Kinetics et MADRIX |
Pour WLED, commencez par DDP. Cela évite les calculs d’univers et envoie l’image dans le moins de paquets possible. Utilisez E1.31 lorsque WLED fait partie d’une installation plus vaste qui parle déjà sACN.
KiNet n’est pas un protocole WLED. Il cible les pilotes Color Kinetics et les installations de type MADRIX. Ne le sélectionnez pas pour une carte WLED.
Étape 1 : configurer WLED
- Ouvrez l’interface web de WLED.
- Allez dans Config → LED Preferences et réglez le nombre total de LED sur
width x height. - Réglez l’ordre des couleurs selon le ruban ou le panneau : RGB, GRB, BRG, etc.
- Ouvrez la configuration 2D Matrix et réglez la largeur, la hauteur et la disposition du câblage du panneau. Selon la version de WLED, cela se trouve dans LED Preferences ou sur la page dédiée à la configuration 2D.
- Allez dans Config → Sync Interfaces et activez DDP. Activez E1.31 ou Art-Net uniquement si vous comptez les utiliser.
- Attribuez une adresse IP fixe à la carte via une réservation DHCP.
- Testez la matrice avec un effet intégré de WLED avant d’envoyer des données externes.
Si l’effet intégré est faux, le streaming externe sera faux aussi. Corrigez d’abord les dimensions de la matrice et le câblage.
Étape 2 : aligner le câblage dans Pixel LED Animator
Ouvrez la fenêtre de streaming et choisissez le bouton de protocole WLED.
- WLED IP : l’adresse de la carte, par exemple
192.168.4.1en mode point d’accès ou l’adresse DHCP de votre réseau local. - Protocol:
DDP (Recommended). - Port: laissez Default, sauf si votre version de WLED utilise un port personnalisé.
- Wiring pattern: choisissez le motif correspondant à la matrice physique : séquentiel, serpentin, vertical ou serpentin vertical.
- Brightness: gardez une limite globale pour les tests, puis augmentez-la pour le spectacle.
Le motif de câblage de l’éditeur et le réglage de matrice 2D de WLED doivent concorder. Si l’un dit serpentin et l’autre progressif, l’image se déchirera ou se inversera à chaque ligne.
Étape 3 : vérifier avec des motifs de test
Ouvrez le groupe Test Patterns dans la fenêtre de streaming et envoyez un motif :
- Solid vérifie l’alimentation et la couleur de base.
- Chase vérifie l’ordre et la direction des pixels.
- Alternate vérifie le câblage pair/impair.
- RGB Cycle vérifie l’ordre des couleurs.
- Bars vérifie le mapping des lignes et des colonnes.
- Gradient révèle les problèmes de banding et de gamma.
Envoyez un motif avant de diffuser l’animation. Un défaut de câblage se voit beaucoup plus facilement dans un chase que dans un effet plasma en mouvement.
Si l’image est inversée, retournée ou pivotée, corrigez le motif de câblage ou l’orientation 2D de WLED. Ne compensez pas en modifiant l’animation.
Étape 4 : démarrer la diffusion
Appuyez sur Start Streaming et surveillez le compteur FPS et l’affichage d’activité DMX. Vérifiez ensuite :
- La première image correspond à l’aperçu de l’éditeur.
- Le mouvement est fluide, sans saccade visible.
- Les couleurs correspondent à la palette.
- La matrice ne clignote pas quand la luminosité change.
WLED a un délai d’expiration pour les données live. Si le flux s’arrête, WLED revient à ses effets normaux après un court délai. C’est le comportement attendu, pas une panne.
Étape 5 : choisir entre live et autonome
Le streaming est idéal pour les tests et les spectacles live. Ce n’est pas le bon choix pour une installation permanente qui doit démarrer sans ordinateur.
| Cas d’usage | Meilleure sortie |
|---|---|
| Régler un effet sur la vraie matrice | Flux DDP live |
| Spectacle live avec un ordinateur | DDP ou E1.31 live |
| Installation autonome | Vidéo exportée, GIF ou fichier contrôleur |
| Spectacle géré par FPP | Séquence FSEQ |
| Contrôleur à carte SD | XDAT ou vidéo |
Pour la lecture autonome, exportez l’animation terminée et utilisez le format accepté par le contrôleur. Le guide des formats d’export détaille les compromis.
Limites réseau et performances
La bande passante brute des pixels est facile à calculer :
width x height x 3 x FPS = bytes per second
| Matrice | Taille d’image | À 30 FPS |
|---|---|---|
32 x 32 | 3 072 octets | ~0,74 Mbps |
64 x 32 | 6 144 octets | ~1,47 Mbps |
64 x 64 | 12 288 octets | ~2,95 Mbps |
128 x 64 | 24 576 octets | ~5,9 Mbps |
Ces chiffres précèdent la surcharge des paquets. Le Wi-Fi peut les transporter, mais la latence et la gigue comptent plus que le débit brut. Pour les grandes matrices :
- Utilisez Ethernet sur l’ESP32 si la carte le permet.
- Gardez le point d’accès proche et sur un canal peu encombré.
- Rappelez-vous que la plupart des cartes ESP32 sont limitées à 2,4 GHz ; un réseau 5 GHz n’apparaîtra pas.
- Désactivez l’isolation des clients du routeur pour que le PC puisse joindre la carte.
- Plafonnez la luminosité dans WLED pour rester dans les limites de l’alimentation.
Dépannage
| Problème | Solution |
|---|---|
| WLED ne réagit pas | Vérifiez l’IP, activez DDP dans WLED, confirmez que les deux appareils sont sur le même réseau |
| Seule une partie de la matrice s’actualise | Le motif de câblage, les dimensions de la matrice ou le nombre d’univers sont faux |
| L’image est inversée ou pivotée | Alignez le motif de câblage de l’éditeur sur l’orientation 2D de WLED |
| Les couleurs sont fausses | Réglez le bon ordre des couleurs dans WLED |
| Scintillement ou pixels aléatoires | Injection d’alimentation, adaptation de niveau, ligne de données mal fixée ou retransmissions Wi-Fi |
| Le flux coupe après quelques secondes | Délai d’expiration live de WLED ; gardez le flux actif et vérifiez le réseau |
| La cadence est faible | Réduisez la taille du canevas ou les FPS, utilisez Ethernet, limitez le trafic Wi-Fi |
| Carte introuvable dans Discover | Pare-feu, sous-réseau ou isolation du point d’accès ; saisissez l’IP manuellement |
FAQ
WLED peut-il lire un fichier vidéo directement ? Pas au sens habituel. WLED affiche des données pixel live ou ses propres effets. La lecture vidéo nécessite des usermods et du matériel spécifiques, et ce n’est pas la même chose que diffuser des images depuis l’éditeur.
Faut-il utiliser DDP ou E1.31 ? Utilisez DDP pour une installation uniquement WLED. Utilisez E1.31 lorsque WLED partage le réseau avec FPP, une console d’éclairage ou d’autres appareils sACN.
Puis-je diffuser par internet ? C’est possible avec un tunnel, mais déconseillé. Le streaming de pixels est sensible à la latence et expose le contrôleur au réseau. Gardez-le sur le réseau local.
L’animation reste-t-elle sur WLED quand j’arrête la diffusion ? Non. Le flux est une donnée live. Pour une lecture autonome, exportez un fichier pour le contrôleur ou utilisez FPP.
Combien de pixels WLED peut-il gérer ? Cela dépend de la carte ESP32, de la cadence, du réseau et de l’alimentation. Testez la vraie matrice à la cadence visée plutôt que de vous fier à un chiffre marketing.
Découvrir Pixel LED Animator 3 · Voir toutes les intégrations · Lire le guide FSEQ pour Falcon Player · Acheter la licence version 3 à vie
