This library allows you to control unipolar or bipolar stepper motors. To use it you will need a stepper motor, and the appropriate hardware to control it. For more on that, see Tom Igoe's notes on steppers.

 

函数

Stepper(steps, pin1, pin2)            步进电机定义

Stepper(steps, pin1, pin2, pin3, pin4)   步进电机定义

Description  解释

This function creates a new instance of the Stepper class that represents a particular stepper motor attached to your Arduino board. Use it at the top of your sketch, above setup() and loop(). The number of parameters depends on how you've wired your motor - either using two or four pins of the Arduino board.

Parameters  参数

steps: the number of steps in one revolution of your motor. If your motor gives the number of degrees per step, divide that number into 360 to get the number of steps (e.g. 360 / 3.6 gives 100 steps). (int)  一圈对应的步数

pin1, pin2: two pins that are attached to the motor (int)

pin3, pin4: optional the last two pins attached to the motor, if it's connected to four pins (int)

Returns  A new instance of the Stepper motor class.

 

setSpeed(rpm)  速度设定

Description  解释

Sets the motor speed in rotations per minute (RPMs). This function doesn't make the motor turn, just sets the speed at which it will when you call step().

Parameters  参数

rpms: the speed at which the motor should turn in rotations per minute - a positive number (long)

Returns None 无返回值

 

step(steps)   步数执行

Description

Turns the motor a specific number of steps, at a speed determined by the most recent call to setSpeed(). This function is blocking; that is, it will wait until the motor has finished moving to pass control to the next line in your sketch. For example, if you set the speed to, say, 1 RPM and called step(100) on a 100-step motor, this function would take a full minute to run. For better control, keep the speed high and only go a few steps with each call to step().

Parameters

steps: the number of steps to turn the motor - positive to turn one direction, negative to turn the other (int)

Returns  None

 

举例

1  Stepper Motor Knob  用电位器控制步进电机步数

Control a highly accurate stepper motor using a potentiometer

Stepper motors, due to their unique design, can be controlled to a high degree of accuracy without any feedback mechanisms. The shaft of a stepper, mounted with a series of magnets, is controlled by a series of electromagnetic coils that are charged positively and negatively in a specific sequence, precisely moving it forward or backward in small "steps".

There are two types of steppers, Unipolars and Bipolars, and it is very important to know which type you are working with. For each of the motors, there is a different circuit. The example code will control both kinds of motors. See the unipolar and bipolar motor schematics for information on how to wire up your motor.

In this example, a potentiometer (or other sensor) on analog input 0 is used to control the movement of a stepper motor using the Arduino Stepper Library. The stepper is controlled by with digital pins 8, 9, 10, and 11 for either unipolar or bipolar motors.

The Arduino or Genuino board will connect to a U2004 Darlington Array if you're using a unipolar stepper or a SN754410NE H-Bridge if you have a bipolar motor.

For more information about the differences of the two types, please take a look at Tom Igoe's page on stepper motors.

 

Hardware Required  硬件

Arduino or Genuino Board

10k ohm potentiometer

stepper motor

U2004 Darlington Array (if using a unipolar stepper)

SN754410ne H-Bridge (if using a bipolar stepper)

power supply appropriate for your particular stepper

hook-up wires

breadboard

 

Circuits  电路

Below you'll find circuits for both unipolar and bipolar steppers. In either case, it is best to power your stepper motors from an external supply, as they draw too much to be powered directly from your Arduino board.

In both circuits, connect a 10k pot to power and ground, with it's wiper outputting to analog pin 0.

Note: Both circuits below are four wire configurations. Two wire configurations will not work with the code provided.

Unipolar Stepper Circuit and schematic:

Bipolar Stepper Circuit and schematic:

 

Code  程序

For both unipolar and bipolar steppers

 1 /*
 2 * MotorKnob
 3 ** A stepper motor follows the turns of a potentiometer (or other sensor) on analog input 0.
 4 ** http://www.arduino.cc/en/Reference/Stepper
 5 * This example code is in the public domain.
 6 */
 7 
 8 #include <Stepper.h>
 9 #define STEPS 100     // change this to the number of steps on your motor
10   // create an instance of the stepper class, specifying
11   // the number of steps of the motor and the pins it's attached to
12 Stepper stepper(STEPS, 8, 9, 10, 11);
13 int previous = 0;    // the previous reading from the analog input
14 
15 void setup() 
16 {
17     stepper.setSpeed(30);   // set the speed of the motor to 30 RPMs
18 }
19 
20 void loop() 
21 {
22     int val = analogRead(0);   // get the sensor value
23   // move a number of steps equal to the change in the sensor reading
24     stepper.step(val - previous);   // remember the previous value of the sensor
25     previous = val;
26 }

  

