Was du brauchst
Für den ersten Aufbau mit einem LED-Streifen brauchst du nur wenig. Diese Seite listet die Teile auf, erklärt die Auswahl und zeigt, wie du das Netzteil berechnest.
Die Einkaufsliste
| Teil | Worauf du achten solltest | Wozu |
|---|---|---|
| Controller-Board | Ein ESP32-S3 mit mindestens 4 MB Flash. HyperLED wird auf dem Waveshare ESP32-S3-Zero entwickelt und getestet (4 MB Flash, 2 MB PSRAM). | Das ist das „Gehirn“. Es führt HyperLED und die Weboberfläche aus. |
| LED-Streifen | WS2812B, 5 V, einzeln ansteuerbar („NeoPixel“) ist der leichte Einstieg. Auch gut: WS2813, WS2815 (12 V). | Das Licht. Viele andere Typen gehen auch, siehe die vollständige Liste unten. |
| Netzteil | Passende Spannung für deinen Streifen (5 V bei WS2812B) und genug Strom (siehe unten). | Die LEDs brauchen viel mehr Strom, als der ESP32 liefern kann. |
| USB-Kabel | Ein Datenkabel (nicht „nur laden“), passend zu deinem Board. | Um die Firmware einmal aufzuspielen. |
| Widerstand | Etwa 330 Ω (220 bis 470 Ω sind in Ordnung). | Schützt den Datenpin. |
| Kondensator | 1000 µF, mindestens 6,3 V (gern 10 V oder 16 V). Auf die Polung achten. | Fängt den Stromstoß beim Einschalten ab. |
| Kabel | Dick genug für den Strom (die 5-V- und GND-Leitungen tragen den LED-Strom). | |
| (optional) Pegelwandler | 74AHCT125, von 3,3 V auf 5 V. | Nur wenn der Streifen flackert, siehe Verkabelung und Strom. |
Außerdem brauchst du für die Erstinstallation einen Computer (Windows, macOS oder Linux) und ein WLAN mit 2,4 GHz. Danach reicht für alles ein Handy.
Tipp: Kauf lieber einen Streifen mit ein paar LEDs mehr, als du glaubst zu brauchen. In HyperLED kannst du jederzeit eine kleinere LED-Anzahl einstellen.
Welcher ESP32?
HyperLED ist für den ESP32-S3 gebaut und überwiegend darauf getestet. Der Slave läuft auch auf dem ESP32-C6 (zum Beispiel dem ESP32-C6 Super Mini); das ist neu und wird noch getestet, siehe Mehrere Geräte. Andere ESP32-Chips könnten theoretisch laufen, brauchen aber Änderungen im Code. Mehr dazu steht in Hardware Setup im Repository. Die Anforderungen in Kürze:
- WLAN (2,4 GHz) und ESP-NOW
- mindestens 4 MB Flash (zwei Update-Plätze plus Dateisystem)
- genug RAM für Webserver, Verschlüsselung und Funk gleichzeitig
- für HUB75-Panels: ein Chip, den die Panel-Bibliothek unterstützt
Welche LEDs?
Den Typ wählst du in der Weboberfläche unter Geräte → LED-Hardware → LED-Typ (siehe Erstes Licht). WS2812B (der Eintrag „WS281x“) ist die übliche Wahl und der beste Einstieg: Dieser Typ ist auf echter Hardware getestet. HyperLED unterstützt noch viele weitere. Das ist die vollständige Liste, in der Reihenfolge der Auswahlliste.
Digitale LEDs (1-Wire): eine Datenleitung
| Eintrag in der Liste | Typische Streifen | Stand |
|---|---|---|
| WS281x | WS2812B, WS2813, WS2815 (12 V), WS2811 und Nachbauten; RGB | ✅ getestet |
| SK6812/WS2814 RGBW | Streifen mit zusätzlicher weißer LED | ⚠️ noch nicht auf Hardware getestet |
| TM1814 | RGBW-Streifen | ⚠️ noch nicht auf Hardware getestet |
| 400kHz | ältere Streifen mit 400-kHz-Zeitverhalten | ⚠️ noch nicht auf Hardware getestet |
| TM1829 | RGB | ⚠️ noch nicht auf Hardware getestet |
| UCS8903 | RGB | ⚠️ noch nicht auf Hardware getestet |
| APA106/PL9823 | RGB-Pixel-LEDs | ⚠️ noch nicht auf Hardware getestet |
| TM1914 | RGB | ⚠️ noch nicht auf Hardware getestet |
| FW1906 GRBCW | RGB plus kaltweiß und warmweiß | ⚠️ noch nicht auf Hardware getestet |
| UCS8904 RGBW | RGBW | ⚠️ noch nicht auf Hardware getestet |
| SM16825 RGBCW | RGB plus kaltweiß und warmweiß | ⚠️ noch nicht auf Hardware getestet |
| WS2811 White | einfarbig weiße Streifen | ⚠️ noch nicht auf Hardware getestet |
| WS281x WWA | weiße Streifen mit Warmweiß, Kaltweiß und Bernstein | ⚠️ noch nicht auf Hardware getestet |
| WS2805 RGBCW | RGB plus kaltweiß und warmweiß (12 V) | ⚠️ noch nicht auf Hardware getestet |
Digitale LEDs (SPI / 2-Wire): eine Daten- und eine Taktleitung
| Eintrag in der Liste | Typische Streifen | Stand |
|---|---|---|
| WS2801 | ältere RGB-Streifen | ⚠️ noch nicht auf Hardware getestet |
| APA102 | APA102, SK9822 („DotStar“) | ⚠️ noch nicht auf Hardware getestet |
| LPD8806 | RGB | ⚠️ noch nicht auf Hardware getestet |
| LPD6803 | RGB | ⚠️ noch nicht auf Hardware getestet |
| PP9813 | P9813 / PP9813 | ⚠️ noch nicht auf Hardware getestet |
Analoge / einfache LEDs (PWM): kein Datensignal; der ESP32 dimmt jeden Farbkanal selbst, meist über einen Treiber oder MOSFETs
| Eintrag in der Liste | Was er ansteuert | Stand |
|---|---|---|
| On/Off | eine Lampe oder ein Relais, das nur schaltet | ⚠️ noch nicht auf Hardware getestet |
| PWM White | ein Kanal, einfarbige Streifen | ⚠️ noch nicht auf Hardware getestet |
| PWM CCT | zwei Kanäle: kaltweiß und warmweiß | ⚠️ noch nicht auf Hardware getestet |
| PWM RGB | drei Kanäle | ⚠️ noch nicht auf Hardware getestet |
| PWM RGBW | vier Kanäle | ⚠️ noch nicht auf Hardware getestet |
| PWM RGB+CCT | fünf Kanäle | ⚠️ noch nicht auf Hardware getestet |
Scan-Matrix-Panels
| Eintrag in der Liste | Was er ansteuert | Stand |
|---|---|---|
| HUB75 | HUB75-LED-Panels, zum Beispiel 64 × 64; stell den Treiber-Chip auf Generic (die meisten Panels), FM6126A, ICN2038S, FM6124, MBI5124 oder DP3246, wenn du Geisterbilder oder Flackern siehst | ✅ getestet (Generic) |
„Noch nicht auf Hardware getestet“ heißt: Der Treiber wurde gegen die Bibliothek und das Datenblatt geprüft, aber noch niemand hat ihn an einem echten Streifen laufen lassen. Wenn du einen ausprobierst, sag uns das bitte in einem Issue, mit dem genauen Streifen, den du benutzt hast.
Bei 12-V- und 24-V-Streifen, bei denen sich mehrere LEDs einen Chip teilen (zum Beispiel WS2805), ist die Einstellung LEDs pro Chip wichtig; siehe Erstes Licht.
LED-Panels (HUB75, zum Beispiel 64 × 64) werden mit einer festen Pinbelegung angeschlossen, die dir die Weboberfläche zeigt; siehe Panels und Elemente und Mehrere Geräte (ein Panel kann auf einem eigenen Board laufen, einem Slave).
Das Netzteil berechnen
Eine einzelne WS2812B-LED kann bei vollem Weiß (Rot, Grün und Blau auf voller Helligkeit) etwa 60 mA ziehen. Also:
Strom in Ampere = Anzahl der LEDs × 0,06
| LEDs | Schlimmster Fall (alles weiß, volle Helligkeit) |
|---|---|
| 30 | 1,8 A |
| 60 | 3,6 A |
| 144 | 8,6 A |
| 300 | 18 A |
Du wirst selten alle LEDs auf vollem Weiß betreiben, und HyperLED hat einen Helligkeitsbegrenzer, der den Strom unter der Grenze hält, die du einstellst (siehe Erstes Licht). Trotzdem solltest du ein Netzteil wählen, das mindestens so stark wie deine Grenze ist, dicke Leitungen nehmen und lange Streifen von beiden Enden einspeisen.
HyperLED rechnet auch selbst mit: Unter Geräte → LED-Hardware → Stromversorgung zeigt es das empfohlene Netzteil für die eingegebene LED-Anzahl.
Wichtig: Der ESP32 darf die LEDs nicht mit Strom versorgen. Nimm ein richtiges Netzteil für den Streifen und verbinde nur die Datenleitung und eine gemeinsame Masse mit dem ESP32. Wie das geht: Verkabelung und Strom.