ST UM2313 User manual

November 2017
DocID031215 Rev 1
1/33
www.st.com
UM2313
User manual
Getting started with the STSW-GLA001V1 software package for
the STEVAL-GLA001V1 evaluation board based on STM32Cube
Introduction
The STSW-GLA001V1 firmware is designed to be used with the STEVAL-GLA001V1 insulated AC
switch control evaluation board to evaluate its embedded TRIACs and AC switches, implementing
different control modes.
The firmware is developed from the STM32Cube embedded software libraries for STM32F0 series
using the IAR Embedded Workbench for ARM.
The firmware also lets you interact with the STEVAL-GLA001V1 hardware user interface and allows the
configuration of some parameters using a PC user interface.
Thanks to the dynamic storage of the configuration parameters in a dedicated section of the Flash
memory embedded in the STM32 microcontroller, you can change any parameter any time without the
need of compiling and programming the MCU via third-party tools.

Contents
UM2313
2/33
DocID031215 Rev 1
Contents
1STSW-GLA001V1 firmware structure.............................................5
1.1 Overview...........................................................................................5
1.2 Architecture.......................................................................................5
1.3 Parameters........................................................................................6
1.4 Variables...........................................................................................6
1.5 Parameters and variables stored in the MCU Flash memory............6
2System setup guide.........................................................................9
2.1 Hardware configuration and board setup ..........................................9
2.1.1 Programming the NUCLEO-F030R8 board using a binary file .......... 9
2.1.2 Programming the NUCLEO-F030R8 board using a preconfigured
source project................................................................................................... 12
2.2 STEVAL-GLA001V1 operating modes............................................13
2.2.1 STSW-GLA001V1 control mode detection....................................... 16
2.2.2 ZVS signal synchronization with Vmains zero voltage crossing ...... 16
2.2.3 ON/OFF pulse basic/timer control mode.......................................... 18
2.2.4 Phase control mode.......................................................................... 22
2.2.5 ZVS signal delay measurement ....................................................... 24
2.2.6 User interface ................................................................................... 25
3Revision history ............................................................................32

UM2313
List of tables
DocID031215 Rev 1
3/33
List of tables
Table 1: Stored parameters and variables..................................................................................................7
Table 2: Factory values for td_buffer..........................................................................................................8
Table 3: State machine fault codes ..........................................................................................................15
Table 4: STEVAL-GLA001V1 operating modes: analog input and digital level........................................16
Table 5: STEVAL–GLA001V1 evaluation board: user interface command list ........................................30
Table 6: Document revision history ..........................................................................................................32

List of figures
UM2313
4/33
DocID031215 Rev 1
List of figures
Figure 1: System architecture.....................................................................................................................5
Figure 2: STEVAL-GLA001V1 evaluation board connected to NUCLEO-F030R8 board via X-NUCLEO-
IHM09M1 expansion board.........................................................................................................................9
Figure 3: NUCLEO device on Windows OS .............................................................................................10
Figure 4: ST-LINK utility tool window after bin file opening......................................................................11
Figure 5: ST-LINK utility tool Target menu and Program command ........................................................11
Figure 6: ST-LINK utility tool download window .......................................................................................12
Figure 7: STSW-GLA001V1 firmware –Project workspace on IAR™ .....................................................12
Figure 8: STSW-GLA001V1 firmware –IAR workspace configuration selection.....................................13
Figure 9: STSW-GLA001V1 firmware –IAR workspace Make icon.........................................................13
Figure 10: STSW-GLA001V1 firmware –IAR workspace Download and Debug icon.............................13
Figure 11: STSW-GLA001V1 state machine............................................................................................14
Figure 12: ZVS delay principle..................................................................................................................17
Figure 13: ON/OFF control in basic/timer mode with pulse gate command timing diagram....................18
Figure 14: ON/OFF control in basic/timer mode with pulse gate command timing diagram with td_zvs >
0................................................................................................................................................................19
Figure 15: ON/OFF control in basic/timer mode with pulse gate command timing diagram with td_zvs <
0................................................................................................................................................................20
Figure 16: ON/OFF basic mode control with DC gate command timing diagram ....................................21
Figure 17: ON/OFF timer mode control with DC gate command timing diagram.....................................21
Figure 18: Phase control timing diagram..................................................................................................22
Figure 19: Phase control timing diagram with td_zvs > 0.........................................................................23
Figure 20: Phase control timing diagram with td_zvs < 0.........................................................................24
Figure 21: ZVS delay measurement - oscilloscope capture.....................................................................25
Figure 22: HyperTerminal: new connection window.................................................................................26
Figure 23: HyperTerminal: port settings ...................................................................................................26
Figure 24: Tera Term: new connection menu...........................................................................................27
Figure 25: Tera Term: setup menu...........................................................................................................28
Figure 26: Tera Term: setup menu parameters........................................................................................28
Figure 27: Tera Term: command list.........................................................................................................29
Figure 28: Tera Term: command list sample view (white background and black font) ............................29

