WLED & ESP32 steuern – PixDrive für Maker

Worum es geht

Mehr als die eingebauten WLED-Effekte

WLED ist ideal für den Einstieg: ESP32 flashen, Strip anschließen, Effekt auswählen. Spätestens bei einer eigenen Matrix, einem Effekt, den es noch nicht gibt, oder mehreren Controllern, die zusammenspielen sollen, wird es eng.

PixDrive übernimmt dann das Rendering am Rechner und schickt die fertigen Pixel per Art-Net oder sACN an WLED. Effekte schreibst du in Lua und siehst sie sofort auf den LEDs. Soll der Controller später allein laufen, exportierst du die Show auf eine SD-Karte am ESP32.

Funktionen

Mehr aus deinem WLED-Controller holen

WLED per Art-Net und sACN

WLED empfängt Art-Net und sACN (E1.31). PixDrive schickt die Pixeldaten in Echtzeit, jede Änderung siehst du sofort auf den LEDs.

Eigene Effekte in Lua

Die Script Engine führt Lua 5.4 aus. Parameter legst du als Regler an und verstellst sie live; ab 1.024 LEDs verteilt PixDrive die Berechnung auf bis zu acht Kerne.

Shows auf die SD-Karte

Mit der PixDrive-Firmware für WLED und einem SD-Karten-Board spielt dein ESP32 Shows als .wled-Datei ohne Rechner ab. Hochladen geht per Drag & Drop unter http://<WLED-IP>/pixdrive, der Usermod ist Open Source.

Anleitung: WLED mit SD-Karte →

Automatisieren mit REST, OSC und MCP

Home Assistant, Node-RED oder eigene Skripte steuern PixDrive über REST und OSC. Über den MCP-Server arbeitet auch ein KI-Assistent wie Claude oder Cursor mit.

Praxisbeispiel

Beispiel: 32 × 16 Matrix an einem ESP32

Zwei 16 × 16-Panels mit WS2812B ergeben eine Matrix mit 512 Pixeln an einem ESP32 mit WLED. WLED packt im DMX-Modus „Multi RGB“ 170 Pixel in ein Universum, die Matrix belegt also die sACN-Universen 1 bis 4.

Das vierte Universum trägt nur noch zwei Pixel. Das kostet keine Bildrate, du musst es in WLED und PixDrive aber trotzdem mitzählen – sonst bleiben die letzten beiden LEDs dunkel.

Im DMX-Rechner öffnen

Pixel: 512 RGB (32 × 16)
Universen: 4 (sACN 1–4)
Netzwerklast bei 40 fps: unter 1 Mbit/s
Max. Bildrate am Datenpin: ca. 63 fps
Lizenz: Vollversion (Demo: 1 Universum = 170 Pixel)

Script Engine

Ein Matrix-Effekt in acht Zeilen Lua

Dein Skript definiert eine Funktion render(), die PixDrive für jedes Bild aufruft. Bei Matrizen liefern pos_x(i) und pos_y(i) die Position jeder LED von 0.0 bis 1.0 – Verkabelung, Startecke und Schlangenlinie sind schon eingerechnet. Mit aktiviertem Mikrofon kommen audio_bass, audio_mids, audio_highs und audio_beat dazu.

Ringe, die mit dem Bass pumpen

function render()
    for i = 0, led_count - 1 do
        local x = pos_x(i) - 0.5
        local y = pos_y(i) - 0.5
        local hue = (sqrt(x * x + y * y) * 720.0 - time * 90.0) % 360.0
        set_led_hsv(i, hue, 1.0, audio_bass * 0.8 + 0.2)
    end
end

Anleitung: Effekte mit Lua →

Aus der Praxis

Tipps, die dir Zeit sparen

WLED auf Empfang stellen

In WLED unter Config → Sync Interfaces den Empfang per E1.31 oder Art-Net einschalten, das Start-Universum eintragen und als DMX-Modus „Multi RGB“ wählen.

Bewegung mit delta rechnen

Rechne Bewegungen mit delta, den Sekunden seit dem letzten Bild. Dann läuft dein Effekt gleich schnell, egal ob mit 30 oder 60 Bildern pro Sekunde.

Effekte mit KI schreiben

Der Button „LLM“ im Script-Editor kopiert die komplette Script-API in die Zwischenablage. Füg sie in einen KI-Chat ein, beschreib den Effekt und übernimm den Code.

Passt in die Demo

In der Demo ist die Script Engine voll nutzbar, Skripte dürfen aber höchstens 20 Zeilen lang sein. Das Beispiel oben passt locker rein.

FAQ

Häufige Fragen

Kurz beantwortet: PixDrive für Maker & WLED.

Was brauche ich für die Wiedergabe von der SD-Karte?

Die PixDrive-Firmware für WLED mit SD-Karten-Usermod und ein SD-Karten-Board, zum Beispiel das Zedfy ZW-SD am C012-Controller. Für die Live-Steuerung per Art-Net oder sACN reicht normales WLED.

Reicht die kostenlose Demo für ein kleines WLED-Projekt?

Für den Einstieg ja: ein Gerät, ein Universum (bis 170 RGB-Pixel), Live-Effekte und Lua-Skripte bis 20 Zeilen. Die Live-Ausgabe hat in der Demo kurze Blackouts; Sequencer, Export und längere Skripte gibt es in der Vollversion.

Kann ich PixDrive mit Home Assistant verbinden?

Ja, über die REST-API. Home Assistant, Node-RED oder ein Shell-Skript starten Looks und Shows, steuern die Wiedergabe und setzen die Helligkeit. Die externe Steuerung ist Teil der Vollversion.

Weitere Anwendungen

Probier es mit deinen eigenen LEDs aus

Die Demo läuft ohne Zeitlimit und ohne Registrierung. Teste Live-Effekte, LED-Layout und Script Engine mit einem Gerät und einem Universum.

Kostenlos laden Preise ansehen

macOS 12+ · Windows 10 / 11 · Kein Konto erforderlich

PixDrive für Maker & WLED-Projekte