Dzięki WLED, otwartemu oprogramowaniu układowemu, z ESP32 lub ESP8266 powstaje sterownik adresowalnych taśm LED. Do dyspozycji są strona WWW, aplikacja, efekty, zapisane ustawienia i interfejs JSON. Wszystko działa w sieci lokalnej, bez konta w chmurze. Poniżej opisano budowę prostego sterownika dla taśmy WS2812B zasilanej napięciem 5 V i podłączonej do ESP32: okablowanie, wgrywanie oprogramowania przez instalator w przeglądarce, pierwszą konfigurację oraz ustawienia ważne dla bezpieczeństwa, czyli limit prądu, blokadę aktualizacji bezprzewodowych i domyślne hasła.

Numery pinów, nazwy ustawień i wartości domyślne pochodzą z oficjalnej dokumentacji WLED (kno.wled.ge). Projekt szybko się rozwija. W chwili pisania najnowszym wydaniem w serwisie GitHub była wersja v16.0.1 z lipca 2026 roku, więc nazwy w innej wersji mogą się nieco różnić.

Wybierz płytkę i taśmę

W skróconej instrukcji WLED do nowych projektów zalecany jest układ ESP32. Ma znacznie większe możliwości, a wsparcie dla ESP8266 dobiega końca.

W taśmach adresowalnych (nazywanych też cyfrowymi) każdą diodą można sterować osobno i właśnie z myślą o nich przygotowano efekty WLED. W dokumentacji jest lista obsługiwanych układów wraz z napięciami. Kilka popularnych:

  • WS2812B: 5 V, jedna linia danych,
  • SK6812: 5 V lub 12 V, dostępne także wersje RGBW,
  • WS2815: 12 V, z zapasową linią danych,
  • APA102 i SK9822: 5 V, z osobnymi liniami zegara i danych.

WLED obsługuje też taśmy nieadresowalne (analogowe), ale każdy kanał koloru wymaga wtedy osobnego tranzystora MOSFET i osobnego pinu GPIO. Ten tekst dotyczy wyłącznie taśm adresowalnych.

Dobierz zasilacz

Zasilacz i przekrój przewodów dobiera się do prądu pobieranego przez taśmę przy pełnej bieli. W ustawieniach diod WLED domyślna wartość prądu jednej diody przy pełnej bieli to „55mA (typ. 5V WS281x)”. Przy takim założeniu:

  • 30 diod: 30 × 55 mA = 1,65 A,
  • 60 diod: 60 × 55 mA = 3,3 A,
  • 150 diod: 150 × 55 mA = 8,25 A.

To wartości dla najgorszego przypadku, czyli pełnej bieli. W poradniku okablowania WLED są praktyczne zasady dla instalacji różnej wielkości:

  • Poniżej 30 diod. Taśmę można zasilić przez port USB płytki, jeśli ogranicznik jasności jest włączony, a między złączem USB a pinem 5 V nie ma stabilizatora ani diody. Przez port USB płytki nie należy nigdy pobierać więcej niż 1 A.
  • Od 30 do 300 diod. Taśmę zasilaj bezpośrednio z zasilacza, a sterownik podłącz równolegle. Powyżej 150 diod warto doprowadzić zasilanie w kilku miejscach taśmy, zwykle na początku i na końcu, dodatkowymi przewodami z tego samego zasilacza. Typowym objawem takiej potrzeby są przyciemnione lub przebarwione diody na dalekim końcu. Według poradnika przewody dodatkowego zasilania nie powinny być cieńsze niż 22 AWG.
  • Powyżej 100 W. Dodaj bezpieczniki. Każdy bezpiecznik umieść jak najbliżej zasilacza, na przewodzie dodatnim, i dobierz go nieco powyżej spodziewanego prądu. Przykład z dokumentacji: przy maksymalnym poborze 4,5 A wystarczy bezpiecznik 5 A.

Nie przesadzaj też w drugą stronę. W poradniku jest zalecenie, aby 30 diod zasilać z zasilacza 10 W (2 A przy 5 V), a nie 100 W, bo w razie zwarcia przez cienkie przewody popłynie wtedy mniej energii. Jest tam też ostrzeżenie, że tanie zasilacze bywają przyczyną migotania taśm adresowalnych. Wybierz model sprawdzony z taśmami WS2812 lub SK6812, a nie tylko z analogowymi.

Przy kilku zasilaczach nigdy nie łącz ich wyjść dodatnich na jednej taśmie. Podziel diody na odcinki, każdy z własnym zasilaczem, i połącz tylko masy.

Podłącz sterownik

