ST STEVAL-PTOOL2V1 User manual

Introduction
The STEVAL-PTOOL2V1 is a ready-to-use reference design tailored for medium voltage power tools driven by 3-phase
brushless motors and supplied from 8S to 15S batteries. It can also effectively be used in other battery-operated applications
requiring similar architecture, rating and performance.
The STEVAL-PTOOL2V1 is based on the STSPIN32F0252 motor controller which embeds a 3-phase 250 V gate driver, a
Cortex®‑M0 STM32 MCU and STL130N8F7 MOSFETs.
The power stage can be populated with any power MOSFET with similar ratings and hosted in a powerFLAT 5x6 package.
The board has a single shunt sensing topology. Field-oriented control (FOC) and sensored or sensorless 6-step control
implementation allows driving permanent magnet synchronous motors (PMSMs) and brushless DC (BLDC) motors.
This reference design can deliver up to 19 A of continuous current with very good thermal dissipation performance thanks to the
mounted heat-sink. It is compatible with a wide range (from 20 to 72 VDC) input voltage and includes a power supply stage with
the VIPER013BLS in buck configuration to generate +12 V and +3.3 V supply voltage required by the application.
The STEVAL-PTOOL2V1 embeds a potentiometer for speed variation and is fully protected from thermal shutdown,
undervoltage lockout and overcurrent.
It comes in a compact layout of 80 x 58 mm and includes the STSW-PTOOL2V1 six-step companion firmware that uses the
position feedback from Hall effect sensors.
The STSW-PTOOL2V1 firmware can be debugged and configured through an external ST-LINK debugger (ST-LINK/V2-1 or ST-
LINK/V3MINI).
Figure 1. STEVAL-PTOOL2V1 evaluation board
Getting started with the STEVAL-PTOOL2V1 compact reference design for
medium voltage brushless power tools based on STSPIN32F0252
UM2772
User manual
UM2772 - Rev 1 - October 2020
For further information contact your local STMicroelectronics sales office.
www.st.com

1Getting started
1.1 Safety precautions
Danger:
There is danger of serious personal injury, property damage or death due to electrical shock and
burn hazards if the kit or components are improperly used or installed incorrectly.
Warning:
• The kit is not electrically isolated from the high-voltage supply AC-DC input.
• The evaluation board is directly linked to the mains voltage. No insulation is ensured
between the accessible parts and the high voltage. All measurement equipment must be
isolated from the mains before powering the board.
• When using an oscilloscope with the evaluation board, it must be isolated from the AC line.
This prevents shock from occurring as a result of touching any single point in the circuit, but
does NOT prevent shock when touching two or more points in the circuit.
Caution: During assembly, testing, and operation, the evaluation board poses several inherent hazards, including bare
wires, moving or rotating parts and hot surfaces.
All operations involving transportation, installation, use and maintenance must be performed by skilled technical
personnel who is familiar with the installation, use and maintenance of power electronic systems.
Work area safety
• The work area must be clean and tidy
• Do not work alone when boards are powered
• Protect the area against any unauthorized access by putting suitable barriers and signs
• A system architecture that supplies power to the evaluation board must be equipped with additional control
and protective devices in accordance with the applicable safety requirements (i.e., compliance with technical
equipment and accident prevention rules)
Electrical safety
• Remove power supply from the evaluation board and electrical loads before performing any electrical
measurement
• Arrange measurement setup, wiring and configuration paying attention to high voltage sections
• Once the setup is complete, power the board
Danger:
Do not touch the evaluation board when it is powered or immediately after it has been
disconnected from the voltage supply as several parts and power terminals containing potentially
energized capacitors need time to discharge, and heat-sinks and transformers may still be very
hot.
The kit is not electrically isolated from the AC-DC input.
Personal safety
• Always wear suitable personal protective equipment, such as insulating gloves and safety glasses
• Take adequate precautions and install the board preventing accidental touch
• Use protective shields, such as insulating box with interlocks
UM2772
Getting started
UM2772 - Rev 1 page 2/28

