STMicroelectronics STSW-IME014GUI User Manual
Pubblicità
Pubblicità
UM2384
User manual
Getting started with the graphical user interface for the STEVAL-IME014V1B evaluation kit
Introduction
The graphical user interface for the STEVAL-IME014V1B evaluation kit helps to configure the STHV1600 16-channel high voltage pulser for ultrasound imaging applications and build custom waveforms to test the device.
The GUI allows setting up environment variables like clock and pulse frequencies, as well as waveform operating modes.
Figure 1. STSW-IME014GUI main window
UM2384 - Rev 3 - January 2020
For further information contact your local STMicroelectronics sales office.
www.st.com
UM2384
How to run the GUI
1
1.1
1.2
Note:
How to run the GUI
This software is designed and tested for Windows 7 and 10, and requires Microsoft .NET Framework 4.0 to run.
The minimum screen resolution is 1024 x 768.
Download the GUI
The GUI is available for download from the following location on the ST website: STEVAL-IME014V1 product page
How to connect STEVAL-IME014V1B to your PC
Step 1.
Connect a type A to mini type B USB cable between the USB connector on the STEVAL-IME014V1 board and a USB port on your PC
Use the USB connector on the STEVAL-IME014V1 board, instead of the one on the Nucleo board.
USB connection is also suitable to provide low voltage supply to the board, while connected.
Figure 2. USB connection
Step 2.
A removable disk appears in the Computer Resources.
The name of the disk is ST_IME014V1, with a capacity of 10 KB.
Figure 3. ST_IME014V1 disk drive
1.3
1.
If the USB device is not recognized, try a USB + charging port with the symbol.
2.
If this doesn’t work, provide suitable VEXT (pin 4) power supply and GND (pin 5) on the STEVAL-
IME014V1D power supply module before connecting the USB cable.
Run the GUI
After running the STSW-IME014_V1_1_1.exe file, the STSW-IME014GUI main window opens.
UM2384 - Rev 3 page 2/21
Figure 4. GUI main window
UM2384
Run the GUI
Note: For the GUI latest updates (including new features or bug fixes), refer to the STEVAL-IME014V1B evaluation kit web page , in the Resources tab.
UM2384 - Rev 3 page 3/21
UM2384
How to configure the board with the GUI
2
2.1
Note:
How to configure the board with the GUI
Set the environment parameters
The environment parameters available on the GUI window are:
• [f
CLKSYS
] allows you to select one of the available CLKSYS frequencies for the STHV1600:
– 10 MHz
– 50 MHz
– 100 MHz
– 200 MHz
The system may not function properly at 200 MHz because the STEVAL-IME014V1B uses a CMOS interface to provide system clock to the STHV1600 device, whereas a differential interface is usually recommended for high frequencies.
• [ Operation mode ] selects how the waveform is driven:
– Single: one trigger event is generated whenever [ PB1 ] is pressed. On XDCRs, the waveform is generated only once.
– Continuous: after [ PB1 ] is pressed, a trigger event is generated according to desired Pulse Repetition
Frequency set via the [ Rep time ] box. On XDCRs, waveforms are repeated until [ PB1 ] is pressed again.
– CW: waveforms are continuously generated (no pauses) according to [ PB1 ] (used for Start and Stop).
Figure 5. STEVAL-IME014V1B operating mode
CW
CONTINUOUS
SINGLE
UM2384 - Rev 3 page 4/21
Figure 6. PB1 and PB2 location
UM2384
Set the environment parameters
Note:
• [ Rep time ] box (Continuous mode only): is the time between the rising edge of a trigger and the next one; that is, the time between two consecutive TX phases.
The trigger signal generated by STEVAL-IME014V1B is defined as follows:
• State 0: the trigger is set to a low logic level for 500 ns. This interval cannot be modified by the user.
This limit for State 0 of trigger signal applies only to the STEVAL-IME014V1B evaluation kit. The actual trigger to
STHV1600 can be different on the user's application.
• State 1: equals the value in the [ Rep time ] box minus 500 ns
Figure 7. Environment parameters panel
UM2384 - Rev 3 page 5/21
2.2
UM2384
Enable and disable channels
Enable and disable channels
Every channel on the STHV1600 16-channel high voltage pulser can be enabled in TX or in RX.
If a [ TX ] or [ RX ] box is checked for a given [ CHxx ], that channel is enabled in TX or RX, respectively; if neither is checked, the channel is disabled.
Each channel [ CHxx ] can be enabled for both TX and RX.
The [ Select All ] and [ Deselect All ] boxes allow controlling the channels collectively.
Figure 8. Channel enable management
2.3
PW waveform management
Follow the procedure below to create and edit PW waveforms.
Step 1.
Ensure the selected [ Operation mode ] box is [ Single ] or [ Continuous ].
Step 2.
Click the [ Waveform SET ] button.
The Waveform management window opens.
UM2384 - Rev 3 page 6/21
UM2384 - Rev 3
UM2384
PW waveform management
Step 3.
Select the [ WF x ] tab to view or edit, or click the [ + ] tab to create a new waveform
It is possible to build up to 100 waveforms.
Figure 9. Waveform editor
Step 4.
Use the state drop-down menu to set a functional state and insert the desired duration in the "State duration" box.
Figure 10. Waveform state panel page 7/21
UM2384
PW waveform management
Note:
Step 5.
Push one of the five buttons to perform the following operations: a.
[ Add state ] button: adds a new state to the waveform. Normally it adds the state described in the state panel (above the five buttons) at the end of waveform, but if a state is selected in the view panel (list of states shown on the left of the five buttons), it is possible to add the new state before or after the selected state.
b.
[ Remove selected state ] button: removes any selected states of the view panel.
c.
[ Update selected state ] button: substitutes the state selected in the view panel with the new parameters in the state panel.
d.
[ Add a repetition of selected states ] button: repeats two or more consecutive states selected in the view panel, for the number of specified iterations.
Although the STHV1600 device allows compacting repetitions, the GUI does not allow saving RAM space into the STHV1600 waveform memory as it occupies more STHV1600 memory, directly proportional to the number of repetitions.
e.
[ Delete waveform ] button: deletes the entire waveform.
Figure 11. Waveform build panel
Step 6.
Use the waveform view panel to view the individual states of a selected waveform.
Use this panel to select a single state or a group of states .For new/empty waveforms, "END waveform" is the only state listed in the view panel.
Figure 12. Waveform view panel
UM2384 - Rev 3 page 8/21
Step 7.
View the graph panel to observe the shape of a waveform
Different states are indicated by the colors in the corresponding legend
Figure 13. Waveform graph panel
UM2384
CW waveform management
2.4
CW waveform management
Follow the procedure below to create and edit CW waveforms.
Step 1.
Ensure the selected [ Operation mode ] box is [ CW ].
Step 2.
Click the [ CW Waveform SET ] button.
The CW waveform management window opens.
Figure 14. CW waveform management window
UM2384 - Rev 3
Step 3.
Select the CW_WF x tab to view or edit, or click the + tab to create a new waveform
It is possible to build up to 100 waveforms.
page 9/21
UM2384
Assign waveforms to channels
Step 4.
Use the CW waveform view panel to view the individual states of a selected CW waveform.
In this area, set the number of states (from two to four) and define the type and duration of each one.
Figure 15. CW waveform view panel
Step 5.
View the graph panel to observe the shape of a waveform
Different states are indicated by the colors in the corresponding legend
Figure 16. Waveform graph panel
2.5
Assign waveforms to channels
Follow the procedure below to assign waveforms to channels
UM2384 - Rev 3 page 10/21
UM2384
Set beamforming delay and manage RX channels
Step 1.
Use the selector panel to assign a waveform to a channel.
Figure 17. Waveform selector panel
Step 2.
Use the graph section below to check the waveforms.
Figure 18. Waveform graph panel
2.6
Step 3.
Use the [ Same waveform for all channels ] and [ Same waveform for odd/even channels ] buttons to set the waveforms collectively.
Set beamforming delay and manage RX channels
Follow the procedure below to set beamforming delays and manage the RX settings.
UM2384 - Rev 3 page 11/21
UM2384
How to load settings onto the STEVAL-IME014V1B
Step 1.
Use the delay panel to set the beamforming delay for each channel.
Figure 19. Beamforming delay panel
Step 2.
Use the RX panel to manage the RX phase.
The available selections are:
– All channels enter the RX simultaneously, after the last TX
– Each channel enters RX after its corresponding TX according to the delay set in the [ Wait RX ] box.
Figure 20. RX management panel
2.7
Step 3.
Use the [ Set registers ] button to open a new form where all STHV1600 registers can be set at bit level.
How to load settings onto the STEVAL-IME014V1B
Use the following procedure to load the configuration file onto the STEVAL-IME014V1B evaluation board.
Step 1.
On the GUI, click the [ Generate .txt & .bin programming files for STEVAL-IME014V1B ] button.
The software will prompt giving the option of programming the STEVAL-IME014V1B board with the new file.
UM2384 - Rev 3 page 12/21
UM2384
How to load settings onto the STEVAL-IME014V1B
Step 2.
Click [ Yes ] to generate the config file and program the device.
[ No ] generates the config file only.
A popup window appears with instructions to connect the board and save the bin configuration file to the appropriate location.
Step 3.
Ensure the USB port on the board is connected via cable to your PC.
Step 4.
Click the [ OK ] button.
The Save the STEVAL-IME014 configuration binary file window appears
Step 5.
Select the root folder of the Mass Storage Device corresponding to the STEVAL-IME014V1B
(ST_IME014V1 drive) and enter an appropriate file name.
The previous file will be deleted.
Step 6.
Click [ Save ]
A popup window will prompt you whether you want to save the text and bin configuration files.
Step 7.
Click [ Yes ] to save the files in both formats.
They can be useful because:
– txt file lists all the registers set
– bin file can be saved and reused
One popup will appear to prompt you for the txt file name, and another will appear to prompt you for the bin file name.
UM2384 - Rev 3 page 13/21
3
UM2384
Troubleshooting: check status register after a fault
Troubleshooting: check status register after a fault
If LED D5 lights on (red), a fault has occurred and a log file (STEVAL-IME014_log.txt) is written to the board mass storage drive.
Figure 21. STEVAL-IME014V1B fault LED D5
Use the procedure below to identify the causes of any fault events.
Step 1.
On the GUI, click the [ Read Status ] button (with the evaluation kit connected via USB)
Step 2.
Select the root folder of the ST_IME014V1 drive visible in the Window Explorer.
Step 3.
Check the log file path in the path panel and click the [ Change path ] button if the suggested directory does not contain the log file.
Figure 22. Log file path
UM2384 - Rev 3 page 14/21
UM2384
Troubleshooting: check status register after a fault
Step 4.
Check the status panel to identify any issues.
RED boxes indicate a problem.
Figure 23. Fault status panel
UM2384 - Rev 3
Step 5.
Check the log panel to view the interrupt events recorded in the log file from the time the GUI was launched.
Figure 24. Events log panel page 15/21
4
UM2384
Other GUI features
Other GUI features
Other buttons on the GUI are listed below.
•
•
•
[ How to use STSW-IME014GUI ] opens a GUI user guide
[ STHV1600 acquisitions ] provides a collection of oscilloscope screenshots regarding the main performance characteristics of the STHV1600 device
[ Load .cfg GUI setup ] and [ Save .cfg GUI setup ] are used to save and reload GUI configuration files
(waveforms, channel settings, environment setting, etc.)
• [ About ] button for support contact information
UM2384 - Rev 3 page 16/21
5
UM2384
How to start TX activity and overwrite default board waveforms
How to start TX activity and overwrite default board waveforms
Once the previous steps are completed, a .bin file is stored in STEVAL-IME014V1B RAM.
From the RAM, you can run program 1 on the board.
Step 1.
If you are using a high supply voltage, disconnect the USB cable from the PC before starting waveform generation.
Step 2.
Press Push button 1 (PB1) on the STEVAL-IME014V1B board to start generating waveforms.
In Single mode, the waveform stops automatically at the end of the program.
Step 3.
Press Push button 1 (PB1) again to stop the waveform while in Continuous or CW mode.
Step 4.
To store program 1 in the permanent on-board Flash memory (preventing loss of .bin program when
Low Voltage power supply (i.e. VEXT) is removed), press and hold Push button 2 (PB2) for 3 seconds.
The board must be powered externally or via USB during this operation.
Figure 25. Push button 2
LED D1 will light on (red) for a while when the Flash memory is programmed.
Figure 26. LED D1
UM2384 - Rev 3 page 17/21
UM2384
Revision history
Table 1. Document revision history
Date
06-Apr-2018
Version Changes
1 Initial release.
19-Dec-2018 2
1 7 -Jan-20 20 3
Updated Figure 23. Fault status panel.
Updated Introduction, Section 1 How to run the GUI , Section 1.2 How to connect STEVAL-
,
Section 2.1 Set the environment parameters ,
Section 2.2 Enable and disable channels ,
Section 2.3 PW waveform management
,
2.6 Set beamforming delay and manage RX channels ,
Section 2.7 How to load settings onto the
,
Section 3 Troubleshooting: check status register after a fault and
5 How to start TX activity and overwrite default board waveforms .
Minor text edits.
UM2384 - Rev 3 page 18/21
UM2384
Contents
Contents
UM2384 - Rev 3 page 19/21
UM2384
List of figures
List of figures
UM2384 - Rev 3 page 20/21
UM2384
IMPORTANT NOTICE – PLEASE 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 acknowledgement.
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, please 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.
© 2020 STMicroelectronics – All rights reserved
UM2384 - Rev 3 page 21/21
Scarica
Pubblicità