Instalasi WLED pada ESP32: Kendalikan LED Addressable Tanpa Coding

Instalasi WLED adalah cara tercepat untuk mengubah ESP32 menjadi pengendali LED Wi-Fi tanpa menulis satu baris kode pun. WLED merupakan firmware gratis dan sumber terbuka yang dibuat untuk mengendalikan LED strip, cincin, dan matrix addressable seperti WS2812B. Firmware ini ditulis ke board dari browser hanya dengan beberapa klik; setelah itu kamu bisa memilih lebih dari 100 efek, puluhan palet warna, timer, dan animasi reaktif musik melalui ponsel atau komputer. Pencahayaan di belakang TV, lampu rak, lampu tangga, atau dekorasi Natal semuanya bisa memakai pengaturan yang sama.

Dalam panduan ini kamu akan melihat langkah demi langkah cara menghubungkan ESP32, LED strip, dan catu daya dengan benar, menginstal WLED dengan installer web, melakukan pengaturan Wi-Fi pertama, serta mengatur jumlah LED, pin data, dan urutan warna. Setelah itu kamu akan mempelajari penggunaan efek, palet, segmen, dan preset, cara menghitung daya dan memasoknya di sepanjang strip yang panjang, cara menyinkronkan lampu dengan musik memakai mikrofon I2S, serta cara mengintegrasikannya dengan Home Assistant. Pada bagian akhir tersedia dua program singkat untuk mengendalikan WLED melalui JSON API dari ESP32 lain dan Raspberry Pi Pico W, beserta solusi untuk masalah paling umum.

Apa itu WLED dan apa saja kemampuannya?

Biasanya, untuk mengendalikan LED addressable kamu menulis kode di Arduino IDE dengan Adafruit NeoPixel atau FastLED dan memprogram ulang board untuk setiap perubahan. WLED mengubah cara ini sepenuhnya: board diprogram sekali, lalu semua pengaturan, efek, dan jadwal ditangani melalui antarmuka web milik board itu sendiri. ESP32 bergabung ke Wi-Fi rumahmu, menjalankan web server, dan perangkat apa pun di jaringan yang sama dapat mengaksesnya melalui browser atau aplikasi ponsel. Pengaturan disimpan dalam memori flash board, sehingga setelah listrik padam lampu melanjutkan kondisi sebelumnya.

• LED yang didukung: WS2812B, WS2811, WS2813, WS2815, SK6812 (termasuk RGBW), TM1814, serta LED dengan sinyal clock seperti APA102 dan SK9822.
• Efek dan palet: Lebih dari 100 efek bawaan dan lebih dari 70 palet warna; setiap efek dapat diatur dengan penggeser kecepatan dan intensitas.
• Segmen: Bagi satu strip menjadi beberapa bagian, lalu beri setiap bagian efek dan warna tersendiri.
• Preset dan playlist: Simpan tampilan yang kamu sukai dan panggil kembali dengan satu ketukan, atau buat daftar yang berganti secara berurutan.
• Timer: Lampu yang menyala atau mati pada waktu tertentu, ketika matahari terbit atau terbenam, ditambah timer tidur.
• Integrasi: Berkomunikasi dengan sistem lain di jaringan melalui Home Assistant, MQTT, Alexa, E1.31, dan Art-Net.

Yang kamu perlukan

Catatan kompatibilitas: WLED juga berjalan pada board berbasis ESP8266 (NodeMCU, Wemos D1 mini), tetapi karena memori dan kemampuan pemrosesannya lebih terbatas, board tersebut menangani lebih sedikit LED, dan fitur reaktif musik hanya tersedia pada ESP32. Karena itu, kami menyarankan ESP32 untuk proyek baru, dan seluruh panduan ini ditulis untuk ESP32. Raspberry Pi Pico tidak bisa menjalankan WLED; untuk mengendalikan LED addressable dengan Pico, kamu bisa memakai modul neopixel MicroPython, atau, seperti pada contoh JSON API di bawah, memakai Pico W untuk mengendalikan ESP32 yang menjalankan WLED dari jarak jauh.

Pengkabelan: ESP32, LED strip, dan catu daya

Menginstal WLED dengan installer web

