STMicroelectronics STSW-DO40F4 User Manual

UM3454
User manual
Getting started with STSW-DO40F4 demonstration firmware for
NUCLEO‑F401RE enabling STSW-IFAPGUI on X-NUCLEO-DO40A1 and
X‑NUCLEO‑DO41A1 expansion boards
Introduction
The STSW-DO40F4 firmware runs on the NUCLEO-F401RE development board and allows controlling the X-NUCLEODO40A1 and X-NUCLEO-DO41A1 expansion boards using the STSW-IFAPGUI graphical user interface.
The STSW-DO40F4 contains the software routines that enable the USB-based communication between the NUCLEO-F401RE
and the system where the STSW-IFAPGUI runs, and the control of the X-NUCLEO-DO40A1 or X-NUCLEO-DO41A1 expansion
board.
The firmware can control a single expansion board (X-NUCLEO-DO40A1 or X-NUCLEO-DO41A1).
The STSW-IFAPGUI is based on a common engine and several plug-ins designed to communicate through the USB connection
with the application layer running on the NUCLEO-F401RE development board stacked with the expansion board.
UM3454 - Rev 1 - January 2025
For further information, contact your local STMicroelectronics sales office.
www.st.com
UM3454
Overview
1
Overview
•
•
Full control of the X-NUCLEO-DO40A1 and X-NUCLEO-DO41A1 expansion boards via the STSWIFAPGUI graphical user interface
Control of:
–
–
UM3454 - Rev 1
Output channel switching frequency and duty cycle configuration
Visualization of per-channel thermal shutdown diagnostic
page 2/11
UM3454
How to control a single expansion board with IFAPGUI
2
How to control a single expansion board with IFAPGUI
This application scenario is based on the default on-board switches and resistors configuration of the X-NUCLEODO40A1 (or X-NUCLEO-DO41A1) expansion board.
Step 1.
Stack the X-NUCLEO-DO40A1 (or X-NUCLEO-DO41A1) on the NUCLEO-F401RE board flashed with
the STSW-DO40F4 firmware through the Arduino connectors.
Step 2.
Connect the two stacked boards to your PC or laptop USB port through a mini-USB cable.
The STM32 is supplied via USB (3.3 V) and the flashed firmware starts running.
Press the black button on the NUCLEO-F401RE board to reset the firmware.
Step 3.
Launch the STSW-IFAPGUI.
When the application starts, a splash screen appears during the STSW-IFAPGUI components loading.
Figure 1. STSW-IFAPGUI splash screen
If a valid firmware is recognized a COM port is opened for communication.
Figure 2. STSW-IFAPGUI COM port opened
UM3454 - Rev 1
page 3/11
UM3454
How to control a single expansion board with IFAPGUI
Step 4.
Click on the GUI STM32 Nucleo icon after it turns blue (it remains green until the firmware identification
is complete). The GUI automatically identifies the board configuration based on the information
provided by the firmware.
Figure 3. STSW-IFAPGUI identification complete
Step 5.
When the board identification phase has been completed the related STSW-IFAPGUI appears on the
screen.
Figure 4. STSW-IFAPGUI main control panel
Step 6.
–
–
–
–
Step 7.
UM3454 - Rev 1
Use the dedicated section of the GUI for the desired channel of IPS4140HQ (or IPS4140HQ-1)
In each channel section use the left part to manage channel Steady State
In each channel section use the right part to manage channel PWM settings
[Commands Reset] button, available in bottom left side of the GUI, can be used to reset any
channel setting and also the diagnostic pin status check
Configure the power stage of the X-NUCLEO-DO40A1 (or X-NUCLEO-DO41A1): see details in the
DB5346 (or DB5347) and UM3411 (or UM3412).
page 4/11
UM3454
How to control a single expansion board with IFAPGUI
Step 8.
Select the desired switching frequency and duty cycle of the desired output channel through the
[Frequency] and [Duty Cycle] input controls on the PWM part of desired channel section and then
pressing the [ON] button to enable PWM feature for the current channel (or press the [OFF] button to
turn off the PWM feature for the current channel).
Step 9.
The desired output channel steady state can be activated/deactivated by clicking on the [ON] / [OFF]
buttons on the left part of the desired channel section in the [Steady State] part.
Step 10. Click on the [START] button in the diagnostic sections to monitor the on/off state of STATUS1,
STATUS2, STATUS3 or STATUS4 pins.
You can stop monitoring a diagnostic pin status by clicking on the [STOP] button related to the pin.
Press the [RESET] button to reset the last read status of the related pin.
Step 11. Use Channels Selection section to select the channels and drive them in Steady State or PWM mode
with one click.
Figure 5. STSW-IFAPGUI in action
UM3454 - Rev 1
page 5/11
UM3454
How to control a single expansion board with command-line interface
3
How to control a single expansion board with command-line
interface
This application scenario is based on the default on-board switches and resistors configuration of X-NUCLEODO40A1 (or X-NUCLEO-DO41A1) expansion board.
Step 1.
Plug the X-NUCLEO-DO40A1 (or X-NUCLEO-DO41A1) expansion board on top of the NUCLEOF401RE board, flashed with the STSW-DO40F4 firmware, through the Arduino connectors.
Step 2.
Connect the two stacked boards to your PC or laptop USB port through a mini-USB cable. The STM32
is supplied via USB (3.3 V) and the flashed firmware starts running. Press the black button on the
NUCLEO-F401RE board to reset the firmware.
Step 3.
Launch the serial communication terminal application (Tera Term). When the application starts, the
serial communication must be configured as follows, selecting the proper COM port in your system
labeled as "STMicroelectronics STLink Virtual COM Port":
Figure 6. Tera Term: select serial communication method
Figure 7. Tera Term: Setup/Terminal
Figure 8. Tera Term: Setup/Serial port
UM3454 - Rev 1
page 6/11
UM3454
How to control a single expansion board with command-line interface
Step 4.
Press [Enter] and type [h] for help:
Figure 9. CLI help
Step 5.
Type [w?] for a list of available commands:
Figure 10. Command list
Step 6.
Initialize the device using [w0] command:
Figure 11. Device initialization
Step 7.
UM3454 - Rev 1
Continue to interact with the device using commands from the available command list (see above).
page 7/11
UM3454
Revision history
Table 1. Document revision history
UM3454 - Rev 1
Date
Revision
23-Jan-2025
1
Changes
Initial release.
page 8/11
UM3454
Contents
Contents
1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
2
How to control a single expansion board with IFAPGUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
3
How to control a single expansion board with command-line interface. . . . . . . . . . . . . . 6
Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
List of figures. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
UM3454 - Rev 1
page 9/11
UM3454
List of figures
List of figures
Figure 1.
Figure 2.
Figure 3.
Figure 4.
Figure 5.
Figure 6.
Figure 7.
Figure 8.
Figure 9.
Figure 10.
Figure 11.
UM3454 - Rev 1
STSW-IFAPGUI splash screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
STSW-IFAPGUI COM port opened . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
STSW-IFAPGUI identification complete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
STSW-IFAPGUI main control panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
STSW-IFAPGUI in action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Tera Term: select serial communication method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Tera Term: Setup/Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Tera Term: Setup/Serial port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
CLI help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Command list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Device initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
page 10/11
UM3454
IMPORTANT NOTICE – READ CAREFULLY
STMicroelectronics NV and its subsidiaries (“ST”) reserve the right to make changes, corrections, enhancements, modifications, and improvements to ST
products and/or to this document at any time without notice. Purchasers should obtain the latest relevant information on ST products before placing orders. ST
products are sold pursuant to ST’s terms and conditions of sale in place at the time of order acknowledgment.
Purchasers are solely responsible for the choice, selection, and use of ST products and ST assumes no liability for application assistance or the design of
purchasers’ products.
No license, express or implied, to any intellectual property right is granted by ST herein.
Resale of ST products with provisions different from the information set forth herein shall void any warranty granted by ST for such product.
ST and the ST logo are trademarks of ST. For additional information about ST trademarks, refer to www.st.com/trademarks. All other product or service names
are the property of their respective owners.
Information in this document supersedes and replaces information previously supplied in any prior versions of this document.
© 2025 STMicroelectronics – All rights reserved
UM3454 - Rev 1
page 11/11
">