RGB LEDs are used everywhere, in many different products and devices. This Arduino library is for controlling RGB LED colour and fading between colours. Almost every setting can be controlled through this library to control the RGB LEDs. The library contains preset colours and functions to make it easier to construct your RGB LED project.
I made this library because I wanted more control over the RGB LEDs without using any of the timers. Depending on the Arduino that is being used, that may change what timers are available. This library does not uses timers, therefore it can be used across devices.
This library can also change how the function fades from linear and continue to fade to an experiential fading, pulse function or waving fade function. The waving fade function is where the LED changes bits at a time from one colour to another colour then back to the first colour. This repeats until the fade is complete.
Check it out.
Technical Deep-Dive: Asynchronous PWM Modulation & Luminance Orchestration
Moving beyond standard linear transitions, this library provides a sophisticated framework for controlling RGB LED color-spaces while maintaining complete timer-independence. This unique architecture ensures cross-platform compatibility across various MCU architectures (AVR, SAMD, ESP32) without resource conflicts.
- Timer-Independent Modulation & PWM Forensics:
- The Software-PWM Orchestration: Standard Arduino PWM relies on internal 8-bit or 16-bit timers (Timer1, Timer2), which can conflict with servo-libraries or custom interrupts. This library utilizes a non-blocking
millis()based modulation engine. The diagnostics focus on the jitter-free transition of R-G-B channels, ensuring that the software-level duty cycle remains deterministic even when the MCU's main loop is under heavy computational load. - PWM-Aliasing Mitigation: To prevent visual "stepping" during ultra-slow fades, the library implements a high-resolution sub-sampling technique. This manages the transition rate to ensure that the incremental luminance changes are below the biological threshold of flicker-perception, providing absolute visual smoothness.
- The Software-PWM Orchestration: Standard Arduino PWM relies on internal 8-bit or 16-bit timers (Timer1, Timer2), which can conflict with servo-libraries or custom interrupts. This library utilizes a non-blocking
- Luminance-Profiling & Transition Heuristics:
- The Logarithmic-Response Diagnostics: The human eye perceives light exponentially rather than linearly. Linear PWM values (0-255) often result in a "blown-out" appearance at low-intensities. The library's "Exponential Fading" heuristic ensures that the perceived brightness scales naturally, providing high-fidelity color-mixing accuracy across the entire gamut.
- Transition-Harmonic Modes: The library features specialized modes like "Waving Fade" and "Pulse Function". These involve sinusoidal interpolation of the color-vectors, allowing the LED to oscillate between color-states with fluid phase-coherency.
Engineering & Implementation
- Cross-Platform Portability Forensics:
- Architecture-Agnostic Timing: Since the library avoids direct register manipulation, it operates flawlessly on any Arduino-compatible board. The focus is on the cycle-efficiency of the color-calculation loops to ensure that 8-bit AVRs (16MHz) can drive the RGB stack without inducing perceptible latency.
- Common Cathode vs. Common Anode Diagnostics: The library supports inverted logic-states, allowing software-toggling of the PWM output polarity to ensure compatibility with both CC and CA physical LED hardware architectures.
- Modular Interconnect Aesthetics:
- The implementation emphasizes clean wiring. Proper implementation requires selecting the correct current-limiting resistor for each channel (R, G, B) to compensate for the varying forward-voltage drops of the different semiconductors inside the RGB package. This ensures a perfectly neutral white-balance at full duty-cycle.
Projects Using This Library
Other Projects
Videos
Conclusion
This library represents a robust approach to Physiological Light-Management. By mastering Timer-Independent Orchestration and Logarithmic Luminance Forensics, it provides a professional-grade tool for achieving absolute chromatic clarity through sophisticated software-modulation.