Kamu tidak memerlukan Arduino IDE atau program lain untuk menginstal WLED. Installer web resmi (install.wled.me) terhubung langsung ke ESP32 melalui fitur Web Serial browser, mendeteksi chip board, dan menulis firmware yang sesuai. Cara ini bekerja pada browser desktop berbasis Chromium seperti Chrome, Edge, dan Opera; sekarang Firefox dan Safari belum mendukung Web Serial. Agar board muncul sebagai port serial pada komputermu, driver CP210x atau CH340 harus terinstal.

1. Hubungkan ESP32 ke komputer dengan kabel USB yang dapat membawa data. Kamu belum perlu menghubungkan LED strip.
2. Buka installer web WLED di Chrome atau Edge. Dari daftar versi, pilih rilis stabil terbaru; versi beta digunakan untuk pengujian.
3. Tekan tombol Install. Pada jendela yang terbuka, pilih port board-mu (misalnya COM3 pada Windows, cu.usbserial... atau cu.wchusbserial... pada macOS), lalu klik Connect.
4. Setelah installer mendeteksi chip, konfirmasikan opsi Install WLED. Jika board sebelumnya dipakai untuk program lain, menghapus memori dengan “Erase device” mencegah pengaturan lama tercampur.
5. Penulisan memerlukan sekitar satu menit. Jika upload tidak dimulai, tahan tombol BOOT ESP32 dan coba lagi.
6. Ketika instalasi selesai, installer meminta detail Wi-Fi-mu. Masukkan nama jaringan dan kata sandi, lalu klik Connect; setelah itu buka antarmuka WLED melalui tautan Visit Device yang muncul.

Pengaturan Wi-Fi pertama

Jika kamu melewati langkah Wi-Fi pada installer, atau board tidak bisa bergabung ke jaringan, WLED membuka access point sendiri. Hubungkan ponselmu ke jaringan bernama WLED-AP; kata sandi bawaannya adalah wled1234. Pada sebagian besar ponsel, halaman pengaturan terbuka otomatis; jika tidak, ketik 4.3.2.1 di browser. Pada halaman WiFi Setup, masukkan nama dan kata sandi jaringan rumahmu, simpan, lalu tunggu board memulai ulang. ESP32 hanya mendukung Wi-Fi 2,4 GHz; jika router memakai nama yang sama untuk 2,4 dan 5 GHz, biasanya tidak masalah, tetapi ESP32 tidak bisa bergabung ke jaringan yang hanya memancarkan pada 5 GHz. Setelah terhubung, kamu bisa menemukan alamat IP board di daftar perangkat terhubung pada router atau melalui penemuan otomatis aplikasi WLED. Sebaiknya ganti juga kata sandi access point pada halaman yang sama demi keamanan.

Jumlah LED, pin data, dan urutan warna

1. Pada antarmuka WLED, buka menu Config (ikon roda gigi), lalu masuk ke LED Preferences.
2. Di bagian LED outputs, pilih jenis LED: “WS281x” untuk WS2812B, “SK6812/WS2814 RGBW” untuk strip RGBW.
3. Atur Color Order ke GRB untuk WS2812B; jika warna yang muncul salah, ubah kolom ini sampai menemukan urutan yang benar.
4. Pada Length, masukkan jumlah LED pada strip (misalnya 60 untuk 1 m strip dengan 60 LED/m).
5. Pada GPIO, masukkan pin tempat kabel data terhubung (16 dalam panduan ini). GPIO 6–11 dicadangkan untuk memori flash dan 34–39 hanya bisa menjadi input; jangan gunakan pin tersebut.
6. Pada Maximum Current (pembatas kecerahan otomatis), masukkan sekitar 80% arus yang dapat diberikan catu dayamu dalam mA; 3200 untuk catu daya 5 V 4 A.
7. Tekan Save di bagian bawah halaman. Kembali ke layar utama dan pilih warna; seluruh strip seharusnya menyala dengan warna tersebut.

Efek, palet, segmen, dan preset

Layar utama WLED memiliki tiga bagian: pemilih warna dan kecerahan di atas, daftar efek di tengah, serta daftar palet di sampingnya. Ketika kamu memilih efek (misalnya Rainbow, Fire 2012, Twinkle), penggeser Speed dan Intensity di bawahnya mengubah kecepatan dan kepadatannya. Palet menentukan kelompok warna yang dipakai efek: efek “Colorwaves” yang sama terlihat seperti gelombang biru dengan palet “Ocean” dan seperti api merah dengan “Lava”. Jika kamu ingin efek memakai warna pilihanmu, pilih palet seperti “Default” atau “Color 1”.