Taśma cyfrowa w najprostszej postaci ma trzy połączenia: zasilanie, dane i masę.

  1. Dane. W ESP32 do tego celu zalecany jest GPIO16. Według skróconej instrukcji można też użyć GPIO 4, 13 oraz 16-33, a pozostałe piny nie są zalecane. Oznaczenia na płytkach różnią się w zależności od producenta, więc sprawdź schemat wyprowadzeń swojej płytki i posługuj się numerami GPIO. W ESP8266 zalecany jest GPIO2, na większości płytek oznaczony jako D4.
  2. Masa. Połącz masę ESP z masą taśmy. To konieczne także wtedy, gdy sterownik i taśma mają osobne zasilacze.
  3. Kierunek. Na taśmie są nadrukowane małe strzałki. Linię danych podłącz od strony, z której strzałki wychodzą. Podłączenie do niewłaściwego końca jest pierwszym punktem na liście „Top 5 mistakes” w dokumentacji WLED.
  4. Konwerter poziomów logicznych. ESP32 ma wyjścia o poziomie 3,3 V. Według skróconej instrukcji, jeśli przewodu danych nie da się poprowadzić krótko, potrzebny jest konwerter poziomów. Na schematach WLED jest układ SN74AHCT125 (lub SN74HCT125). Jego wejścia blokady wyjść (1OE do 4OE) połącz z masą, nieużywane wejścia również połącz z masą, a nieużywane wyjścia zostaw niepodłączone.

Przy liniach danych dłuższych niż kilka metrów w dokumentacji WLED opisano jeszcze jedno rozwiązanie: parę nadajnik-odbiornik RS485. Według dokumentacji powyżej mniej więcej 5 m trudno utrzymać czysty sygnał, a przy transmisji różnicowej przez skrętkę z kabla Cat5e sygnał dociera na odległość kilkudziesięciu metrów.

Wgraj WLED z przeglądarki

Najprostsza metoda to instalator w przeglądarce pod adresem https://install.wled.me.

  1. Użyj komputerowej wersji przeglądarki Chrome, Edge lub Opera albo Firefoksa w wersji 151 lub nowszej. Safari się nie nadaje, bo brakuje w niej funkcji potrzebnej do komunikacji z płytką.
  2. Podłącz ESP32 przez USB i wykonaj kroki instalatora.
  3. W Linuksie, jeśli port szeregowy jest widoczny na liście, ale nie da się go otworzyć, dodaj swoje konto do grupy z dostępem do tego portu.

Płytki z pamięcią flash mniejszą niż 4 MB nie są obsługiwane przez instalator. Opis innych metod, w tym wgrywania narzędziem esptool, jest na stronie „Install WLED Binary”. Przy samodzielnym pobieraniu plików pamiętaj, że WLED_x.x.x_ESP32.bin jest przeznaczony dla klasycznych układów ESP32, a nie dla ESP32-S2, S3 ani C3.

Jeśli wgrywanie się powiodło, pierwsze 30 diod świeci na pomarańczowo. Taśma analogowa świeci na pomarańczowo w całości.

Połącz sterownik z siecią Wi-Fi

  1. W telefonie lub komputerze połącz się z siecią Wi-Fi WLED-AP, używając domyślnego hasła wled1234.
  2. Otwórz w przeglądarce adres http://4.3.2.1 (lub wled.me).
  3. Kliknij ikonę konfiguracji (koło zębate) i wybierz WiFi Setup.
  4. Wybierz Scan albo wpisz nazwę sieci, a potem hasło do Wi-Fi. Wielkość liter ma znaczenie.
  5. Ustaw mDNS address, na przykład wled-salon.
  6. Zmień AP password. Domyślne hasło wled1234 jest takie samo we wszystkich urządzeniach WLED.
  7. Kliknij Save & Connect, a potem połącz telefon lub komputer z powrotem z domową siecią.
  8. Otwórz adres http://wled-salon.local. Jeśli nazwa .local nie działa na danym urządzeniu, znajdź adres IP w aplikacji WLED albo na liście urządzeń w routerze.

Po dołączeniu sterownika do domowej sieci adresy 4.3.2.1 i wled.me przestają działać.

Na tej samej stronie w ustawieniu AP opens wybiera się, kiedy punkt dostępu ma się ponownie włączyć. Do wyboru są opcje „No connection after boot”, „Disconnected”, „Always”, „Never (not recommended)” i „Temporary (no connection after boot)”.

Skonfiguruj wyjście LED i limit prądu

Otwórz konfigurację, a potem LED Preferences:

  • Type: układ zastosowany w taśmie. Domyślnie „WS281x RGB”. Niektóre taśmy wymagają innego typu. Przykład z dokumentacji: WS2814 trzeba ustawić jako SK6812, a nie WS281x.
  • Color order: domyślnie GRB. Jeśli czerwony i zielony są zamienione, wypróbuj inną kolejność.
  • Length: liczba diod.
  • GPIO: pin danych, na przykład 16.
  • Enable automatic brightness limiter: domyślnie włączony. Po włączeniu ogólna jasność jest automatycznie obniżana tak, aby szacowany prąd nie przekraczał wartości Maximum PSU Current. Do szacowania służy ustawienie mA/LED (domyślnie „55mA (typ. 5V WS281x)”). Ogranicznik nie działa dla diod analogowych (PWM) ani wirtualnych.

