Texas Instruments DRV8317HEVM User manual

User’s Guide
DRV8317HEVM User's Guide
ABSTRACT
This document is provided with the DRV8317HEVM customer evaluation module (EVM) to evaluate the
DRV8317 4.5-V to 20-V Three-Phase Smart Gate Driver. This User's Guide details the implementation of the
EVM and shows how to set up and power the board with the LAUNCHXL-F280049C (C2000 Piccolo MCU
F280049C LaunchPad™ development kit).
Note
The DRV8317HEVM comes automatically populated with and configured for the DRV8317H hardware
device. It is also compatible for the DRV8317S variant, but the user will need to modify the board to
make it compatible for the SPI variant (see Section 4.4).
Table of Contents
1 Cautions and Warnings..........................................................................................................................................................2
2 Introduction.............................................................................................................................................................................3
3 Quick Start Guide....................................................................................................................................................................4
4 Hardware and Software Overview.........................................................................................................................................5
4.1 Hardware Connections Overview – DRV8317HEVM + LAUNCHXL-F280049C............................................................... 5
4.2 Connection Details............................................................................................................................................................. 5
4.3 LED Lights..........................................................................................................................................................................7
4.4 DRV8317HEVM Configurability – Jumpers and Resistors.................................................................................................8
5 Hardware Setup.................................................................................................................................................................... 14
6 Firmware and GUI Application.............................................................................................................................................15
6.1 C2000 InstaSPIN Universal GUI...................................................................................................................................... 15
6.2 Motor Identification...........................................................................................................................................................15
6.3 Sensorless-FOC Commutation........................................................................................................................................ 16
6.4 Torque Control, Speed Control, and Advanced Modulation Techniques..........................................................................17
6.5 SPI Communication (DRV8317S only).............................................................................................................................17
7 Schematics............................................................................................................................................................................19
7.1 Main Supply..................................................................................................................................................................... 19
7.2 DRV8317H/S....................................................................................................................................................................20
7.3 3.3V Buck Regulator and VREF.......................................................................................................................................21
7.5 LaunchPad Connections.................................................................................................................................................. 22
7.6 Connectors & Interface.................................................................................................................................................... 22
7.7 Status LEDs, Voltage Sense, and Protection...................................................................................................................23
8 Revision History................................................................................................................................................................... 23
Trademarks
All trademarks are the property of their respective owners.
www.ti.com Table of Contents
SLVUCL3 – DECEMBER 2022
Submit Document Feedback
DRV8317HEVM User's Guide 1
Copyright © 2022 Texas Instruments Incorporated