• Segmen: Bagi strip menjadi beberapa bagian di bagian Segments; misalnya, LED 0–29 dapat meredup dan terang perlahan dalam warna biru, sementara 30–59 menampilkan pelangi. Setiap segmen memiliki efek, palet, kecerahan, dan arah tersendiri.
• Preset: Beri nama dan simpan tampilan yang kamu sukai di bagian Presets. Preset menyimpan efek, warna, segmen, dan kecerahan sekaligus, lalu mengembalikannya dengan satu ketukan.
• Playlist: Buat daftar yang memutar beberapa preset secara berurutan dengan durasi pilihanmu; ideal untuk etalase toko atau lampu pesta.
• Timer: Atur zona waktumu pada halaman Config > Time & Macros, lalu jalankan preset pada waktu tertentu, ketika matahari terbit, atau ketika matahari terbenam.
• Lampu malam: Tombol bulan meredupkan lampu secara perlahan lalu mematikannya dalam durasi pilihanmu; berguna untuk kamar anak.
• Sinkronisasi: Beberapa perangkat WLED di jaringan yang sama dapat terhubung melalui UDP dan menjalankan efek yang sama secara bersamaan.

Aplikasi ponsel

Antarmukanya bekerja di browser apa pun, tetapi untuk penggunaan sehari-hari, aplikasi WLED gratis untuk iOS dan Android lebih praktis. Aplikasi ini menemukan perangkat WLED di jaringan yang sama secara otomatis, menampilkannya dalam daftar, dan membuka antarmuka milik board ketika kamu mengetuk salah satunya. Jika kamu memiliki beberapa perangkat (misalnya di ruang tamu, dapur, dan tangga), kamu bisa mengendalikan semuanya dari satu layar. Jika perangkat tidak muncul dalam daftar, pastikan ponsel dan ESP32 berada di jaringan yang sama, atau tambahkan alamat IP secara manual. Karena aplikasi hanya berfungsi sebagai antarmuka, ponsel tidak perlu tetap menyala agar lampu bekerja; timer dan preset terus berjalan di dalam ESP32.

Perhitungan kebutuhan daya dan injeksi daya

Satu LED WS2812B berisi tiga LED kecil, merah, hijau, dan biru, yang masing-masing menarik sekitar 20 mA pada kecerahan penuh. Jadi, satu piksel memerlukan sekitar 60 mA pada putih penuh. Itulah kondisi terburuk; dengan efek berwarna dan kecerahan sedang, konsumsi sebenarnya sering kali sekitar sepertiganya. Pengaturan Maximum Current WLED (pembatas kecerahan otomatis) menghitung arus yang akan ditarik setiap frame dan menurunkan kecerahan secara otomatis jika arus akan melampaui batas. Berkat fitur ini, kamu bisa menjalankan strip dengan 300 LED secara aman dari catu daya 5 V 10 A; hanya putih penuh yang menjadi sedikit lebih redup. Batas bawaan dibuat rendah agar board tetap aman ketika mendapat daya dari USB, jadi pastikan kamu memperbaruinya ketika beralih ke catu daya eksternal.

• Jatuh tegangan: Jalur tembaga pada strip 5 V tipis; ketika arus meningkat, tegangan turun menuju ujung strip dan warna putih terlihat kekuningan atau kemerahan muda. Ini biasanya mulai terjadi setelah 1–2 meter (60–120 LED).
• Injeksi daya: Tarik kabel 5 V dan GND terpisah dari catu daya ke setiap 1–2 meter strip, lalu solder ke pad tembaga strip. Memasok daya ke kedua ujung strip panjang juga efektif. Jalur data hanya masuk di awal; kabel injeksi hanya membawa 5 V dan GND.
• Ukuran kabel: Gunakan minimal 0,75–1 mm² (sekitar 18 AWG) untuk beberapa ampere dan 1,5 mm² untuk 10 A ke atas; kabel bawaan strip yang tipis hanya ditujukan untuk strip pendek.
• Sekring: Pasang sekring di antara catu daya dan strip pada setiap jalur pasokan, dengan rating sesuai kemampuan kabel membawa arus; sekring mencegah kabel terbakar ketika terjadi korsleting.
• Pilihan 12 V: Untuk instalasi yang sangat panjang, strip 12 V seperti WS2815 menarik sepertiga arus untuk daya yang sama dan jauh lebih sedikit terpengaruh jatuh tegangan.
• Kalkulator: Jika kamu membuat sistem portabel dengan baterai atau power bank, hitung waktu pakainya dengan kalkulator umur baterai.

