Some links in this post may be affiliate links. We may get paid if you buy something or take an action after clicking one of these, but without addictional costs for you compared to direct buying.

PWM with Raspberry PI: python example usage for a breathing LED

Raspberry pi PWM beathing led featured image
Follow my latest articles on Twitter: . Or subscribe my newsletter (top right in this page) to be notified when new projects are available!

Pulse Width Modulation (PWM) is an electronic technique of reducing the (average) power provided to a circuit by providing regular discrete pulses. As Raspberry PI hasn’t analogic PINs, this can provide an effective way to simulate an analog output

In this tutorial I’m going to show you how to use PWM with Raspberry PI, include an example with a “breathing” LED.

PWM technique uses digital signals, sent at a specified frequency, to compose square waves. This means that output high and low levels are alternated to form a squared signal:

PWM square wave

With square waves, following are common definitions:

  • Period: time between same points of 2 cycles (for example the time between the rising edge of a wave and the rising edge of the following one). The higher the period, the larger the cycle.
  • Frequency: usually defined as the inverse of period. You can think the frequency as the number of cycles for a specified period unit (if you use seconds for period, frequency becomes in hertz)
  • Pulse Width: time of high level in each cycle period
  • Duty cycle: percentage given from pulse width divided by total period time
PWM square wave explaination

Changing frequency and duty cycles, PWM can simulate an “analog like” signal, where output level can be calculated as high-level voltage (about 3.3 V for Raspberry PI programmable GPIOs) multiplied by duty cycle percentage. For example, still with Raspberry PI programmable GPIOs, a duty cycle of 50% will give:

3.3V x 50% = 1,65V

In Raspcberry PI, only GPIO 18 has a direct ability to act in PWM mode with an accuracy of 10-bit, which means that the 0%-100% duty cycle range is divided into 1024 (210) equal parts.

In this turial I will use the PWM modulation to drive a LED connected to Raspberry PI. The LED intensity is proportional to its input voltage, so configuring properly the duty cycle we’ll have different light effects. Moreover, by changing frequency during a loop, we’ll obtain a coll “breathing led” effect.

I will use a Raspberry PI Zero W, but same procedure a commands will work also with newer Raspberry PI computer boards.

What We Need

As usual, I suggest adding from now to your favourite e-commerce shopping cart all needed hardware, so that at the end you will be able to evaluate overall costs and decide if continuing with the project or removing them from the shopping cart. So, hardware will be only:

Raspberry Pi Zero WH PINS

Check hardware prices with following links:

Amazon raspberry pi boards box
Amazon raspberry pi Zero W box
Amazon Micro SD box
Amazon Raspberry PI Power Supply box
Amazon Dupont Wiring box
Amazon Resistors box
Amazon Breadboard box

Wiring diagram

Please find below a picture describing cabling:

Raspberry PI PWM breathing LED wiring

Please note that shorted PIN from LED is connected t Ground.

Following pictures are showing more details from my cabling:

Raspberry pi PWM beathing led details 01
Raspberry pi PWM beathing led details 02
Raspberry pi PWM beathing led details 03

Step-by-Step Procedure

Prepare Raspberry PI Operating System

Start preparing your OS. You can install Raspberry PI OS Lite (for a fast, headless OS) or Raspberry PI OS Desktop (using its internal terminal).

Make your OS up to date. From terminal, use following command:

sudo apt update -y && sudo apt upgrade -y

Install RPI.GPIO package from aptitude repositories, as it will be used to manage GPIOs from Python:

sudo apt install rpi.gpio

Prepare Python Script

You can get my script directly in your RPI with following command:


Following paragraphs will describe code lines.

Our breathing led script starts importing required python modules:

import RPi.GPIO as GPIO
import sys
import time

Then the number corresponding to PWM led is associated to a variable for better code management. After this, broadcom (BCM) naming is set to be used, according to Raspberry PI pinout. We also set PWM led to output:

PWMLed = 18


A “breath” variable will manage PWM mode, setting frequency to 1000 (1kHz). PWM output is also started:

breath = GPIO.PWM(PWMLed, 1000)

Here pwm function comes. This is a simple function composed by 2 “for” loops, each one using a “dc” variable associated to duty cycle. The first loop changes duty cycle from 1(%) to 100(%), as the last value from a range used inside a loop is not run. A small delay (0.02 ms) will make slower the led light moving from low to high. With same logic, following “for” loop make same effect but in reverse direction (from high light to low). With ranges starting and ending to “1”, you won’t experience the led completely shutting down.

def pwm():
 while True:
  for dc in range(1, 101, 1):
  for dc in range(100, 0, -1):

Main program will run an infinite loop where the pwm effect will restart at the end of every run:

while True:

Final except statement will manage user interruption by stopping pwm mode from GPIO, cleaning GPIO status and exiting:

 except KeyboardInterrupt:

Run the breathingLed Python Script

To run this script, issue following command from terminal:


Your LED will start its breathing effect.


How useful was this post?

Click on a star to rate it anonymously!

Average rating 0 / 5. Vote count: 0

No votes so far! Be the first to rate this post.

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?

Leave a Reply

Your email address will not be published. Required fields are marked *

I accept the Privacy Policy