WLED draait op ESP32- en ESP8266-boards en stuurt adresseerbare LED-strips en -matrices aan. Pixel LED Animator 3 kan pixelframes in realtime over het netwerk naar WLED sturen, zodat de animatie live afspeelt in plaats van naar een kaart te worden gekopieerd.
Dat verandert de workflow. U kunt een effect afstellen terwijl u naar de echte matrix kijkt, de bedrading direct testen en een sequence laten lopen zolang de stream verbonden blijft.
Hoe de Verbinding Werkt
Pixel LED Animator verstuurt UDP-pakketten met pixeldata. WLED ontvangt ze, schakelt over naar live-modus en schrijft de waarden naar de LED’s. De editor doet het renderen; WLED doet de uitvoer.
Meerdere protocollen kunnen dezelfde frames vervoeren:
| Protocol | Standaardpoort | Adressering | Beste voor |
|---|---|---|---|
| DDP | 4048 | Pixel-offset, geen universes | WLED, eenvoudigste opstelling |
| E1.31 / sACN | 5568 | 510 kanalen per universe | Gemengde controlleropstellingen, FPP |
| Art-Net | 6454 | 512 kanalen per universe | Lichttafels, MADRIX |
| TPM2.net | 65506 | Sequentiële pixeldata | Jinx, FPP, WLED-builds die dit ondersteunen |
| KiNet | 6038 | Sequentiële pixeldata | Color Kinetics- en MADRIX-hardware |
Begin voor WLED met DDP. Het voorkomt universerekenwerk en verstuurt het frame in zo weinig mogelijk pakketten. Gebruik E1.31 wanneer WLED deel uitmaakt van een grotere opstelling die al sACN spreekt.
KiNet is geen WLED-protocol. Het is bedoeld voor Color Kinetics-drivers en MADRIX-achtige opstellingen. Selecteer het niet voor een WLED-board.
Stap 1: WLED Configureren
- Open de webinterface van WLED.
- Ga naar Config → LED Preferences en stel het totale aantal LED’s in op
width x height. - Zet de kleurvolgorde gelijk aan de strip of het paneel: RGB, GRB, BRG, enzovoort.
- Open de 2D Matrix-configuratie en stel paneelbreedte, -hoogte en bedradingsindeling in. Afhankelijk van de WLED-versie staat dit in LED Preferences of op de aparte 2D-instelpagina.
- Ga naar Config → Sync Interfaces en schakel DDP in. Schakel E1.31 of Art-Net alleen in als u die wilt gebruiken.
- Geef het board een vast IP-adres via een DHCP-reservering.
- Test de matrix met een ingebouwd WLED-effect voordat u externe data stuurt.
Ziet het ingebouwde effect er verkeerd uit, dan ziet externe streaming er ook verkeerd uit. Los eerst de matrixafmetingen en de bedrading op.
Stap 2: De Bedrading Afstemmen in Pixel LED Animator
Open het streamingvenster en kies de protocolknop WLED.
- WLED IP: het adres van het board, bijvoorbeeld
192.168.4.1in accesspointmodus of het DHCP-adres op uw LAN. - Protocol:
DDP (Recommended). - Port: laat Default staan, tenzij uw WLED-build een aangepaste poort gebruikt.
- Wiring pattern: kies het patroon dat bij de fysieke matrix past: sequential, serpentine, vertical of vertical serpentine.
- Brightness: houd een algemene limiet aan tijdens het testen en verhoog die voor de show.
Het bedradingspatroon in de editor en de 2D-matrixinstelling in WLED moeten overeenkomen. Zegt de een serpentine en de ander progressive, dan scheurt of spiegelt het beeld op elke rij.
Stap 3: Controleren met Testpatronen
Open de groep Test Patterns in het streamingvenster en stuur een patroon:
- Solid controleert voeding en basiskleur.
- Chase controleert pixelvolgorde en richting.
- Alternate controleert oneven/even bedrading.
- RGB Cycle controleert de kleurvolgorde.
- Bars controleert de mapping van rijen en kolommen.
- Gradient legt banding- en gammaproblemen bloot.
Stuur een patroon voordat u de animatie streamt. Een bedradingsfout is veel makkelijker te zien in een chase dan in een bewegend plasma-effect.
Is het beeld gespiegeld, omgekeerd of geroteerd, pas dan het bedradingspatroon of de 2D-oriëntatie van WLED aan. Compenseer het niet door de animatie te bewerken.
Stap 4: Streaming Starten
Druk op Start Streaming en let op de FPS-meter en de DMX-activiteitsweergave. Controleer daarna:
- Het eerste frame komt overeen met de preview in de editor.
- De beweging is vloeiend, zonder zichtbare haperingen.
- De kleuren kloppen met het palet.
- De matrix flikkert niet wanneer de helderheid verandert.
WLED heeft een timeout voor live data. Stopt de stream, dan keert WLED na korte tijd terug naar zijn normale effecten. Dat is verwacht gedrag, geen storing.
Stap 5: Kiezen Tussen Live en Standalone
Streaming is ideaal voor testen en live shows. Het is niet de juiste keuze voor een vaste installatie die zonder computer moet starten.
| Gebruikssituatie | Beste uitvoer |
|---|---|
| Een effect afstellen op de echte matrix | Live DDP-stream |
| Live show met een computer | Live DDP of E1.31 |
| Standalone installatie | Geëxporteerde video, GIF of controllerbestand |
| Door FPP beheerde show | FSEQ-sequence |
| Controller met SD-kaart | XDAT of video |
Exporteer voor standalone weergave de voltooide animatie en gebruik het formaat dat de controller accepteert. De gids voor exportformaten behandelt de afwegingen.
Netwerk- en Prestatielimieten
De ruwe pixelbandbreedte is eenvoudig te berekenen:
width x height x 3 x FPS = bytes per second
| Matrix | Framegrootte | Bij 30 FPS |
|---|---|---|
32 x 32 | 3.072 bytes | ~0,74 Mbps |
64 x 32 | 6.144 bytes | ~1,47 Mbps |
64 x 64 | 12.288 bytes | ~2,95 Mbps |
128 x 64 | 24.576 bytes | ~5,9 Mbps |
Die cijfers gelden vóór pakketoverhead. Wi-Fi kan ze dragen, maar latentie en jitter zijn belangrijker dan ruwe doorvoer. Voor grote matrices:
- Gebruik Ethernet op de ESP32 als het board dat ondersteunt.
- Houd het accesspoint dichtbij en op een rustig kanaal.
- Onthoud dat de meeste ESP32-boards alleen 2,4 GHz ondersteunen; een 5GHz-netwerk verschijnt niet.
- Schakel client-isolatie op de router uit zodat de pc het board kan bereiken.
- Beperk de helderheid in WLED om binnen de voeding te blijven.
Problemen Oplossen
| Probleem | Oplossing |
|---|---|
| WLED reageert niet | Controleer het IP, schakel DDP in WLED in en bevestig dat beide apparaten op hetzelfde netwerk zitten |
| Slechts een deel van de matrix werkt | Bedradingspatroon, matrixafmetingen of aantal universes is onjuist |
| Beeld is gespiegeld of geroteerd | Stem het bedradingspatroon van de editor af op de 2D-oriëntatie van WLED |
| Kleuren zijn verkeerd | Stel de juiste kleurvolgorde in WLED in |
| Flikkering of willekeurige pixels | Voedingsinjectie, level shifting, losse datalijn of Wi-Fi-hertransmissies |
| Stream valt na enkele seconden weg | Live timeout van WLED; houd de stream actief en controleer het netwerk |
| Framerate is laag | Verlaag canvasgrootte of FPS, gebruik Ethernet, beperk ander Wi-Fi-verkeer |
| Board niet gevonden in Discover | Firewall, subnet of AP-isolatie; voer het IP handmatig in |
Veelgestelde Vragen
Kan WLED direct een videobestand afspelen? Niet in de gebruikelijke zin. WLED toont live pixeldata of zijn eigen effecten. Videoweergave vereist specifieke usermods en hardware, en is niet hetzelfde als frames uit de editor streamen.
Moet ik DDP of E1.31 gebruiken? Gebruik DDP voor een opstelling met alleen WLED. Gebruik E1.31 wanneer WLED het netwerk deelt met FPP, een lichttafel of andere sACN-apparaten.
Kan ik via internet streamen? Het kan met een tunnel, maar het wordt afgeraden. Pixelstreaming is latentiegevoelig en stelt de controller bloot aan het netwerk. Houd het op de LAN.
Blijft de animatie op WLED staan als ik stop met streamen? Nee. De stream is live data. Exporteer voor standalone weergave een bestand voor de controller of gebruik FPP.
Hoeveel pixels kan WLED aan? Dat hangt af van het ESP32-board, de framerate, het netwerk en de voeding. Test de echte matrix op de gewenste framerate in plaats van op een cijfer uit de folder te vertrouwen.
Ontdek Pixel LED Animator 3 · Bekijk alle integraties · Lees de FSEQ-gids voor Falcon Player · Koop de levenslange licentie