2  Stepper Speed Control  用电位器控制步进电机速度

Control the stepping speed with a potentiometer

硬件与电路部分,与上例同

Code  程序

For both unipolar and bipolar steppers

 1 /*
 2 Stepper Motor Control - speed control
 3 This program drives a unipolar or bipolar stepper motor.
 4 The motor is attached to digital pins 8 - 11 of the Arduino.
 5 A potentiometer is connected to analog input 0.
 6     The motor will rotate in a clockwise direction. The higher the potentiometer value,the faster the motor speed. Because setSpeed() sets the delay between steps,you may notice the motor is less responsive to changes in the sensor value at low speeds.
 7 
 8 Created 30 Nov. 2009,Modified 28 Oct 2010,by Tom Igoe
 9 */
10 
11 #include <Stepper.h>
12 const int stepsPerRevolution = 200; 
13 // change this to fit the number of steps per revolution
14   // for your motor initialize the stepper library on pins 8 through 11:
15 Stepper myStepper(stepsPerRevolution, 8, 9, 10, 11);
16 int stepCount = 0;   // number of steps the motor has taken
17 
18 void setup() 
19 {
20     // nothing to do inside the setup
21 }
22 
23 void loop()
24  {
25     int sensorReading = analogRead(A0); // read the sensor value:
26     int motorSpeed = map(sensorReading, 0, 1023, 0, 100);    
27     // map it to a range from 0 to 100
28     if (motorSpeed > 0) // set the motor speed:
29     {
30         myStepper.setSpeed(motorSpeed);
31         myStepper.step(stepsPerRevolution / 100); // step 1/100 of a revolution:
32     }
33 }

  

3  Stepper One Revolution    正转一圈反转一圈

Turn the shaft one revolution clockwise and one counterclockwise.

硬件与电路部分,与上例同

Code  程序

For both unipolar and bipolar steppers

 1 /*
 2 Stepper Motor Control - one revolution
 3 This program drives a unipolar or bipolar stepper motor.
 4 The motor is attached to digital pins 8 - 11 of the Arduino.
 5     The motor should revolve one revolution in one direction, then one revolution in the other direction.
 6 
 7 Created 11 Mar. 2007,Modified 30 Nov. 2009,by Tom Igoe
 8 */
 9 #include <Stepper.h>
10 const int stepsPerRevolution = 200; 
11 // change this to fit the number of steps per revolution
12  // for your motor initialize the stepper library on pins 8 through 11:
13 Stepper myStepper(stepsPerRevolution, 8, 9, 10, 11);
14 
15 void setup()
16 {
17     myStepper.setSpeed(60);   // set the speed at 60 rpm:
18     Serial.begin(9600);   // initialize the serial port:
19 }
20 
21 void loop() 
22 {
23     Serial.println("clockwise");   // step one revolution in one direction:
24     myStepper.step(stepsPerRevolution);
25     delay(500);
26     Serial.println("counterclockwise");   // step one revolution in the other         direction:
27     myStepper.step(-stepsPerRevolution);
28     delay(500);
29 }

 

4  One step at a time  一次只走一步

Turn the shaft step by step to check the proper wiring of the motor.

硬件与电路部分,与上例同

Code  程序

For both unipolar and bipolar steppers

 1 /*
 2 Stepper Motor Control - one step at a time
 3 This program drives a unipolar or bipolar stepper motor.
 4 The motor is attached to digital pins 8 - 11 of the Arduino.
 5     The motor will step one step at a time, very slowly. You can use this to test that you've got the four wires of your stepper wired to the correct pins. If wired correctly, all steps should be in the same direction.
 6     Use this also to count the number of steps per revolution of your motor,if you don't know it. Then plug that number into the one Revolution example to see if you got it right.
 7 
 8 Created 30 Nov. 2009,by Tom Igoe
 9 */
10 
11 #include <Stepper.h>
12 const int stepsPerRevolution = 200; // change this to fit the number of steps per revolution
13     // for your motor initialize the stepper library on pins 8 through 11:
14 Stepper myStepper(stepsPerRevolution, 8, 9, 10, 11);
15 int stepCount = 0; // number of steps the motor has taken
16 
17 void setup() 
18 {
19     Serial.begin(9600);   // initialize the serial port:
20 }
21 
22 void loop()
23 {
24     myStepper.step(1);   // step one step:
25     Serial.print("steps:");
26     Serial.println(stepCount);
27     stepCount++;
28     delay(500);
29 }