Driving a 28BYJ-48 Stepper Motor & ULN2003 driver with a Raspberry Pi

Quick points about this motor & driver

They are wonderfully cheap and extremely accurate due to 1/64 gearing. They move by 0.087890625° per step! However, the gearing is made of plastic and will wear out overtime, especially if moving heavy objects. Lastly the motors can become a little toasty if you work them hard.




import RPi.GPIO as GPIO
import time

in1 = 17
in2 = 18
in3 = 27
in4 = 22

# careful lowering this, at some point you run into the mechanical limitation of how quick your motor can move
step_sleep = 0.002

step_count = 4096 # 5.625*(1/64) per step, 4096 steps is 360°

direction = False # True for clockwise, False for counter-clockwise

# defining stepper motor sequence (found in documentation http://www.4tronix.co.uk/arduino/Stepper-Motors.php)
step_sequence = [[1,0,0,1],

# setting up
GPIO.setmode( GPIO.BCM )
GPIO.setup( in1, GPIO.OUT )
GPIO.setup( in2, GPIO.OUT )
GPIO.setup( in3, GPIO.OUT )
GPIO.setup( in4, GPIO.OUT )

# initializing
GPIO.output( in1, GPIO.LOW )
GPIO.output( in2, GPIO.LOW )
GPIO.output( in3, GPIO.LOW )
GPIO.output( in4, GPIO.LOW )

motor_pins = [in1,in2,in3,in4]
motor_step_counter = 0 ;

def cleanup():
    GPIO.output( in1, GPIO.LOW )
    GPIO.output( in2, GPIO.LOW )
    GPIO.output( in3, GPIO.LOW )
    GPIO.output( in4, GPIO.LOW )

# the meat
    i = 0
    for i in range(step_count):
        for pin in range(0, len(motor_pins)):
            GPIO.output( motor_pins[pin], step_sequence[motor_step_counter][pin] )
        if direction==True:
            motor_step_counter = (motor_step_counter - 1) % 8
        elif direction==False:
            motor_step_counter = (motor_step_counter + 1) % 8
        else: # defensive programming
            print( "uh oh... direction should *always* be either True or False" )
            exit( 1 )
        time.sleep( step_sleep )

except KeyboardInterrupt:
    exit( 1 )

exit( 0 )

Stuff you might need for this to run:

sudo apt-get update --fix-missing && sudo apt-get install python3-rpi.gpio


This motor takes 5.625*(1/64)° per step, this means 2048 steps for 180°:

and 4096 steps for 360°:

One thing that is super cool about the driver board are the LEDs. Projects are always cooler with blinky LEDs, but these guys also help show what is actually going on inside the stepper, and can help you find issues. They are supposed to light up in sequence.

16 Replies to “Driving a 28BYJ-48 Stepper Motor & ULN2003 driver with a Raspberry Pi”

  1. Thanks Ben for your post.
    It was very easy and useful.
    As I do not have external power supply, I have powered the motor and ULN2008 with Raspberry Pi 4. As said, it perfectly worked.

    What it’s more amusing is that I have descovered your web page. Congratulations. It’s fantastic. This lifestyle and projects are inspiring. They even make me a little jealous. Healthy envy. And they bring back a little hope in the human being. Good luck and good health from Catalonia.

    1. David,

      bon dia, I was very lucky to spend several Summer vacations in Catalonia and I found it to be an incredible place. The culture is strong and the people are super nice. My sister is a Casteller in France, this tradition is exceptional and I show videos of it to my kids. Because they show amazing kids, but also because the exercise is the antithesis of American individualism :). It’s good for them to see both.

      In any case, I won’t bore you with my vacations, but your place is a truly special one in the world, and from it there isn’t much to envy.

      I’m glad I was able to help you drive your motor, and I’m suprised you were able to power the motor with the Pi :). Motors usually wreck havoc on circuits and you want to decouple them from the logic and other sensitive things. But hey, if it works it works :).

      Take care and good health to you too.

      1. Thanks Ben,

        I’m very glad to read your answer. In one of your videos I heard some French, so it makes sense with what you say regarding your sister. For sure she sould be Casteller in Paris or Toulouse.

        USA is a great country, with more diversity than is transmitted through the news and stereotypes. Just a sample: I am writing this after attending a concert in Barcelona by the great Bruce Springsteen. I’m a big fan. He has always been a rebel and a committed man.

        Concerning Catalonia, well,… just trying to preserve language ​​and culture, which is difficult in this globalized world if you don’t have a state behind. But always, keeping the doors open to everyone who needs it, with solidarity, There are millions of people who, just because of their place of birth, have less opportunities than us.

        Best wishes to you and your family.

  2. Hey, Used your code, and it works well BUT, step_count = 4096 makes stepper revolve 4 times.. (360 x 4)…. I reduced step_count to 1024 for 1 360 degree rotation…. So what’s happening here..
    any comment would be appreciated… thanks

    1. That’s really bizarre. Off the top of my head:
      – are you sure you’ve got the same stepper motor?
      – did you change the code in any way? (sorry I gotta cover the basics :))
      – when it moves, is it going at the same speed as the GIFs on this post? Or is is faster/slower?

    2. Ok, so apparently the SAME Stepper (28byj-48) comes in two
      flavors a 1/16, and a 1/64 gear ratio… see adafruit’s 28byj-48…??
      So of cores, with your code they both work but with different amount of steps per 360 degree.. On amazon search both 1/16 and 1/64 to get the right one for your particular need… These steppers draw NO current when all inputs are set to 0,0,0,0.. this is a very good feature as other type steppers always draw current…
      Thanks for your quick response…

      1. Oh wow, I’m glad there’s an explanation. I never came upon the 1/16 ones, thanks for finding out.

        I think that most stepper drivers have a “brake” mode that does draw current to stay in position, and a “free” mode that draws no current but lets the motor move is force is applied externally.

  3. Thanks for the quick-start with the stepper motor! I was playing around with your code and optimized the main for loop. You have to make range() iterate backwards to have the motor reverse, but it only changes the GPIO ports as they need to be changed.

    # the meat
        for i in range(step_count):
            GPIO.output(motor_pins[(i%8//2 + 2*(i%2))%4], i%2)
  4. Recommend you update the wiring diagram to connect the Pi and ULN2003 grounds together. Bad things might happen if someone uses a separate AC supply.

    Fun that it works at all. They’re likely grounding through suppression diodes.

    1. You’re entirely right, I think in my test I was using the 2 ports of the same USB power bank so I most likely had shared ground.

      Thanks for pointing it out, it’s updated!

  5. dear friends,
    I tried to rebuild the circuit diagramm as shown above.
    I miss the ground connection between circuit (ULN2008) and Raspi. As a result of this my engine doesn’t work. Secondly I connected the external power supply-ground with Raspi-ground and external (+) with (+) of the ULN2008 circuit, but the result was the same. Zhen I used the +5V and Ground from Raspi for connecting with ULN2008 circuit. This configuration works.
    I want to supply the ULN2008 with an external power supply. How does it works? Can you help me please

    1. Rolf,

      I’m having a hard time understanding what wire was where when things were working or not. Are you saying that you actually powered the motor from the Pi? Even if it works it’s pretty “dangerous” to do so because motors generator a lot of noise on circuits and do you don’t want them hooked up directly to your GPIO pins (expect for the control pins of course). But hey, if it works it works :).

      In any case, are you saying that you have a 5V external power supply, and that you’d like to power both the Pi and the motor with it?

  6. It’s one of the first time I read a tutorial, really “ready to use”.
    I just followed your diagram, copy/past your script, and it works !

    Congrats and thank you 🙂

    1. C’est tellement la lutte pour trouver des informations succinctes et précises sur ce genre de sujet, j’essaye vraiment de poster des infos qui sont les deux. Merci de laisser un commentaire pour me faire savoir que c’est réussi :).

  7. Thank you. This article was clear and concise. It explained very well how the motor works with Raspberry pi. It is exactly what I was looking for.

Leave a Reply

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