UM1844
User manual
EVAL-L9958 Graphical user interface
– (GUI)
Introduction
This document describes the STSW-L9958, the Graphical User Interface (GUI) dedicated to set and control the EVAL-L9958 board (DC Motor Driver application boards for L9958) through the SPI protocol and the EN, DI and DIR pins.The STSW-L9958 has been developed using Labview
®
and it works with
SPC560P-DISP evaluation board programmed with a dedicated FW ( GP-Pictus.elf) .
December 2014 DocID027235 Rev 1 1/15
www.st.com
Contents
Contents
UM1844
1 Graphical User Interface description ............................................. 4
2 How to use the GUI to configure the device .................................. 5
3 SPC560P-DISP: USB drivers installation ....................................... 6
4 Labview driver: installation guide .................................................. 9
5 SPC560P-DISP: Load Firmware .................................................... 10
6 Revision history ............................................................................ 14
2/15 DocID027235 Rev 1
UM1844
List of figures
List of figures
Figure 1: :STSW-L9958 Graphical User Interface (GUI) for EVAL-L9958 ................................................. 4
Figure 2: USB Driver Installation
– folder “JtagUsbDriver” ......................................................................... 6
Figure 3: SPC560P-DISP: USB input ......................................................................................................... 6
Figure 4: Start menu, Computer, Manage .................................................................................................. 7
Figure 5: Disk Management ........................................................................................................................ 7
Figure 6: PLS USB JTAG Adapter- COM Ports ......................................................................................... 7
Figure 7: PLS USB JTAG Adapter for SPC5xxx B - Advanced Tab, Enable VCP ..................................... 8
Figure 8: PLS Drivers and VCP .................................................................................................................. 8
Figure 9: UDE Visual Platform: File and New Workspace ........................................................................ 10
Figure 10: UDE Visual Platform: Define File name .................................................................................. 10
Figure 11: UDE Visual Platform: Select “STM Pictus Evaluation Board with SPC560P50(SPC5
UDE/STK)” ................................................................................................................................................ 11
Figure 12: UDE Visual Platform: Load Program ....................................................................................... 11
Figure 13: UDE Visual Platform: Program All ........................................................................................... 12
Figure 14: UDE Visual Platform: Execute Memtool Command - loading ................................................. 12
Figure 15: UDE Visual Platform: Procedure completed ........................................................................... 13
DocID027235 Rev 1 3/15
Graphical User Interface description
1 Graphical User Interface description
UM1844
The L9958 GUI includes the fields highlighted in
Figure 1: ":STSW-L9958 Graphical User
Interface (GUI) for EVAL-L9958 "
:
Figure 1: :STSW-L9958 Graphical User Interface (GUI) for EVAL-L9958
4/15
1. Com Port Setup : the com port is selected where the microcontroller is connected too.
2. SDI: selecting the specific device register and setup all the bits to the required value
3. SDO: reading the SDO register of the device.
4. SPI Send/Receive: through this menu, by pushing the [SEND] button, it is possible to send the SPI command configured in the SDI menu (menu 2) or directly send an SPI command writing the command in the MOSI field in hexadecimal. In this menu there is the possibility to read also the device answer MISO. The two LEDs, SPI SEND OK and SPI RECEIVE OK are used to give feedback on the SPI communication (red means communication is running properly).
5. PWM: through this menu setup the Frequency and the Duty cycle of the PWM. By pushing the [START] button, the PWM starts, by pushing the [STOP] button the PWM is stopped. Before sending a PWM, the Frequency value must be confirmed by pushing the [SET] button.
6. ENABLE: through this menu set the level of the EN pin.
7. DIR: through this menu set the level of the DIR pin.
8. DISABLE: through this menu set the DI pin of the device.
9. HELP: through this menu download the help, the Datasheet and the HW Help.
DocID027235 Rev 1
UM1844
2
How to use the GUI to configure the device
How to use the GUI to configure the device
The following procedure must to be followed to configure the GUI and to set the EVAL-
L9958 evaluation board.
1. Configure the COM port.
2.
Press “OK”.
3. Insert the register configuration value of the SPI in the field #2.
4.
Press “SEND” in the field n°4. If the communication is established and the command is sent, the LED “SPI SEND OK” must be red. The LED “SPI RECEIVE OK” becomes red if the message sent by the device has been received properly.
5. In the field #3 is reported the device answer; in the field # 4 it is possible to read the
SDI and SDO signals expressed in hex.
6. Set the PWM frequency value in the field #5
7.
Press “SET” button.
8. Configure the PWM Duty Cycle
9.
Press “START” button.
10. Enable the Device (EN) by pressing the corresponding button in the field #6. If the communication has been established and the configuration command has been sent, the led “SEND ENABLE OK” will appear red. The LED D1 on the EVAL-L9958 will be turned ON.
11. Enable the Device (DI) by pressing the corresponding button in the field #8. If command has been rece ived and decoded properly, the LED “SEND DISABLE OK” will appear red and the LED D5 on the EVAL-L9958 will be turned OFF.
12.
Pressing the button “DIR (field #7), the direction of the DC motor is inverted and the
LED “SEND DIR OK” will appear red.
13.
Pressing “STOP PWM” field #5 the PWM will be stopped and consequently the motor will be stopped as well.
14.
Pressing the button “STOP” on the top side of the GUI the execution of Labview will be stopped.
DocID027235 Rev 1 5/15
SPC560P-DISP: USB drivers installation
3 SPC560P-DISP: USB drivers installation
UM1844
The GUI needs a dedicated USB driver to enable the serial communication channel. If the driver is not installed or not appropriately configured, the following procedure describes how to uninstall then install the latest driver.To install the drivers the board does not need the external supplier; the USB provides the supply voltage.
Once the installation is completed, connect the USB cable to the SPC560P-DISP board; the USB drivers are installed.
Right click on “InstallPlsUsbJtagDriver.bat ” then select “ Run as administrator ”
Figure 2: USB Driver Installation
– folder “JtagUsbDriver”
Once the installation is completed, connect the USB cable to the SPC560P-DISP board; the USB drivers are installed.
Figure 3: SPC560P-DISP: USB input
6/15
From “Start” Menu, right click on “ Computer” item then select “Manage”. From “Start”
Menu, right click on “ Computer” item then select “Manage”.
DocID027235 Rev 1
UM1844
SPC560P-DISP: USB drivers installation
Figure 4: Start menu, Computer, Manage
Once the Computer management popup appears, select Device Manager from the
System Tools menu
Figure 5: Disk Management
Expand the item Universal Serial Bus controlle rs : the item “ PLS USB JTAG Adapter for SPC5xxx A ” and “ PLS USB JTAG Adapter for SPC5xxx B ” will appear.
Figure 6: PLS USB JTAG Adapter- COM Ports
In order to enable the COM port, right click on “PLS USB JTAG Adapter for SPC5xxx
B ” (only this) then click “ Proprieties ”.
A new window will pop up: select the tab “Advanced ” then flag the “ LOAD VCP ”
(Virtual COM Port ) box. This item should be already flagged, do not modify it.
DocID027235 Rev 1 7/15
SPC560P-DISP: USB drivers installation
UM1844
Figure 7: PLS USB JTAG Adapter for SPC5xxx B - Advanced Tab, Enable VCP
Click OK button to continue.
Disconnect the USB cable from the SPC560P-DISP board then reconnect it. A new
COM port will be detected, and Windows will automatically install the new drivers.
From the Device Manager window check the new COM port available.
Figure 8: PLS Drivers and VCP
8/15
Now the COM port is available on the SPC560P-DISP and the USB port on the
SPC560P-DISP board can be used for serial communication with the PC.
DocID027235 Rev 1
UM1844
4
Labview driver: installation guide
Labview driver: installation guide
The L9958 GUI can be used stand alone without a Labview license installing the free SW named “Runtime Engine for Labview 2013” and “VISA Runtime 5.4”; here below the links:
Runtime Engine for Labview 2013:
http://www.ni.com/download/labview-run-time-engine-
2013/4059/en/
VISA Runtime 5.4:
http://www.ni.com/download/ni-visa-run-time-engine-5.4/4231/en/
DocID027235 Rev 1 9/15
SPC560P-DISP: Load Firmware
5 SPC560P-DISP: Load Firmware
UM1844
To use the L9
958 GUI a dedicated FW (file name: “GP-Pictus.elf”) must to be loaded on the microcontroller in the SPC560P-DISP board following below procedure (the board is supplied by the USB cable thus the external PSU is not required):
Start UDE Visual Platform. If the SPC5Studio is installed UDE Visual Platform is already available otherwise it can be downloaded from the link:
http://www.plsmc.com/spc5-udestk
Create a New Workspace for SPC560P-DISP. Click File>New WorkspaceX
Figure 9: UDE Visual Platform: File and New Workspace
Name the new Workspace i.e. Pictus then select OPEN
Figure 10: UDE Visual Platform: Define File name
10/15 DocID027235 Rev 1
UM1844
SPC560P-DISP: Load Firmware
Select “ STM Pictus Evaluation Board with SPC560P50(SPC5 UDE/STK)” then click
OK
Figure 11
: UDE Visual Platform: Select “STM Pictus Evaluation Board with SPC560P50(SPC5
UDE/STK)”
UDE Visual Platform 4.0 will be refreshed and new functionalities will appear, then click on the icon “Load Program” highlighted in the red circle; browse the file “GP-
Pictus.elf “then click “Open.
Figure 12: UDE Visual Platform: Load Program
Click on “Program All”.
DocID027235 Rev 1 11/15
SPC560P-DISP: Load Firmware
Figure 13: UDE Visual Platform: Program All
UM1844
Figure 14: UDE Visual Platform: Execute Memtool Command - loading
12/15 DocID027235 Rev 1
UM1844
SPC560P-DISP: Load Firmware
Figure 15: UDE Visual Platform: Procedure completed
When the procedure is completed click on “Exit”. The SPC560P-DISP is programmed and the SPC560P-DISP is ready to be used with the Graphical User Interface (GUI) dedicated to configure and control the board EVAL-L9958.
DocID027235 Rev 1 13/15
Revision history
6 Revision history
Date
02-Dec-2014
Table 1: Document revision history
Revision
1
Changes
Initial release.
UM1844
14/15 DocID027235 Rev 1
UM1844
IMPORTANT NOTICE
– PLEASE READ CAREFULLY
STMicroelectronics NV and it s 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 b efore 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. 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.
© 2014 STMicroelectronics
– All rights reserved
DocID027235 Rev 1 15/15