Lampu yang tersinkron dengan musik melalui mikrofon

Build WLED untuk ESP32 menyertakan add-on AudioReactive; hubungkan mikrofon, ubah beberapa pengaturan, lalu efek akan bergerak mengikuti irama dan frekuensi musik. Hasil terbaik diperoleh dengan INMP441, yaitu mikrofon I2S digital: karena sinyal dikirim secara digital, kamu menghindari masalah derau dan penguatan pada mikrofon analog. Modul mikrofon analog seperti MAX9814 atau MAX4466 juga dapat dipakai pada pin ADC1 (misalnya GPIO 36), tetapi memerlukan lebih banyak penyesuaian. Sensor suara seperti KY-038 hanya memberi tahu apakah ada suara, sehingga tidak cocok untuk tugas ini.

Setelah pengkabelan selesai, aktifkan bagian AudioReactive pada halaman Config > Usermods, pilih “Generic I2S” sebagai jenis mikrofon, lalu masukkan pin SD, WS, dan SCK sesuai tabel. Setelah menyimpan dan memulai ulang board, efek yang digerakkan suara akan terlihat jelas dalam daftar efek; GEQ, Gravimeter, dan Waterfall cocok untuk dicoba pertama kali. Jika lampu bergerak-gerak ketika tidak ada suara, naikkan nilai Squelch (ambang derau); jika respons terhadap musik kurang kuat, naikkan Gain. Menempatkan mikrofon di lokasi yang dapat menangkap suara ruangan, bukan tepat di depan speaker, memberikan hasil paling seimbang.

Integrasi Home Assistant

Home Assistant memiliki integrasi WLED bawaan dan biasanya menemukan perangkat WLED di jaringan yang sama secara otomatis. Jika notifikasi “New device discovered” muncul, cukup konfirmasikan; jika tidak, buka Settings > Devices & Services > Add integration, pilih WLED, lalu masukkan alamat IP perangkat. Integrasi ini menambahkan strip dan setiap segmen sebagai lampu terpisah, preset, playlist, dan palet sebagai kotak pilihan, serta kecepatan dan intensitas sebagai penggeser. Dengan begitu, kamu dapat membuat otomatisasi seperti “ubah strip ruang tamu menjadi putih hangat ketika matahari terbenam” atau “nyalakan lorong ketika pintu terbuka” hanya dengan beberapa klik. Jika kamu lebih memilih MQTT, WLED juga bisa terhubung ke broker MQTT melalui halaman Sync Interfaces; penggunaan MQTT dengan Home Assistant telah kita bahas dalam artikel ESP32, MQTT, dan Home Assistant.

Mengendalikan WLED dari kode: JSON API

WLED bekerja tanpa kode, tetapi ketika kamu ingin perangkat lain mengendalikannya, request HTTP sederhana sudah cukup. Pesan JSON yang dikirim ke alamat /json/state perangkat mengubah kondisi lampu: {"on":"t"} membalik kondisi nyala/matinya, {"bri":128} mengatur setengah kecerahan, dan {"ps":2} menjalankan preset nomor 2. Jika kamu menambahkan "v":true ke pesan, WLED membalas dengan kondisi terkini. Program pertama di bawah memakai tombol pada ESP32 terpisah untuk berganti di antara tiga preset pertama pada WLED; program kedua melakukan hal yang sama dengan Raspberry Pi Pico W dan MicroPython. Pada kedua program, masukkan detail jaringanmu sendiri dan alamat IP perangkat WLED.

