lba.gitea/WLED
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Control WS2812B and many more types of digital RGB LEDs with an ESP8266 or ESP32 over WiFi!
36 Commits 17 Branches 42 Tags 125 MiB
C++ 56.6%
C 30.1%
HTML 7.4%
JavaScript 4.1%
CSS 1.5%
Other 0.3%
e9ae7c34c7
Go to file
cschwinne e9ae7c34c7 Added (highly unstable and experimental) NTP time support 
Added timezones library (CET for now, you can easily adapt it to your timezone however)
Added overlays to support both digital and analog clockfaces, basic countdown
Improved serial debug
Included license notes in settings file
Added a bit of guides to readme file

Warning! Using NTP usually results in a complete system crash after 1-48 hours.
Please only enable it if you are willing to experiment with it.
To get a proper WLED experience, make sure the checkbox for NTP is disabled in settings!
2017-01-15 00:24:28 +01:00
wled00 Added (highly unstable and experimental) NTP time support 2017-01-15 00:24:28 +01:00
LICENSE included MIT license 2016-12-29 00:19:22 +01:00
readme.md Added (highly unstable and experimental) NTP time support 2017-01-15 00:24:28 +01:00
TODO.txt included MIT license 2016-12-29 00:19:22 +01:00

readme.md

WLED is a basic, fast and (relatively) (ok, VERY relatively) secure implementation of a ESP8266 webserver to control Neopixel (WS2812B) leds

Uses ESP8266 Arduino libraries from 15th August 2016! Untested with newer version! Contents in the /data directory need to be uploaded to SPIFFS.

Features: (V0.2)

  • RGB and brightness sliders
  • Settings page - configuration over network
  • Access Point and station mode - automatic failsafe AP
  • Edit page. Change html and other files via OTA.

Additions for V0.3 (nearly complete!)

  • WS2812FX library integrated for nearly 50 special effects!
  • Nightlight function (gradually dims down)
  • Notifier function (multiple ESPs sync color via UDP broadcast)
  • Support for power pushbutton
  • Full OTA software update capability
  • Password protected OTA page for added security (OTA lock)

Compile settings: Board: WeMos D1 mini CPU frequency: 80 MHz Flash size : 4MB (1MB settings) Upload speed: 115200

Quick start guide:

  1. Make sure your ESP module has a min. 4MB SPI flash module. (currently working on supporting 1MB modules) Connect a WS2812B RGB led strip to GPIO2. Optionally connect a NO-pushbutton to GPIO0 (internal pull-up) and ground.

  2. Follow a guide to setup your Arduino client (I am using version 1.6.9) with the ESP8266 libraries. For current compiles I use an old version from 15th August 2016.

  3. You will also need the ESP8266 SPIFFS sketch data uploader. (currently working on making this step unnecessary)

  4. In file "wled00.ino", change the LED count to the amount you connected. Proceed to flash the sketch and the SPIFFS data. You should also change the access point and OTA update passphrases for added security (you can change them later, this is just the "factory default").

  5. Connect to automatically started WiFi access point "WLED-AP" using default passwort "wled1234". Go to the IP "192.168.4.1".

  6. Click on the wrench icon to edit settings like connecting the module to your home WiFi.

  7. Have fun with the software!

Advanced module control via HTTP requests:

Base URL scheme: "/ajax_in". This will return a XML file with some current values. Add one or multiple of the following parameters after the base url to change values: "&A=<0-255>" set LED brightness (yellow slider) "&R=<0-255>" set LED red value (red slider) "&G=<0-255>" set LED green value (green slider) "&B=<0-255>" set LED blue value (blue slider) "&FX=<0-47>" set LED effect (refer to WS2812FX library) "&SX=<0-255>" set LED effect speed (refer to WS2812FX library) "&NR=<0 or 1>" receive notifications on or off "&NS=<0 or 1>" send (direct) notifications on or off "&NL=<0 or 1>" turns nightlight function on or off ("&OL=<0, 1, 3 or 5>" experimental clock overlays) ("&I=<0-255>" experimental individual LED control) ("&I=<0-255>&I2=<0-255>" experimental individual LED range control)

Software update procedure:

Method 1: Reflash the new update source via USB.

Method 2: The software has an integrated OTA software update capability. First you have to enable it by typing in the correct OTA passphrase (default: "wledota") in the settings menu. Remove the tick in the checkbox "OTA locked". Then save settings and reboot the ESP. Now you can go to "/update" to update binary firmware. To edit flash content (images and HTML), go to "/edit". After you are done, it is recommended to lock the OTA function again. To do so, tick the checkbox again (you can change the passphrase by typing in a new one now). Reboot. If you try to access the update page now, you should see the message "OTA lock active".