1.2 Overview
The STEVAL-PTOOL2V1 features:
• 20 to 72 VDC input voltage
• Up to 250 V high voltage rail (limited to 100 V by on-board components)
• Up to 19 Arms output current
•STSPIN32F0252 featuring:
– 250 V, 1 A 3-phase gate driver
– Smart shutdown OCP
– Cortex-M0 STM32
•STL130N8F7 MOSFET power stage with:
– VDS = 80 V
– RDS(on) max. = 3.6 mΩ
– 5x6 PowerFlat package
• Single shunt current sensing for:
– Sensored or sensorless 6-step algorithm
– Single shunt vector algorithm
• Digital Hall sensors and encoder input
• Plug-and-play thanks to the six-step firmware with Hall-effect sensor feedback
• Speed regulation through an external trimmer
• Heat-sink for the best power dissipation performance
• Fully protected:
– Thermal shutdown
– Undervoltage lockout
– Overcurrent protection
• Compact footprint (80 x 58 mm)
• Bus voltage sensing
• 12 V VCC and 3.3 V VDD supplies
• Serial wire debug (SWD) port for debugging/programming
• UART TX-RX interface
• Simple user interface with buttons and trimmer
• RoHS compliant
1.3 Hardware and software requirements
To use the STEVAL-PTOOL2V1 board, you need:
• a Windows (XP, Vista, 7, 8 or 10) PC
•ST-LINK debugger/programmer for STM32
•STSW-PTOOL2V1 firmware
• a three-phase brushless or PMSM motor with compatible current and voltage ranges
• External DC power supply
1.4 Evaluation board intended use
The STEVAL-PTOOL2V1 is intended for evaluation purposes only and must not be used for electrical installations
or machinery. Technical data and information concerning the power supply conditions should be strictly observed.
UM2772
Overview
UM2772 - Rev 1 page 3/28

1.5 Installing the board
• The installation and cooling down of the evaluation board must be in accordance with the specifications and
target application
• The motor drive converters must be protected against excessive strain. In particular, components should not
be bent or isolating distances altered during transportation or handling
• No contact must be made with other electronic components and contacts
• The evaluation board contains electrostatic sensitive components that could be damaged if used incorrectly
UM2772
Installing the board
UM2772 - Rev 1 page 4/28

2Hardware description and configuration
Figure 2. STEVAL-PTOOL2V1 circuitry main blocks - top view
1. SWD, UART, GPIOs
2. Power supply
3. Feedback network
4. STSPIN32F0252
1
2
3
4
UM2772
Hardware description and configuration
UM2772 - Rev 1 page 5/28

Figure 3. STEVAL-PTOOL2V1 circuitry main blocks - bottom view
1. Power stage
2. Shunt resistor
3. Heat sink mounting hole
4. Heat sink mounting hole
5. Heat sink mounting hole
6. Heat sink mounting hole
1
2
3
5
4
6
UM2772
Hardware description and configuration
UM2772 - Rev 1 page 6/28

Figure 4. STEVAL-PTOOL2V1 main components and connectors
1. J3 external trigger
2. VBAT-
3. VBAT+
4. J8 W phase
5. J7 V phase
6. J6 U phase
7. J2 Hall encoder connector
8. J1 external speed regulation potentiometer
9. TR1 speed regulation trimmer
10. SW1 spinning direction switch
11. J9 external direction switch
12. J10 UART SWD - GPIO connector
13. J11 SWD connector
14. SW2 trigger button
Table 1. Jumper settings
Jumper Permitted configurations Default condition
JP1 External reset (connected through soldering pads) OPEN
JP2 Selection PA0 connected to BEMF phase U (1-2 CLOSED) or Hall 1 (2-3 CLOSED) (2-3 CLOSED)
JP3 Selection PA1 connected to BEMF phase V (1-2 CLOSED) or Hall 2 (2-3 CLOSED) (2-3 CLOSED)
JP4 Selection PA2 connected to BEMF phase W (1-2 CLOSED) or Hall 3 (2-3 CLOSED) (2-3 CLOSED)
UM2772
Hardware description and configuration
UM2772 - Rev 1 page 7/28

