Maker Portal

View Original

Arduino Breathing LED Functions

“As an Amazon Associates Program member, clicking on links may result in Maker Portal receiving a small commission that helps support future projects.”

See this content in the original post

See this content in the original post

A lot of Arduino code is single-sided, meaning that many of the loops range from zero to some number. This is because many of the functions of a microcontroller start with zero and increase positively and are related to iterables. In this section, functions are explored that have a peak at their midpoint and maintain smoothness throughout the function. These functions will create the ‘breathing’ of the LED by starting with minimal brightness, peaking in brightness, and going back to minimal brightness - all without any abrupt changes. This is similar to the intake and exhale of air into a lung. The list of five functions explored in this tutorial are given below:

Depending on the desired effect, the functions above give different variability in amount of brightness and darkness during the cycle of the LED breathing. For example, the plot below is an annotated version of the plot above, pointing to the functions that favor brightness and the functions that favor darkness:

The relationship between brightness and the duty cycle of a pulse-width modulation (analogwrite() function) is linear, and has been observed as such in the literature (see example here). Therefore, we expect the linear sweep (triangular function) to be the decider of whether darkness or lightness is favored. Using this principle, the Gaussian decidedly favors darkness in the plot above, and the circular function favors brightness. In the following section, the parts list and wiring diagram are introduced for following along with the tutorial. The rest of the forthcoming sections focus on the functions and coding them, with demonstrations for each function.


See this content in the original post

Only two parts are truly needed in this tutorial: an Arduino board and LED. A few other parts that may be useful for wiring, etc. are listed below as a guide:

The wiring diagram for wiring the RGB LED to the Arduino Uno is given below:

See this product in the original post

It is important to note that the LED pins have been wired to PWM-enabled Arduino pins, ensuring that the ‘breathing’ phenomenon will be possible on the chosen pins (on the Arduino Uno these pins have a ~ next to them).

See this content in the original post

See this content in the original post

The first and simplest method of creating a breathing LED is by linearly spanning from minimum to maximum through what is called a triangle wave. A triangle wave can be written in equation form as follows:

where x represents the input from 0 - N, with N acting as the total number of points in each loop. Note: y varies from 0-1, so we need to multiply the entire equation by the PWM amplitude (which, in Arduino is 255.0, or an 8-bit PWM). In Arduino, this can be coded as follows:

See this content in the original post

Opening the serial plotter, one should see the following profile being plotted:

The wave spans from 0 - 255, in a uniform profile. A video of this is also given below as a demonstration of the code and triangle wave profile:

See this content in the original post

See this content in the original post

Now, a circular function will be used to favor brightness in the breathing of the LED. This function uses a circle as the basis for spanning darkness to brightness. The equation can be written as follows:

again, x represents the input from 0 - N, with N acting as the total number of points in each loop. y varies from 0-1, so we again need to multiply by the PWM amplitude (255). In Arduino, the code is as follows:

See this content in the original post

Plotting on the Arduino serial plotter gives the following nice profile:

See this content in the original post

See this content in the original post

The final equation that will be investigated is the most complex, versatile, and interesting. Gaussian functions can be found in many disciplines in science, math, and engineering. The Gaussian function can be used in image processing as a smoothing tool, statistics to describe normally distributed data, and even quantum mechanics to describe quantum harmonic oscillators [read more on Gaussian functions here, here, here, and here].

The 1-D gaussian equation can be written as follows:

where, again x is the variable ranging from 0 - N. For the Gaussian, the constant α represents the maximum amplitude of the PWM output (255 for the Uno board). Additionally, the constant β here is 0.5, as it needs to be symmetric around x. Finally, the constant  γ represents a parameter that controls the width of the wave. For the Arduino, changing  γ results in either more or less darkness. Therefore, the Gaussian for our breathing LED can be written as:

This is plotted below for various values of γ:

A good range of values to ensure perceptible ‘breathing’ is 0.1 < γ < 0.3. Outside of this range the LED looks like it’s either blinking (0.1<γ) or staying on completely (γ>0.3). The Arduino code that implements the Gaussian is given below, where a value of γ = 0.14 was chosen based on its smooth profile and ability to replicate the ‘breathing’ phenomenon.

See this content in the original post

Using Arduino’s serial plotter shows the really smooth profile associated with the Gaussian:

The Gaussian is perhaps the most natural display of a ‘breathing’ LED, likely due to its smoothness at the darker ends. This smoothness makes it easier for our eyes to perceive the changes in brightness as delicate, rather than abrupt. The circle function is a fairly abrupt change in brightness toward the darker sections, and even the triangle wave is perceived as spending too little time on the darker sections. The Gaussian function, with γ = 0.2 gives the best ‘breathing’ phenomenon, but never goes to zero (plotting the function demonstrates why). For some reason, the LEDs do not handle tending toward off very well - so keeping them slightly on and spending more time toward darkness (with γ = 0.2, delay of 1ms, and 1000 total points per loop), the ‘breathing’ phenomenon is perceived as very natural. This is shown below:

See this content in the original post

See this content in the original post

A breathing LED is a phenomenon that mimics the inhale and exhale of a lung with light instead of air. Breathing LEDs can be found in many electronics, and are often a sign of functionality to some degree. In this tutorial, a few functions were proposed that are able to replicate the breathing phenomenon. The triangle, circular, and gaussian waves were all presented and demonstrated for an Arduino board and RGB LED. Each function uses a loop to cycle through darkness and brightness, giving the illusion of a ‘breathing’ LED. This tutorial is merely an introduction to modulating LED brightness with different mathematical functions. The goal was to create an array of methods for creating the breathing phenomenon, and this was done with the three aforementioned functions. The Gaussian wave proves to be both the most versatile and most natural of the functions, however, the simplicity of the triangle wave makes it a great (and likely common) selection for creating a breathing LED.

Follow us for more updates and project insights:

See this content in the original post

See More in Arduino and LEDs:

See this content in the original post