Skip to content

Latest commit

 

History

History
190 lines (111 loc) · 9.54 KB

README.md

File metadata and controls

190 lines (111 loc) · 9.54 KB
Raw

ESP8266 FastLED IoT Webserver

This is a fork of jasoncoon's esp8266 fastled webserver that was adapted to control the colors of my LED-Projects.

Webinterface

The web app is stored in SPIFFS (on-board flash memory) and has around 400kb. All stylsheets/js used are also stored in the spiffs, so no internet connection is required to view the webpage correctly.

New: Windows application to sync the LED devices with music. Completely optional but it's awesome. But it's just the first prototype and very experimental. Software and docs still work in progress.

https://github.com/NimmLor/IoT-Audio-Visualization-Center

Can be downloaded here.

screenshot_alpha

https://github.com/NimmLor/IoT-Audio-Visualization-Center

What happened here?

All of my recent project were merged into one including most of the features. A new and optional Windows application allows to sync the LEDs to a Windows audio source of your choice.

Supported Devices

Generic LED-Strip, just a regular LED-Strip without special hardware

LED-Matrix, with a flexible LED-Matrix you can display the audio like a Audio Visualizer

3D-Printed 7-Segment Clock, display the time, syncs with a ntp server of your choice

3D-Printed Desk Lamp, a lamp that reacts to sound for your desk

3D-Printed Nanoleafs, a Nanoleaf clone that can be made for cheap

3D-Printed Animated RGB Logos, a small 3D-Printed logo that lights up with style

(soon) 3D-Printed Infinity Mirror, a DIY infinity mirror inspired by Adafruit

3D-Printed IoT Bottle Lighting Pad, a simple but smart lighting for any bottle you want.

Changelog

07.05.2020, Major Code rewrite and merge of projects, audio visualization

  • New features:
    • Audio Visualization with a Windows Desktop Application (C#, WPF) here
    • multicast DNS by @WarDrake
    • OTA Support
    • MQTT/Homeassistant integration by @WarDrake
    • Serial Ambilight for usage behind a TV
    • Support of Desk Lamp, 7-Segment Clock, Animated RGB Logos, Generic LED-Strip
    • WebUI fits now on 1MB devices (esp-01)
    • Dark mode for WebUI

01.02.2020, Native Alexa Update

  • NodeRED part is now DEPRECATED
  • The Nanoleaf Replica allows now for NATIVE Alexa support without the need of an extra Raspberry Pi. When added to the Smart Home devices in the Alexa app, the nanoleafs will appear as Phillips Hue devices.
  • Added Strobe Pattern
  • Added Sound Reactive support
  • Some code cleanup and new parameters to configure
  • New step by step installation instructions (Software_Installation.md)

24.02.2019, NodeRED Update (Depricated)

  • Node-RED integration was added
  • Alexa support via NodeRED

Installation

FOR INSTALLATION REFER TO THE Software_Installation.md

Features

  • Turn the LEDs on and off
  • Appear as an ALEXA SMART HOME DEVICE
  • Sound Reactive Mode
  • Adjust the brightness, color and patterns
  • Play over 30+ patterns in Autoplay

Technical

Patterns are requested by the app from the ESP8266, so as new patterns are added, they're automatically listed in the app.

The web app is stored in SPIFFS (on-board flash memory).

The web app is a single page app that uses jQuery and Bootstrap. It has buttons for On/Off, a slider for brightness, a pattern selector, and a color picker (using jQuery MiniColors). Event handlers for the controls are wired up, so you don't have to click a 'Send' button after making changes. The brightness slider and the color picker use a delayed event handler, to prevent from flooding the ESP8266 web server with too many requests too quickly.

The only drawback to SPIFFS that I've found so far is uploading the files can be extremely slow, requiring several minutes, sometimes regardless of how large the files are. It can be so slow that I've been just developing the web app and debugging locally on my desktop (with a hard-coded IP for the ESP8266), before uploading to SPIFFS and testing on the ESP8266.

Alexa

The code has an optional feature to be able to control the lamp via Alexa on any Amazon Echo device. For setup instructions refer to Software_Installation.md document.

Compression

The web app files can be gzip compressed before uploading to SPIFFS by running the following command:

gzip -r data/

The ESP8266WebServer will automatically serve any .gz file. The file index.htm.gz will get served as index.htm, with the content-encoding header set to gzip, so the browser knows to decompress it. The ESP8266WebServer doesn't seem to like the Glyphicon fonts gzipped, though, so I decompress them with this command:

gunzip -r data/fonts/

REST Web services

The firmware implements basic RESTful web services using the ESP8266WebServer library. Current values are requested with HTTP GETs, and values are set with POSTs using query string parameters. It can run in connected or standalone access point modes.

MQTT Syntax

The MQTT integration by default sets up a light domain autodiscovery for home assistant, should you want to send MQTT commands from a different system or manually the syntax is as follows

Topic : MQTT_TOPIC / MQTT_TOPIC_SET
example : "homeassistant/light/nanoleafs/set" in the case of the nanoleafs if you use default values, adjust for any changes you make to the previous two configuration variables

payload : this is a json formatted string with parameters, you can send one or multiple parameters, please note that to change most of them the light must be on, so sending an on command on every request other than off is a good idea.

commands :
state : values ON or OFF
brightness : values 1 to 255
autoplay : values ON or OFF
speed : values 1 to 255
effect : values Pattern name as a quoted string.
color : values [1..255,1..255,1..255]

command examples :
turn lights on : {"state": "ON"}
turn lights off : {"state": "OFF"}
Set brightness to 50% : {"state": "ON", "brightness": 127}
Set animation speed to 16 : {"speed": "16"}
Set animation autoplay on : {"autoplay": "ON"}
Set animation pattern : {"state": "ON", "effect": "Sinelon"}
Set a solid color : {"state": "ON", "color": {"r": 72, "g": 255, "b": 163}}

you can combine multiple commands in a single payload, for example
Set lights on, with a brightness of 50%, animation speed of 25, animation autplay off and the pride pattern.
ex : {"state": "ON", "brightness": 127, "speed": "25", "autoplay": "OFF", "effect": "Pride"}