Maximum PSU Current ustaw nieco poniżej prądu, jaki faktycznie są w stanie dostarczyć zasilacz i przewody. Po wgraniu oprogramowania sprawdź tę wartość. W dokumentacji WLED są dwie różne wartości domyślne: na stronie ustawień jest 3000 mA, a w poradniku okablowania i na stronie „Top 5 mistakes” 850 mA. Przy zbyt niskim limicie i wielu diodach objaw jest typowy: diody nie świecą albo po zmianie koloru błyskają i gasną. Przy zbyt wysokim limicie pobór prądu może przekroczyć możliwości zasilacza lub przewodów.

Jasność można też ograniczyć na stałe ustawieniem Global brightness factor (1-100 %).

Zabezpiecz urządzenie

W dokumentacji WLED model bezpieczeństwa opisano otwarcie. Założeniem jest zaufana sieć, a każdy, kto ma do niej dostęp, może zrobić z urządzeniem prawie wszystko. Połączenia odbywają się przez nieszyfrowany protokół HTTP. W praktyce:

  • Zmień oba domyślne hasła. Hasło punktu dostępu (wled1234) zmienia się w WiFi Setup, a hasło aktualizacji (wledota) w ustawieniach bezpieczeństwa (Security settings).
  • Włącz blokadę aktualizacji bezprzewodowych. W ustawieniach bezpieczeństwa zaznacz Lock wireless (OTA) software update. Bez hasła nikt nie wgra wtedy nowego oprogramowania przez Wi-Fi. To ważne, bo hasło do Wi-Fi jest zapisane w urządzeniu bez szyfrowania, a złośliwe oprogramowanie mogłoby je przekazać atakującemu.
  • Ustaw PIN do ustawień (4 cyfry), jeśli z sieci korzystają inne osoby. PIN jest przesyłany bez szyfrowania, więc nie używaj kodu, który służy ci gdzie indziej. Według FAQ o blokadzie aktualizacji po wpisaniu PIN-u ustawienia są dostępne przez 15 minut.
  • Pamiętaj, czego nie da się zabezpieczyć. Według FAQ samego sterowania oświetleniem nie da się chronić hasłem. Każdy, kto ma dostęp do adresu IP urządzenia, może zmieniać światło.
  • Nie wystawiaj urządzenia do internetu. W FAQ jest prośba, aby przy przekierowaniu portu włączyć blokadę aktualizacji i nigdy nie zmieniać haseł Wi-Fi ani aktualizacji przez przekierowany port. Przy połączeniu VPN z domową siecią ten problem w ogóle nie występuje.
  • Uważaj na sieci VLAN. Po włączeniu opcji Only allow update from same network/WiFi próby wgrania oprogramowania z innych podsieci są odrzucane. Jeśli urządzeniami IoT zarządzasz z innej sieci VLAN, w dokumentacji jest zalecenie, aby ustawić PIN albo wyłączyć tę opcję. Po jej wyłączeniu urządzenie jest jednak gorzej chronione.

W sekcji Backup & Restore na tej samej stronie można pobrać zapisane ustawienia i konfigurację w plikach JSON. Hasła nie trafiają do kopii zapasowej.

Zaktualizuj oprogramowanie

Aktualizacja przez Wi-Fi wygląda tak:

  1. W ustawieniach bezpieczeństwa odznacz blokadę aktualizacji i wpisz hasło.
  2. Zapisz ustawienia i uruchom urządzenie ponownie.
  3. Przyciskiem Update WLED (w skróconej instrukcji ta funkcja nazywa się „Manual OTA update”) wgraj nowy plik wydania przeznaczony dla danej płytki.
  4. Ponownie włącz blokadę i uruchom urządzenie ponownie.

Komunikat „OTA lock active” na stronie aktualizacji oznacza, że blokada jest nadal włączona.

Steruj z poziomu skryptów

WLED udostępnia interfejs JSON pod adresem /json. Stan oświetlenia zmienia się żądaniem POST wysłanym na /json/state. Po wysłaniu poniższego polecenia z dokumentacji światło przechodzi w stan przeciwny, a w odpowiedzi przychodzi nowy stan:

curl -X POST "http://wled-salon.local/json/state" -d '{"on":"t","v":true}' -H "Content-Type: application/json"

Według tej samej strony treść {"on":true,"bri":255} oznacza włączenie światła z pełną jasnością:

curl -X POST "http://wled-salon.local/json/state" -d '{"on":true,"bri":255}' -H "Content-Type: application/json"

W dokumentacji opisano też MQTT, E1.31/Art-Net, synchronizację UDP między urządzeniami WLED oraz współpracę z systemami automatyki domowej.

Sprawdź najczęstsze błędy

Według strony „Top 5 mistakes” najczęściej przyczyną problemów są:

  1. Linia danych podłączona do niewłaściwego końca taśmy (sprawdź strzałki).
  2. Zły numer GPIO w LED Preferences. Na płytce D1 mini oznaczenia typu D4 nie są numerami GPIO.
  3. Zbyt niski limit prądu przy dużej liczbie diod.
  4. Zły typ diod lub kolejność kolorów.
  5. Wadliwe okablowanie: luźne styki, zimne luty, zbyt cienkie przewody albo kilka zasilaczy bez wspólnej masy.