Table 2. Connectors and test points
Name Pin Label Description
J1 1-2-3 J1 External potentiometer connector (remove R70 if used)
J2
1 A+/H1
Hall/encoder sensor connector2 B+/H2
3 Z+/H3
4 VDD
Hall sensor/encoder supply
5 GND
J3 1-2 J3 External trigger switch
J4 1 VBAT+ Battery positive terminal
J5 1 VBAT- Battery negative terminal
J6 1 OUT U
3-phase BLDC motor phases connectionsJ7 1 OUT V
J8 1 OUT W
J9 1-2-3 J9 External direction switch connector (remove R68 if used)
J10
1
J10
NRST – MCU reset
2 GND
3 SWDIO – MCU debug IO port
4 PB1 MCU GPIO
5 GND
6 PB0 MCU GPIO
7 SWCLK – MCU debug clock port
8 VBUS_fdbk (PA7) – Battery supply MCU monitor
9 VDD – MCU supply
10 CURRENT_REF (PA6) – current reference for 6-step current mode control
11 PA15 MCU GPIO
12 Curr_fdbk (PA5) – shunt current MCU sensing
13 PB3 MCU GPIO
14 Temp_fdbk (PA4) – Power bridge MCU monitor
15 UART1_TX (PB6) – MCU uart transmit
16 PA3 MCU GPIO – Speed set point MCU monitor
17 UART1_RX (PB7) – MCU UART receive
18 PF1 MCU GPIO
19 BOOT0 – MCU bootloader selector
20 PB8 MCU GPIO
J11
1 SWD IO
Auxiliary connector for SWD mode debugging/programming
2 SWD CLK
3 GND
UM2772
Hardware description and configuration
UM2772 - Rev 1 page 8/28

Table 3. Test points
Name Pin Label Description
TP1 - TP1 W phase high side gate
TP2 - OUT3 W phase
TP3 - TP3 RES3
TP4 - TP4 RES2
TP5 - TP5 W phase low side gate
TP6 - TP6 RES1
TP7 - TP7 SENSE
TP8 - TP8 PB4 MCU GPIO
TP9 - TP9 V phase high side gate
TP10 - TP10 V phase
TP11 - TP11 V phase low side gate
TP12 - TP12 SENSE
TP13 - TP13 Speed set point
TP14 - GND GND – signal ground
TP15 - PGND PGND – power ground
TP16 - TP16 PB5 GPIO
TP17 - OD OD – Smart SD Open Drain output, unlatch and restart input
TP18 - TP18 U phase high side gate
TP19 - TP19 U phase
TP20 - TP20 U phase low side gate
TP21 - TP21 SENSE
TP22 - TP22 CIN – comparator positive input
UM2772
Hardware description and configuration
UM2772 - Rev 1 page 9/28

3How to use the board
Step 1. Check the jumper position according to the target configuration (see Section 2 Hardware description
and configuration).
Step 2. Connect the motor phases to J6, J7 and J8 pads on the basis of the motor phase sequence.
Step 3. Supply the board through DC J4 (VBAT+) and J5 (VBAT-) pads.
Step 4. Develop your application using the STSW-PTOOL2V1 firmware example package as starting point.
3.1 Sensorless mode
To configure the STEVAL-PTOOL2V1 evaluation board for 6-step sensorless mode, BEMF network components
(R65, R66, R67) have to be mounted and the BEMF detection network must be enabled.
You have to set jumpers as follows:
• JP2 pins 1-2: closed, PA0 connected to BEMF phase U
• JP3 pins 1-2: closed, PA1 connected to BEMF phase V
• JP4 pins 1-2: closed, PA2 connected to BEMF phase W
UM2772
How to use the board
UM2772 - Rev 1 page 10/28