Tektronix TekExpress M-PHY Receiver Automated Test Solution User manual

Download

M-PHY Receiver Automated Test Solution

Printable Application Help

*P077064303*

077-0643-03

M-PHY Receiver Automated Test Solution

Printable Application Help

Supports M-PHY Receiver Automated Test Solution, release

3.1.0 and above.

www.tektronix.com

077-0643-03

Copyright © Tektronix. All rights reserved. Licensed software products are owned by Tektronix or its subsidiaries or suppliers, and are protected by national copyright laws and international treaty provisions. 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.

Contacting Tektronix

Tektronix, Inc. 14150 SW Karl Braun Drive P.O. Box 500 Beaverton, OR 97077 USA

For product information, sales, service, and technical support:

■

In North America, call 1-800-833-9200.

■

Worldwide, visit www.tektronix.com to find contacts in your area.

Welcome .............................................................................................................................................. v

Getting help and support

Related documentation ................................................................................................................... 1

Conventions used in help ................................................................................................................ 1

Technical support ........................................................................................................................... 2

Getting started

Installing the software .................................................................................................................... 3

Compatibility ............................................................................................................................. 3

Minimum system requirements ................................................................................................. 3

Install the software .................................................................................................................... 5

Activate the license ................................................................................................................... 6

View license information .......................................................................................................... 6

Introduction to the application ........................................................................................................ 6

M-PHY Rx application overview .............................................................................................. 6

Application directories and usage ............................................................................................. 7

File name extensions ................................................................................................................. 8

Operating basics

Start the application ........................................................................................................................ 9

Exit the application ......................................................................................................................... 9

Application controls and menus ................................................................................................... 10

Application controls ................................................................................................................ 10

Options menu .......................................................................................................................... 11

Email settings .......................................................................................................................... 12

Instrument control settings ...................................................................................................... 12

Panels ....................................................................................................................................... 14

Saving and recalling test setups

About test setups ........................................................................................................................... 21

Save a test setup ............................................................................................................................ 21

Recall a saved test setup ............................................................................................................... 22

Create a new test setup based on an existing one ......................................................................... 22

M-PHY Receiver Automated Test Solution Printable Application Help i

Table of Contents

Setting up and configuring tests

About setting up tests ................................................................................................................... 23

Equipment connection setup ......................................................................................................... 24

View connected instruments ......................................................................................................... 28

Test setup overview ...................................................................................................................... 29

Select device parameters .............................................................................................................. 30

Select a test ................................................................................................................................... 32

Configuring tests ........................................................................................................................... 33

About configuring tests ........................................................................................................... 33

Configure tests ......................................................................................................................... 33

Common test parameters ......................................................................................................... 33

Configure email notification ................................................................................................... 35

Select test notification preferences ............................................................................................... 36

Select report options ..................................................................................................................... 37

Auto calibration ............................................................................................................................ 38

Auto calibration ...................................................................................................................... 38

Auto calibration wizard overview .......................................................................................... 39

Auto calibration setup diagrams .............................................................................................. 40

Start the auto calibration wizard .............................................................................................. 41

Set auto calibration pattern parameters ................................................................................... 42

Perform ISI auto calibration ................................................................................................... 43

Perform RJ auto calibration .................................................................................................... 44

Perform SJ auto calibration .................................................................................................... 44

Perform voltage auto calibration ............................................................................................. 45

View auto calibration results ................................................................................................... 46

View auto calibration parameter details .................................................................................. 47

Running tests and viewing results

About running tests ....................................................................................................................... 49

Before you click start .................................................................................................................... 49

Pre-Run checklist .......................................................................................................................... 51

View the progress of analysis ....................................................................................................... 52

View test results ............................................................................................................................ 53

View a report ................................................................................................................................ 54

View test-related files ................................................................................................................... 56

ii M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

About the programmatic interface ................................................................................................ 59

Requirements for developing TekExpress client .......................................................................... 60

Remote proxy object ..................................................................................................................... 61

Client proxy object ....................................................................................................................... 62

Client programmatic interface example ....................................................................................... 63

Program example .......................................................................................................................... 66

M-PHY Rx application commands ............................................................................................... 67

About M-PHY Rx application commands .............................................................................. 67

Connect through an IP address ................................................................................................ 73

Lock the server ........................................................................................................................ 74

Disable the popups .................................................................................................................. 76

Set or get the DUT ID ............................................................................................................. 77

Set the configuration parameters for a suite or measurement ................................................. 79

Query the configuration parameters for a suite or measurement ............................................ 82

Select a measurement .............................................................................................................. 86

Select a suite ............................................................................................................................ 87

Select a channel ....................................................................................................................... 89

Configure the selected measurement ....................................................................................... 92

Run with set configurations or stop the run operation ............................................................ 94

Handle error codes ................................................................................................................... 95

Get or set the timeout value ..................................................................................................... 96

Wait for the test to complete ................................................................................................... 97

After the test is complete ....................................................................................................... 102

Save, recall, or check if a session is saved ............................................................................ 110

Unlock the server ................................................................................................................... 113

Disconnect from the server .................................................................................................... 114

Table of Contents

HS testing procedures and examples

Receiver testing measurement procedure ................................................................................... 117

High-Speed mode measurements ............................................................................................... 118

Test pattern details for continuous mode .................................................................................... 119

Test pattern details for burst mode ............................................................................................. 119

Test procedure ............................................................................................................................ 119

Loopback validation ................................................................................................................... 120

About the oscilloscope error detector ......................................................................................... 121

2.1.1 HS-RX differential DC input voltage amplitude tolerance (VDIF-RX) test ..................... 121

M-PHY Receiver Automated Test Solution Printable Application Help iii

Table of Contents

2.1.2 HS-RX accumulated diff input voltage (VDIF-ACC-HS-RX) test ................................... 123

2.1.3 HS-RX Common-Mode input voltage tolerance (VCM-RX) test ..................................... 124

2.1.4 HS-RX differential termination enable time (TTERM-ON-HS-RX) test ......................... 125

2.1.5 HS-RX differential termination disable time (TTERM-OFF-HS-RX) test ....................... 127

2.1.7 HS-RX receiver jitter tolerance (TJRX, DJRX, RJRX, STTJRX, STDJRX) test ............. 128

2.1.8 HS-RX frequency offset tolerance (fOFFSET-RX) test .................................................... 130

2.1.9 HS-RX PREPARE length capability verification (THS-PREPARE-RX) test .................. 131

2.1.10 HS-RX sync length capability verification (TSYNC-RX) test ....................................... 132

HS margin tests ........................................................................................................................... 133

PWM testing procedures and examples

Test pattern details for continuous mode .................................................................................... 137

Test pattern details for burst mode ............................................................................................. 137

Test procedure ............................................................................................................................ 137

2.2.1 PWM-RX differential DC input voltage amplitude tolerance (VDIF-DC-PWM-RX) test

.................................................................................................................................................... 138

2.2.2 PWM-RX accumulated differential input voltage tolerance (VDIF-ACC-PWM-RX) test

.................................................................................................................................................... 139

2.2.3 PWM-RX Common-Mode input voltage tolerance (VCM-RX) test ................................ 140

2.2.4 PWM-RX differential termination enable time (TTERM-ON-PWM-RX) test ................ 142

