PMBusGUI Manual
PMBusGUI Manual
DATE
SOFTWARE
DESCRIPTION
S/W REV.
REMARKS
01
06242008
00.01.00Bet
a
First Issue
02
02062009
00.08.00
Beta
03
02142009
00.09.00
04
11272009
Universal
PMBus
Users Manual
GUI
00.11.00
05
12292009
Universal
PMBus
Users Manual
GUI
00.12.00
06
06092010
GUI
00.16.00
07
09092010
GUI
00.17.00
08
10182010
Universal
PMBus
Users Manual
Universal
PMBus
Users Manual
Universal
PMBus
Users Manual
GUI
00.20.00
09
11082011
GUI
00.40.00
Updated Version
10
04172012
Universal
PMBus
Users Manual
Universal
PMBus
Users Manual
GUI
1.00.00
Release Version
11
03042013
GUI
1.01.05
Beta Version
12
10092013
Universal
PMBus
Users Manual
Universal
PMBus
Users Manual
GUI
1.01.18
Beta Version
TABLE OF CONTENTS
DOCUMENT REVISION HISTORY ................................................................................................................................2
TABLE OF CONTENTS ...................................................................................................................................................3
GENERAL INFORMATION..............................................................................................................................................5
SYSTEM REQUIREMENT:...........................................................................................................................................5
INSTALLATION .................................................................................................................................................................6
GETTING STARTED.......................................................................................................................................................10
GENERAL SETUP .......................................................................................................................................................10
PSU COMPATIBILITY.................................................................................................................................................10
HARDWARE SETUP...................................................................................................................................................10
LAUNCHING THE UNIVERSAL PMBUS GUI..........................................................................................................11
GUI DETAILS................................................................................................................................................................13
MAIN MENU ..............................................................................................................................................................13
MAIN PANELS ...........................................................................................................................................................13
GUI ADD ON FEATURES .........................................................................................................................................13
GUI FEATURES AND DETAILED DESCRIPTION....................................................................................................14
BASIC TAB....................................................................................................................................................................14
INPUT CONFIGURATION ........................................................................................................................................15
OUTPUT CONFIGURATION ....................................................................................................................................15
THERMAL CONFIGURATION..................................................................................................................................16
TEST PANEL ....................................................................................................................................................................17
FAVORITES PANEL ..........................................................................................................................................................18
OPERATIONS TAB ...........................................................................................................................................................19
MAIN STATUS..............................................................................................................................................................20
USING THE BASIC PANEL ........................................................................................................................................20
ADJUSTING POWER SUPPLY PARAMETERS ........................................................................................................20
CHANGING THE ADDRESS .....................................................................................................................................21
CHANGING USB ADAPTER .....................................................................................................................................22
SHOW ERROR LOG DISPLAY ..................................................................................................................................23
USING THE TEST PANEL..........................................................................................................................................24
ADDING A COMMAND ON THE SEQUENCE LIST VIEW .....................................................................................24
EDITING A COMMAND FROM THE SEQUENCE LIST VIEW ...............................................................................26
WRITING DATA TO THE DEVICE IN THE SEQUENCE LIST VIEW......................................................................28
SAVING THE COMMAND SEQUENCE....................................................................................................................31
LOG THE OUTPUT DATA TO TEXT FILE...............................................................................................................32
OUTPUT VIEW INFORMATION...............................................................................................................................34
CONFIGURATION FILE UPDATE (AUTHORIZED PERSONNEL ONLY)................................................................................35
Device Configuration..................................................................................................................................................36
PMBUS COMPLIANCE COMMAND MATRIX .........................................................................................................37
PMBUS Command EXPORT to Excel ........................................................................................................................38
Device Unit Actual Image...........................................................................................................................................39
Device Bootloader Configuration...............................................................................................................................40
ACCESSING FRU INFORMATION ................................................................................................................................41
ADVANCE PANEL SECTION (AUTHORIZED PERSONNEL ONLY) ......................................................................................43
Advance Tool Strip Icon .............................................................................................................................................46
Advance Category Selection Button............................................................................................................................49
Advance Command Editor Section .............................................................................................................................52
GENERAL INFORMATION
This GUI Software is designed to make PSU accessible to the user using PMBus protocol. It is intended to
provide information gathered from the PSU and interactive controls to the basic capabilities of Emerson Power
Supply Product which complies in PMBus Protocol. This Software must be installed to PC before the user
can make use all of the function of this program. This program can support AC-DC and DC-DC power
supplies series. Please refer to the system requirement before starting the installation.
SYSTEM REQUIREMENT:
Minimum Hardware Requirements:
Intel/AMD Dual Core Processor 1.6GHz
1GB RAM (add more RAM if more than 64MB is shared for the video)
ENP USB-to-I2C Adapter
Software Requirements:
Windows XP, Win VISTA (32Bit), Win7 (32Bit / 64Bit)
Dot Net Framework Version 3.5 installed to run the GUI.
INSTALLATION
Note:
Make sure that other applications are closed before starting the installation.
Installation Procedure
Run the installer CD, a pop up window for installation will come out. Select Install software to begin
installation.
1) Once Install Software was selected, a pop up window wizard will appear to guide you through
the installation process.
Figure below is the welcome window for software installation. Just click NEXT to begin
installation.
Note:
If you do not have the Dot Net Framework Version 3.5 installed, the installation process will
prompt you to first install Dot Net Framework Version 3.5. If not, click the Install .Net
Framework 3.5 in installer menu window. Once framework installed, proceed the installation of
the GUI by selecting the Install Software GUI in installer menu window.
2) This window serves as a confirmation window that installation for GUI is now ready.
Click Next to start installation.
3) GUI driver and reference file will be installed to your PC. Wait until installation completed.
4) Once installation completed successfully, a pop up wizard will appear that installation
completed. See figure below.
Now, you can already start using the Universal PMBus GUI.
GETTING STARTED
GENERAL SETUP
To provide proper communication between the Universal PMBus GUI software and power supply, both
PSU must be loaded with correct firmware version compatible with the GUI. The PSU must also
be calibrated to make use of all the function correctly and to get correct data from actual PSU.
PSU COMPATIBILITY
PSU Case with PMBus Protocol Compatibility
HARDWARE SETUP
1.Plug Standard USB adapter to your PC using compatible USB cable.
2.Wait until you PC detect it as new Hardware (It only happens when first time use in USB port).
3.If USB adapter is detected by your PC, plug the connecting cable from USB adapter to I2C port of the
PSU Case.
Note: Make sure that the Power Supply already power up to have proper communication with Universal PMBus GUI Software.
On the Start Menu Program or in your desktop, double-click the Universal PMBus GUI (red power) icon. A
window will appear as seen below shows that the GUI is currently detecting the connected device.
Note: Make sure that power supply and USB to I2C adapter are connected, this is to avoid pro long process
of detection then prompt the user above the invalid address.
GUI can automatically detect USB to I2C adapter and Device connected to it.
If your unit was not belong in the auto detection unit, press skip auto detection button to bypass the auto
detection process then select the Manual button for loading configuration file.
Manual loading are use for special cases only and password protected. This feature was added to support
model that dont have MFR_ID and MFR_MODEL value.
Once the GUI has automatically detected the device the window will appear as seen below:
As an example this window shows that the DS800SL-3 unit has been detected.
GUI DETAILS
GUI consists of different controls and indicators to support the power supply functionality. Most of the
common parameters of the power supply are being displayed in the GUI. Configuration and controls are also
made available to support actual interaction with the device. Universal PMBus GUI also has the capability to
configure, monitor and upgrade firmware of the power supply.
Here are the lists of GUI features available and functional on this version:
MAIN MENU
This is located at the upper rightmost part of the Universal PMBus GUI. It consists of the following
menu.
- Device menu for making, editing, importing and exporting device configuration.
- Options Menu Simulation Mode and Detect Device.
- Tools Menu- use to enable advance panel, error log and for firmware update.
- Help Menu was use to view Users Manual, GUI updates and detailed information.
MAIN PANELS
Basic Panel Tab it display basic parameter of the power supply such as voltage, current, power, flags
and temperatures.
Test Panel Tab this commonly use for debugging power supply debugging of PMBus Command. It is
also use for burn-in testing and data logging.
This view contains graphical gauges indicating input and output parameters of the power supply (e.g.
input and output voltage, current and power). It also shows the temperature reading and fan
speed depending on how many temp sensors and fans are installed in the PSU. There is also an LED
indicator emulation to provide easy indication of the PSU status.
INPUT CONFIGURATION
appears when the Input Config button is clicked on the Basic panel. Here you can set the input
limits of the power supply.
OUTPUT CONFIGURATION
- appears when the Output Config button is clicked on the Basic folder. Here you can set the output
control and limits and of the power supply.
THERMAL CONFIGURATION
appears when the Thermal Config button is clicked on the Basic folder. Here you can set the
thermal limits and fan configurations of the power supply.
Test Panel
In this section you can set commands and execute them once or continuously. This also allows you
to connect to multiple devices because the Address column is changeable per command on the Sequence
List view. You can also arrange the command sequence, save and load it for future use. The output data on
the Output view, acquired to the power supply device can also be exported to a text file. The Command
Guide shows corresponding PMBus command information by clicking a row on the Sequence List view.
A sequence list can be created by clicking the Add button. A list of supported commands by the PSU will
appear and can be selected to be added to the sequence list. Each command in the sequence list can be
edited according to your preference by highlighting the command and clicking Edit. Commands may be
removed from the list by using the Remove and Clear All button. The sequence list may be saved to a
sequence list file by using the Save button, which can be reused and reloaded by using the Load
button.
The sequence list can be executed either as a Single burst or Continuous execution by using the Single
or Continuous button. Continuous execution may be paused by using the Stop button.
The logged results can be cleared using the Clear button or can be saved in a text file using the Export
to File button. The text file is formatted in a way that it can also be easily exported to Microsoft Excel
format.
For more detail about Using Test Panel Section, proceed to Using Test Panel Chapter of this users
manual.
Favorites Panel
Info Tab displays the manufacturing information of the power supply device.
Note: Only supported command codes by the PSU will be displayed in this panel.
Operations Tab
This was design support power supply operations and PMBus Status flags. See detailed description
below.
OPERATION switch
use to turn on/off the
PSU output.
Page spinner
provides ability to
configure multiple
outputs PSU.
MAIN STATUS
For example to adjust the output voltage of the power supply device, click the Output Config
button. The Output Configuration dialog window will appear on the screen, as seen below, with the
current Output settings of the power supply device.
2) If the VOUT_COMMAND is supported by your device then the Output Voltage Control is enabled.
Change its value with your desired value, and click the Write button. The GUI will then write to the
power supply device and automatically returns the value written if it is a valid value for the device.
3) You may do the same steps for the other basic power supply parameters.
Standard Adapters are the USB adapter that uses HID driver.
USB to I2C adapter (73-769-001 / 73-769-003) are slow communication interface device.
Once Show Error Log Display was selected, Error Log tab will be added in Universal PMBus
Panel.
Filename it
display file
current directory.
3) Select the desired command/s in the Command Selection list and press the Add-> button. The
command/s you selected will appear on the Selected Commands list.
4) You can remove command/s from the Selected Commands list by clicking the Remove button or by
clicking the Remove All to remove them all.
5) To add it to the Sequence List view in the Test Panel, click the OK button.
2) The dialog will appear as seen below. Change the Address value, say from BE to B0. Then press the
OK button.
2)
Then change or type the Formatted/Text field value to 12.5 then click the ENTER button.
3) The command is now a write transaction and it will write 12.50 to the power supply device when a
Single or Continuous button is clicked.
Polling Delay
Field - use to
change the delay the
commands execution
in milliseconds.
B. CONTROLS FOR DISABLING, REMOVING AND ARRANGING THE COMMANDS ON THE TEST
PANEL
Clear All Button
Check Box -
use to enable
and disable
commands during
execution
without
removing from
the Sequence
List.
Remove Button
removes a
Up-Arrow Button
moves the selected
command one row up.
Down-Arrow
Button moves
the selected
command one row
down.
command from
the Sequence
List.
Duplicate Button
Create another
copy of selected
command.
Single
Button -
Continuous
Button - use
use to
execute
the
commands
on the
Sequence
List once.
to execute
the commands
on the
Sequence List
continuously.
Stop Button
- use to stop
Clear Button
- use to
the
continuous
execution.
clear the
date from the
Output view.
1) Click on the Log Data To File checkbox and a Save dialog will be appear on the screen.
2) Enter the desired filename and then click the Saved button.
Every time Test Panel read from the device it will automatically log data on the Output list and directly
to the file.
3) Press Stop Button then Go to the Location of file to open the Log file.
Note: Dont open file if Test Panel Data Logging is still ongoing. It will cause error. If you want to review data
you can directly see data in the Output Log display of the test Panel. You can only review the file once test
already completed.
Time Stamp
column
displays the
moment of
time a loop
was executed.
Loop column
displays the
number of
execution of a
sequence.
This section was designed for authorized personnel only. It is also password protected for security protection
to change any setting and update supported PSU and configuration file.
Device Configuration
This will show the list of supported Power Supply model. Display and supported command can be change and
update in this section.
Configuration File will be the reference of Universal PMBus GUI for data conversion, parameter to be
displayed, FRU and Firmware Update.
Supported command varies in every model so it is better to make sure that configuration files are updated
base on the latest PMBus Compliance matrix from Design Engineering.
PMBus Compliance Command matrix update in the GUI was made easy. To add or remove PMBus command
from supported command just enable or disable command in GUI. Select proper Transaction and Data format,
this is to make sure that actual value will be displayed correctly in the GUI.
FRU Information view also has the capability to store FRU data into file with *.EEP extension.
OPEN it will load *.EEP file which are stored in local drive.
SAVE save FRU information into file (*.EEP format).
Write it will write the *.EEP file being loaded into the power supply EEPROM.
Read extract FRU information from actual unit.
This section was designed for authorized personnel only and has the knowledge on firmware configurable
operation. It is also password protected for security protection to change any setting in the power supply that
may cause destroying the unit.
This new features of power supplies will help changing any parameter without changing the firmware. Only
selected power supply has this capability. For more information about this new feature, please contact our
technical support team.
Create New SCF Setting this is use to create new SCF command settings. New SCF command format will
be base on the enable command in the main database.
Once this button was click, Untitled.scf will be its initial file name.
Open SCF File if existing SCF file is available, the user can load it and use for writing setting into
the actual power supply.
Save SCF File / Save As SCF Use to save or save as the new and existing SCF Command file.
SCF File Name it indicate the name of the file being loaded or the name of newly created SCF file.
Write All SCF File It will write All SCF command in the file either selected or unselected.
Write Selected SCF Command Only It will write selected SCF command only.
Extract Command setting from PSU This icon was use to read all the SCF command setting from
the actual PSU. Extracted command will only base on SCF file command index or from the main SCF
command database if no SCF command file loaded.
Stop this icon was use to stop update and the extraction of scf command settings from power
supply.
Check All SCF commands It will check all SCF command from the file. This function will be useful
for selecting SCF command from existing file which only has a fewer checked command. Selecting this
function will check all the SCF commands then the user can unchecked few SCF commands that will not be
included in the update.
Un-check All SCF commands It will uncheck all SCF command from the file. This function will be
useful de-selecting SCF command from existing file which only has a lot of command checked.
Selecting this function will uncheck all the SCF command then the user can checked few commands that will
be included in the update.
SCF Device Setting This is use to open the window for Device setting panel. This panel was use to
set the device address and the PSU configuration status.
This device setting has the capability to change the configurable setting of the primary and secondary
controller. It can be done manually through this section.
Write All SCF Command from the file already has the capability to change the configuration setting of
the primary and secondary controller automatically.
View SCF Command Editor was use to view the advance command editor window. This section was
for firmware engineer who are knowledgeable on SCF command setting and configuration.
SCF Command Editor will be discussed in details in next section of this users manual.
View SCF Summary Report was use to view the update report between the loaded file and the actual
read configuration from the actual PSU.
See figure below for more details.
Command Summary report gives the information of the passed and failed command during update. It can also
useful as reference before updating the SCF command.
The user can just use the Extract Command from the PSU then go to this report afterwards. This report will
give the details between the file and the actual setting from the PSU. It will give the user heads up which SCF
command needed update.
SCF Command List - it display the current SCF Command selected or available in the database. Display
on this list was base on the category button selected. Default display will be all SCF command base on
selected customization.
- click this link label if you like to expand the size of SCF Command List. It will hide the
lower level section of the advance panel to optimize the space for SCF Command List. See Figure below.
- click this like to show the SCF Command Info and Editor Section.
Fan Temp Configuration this is use for configuring fan and temperature settings. As of the moment this
feature was still disable. It is still ongoing for finalization.
Command Editor was design for adding and configuring settings and limits of the SCF command.
This section will explain how to create new SCF command from empty setting and configuration or base on
the existing command. Code index, category, data format, setting and ranges are some of the details need to
be place on this section.
It has also the capability to use formula, defined by the admin or firmware engineer. This formula will be use
by the GUI as reference for computing raw data then load it to actual power supply.
This toolbar will be the key for creating and saving SCF command. Access for editing and entering data also
included in this section.
Name of the Main Database This is main database of the SCF command. Initial name of this database was
set to ADVcom.xdb. It can be found the current directory of the Universal PMBus GUI. This database will be
the default database name.
Create New SCF Database - This is use to create new database which contain one SCF command
only.
Load SCF Database This is use to load database from directory. If any SCF database available
as reference for SCF Command, it can also be loaded. This icon will also enable backward
compatibility for any old SCF commands.
Save Configured SCF - This is use to save the created SCF command into the active database
(e.g. ADVcom.xdb). If this icon was grayed, it means that the SCF command created already save into
the database.
Create New SCF Command - This is use to create an empty SCF command base on auto selected
code index search by the GUI. The user can still change the code index to its design location.
Enable Editing SCF Command - This is use for enabling command editor section. SCF editor entry
section was disabled as default setting. The user can only view existing command but dont have the
access to change the settings.
Remove Selected SCF Command - This is use to remove the selected SCF command from the
database. If the user wants to remove the SCF command permanently from the database, the user
should clicked save.
Duplicate Selected SCF Command it can be use to create a copy of the selected SCF command
from the database. It will be much easier for the user to create a new SCF command which almost the
same on the previous command rather than start from empty setting. Duplicate will create a copy of SCF
command with different code index.
SCF Versions This version will be use as reference for SCF Command update to the actual power supply. It
can only be edited in this section. SCF File on advance main panel should match on these versions before the
user can continue SCF Update into actual power supply.
Go back to previous SCF command This is use to move 1 step backward on SCF command.
Go to next SCF command This is use to move 1 step forward on SCF command.
Polling Delay This will be use as standard time delay interval between commands during SCF Update in
advance main panel.
Help this is use to open help file (Still on going for development).
Advance Editing buttons also available to be use for creating and editing SCF command. This is located
below the SCF command list. This buttons also have the same function in the toolbar section.
SCF Status Bar this will display which category is currently active and how many SCF command already
available. It also show if editing mode is locked or enabled.
Sort Category Button This button was use to view list of command base on category.
SCF Command Data Entry Section most of the SCF Command information should be entered in this
section. The user can select which code index to assign a new SCF command. These include the category,
group, data format of the SCF command, ranges, and the default value. Function name and Config variable
name also are part of information that should be entered.
It also has the capability to translate the formula of this command to convert the user data into raw data.
Code Index this SCF command location where SCF command data should be entered in actual PSU.
Unit and Ranges see SCF documentation for proper ranges and
units.
FORMULA
This formula was use to convert data from and to actual power supply.
Write Formula: This formula will be use to convert readable user setting to raw data format to be written on
the actual power supply.
Read Formula: This formula will be use to convert raw data from power supply into data readable to user.
Note: To enter a formula in this editor, the user should follow the correct syntax for the program to detect the
data being entered is a formula. Use f = as indicator as start of the formula and x will be the variable to
convert. Example: f = (x +32) / 5.
This formula support bracket, perform basic mathematical expression, calculate trigonometric and special
function on real, imaginary and complex number.
Here are the lists of supported mathematical calculation:
Addition: +
Subtraction: Multiplication: *
Division: /
Power: ^
Absolute Value: abs(x)
Cosine: cos(x)
Sinus: sin(x)
Tan: tan(x)
(Radians) Inverse Cosine: acos(x)
(Radians) Inverse Sinus: asin(x)
(Radians) Inverse Tan: atan(x)
(Radians) Hyperbolic Cosine: cosh(x)
(Radians) Hyperbolic Sinus: sinh(x)
(Radians) Hyperbolic Tan: tanh(x)
Logarithm to e: log(x)
Logarithm to 10: log10(x)
Degrees to Radians function: rad(x)
Radians to Degrees function: deg(x)
Constant Pi: pi
Constant E: ee
Real: re(x)
Imaginary: im(x)
Modulus: mod(x)
Conjugate: conj(x)
Once all data are entered correctly, dont forget to press "ENTER" button then save.
Authorized personnel only can access this feature. It is also password protected.
This GUI feature will enable user to update the firmware of power supply anywhere.
For more information if your power supply is supported with this feature, please contact our technical support
team.
Definitions:
Status This icon was use to display the Status Window.
Process File This icon was use to display the File Processing window. This is use to convert
SRecord file to Hex File and SRecord File to Checksum Updated SRecord File. This Icon is accessible
only for Bootloader Administrator.
Manual Set This icon was use to display the Bootloader Manual Setting window. This Icon is
accessible only for Bootloader Administrator.
Memory Map This icon was use to show the Memory Allocation panel for SRecord and Hex File
data.
Readouts This icon was use to show the Actual Data from PSU. This Icon is accessible only for
Bootloader Administrator.
Configuration This icon was use to display the Bootloader Configuration and Settings. Only the
Bootloader Administrator has the rights to change these settings.
Update Firmware This icon was use to show or focus the main window of Firmware Update Panel.
Click this
button to
read PSU
Model
Code
Click this
button to
read PSU
Model
Code
This section was design for detecting PSU status before and during firmware
upgrade. It is also capable to read the model code and firmware version of the power supply.
READ STATUS This will read the current status, error and faults of the power supply.
It will also indicate the current mode of the PSU (PMOS Mode or ISP Mode)
This window was use by firmware engineers to convert actual SRecord files into Hex File or
Checksum Updated SRecord File. This function will be enabled for Bootloader Administrator login
only.
Import SRecord File this is use to load a reference file to be process and convert into hex or
SRecord checksum updated file.
Export File this is use to initiate file conversion, either to SRecord or Hex file or choose both format.
Configuration Window:
This window was use to update settings of Bootloader configuration. Firmware engineers and GUI
administrator are the only allowed personnel to change this configuration.
This function will be enabled for Bootloader Administrator login only.
2. Firmware Update Window will appear with the default Bootloader window inside.
4. Once file is loaded, Memory map will and open the open loader file.
Once update completed, End time will be indicated including the old and new firmware
version of the power supply.
Checking of Model code and Firmware version are needed to be done manually using ISP Status window.
See procedure below on how to upgrade power supply firmware using manual Bootloading.
9. Go to ISP Status and click buttons to read Model Code and Firmware Version.
10. Click Read Status Button to verify the current status of the Bootloader.
11. Go to Bootloader Manual Setting window to start firmware upgrade.
st
13. Once Bootloader already loaded, click Enter Boot ISP Key (1), then click Enter
BOOT ISP (2) and wait until PMOS Mode to change into ISP Mode. If Bootloader
status already in the ISP Mode. Reset Address then press Write Until End
button.
1
2
17. Go to status window then check FW Version if already updated. Once Confirmed
that version already update then firmware upgrade already successful.
Cause 1: USB to I2C adapter not connected to USB port of the computer.
Solution 1: Make sure that it is already connected before launching the Universal PMBus GUI.
Cause 2: USB to I2C adapter set in the GUI did not match the actual adapter connect to computer.
Solution 2: Go to device menu then Select the correct USB Adapter.
Cause 1: This error occurred when wrong address was set or adapter connection to power supply
unit was disconnected.
Solution 1: Make sure that device address was correctly set and make sure that the I2C adapter was
connected the power supply to avoid this error.
Cause 1: This error occurred when USB-to-I2C adapter was disconnected while Universal PMBus
GUI is currently active.
Solution 1: Make sure to connect the USB-to-I2C adapter to avoid this error.
Cause 1: Opening data log file while Continuous reading in Test Panel currently active.
Solution 1: Accessing file is prohibited while data logging is still ongoing.