Control WS2812B and many more types of digital RGB LEDs with an ESP8266 or ESP32 over WiFi!
1ecbaf2c7f
* Rawframe edit: * - TESTED ON WLED VS.0.10.1 - WHERE ONLY PRESET 16 SAVES SEGMENTS - some macros may not be needed if this changes. * - Code has been modified as my usage changed, as such it has poor use of functions vs if thens, but feel free to change it for me :) * * Edited to SWITCH between two lighting scenes/modes : STANDBY and HIGHLIGHT * * Usage: * - Standby is the default mode and Highlight is activated when the PIR detects activity. * - PIR delay now set to same value as Nightlight feature on boot but otherwise controlled as normal. * - Standby and Highlight brightness can be set on the fly (default values set on boot via macros calling presets). * - Macros are used to set Standby and Highlight states (macros can load saved presets etc). * * - Macro short button press = Highlight state default (used on boot only and sets default brightness). * - Macro double button press = Standby state default (used on boot only and sets default brightness). * - Macro long button press = Highlight state (after boot). * - Macro 16 = Standby state (after boot). * * ! It is advised not to set 'Apply preset at boot' or a boot macro (that activates a preset) as we will call our own macros on boot. * * - When the strip is off before PIR activates the strip will return to off for Standby mode, and vice versa. * - When the strip is turned off while in Highlight mode, it will return to standby mode. (This behaviour could be changed easily if for some reason you wanted the lights to go out when the pir is activated). * - Macros can be chained so you could do almost anything, such as have standby mode also turn on the nightlight function with a new time delay. * * Segment Notes: * - It's easier to save the segment selections in preset than apply via macro while we a limited to preset 16. (Ie, instead of selecting sections at the point of activating standby/highlight modes). * - Because only preset 16 saves segments, for now we are having to use additional macros to control segments where they are involved. Macros can be chained so this works but it would be better if macros also accepted json-api commands. (Testing http api segment behaviour of SS with SB left me a little confused). * * Future: * - Maybe a second timer/timetable that turns on/off standby mode also after set inactivity period / date & times. For now this can be achieved others ways so may not be worth eating more processing power. |
||
|---|---|---|
| .github | ||
| .vscode | ||
| images | ||
| include | ||
| lib | ||
| test | ||
| tools | ||
| usermods | ||
| wled00 | ||
| .gitignore | ||
| .travis.yml | ||
| CHANGELOG.md | ||
| CODE_OF_CONDUCT.md | ||
| LICENSE | ||
| package-lock.json | ||
| package.json | ||
| platformio_override.ini.example | ||
| platformio.ini | ||
| readme.md | ||
| wled00.sln | ||
Welcome to my project WLED! ✨
A fast and feature-rich implementation of an ESP8266/ESP32 webserver to control NeoPixel (WS2812B, WS2811, SK6812, APA102) LEDs or also SPI based chipsets like the WS2801!
⚙️ Features
- WS2812FX library integrated for over 100 special effects
- FastLED noise effects and 50 palettes
- Modern UI with color, effect and segment controls
- Segments to set different effects and colors to parts of the LEDs
- Settings page - configuration over network
- Access Point and station mode - automatic failsafe AP
- Support for RGBW strips
- 16 user presets to save and load colors/effects easily, supports cycling through them.
- Macro functions to automatically execute API calls
- Nightlight function (gradually dims down)
- Full OTA software updatability (HTTP + ArduinoOTA), password protectable
- Configurable analog clock + support for the Cronixie kit by Diamex
- Configurable Auto Brightness limit for safer operation
💡 Supported light control interfaces
- WLED app for Android and iOS
- JSON and HTTP request APIs
- MQTT
- Blynk IoT
- E1.31, Art-Net and TPM2.net
- Hyperion
- UDP realtime
- Alexa voice control (including dimming and color)
- Sync to Philips hue lights
- Adalight (PC ambilight via serial) and TPM2
- Sync color of multiple WLED devices (UDP notifier)
- Infrared remotes (24-key RGB, receiver required)
- Simple timers/schedules (time from NTP, timezones/DST supported)
📲 Quick start guide and documentation
See the wiki!
DrZzs has made some excellent video guides:
Introduction, hardware and installation
Settings, tips and tricks
If you'd rather read, here is a very detailed step-by-step beginner tutorial by tynick!
Russian speakers, check out the videos by Room31:
WLED Firmware Overview: Interface and Settings
ESP8266 based LED controller for WS2812b strip. WLED Firmware + OpenHAB
🖼️ Images
💾 Compatible LED Strips
| Type | Voltage | Comments |
|---|---|---|
| WS2812B | 5v | |
| WS2813 | 5v | |
| SK6812 | 5v | RGBW |
| APA102 | 5v | C/D |
| WS2801 | 5v | C/D |
| LPD8806 | 5v | C/D |
| TM1814 | 12v | RGBW |
| WS2811 | 12v | 3-LED segments |
| WS2815 | 12v | |
| GS8208 | 12v |
🧊 Compatible PC RGB Fans and ARGB accessories
| Brand | Model | Comments |
|---|---|---|
| Corsair | HD120 Fan | Uses WS2812B, data-in only |
| PCCOOLER | Moonlight 5-pack Fans | Uses WS2812B, includes Data-out connector to keep each fan uniquely addressable if wired in series like traditional LED strips |
| Any | 5v 3-pin ARGB for PC | Any PC RGB device that supports the 5v 3-pin ARGB motherboard header should work fine with WLED. All the major motherboard vendors support the Corsair HD120 and PCCOOLER fans listed, so we can safely assume any device that supports motherboard ARGB 5V 3-Pin standard will work with WLED. |
✌️ Other
Licensed under the MIT license
Credits here!
Uses Linearicons by Perxis!
Join the Discord server to discuss everything about WLED!
Check out the WLED Discourse forum!
You can also send me mails to dev.aircoookie@gmail.com, but please only do so if you want to talk to me privately.
If WLED really brightens up your every day, you can 
Disclaimer:
If you are sensitive to photosensitive epilepsy it is not recommended that you use this software.
In case you still want to try, don't use strobe, lighting or noise modes or high effect speed settings.
As per the MIT license, I assume no liability for any damage to you or any other person or equipment.