2.2.5 PWM-RX differential termination disable time (TTERM-OFF-PWM-RX) test .............. 143

2.2.8 PWM-RX receive ratio PWM-G1 and above (kPWM-RX) test ....................................... 144

2.2.9 PWM-RX receive minor duration in PWM-G0 (TPWM-MINOR-G0-RX) test .............. 145

Reference

Map the My TekExpress folder .................................................................................................. 147

Enable the oscilloscope error detector ........................................................................................ 147

Use a bias tee for common mode DC ......................................................................................... 148

iv M-PHY Receiver Automated Test Solution Printable Application Help

Welcome

The Tektronix M-PHY Rx Automated Test software runs on Tektronix real-time oscilloscopes that are based on Windows 7 computer operating systems. M-PHY Rx provides an automated, simple, and efficient way to test M-PHY Receiver interfaces and devices consistent to the requirements of the MPHY Base Specification and Conformance Test Specification.

M-PHY Receiver Automated Test Solution Printable Application Help v

Welcome

vi M-PHY Receiver Automated Test Solution Printable Application Help

Getting help and support

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 mechanical methods of choosing an option: using a mouse or using the touch screen.

M-PHY Receiver Automated Test Solution Printable Application Help 1

Getting help and 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, or the Web site. See

Contacting Tektronix for more information.

When you contact Tektronix Technical Support, please include the following information (be as specific as possible):

■

General Information

All instrument model numbers

■

Hardware options, if any

■

Probes used

■

Your name, company, mailing address, phone number, FAX number

■

Please indicate if you would like to be contacted by Tektronix about your suggestion or comments.

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.

2 M-PHY Receiver Automated Test Solution Printable Application Help

Getting started

Installing the software

Compatibility

The TekExpress M-PHY Rx application runs on the following Tektronix oscilloscopes:

■

DPO/DSA/MSO70604 C/D M-PHYRX (only for HS-Gear 1)

■

DPO/DSA/MSO71254 C/D M-PHYRX (only for HS-Gear 1 and 2)

■

DPO/DSA/MSO72304 C/D M-PHYRX

■

DPO/DSA/MSO71604 C M-PHYRX (only for HS-Gear 1 and 2)

■

DPO/DSA/MSO72004 C M-PHYRX (only for HS-Gear 1 and 2)

■

DPO/DSA/MSO72504 DX M-PHYRX

■

DPO/DSA/MSO73304 D M-PHYRX

■

DPO/MSO72304 DX M-PHYRX

■

DPO/DSA/MSO70804 C M-PHYRX (only for HS Gear 1)

The TekExpress M-PHY Rx application can be used with the following probes:

■

Tektronix P7380SMA for HS Gear 1

■

P73xx SMA for HS Gear 2

■

P76xx for HS Gear 3

■

P73xx for all PWM Gears

Install the software

The TekExpress M-PHY Rx web installer page provides link to the software package which is to be installed on the oscilloscope. For a list of compatible instruments, see Compatibility.

■

TekExpressM-PHYRXWebInstaller.exe: Installs the TekExpress M-PHY Rx application

To download and install the files:

1. Close the TekScope application.

2. Go to the www.tek.com Web site and search for M-PHY Rx to locate the

installation file. Download the file TekExpressM-PHYRXWebInstaller.exe.

3. Double-click the executable file to extract the installation files.

After extraction, the installer launches and the software automatically installs in the following location:

■

C:\Program Files\Tektronix\TekExpress\TekExpress M–PHY Rx

4. To open the application, open the TekScope application and then select TekExpress M-PHY Rx from the Analyze menu.

Activate the license

View license information

Activate the license using the Option Installation wizard on the oscilloscope. The oscilloscope Online Help has instructions for using the Options Installation window to activate licenses for installed applications. Follow these steps to activate the TekExpress M-PHY Rx license:

1. From the oscilloscope menu, click Utilities > Option Installation.

The TekScope Option Installation wizard opens.

2. Press 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

To view license information:

1. From the oscilloscope Help menu, select About TekScope.

The Options section in the dialog box displays a list of installed options, including M-PHY Rx: M-PHY receiver solution.

2. To view the Option key, look in the Option Installation Key section.

Introduction to the application

M-PHY Rx application

overview

TekExpress is the Tektronix Test Automation Framework, developed to support your current and future test automation needs. TekExpress uses a highly modular architecture that lets you deploy automated test solutions for various standards in a relatively short time.

6 M-PHY Receiver Automated Test Solution Printable Application Help

Getting started

Key Features. M-PHY Rx has the following key features:

■

Allows conformance testing to the Base specification version 2.0 and Compliance Test Specification (CTS v1.0)

■

Automated Testing:

■

Reduces the amount of time required to conduct testing

■

Enables you to test devices faster

■

Tests coverage: 9 HS measurements, 7 PWM measurements, and Margin test for HS mode.

■

Auto calibration of setup for HS mode and HS Margin tests.

■

Selective testing: Allows you to select individual tests or test groups in the tree-structure.

■

Reliable Results: Avoids repeated testing through accurate and reliable results from a single run

■

Integrated BER:

Bit Error Rate

■

Leverage Bit-Error-Rate or Error-Count testing using oscilloscopeintegrated ERRDT software in the background.

■

Dialog box to support manual error entry.

■

Custom script support for reading error.

■

Customize the setup: Provision to configure the test setup according to the DUT-supported configuration, such as the HS Gear A or B, and test time.

■

Detailed test reporting:

■

Provides a Pass/Fail summary table. (For details, see Results panel)

■

Provides a consolidated report for all tests

■

Provides additional information such as test setup hardware and software details, signal type selected, measured value, execution time, and usercomments for each measurement

Application directories

and usage

The application directory and associated files are organized as follows:

M-PHY Receiver Automated Test Solution Printable Application Help 7

Getting started

The following table lists the default directory names and their usage:

Table 3: Application directories and usage

Directory names Usage

InstallDir\TekExpress\TekExpress MIPI M-PHYRxContains the application and associated files

TekExpress M-PHY Rx\Bin Contains miscellaneous M-PHY Rx application

libraries

TekExpress M-PHY Rx\Compliance Suites Contains compliance-specific files

TekExpress M-PHY Rx\Images Contains Tektronix logo images used for reports

TekExpress M-PHY Rx\Documents Contains the technical documentation for the M-

PHY Rx application

TekExpress M-PHY Rx\Examples Contains various support files

TekExpress M-PHY Rx\ICP Contains instrument and M-PHY Rx application-

specific interface libraries

TekExpress M-PHY Rx\Lib Contains utility files specific to the M-PHY Rx

application

TekExpress M-PHY Rx\Report Generator Contains Excel Active X interface Library for

Report Generation

TekExpress M-PHY Rx\Tools Contains instrument and M-PHY Rx application-

specific files

File name extensions

Operating basics

Start the application

When you open the application after installation, the application checks for a file called Resources.xml located in the My TekExpress folder. If this file is not found, instrument discovery is performed before launching M-PHY Rx. The Resources.xml file contains information regarding instruments that are available on your network. If the application license was not installed using the TekScope menu Utilities > Option Installation selection, the application will allow 10 free launches. Each time you open the application without supplying a valid license key, one of the free trials is used.

To run the M-PHY Rx application, do any of the following:

■