UM2313
STSW-GLA001V1 firmware structure
DocID031215 Rev 1
5/33
1 STSW-GLA001V1 firmware structure
1.1 Overview
The STSW-GLA001V1 firmware features:
Based on the STM32Cube embedded software libraries
Support for the NUCLEO-F030R8 board
Configuration and independent control of three TRIACs and AC switches embedded in
the STEVAL-GLA001V1 evaluation board:
On/Off control (DC and pulse modes)
Phase control mode
Timer mode
Hardware user interface via push-buttons and switches
Automatic mains frequency detection at switch-on
PC user interface through a serial terminal as Windows HyperTerminal or Tera Term
to:
configure the firmware parameters
monitor the main firmware variables
control command lines (i.e., start and stop commands)
1.2 Architecture
The STSW-GLA001V1 firmware
a
for the STEVAL-GLA001V1 evaluation board is based on
the STM32Cube HAL peripheral drivers and supports different operating modes for AC
switch control.
Figure 1: System architecture
a
Contact your local STMicroelectronics sales office to obtain the source code

STSW-GLA001V1 firmware structure
UM2313
6/33
DocID031215 Rev 1
The STSW-GLA001V1 firmware consists of a list of functions that allow the user to
interface with the code variables and functions which manage and implement the different
evaluation board operating modes
a
:
AC_Switch_Control_Lib_Interface_Methods.c file: contains the interfacing
functions used by the firmware
User_Methods.c file: contains the methods the user has to refer to for writing his own
program
AC_Switch_Control_Lib.c file: contains all the functions that implement the operating
modes
AC_Switch_Control_Tasks.c file: contains the MediumFrequencyTask() and
theLowFrequencyTask() functions which calls the operating mode functions
The MediumFrequencyTask() function is executed at the SYSTICK frequency (i.e. 1
kHz).
The LowFrequencyTask() function is executed at the mains frequency (50/60 Hz), if the
ZVS detection circuit is used; otherwise, the LowFrequencyTask() function is not
executed.
1.3 Parameters
The STSW-GLA001V1 firmware contains two types of parameters defined in the
AC_Switch_Control_param.h file:
Default parameters: used for the firmware variable initialization/reset.
Firmware configuration parameters: used to set the firmware configuration
parameters (i.e., the minimum and maximum values for the system variables).
When the user wants to change a parameter value, the firmware has to be compiled and
downloaded in the MCU Flash memory using the IAR Embedded Workbench IDE.
1.4 Variables
The AC switch control firmware variables are defined in the AC_Switch_Control_Vars_t
structure contained in the AC_Switch_Control_Lib.h file.
You may not directly access this structure, but you can use the interfacing functions
included in the user project under the AC_Switch_Control_Lib_Interface_Tasks.h
header file.
1.5 Parameters and variables stored in the MCU Flash memory
The firmware stores the set of variables and parameters listed in Table 1: "Stored
parameters and variables" in the MCU Flash memory whenever one of them is changed
and the current machine state is GATE_CONTROL_AVAILABLE_IDLE.
Then, the following two cases should be considered:
The data is changed during the GATE_CONTROL_AVAILABLE_IDLE state: it
causes the data set to be saved in the Flash memory. During this state, data
modification is taken into account in a very short time. Data storage process starts
approximately 1 ms after the end of data modification and ends after about 25 ms
a
Refer to Section 2.2: "STEVAL-GLA001V1 operating modes" for further details.

