SparkFun ProDriver and Mini Stepper Motor Driver Hookup Guide
QCPete, santaimpersonator Introduction
The SparkFun ProDriver and Mini Stepper Motor Driver utilize the latest TC78H670FTG stepper motor driver from Toshiba. With a full to 1/128 stepping resolution and two different methods for control (serial communication or clock-in stepping) this is a great option for your next project that requires precise motor control.
The advantage of the ProDriver is that it's solderless, out of the box. With the DC barrel jack and latch pins, the board can be easily powered and connected without any soldering. This is great for projects, where users want to easily swap out components in the event of a failure.
The primary disadvantage of this product is it's size. Users may face difficulties trying to squeeze this into smaller projects.
The advantage of the Mini Stepper Motor Driver is in its size. The small footprint of the board, allows users to squeeze it into smaller projects and the pin layout is breadboard compatible to simplify prototyping.
Its primary disadvantage, is that users may need to connect an electrolytic capacitor (>50µF is recommended), externally to its VM and GND pins.
Although both communication methods are included in the Arduino library, the serial command has some unique features. The serial communication allows users to precisely control the phase, torque, mixed decay ratio of each coil, and current limit while the motor is in motion. (In contrast, most stepper motor drivers need an external trimpot that is physically adjusted to control the current output limit.)
Required Materials
The SparkFun ProDriver and Mini Stepper Motor Driver require a few additional items for you to get started. At minimum, users will want an Arduino compatible microcontroller with a USB cable, a power supply, some hookup wire or jumper wires, and a stepper motor (*we recommend a 4-wire, bipolar stepper motor to begin with). You may already have a few of these items, including the USB cable, so feel free to modify your cart based on your needs. Additionally, there are also alternative part options that are available as well (click button below to toggle options).
VM and GND pins.
Here are a few other Arduino compatible microcontrollers. For a full list of options from our catalog, please visit the Arduino microcontroller product category.
Here are a few other wiring options. For a full list of options from our catalog, please visit the wire product category.
While most users may only need headers for the Mini Stepper Motor Driver, they can also be used with the ProDriver.
Here are a few other stepper motor options. For a full list of options from our catalog, please visit the stepper motor product category.
Here are a few other power supply options. For a full list of options from our catalog, please visit the power supply and wall adapter product categories.
Users may find these accessories useful for the Mini Stepper Motor Driver.
Soldering Accessories
While the ProDriver is intended to be solderless, users will need soldering equipment to attach wires and/or headers to the Mini Stepper Motor Driver. Additionally, to modify the jumpers on the Prodriver, users will need a hobby knife.
Suggested Reading
We will skip over the more fundamental tutorials like Ohm's Law and What is Electricity?. However, below are a few fundamental tutorials that may help users familiarize themselves with various aspects of this board.
How to Solder: Through-Hole Soldering
Serial Communication
Installing an Arduino Library
Installing Arduino IDE
Hardware Overview - ProDriver
Board Dimensions
Below, is a basic drawing of the board dimensions and component layout for the SparkFun ProDriver. For more detailed measurements, users should download and open the Eagle files from the GitHub repository or from the Documents tab on the product page.
- The ProDriver includes four mounting holes that are compatible with 4-40 screws, standoffs, and other related hardware.
- There are four 5mm latch pin terminals; a 2-pin terminal for power and three 4-pin terminals for the control pins and motor connections.
- There is a 5.5 x 2.1 mm DC barrel jack as another power connection.
- All the PTH breakout pins have a .10" spacing for headers or to solder more permanent connections.
For more details on the DC barrel jack, 2-pin latch terminal, and 4-pin latch terminal's dimensions, check out the documentation on their respective product pages.
Power
To power the ProDriver, users will need a power supply that has an output of 3.3 - 16V and can source at least 2A. We have provided three different methods for users to connect their power supply to the ProDriver:
- A 5.5 x 2.1 mm DC barrel jack, which is simple and the easiest to use.
- A latch pin terminal that is similar to a screw terminal, except toolless.
- A set of PTH points (
VMandGND) for users who wish to, more permanently, solder their power connections.
Users opting to use the DC barrel jack may find some of these accessories useful:
⚡ Note: Do not connect or disconnect the motor while the ProDriver is powered; as it may damage the motor driver IC.
Power Status LED
A power LED status indicator is also provided on the ProDriver. The LED turns on once the motor power supply is connected and the attached voltage regulator outputs 3.3V. The LED can be disabled by cutting the LED jumper.
LED jumper on the ProDriver. (Click to enlarge) 3.3V PTH Pin
A 3.3V PTH connection is broken out amongst the other pin connections. It is connected to the 3.3V output of the LM117 voltage regulator, which is powered by the motor power supply input.
3V3 PTH pin on the ProDriver. (Click to enlarge) Power Protection
The ProDriver includes a safety features to protect the board and power supply. There is a protection diode to prevent reverse current and a thermal fuse to prevent current from being overdrawn.
⚡ Note: We have provided bypass jumpers for more advance users to circumvent these safety features; however, we recommend NOT modifying them, unless you absolutely know what you are doing. Users can easily damage or destroy their ProDriver and/or power supply by modifying the jumpers.
The
D1 BP and PTC BP jumpers on the ProDriver. (Click to enlarge)
Pin Connections
The ProDriver was designed with latch pins to provide a completely solderless connection to get users up and running faster. We have also broken out those same connections with PTH points, for a more permanent installation. (*These latch pins are great! Just as secure as a screw pin terminal, but without the hassel.)
More details on these pins are laid out in the following sections below, excluding the power pins. Details for the 3V3 and VM pins are described in the power section above.
Latch Terminals
When working with the latch terminals, there are two things to keep in mind. These should be fairly obvious, once you take a closer look at the jaws or clamping mechanism:
- If you look closely at the closed jaws or clamping mechanism, you will notice a small gap. Just like screw terminals, there is a minimum and maximum wire thickness for the jaws to physically clamp onto wires.
- On some stepper motors, you may need to tin (i.e. add a little solder) the wire leads and thicken the wires just enough to be clamped.
- Make sure you are inserting the wire between the jaws.
- Looking to the right end of the picture, below, on the latch partially closed, it should be noted that is possible to accidentally insert a wire above the jaws.
Input Control Pins
The input control pins are used to interface directly with the TC78H670FTG motor driver. The ProDriver was designed with latch pins to provide a completely solderless connection to get users up and running faster. We have also broken out those same connections with PTH, for a more permanent installation. (*These latch pins are great! Just as secure as a screw pin terminal, but without the hassel.)
For more details on the functions of the pins listed below, check out the datasheet for the TC78H670FTG.
| Pin Name | Label | Description | Operating Something |
|---|---|---|---|
| Ground Reference | GND |
Ground (i.e. the 0V reference) | 0V |
| Standby | STBY |
This pin is used to either place the motor driver in standby or initiate one of the control methods.
|
0 to 3.3V (Default: Low or 0V) |
| Enable | EN |
When the motor driver is configured for clock-in stepping, this pin is used to enable the motor output ON or OFF.
|
0 to 3.3V (Default: Low or 0V) |
| Error Detection Flag Output | ERR |
If a thermal shutdown (TSD), over current (ISD), or motor load
open (OPD) error, is triggerd, the pin output is pulled low. Under a normal operating status, the level of ERR pin is equal to the EN control voltage from outside. The error flag can be released by reconnecting the VM power or by setting the device to standby.
|
0 to 3.3V |
|
MODE0 UP-DW (Clock-in) S_DATA (Serial) |
MODE0 |
MODE0: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE1 SET_EN (Clock-in) LATCH (Serial) |
MODE1 |
MODE1: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE2 CLK (Clock-in) S_CLK (Serial) |
MODE2 |
MODE2: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE3 CW-CCW (Clock-in) |
MODE3 |
MODE3: Utilized to configure the conrol method of the motor driver, when the standby pin is released. The pin will then, only function as an input for clock-in stepping:
|
0 to 3.3V (Default: High or 3.3V) |
| Current Threshold Reference | VREF |
Connected to the 10 kΩ potentiometer that controls the maximum drive current to the stepper motor coils. Iout (max) = 1.1 × Vref (V) | 0 to 1.8 V |
3V3 pin is connected to the 3.3V output of the LM117 voltage regulator, which is powered by the motor power supply input. The 3.3V ouptut is utilized as a supply voltage for the voltage divider that controls the maximum drive current through the VREF pin. The supply voltage is also utilized as an I/O reference voltage through the pull-up resistors connected to the MODE0, MODE1, MODE2, and MODE3 pins.Output Channel Pins
The output channel pins are used to drive the coils of the stepper motor. The paired outputs are connected to the two H-Bridges of the motor driver.
| Pin Name | Label | Description |
|---|---|---|
| Positive "A" Channel Output | A+ |
The "A" channel motor output (+) pin |
| Negative "A" Channel Output | A- |
The "A" channel motor output (-) pin |
| Positive "B" Channel Output | B+ |
The "B" channel motor output (+) pin |
| Negative "B" Channel Output | B- |
The "B" channel motor output (-) pin |
For basic information on stepper motors, users should check out our Motors and Selecting the Right One tutorial. Additionally, we have included a few YouTube videos, below, that help explain the theory of the stepping functionality behind stepper motors. Users who have stepper motors with more than four wires, may also find this article enlightening.
Motors and Selecting the Right One
December 12, 2013
TC78H670FTG Motor Driver
The ProDriver is driven by the Toshiba TC78H670FTG stepper motor driver IC. The TC78H670FTG is a 2-phase stepping motor driver, intended for bipolar stepper motors. The chip features two H-Bridge motor drivers that provide users with step size resolutions ranging from full steps, half steps, and micro-stepping down to a 1/128 of a step. The TC78H670FTG can be controlled with the standard clock-in stepping, but it also has an additional option for serial communication.
Some of the advantages to the TC78H670FTG over a simple H-Bridge, include a standby function, selectable mixed decay, error detect flag output, clock- in stepping or serial communication control, software control of the current output, and a minimal parts bill of matierals (BOM). The serial command method is especially unique because it allows users to precisely control the phase, torque, current limit and mixed decay ratio of each coil during the motor operation. Additionally, while in most stepper motor driver ICs, an external trimpot is required to set the current limit; however, with the ProDriver, a simple serial command can be utilized to precisely adjust the current limit.
| Characteristic | Description |
|---|---|
| Motor Power Supply Voltage: | 2.5 to 16.0V |
| Output Current: | 2.0A (max) |
| Control Methods: |
|
| Clock Frequency: |
|
| Step Size Resolution: |
Discrete Steps
Micro-Steps
|
| Error Detection Functions: |
|
Enable/Error Pin Functionality
On the ProDriver the EN and ERR pins are broken out separately; however, these connections are tied to the same pin on the TC78H670FTG, which operates as a control input and output for error flags. A typical application of the EN/ERR pin with a microcontroller is displayed below.
EN/ERR pin application from the datasheet. (Click to enlarge) This duality allows the TC78H670FTG to give users control of the power to the motor drive channels; while also providing autonomous functionality to disable its own power, when an error flag is triggered and simultaneously, provide an output indicator on the same pin.
EN and ERR pins. (Click to enlarge) H-Bridge Power Control
The EN pin controls the ON/OFF operation of the H-Bridges to the motor outputs. When the EN pin is low, all of the H-Bridge MOSFETs turn off and become high impedance (Hi-Z). Likewise, when the EN pin is set high, the motor channel outputs will be driven normally, based on the stepping controls.
EN pin functionality from the datasheet. (Click to enlarge) VM power-on and power-off cycles by setting the EN pin low to disable the motor channel outputs. The EN pin can be set high after the power supply reaches the target voltage and becomes stable.Motor Enable Switch
We have broken out EN pin control to a DPST switch. The switch allows users to easily disable power to the motor channels without connecting additional hardware.
EN pin. (Click to enlarge) Error Detection
The TC78H670FTG has a built-in functionality to detect thermal shutdown (TSD), over current (ISD), or motor load
open (OPD) connection issues. When these errors are triggered, the ERR pin is pulled low. In a normal operating status, the level of ERR pin is equal to the EN control voltage from outside. After the error is triggered, the error flag can be released by reconnecting the VM power or by setting the device to standby.
Standby Function
The standby pin for the TC78H670FTG, is used to set up the control method for the motor driver. When the standby pin is low, the motor is released from any control methods and is in standby. On the up edge, of when the standby pin is set high, the motor driver is configured for clock-in stepping or serial communication control based on the input state of the MODE0, MODE1, MODE2, and MODE3 pins.
HIGH. Pulled from the datasheet. (Click to enlarge) Control Methods
There are two different communication or control methods for users to interface with the ProDriver. The control method is configured by the input state of the MODE0 - MODE3 pins, when the TC78H670FTG is released from standby mode. The TC78H670FTG features the common clock-in stepping method and a more unique serial communication control.
Serial Communication Control
This method is unique to the TC78H670FTG Toshiba motor driver. The control logic allows users to manipulate registers through serial communication, which provide control over:
- The motor rotation direction (or polarity)
- Maximum current output, torque
- OPD error detection
- Selectable mixed decay (used to finely tune drive current to the motor)
- Driving the motor rotation (full steps only).
(*For more details on the configuration options for the available registers, refer to Section 9 of the datasheet.)
Clock-In Stepping Control
This is a standard method for controlling most stepper motor drivers. By default, the ProDriver is configured for clock-in stepping in the fixed mode with a step resolution of 1/128 of a step.
- Step Resolution Modes
With the clock-in control method, users can set up how the step resolution is configured. TC78H670FTG has the two modes for the step resolution settings, a variable mode and a fixed mode. These modes are also initiated by the input states of theMODE0-MODE3pins after releasing the standby pin, when the clock-in control method is configured. Below, is a table from the datasheet of the step resolution settings.- Variable Mode: The motor can be started with full step resolution and the step resolution can be changed while the motor is operating.
- Fixed Mode: Once initiated, the step resolution is configured and maintained during the motor operation.
Once clock-in stepping and the step resolution are configured together. The TC78H670FTG awaits for the up-edge of the clock (CLK) signal, for the MODE2 pin, to before it shifts the motor’s electrical angle per step. The MODE3 pin, controls the clockwise/counter-clockwise (CW-CCW) rotation direction of the motor for clock-in stepping.
- When the
MODE3pin is low, the motor is driven with a counter-clockwise (CCW) operation. - Like wise, when the
MODE3pin is high, the motor is driven with a clockwise (CW) operation.
MODE3 (CLK) and MODE2 (CW-CCW) pin functionality for clock-in stepping, from the datasheet. (Click to enlarge) Step Resolution Transition
In variable mode, users can transition between different ranges of step size resolutions with the MODE0 and MODE1 pins. To enable the transition between step size resolutions, the MODE1 (SET_EN) pin must be high, when the TC78H670FTG is in variable mode for clock-in stepping. The MODE0 (UP-DW) pin is used to control the direction of the step size transition.
- When the
MODE0pin is low, the step size resolution is increased to a smaller step size (i.e. from 1/4 to 1/8 of a step). - Like wise, when the
MODE0pin is high, the step size resolution is decreased to a larger step size (i.e. from 1/8 to 1/4 of a step).
MODE1 (SET_EN) and MODE0 (UP-DW) pin functionality for transitioning the step size resolution during clock-in stepping, from the datasheet. (Click to enlarge) The transition between step size resolutions occurs, synchronously with the up-edge of the next clock signal. It should also be noted, that the transition can only change the step size resolution one increment at a time (i.e. it takes three clock cycles to transition from a 1/4 step size, down three sizes, to a 1/32 step size resolution).
Maximum Drive Current
The maximum drive current for the ProDriver is limited to 2A (max). However, the peak output current can be controlled with two different methods.
Hardware: The first method controls the drive current through the reference voltage (Vref). The reference voltage, can be configured utilizing the external potentiometer or VREF breakout pin.
VREF pin that can be utilized to control the maximum drive current. For the hardware control, the maximum drive current can be calculated with the following equation:
Software: The second method controls the drive current through software. Utilizing serial communication to the TC78H670FTG, the registers can be configured to limit the maximum drive current. The maximum drive current can be calculated with the following equation, based on the configured registers:
Chopping Current Drive
Chopping is a technique that is used to control the average current per phase, by rapidly switching a relatively high output voltage to the motor coils, on and off. This technique improves the current rise time in the motor and improves the torque at high speeds, while maintaining a high efficiency in the constant current drive.
On the TC78H670FTG, the OSCM oscillation frequency (fOSCM) and chopping frequency (fchop) are adjusted with an external resistor (ROSC), connected to the OSCM pin. By default, a 47 kΩ resistor is utilized. However, users can modify the ROSC resistor value by cuttin the OSCM BP jumper and soldering a resistor to the provided OSCM PTH connections.
OSCM BP jumoer and OSCM PTH points on the ProDriver. (Click to enlarge) Heat Sink
There is a thermal ground plane on the bottom of the board available for users to attach a heat sink(s) with some thermal tape, if necessary. However, after several tests by the engineer for this product, we have determined that for most use cases, a heat sink probably won't be necessary.
Hardware Overview - Mini Stepper Motor Driver
Board Dimensions
Below, are basic drawings of the board dimensions and component layout for the SparkFun Mini Stepper Motor Driver. For more detailed measurements, users should download and open the KiCad files from the GitHub repository or from the Documents tab on the product page. It should be noted that the layout of the PTH breakout pins is compatible with breadboards and that the pins on the edge of the board, have a .10" spacing for headers (or to solder more permanent connections).
SparkFun Mini Stepper Motor Driver board dimensions. (Click to enlarge)
Power
Unlike the ProDriver, the Mini Stepper Motor Driver requires two power inputs:
3V3- Supplies the I/O voltage for the pull-up resistors on theM0-M3pins. Additionally, it is connected to a voltage divider that provides the reference voltage (VREF) for the drive current, limitation.VM- Powers the TC78H670FTG motor driver IC and supplies the output power for driving a bipolar stepper motor (or DC motors).
I/O Voltage Level
The 3.3V PTH connection provides the I/O voltage level for the pul-up resistors on the M0 - M3 pins. It is also used for the hardware configuration for the drive current, limitation on the TC78H670FTG.
3V3 pin on the Mini Stepper Motor Driver. (Click to enlarge) VREF), which has a maximum input range of 1.8V and the resistor combination of the voltage divider, was calculated with the assumption that 3.3V would be provided.Motor
⚡ Note: Do not connect or disconnect the motor while the Mini Stepper Motor Driver is powered; as it may damage the motor driver IC.
In order to drive a motor, users will need a power supply with an voltage between 3.3 - 16V and can source at least 2A. Users will connect their power supply to the VM and GND pins on the Mini Stepper Motor Driver.
VM and GND pins on the Mini Stepper Motor Driver. (Click to enlarge) ⚡ Note: For the Mini Stepper Motor Driver, we recommend that users attach an electrolytic capacitor (>50µF) between the VM and GND pins.
Users that have a power supply with a DC barrel jack, may find some of these accessories useful:
Pin Connections
The Mini Stepper Motor Driver was designed with PTH breakout pins in a compact layout that is compatible with breadboards.
More details on these pins are laid out in the following sections below, excluding the power pins. Details for the 3V3 and VM pins are described in the power section above.
Input Control Pins
The input control pins are used to interface directly with the TC78H670FTG motor driver. For more details on the functions of the pins listed below, check out the datasheet for the TC78H670FTG.
| Pin Name | Label | Description | Operating Something |
|---|---|---|---|
| Ground Reference | GND |
Ground (i.e. the 0V reference) | 0V |
| Standby | STBY |
This pin is used to either place the motor driver in standby or initiate one of the control methods.
|
0 to 3.3V |
| Enable | EN |
When the motor driver is configured for clock-in stepping, this pin is used to enable the motor output ON or OFF.
|
0 to 3.3V (Default: Low or 0V) |
| Error Detection Flag Output | ERR |
If a thermal shutdown (TSD), over current (ISD), or motor load
open (OPD) error, is triggerd, the pin output is pulled low. Under a normal operating status, the level of ERR pin is equal to the EN control voltage from outside. The error flag can be released by reconnecting the VM power or by setting the device to standby.
|
0 to 3.3V |
|
MODE0 UP-DW (Clock-in) S_DATA (Serial) |
M0 |
MODE0: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE1 SET_EN (Clock-in) LATCH (Serial) |
M1 |
MODE1: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE2 CLK (Clock-in) S_CLK (Serial) |
STEP/M2 |
MODE2: Utilized to configure the conrol method of the motor driver, when the standby pin is released. Based upon that control method, the pin will then function as one of the following inputs:
|
0 to 3.3V (Default: High or 3.3V) |
|
MODE3 CW-CCW (Clock-in) |
DIR/M3 |
MODE3: Utilized to configure the conrol method of the motor driver, when the standby pin is released. The pin will then, only function as an input for clock-in stepping:
|
0 to 3.3V (Default: High or 3.3V) |
| 3.3V Input | 3V3 |
|
3.3V |
| Current Threshold Reference | VREF |
Connected to the 10 kΩ potentiometer that controls the maximum drive current to the stepper motor coils. Iout (max) = 1.1 × Vref (V) |
0 to 1.8 V
(assuming a 3.3V input voltage) |
VREF), which has a maximum input range of 1.8V and the resistor combination of the voltage divider, was calculated with the assumption that 3.3V would be provided.Output Channel Pins
The output channel pins are used to drive the coils of the stepper motor. The paired outputs are connected to the two H-Bridges of the motor driver.
⚡ Note: Do not connect or disconnect the motor while the Mini Stepper Motor Driver is powered; as it may damage the motor driver IC.
| Pin Name | Label | Description |
|---|---|---|
| Positive "A" Channel Output | A+ |
The "A" channel motor output (+) pin |
| Negative "A" Channel Output | A- |
The "A" channel motor output (-) pin |
| Positive "B" Channel Output | B+ |
The "B" channel motor output (+) pin |
| Negative "B" Channel Output | B- |
The "B" channel motor output (-) pin |
For basic information on stepper motors, users should check out our Motors and Selecting the Right One tutorial. Additionally, we have included a few YouTube videos, below, that help explain the theory of the stepping functionality behind stepper motors. Users who have stepper motors with more than four wires, may also find this article enlightening.
Motors and Selecting the Right One
December 12, 2013
TC78H670FTG Motor Driver
The Mini Stepper Motor Driver operates with the Toshiba TC78H670FTG stepper motor driver. The TC78H670FTG is a 2-phase stepping motor driver, intended for bipolar stepper motors. The chip features two H-Bridge motor drivers that provide users with step size resolutions ranging from full steps, half steps, and micro-stepping down to a 1/128 of a step. The TC78H670FTG can be controlled with the standard clock-in stepping, but it also has an additional option for serial communication.
Some of the advantages to the TC78H670FTG over a simple H-Bridge, include a standby function, selectable mixed decay, error detect flag output, clock- in stepping or serial communication control, software control of the current output, and a minimal parts bill of matierals (BOM). The serial command method is especially unique because it allows users to precisely control the phase, torque, current limit and mixed decay ratio of each coil during the motor operation. Additionally, while in most stepper motor driver ICs, an external trimpot is required to set the current limit; however, with the Mini Stepper Motor Driver, a simple serial command can be utilized to precisely adjust the current limit.
| Characteristic | Description |
|---|---|
| Motor Power Supply Voltage: | 2.5 to 16.0V |
| Output Current: | 2.0A (max) |
| Control Methods: |
|
| Clock Frequency: |
|
| Step Size Resolution: |
Discrete Steps
Micro-Steps
|
| Error Detection Functions: |
|
Enable/Error Pin Functionality
On the Mini Stepper Motor Driver the EN and ERR pins are broken out separately; however, these connections are tied to the same pin on the TC78H670FTG, which operates as a control input and output for error flags. A typical application of the EN/ERR pin with a microcontroller is displayed below.
EN/ERR pin application from the datasheet. (Click to enlarge) This duality allows the TC78H670FTG to give users control of the power to the motor drive channels; while also providing autonomous functionality to disable its own power, when an error flag is triggered and simultaneously, provide an output indicator on the same pin.
EN and ERR pins on the Mini Stepper Motor Driver. (Click to enlarge) H-Bridge Power Control
The EN pin controls the ON/OFF operation of the H-Bridges to the motor outputs. When the EN pin is low, all of the H-Bridge MOSFETs turn off and become high impedance (Hi-Z). Likewise, when the EN pin is set high, the motor channel outputs will be driven normally, based on the stepping controls.
EN pin functionality from the datasheet. (Click to enlarge) VM power-on and power-off cycles by setting the EN pin low to disable the motor channel outputs. The EN pin can be set high after the power supply reaches the target voltage and becomes stable.Error Detection
The TC78H670FTG has a built-in functionality to detect thermal shutdown (TSD), over current (ISD), or motor load
open (OPD) connection issues. When these errors are triggered, the ERR pin is pulled low. In a normal operating status, the level of ERR pin is equal to the EN control voltage from outside. After the error is triggered, the error flag can be released by reconnecting the VM power or by setting the device to standby.
Standby Function
The standby pin for the TC78H670FTG, is used to set up the control method for the motor driver. When the standby pin is low, the motor is released from any control methods and is in standby. On the up edge, of when the standby pin is set high, the motor driver is configured for clock-in stepping or serial communication control based on the input state of the M0, M1, M2, and M3 pins.
HIGH. Pulled from the datasheet. (Click to enlarge) Control Methods
There are two different communication or control methods for users to interface with the Mini Stepper Motor Driver. The control method is configured by the input state of the M0 - M3 pins, when the TC78H670FTG is released from standby mode. The TC78H670FTG features the common clock-in stepping method and a more unique serial communication control.
Serial Communication Control
This method is unique to the TC78H670FTG Toshiba motor driver. The control logic allows users to manipulate registers through serial communication, which provide control over:
- The motor rotation direction (or polarity)
- Maximum current output, torque
- OPD error detection
- Selectable mixed decay (used to finely tune drive current to the motor)
- Driving the motor rotation (full steps only).
(*For more details on the configuration options for the available registers, refer to Section 9 of the datasheet.)
Clock-In Stepping Control
This is a standard method for controlling most stepper motor drivers. By default, the Mini Stepper Motor Driver is configured for clock-in stepping in the fixed mode with a step resolution of 1/128 of a step.
- Step Resolution Modes
With the clock-in control method, users can set up how the step resolution is configured. TC78H670FTG has the two modes for the step resolution settings, a variable mode and a fixed mode. These modes are also initiated by the input states of theM0-M3pins after releasing the standby pin, when the clock-in control method is configured. Below, is a table from the datasheet of the step resolution settings.- Variable Mode: The motor can be started with full step resolution and the step resolution can be changed while the motor is operating.
- Fixed Mode: Once initiated, the step resolution is configured and maintained during the motor operation.
Once clock-in stepping and the step resolution are configured together. The TC78H670FTG awaits for the up-edge of the clock (CLK) signal, for the STEP/M2 pin, to before it shifts the motor’s electrical angle per step. The DIR/M3 pin, controls the clockwise/counter-clockwise (CW-CCW) rotation direction of the motor for clock-in stepping.
- When the
DIR/M3pin is low, the motor is driven with a counter-clockwise (CCW) operation. - Like wise, when the
DIR/M3pin is high, the motor is driven with a clockwise (CW) operation.
DIR/M3 (CLK) and STEP/M2 (CW-CCW) pin functionality for clock-in stepping, from the datasheet. (Click to enlarge) Step Resolution Transition
In variable mode, users can transition between different ranges of step size resolutions with the M0 and M1 pins. To enable the transition between step size resolutions, the M1 (SET_EN) pin must be high, when the TC78H670FTG is in variable mode for clock-in stepping. The M0 (UP-DW) pin is used to control the direction of the step size transition.
- When the
M0pin is low, the step size resolution is increased to a smaller step size (i.e. from 1/4 to 1/8 of a step). - Like wise, when the
M0pin is high, the step size resolution is decreased to a larger step size (i.e. from 1/8 to 1/4 of a step).
M1 (SET_EN) and M0 (UP-DW) pin functionality for transitioning the step size resolution during clock-in stepping, from the datasheet. (Click to enlarge) The transition between step size resolutions occurs, synchronously with the up-edge of the next clock signal. It should also be noted, that the transition can only change the step size resolution one increment at a time (i.e. it takes three clock cycles to transition from a 1/4 step size, down three sizes, to a 1/32 step size resolution).
Maximum Drive Current
The maximum drive current for the Mini Stepper Motor Driver is limited to 2A (max). However, the peak output current can be controlled with two different methods.
Hardware: The first method controls the drive current through the reference voltage (Vref). The reference voltage, can be configured utilizing the external potentiometer or VREF breakout pin.
VREF pin that can be utilized to control the maximum drive current. For the hardware control, the maximum drive current can be calculated with the following equation:
Software: The second method controls the drive current through software. Utilizing serial communication to the TC78H670FTG, the registers can be configured to limit the maximum drive current. The maximum drive current can be calculated with the following equation, based on the configured registers:
Chopping Current Drive
Chopping is a technique that is used to control the average current per phase, by rapidly switching a relatively high output voltage to the motor coils, on and off. This technique improves the current rise time in the motor and improves the torque at high speeds, while maintaining a high efficiency in the constant current drive.
On the TC78H670FTG, the OSCM oscillation frequency (fOSCM) and chopping frequency (fchop) are adjusted with an external resistor (ROSC), connected to the OSCM pin. On the Mini Stepper Motor Driver, a 47 kΩ resistor is utilized.
Hardware Assembly
Hardware Connections
Latch Terminals
When working with the latch terminals of the ProDriver, users should be aware of the following, about the clamping mechanism:
- If you look closely at the closed jaws or clamping mechanism, you will notice a small gap. Just like screw terminals, there is a minimum and maximum wire thickness for the jaws to physically clamp onto wires.
- On some stepper motors, you may need to tin (i.e. add a little solder) the wire leads and thicken the wires just enough to be clamped.
- Make sure you are inserting the wire between the jaws.
- Looking to the right end of the picture, below, on the latch partially closed, it should be noted that is possible to accidentally insert a wire above the jaws.
Headers
When prototyping, users may consider soldering headers to the ProDriver or Mini Stepper Motor Driver. Most users may consider solder headers to the Mini Stepper Motor Driver, as the pin layout is compatible with breadboards.
When connecting Mini Stepper Motor Drivers in parallel, users may find it more convenient to utilize our stackable headers.
Hookup Wires
For a more permanent connection, user may choose to solder their connections directly to the ProDriver or Mini Stepper Motor Driver.
Power Connections
On the Prodriver, we recommend one of our wall adapter, power supplies to connect to the DC barrel jack. Otherwise, users can utilize the (VM and GND) PTH or latch pins to attach an external power supply.
On the Mini Stepper Motor Driver, users can connect an external power supply to the VM and GND PTH pins. When prototyping with a breadboard, we recommend using either the regulated power from a development board or utilizing a barrel jack adapter.
⚡ Note: For the Mini Stepper Motor Driver, we recommend that users attach an electrolytic capacitor (>50µF) between the VM and GND pins.
Input Control Pin Connections
The input control pins need to be connected to a microcontroller. To utilize the Arduino examples below, without modifying the code, we recommend using the SparkFun RedBoard (Qwiic) as the microcontroller. Use the table and image below to hookup a SparkFun RedBoard to the ProDriver or Mini Stepper Motor Driver with some jumper wires.
| ProDriver Control Pins | STBY |
EN |
MODE0 |
MODE1 |
MODE2 |
MODE3 |
ERR |
|---|---|---|---|---|---|---|---|
| Mini Stepper Motor Driver Control Pins | STBY |
EN |
M0 |
M1 |
STEP/M2 |
DIR/M3 |
ERR |
| RedBoard Pins | D8 |
D7 |
D6 |
D5 |
D4 |
D3 |
D2 |
MODE 1/M1 pin. Each motor driver board requires a seperate pin on the microcontroller to operate their MODE 1/M1 pin. (See the example below)Motor Channel Output Connections
The output channels for the H-Bridges need to be connected to the stepper motor. Users need to hookup the wire pairs for each coil to individual channels. However, the polarity of the connections isn't very important as the direction of the motor rotation can be controlled in software. For the recommended stepper motor, use the table and image below to hookup the motor to the ProDriver or Mini Stepper Motor Driver.
| Motor Driver Output Channels | A+ |
A- |
B+ |
B- |
|---|---|---|---|---|
| Stepper Motor Wires | Black | Green | Red | Blue |
⚡ Note: Do not connect or disconnect the motor while the motor driver is powered; as it may damage the TC78H670FTG IC.
Motor Coil Pairs
In order to determine the wire pairs for each coil on their stepper motor, users can refer to the datasheet for the stepper motor. Often, the relevant information is indicated as shown in the diagram below.
For a 4-wire motor, users can alternatively use a multimeter to determine the wire pairs for the coils. This is done by comparing the resistance of one wire and against each of the three remaining wires. Whichever wire shows the lowest resistance against the first wire is the pair mate. The remaining two wires should show similar resistance between the two of them.
Examples
Single Stepper Motor
Utilizing the instructions above, an example of the standard assembly used for most of the examples in the Arduino library, is shown below.
The SparkFun RedBoard connected to a ProDriver and stepper motor. (Click to enlarge)
The SparkFun RedBoard connected to a Mini Stepper Motor Driver and stepper motor. (Click to enlarge)
| ProDriver Control Pins | STBY |
EN |
MODE0 |
MODE1 |
MODE2 |
MODE3 |
ERR |
|---|---|---|---|---|---|---|---|
| Mini Stepper Motor Driver Control Pins | STBY |
EN |
M0 |
M1 |
STEP/M2 |
DIR/M3 |
ERR |
| RedBoard Pins | D8 |
D7 |
D6 |
D5 |
D4 |
D3 |
D2 |
Multiple Stepper Motors
For users interested in utilizing multiple stepper motors, we have provided an additional Arduino example for hooking up two Mini Stepper Motor Driver(s) and/or ProDriver(s) in parallel. Use the table and image below to hookup the SparkFun RedBoard to the two motor drivers with some jumper wires.
Two ProDrivers
Two Mini Stepper Motor Drivers
Combination
MODE 1/M1 pin. Each motor driver will utilizes a different pin on the RedBoard, for their MODE 1/M1 pin.| Motor Driver (1) | STBY |
EN |
MODE0
M0
|
MODE1
M1
|
MODE2
STEP/M2
|
MODE3
DIR/M3
|
ERR |
|
|---|---|---|---|---|---|---|---|---|
| Motor Driver (2) | STBY |
EN |
MODE0
M0
|
MODE1
M1
|
MODE2
STEP/M2
|
MODE3
DIR/M3
|
ERR |
|
| RedBoard | D8 |
D7 |
D6 |
D5 |
D9 |
D4 |
D3 |
D2 |
Arduino Library Overview
Note: This example assumes you are using the latest version of the Arduino IDE on your desktop. If this is your first time using Arduino, please review our tutorial on installing the Arduino IDE. If you have not previously installed an Arduino library, please check out our installation guide.
Installing an Arduino Library
January 11, 2013
We've written a library to easily get setup and control stepper motors with the SparkFun ProDriver. However, before we dive into spinning motors, let's take a closer look at the available functions in the library. You can install this library through the Arduino Library Manager. Search for SparkFun ProDriver TC78H670FTG Arduino Library and you should be able to install the latest version. If you prefer manually downloading the libraries from the GitHub repository, you can grab them here:
Let's get started by looking at the functions that set up the SparkFun ProDriver:
Class
In the global scope, construct your device object (such as myProDriver) without arguments.
PRODRIVER myProDriver;
Functions
Below, are the available methods, which can be called:
.begin()- Initializes the motor driver with basic settings. It also returns false if error is detected (i.e. ERR pin is pulled low by the IC)..pinSetup()- Configures pins as inputs/outputs as needed, and to default settings (disabled, standby).enable()- Enables power to the motor output channels..diable()- Disables power to the motor output channels.controlModeSelect()- This configures the IC into the mode specified by thesettings.controlModevariable..errorStat()- This function checks the status of the ERR output, which is triggered for thermal shutdown (TSD), overcurrent (ISD), or motor load open (OPD) errors..step(steps, direction, clockDelay)- Utilizes the CLOCKIN mode to step the motor a set amount of steps in a specified direction.changeStepResolution(resolution)- Used to change the step resolution with clock-in stepping.sendSerialCommand()- With the serial communication method, this function sends a serial command, if one of the settings for the serial control is modified.- Note, one of the settings (listed below) must be changed prior to calling this function, for a new command to be sent.
settings.phaseAsettings.phaseBsettings.currentLimAsettings.currentLimBsettings.torquesettings.openDetectionsettings.mixedDecayAsettings.mixedDecayBsettings.phasePosition
- Note, one of the settings (listed below) must be changed prior to calling this function, for a new command to be sent.
.stepSerial(steps, direction, stepDelay)- Used with the serial communication method, to rotate the motor for a specified number of steps and direction.- Note, this function utilizes full steps.
stepSerialSingle(direction)- Used with the serial communication method, to rotate the motor with a single step in a specified direction..setTorque(newTorque)- A wrapper function to set desired torque setting.- Note, the changes will not take effect on the motor driver until
sendSerialCommand()is called. - Valid torque options include the following:
PRODRIVER_TRQ_100(default set in constructor)PRODRIVER_TRQ_75PRODRIVER_TRQ_50PRODRIVER_TRQ_25
- Note, the changes will not take effect on the motor driver until
.setCurrentLimit(currentLimit)- A wrapper function to set desired current limit setting.- Note, this applies the current limit on both coils (A and B), is a percentage of
VREF, and affected by the torque setting. The changes will not take effect on the motor driver untilsendSerialCommand()is called.currentLimit(10-bit value: 0-1023)
- Note, this applies the current limit on both coils (A and B), is a percentage of
Arduino Examples
Note: Most of the examples in the Arduino library will use a standard setup for the ProDriver or Mini Stepper Motor Driver (shown below), with the exception of the Example8_SerialMultiMotor demo code.
The SparkFun RedBoard connected to a ProDriver and stepper motor. (Click to enlarge)
The SparkFun RedBoard connected to a Mini Stepper Motor Driver and stepper motor. (Click to enlarge)
Example 1: Basic Motor Control
The first example in the Arduino library is perfect for demonstrating the basic functionality of the Mini Stepper Motor Driver/ProDriver. In the Arduino IDE, the example file can be found in the File > Examples > SparkFun ProDriver TC78H670FTG Arduino Library > Example1_Basic drop down menu. The example, utilizes the default configuration of the Arduino library and steps the motor utilizing clock-in control.
Example 8: Serial Control - Multiple Motors
Example 8 demonstrates the operation of multiple motor drivers through a parallel connection. In the Arduino IDE, the example file can be found in the File > Examples > SparkFun ProDriver TC78H670FTG Arduino Library > Example8_SerialMultiMotor drop down menu. The example, configures the microcontroller to sequentially operate multiple ProDrivers.
Troubleshooting
For users looking for technical assistance, click on the link. There you will find, basic troubleshooting tips and instructions to get started with posting a topic in our forums. Our technical support team will do their best to assist you.
Motor Misstep
If users experience a jittery response from their motor or their motor missteps, try increasing the drive current with the potentiometer.
VREF pin that can be utilized to control the maximum drive current. (Click to enlarge) By twisting the potentiometer with a screwdriver, users can configure the total drive current from 0A to 2A.
Resources and Going Further
For more on the SparkFun ProDriver and Mini Stepper Motor Driver (TC78H670FTG), check out the links below:
- Schematic (PDF)
- Board Dimensions (PDF)
- Eagle Files (ZIP)
- GitHub Repository
- Schematic (PDF)
- Board Dimensions (PDF)
- KiCad Files (ZIP)
- GitHub Repository
General Information
For more motor control tutorial, check out the links below:
Hacker in Residence: The Harmonic Skew Zoetrope
GPS Differential Vector Pointer
Electret Mic Breakout Board Hookup Guide
Continuous Rotation Servo Trigger Hookup Guide
How to Build a Remote Kill Switch
micro:bot Kit Experiment Guide
Qwiic Haptic Driver DA7280 Hookup Guide
Or check out this blog post for inspiration