From the TekScope Analyze menu, select Analyze > TekExpress M-PHY Rx.

■

Double-click any saved session file.

See also

Exit the application

Activate the license

Use the following method to exit the application:

NOTE. Using other methods to exit the application results in abnormal termination of the application.

Click

2. Do one of the following:

■

on the application title bar.

If you have an unsaved session or test setup open, you are asked to save it before exiting. To save it, click Yes. Otherwise click No. The application closes.

A message box appears asking if you really want to exit TekExpress. To exit, click Yes.

M-PHY Receiver Automated Test Solution Printable Application Help 9

Operating basics

Application controls and menus

Application controls

Table 4: Application controls descriptions

Item Description

Options menu Opens the Options menu for access to global

controls

Panels Visual frames with sets of related options

Command buttons Buttons that initiate an immediate action such as

the Start, Stop, Pause, Continue, and Clear command buttons

Start button

Use the Start button to continuously acquire and accumulate measurements. If prior acquired measurements have not been cleared, the new measurements are added to the existing set.

Stop button

Use the Stop button to abort the test.

Pause \ Continue button

Use the Pause button to temporarily interrupt the current acquisition. When a test is paused, the button name changes to Continue.

Clear button

Application window move icon

Use the Clear button to clear all existing measurement results. Adding or deleting a measurement, or changing a configuration parameter of an existing measurement, also clears measurements. This is to prevent the accumulation of measurement statistics or sets of statistics that are not coherent. This button is available only on the Results panel.

Place the cursor over the three-dot pattern in the upper left corner of the application window. When the cursor changes to a hand, drag the window to the desired location.

10 M-PHY Receiver Automated Test Solution Printable Application Help

Operating basics

Options menu

The Options menu is located in the upper right corner of the application.

The Options menu has the following selections:

Menu Function

Default Test Setup Opens an untitled test setup with defaults

selected

Open Test Setup Opens a saved test setup

Save Test Setup Saves the current test setup selections

Save Test Setup As Creates a new test setup based on an existing

one

Open Recent Displays a menu of recently opened test setups

to select from

Instrument control settings Shows the list of instruments connected to the

test setup and allows you to locate and refresh connections to connected instruments

Keep On Top Keeps the TekExpress M-PHY Rx utility on top

of other open windows on the desktop

Email settings Use to configure email options for test run and

results notifications

Help Displays TekExpress Help

About TekExpress

■

Displays application details such as software name, version number, and copyright

Options menu

Email settings

Use the Email Settings utility to configure email notifications if you want MPHY Rx to notify you when a test completes, produces an error, or fails. Select the type of test run information to include in the notification, such as test reports and test logs, the email message format, and the email message size limit.

NOTE. Recipient email address, sender’s address, and SMTP Server are mandatory fields.

Instrument control

settings

Panels

About panels. TekExpress M-PHY Rx has the following main panels:

Table 5: Application panels

Panel Name Purpose

Setup The Setup panel allows you to configure the test

setup. Use this panel to:

■

Select the device paramaters.

■

Select the test(s).

■

Configure the selected tests.

■

Select test notification preferences.

Status View the progress and analysis status of the

selected tests, and view test logs.

Results View a summary of test results and select

results viewing preferences.

Reports Browse for reports, save reports as specific file

types, 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.

Saving and recalling test setups

About test setups

TekExpress M-PHY Rx opens with the default setup selected. Run a test before or after saving a setup. When you save a setup, the selected oscilloscope, general parameters, measurement limits, test, and other configuration settings are all saved under the setup name. You can run a saved test without having to do any other setup except ensuring that the oscilloscope is ready. Open the setup and click Start.

See also

Save a test setup

About setting up tests

Save a test setup

Recall a saved test setup

Create a new test setup based on an existing one

Save a test setup before or after running a test using the parameters you want saved. Create a new test setup from any open setup or from the default setup. When you select the default test setup, all parameters are returned to their defaults. The following instructions start from the default test setup:

1. From the Options menu, select Default Test Setup.

2. Select the desired options in the Setup panel.

3. Select the desired report options.

4. If desired, run the test to be sure that it captures the information you want. If

it does not, edit the parameters.

5. From the Options menu, select Save Test Setup.

M-PHY Receiver Automated Test Solution Printable Application Help 21

Saving and recalling test setups

See also

About setting up tests

About configuring tests

Test setup overview

Recall a saved test setup

These instructions are for recalling saved test setups:

1. From the Options menu, select Open Test Setup.

2. In the File Open dialog box, select the desired setup from the list and then click Open.

See also

About test setups

Create a new test setup based on an existing one

See also

Use this method to create a variation on a test setup without having to create the setup from the beginning.

1. From the Options menu, select Open Test Setup.

2. In the File Open dialog box, select the desired setup from the list and then click Open.

3. Modify the parameters as desired.

4. From the Options menu, select Save Test Setup As.

5. In the File Save As dialog box, enter a test setup name and then click Save.

About test setups

Test setup overview

22 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

About setting up tests

Set up tests using the tabs in the Setup panel. Settings in the DUT tab use a topdown, left-to-right logic flow, so that any parameter that affects or acts as a filter for other parameters appears either to the top of or to the left of the affected parameters.

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.

The application supports the following tests in Compliance Mode only:

■

