NimmLor / esp8266-nanoleaf-webserver

this repo has moved, https://github.com/NimmLor/esp8266-fastled-iot-webserver
GNU General Public License v3.0
43 stars 8 forks source link

This repo has been merged and moved here

https://github.com/NimmLor/esp8266-fastled-iot-webserver

LEGACY Nanoleaf Web Server

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

Nanoleafs

Changelog

01.02.2020, Native Alexa Update

24.02.2019, NodeRED Update (Depricated)

Bill of Materials

Hardware

Check out the project on Thingiverse for more details.

https://www.thingiverse.com/Surrbradl08/things

Installation

FOR INSTALLATION REFER TO THE Software_Installation.md

Features

Web App

Webinterface

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

Circuit

circuit without Logic level converter

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.