1 Cautions and Warnings
Observe the following cautions and warnings as printed on the EVM board.
HOT SURFACE:
Caution Hot Surface! Contact may cause burns. Do not touch. Please take the proper
precautions when operating.
Regulatory
REACH:
A component in this module contains a REACH Restriction candidate.
Table 1-1. REACH Components
Component Name Manufacturer Part Number Candidate Listed
Chemical
Chemical Identity
(CAS#)
Concentration
PCB terminal block -
PT 1,5/ 5-5,0-H
Phoenix Contact 1935190 Lead 7439-92-1 ~5%
Cautions and Warnings www.ti.com
2DRV8317HEVM User's Guide SLVUCL3 – DECEMBER 2022
Submit Document Feedback
Copyright © 2022 Texas Instruments Incorporated

2 Introduction
The DRV8317 is a 4.5-V to 20-V, 5-A peak integrated three-phase FET driver IC for motor drive applications. It
provides three integrated half-bridges capable of directly driving a 3-phase Brushless-DC motor. The DRV8317
integrates multiple control interface options, low-side integrated current sense resistors and sense amplifiers,
a 3.3-V 80-mA LDO regulator, and a variety of protection and control features. The device is available in the
hardware variant (DRV8317H) and SPI variant (DRV8317S) Table 2-1.
Table 2-1. DRV8317x Device Variants
Device Name Device Description
DRV8317H Hardware variant
DRV8317S SPI variant
The DRV8317HEVM can be interfaced with the TMS320F280049C microcontroller on the LAUNCHXL-
F280049C LaunchPad in correspondence with the reference software to provide the algorithm to the DRV8317
to control the BLDC motor.
This document serves as a startup guide for the DRV8317HEVM + LAUNCHXL-F280049C BLDC motor control
demo kit. It also is intended to help engineers design, implement, and validate reference hardware and software
for the LaunchPad MCU and DRV8317. For step by step details on connecting the LAUNCHXL-F280049C +
DRV8317HEVM, installing software, and running the project to spin a motor, refer to Section 5.
Figure 2-1. DRV8317HEVM PCB Layout
www.ti.com Introduction
SLVUCL3 – DECEMBER 2022
Submit Document Feedback
DRV8317HEVM User's Guide 3
Copyright © 2022 Texas Instruments Incorporated

3 Quick Start Guide
The DRV8317HEVM requires a power supply with a recommended operating range from 4.5-V to 20-V. To setup
and power the EVM, follow the sequence below:
1. Connect the power supply ground to the PGND of the 2-pin power connector J5 and the power supply
positive terminal to the VBAT pin of J5. Ensure jumpers JP1, JP2, and JP3 of the LAUNCHXL-F280049C are
populated to ensure that 3.3 V and 5 V are powered from the LaunchPad.
2. Connect the motor phases to OUTA, OUTB, and OUTC in the correct order. For sensored applications,
connect the Hall sensors to the appropriate locations on the 5-pin connector J7 as shown in Figure 4-2.
Select 3V3 or Ext on jumper J2 to choose the Hall power source voltage to be either from the 3.3 V on the
board or from an external supply.
3. Mate the DRV8317HEVM onto the top half of the LAUNCHXL-F280049C (LaunchPad Headers J1/J3 and
J2/J4) as shown in Figure 4-3. Make sure motor and power connectors face the same direction as the
Micro-USB connector on the LaunchPad.
4. Connect a Micro-USB cable from the computer into the Micro USB connector on the top of the LAUNCHXL-
F280049C.
5. Power on the DRV8317HEVM.
Quick Start Guide www.ti.com
4DRV8317HEVM User's Guide SLVUCL3 – DECEMBER 2022
Submit Document Feedback
Copyright © 2022 Texas Instruments Incorporated

4 Hardware and Software Overview
4.1 Hardware Connections Overview – DRV8317HEVM + LAUNCHXL-F280049C
Figure 4-1 shows the major hardware blocks of the DRV8317HEVM. The DRV8317HEVM is designed for an
input supply from 4.5-V to 20-V. The DRV8317 includes three integrated half-bridges that can drive up to 5-A
peak current which can be used in conjunction with an external MCU for sensored or sensorless trapezoidal
control, sinusoidal control, or Field-oriented control (FOC).
Figure 4-1. Major hardware blocks of the DRV8317HEVM
4.2 Connection Details
Figure 4-2 shows the power supply and motor connections made to the DRV8317HEVM in order to spin a
3-phase sensored or sensorless Brushless-DC motor.
A 4.5-V to 20-V power supply or battery is connected to the VBAT and GND terminals. The three phases of the
BLDC motor connect directly to the OUTA, OUTB, and OUTC terminals of the screw terminal provided on the
DRV8317HEVM.
For sensored applications, the Hall sensor outputs need to be connected to the respective Hall connector
terminals on the DRV8317HEVM.
www.ti.com Hardware and Software Overview
SLVUCL3 – DECEMBER 2022
Submit Document Feedback
DRV8317HEVM User's Guide 5
Copyright © 2022 Texas Instruments Incorporated

Figure 4-2. Connections from motor to DRV8317HEVM
Figure 4-3 shows where the Micro-USB cable is plugged in to the LAUNCHXL-F280049C to provide
communication between the LaunchPad firmware and GUI as well as the correct installment of the
DRV8317HEVM to the J1/J3 and J2/J4 headers of the LaunchPad.
Hardware and Software Overview www.ti.com
6DRV8317HEVM User's Guide SLVUCL3 – DECEMBER 2022
Submit Document Feedback
Copyright © 2022 Texas Instruments Incorporated

Figure 4-3. DRV8317HEVM on headers J1/J3 and J2/J4 of LaunchPad and Micro-USB plugged into
LaunchPad
4.3 LED Lights
There are LED indicators on both the LAUNCHXL-F280049C and DRV8317HEVM when power is provided and
the micro USB cable is plugged in to the LaunchPad.
The DRV8317HEVM has 4 status LEDs on the board. By default, the VM and V_BUCK LEDs will light up when
the board is powered on. The fault LED will light up when the driver reports a fault, and the MCU LED (tied to
GPIO59) can be used for debugging and validation. Table 4-1 shows the LED descriptions, with the LEDs that
are on during power up indicated in bold. Figure 4-4 shows the LED locations on the EVM.
Table 4-1. Description of DRV8317HEVM LEDs (on during power up in bold)
Designator Name Color Description
D1 V_BUCK Green on-board 3.3 V Buck is on
www.ti.com Hardware and Software Overview
SLVUCL3 – DECEMBER 2022
Submit Document Feedback
DRV8317HEVM User's Guide 7
Copyright © 2022 Texas Instruments Incorporated

Table 4-1. Description of DRV8317HEVM LEDs (on during power up in bold) (continued)
Designator Name Color Description
D2 nFAULT Red Lights up when fault condition
has occurred on the DRV8317
D3 VM Green Power is supplied to the board
D4 MCU_LED Orange MCU debugging
Figure 4-4. DRV8317HEVM LEDs
4.4 DRV8317HEVM Configurability – Jumpers and Resistors
The DRV8317HEVM includes a variety of user-selectable jumpers and unpopulated components on the PCB
to choose user settings and evaluate the DRV8317H or the DRV8317S device. A summary of those selectable
settings is listed in Table 4-2 (defaults in bold), and can be seen on the board in Figure 4-5. Section 4.4.2
describes the changes that need to be made to the board in order to use the SPI variant as the main motor
driver IC.
Table 4-2. Description of user selectable settings on DRV8317HEVM (H variant defaults in bold)
Id. Setting Name Description Position Function
A GAIN select (DRV8317H only) Use J8
to select desired gain
settings. DNP jumper if
DRV8317H is not used.
J8 = Bottom 0.25 V/A
J8 = Middle 0.5 V/A
J8 = No Jumper 1 V/A
J8 = Top 2 V/A
Hardware and Software Overview www.ti.com
8DRV8317HEVM User's Guide SLVUCL3 – DECEMBER 2022
Submit Document Feedback
Copyright © 2022 Texas Instruments Incorporated

Table 4-2. Description of user selectable settings on DRV8317HEVM (H variant defaults in bold)
(continued)
Id. Setting Name Description Position Function
B SLEW select (DRV8317H only) Use J9
jumper to select desired
slew rate settings. DNP
jumper if DRV8317H is not
used.
J9 = Bottom 25 V/us
J9 = Middle 50 V/us
J9 = No Jumper 125 V/us
J9 = Top 200 V/us
C MODE select (DRV8317H only) Use J10
jumper to select desired
PWM mode. DNP jumper
if DRV8317H is not used.
J10 = Bottom 6x PWM mode
J10 = Middle 6x direct PWM mode
J10 = No Jumper 3x PWM mode
J10 = Top 3x direct PWM mode
D Power LaunchPad from
buck
0-ohm R13 resistor on
bottom of board used
to supply power from
buck to LaunchPad. DNP
if powering LaunchPad
externally. See Section
4.4.3 on MCU Power
See Section 4.4.3 on
MCU power options
E Supply 5 V from
LaunchPad
0-ohm R36 resistor on
bottom of the board
Supplies 5 V from the
F280049C LaunchPad
boost converter.
R36 is populated Supply 5 V from
LaunchPad
R36 is DNP Supply 5 V externally (if
desired) from the+5V test
point
F Supply 3.3 V from buck 0-ohm R7 resistor
connects buck 3.3 V
voltage to supply main 3.3
V.
R7 is populated Connects buck output to
supply 3.3 V rail
R7 is DNP Supply 3.3 V externally
from the 3V3 test point
G VIN_AVDD select Use J1 to supply
VIN_AVDD voltage from
either VM or 5 V.
J1 = Left VIN_AVDD supplied from
VM
J1 = Right VIN_AVDD supplied from
5 V
H HALL_EXT select Use J2 to supply Hall
power externally or from
3.3 V
J2 = Left Hall power supplied
externally from the HALL
PWR test point
J2 = Right Hall power supplied
from 3V3
I SPI variant connections Populate specific resistors
to properly use the
Hardware or SPI variant
SPI variant: Populate R9,
R10, R11, and R12
J VREF connection 0-ohm R54 resistor
supplies CSA REF from
on-board VREF
R54 is populated CSA REF is supplied
from on-board VREF
voltage
R54 is not populated CSA REF needs to
be supplied externally
through VREF test pin
www.ti.com Hardware and Software Overview
SLVUCL3 – DECEMBER 2022
Submit Document Feedback
DRV8317HEVM User's Guide 9
Copyright © 2022 Texas Instruments Incorporated

Table 4-2. Description of user selectable settings on DRV8317HEVM (H variant defaults in bold)
(continued)
Id. Setting Name Description Position Function
K CSA output filtering C9-11 and R3, 5, and 6
are used for RC filtering
C9-11 and R3, 5, and 6
populated
RC filter for CSA outputs
C9-11 and R3, 5, and 6
not populated
No RC filter for CSA
outputs
Figure 4-5. User-selectable jumpers and DNP components on DRV8317HEVM
4.4.1 DRV8317H Compatibility
The DRV8317HEVM default is the DRV8317H (Hardware variant), which can be used to spin a 3-phase
Brushless-DC motor with selectable modes configured with hardware settings as shown in Table 4-3.
When using the DRV8317H, resistors R8, R9, R10, R11, and R12 must be left unpopulated. This allows the user
to select settings using the MODE, SLEW, and GAIN pins by using jumpers on J10, J9, and J8. An outline of the
various hardware selectable settings can be found below.
Note
In order to change the hardware settings for the GAIN, MODE, or SLEW using the appropriate
jumpers, the device must first be powered off or put into sleep mode in order for the new hardware
settings to take affect.
Table 4-3. Description of Hardware settings for DRV8317H
Setting Jumper Position Description
MODE J10 = Top 3x direct PWM Mode
J10 = No Jumper 3x PWM Mode
J10 = Middle 6x direct PWM Mode
J10 = Bottom 6x PWM Mode
SLEW J9 = Top 200 V/μs
J9 = No Jumper 125 V/μs
J9 = Middle 50 V/μs
J9 = Bottom 25 V/μs
Hardware and Software Overview www.ti.com
10 DRV8317HEVM User's Guide SLVUCL3 – DECEMBER 2022
Submit Document Feedback
Copyright © 2022 Texas Instruments Incorporated