QuinLED

This repository provides various bits of code, for use with the awesome QuinLED PWM LED dimmer, as created by Quindor. Please note that this is not the original code provided by Quindor, so if you got the code from this GitHub repository and have issues, please complain to me, not to Quindor. The original code has been altered and is provided here with permission from Quindor.

Introduction

In short, the QuinLED module is a DIY Pulse-Width Modulation (PWM) LED dimmer. It is designed by Quindor, who has many blog articles and videos about the evolution of this dimmer. I highly recommend that you check these resources if you're unfamiliar with the QuinLED module.

Contents

While creating and using my own QuinLED modules, I noticed some small issues in the code provided. Since I'm familiar with Lua coding, I decided to fix these issues for myself, and improve the script while I was at it. I also added some extras, and will guide you through creating your own NodeMCU firmware.

I would suggest that you follow the links below in the order they're provided, this should make it easier to understand what's going on.

What is provided:

• A guide on creating your own NodeMCU firmware for QuinLED
  (This is completely optional, you can also use the firmware build provided by Quindor in the Workshop Archive, or provided by me)
  • This way you can build your own firmware when you want to develop extra functionality for QuinLED, without guessing which modules you need.
• Completely revamped program code
  • Fixes reboot when providing a brightness level outside the 0-1023 range
  • Fixes reboot when providing a non-four-digit fadetime
  • Adds flexibility for future development with more channels
  • Adds a web server, which allows updating the code Over The Air (OTA), so no need to attach wires after the first time!
• A different way of implementing QuinLED in Domoticz (using dzVents)
  (Again, completely optional. You can also use Quindor's method)
  • Enables all script editing to be done from the browser, through Domoticz. No command line needed
  • Eliminates the need for a script for every device, one script can handle all your devices
• A batch file, that allows you to control your QuinLED modules easily through a command line interface
  (Also optional, this is just for ease of use)
  • Allows for quick and easy input, without having to remember the exact syntax of the command

Conclusion

If you followed all the readme's as linked above, you should now have:

• A QuinLED module running my custom firmware and program code
• The ability to change the program code OTA
• An easy way to add new modules through the dzVents scripts
• A simple batch file that allows you to control the QuinLED modules through the command line quickly and easily.

Contributing

If you want to contribute to this repository in any way shape or form, please feel free to do so! Some suggestions:

• Translations of the README files
• Code improvements, changes, or additions
• Well.. anything really

To keep things clean, I do have the repo set to protected, meaning that I will have to approve any pull request manually. Some guidelines:

• Use proper indentation
• Try to use the same coding style as provided
• Try to provided descriptive comments for at least each code block you add

If you want to discuss your idea before you start working on it (which I'd recommend), feel free to open an issue on this repository.