Tektronix products are covered by U.S. and foreign patents, issued and pending. Information in this
publication supersedes that in all previously published material. Specifications and price change privileges
reserved.
TEKTRONIX and TEK are registered trademarks of Tektronix, Inc.
TekExpress is a registered trademark of Tektronix, Inc.
Contactin
Tektronix, Inc.
14150 SW Karl Braun Drive
P.O . B o x 5 0 0
Beaverton, OR 97077
USA
For product information, sales, service, and technical support:
g Tektronix
In North America, call 1-800-833-9200.
Worldwide, visit www.tektronix.com to find contacts in your area.
Table of Contents
Getting help and support
Related documentation.............................................................................................1
Conventions used in help ..........................................................................................1
Technical support ...................................................................................................2
Getting started
Installing the software
Minimum system requirements . ................................ ................................ .............3
Windows 7 user account settings.......... .................................. ................................ .3
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Softwareiii
Table of Contents
ivTekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Getting help and supportRelated documentation
Related documentation
The following manuals are available as part of the TekExpress USBPWR Compliance and Debug Solution
documentation set.
Table 1: Product documentation
ItemPurposeLocation
Online Help
PDF of the Online HelpPrintable version of the compiled
In-depth op
Online help
eration and UI help
+
xxx
See also
Technic
al support
(see page 2)
Conventions used in help
Online Help uses the following conventions:
The term “DUT” is an abbreviation for Device Under Test.
The term “select” is a generic term that applies to the two methods of choosing an option: using
a mouse or using the touch screen.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software1
Getting help and supportTechnical support
Technical support
Tektronix values your feedback on our products. To help us serve you better, please send us your
suggestions, ideas, or comments on your application or oscilloscope. Contact Tektronix through mail,
telephone, o
When you contact Tektronix Technical Support, please include the following information (be as specificas
possible):
r the Web site. See Contacting Tektronix
General information
All instrument model numbers
for more information.
Hardware
Probes used
Yo ur name, company, mailing address, phone number, FAX number
Please indicate if you would like to be contacted by Tektronix about your suggestion or comments.
options, if any
Application specific information
Software version number
Description of the problem such that technical support can duplicate the problem
If possible, save the setup files for all the instruments used and the application
If possible, save the TekExpress setup files, log.xml, *.TekX (session files and folders), and status
messages text file
If possible, save the waveform on which you are performing the measurement as a .wfm file
2TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Getting startedMinimum system requirements
Minimum system requirements
The following table shows the minimum system requirements needed for an oscilloscope to run
TekExpress USBPWR.
Table 2: Syst
OscilloscopeSee Supported oscilloscopes (see page 4)
Processor
Operating SystemSame as the oscilloscope:
Memory
Hard Disk
Display
Firmware
SoftwareMicrosoft .NET 4.0 Framework
mmended Accessories
Reco
xxx
1
TekExpress is running on an instrument having a video resolution lower than 800x600 (for example, a sampling oscilloscope), it is recommended
If
that you connect a secondary monitor, which must be enabled before launching the application.
em requirements
Same as the oscilloscope
Windows 7 (64-bit only) Windows 7 user account
settings (see page 3)
Same as the oscilloscope
Same as the oscilloscope
Same as the oscilloscope
TekScope 6.4.5 and later (Windows 7)
Microsoft Internet Explorer 7.0 SP1 or later
Microsoft Photo Editor 3.0 or equivalent software for
ng image files
viewi
e Reader 7.0 or equivalent software for viewing
Adob
portable document format (PDF) files
One set of TPP0500, TPP1000, P6139B, or P5100A
probe with standard a ccessories are recommended
Additionally, one set of TCA to BNC converter and
-1MEG TekConnect 1 MΩ adapter is recommended
TCA
when using a P6139B or P5100A probe with a
DPO/DSA/MSO70000C/GSA Series Oscilloscope
ease refer to www.tek.com/probes
Pl
on recommended probes and probe adapters.
1
for further information
indows 7 user account settings
W
indows 7 instruments need to have the User Account Control Settings set to Never Notify. To set
W
User Account Control Settings:
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software3
Getting startedSupported oscilloscopes
1. Go to Control Panel > User Accounts > Change User Account Control settings.
2. Set it to Never Notify as shown in the image.
See also
Supported oscilloscopes (see page 4)
Supported oscilloscopes
The TekExpress USBPWR application (Option USBPWR) is compatible with the following Tektronix
oscilloscopes:
MSO/DPO5000/GSA Series (350 MHz and above)
DPO7000C/GSA Series
DPO/DSA/MSO70000C/GSA Series
NOTE. DPO/DSA/MSO70000D Series oscilloscopes are not supported for Option USBPWR.
See also
Minimum system requirements (see page 3)
4TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Getting startedInstall the software
Install the software
Use the following steps to install the USBPWR application on any compatible instrument running
Microsoft Windows 7 (64-bit). See Minimum System Requirements
1. Close all applications (including the TekScope application).
2. Go to the www.tek.com Web site and search for TekExpress USB PWR to locate the installation file.
Download the file
3. Copy or download the USBPWR installer to the oscilloscope.
4. Double-click the installer .exe file to extract the installation files and launch the InstallShield Wizard.
Follow the on-screen instructions.
5. The software installs in the following location:
aller updates the TekScope Analyze menu to include the installed options.
See also
Minimum system requirements (see page 3)
Supported oscilloscopes (see page 4)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software5
Getting startedActivate the license
Activate the license
Activate the license using the Option Installation wizard on the oscilloscope. Instructions for using the
Options Installation window to activate licenses for installed applications is provided in the oscilloscope
online Help:
1. From the oscilloscope menu bar, click Utilities > Option Installation.
The TekScope Option Installation wizard opens.
2. Push the F1 key on the oscilloscope keyboard to open the Option Installation help topic. Follow the
directions in the topic to activate the license.
See also
View version and license information (see page 7)
6TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Getting startedView software version and license information
View software version and license information
Use the following instructions to view version information for the application and for the application
modules such as the Programmatic Interface and the Programmatic Interface Client.
To view version information for USBPWR:
1. In the USBPWR application, click the Options button and select About TekExpress.
2. Click the View Version Details link to view the version numbers of the installed test suites.
To view
1. From the TekScope menu, select Help > About TekScope.
2. Scroll through the Options section list to locate USBPWR.
3. To view the Option key, look below the Options list.
license and option key information:
See also
Activate the license (see page 6)
Options menu (see page 13)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software7
Getting startedUSBPWR features and benefits
USBPWR features and benefits
Welcome to the TekExpress® USB Power Adapter / EPS Compliance Automated Test Solution Software
(referred to as TekExpress USBPWR or USBPWR in the rest of the document). USBPWR provides
an automated, simple, and efficient way to test USB power interfaces and devices consistent to the
requirements of the USB2.0 Battery Charger Specification v1.1 and IEC 62684.
USBPWR is based on TekExpress v ersion 2, the Tektronix Test Automation Framework, developed to
support your current and future test automation needs. TekExpress uses a highly modular architecture
that lets y
Key features and benefits of USBPWR include:
ou deploy automated test solutions for various standards.
Automates compliance measurements for USB2.0 Battery Charger S peci fi cation v1.1 and IEC 62684:
AC Voltage Frequency Component measurement
AC CommonMode Voltage measurement
Ripple Voltage measurement
Maximu
Reduces the time required to conduct testing
Minimizes user intervention when conducting time-consuming testing
Provides individual or group test selection by using a tree-structure menu
Built-in reporting features:
Provides a Pass/Fail summary table
Pro
Provides a consolidated report for all tests
Complete programmatic interface enables automation scripts to call USBPWR functions
m Slew measurement
vides margin details on each test
Application directories and their contents
TekExpress USBPWR application
The TekExpress USBPWR application files are installed at the following location:
8TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Getting startedApplication directories and their contents
Contains the technical documentation for the USBPWR
application
Examples
Contains various support files
ICPContains instrument and USBPWR application-specific
interface libraries
Lib
Contains utility files specific to the USBPWR application
Report GeneratorContains style sheets for report generation
Tools
xxx
Contains instrument and USBPWR application-specific files
See also
View test-related files (see page 32)
File name extensions (see page 10)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software9
Getting startedFile name extensions
File name extensions
The USBPWR application uses the following file name extensions:
File name extensionDescription
.TekX
.py
.xml
.wfmThe test wa
.mht
xxx
See also
The application session files (the extensions may not be
displayed).
The test sequence file
The test-specificconfiguration information (encrypted) file
The applic
The test r
savedinHTMLformat
ation log file
veform file
esult reports (default). Test reports can also be
(see page 33).
Select r
eport options
(see page 33)
View test-related files (see page 32)
Application directories and their contents (see page 8)
Before you click start (see page 45)
10TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsRun the application
Run the application
To run the USBPWR application, do either of the following:
Select Analyze > TekExpress USB PWR from the TekScope menu.
Double-click any saved USB PWR session file (<file name>.TekX).
When you first run the application after installation, the application checks for a file called
Resources.xml located in the C:\Users\<username>\My Documents folder. The Resources.xml
file gets mapped to the
X:\USB PWR folder. The Resources.xml file contains information about available network-connected
instruments. If this file is not found, the application runs an instrument discovery program, before
launchin
g USBPWR, to locate available instruments.
X: drive when the application launches. Session files are then stored inside the
To keep the application window on top, select Keep On Top from the USBPWR Options menu
page 13).I
PWR to move the application to be in front.
f the application goes behind the oscilloscope application, click Analyze > TekExpress USB
See also
Activate the license (see page 6)
Exit the application
Use the following method to exit the application:
NOTE. Using other methods to exit the application results in abnormal termination of the application.
1. Clickon the application title bar.
2. Do one of the following:
If you have an unsaved session or test setup, you are asked to save it before exiting. To save it,
click Yes. Otherwise click No. The application closes.
(see
A message box appears asking if you really want to exit TekExpress. To exit, click Yes.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software11
Operating basicsApplication controls
Application controls
Table 4: Application controls descriptions
ItemDescription
Options menu (see page 13)
Panels (see page 18)Visual frames with sets of related options.
Command buttonsButtons that initiate an immediate action. Examples of
Start button
Stop button
Menu to display global application controls
command buttons are the Start, Stop, Pause, Continue,
and Clear buttons.
Use the Start button to start the execution of the
measurem
measurements have not been cleared, the new
measurements are added to the existing set.
ents in the selected order. If prior acquired
Pause \ Continue button
Use the Stop button to abort the test.
Use the Pause button to temporarily interrupt the current
acquisition. When a test is paused, the button name
s to “Continue.”
change
12TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Use the Clear button to clear all existing measurement
results. Adding or deleting a measurement, or changing a
on parameter of an existing measurement, also
This button is available only on the Results panel
Applicati
configurati
clears measurements. This is to prevent the accumulation
of measurement statistics or sets of statistics that are not
coherent.
(see page 30).
on window move icon
xxx
Options menu overview
The Options menu is located in the upper right corner of the application.
The Op
MenuFunct
Defau
Open
Save
Sav
Ope
Instrument Control Settings (see page 14)Shows the list of instruments connected to the test setup
K
Email Settings (see page 15)Usetoconfigure email options for test run and results
tions menu
lt Test Setup
Test Setup
Test Setup
e Test Setup As
n Recent
eep On Top
(see page 14) has the following selections:
Place the
corner of the application window. When the cursor changes
to a hand, drag the window to the desired location.
Opens
Open
Save
Cre
Dis
from
and allows you to locate and refresh connections to those
in
eeps the TekExpress USBPWR application on top of other
K
open windows on the desktop
notifications
cursor over the three-dot pattern in the upper left
ion
an untitled test setup with defaults selected
s a saved test setup
s the current test setup selections
ates a new test setup based on an existing one
plays a menu of recently opened test setups to select
struments
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software13
Operating basicsInstrument control settings
MenuFunction
Help
About TekExpress
Displays the TekExpress USBPWR Online help
Displays application details such as software name,
version numbe
r, and copyright
xxx
Options menu
See also
Provides acc
your USBPWR installation
Provides a l ink to the Tektronix Web site
ess to license i nformation
(see page 7) for
Application controls (see page 12)
Instrument control settings
Use the TekExpress Instrument Control Settings dialog box to search for and list the connected resources
(instruments) found on specified connections (LAN, GPIB, USB, and so on) and each instruments
connection information. You access this dialog box from the Options menu.
Access this dialog box from the Options menu.
14TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsEmail settings
Use the In
instrument connection details. Connected instruments displayed here can be selected for use under Global
Settings in the test configuration section.
strument Control Settings feature to search for connected instruments
See also
Options menu overview (see page 13)
Email settings
Use the Email Settings utility to configure email notifications (see page 16) to receive notifications when a
test completes, produces an error, or fails. Select the type of test session information to include in the
notification, such as test reports and test logs, the email message format, and the email message size limit.
Access this dialog box from the Options menu.
NOTE. Recipient email address, sender’s address, and SMTP Server are mandatory fields.
(see page 41) and view
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software15
Operating basicsConfigure email settings
See also
Configure email settings (see page 16)
Options menu (see page 13)
Select test notification preferences (see page 25)
Configure email settings
To be notified by email when a test completes, fails, or produces an error, configure the email settings.
1. Options > Email Settings to open the Email Settings
2. (Required) For Recipient email Address(es), enter one or more email addresses to which to send the
test notification. To include multiple addresses, separate the addresses with commas.
3. (Required) For Sender’s Address, enter the email address used by the instrument. This address consists
of the instrument name followed by an underscore followed by the instrument serial number, then the
@ symbol and the email server used. For example: DPO72016C_B130099@yourcompany.com.
4. (Required) In the Server Configuration section, type the SMTP Server address of the Mail server
configured at the client location, and the SMTP Port number, in the corresponding fields.
If this server requires password authentication, enter a valid login name, password, and host name
in the corresponding fields.
(see page 17) dialog box.
NOTE. If any of the above required fields are left blank, the settings will not be saved and email
notifications will not be sent.
16TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsConfigure email settings
5. In the Email Attachments section, select from the following options:
Reports: Select to receive the test report with the notification email.
Status Log: Select to receive the test status log with the notification email. If you select this
option, then also select whether you want to receive the full log or just the last 20 lines.
6. In the Email Configuration section:
Select the message file format to send: HTML (the default) or plain text.
Enter a maxi
limit will not be sent. The default is 5 MB.
Enter the n
system makes to send a notification. The default is 1. You can also specify a timeout period.
7. Select th
enable or disable email notifications.
8. To test y
9. To apply your settings, click Apply.
10. Click Close when finished.
Email
e Email Test Results When complete or on error check box. Use this check box to quickly
our email settings, click Te st Email .
settings
mum file size for the email message. Messages with attachments larger than this
umber in the Number of Attempts to Send field, to limit the number of attempts that the
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software17
Operating basicsApplication panel overview
Application panel overview
Panels group related configuration, test, and results settings.
The TekExpress USBPWR panels are:
Table 5: Application panels
Panel NamePurpose
Setup (see page 18)The Setup panel shows the test setup controls. Click the
Setup button to open this panel.
Use this panel to:
Select DUTparameters (see page 19).
Select the test(s) (see page 20).
Set acquisitions parameters (see page 21) for selected
tests.
Configuration test parameters (see page 27)
Status (see page 29)View the progress and analysis status of the selected tests,
Results (see page 30)View a summary of test results and select result viewing
Reports (see page 33)Browse for reports, save reports as specific file types,
xxx
See also
Application controls (see page 12)
about setting up tests (see page 39)
Setup panel overview
The Setup panel (see page 19) contains sequentially ordered tabs that help guide you through a typical
test setup process. Use the tabs on this panel to:
Set the DUT parameters
Select test notification preferences (see page 25).
and view test logs.
preferences.
specify report naming conventions, select report content to
include (such as summary information, detailed information,
user comments, setup configuration, application
configuration), and select report viewing options.
(see page 19)
Select test(s) (see page 20)
Select acquisition parameters (see page 21)
Set configuration parameters (see page 27)
18TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsSet DUT parameters
Select test notification preferences (see page 25)
Set DUT parameters
Use the Setup panel (see page 19) DUT tab to select p arameters for the device under test. The settings
are global and apply to all tests for the current session. DUT settings also affect the list of available
tests in the Test Selection tab.
Click Setup > DUT to access the DUT parameters:
Table 6: DUT tab settings
SettingDescription
DUT ID
Comments icon (to the right of the DUT ID field)
Acquire live waveformsAcquire active signals from the DUT for testing.
Use prerecorded waveform filesRun tests on a saved waveform. Open (load) a saved test
Version
Adds an optional text label for
default value is DUT001.
Opens a Comments dialog box in which to enter optional
text to add to a report. Maximum size is 256 characters. To
enable or disable comments a
see Select report options
setup (see page 50)
Sets the DUT generation version.
the DUT to reports. The
ppearing on the test report,
(see page 33).)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software19
Operating basicsSelect tests
Table 6: DUT tab settings (cont.)
SettingDescription
SpecificationUSBPWR currently supports USB2.0 Battery Charger
Specification v1.1 and IEC 62684.
View
SuiteSets the DUT device type (Permanent cable or Detachable
xxx
Sets the overall testing mode. Select Compliance or
Advanced:
Compliance: Preselects tests and parameters to m eet
compliance specifications for the selected version,
specification, and device type.
View configuration settings by clicking Setup > Test
Selection > Configure.
Advanced: Enables the user to select specifictestsand
set custom parameters for tests.
This also enables the Configuration tab on the
Setup panel to quickly access test parameters.
type)
See also
About setting up tests (see page 39)
Select a test (see page 20)
Select tests
Use the Test Selection tab to select the tests to run on the connected DUT.
1. Click Setup > Test Selection.
2. Select the test(s) to run:
Cl
tests in that group. Click check boxes adjacent to individual tests to select those tests.
C
Click Select All to select all tests.
Click Schematic to view a diagram that shows the correct DUT and equipment setup for the
selected test. Use to verify your test equipment setup before running the test.
Click Configure to open the configuration settings for a selected test.
ick + to expand a group of commands. Click the check box adjacent to a test group to select all
lick Deselect All to deselect all tests. All tests are selected by default.
20TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsSet acquisition parameters
NOTE. The Configure button is not displayed if the View (in the DUT tab) is set to Advanced.
Click Schematic to display a schematic diagram that shows the DUT test setup. Use the diagram
to verify the test setup before running the test.
See also
Set acquisition parameters (see page 21)
About setting up tests (see page 39)
Set acquisition parameters
Use the Acquisition tab in the Setup panel to view and select test acquisition parameters, such as the
signal source channel and waveform save options.
Click on Channel Selection to select the channel to which the DUT has been connected. (Channel
Selection is only available when acquiring live waveforms.)
Click the Acquisition and Save Options (see page 23) controls to set how the application acquires
and analyzes signals (Save all waveforms before analysis, Analyze immediately without saving
waveforms, or Save and Analyze acquisitions in sequence).
Click on Show Acquire Parameters to display the acquisition parameters for each acquisition.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software21
Operating basicsSet acquisition parameters
Active waveforms
Acquisitions tab: using active waveforms
Prerecorded waveforms
Acquisitions tab: using prerecorded waveforms
22TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsSet acquisition and save options
When using prerecorded waveform files, this panel lists available prerecorded waveform files. You can
only select the source of the prerecorded waveform file for each test. See Set acquisition waveform
source for pre
recorded waveform files
(see page 24).
Set acquisition and save options
Select an Acquisition and Save Options to set the order in which waveforms are acquired and analyzed:
Save all waveforms before analysis: Acquire & save all waveforms required by tests before
performing analysis. All required user interventions (such as connecting the setup in different setups)
are comple
after the acquisitions are completed.
ted, and waveforms acquired & saved, before the analysis is run. You can turn off the DUT
Analyze i
of acquisition, analysis is done just after acquisition. Waveforms are discarded when the analysis is
complete.
Save and analyze acquisitions in sequence: Acquire and save waveforms and analyze for each
test before proceeding to the next test. Use this setting to stop the testing when an error occurs,
investigate and correct DUT, instrument connections, or change application settings. Restart testing
after any changes.
mmediately - No waveforms saved: Waveforms are acquired but not saved. For each type
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software23
Operating basicsSet acquisition waveform source for prerecorded waveform files
Set acquisition waveform source for prerecorded waveform files
Select a Save Option to set how to save acquired test waveforms.
When using prerecorded waveform files, there are no acquisition source selections to make. You can only
select the source of the prerecorded waveform files for each test.
If you selected to use a p rerecorded waveform file (in the DUT tab), the Acquisition tab shows a table of
the waveforms used for the required test acquisitions.
Yo u can load a different waveform file for each table item. To load a different waveform file:
1. Click the ellipsis button (
2. Select the waveform task to perform (replace, remove, or select the waveform file).
3. Use the dialog box to navigate to and select the waveform file with which to replace the current file.
) of the waveform file to change.
See also
Set acquisition options (see page 23)
24TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsSet test notification preferences
Settestnotification preferences
Use the Preferences tab to set the application action when a test measurement fails:
1. Click Setup > Preferences.
2. Select On Test Failure, stop and notify me of the failure to stop the test and send an email when
a test fails. Click Email Settings to verify that Email Test Results when complete or on error is
selected, and verify the email address.
See also
About setting up tests (see page 39)
Select re
port options
(see page 33)
About configuring test parameters
Use the configuration settings to view the measurement parameters for selected tests. How the test
configurations are accessed depend on the View selected in the DUT tab.
If you set the view to Compliance in the DUT tab, then in the Test Selection tab, select the desired
test in the list and then click the Configure button.
Use the Test Selection button to return to the Test selection display.
If you set the view to Advanced in the DUT tab, click the Configuration tabintheSetuppanel.
NOTE. You cannot change test parameters that are grayed out.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software25
Operating basicsAbout configuring test parameters
See also
Configuration tab parameters (see page 27)
About setting up tests (see page 39)
26TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsConfiguration tab parameters
About running tests (see page 45)
Configuration tab parameters
The following table lists the Configuration tab settings and parameters.
Table 7: Com
Parameter TypeParameter and Default Value
Compliance/User Defined Mode
Limits Editor
mon parameters and values
Determines
can be edited (User Defined Mode).
edited.
Shows the upper and lower limits for the applicable
measure
In Compliance Mode, use the Limits Editor to view the
measurement high and low limits used for selected tests.
In User D
settings.
whether test parameters are in compliance or
Compliance: Most test parameter values cannot be
User Defined: Enables editing of most test parameters.
ment using different types of comparisons.
efined Mode, use the Limits Editor to edit the limit
it a value, click that field and either select from the
To e d
displayed list or enter a new value. Use the bottom scroll
bar to view all available fields.
Instruments Detected
Displays a list of the connected instruments found during the
trument discovery. Instrument types include equipment
ins
such as oscilloscopes and signal generators. Select
Instrument Control Settings to refresh the connected
strument list
in
(see page 14).
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software27
Operating basicsConfiguration tab parameters
Table 7: Common parameters and values (cont.)
Parameter TypeParameter and Default Value
Test Parameters (for Ripple voltage)To select the parameter values for AC Frequency, AC
Voltage, Load & Temperature for Ripple test needs.
Record Length, Sample RateThese settings apply to all tests selected for the indicated
data rate.
Record Length: Specifies the waveform record length.
Sample Rate: Specifies the oscilloscope sample rate to
use for all tests.
xxx
See also
About acquisitions (see page 21)
28TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsStatus panel overview
Status panel overview
The Status panel provides status on test acquisition and analysis (Te st Sta tus (see page 29) tab) and a
listing of test tasks performed (Log View
when you star
tests are running.
t a test run. You can select the Test Status or the Log View tab to view these items while
Test status view
(see page 30) tab). The application opens the Test Status tab
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software29
Operating basicsResults panel overview
Log view
The Log View display has several viewing options:
Message History: This window timestamps and displays all run messages.
Show Detailed Log: Select this check box to record a detailed history of test execution. This must
be checked before starting a measurement.
Auto Scroll: Select this check box to have the program automatically scroll down as information
is added to the log during the test.
Clear Log: Click this button to clear all messages from the display.
Save: Click this button to save the log file as a text file. A standard Save File window is displayed
to name and save the file.
See also
Application panel overview (see page 18)
Results panel overview
When a test finishes, the application switches to the Results panel (see page 31) to display a summary
of signal and preset test results. The Overall Test Result is displayed at the top left of the Results table.
If all of the tests for the session pass, the overall test result is Pass. If one or more tests fail, the overall
test result is Fail.
30TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsResults panel overview
Set viewing preferences for this panel from the Preferences menu in the upper right corner. Viewing
preferences include showing whether a test passed or failed, summary results or detailed results, and
enabling word
wrap.
Results panel
When a test finishes, the application switches to the Results panel (see page 30), which displays a
summary of test results.
NOTE. NAN (Not A Number) is displayed in the test results if an invalid waveform was supplied for the test.
Each test result occupies a row in the Results table. By default, results are displayed in summary format
with the measurement details collapsed and with the Pass/Fail column visible. Change the view in the
lowing ways:
fol
To expand all tests listed, select View Results Details from the Preferences menu in the upper right
rner.
co
To expand and collapse tests, click the plus and minus buttons.
To collapse all expanded tests, select Preferences > View Results Summary.
To remove or restore the Pass/Fail column, select Preferences > Show Pass/Fail.
To enable or disable the wordwrap feature, select Preferences > Enable Wordwrap.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software31
Operating basicsView test-related files
To expand the width of a column, place the cursor over the vertical line that separates the column
from the column to the right. When the cursor changes to a double-ended arrow, hold down the mouse
button and dra
To clear all test results displayed, click Clear.
g the column to the desired width.
See also
View a report (see page 35)
About panels (see page 18)
View test-related files
Files related to tests are stored in the My TekExpress\USB PWR folder. Each test setup in this folder has
a test setup file and a test setup folder, both with the test setup name.
The test setup file is preceded by the TekExpress icon and usually has no visible file name extension.
Inside the test setup folder is another folder named for the DUT ID used in the test sessions. The default
is DUT001.
Inside the DUT001 folder are the session folders and files. Each session also has a folder and file pair, both
named for the test session using the naming convention (date)_(time). Each session file is stored outside
its matching session folder:
Each session folder contains image files of any plots generated from running the test session. If you
selected to save all waveforms or ran tests using prerecorded waveform files, these are included here.
The first time you run a new, unsaved session, the session files are stored in the
folder located at ..\My TekExpress\USB PWR. When you name and save the session, the files are
placed in a folder with the name that you specify. A copy of the test files stay in the Untitled S ession folder
until you run a new test or until you close the USBPWR application.
Untitled Session
See also
File name extensions (see page 10)
Before you click start (see page 45)
32TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsReports panel overview
Reports panel overview
Use the Reports panel (see page 33) to browse for reports, name and save reports, select re port content to
include, and select report viewing options.
For information on setting up reports, see Select report options
reports, see View a Report
(see page 35).
Reports panel
(see page 33). For information on viewing
See also
About panels (see page 18)
Select report options
Use the Reports panel (see page 33) to select which test information to include in the report, and the naming
conventions to use for the report. For example, a lways give the report a unique name or select to have the
same name increment each time you run a particular test. Generally, you would select report options before
running a test or when creating and saving test setups. Report settings are included in saved test setups.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software33
Operating basicsSelect report options
In the Reports panel, select from the following report options:
Table 8: Report options
SettingDescription
Generate new reportCreates a new report.
Replace current test values with the new resultsReplaces the previous test results with the latest test
results. Newly added tests results are appended to the end
of the report.
Append to previous report
Report Path
Appends the latest test results to the end of the current test
results report.
Displays the name and location from which to open a
report. The default l ocation is at \My TekExpress\USBPWR\Untitled Session. The report file in this folder gets
overwritten each time you run a test unless you specify a
unique name or select to auto increment the report name.
Change the report name or location.
Do one of the following:
In the Report Path field, type over the current
folder path and name.
Double-click in the Report Path field
and then make selections from the popup
ard and click the Enter button.
keybo
Be sure to include the entire folder path, the file name,
and the file extension. For example: C:\Documents
ttings\your user name\My Documents\My
and Se
TekExpress\USB PWR\DUT001_Test_72.7.1.3.mht.
NOTE. You cannot set the file location using the Browse
on.
butt
Open an existing report.
Click Browse, locate and select the report file and then click
View at the bottom of the panel.
Save As TypeSaves a report in the specified file type. Lists s upported file
pes to choose from.
ty
NOTE. If you select a file type different from the default,
be sure to change the report file name extension in the
port Name fieldtomatch.
Re
iew Report After Generating
V
nclude Pass/Fail Results Summary
I
Automatically opens the report in a Web browser when the
est completes. This option is selected by default.
t
ets the application to include the color block labeled Test
S
Result (indicating whether the test passed or failed) in the
report. For details, see Report Contents in View a report
(see page 35).
34TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsView a report
Table 8: Report options (cont.)
SettingDescription
Include Detailed Results
Include Plot Images
Include Setup ConfigurationSets the application to include hardware and software
Include User CommentsSelect to include any comments about the test that you or
xxx
See als
o
Sets the application to include parameter limits and
test-specific comments generated during the test.
Sets the application to include plotted diagrams.
information in the summary box at the top of the report.
Information includes: the oscilloscope model and serial
number, probe model and serial number, the oscilloscope
firmware version, SPC and factory calibration status,
and software versions for applications used in the
measurements.
another user added in the DUT tab of the Setup panel.
View a report (see page 35)
About
setting up tests
(see page 39)
View a report
The application automatically generatesareportwhentestanalysisiscompletedanddisplaysthereport
in your default Web browser (unless you cleared the View Report After Generating check box in the
Reports panel before running the test). If you cleared this check box, or to view a different test report,
do the following:
1. Click the Browse button and locate and select the report file to view.
NOTE. If you did not save the test setup after running the report and you either closed the application or
you ran another report, the report file was not saved.
2. In the Reports panel, click View.
Forinformationonchangingthefile type, file name, and other report options, s ee Select report options
(see page 33).
Report cont
ents
Areportsho
ws specified test details, as defined in the Reports panel.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software35
Operating basicsReport contents
NOTE. NAN (Not A Number) is displayed in the report contents if an invalid waveform was supplied
for the test.
Setup configuration information
Setup configuration information is listed in the summary box at the beginning of the report. This
information includes the oscilloscope model and serial number, and software versions. To exclude this
information from a report, clear the Include Setup Configuration check box in the Reports panel before
running the
test.
Test result summary
The Test Result column indicates whether a test passed or failed. If the test passed, the column cell is
green. If the test failed, it is red. To exclude this information from a report, clear the Include Pass/FailResults Summary check box in the Reports panel before running the test.
36TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Operating basicsReport contents
See also
Results panel overview (see page 30)
View test-related files (see page 32)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software37
Operating basicsReport contents
38TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Setting up and configuring testsAbout setting up tests
About setting up tests
Set up tests using the tabs in the Setup panel (see page 18).
Tests are saved when you save a test setup. To avoid overwriting test results, remember to assign a unique
name to the test either before running it or immediately after.
See also
Test setup overview (see page 43)
Before you
About test setups (see page 49)
About running tests (see page 45)
click start
(see page 45)
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software39
Setting up and configuring testsEquipment connection setup
Equipment connection setup
The following diagrams shows how to connect the DUT to the oscilloscope for the measurements.
Common Mode c
Ripple Voltage connection
onnection
See also
Minimum system requirements (see page 3)
View connected instruments (see page 41)
About setting up tests (see page 39)
40TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Setting up and configuring testsView connected instruments
View connected instruments
Use the Instrument Control Settings dialog box to view or search for connected instruments required for
the tests. The application uses TekVISA to discover the connected instruments.
To refresh the list of connected instruments:
1. From the Options menu, select Instrument Control Settings.
2. In the Search Criteria section of the Instrument Control Settings dialog box, select the connection types
of the instruments for which to search.
Instrument search i s based on the VISA layer, but different connections determine the resource type,
such as LAN, GPIB, and USB. For example, if you choose LAN, the search will include all the
instruments supported by TekExpress that are communicating over the LAN. If the search does not
find any instruments that match a selected resource type, a message appears telling you that no such
instrum
3. Click Refresh. TekExpress searches for connected instruments.
ents were found.
4. After discovery, the dialog box lists the instrument-related details based on the search criteria you
selected. For example, if you selected LAN and GPIB as the search criteria, the application checks for
the availability of instruments over LAN, then GPIB.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software41
Setting up and configuring testsView connected instruments
The details of the instruments are displayed in the Retrieved Instruments table. The time and date of
instrument refresh is displayed in the Last Updated field.
See also
Configuration test parameters (see page 27)
Equipment connection setup (see page 40)
42TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Setting up and configuring testsTest setup overview
Test setup overview
Test setup includes acquisition and configuration parameters. You can also select report options when
setting up tests. Use the options in the Setup panel
select and co
nfigure tests.
(see page 18) and Reports panel (see page 33) to
1. Set DUT parameters
2. Select one or more tests
3. Select acquisitions
4. Configuration test parameters
5. Set test measurement notification options
6. Select re
port options
(see page 19).
(see page 20).
(see page 21).
(see page 27).
(see page 33).
See also
About test setups (see page 49)
Prerun checklist (see page 48)
Before you click start (see page 45)
About running tests (see page 45)
(see page 25).
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software43
Setting up and configuring testsTest setup overview
44TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Running testsAbout running tests
About running tests
After selecting and configuring tests, review the prerun checklist (see page 48) andthenclickStart to
run the tests. While tests are running, you cannot access the Setup or Reports panels. To monitor the test
progress, sw
The application displays a report when the tests are complete. While the tests are running, other
applications may display windows in the background. The TekScope application takes precedence over
other applications, but you can switch to other applications by using the Alt + Tab key combination. To
keep the TekExpress USBPWR application on top, select Keep On Top from the TekExpress Options
menu.
See also
Before you click start (see page 45)
About configuring tests (see page 25)
About setting up tests (see page 39)
itch back and forth between the Status panel and the Results panel.
Before you click start
Before you run tests for the first time, do the following:
1. Understand where your test files are stored on the instrument.
After you install and launch TekExpress USBPWR, it creates the following folders on the oscilloscope:
Every time y ou launch TekExpress USBPWR, an Untitled Session folder is created in the US B
folder. The Untitled Se ssion folder is automatically deleted when you exit the USBPWR
PWR
application. To preserve your test session files, save the test setup before exiting the TekExpress
application.
CAUTION. Do not modify any of the session files or folders because this may result in loss of data
or corrupted session files. Each session has multiple files associated with it. When you save a
session, a .TekX file, and a folder named for the session that contains associated files, is created
on the oscilloscope X: drive.
2. Map the shared My TekExpress folder (see page 47) as X: (X drive) on the instruments used in test
setups running Microsoft Windows Operating System.
The My TekExpress folder has the share name format
the instrument is not connected to a domain, the share name format is
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software45
<domain><user ID>My TekExpress.Or,if
<instrument name><user
Running testsBefore you click start
ID>My TekExpress. This shared folder is used to save the waveform files and is used during other
file transfer operations.
NOTE. If the X:
drive is mapped to any other shared folder, the application will display a warning message
asking you to disconnect the X: drive manually.
3. Make sure th
at the My TekExpress folder has read and write access, and that the contents are not set
to be encrypted:
a. Right-cli
ck the folder and select Properties.
b. Select the General tab and then click Advanced.
c. In the Advanced Attributes dialog box, make sure that the option Encrypt contents to secure
data is NOT selected. Example.
4. See the prerun checklist (see page 48) before you run a test.
See also
Configuration test parameters (see page 27)
View test-related files (see page 32)
Application directories and usage (see page 8)
File name extensions (see page 10)
46TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Running testsMap the My TekExpress folder
Map the My TekExpress folder
In the case where you operate the TekExpress application on one oscilloscope, but acquire data from
another (remotely-accessed) oscilloscope, you need to share and map the My TekExpress folder on the
remote instr
To map the My TekExpress folder on a remote instrument:
1. Open Windows Explorer.
2. From the Windows Explorer menu, click Computer.
3. In the menu bar, click Map network drive.
4. Select the Drive letter as X: (if there is any previous connection on X:, disconnect it first through
Tools > Disconnect Network drive menu of Windows Explorer. Windows 7 users: if you do not seethe Tools menu, press the Alt key).
5. In the Folder field, enter the remote My TekExpress folder path (for example, \\192.158.97.65\ My
TekExpress).
ument with the USBPWR application.
6. Click Finish.
To determine the IP address of the instrument where the My TekExpress folder exists, do the following:
1. On the
2. Ty pe cmd and press Enter.
3. At the command prompt, type ipconfig and press Enter.
instrument where the My TekExpress folder exists, click Start and select Run.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software47
Running testsPrerun checklist
Prerun checklist
Do the following before you click Start to run a test. If this is the first time you are running a test on a
setup, refer to the information in Before you click start
1. Make sure that all the required instruments are properly warmed up (approximately 20 minutes).
2. Perform Signal Path Compensation (SPC).
a. On the oscilloscope main menu, select the Utilities menu.
b. Select Instrument Calibration.
(see page 45).
3. Verify tha
instruments (see page 41).
t the application is able to find the DUT. If it cannot, perform a search for connected
a. In USBPWR
b. Select any test and then click Configure.
c. In the Configuration section, click Global Settings.
d. In the Instruments Detected section, click the drop-down arrow to the right of Real Time
Scope and make sure that the oscilloscope with the (GPIB8::1::INSTR) designation is in
the list.
See also
pment connection setup
Equi
, select the Setup panel and then click the Test Selection tab.
(see page 40)
48TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
Saving and recalling test setupsAbout test setups
About test setups
TekExpress USBPWR opens with the default setup selected. Run a test before or after saving a setup.
When you save a setup, the test information, such as the selected oscilloscope, general parameters,
acquisition
all saved under the setup name at X:\USB PWR.
Use test setups to:
Run a saved test in prerecorded mode.
View all the information associated with a saved test, including the log file, the history of the test
status as it executed, and the results summary.
Createanewtestsetupbasedonanexistingone.
Run a new session, acquiring live waveforms, using a saved test configuration.
See also
parameters, measurement limits, waveforms (if a pplicable), and other configuration settings are
About set
Save a test setup (see page 49)
Recall a saved test setup (see page 50)
tinguptests
Save a test setup
Save a test setup before or after running a test to save the test configuration. Create a new test setup
from any open setup or from the default setup. When you selec t the default test setup, all parameters
are returned to the application’s default values.
To save the current setup session to the same setup name, select Options > Save Test Setup.
To save the current setup session to a new setup name, select Options > Save Test Setup As.
To create and save a new setup from the default test setup:
1. Select Options > Default Test Setup.
2. Select Setup and set required options and paramete rs in the tabs (DUT, Test Selection, and so on).
3. Select Reports and set your report options
4. Optional: Click Start to run the test and verify that it runs correctly and captures the information you
want. If it does not, edit the parameters and repeat this step until the test runs to your satisfaction.
(see page 39)
(see page 33).
Running the test helps verify that all parameters are set correctly, but it is not a necessary step.
5. Select Options > Save Test Setup.Enterthefile name for the setup file. The application saves the
file to X:\USB PWR\<session_name.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software49
Saving and recalling test setupsOpen (load) a saved test setup
See also
About setting up tests (see page 39)
Test setup overview (see page 43)
View test-related files (see page 32)
About configu
ring tests
(see page 25)
Open (load) a saved test setup
These instructions are for recalling saved test setups.
1. Select Options > Open Test Setup.
2. Select the setup from the list and click Open.SetupfilesmustbelocatedatX:\USB PWR.
See also
About test setups (see page 49)
Create a new test setup based on an existing one (see page 50)
Test se
tups overview
(see page 43)
Create a new test setup based on an existing one
Use this method to create a variation on a test setup without having to create the setup from the beginning.
1. Select Options > Open Test Setup.
2. Select a setup from the list and then click Open.
3. Use the Setup and Reports panels to modify the parameters to meet your testing requirements.
4. Select Options > Save Test Setup As.
ter a test setup name and click Save.
5. En
See also
About test setups (see page 49)
Set DUT parameters (see page 19)
Configuration parameters (see page 27)
Select acquisitions (see page 21)
50TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceAbout the programmatic interface
About the programmatic interface
The Programmatic interface seamlessly integrates the TekExpress test automation application with the
high-level automation layer. This also lets you control the state of the TekExpress application running on a
local or a rem
The following terminology is used in this section to simplify description text:
TekExpress Client: A high-level automation application that communicates with TekExpress using
TekExpress Programmatic Interface.
TekExpress Server: The TekExpress application when being controlled by TekExpress Client.
TekExpress leverages .Net Marshalling to enable the Programmatic Interface for TekExpress Client.
TekExpre
TekExpress client library is inherited from .Net MarshalByRef class to provide the proxy object for the
clients. The TekExpress client library maintains a reference to the TekExpress Server and this reference
allows the client to control the server state.
ote computer.
ss provides a client library for TekExpress clients to use the programmatic interface. The
also
See
Requirements for Developing TekExpress Client (see page 51)
Requirements for developing TekExpress client
While developing TekExpress Client, use the TekExpressClient.dll. The client can be a VB .Net, C#
.Net, TestStand, or Web application. The examples for interfaces in each of these applications are in the
amples
S
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software51
folder.
TekExpress programmatic interfaceRequirements for developing TekExpress client
References required
TekExpressClient.dll has an internal reference to IIdlglib.dll and IRemoteInterface.dll
IIdlglib.dll has a reference to TekDotNetLib.dll.
IRemoteInterface.dll provides the interfaces required to perform the remote automations. It is an
.
interface that forms the communication line between the server and the client.
IIdlglib.dll provides the methods to generate and direct the secondary dialog messages at the
client-end.
NOTE. The end-user client application does not need any reference to the above mentioned DLL files.
It is essential to have these DLLs (IRemoteInterface.dll, IIdlglib.dll and TekDotNetLib.dll) in the same
folder as
that of TekExpressClient.dll.
Required steps for a client
The client uses the following steps to use TekExpr essClient.dll to programmatically control the
server:
Develop a client UI to access the interfaces exposed through the server. This client loads
TekExpressClient.dll to access the interfaces. After TekExpressClient.dll is loaded, the client
UI can call the specific functions to run the operations requested by the client. When the client is up and
running, it does the following to run a remote operation:
1. To connect to the server, the client provides the IP address of the PC where the server is running.
2. The client locks the server application to avoid conflict with any other Client that may try to control
the server simultaneously. “Lock” would also disable all user controls on the server so that server
state cannot be changed by manual operation.
If any other client tries to access a server that is locked, it will receive a notification that the server
is locked by another client.
3. When the client has connected to and locked the server, the client can access any of the programmatic
controls needed to run the remote automations.
4. After the client operations finish, the client unlocks the server.
See also
USB PWR application commands flow (see page 60 )
52TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
The server exposes a remote object to let the remote client access and perform the server-side operations
remotely. The proxy object is instantiated and exposed at the server-end through marshalling.
This object lets the remote client access the interfaces exposed at the server side. The client ge ts the
reference to this object when the client gets connected to the server.
The s econdary dialog messages from the Secondary Dialog library are redirected to the client-end when a
client is performing the automations at the remote end.
In the secondary dialog library, the assembly that is calling for the dialog box to be displayed is checked
and if a remote connection is detected, the messages are directed to the remote end.
File Transfer Events
54TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceClient programmatic interface example
When the client requests the transfer of the report, the server reads the report and transfers the file by
calling the file transfer methods at the client-end.
Client programmatic interface example
The following is an overview of the client programmatic interface:
Process flowchart diagram
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software55
TekExpress programmatic interfaceClient programmatic interface example
Process overview:
56TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceClient programmatic interface example
1. Connect to a server or remote object using a programmatic interface.
2. Get the client ID that is created when connecting to the remote object. This client ID is one of the
required parameters to communicate with the server.
NOTE. The server identifies the client with this ID only and rejects any request if the ID is invalid.
3.Lock the server for further operations. This disables the application interface.
NOTE. You can get values from the server or set values from the server to the client only if the application
is locked.
4. Register for receiving notifications on status change events on the server. To register you need to give
a handler as a parameter. For details, see Handler of Status Change Notification
NOTE. Whenever there is a change in the status of the server, all the clients registered with the server
receive a notification from the server.
(see page 57).
5. Select the tests that you want to run through the programmatic interface.
6. Set the necessary parameters for each test.
7. Run the tests.
8. Poll for the status of the application.
NOTE. Skip step 8 if you are registered for the status change notification and the status is Ready.
9. After completing the tests, get the results.
eate a report or display the results and verify or process the results.
10.Cr
11. Unlock the server after you complete all the tasks.
12. Disconnect from the remote object.
andler of status change notification
H
1. Get the status. If the status is Wait or Error, get the information that contains the title, message
description, and the expected responses for the status.
2. Perform the actions based on the status information.
3. Set the response as expected.
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software57
TekExpress programmatic interfaceClient programmatic interface example
See also
USB PWR application commands flow (see page 60 )
Program remote access code example (see page 59)
58TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceProgram remote access code example
Program remote access code example
This code example shows how to communicate between a remote PC and TekExpress USBPWR.
Table 9: Remote access code example
TaskCode
Start the
application
Connect through
an IP address.
Lock the server
Disable the
Popups
Set the DUT ID
Select a test
Select a
Sample
Rate
Select a Record
Length
Runwithset
configurations
Wait for the test to
lete.
comp
Get the current
te information
sta
nd the
Se
response
Save resultsSave all results values from folder for current run
The dutId parameter is set after the server processes the request.
string device
NameTypeDirectionDescription
devicestringIN
xxx
Specifies the name of the device.
string suite
NameTypeDirectionDescription
suitestringIN
xxx
Specifies the name of the suite
string test
NameTypeDirectionDescription
test
stringIN
Specifies the name of the test to obtain the pass or fail status
or a test result value.
xxx
string parameterString
NameTypeDirectionDescription
parameterString
xxx
stringIN
Selects or deselects a test
int rowNr
NameTypeDirectionDescription
rowNrintIN
xxx
NOTE. When the client tries to lock a server that is locked by another client, the client gets a
notification that the server is already locked and it must wait until the server is unlocked. If the client
locks the server and is idle for a certain amount of time then the server is unlocked automatically
from that client.
Specifies the zero based row index of
the sub-measurement for obtaining
the result value
62TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
The name parameter cannot be empty. If it is empty, the client is prompted to provide a v alid name.
NOTE. When the run is performed, the status of the run is updated periodically using a timer.
string name
NameTypeDirectionDescription
name
xxx
stringIN
The name of the session being saved
The name parameter cannot be empty. If it is empty, the client is prompted to provide a v alid name.
Once the session is saved under ‘name’ you cannot use this method to save the session in a different
name. Use SaveSessionAs instead.
string name
NameTypeDirectionDescription
name
stringIN
The name of the session being
recalled
xxx
The same session is saved under different names using this method. The name parameter cannot be
empty. If it is empty, the client is prompted to provide a valid name.
bool isSelected
NameTypeDirectionDescription
isSelected
xxx
boolIN
Selects or deselects a test
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software63
The time parameter gives the timeout period, which is the time the client is allowed to be locked and
idle. After the timeout period if the client is still idle, it gets unlocked.
The time parameter should be a positive integer; otherwise, the client is prompted to provide a
valid timeout period.
bool_verbose
NameTypeDirectionDescription
_verboseboolIN
xxx
Specifies whether the verbose mode
should be turned ON or OFF
NOTE. When the session is stopped, the client is prompted to stop the session and is stopped at
the consent.
string filePath
NameTypeDirectionDescription
filePath
stringINThe location where the report must
be saved in the client
xxx
NOTE. If the client does not provide the location to save the report, the report is saved at
C:\ProgramFiles.
NOTE. When the client is disconnected, the client is unlocked automatically.
out string WaitingMsbBxCaption
NameTypeDirectionDescription
captionstring
xxx
OUT
The wait state or error state message sent to
you
64TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceConnect through an IP address
out string WaitingMsbBxMessage
NameTypeDirectionDescription
message
xxx
string
OUTThe wait state/error state message sent to you
out string[] WaitingMsbBxButtontexts
NameTypeDirectionDescription
buttonTextsstring array
OUTAn array of strings containing the
possible response types that you can
send
xxx
string WaitingMsbBxResponse
NameTypeDirectionDescription
response
stringINA string containing the response
type that you can select (it must be
one of the strings in the string array
buttonTexts)
The return value of the remote a utomations at the server-end is OP_STATUS, which changes to a string
value depending on its code, and returned to the client. The values of OP_STATUS are as follows:
CodeValueDescription
-1FAIL
1
2
3
4
0NULLNothing
xxx
SUCCESS
NOT FOUNDServer not found
LOCKEDThe server is locked by another client, so the operation cannot be performed
UNLOCKThe server is not locked; lock the server before performing the operation
NOTE. The Fail condition for PI commands occurs in any of the following cases:
The operation failed
The operation succeeded
The ser
ver is LOCKED and the message displayed is "Server is locked by another client".
ThesessionisUNLOCKEDandthemessagedisplayed is "Lock Session to execute the command".
The server is NOTFOUND and the message displayed is "Server not found...Disconnect!".
When none of these fail conditions occur, then the message displayed is "Failed...".
76TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software
TekExpress programmatic interfaceGet or set the timeout value
Returns the current
timeout period set
by the client
Sets a timeout
period spe
by the client.
After this timeout
period exp
server is unlocked
automatically.
cified
ires, the
String that gives
the status of
operation after it
was performed
The default
return value is
1800000.
String that gives
the status
operation after it
was performed
On succes
return value is
“TimeOut Period
Changed”
the
of the
sthe
.
m_Client = new Client()
//m_Client i
Client class in the Client DLL.
returnval as string
returnval=
Out()
m_Client = new Client()
//m_Clien
Client class in the Client DLL.
returnval as string
returnva
Out(clientID, desiredTimeOut)
s a reference to the
m_Client.GetTime-
t is a reference to the
l=m_Client.SetTime-
NOTE. The Fail condition for PI commands occurs in any of the following cases:
The server is LOCKED and the message displayed is "Server is locked by another client".
The session is UNLOCKED and the message displayed is "Lock Session to execute the command".
The server is NOTFOUND and the message displayed is "Server not found...Disconnect!".
When n
one of these fail conditions occur, then the message displayed is "Failed...".
TekExpress USB Power Adapter / EPS Compliance Automated Test Solution Software77
TekExpress programmatic interfaceWait for the test to complete
Wait for the test to complete
The commands in this group execute while tests are running. The GetCurrentStateInfo() and
SendResponse() commands are executed when the application is running and in the wait state.