2.1.1 HS-RX Differential DC input voltage amplitude tolerance (V

■

2.1.2 HS-RX Accumulated diff input voltage (V

■

2.1.3 HS-RX Common-mode input voltage tolerance (V

■

2.1.4 HS-RX Differential termination enable time (T

■

2.1.5 HS-RX Differential termination disable time (T

■

2.1.7 HS-RX Receiver jitter tolerance (TJRX, DJRX, RJRX, STTJRX, STDJRX)

DIF-ACC-HS-RX

CM-RX

TERM-ON-HS-RX

TERM-OFF-HS-RX

)

DIF-RX

)

■

2.1.8 HS-RX Frequency offset tolerance (f

■

2.1.9 HS-RX PREPARE length capability verification (T

■

2.1.10 HS-RX Sync length capability verification (T

■

HS Margin

■

2.2.1 PWM-RX Differential DC input voltage amplitude tolerance (V

DIF-DC-PWM-RX

■

2.2.2 PWM-RX Accumulated differential input voltage tolerance (V

DIF-ACC-PWM-RX

■

2.2.3 PWM-RX Common-mode input voltage tolerance (V

■

2.2.4 PWM-RX Differential termination enable time (T

■

2.2.5 PWM-RX Differential termination disable time (T

■

2.2.8 PWM-RX Receive ratio PWMG1 and above (k

■

2.2.9 PWM-RX Receive minor duration in PWMG0 (T

)

OFFSET-RX

)

SYNC-RX

TERM-ON-PWM-RX

TERM-OFF-PWM-RX

PWM-RX

PWM-MINOR-G0–RX

HS-PREPARE-RX

)

CM-RX

)

M-PHY Receiver Automated Test Solution Printable Application Help 23

Setting up and configuring tests

See also

About test setups

Before You click start

About running tests

Equipment connection setup

To run tests, you need the following equipment (for details, see Minimum system

requirements):

■

A supported Tektronix oscilloscope

■

Arbitrary Waveform Generator (AWG)

■

Differential probe

■

Device under test

■

Filters

Connection diagrams

NOTE. The above setup is applicable only for 2.2.4 PWM-RX differential termination enable time (T termination disable time (T

TERM-ON-PWM-RX

TERM-OFF-PWM-RX

) and 2.2.5 PWM-RX differential

). For all other PWM tests, probe

connection is not required.

Figure 1: PWM schematics

24 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

Figure 2: HS Margin schematic for Gear 1 and Gear 2

Figure 3: HS Margin schematic for Gear 3

M-PHY Receiver Automated Test Solution Printable Application Help 25

Setting up and configuring tests

NOTE. The above setup is applicable only for continuous mode tests. For Burst mode tests, probe connection is not required. Users are expected to use IBER for counting errors.

Figure 4: HS Measurement Gear 1 and Gear 2

NOTE. The above setup is applicable only for continuous mode tests. For Burst mode, probe connection is not required. Users are expected to use IBER for counting errors.

Figure 5: HS Measurement Gear 3

26 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

Figure 6: Auto calibration Gear 1 and Gear 2 schematic

Figure 7: Auto calibration Gear 3 schematic

M-PHY Receiver Automated Test Solution Printable Application Help 27

Setting up and configuring tests

See also

View connected instruments

About setting up tests

Receiver testing measurement procedure

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 to search for.

Instrument search is based on the VISA layer but different connected cables determine the resource type, such as GPIB. If the search does not find any instruments that match a selected resource type, a message appears telling you that no such instruments were found.

3. Click Refresh. TekExpress searches for connected instruments.

4. After discovery, the dialog box lists the instrument-related details based on

the search criteria you selected. For example, if you selected GPIB as the search criteria, the application checks for the availability of instruments over GPIB.

28 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

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

Test setup overview

Configure tests

Equipment setup

Test setup includes configuration parameters and report options. Use the options in the Setup panel and Reports panel to select and configure tests.

1. Select the device parameters.

2. Select one or more tests.

3. Configure tests.

4. Select test notification preferences.

5. Select report options.

M-PHY Receiver Automated Test Solution Printable Application Help 29

Setting up and configuring tests

See also

About test setups

Pre-run checklist

Before you click start

About running tests

Select device parameters

Use the Setup panel DUT tab settings to select parameters for the device under test. Options selected here are global settings that apply to all tests for the current session. Options here also affect the list of available tests in the Test Selection tab.

1. In the Setup panel, click the DUT tab.

2. If needed, in the DUT ID field, enter the ID for the device. The default value

3. (Optional) To add comments that will appear at the top of the test report for

is DUT001. The name you enter here appears on reports.

the selected DUT, click the note pad icon (

) to the right of the DUT ID field and specify a comment up to 256 characters. (To enable or disable comments appearing on the test report, see Select report options.)

4. Select from the following options if available. (Settings that do not apply to compliance testing cannot be changed and are grayed out.)

Table 6: DUT settings

Setting Description

Use Pre-Defined Pattern

Version Select the M-PHY Rx specification version. The latest version is the

Error Detection Using

Uses the built-in pre-defined pattern associated with the selected test. This cannot be changed in Compliance Mode.

default.

■

Scope: TekExpress uses the oscilloscope for error testing. This cannot be changed in Compliance Mode.

■

Manual: User enters the error count using a dialog box.

■

Custom Script: User can use a custom script to read error.

NOTE. A custom script should read the error and write to a text file parallel to the script file with same file name. For example, if you have ABC.exe in the directory C:\MIPI\, after reading the error from the DUT, ABC.exe should write the error value in a text file named ABC.txt in the same C:\MIPI\ directory.

30 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

Setting Description

LoopBack Initialization

■

This is set up manually. The application prompts you to set this value before executing a test.

■

Custom Script: User can put the DUT into loopback using a custom script. The application will run the custom script when it needs to put the DUT into loopback mode.

Perform LoopBack Initialization

Determines how frequently loopback initialization occurs.

■

Always: Do loopback initialization before starting every test.

■

Only Once: Do loopback initialization only once before starting the first measurement in the current test session.

Perform LoopBack Validation

Determines when loopback validation occurs. This process validates the DUT.

■

Only Once: Do loopback validation only once before starting the first measurement of the current session.

■

Always: Do loopback validation at the beginning of every test.

NOTE. This may require you to be available to put the DUT in loopback mode several times during testing, depending on the number of tests and the test options selected.

■

Never: Do not do loopback validation.

Signal Type

■

HS: High Speed

■

PWM: Pulse Width Modulation and HS-Margin

Gear Selection Select the gear and then select the variation of the gear that is

supported by the DUT.

See also

About setting up tests

Loopback validation

M-PHY Receiver Automated Test Solution Printable Application Help 31

Setting up and configuring tests

Select a test

Use these instructions to select the tests to run on the connected DUT.

1. In the Setup panel, click the Test Selection tab.

2. All tests are selected by default. Click Deselect All if you do not want to run

all tests.

3. Select the desired test(s):

■

To select all tests in the list, click the Select All button.

■

To select only the pre-defined tests, click Select Required button

■

To select individual tests, select only the check boxes for the desired tests.

Test selection controls

Table 7: Setup panel test controls

Button Description

Displays the schematic document for the selected test. Use to verify the test setup before running the test

Deselects all tests in the table

See also

Selects all tests in the table

Selects only pre-defined tests from Test Selection panel

About setting up tests

32 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

Configuring tests

About configuring tests

Configure tests

Use configuration settings to view the measurement parameters for selected tests. Some settings can be changed.

Configuration settings consist of Global parameters and Measurement parameters. Global parameters are common for all tests. Measurement parameters are specific to the test selected in the tree view section of the configuration settings.

Common test parameters

■

To change the Trigger source for the current test session, under Scope Settings, select the desired channel from the drop-down list.

2. To modify any individual test measurement settings, click Measurements, select the test in the tree view and change the settings.

Select test notification preferences

Select how you want to be notified by the system when a test measurement fails:

1. In the Setup panel, click the Preferences tab.

2. To receive an email when testing completes, select the On Test Completion, send me an email check box.

The application will send you an email when the current test completes. If you select this option, select the Email Test Results when complete or on error check box in the Email Settings. Click Email Settings to configure the

email settings.

See also

About setting up tests

Select report options

36 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

Select report options

Use the Reports panel to select which test information to include in the report, and the naming conventions to use for the report. For example, always 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.

In the Reports panel, select from the following options:

Table 9: Report options

Setting Description

Report Name Displays the name and location where the report will be saved when

generated. The report and related files are stored in the Untitled Session folder located by default at \My TekExpress\ M-PHY Rx \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 Name field, type over the current folder path and name.

■

Double-click in the Report Name field. Make selections from the popup keyboard and then click the Enter button.

Be sure to include the entire folder path, the file name, and the file type. For example: C:\Documents and Settings\your user name\My Documents \My TekExpress\M-PHY Rx\DUT001_Test_211.mht.

NOTE. You cannot change the file location using the Browse button.

Open an existing report.

Click Browse, locate and select the report file and then click View at the bottom of the panel.

Save As Type Saves a report in a file type different from the default. Lists supported file

types to choose from.

NOTE. If you select a file type different from the default, be sure to change the report file name extension in the Report Name field to match.

Auto increment report name if duplicate

Include Pass/Fail Results Summary

Include Detailed Results

If the application finds a report with the same name as the one being generated, the application automatically increments the name of the report. For example: DUT001, DUT002, DUT003. This option is enabled by default.

The color block labeled Test Result indicating whether the test passed or failed will be included in the report. For details, see Report Contents in

View a report.

The report will include parameter limits, execution time, and any testspecific comments generated during the test.

M-PHY Receiver Automated Test Solution Printable Application Help 37

Setting up and configuring tests

Setting Description

Include Setup Configuration

Include Complete Application Configuration

Include User Comments

View Report After Generating

Information about hardware and software used in the test will be included in the summary box at the top of the report. Information includes: the oscilloscope model and serial number, probe model and serial number, AWG model and serial number, firmware version for the oscilloscope and AWG, SPC and factory calibration status, and software versions for applications used in the measurements.

A table listing general, common, and acquired parameters used in the test will be included in the report. This option is disabled by default.

Select to include any comments about the test that you or another user added in the DUT tab of the Setup panel. Comments appear in the Comments section under the summary box at the beginning of each report.

Automatically opens the report in your Web browser when the test completes. This option is selected by default.

See also

Auto calibration

View a report

About setting up tests

The auto calibration function addresses receiver calibration requirements for the M PHY standard. Auto calibration compensates the patterns for specific jitter parameters (ISI, Random Jitter - RJ, Sinusoidal Jitter - SJ and Voltage).

The procedure sequences through all the patterns, with each pattern calibrated independently. These values are used for the jitter-controlled generation of patterns which will be injected into the DUT during loopback.

The design engineer needs to ensure that the amount of jitter components (also known as target impairments) meets the compliance test specification.

To perform the calibration, the application varies the target parameter through a predefined range and a uniform step size and computes the transfer function between the measured and input values.

The signal generation for calibration is done using an AWG. The measurement methodology is DPOJET as per the CTS.

The calibration results can be viewed at any time as values or graphical plots. The application uses an appropriate polynomial fit algorithm for all the target values which gives the characteristic curve. The respective calibrated values are derived from the characteristic curve.

The orange square icons on the calibration graph plot represent the measured jitter values.

38 M-PHY Receiver Automated Test Solution Printable Application Help

Setting up and configuring tests

See also. Auto calibration setup diagrams

Auto calibration wizard overview

Auto calibration wizard

overview

The Auto calibration wizard lets you:

■

Auto-calibrate the M PHY RX signal with the help of an AWG and oscilloscope running TekExpress

■

Specify the calibration constants, standards, and custom parameters

■

Perform auto calibration for Inter Symbol Interference (ISI), Random Jitter (RJ), Periodic Jitter (PJ) or Sinuosoidal jitter (SJ) and voltage

■

Generate and view the calibration report

Table 10: Calibration table parameters

Parameter Description

ISI For the 2.1.2 HS-RX Accumulated Differential Input Voltage Tolerance

test, the test signal is expected to have 0.2 UI of ISI. This is realized in most part by the traces to the Rx pins. If additional software ISI is needed, this parameter can be used.

RJ The random jitter component is calibrated using this parameter. Two

RJ components are indirectly specified: Random Jitter and short term RJ.

SJ The sinusoidal jitter component is calibrated using this parameter.

Deterministic Jitter (DJRX) and Short Term Total Jitter (STTJRX) are calibrated using SJ at various frequencies.

Voltage This entry represents the parameter Accumulated Differential Input

Voltage Tolerance (V

DIF-ACC-HS-RX

Filter. This setting specifies the frequency in MHz which is applicable to the following parameters:

■

Periodic Jitter: Specifies the jitter frequency.

■

Random Jitter: Specifies the High frequency limit of the RJ components; this is useful in specifying STRJ.

Pattern. This setting specifies the test pattern (CJTPAT), to be used for calibrating this parameter.

M-PHY Receiver Automated Test Solution Printable Application Help 39

Setting up and configuring tests

Jitter specification. The HS-RX jitter specification is shown in the following table.

Table 11: Jitter specifications

Parameter Max value

STRJ

STDJ

DIF-ACC-HS-RX

0.1 UI

0.17 UI

0.20 UI

0.35 UI

40 mV

Running tests and viewing results

About running tests

After selecting and configuring the test, review the pre-run checklist and then click Start to run the tests. While tests are running, you cannot access the Setup or Reports panels. To monitor the test progress, switch back and forth between the Status panel and the Results panel.

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 M-PHY Rx application on top, select Keep On Top from the MPHY Rx Options menu.

See also

Before you click start

About configuring tests

About setting up tests

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 M-PHY Rx, it creates the following folders on the oscilloscope:

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.

■

\Program Files\Tektronix\TekExpress\TekExpress M-PHY Rx

NOTE. This application will work only on machines with the Windows 7 operating system.

■

\My Documents\My TekExpress\M-PHY Rx

■

\My Documents\My TekExpress\M-PHY Rx\Untitled Session

M-PHY Receiver Automated Test Solution Printable Application Help 49

Running tests and viewing results

Every time you launch TekExpress M-PHY Rx, an Untitled Session folder is created in the M-PHY Rx folder. The Untitled Session folder is automatically deleted when you exit the M-PHY Rx application.

2. Map the shared My TekExpress folder as X: (X drive) on all instruments used in test setup running Microsoft Windows Operating System.

The My TekExpress folder has the shared name format <domain><user ID>My TekExpress. Or, if the instrument is not connected to a domain, then the shared name format is <instrument name><user ID>My TekExpress. This shared folder is used to save the test session files and is used during any 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 that the My TekExpress folder has read and write access and that the contents are not set to be encrypted:

a. Right-click 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. Review the pre-run checklist before you run a test.

50 M-PHY Receiver Automated Test Solution Printable Application Help

Running tests and viewing results

See also

Pre-Run checklist

View test-related files

Application directories and usage

File name extensions

Do the following before you click Start to run a test. If this is the first time you are running a test for 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.

3. Perform deskew on any cables.

4. Verify that the application is able to find the DUT. If it cannot, perform a

search for connected instruments

a. Launch the M-PHY Rx application.

See also

b. Select the Setup panel, click the Test Selection tab. 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

the listed instruments and make sure that the DUT is listed.

Equipment connection setup

M-PHY Receiver Automated Test Solution Printable Application Help 51

Running tests and viewing results

View the progress of analysis

The Status panel displays a record of the test as it is executed. By default, the application switches to this panel after you click the Start button to run a test. Choose from the following two views by selecting the named tab, even while a test is in progress.

Test status

The Test Status tab presents a collapsible table with information about each test as it is running.

Table 12: Status tab table

Column Description

Test Name Name of the test

Analysis Status Progress state of the analysis:

■

To be started

■

In progress

■

Completed

■

Aborted

Log view

The Log View tab provides a list of actions that happen as the test executes. Use this tab to review or troubleshoot tests.

Table 13: Log View options

Item Description

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.

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 in the Message History window.

Save Use to save the log file as a text file for examination. Displays a standard

Save File window and saves the status messages in the file that you specify.

52 M-PHY Receiver Automated Test Solution Printable Application Help

Running tests and viewing results

See also

View test results

When a test finishes, the application switches to the Results panel, which displays a summary of 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 will be Pass. If even one test out of multiple tests fails, the overall test result will show Fail.

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 following ways:

■

To expand all tests listed, select View Results Details from the Preferences menu in the upper right corner.

■

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.

See also

■

To enable or disable the wordwrap feature, select Preferences > Enable Wordwrap.

■

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 drag the column to the desired width.

■

To sort the test information by column, click the column head. When sorted in ascending order, a small up arrow is displayed. When sorted in descending order, a small down arrow is displayed.

■

To clear all test results displayed, click Clear.

View a report

View the progress of analysis

M-PHY Receiver Automated Test Solution Printable Application Help 53

Running tests and viewing results

View a report

After the analysis, a report is automatically generated. By default, the report is displayed in your 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 if you want to view a different test report, do the following:

1. In the Reports panel, click the Browse button and locate the desired report.

The path to the report displays in the Report Name field.

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. At the bottom of the Reports panel, click View.

For information on changing the file type, file name, and other report options, see

Select report options.

Report Contents

In the report, a table shows the test name, measurement details, test result (pass/ fail), mode, and analysis time.

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, probe model and serial number, and software versions. To exclude this information from the report, clear the Include Setup Configuration check box in the Reports panel before running the test.

DUT comments

If you selected to include comments in the test report, any comments you added in the DUT tab of the Setup panel appear in the Comments section directly below the summary box.

54 M-PHY Receiver Automated Test Solution Printable Application Help

Running tests and viewing results

Pass/Fail summary

The Pass/Fail Summary 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 the report, clear the Include Pass/Fail Results Summary check box in the Reports panel before running the test.

Detailed results

Includes detailed measurement information, as shown in the example. The Comments column is for test-specific information; for example, if the test had to be aborted, the reason is listed in the Comments column. To exclude this information from the report, clear the Include Detailed Results check box in the Reports panel before running the test.

Application configuration

This table lists general, common, and acquired parameters used in the test. General parameters are those selected to be included in all tests (where applicable). General parameters are set in the DUT tab. By default, this is not selected for inclusion in the test. To include this information in the report, select the Include Complete Application Configuration check box before running the test.

M-PHY Receiver Automated Test Solution Printable Application Help 55

Running tests and viewing results

See also

View test-related files

View test results

View test-related files

Files related to tests are stored in the M-PHY Rx folder under the My TekExpress shared folder. In the M-PHY Rx folder, each test setup has a test setup file and a test setup folder, both with the test setup name. The test setup file is preceded by the M-PHY Rx icon and usually has no visible file extension. For example,

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 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.

56 M-PHY Receiver Automated Test Solution Printable Application Help

Running tests and viewing results

The first time you run a new, unsaved session, the session files are stored in the Untitled Session folder located at ..\My TekExpress\M-PHY Rx. When you name and save the session, the files are placed in a folder with the name that you specify.

See also

File name extensions

M-PHY Receiver Automated Test Solution Printable Application Help 57

Running tests and viewing results

58 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

About the programmatic interface

The Programmatic interface allows you to seamlessly integrate the TekExpress test automation application with the high-level automation layer. This also allows you to control the state of the TekExpress application running on a local or a remote computer.

For simplifying the descriptions, the following terminologies are used in this section:

■

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. TekExpress provides a client library for TekExpress clients to use the programmatic interface. The 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.

M-PHY Receiver Automated Test Solution Printable Application Help 59

TekExpress programmatic interface

See also

Requirements for developing tekExpress client

Remote proxy object

Client proxy object

Requirements for developing TekExpress client

While developing the 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 Samples folder.

■

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.

Required steps for a client

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.

The following steps are used by the client to programmatically control the server using TekExpressClient.dll:

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.

60 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

See also

Remote proxy object

About M-PHY Rx application commands

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.

The following is an example:

RemotingConfiguration.RegisterWellKnownServiceType (typeof (TekExpressRemoteInterface), “TekExpress Remote interface”, WellKnownObjectMode.Singleton);

This object lets the remote client access the interfaces exposed at the server side. The client gets the reference to this object when the client gets connected to the server.

For example,

//Get a reference to the remote object

remoteObject = (IRemoteInterface)Activator.GetObject(typeof(IRemoteInterface), URL.ToString());

M-PHY Receiver Automated Test Solution Printable Application Help 61

TekExpress programmatic interface

Client proxy object

Client exposes a proxy object to receive certain information.

For example,

//Register the client proxy object

WellKnownServiceTypeEntry[] e = RemotingConfiguration.GetRegisteredWellKnownServiceTypes();

clientInterface = new ClientInterface();

RemotingConfiguration.RegisterWellKnownServiceType(typeof(ClientInterface) , “Remote Client Interface”, WellKnownObjectMode.Singleton);

//Expose the client proxy object through marshalling

RemotingServices.Marshal(clientInterface, "Remote Client Inteface");

The client proxy object is used for the following:

■

To get the secondary dialog messages from the server.

■

To get the file transfer commands from the server while transferring the report.

Examples

clientObject.clientIntf.DisplayDialog(caption, msg,iconType, btnType);

clientObject.clientIntf.TransferBytes(buffer, read, fileLength);

For more information, click the following links:

Secondary dialog message handling

62 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

The secondary 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

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

An example of the client programmatic interface is described and shown as follows:

M-PHY Receiver Automated Test Solution Printable Application Help 63

TekExpress programmatic interface

1. Connect to a server or remote object using the programmatic interface provided.

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.

64 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

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.

5. Select the tests 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.

Handler of Status Change

Notification

See also

NOTE. Skip this step if you are registered for the status change notification and the status is Ready.

9. After completing the tests, get the results.

10. Create a report or display the results and verify or process the results.

11. Unlock the server after completing all the tasks.

12. Disconnect from the remote object.

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.

About M-PHY Rx application commands

Program example

M-PHY Receiver Automated Test Solution Printable Application Help 65

TekExpress programmatic interface

Program example

This program example shows how to communicate between a PC and TekExpress M-PHY Rx remotely.

A typical application does the following:

1. Start the application.

2. Connect through an IP address.

m_Client.Connect("localhost") 'True or False

clientID = m_Client.getClientID

3. Lock the server.

m_Client.LockServer(clientID)

4. Disable the Popups.

m_Client.SetVerboseMode(clientID, false)

5. Set the Dut ID.

m_Client.SetDutId(clientID, "DUT_Name")

6. Select a measurement.

mClient.SelectTest(clientID, "Receiver", "HS", "2.1.1 - Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", true)

7. Select a channel.

mClient.SetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", "Scope Channel for Trigger$CH1")

8. Configure the selected measurement.

mClient.SetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", Loopback validation required$Always)'Set loopback validation to Always

mClient.SetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", HS Gear 1A$Include) 'Select Gear 1A

9. Run with set configurations.

m_Client.Run(clientID)

10. Wait for the test to complete.

Thread.Sleep(500)

m_Client.Application_Status(clientID)

Select Case status

Case "Wait"

66 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

'Get the Current State Information

mClient.GetCurrentStateInfo(clientID, WaitingMsbBxCaption, WaitingMsbBxMessage, WaitingMsbBxButtontexts)

'Send the Response

mClient.SendResponse(clientID, WaitingMsbBxCaption, WaitingMsbBxMessage, WaitingMsbBxResponse)

End Select

Loop Until status = "Ready"

11. After the Test is Complete.

'Save all results values from folder for current run

m_Client.TransferResult(clientID, logDirname)

12. Unlock the server.

m_Client.UnlockServer(clientID)

13. Disconnect from server.

m_Client.Disconnect()

14. Exit the application.

M-PHY Rx application commands

About M-PHY Rx

application commands

Click a client action below to see the command name, description, parameters, return value, and an example, associated with the action.

Connect through an IP address

Lock the server

Disable the popups

Set or get the DUT ID

Set the configuration parameters for a suite or measurement

Query the configuration parameters for a suite or measurement

Select a measurement

Select a suite

Select a channel

Configure the selected measurement

Handle Error Codes

Get or set the timeout value

Wait for the test to complete

M-PHY Receiver Automated Test Solution Printable Application Help 67

TekExpress programmatic interface

After the test is complete

Save, recall, or check if a session is saved

Unlock the server

Disconnect from server

string id

Name Type Direction Description

id string IN Identifier of the client

performing the remote function

Ready: Test configured and ready to start

Running: Test running

Paused: Test paused

Wait: A popup that needs your inputs

Error: An error is occurred

string dutName

Name Type Direction Description

dutName string IN The new DUT ID of the

setup

out bool saved

Name Type Direction Description

saved bool OUT Boolean representing

whether the current session is saved

This parameter is used as a check in SaveSession() and SaveSessionAs() functions.

string ipAddress

Name Type Direction Description

ipAddress string IN The ip address of the

server to which the client is trying to connect. This is required to establish the connection between the server and the client.

68 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

out string clientID

Name Type Direction Description

clientid string OUT Identifier of the client

that is connected to the server clientId = unique number + ipaddress of the client. For example, 1065–192.157.98.70

NOTE. If the dutName parameter is null, the client is prompted to provide a valid DUT ID.

NOTE. The server must be active and running for the client to connect to the server. Any number of clients can be connected to the server at a time.

NOTE. When the client is disconnected, it is unlocked from the server and then disconnected. The id is reused.

string dutId

Name Type Direction Description

dutId string OUT The DUT ID of the

setup

The dutId parameter is set after the server processes the request.

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

M-PHY Receiver Automated Test Solution Printable Application Help 69

TekExpress programmatic interface

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

int rowNr

Name Type Direction Description

rowNr int IN Specifies the zero

based row index of the sub-measurement for obtaining the result value

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.

out string[] status

Name Type Direction Description

status string array OUT The list of status

messages generated during the run

string name

Name Type Direction Description

name string IN The name of the

session being recalled

The name parameter cannot be empty. If it is empty, the client is prompted to provide a valid name.

NOTE. When the run is performed, the status of the run is updated periodically using a timer.

70 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

string name

Name Type Direction Description

name string IN The name of the

session being saved

The name parameter cannot be empty. If it is empty, the client is prompted to provide a valid 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

Name Type Direction Description

name string IN The name of the

session being recalled

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

Name Type Direction Description

isSelected bool IN Selects or deselects a

test

string time

Name Type Direction Description

time string IN The time in seconds

that refers to the timeout period

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

Name Type Direction Description

_verbose bool IN Specifies whether the

verbose mode should be turned ON or OFF

M-PHY Receiver Automated Test Solution Printable Application Help 71

TekExpress programmatic interface

NOTE. When the session is stopped, the client is prompted to stop the session and is stopped at the consent.

string filePath

Name Type Direction Description

filePath string IN The location where the

report must be saved in the client

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 caption

Name Type Direction Description

caption string OUT The wait state or error

state message sent to you

out string message

Name Type Direction Description

message string OUT The wait state/error

state message sent to you

out string[] buttonTexts

Name Type Direction Description

buttonTexts string array OUT An array of strings

containing the possible response types that you can send

72 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

string response

Name Type Direction Description

response string IN A string containing the

response type that you can select (it must be one of the strings in the string array buttonTexts)

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065–192.157.98.70

Connect through an IP

address

Command name Parameters Description Return value Example

Connect() string ipAddress

out string clientID

This method connects the client to the server. Note The client provides the IP address to connect to the server. The server provides a unique client identification number when connected to it.

Return value is either True or False

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as boolean returnval = m_Client.Connect( ipaddress,m_client ID)

string ipAddress

Name Type Direction Description

ipAddress string IN The ip address of the

server to which the client is trying to connect. This is required to establish the connection between the server and the client.

M-PHY Receiver Automated Test Solution Printable Application Help 73

TekExpress programmatic interface

out string clientID

Name Type Direction Description

clientid string OUT Identifier of the client

that is connected to the server clientId = unique number + ipaddress of the client. For example, 1065-192.157.98.70

NOTE. The server must be active and running for the client to connect to the server. Any number of clients can be connected to the server at a time.

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".

Lock the server

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 none of these fail conditions occur, then the message displayed is "Failed...".

Command name Parameters Description Return value Example

LockSession() string clientID This method locks

the server. Note The client must call this method before running any of the remote automations. The server can be locked by only one client.

String value that gives the status of the operation after it has been performed The return value is "Session Locked...” on success.

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string returnval = m_Client.LockServ er(clientID)

74 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

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 none of these fail conditions occur, then the message displayed is "Failed...".

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065+192.157.98.70

M-PHY Receiver Automated Test Solution Printable Application Help 75

TekExpress programmatic interface

Disable the popups

Command name Parameters Description Return value Example

SetVerboseMode() string clientID

bool _verbose

This method sets the verbose mode to either true or false. When the value is set to true, any message boxes that appear during the application will be routed to the client machine that is controlling TekExpress. When the value is set to false, all the message boxes are shown on the server machine.

String that gives the status of the operation after it has been performed When Verbose mode is set to true, the return value is “Verbose mode turned on. All dialog boxes will be shown to client”. When Verbose mode is set to false, the return value is “Verbose mode turned off. All dialog boxes will be shown to server”.

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string

Verbose mode is turned on

return=m_Client.S etVerboseMode(cli entID, true)

Verbose mode is turned off

returnval=m_Clien t.SetVerboseMod e(clientID, false)

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065+192.157.98.70

bool_verbose

Name Type Direction Description

_verbose bool IN Specifies whether the

verbose mode should be turned ON or OFF

76 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

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 none of these fail conditions occur, then the message displayed is "Failed...".

Set or get the DUT ID

Command name Parameters Description Return value Example

SetDutId() string clientID

string dutName

GetDutId() string clientID

string dutId

This method changes the DUT ID of the setup. The client must provide a valid DUT ID.

This method gets the DUT ID of the current setup.

String that gives the status of the operation after it has been performed Return value is “DUT Id Changed” on success

String that gives the status of the operation after it has been performed

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string return=m_Client.S etDutId(clientID,de siredDutId) Note

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string return=m_Client.G etDutid(clientID, out DutId)

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

M-PHY Receiver Automated Test Solution Printable Application Help 77

TekExpress programmatic interface

string dutName

Name Type Direction Description

dutName string IN The new DUT ID of the

setup

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192. 157.98.70

string dutID

Name Type Direction Description

dudID string OUT The DUT ID of the

setup

NOTE. If the dutName parameter is null, the client is prompted to provide a valid DUT ID.

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 none of these fail conditions occur, then the message displayed is "Failed...".

78 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

Set the configuration

parameters for a suite or

measurement

Command name Parameters Description Return value Example

SetGeneralParam eter

SetAnalyzeParam eter()

SetAcquireParame ter()

string clientID string device string suite string test string parameterString

This method sets the number of video lanes for the selected measurement.

NOTE. Use this command to select a lane, channel, or source type.

This method sets the configuration parameters in the Analyze panel of the Configuration Panel dialog box for a given suite or measurement.

This method sets the configuration parameters in the Acquire panel of the Configuration Panel dialog box for a given suite or measurement.

String that gives the status of the operation after it has been performed The return value is "" (an empty String) on success.

The return value is "" (an empty String) on success.

returnVal = remoteObject.Set AcquireParameter( id, device, suite, test, parameterString) if ((OP_STATUS) returnVal != OP_STATUS.SUC CESS) return CommandFailed(r eturnVal)

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string Select Channel Select Measurement Method

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL . returnval as string

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

M-PHY Receiver Automated Test Solution Printable Application Help 79

TekExpress programmatic interface

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

80 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

M-PHY Receiver Automated Test Solution Printable Application Help 81

TekExpress programmatic interface

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 none of these fail conditions occur, then the message displayed is "Failed...".

Select Channel Example

returnval=mClient.SetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", "Scope Channel for Trigger$CH1")

Select Loopback Validation Method Example

Query the configuration

parameters for a suite or

measurement

returnval=mClient.SetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (VDIF-DC-RX)", Loopback validation required$Always)

Command name Parameters Description Return value Example

GetGeneralParam eter()

GetAnalyzeParam eter()

GetAcquireParam eter()

string clientID string device string suite string test string parameterString

This method gets the general configuration parameters for a given suite or measurement.

This method gets the configuration parameters set in the Analyze panel of the Configuration Panel dialog box for a given suite or measurement.

This method gets the configuration parameters set in the Acquire panel for a given suite or measurement.

The return value is the general configuration parameter for a given suite or measurement that is set.

The return value is the configuration parameter set in the Analyze panel of the Configuration Panel dialog box for a given suite or measurement.

The return value is the configuration parameter set in the Acquire panel for a given suite or measurement.

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string Query Channel Query Loopback Validation Method

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL . returnval as string

82 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

M-PHY Receiver Automated Test Solution Printable Application Help 83

TekExpress programmatic interface

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

84 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

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 none of these fail conditions occur, then the message displayed is "Failed...".

Query Channel for Trigger Example

returnval = mClient.GetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (V

DIF-DC-RX

)", "Scope

Channel for Trigger")

Query Loopback Validation Method Example

returnval=mClient.GetGeneralParameter(clientID, "Receiver", "HS", "2.1.1 Differential DC Input Voltage Amplitude Tolerance (V

DIF-DC-RX

)", Loopback

validation required)

M-PHY Receiver Automated Test Solution Printable Application Help 85

TekExpress programmatic interface

Select a measurement

Command name Parameters Description Return value Example

SelectTest() string clientID

string device string suite string test bool isSelected

This method selects or deselects a given test. If this Setting parameter is set to true, you can select a measurement. If this Setting parameter is set to false, you can deselect a measurement.

String that displays the status of the operation after it has been performed The return value is "" (an empty String) on success.

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL returnval as string

Select Measurement

2.1.1 – Differential Input Voltage Amplitude Tolerance (VDIFRX):

returnval = mClient.SelectTes t(clientID, "Receiver", "HS", "2.1.1 - Differential DC Input Voltage Amplitude Tolerance (V

DIF-DC-RX

)", true)

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

86 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

bool isSelected

Name Type Direction Description

isSelected bool IN Selects or deselects a

test

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".

Select a suite

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...".

Command name Parameters Description Return value Example

SelectSuite() string clientID

string device string suite bool isSelected

This method selects or deselects a given suite. When this parameter is set to true, you can select a suite. When this parameter is set to false, you can deselect a suite.

String that gives the status of the operation after it has been performed The return value is "" (an empty String) on success.

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string

Select Suite (Default):

returnval=mClient. SelectSuitet(clientI D, "Receiver", "HS", true)

M-PHY Receiver Automated Test Solution Printable Application Help 87

TekExpress programmatic interface

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

bool isSelected

Name Type Direction Description

isSelected bool IN Selects or deselects a

test

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 none of these fail conditions occur, then the message displayed is "Failed...".

88 M-PHY Receiver Automated Test Solution Printable Application Help

TekExpress programmatic interface

Select a channel

Command name Parameters Description Return value Example

SetGeneralParam eter()

SetAnalyzeParam eter()

SetAcquireParame ter()

string clientID string device string suite string test string parameterString

This method sets the parameters that are not specific to any given test.

NOTE. Using this command we can select a lane, channel, or source type.

This method sets the configuration parameters in the Analyze panel of the Configuration Panel dialog box for a given suite or measurement.

This method sets the configuration parameters in the Acquire panel of the Configuration Panel dialog box for a given suite or measurement.

String that gives the status of the operation after it has been performed The return value is "" (an empty String) on success.

The return value is "" (an empty String) on success.

returnVal = remoteObject.Set AcquireParameter( id, device, suite, test, parameterString) if ((OP_STATUS) returnVal != OP_STATUS.SUC CESS) return CommandFailed(r eturnVal)

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string Select Channel for Trigger Select Loopback Validation Method

m_Client = new Client() //m_Client is a reference to the Client class in the Client DLL. returnval as string

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

M-PHY Receiver Automated Test Solution Printable Application Help 89

TekExpress programmatic interface

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

string parameterString

Name Type Direction Description

parameterString string IN Selects or deselects a

test

out string clientID

Name Type Direction Description

clientID string OUT Identifier of the client

that is connected to the server clientID = unique number + ipaddress of the client. For example, 1065 + 192.157.98.70

string device

Name Type Direction Description

device string IN Specifies the name of

the device

string suite

Name Type Direction Description

suite string IN Specifies the name of

the suite

string test

Name Type Direction Description

test string IN Specifies the name of

the test to obtain the pass or fail status

90 M-PHY Receiver Automated Test Solution Printable Application Help

Tektronix TekExpress M-PHY Receiver Automated Test Solution User manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

Welcome

Getting help and support

Related documentation

Conventions used in help

Technical support

Getting started

Installing the software

Compatibility

See Also. Minimum system requirements

Install the software

Activate the license

View license information

Introduction to the application

File name extensions

Operating basics

Start the application

Exit the application

Application controls and menus

Application controls

Options menu

Email settings

Panels

Saving and recalling test setups

About test setups

Save a test setup

Recall a saved test setup

Create a new test setup based on an existing one

Setting up and configuring tests

About setting up tests

Equipment connection setup

View connected instruments

Test setup overview

Select device parameters

Select a test

Configuring tests

About configuring tests

Configure tests

Common test parameters

Select test notification preferences

Select report options

Auto calibration

Auto calibration

Auto calibration wizard overview

Running tests and viewing results

About running tests

Before you click start

Pre-Run checklist

View the progress of analysis

View test results

View a report

View test-related files

TekExpress programmatic interface

About the programmatic interface

Requirements for developing tekExpress client

Remote proxy object

Client proxy object

Client programmatic interface example

Program example

M-PHY Rx application commands

Lock the server

Disable the popups

Set or get the DUT ID

Select a measurement

Select a suite

Select a channel