UM2313
STSW-GLA001V1 firmware structure
DocID031215 Rev 1
7/33
During this process, do not switch the system off to avoid data loss.
The data is changed in a state different from GATE_CONTROL_AVAILABLE_IDLE:
in this case, the store request is activated and the storage process is only performed,
when the state is GATE_CONTROL_AVAILABLE_IDLE.
To avoid data loss, do not switch the system off before reaching the
GATE_CONTROL_AVAILABLE_IDLE state.
The stored values are reloaded at board restart.
If errors occur during the erasing/writing process, the variables stored in the Flash memory
are corrupted and the firmware will restore them to the factory values on the next board
restart.
The user can also manually store data by typing the command store(data) in the serial
terminal (refer to Section 2.2.6: "User interface" for further details).
To avoid data loss, call this function before switching the board off.
Table 1: Stored parameters and variables
Description
Name
Unit
Range
Factory value
ZVS available
zvs_hw
N/A
0 or 1
1
Push button pressure
delay
PBTlow
ms
100 to 500
100
ZVS_delay
td_ZVS
μs
–MainsPeriod/4 to
MainsPeriod/4
0
Pulse time
tp
μs
10 to MainsPeriod/2
5000
Step for pulse time
changing after a tp+
or tp- push button
pressure
tp_step
μs
10 to 1000
1000
Number of steps for
soft-start and soft-
stop
soft_start_stop_n_step
N/A
5 to 100
10
On-time (Timer mode)
OnTime
s
0 to 10000
5
Step for on-time
setting
OnTime_step
s
1 to 10
1
Margin before next
cycle
ZCS_margin
μs
100 to 1000
100
Number of elements
for td buffer
N_td
N/A
5 to 100
20
Minimum td delay
td_min
μs
0 to (td_max-1)
0

STSW-GLA001V1 firmware structure
UM2313
8/33
DocID031215 Rev 1
Description
Name
Unit
Range
Factory value
Maximum td delay
td_max
μs
(td_min+1) to
MainsPeriod/2-
ZCS_margin
MainsPeriod/2-
ZCS_margin
Turn-on delay buffer
td_buffer[N_td]
μs
td_min to td_max
Refer to Table 2:
"Factory values for
td_buffer"
Table 2: Factory values for td_buffer
1
2
3
4
…
20
MainsPeriod/40
MainsPeriod/20
3·MainsPeriod/40
MainsPeriod/10
…
MainsPeriod/2

UM2313
System setup guide
DocID031215 Rev 1
9/33
2 System setup guide
2.1 Hardware configuration and board setup
To use the STSW-GLA001V1 firmware, you need a NUCLEO-F030R8 board and a
STEVAL-GLA001V1 evaluation board.
The two boards are connected through the X-NUCLEO-IHM09M1 expansion board, which
acts as an adapter between a standard ST morpho connector and a 34-pin connector
usually mounted on ST evaluation boards.
a
The user has to ensure that SB16 and the SB50 jumpers on the
NUCLEO-F030R8 board are closed.
Figure 2: STEVAL-GLA001V1 evaluation board connected to NUCLEO-F030R8 board via
X-NUCLEO-IHM09M1 expansion board
The NUCLEO-F030R8 board can be programmed using a binary file or a pre-configured
project.
2.1.1 Programming the NUCLEO-F030R8 board using a binary file
To correctly program the NUCLEO-F030R8 board using a binary file, the user can follow
the drag and drop procedure or use the STM32 ST-LINK utility tool.
2.1.1.1 Drag and drop procedure
1
Install ST-LINK/V2 drivers from www.st.com (usually this is executed automatically
if an Internet connection is available).
2
On the NUCLEO-F030R8 board put the JP5 in U5V position.
a
For further details, refer to the STEVAL-GLA001V1 evaluation board user manual on www.st.com.

System setup guide
UM2313
10/33
DocID031215 Rev 1
3
Plug the NUCLEO-F030R8 board USB connector (CN1) to the PC via a USB type
A to mini-B cable.
If the ST-LINK drivers are correctly installed, the PC recognizes it as an external
memory device called NUCLEO or similar.
4
Download the firmware binary file for the NUCLEO-F030R8 board from
www.st.com.
5
Drag and drop it into the NUCLEO device listed in the disk driver lista.
Figure 3: NUCLEO device on Windows OS
6
Wait until the flashing operation is complete.
2.1.1.2 STM32 ST-LINK utility tool
1
Download the STM32 ST-LINK Utility tool from www.st.com and install it.
2
Open the tool.
3
Plug the NUCLEO-F030R8 board to the PC via the board USB connector (CN1)
through a USB type A to mini-B cable.
4
Ensure the embedded ST-LINK/V2 is configured to program on the NUCLEO-
F030R8 boardb
5
Click on File→Open File
6
Select the binary file to use.
a
Located under Devices with Removable Storage in the Windows OS computer folder.
b
Both CN2 jumpers must be connected.