GY-63_MS5611/libraries/DRV8825

DRV8825

Arduino library for DRV8825 stepper motor driver.

Description

DRV8825 is a library for DRV8825 stepper motor driver.

Warning: experimental

The DRV8825 stepper motor library controls a stepper motor with a direction signal and a step pulse. The library has a default pulse length of 2 us however this can be adjusted to the specific requirements of the motor.

The library will probably work for similar controllers. This is not tested. If you have some working, please let me know.

Hardware connection

See datasheet.

Interface

Constants

//  setDirection
const uint8_t DRV8825_CLOCK_WISE         = 0;  //  LOW
const uint8_t DRV8825_COUNTERCLOCK_WISE  = 1;  //  HIGH

Constructor

• DRV8825() Constructor.
• bool begin(uint8_t dirPin, uint8_t stepPin) set the direction pin and step pin. Both pins are set to LOW. For direction this means DRV8825_CLOCK_WISE.

Direction

To define in which way the motor will turn.

• bool setDirection(uint8_t direction = DRV8825_CLOCK_WISE) switch direction between DRV8825_CLOCK_WISE (0 = default) or DRV8825_COUNTERCLOCK_WISE (1). Returns false for other values.
• uint8_t getDirection() returns DRV8825_CLOCK_WISE (0) or DRV8825_COUNTERCLOCK_WISE (1).

Steps and position

• void setStepsPerRotation(uint16_t stepsPerRotation) specifies the steps per rotation for the specific stepper motor. If set to zero, the steps and position will not be updated/valid. Note this value depends on pins M0, M1 and M2.
• uint16_t getStepsPerRotation() returns the value set before or zero default.
• void step() The workhorse, will give a pulse on the STEP pin. This also updates the position and the steps counters.
• uint32_t resetSteps(uint32_t s = 0 ) to reset the steps counter, default to zero. Returns the last value of internal steps counter.
• uint32_t getSteps() returns the steps made since start of the program or the last resetSteps(). Its purpose is to have an indication of usage (wear and tear).
• bool setPosition(uint16_t pos = 0) to calibrate the position of the motor. Default value is zero. Works only if stepsPerRotation > 0. Returns false if pos > stepsPerRotation.
  Note: it does not rotate the motor to a position.
  Note: there is no relation between position and steps.
• uint16_t getPosition() returns the position which is kin the range 0 .. stepsPerRotation - 1. This value can be converted to an angle in degrees or radians.

Some math

//  angle in degrees.
float angle = position * (360.0 / stepsPerRotation);

//  angle in radians.
float angle = position * (2.0 * PI / stepsPerRotation);

//  wear and tear math.
float rotations = getSteps() * (1.0 / stepsPerRotation);

Note the behaviour of steps changed in 0.1.1. This is done as the library added the position functions.

Configuration

• void setStepPulseLength(uint16_t us = 2) configures the pulse length of one step. This is defined in microseconds, default is 2 which is almost the 1.9 from the datasheet. Normally these need not to be changed.
• uint16_t getStepPulseLength() returns the set value in microseconds. Default the value = 2.

Operational

The base functions are:

DRV8825 stepper;

void setup()
{
  Serial.begin(115200);
  ...
  stepper.begin(4, 5);  // direction + step pin
  stepper.setDirection(DRV8825_CLOCK_WISE);
  ...
}

void loop()
{
...
  stepper.step();
...
}

See examples.

Future

Ideas are kept here so they won't get lost. Some will only be worked on if requested and time permits.

must

• add examples
• update documentation
• investigate other pins
  • M0..M2 8.3.5 micro steps
  • decay mode 8.3.3 there are 3 modi)
  • fault pin FLT input to detect errors
  • sleep pin SLP 8.3.6
  • enable pin EN 8.3.6
  • reset pin RST 8.3.6
  • other?
• if stepsPerRotation is set to zero, should pos be set to zero?
  • NB it will not be updated any more.
• do we need steps counter?

should

• step(uint16_t steps)
  • multiple steps in one call.
  • blocking
  • max 1 rotation?
  • optimize "position admin"
• gotoPosition(pos)..
  • needs steps(n) above.
• investigate other similar STEP/DIR controllers
  • DRV88xx series?

could

• stepCW() + stepCCW()
• base class STEPDIR
  • only when needed?
  • 8825 as derived? or as base class?
  • which others are similar?
• investigate controlling a DRV8825 with an PCF8574
  • pins needed (M0..M2, SLP, RST, EN, DIR, STEP)
  • first need a decent basic library.

wont

• left() + right();