/AiLight

AiLight is a custom firmware for the esp8266 based Ai-Thinker (or equivalent) RGBW WiFi light bulbs

Primary LanguageCMIT LicenseMIT

AiLight Build No Maintenance Intended

AiLight

AiLight is a custom firmware for the inexpensive Ai-Thinker (or equivalent) RGBW WiFi light bulbs that has an ESP8266 on board and is controlled by the MY9291 or MY9231 LED driver.

Current Stable Release: v1.0.0 (Please read the changelog for detailed information).

Ai-Thinker RGBW Light bulb

AiLight is archived. The firmware has seen various improvements and fixes over the years and I feel it reached maturity. Go forth and fork AiLight if you like to improve it.

Features

With AiLight you can:

  • switch the light on or off
  • set the level of the 4 colour channels (Red, Green, Blue and White)
  • set the brightness level
  • set the light at a particular colour temperature
  • let the light flash (i.e. blinking with a given colour and brightness)
  • enable Gamma Correction to make the LED colours appear closer to what our eyes perceive
  • set the light to transition to the new state, rather than immediately.

This can all be done with the built-in (mobile friendly) Web UI or in Home Assistant (using the MQTT built-in integration via JSON). The Web UI also gives you the ability to configure your Smart Light remotely. You can easily change your WiFi settings or the configuration of your MQTT broker.

Other

  • REST API
  • MQTT Last Will and Testament enabled
  • Support for Home Assistant's MQTT Discovery
  • Support for Over The Air (OTA) firmware updates
  • Preserve light settings and configuration after power cycle or restart
  • Perform remote restart using the built-in HTML UI.
  • Reset to factory defaults using the built-in HTML UI (* 'factory' here means the default settings of the AiLight firmware upon compile time)

Making this firmware was largely inspired by the MY9291 LED driver and the Espurna firmware of Xose Pérez.

Getting started

Got curious and want to use AiLight too? Head over to the Wiki where you can find all relevant topics on how to connect, flash and use the AiLight firmware!

Bugs and Feedback

For bugs, questions and discussions, please use the Github Issues.

Contributing

Contributions are encouraged and welcome; I am always happy to get feedback or pull requests on Github :) Create Github Issues for bugs and new features and comment on the ones you are interested in.

If you enjoy what I am making, an extra cup of coffee is very much appreciated :). Your support helps me to put more time into Open-Source Software projects like this.

Buy Me A Coffee

Credits and License

The AiLight Firmware is open-sourced software licensed under the MIT license. For the full copyright and license information, please see the file that was distributed with this source code.