2017-12-12 14:52:28 +01:00
## Welcome to my project WLED!
2017-10-28 22:22:37 +02:00
WLED is a basic, fast and (relatively) secure implementation of a ESP8266 webserver to control Neopixel (WS2812B) leds
2016-09-11 23:07:18 +02:00
2017-12-12 14:52:28 +01:00
Uses ESP Arduino core version 2.3.0 (latest as of December 2017).
2016-12-29 00:03:58 +01:00
2017-12-12 14:52:28 +01:00
### Features: (V0.4)
2017-05-08 21:46:04 +02:00
- RGB, HSB, and brightness sliders
2016-09-11 23:07:18 +02:00
- Settings page - configuration over network
- Access Point and station mode - automatic failsafe AP
2017-12-12 14:52:28 +01:00
- WS2812FX library integrated for over 50 special effects!
- Secondary color support lets you use even more effect combinations
2017-10-28 22:22:37 +02:00
- Support for RGBW strips
2017-12-12 14:52:28 +01:00
- 25 user presets! Save your favorite colors and effects and apply them easily!
2016-12-29 00:03:58 +01:00
- Nightlight function (gradually dims down)
- Notifier function (multiple ESPs sync color via UDP broadcast)
- Support for power pushbutton
2017-12-12 14:52:28 +01:00
- Custom Theater Chase
2016-12-29 00:03:58 +01:00
- Full OTA software update capability
- Password protected OTA page for added security (OTA lock)
2017-02-21 23:59:47 +01:00
- Alexa smart home device server
2017-12-19 16:12:51 +01:00
- NTP and experimental analog clock function
- Realtime UDP Packet Control (WARLS) possible
2017-05-08 21:46:04 +02:00
- client HTML controlled
2017-05-08 21:00:06 +02:00
- Edit page. Change html and other files via OTA. (needs to be enabled in source)
2017-01-15 00:24:28 +01:00
2017-12-12 14:52:28 +01:00
### Compile settings:
- Board: WeMos D1 mini (untested with other HW, should work though)
- CPU frequency: 80 MHz
- Flash size : 4MB (3MB SPIFFS)
- Upload speed: 921600
2017-01-15 00:24:28 +01:00
2017-12-12 14:52:28 +01:00
### Quick start guide:
2017-01-15 00:24:28 +01:00
2017-12-12 14:52:28 +01:00
- If you do not plan to change the software, you can use the supplied binary files instead-
Just flash a [basic HTTP OTA updater ](https://github.com/Aircoookie/ESP8266MinimalHTTPUpdater ) sketch and upload the bin!
2017-02-24 23:21:48 +01:00
2017-12-12 14:52:28 +01:00
1. Connect a WS2812B RGB led strip to GPIO2. Optionally connect a NO-pushbutton to GPIO0 (internal pull-up) and ground.
2017-01-15 00:24:28 +01:00
2017-02-01 21:25:09 +01:00
2. Follow a guide to setup your Arduino client (I am using version 1.8.1) with the ESP8266 libraries.
2017-04-26 14:04:53 +02:00
For current compiles I use version 2.3.0.
2017-01-15 00:24:28 +01:00
2017-05-08 21:00:06 +02:00
3. In file "wled00.ino", you should change the access point and OTA update passphrases for added security (you can change them later, this is just the "factory default"). Flash the sketch.
2017-12-12 14:52:28 +01:00
You will need to install the NeoPixelBus library by Makuna. All other dependencies are included with WLED for convenience.
2017-01-15 00:24:28 +01:00
5. Connect to automatically started WiFi access point "WLED-AP" using default passwort "wled1234". Go to the IP "192.168.4.1".
2017-05-08 21:00:06 +02:00
6. Click on the cog icon to edit settings like connecting the module to your home WiFi.
2017-01-15 00:24:28 +01:00
7. Have fun with the software!
2017-12-19 16:12:51 +01:00
### Advanced module control via HTTP requests API or UDP:
2017-01-15 00:24:28 +01:00
2017-12-12 15:54:23 +01:00
See the [wiki ](https://github.com/Aircoookie/WLED/wiki/HTTP-request-API )!
2017-12-12 14:52:28 +01:00
### Other
2017-01-15 00:24:28 +01:00
2017-02-21 23:59:47 +01:00
Licensed under the MIT license
Uses libraries:
2017-12-12 14:52:28 +01:00
ESP8266 Arduino Core
NeoPixelBus by Makuna
[WS2812FX ](https://github.com/kitesurfer1404/WS2812FX ) by kitesurfer1404 (Aircoookie fork)
Time library
2017-02-21 23:59:47 +01:00
Timezone library by JChristensen
arduino-esp8266-alexa-multiple-wemo-switch by kakopappa
2017-12-12 14:52:28 +01:00
Uses Linearicons by Perxis! (link in settings page)
2017-02-05 00:12:35 +01:00
2017-01-15 00:24:28 +01:00