1// İkinci bir ESP32'den WLED preset değiştirme (JSON API) / Switch WLED presets from a second ESP32 (JSON API)
2// Buton: GPIO 4 -> GND (dahili pull-up) / button: GPIO 4 -> GND (internal pull-up)
3#include <WiFi.h>
4#include <HTTPClient.h>
5
6const char* WIFI_SSID = "AgAdi";                           // ağ adı / network name
7const char* WIFI_PASS = "Sifre";                           // ağ şifresi / network password
8const char* WLED_URL = "http://192.168.1.50/json/state";   // WLED cihazının IP'si / IP of the WLED device
9const int BUTTON_PIN = 4;
10
11int preset = 1;
12bool lastState = HIGH;
13
14int sendJson(const String& body) {
15  HTTPClient http;
16  http.begin(WLED_URL);
17  http.addHeader("Content-Type", "application/json");
18  int code = http.POST(body);                              // 200 = başarılı / success
19  http.end();
20  return code;
21}
22
23void setup() {
24  Serial.begin(115200);
25  pinMode(BUTTON_PIN, INPUT_PULLUP);
26  WiFi.begin(WIFI_SSID, WIFI_PASS);
27  while (WiFi.status() != WL_CONNECTED) {
28    delay(300);
29    Serial.print('.');
30  }
31  Serial.print("\nIP: ");
32  Serial.println(WiFi.localIP());
33}
34
35void loop() {
36  bool state = digitalRead(BUTTON_PIN);
37  if (lastState == HIGH && state == LOW) {                 // butona basıldı / button pressed
38    String body = "{\"on\":true,\"ps\":" + String(preset) + "}";
39    int code = sendJson(body);
40    Serial.printf("Preset %d -> HTTP %d\n", preset, code);
41    preset = preset % 3 + 1;                               // 1 -> 2 -> 3 -> 1
42    delay(50);                                             // basit debounce / simple debounce
43  }
44  lastState = state;
45}

1# Raspberry Pi Pico W: butonla WLED aç/kapat (JSON API) / toggle WLED with a button (JSON API)
2# Buton: GP14 -> GND (dahili pull-up) / button: GP14 -> GND (internal pull-up)
3import network
4import time
5import urequests
6from machine import Pin
7
8SSID = "AgAdi"                                  # ağ adı / network name
9PASSWORD = "Sifre"                              # ağ şifresi / network password
10WLED_URL = "http://192.168.1.50/json/state"     # WLED cihazının IP'si / IP of the WLED device
11
12button = Pin(14, Pin.IN, Pin.PULL_UP)
13
14wlan = network.WLAN(network.STA_IF)
15wlan.active(True)
16wlan.connect(SSID, PASSWORD)
17while not wlan.isconnected():
18    time.sleep(0.3)
19print("IP:", wlan.ifconfig()[0])
20
21last = 1
22while True:
23    now = button.value()
24    if last == 1 and now == 0:                  # butona basıldı / button pressed
25        r = urequests.post(WLED_URL, json={"on": "t", "v": True})
26        state = r.json()                        # güncel durum / current state
27        r.close()
28        print("Acik / On:", state["on"], " Parlaklik / Brightness:", state["bri"])
29        time.sleep_ms(50)                       # basit debounce / simple debounce
30    last = now
31    time.sleep_ms(10)

Pada kedua program, kondisi terkini dibandingkan dengan kondisi sebelumnya agar satu tekanan hanya mengirim satu request, dan jeda 50 ms menyaring pantulan mekanis tombol. Dalam proyek nyata, sebaiknya berikan alamat IP tetap kepada perangkat WLED melalui router, atau gunakan nama mDNS-nya dari antarmuka WLED, karena IP dapat berubah ketika daya terputus dan router memulai ulang. Dengan metode yang sama, kamu bisa menyalakan lampu tangga ketika sensor gerak terpicu, beralih ke preset malam ketika LDR mendeteksi keadaan mulai gelap, atau mengubah warna strip sesuai pembacaan suhu.

Masalah umum dan solusinya

WLED merupakan salah satu cara paling menyenangkan untuk bekerja dengan LED addressable: pengaturannya memerlukan beberapa menit, kamu mendapatkan efek yang tampak profesional tanpa menulis kode, dan ketika diperlukan kamu bisa menghubungkannya ke proyekmu sendiri melalui JSON API. Jika kamu ingin mempelajari cara mengendalikan LED melalui kode, kamu bisa membuat proyek “Kendali Strip NeoPixel WS2812B ESP32” serta proyek LED berjalan WS2812B, Knight Rider, dan lampu polisi dalam aplikasi BlueGrays, langkah demi langkah dengan skema rangkaian dan kode siap pakai.