Standalone LED Controller System
This site contains information regarding the installation, configuration and use of the firmware for this project. This includes the main LED controller and any optional wireless sensors.
⚠️ Build Instruction Notice
This documentation does not contain build instructions, parts lists, or wiring diagrams. For the physical build details, please refer to the following resources:
- YouTube Overview: DIY Standalone LED System V2
- Written guide (parts list, wiring diagrams, etc.): Standalone LED Controller Build Guide
The physical build information also covers the various options for sensors. The system is designed to permit wired or wireless sensors, using PIR or ToF/Distance devices. If opting for wireless sensors, the firmware and use of wireless sensors are also included in this guide.
🤖 AI Transparency Statement
The provided firmware and documentation were created and developed by me (a certified human). While Gemini AI was used to resolve issues with some of the more complex logic, no code was blindly copied and pasted without detailed review. Gemini was also used to style and to provide consistency across these documentation pages. But all content is mine… and developed by a real human!
How this document is organized
The documentation follows a logical setup flow, grouped into the sections seen in the sidebar:
- Welcome: About the project, concepts and terminology.
- Getting Started: Initial firmware flashing, onboarding and interface setup.
- Setting Up the System: Web app overview and setting various system options.
- General System Use: General operation of the system
The remaining topics cover optional and more advanced options, along with a troubleshooting section.
If you are setting up your system for the first time, begin with the Getting Started section.
Wireless Sensor Information
As covered in various related documents, the system can be built as a single-controller system using wired sensors or as a multi-controller system using independent wireless sensors with their own firmware. Many of the initial setup and configuration steps are very similar for the primary controller and any wireless controllers, but any differences will be noted in the sections above.
If you are using wired sensors for your project, just ignore or skip any information that relates to wireless sensors as it will not be applicable for your build.
Hardware Substitutions
The firmware had been written and tested for a specific set of hardware. If you decide to swap the LED strip for a different type that you had left over from another project, congratulations! You’ve just been promoted to Lead Engineer of your own custom fork.
🛠️ Please Note
While I admire the DIY spirit, I simply don’t have the bandwidth to maintain multiple versions of the firmware beyond the options provided. If you venture off-book, you are the Captain of that ship — I’ll be on the shore cheering you on, but I can’t help you navigate the “Why are my LEDs the wrong color?” phase of the journey.
If you use different hardware, you will need to fork this repository and modify the code yourself. See the Modifying the Firmware section for more info.
Opening Issues
- Issues: Reserved strictly for firmware errors or bugs.
- Discussions: For enhancement requests, “how-to” questions or problems that aren’t firmware releated.
Issues opened for feature requests or alternate hardware will be closed without response.