🌈 ESP32 + WLED — Handout zum Mitnehmen

Deine Spickzettel-Karte. Erst im Sim üben, dann am echten Board.
(Gehört zum ESP32 + WLED Kurs.)

🖥️ 1. Erst im Browser üben (risikofrei)

ESP32-WLED-Sim — der Browser-Zwilling, hier kann nichts kaputtgehen:

./start_crumbblocks.sh      → esp32_wled_sim.html öffnen

Spiel mit Farbe · Effekt · Helligkeit · LED-Anzahl, tippe deine Crew an
(jedes Mitglied hat seine Farbe). Wenn du fertig bist: 🚀 An Crew senden,
dann im Terminal:

bash missions/robots/evaluate_esp32_wled.sh      # Ergebnis einfügen

Die Crew gibt dir Feedback und sagt dir, ob du bereit fürs echte Board bist.

🔌 2. Die 3 Kabel (das Wichtigste!)

WS2812B-Streifen          ESP32
  +5V  (rot)        →       5V
  GND  (schwarz)    →       GND
  DIN  (grün/gelb)  →       D4  (GPIO2)

⚠️ Erst alle Kabel verbinden, DANN Strom. Niemals andersrum.

✅ 3. Safety-Check (vor dem Strom)

  • [ ] 5V zu 5V? (nicht 3.3V!)
  • [ ] GND zu GND? (gemeinsame Erde)
  • [ ] DIN zu D4? (Daten-Pin)
  • [ ] Netzteil stark genug? ≥ 2A (Faustregel: ~60 mA pro LED)

Erst wenn alle vier ✓ → Strom einschalten.

⚡ 4. WLED flashen & einstellen

  1. Flashen: install.wled.me → USB-Kabel → Install (ca. 2 Min)
  2. WiFi: mit „WLED-AP" verbinden → Heimnetz wählen (nur 2,4 GHz!)
  3. LEDs: Config → LED Preferences
  4. LED count = deine Anzahl (die aus dem Sim!)
  5. Data GPIO = 2 (das ist D4)
  6. LED type = WS281x · Color Order = meist GRB

🎨 5. Effekte (aus dem Sim wiedererkennbar)

Effekt Was es macht
Solid Eine Farbe, ruhig — gut zum Verkabelung testen
Rainbow Jede LED anders, Farben rotieren
Scanner Lauflicht (Kitt) — später fürs traceroute
Colorwipe Farbe fließt durch — wie ein Datenpaket

🩹 Wenn's klemmt

  • Nichts leuchtet → 5V/GND/DIN prüfen, LED count in WLED gesetzt?
  • Farben falsch → Color Order auf GRB stellen
  • Flackern → 330–470 Ω zwischen Pin und DIN, 1000 µF zwischen 5V/GND
  • ESP32 nicht erkannt → anderes USB-Kabel (viele sind nur Ladekabel!)

🌲 Der Weg

crew_signal (Terminal)  →  ESP32-WLED-Sim (Browser)  →  ESP32 + WLED (echt)
     Farbe+Ton                 üben, risikofrei              dein Licht

Bits sind unsichtbar. Du machst sie sichtbar.
Der Wald wächst, wenn du weiterbaust. 💚

Version: 1.0 · Zielgruppe: Krümel (8–14) + Crew · Badge: ESP32 + LEDs zum Mitnehmen