AMETEK Lx User Manual

Lx \ Ls Series II

AC Power Source

Programming Manual

Contact Information

Telephone: 800 733 5427 (toll free in North America) 858 450 0085 (direct) Fax: 858 458 0267 Email: Domestic Sales: domorders.sd@ametek.com International Sales: intlorders.sd@ametek.com Customer Service: service.ppd@ametek.com Web: www.programmablepower.com

March 2011 Document No. 7004-981 Rev. S

Refers to:

Lx Series AC Power Source/Analyzers - Series II

Ls Series AC Power Sources - Series II

Models:

Single chassis: 3000Lx, 4500Lx, 6000Lx Multiple chassis: 9000Lx/2, 12000Lx/2, 13500Lx/3, 18000Lx/3

Single chassis: 3000Ls, 4500Ls, 6000Ls Multiple chassis: 9000Ls/2, 12000Ls/2, 13500Ls/3, 18000Ls/3

Manual revision: S

About AMETEK

AMETEK Programmable Power, Inc., a Division of AMETEK, Inc., is a global leader in the design and manufacture of precision, programmable power supplies for R&D, test and measurement, process control, power bus simulation and power conditioning applications across diverse industrial segments. From bench top supplies to rack-mounted industrial power subsystems, AMETEK Programmable Power is the proud manufacturer of Elgar, Sorensen, California Instruments and Power Ten brand power supplies.

AMETEK, Inc. is a leading global manufacturer of electronic instruments and electromechanical devices with annualized sales of $2.5 billion. The Company has over 11,000 colleagues working at more than 80 manufacturing facilities and more than 80 sales and service centers in the United States and around the world.

Trademarks

AMETEK is a registered trademark of AMETEK, Inc. Other trademarks, registered trademarks, and product names are the property of their respective owners and are used herein for identification purposes only.

Notice of Copyright

Lx\Ls Series II AC Power Source, Programming Manual

Exclusion for Documentation

UNLESS SPECIFICALLY AGREED TO IN WRITING, AMETEK PROGRAMMABLE POWER, INC. (“AMETEK”):

(a) MAKES NO WARRANTY AS TO THE ACCURACY, SUFFICIENCY OR SUITABILITY OF ANY

TECHNICAL OR OTHER INFORMATION PROVIDED IN ITS MANUALS OR OTHER DOCUMENTATION.

(b) ASSUMES NO RESPONSIBILITY OR LIABILITY FOR LOSSES, DAMAGES, COSTS OR

EXPENSES, WHETHER SPECIAL, DIRECT, INDIRECT, CONSEQUENTIAL OR INCIDENTAL, WHICH MIGHT ARISE OUT OF THE USE OF SUCH INFORMATION. THE USE OF ANY SUCH INFORMATION WILL BE ENTIRELY AT THE USER’S RISK, AND

ALTHOUGH STEPS HAVE BEEN TAKEN TO MAINTAIN THE ACCURACY OF THE TRANSLATION, THE ACCURACY CANNOT BE GUARANTEED. APPROVED AMETEK CONTENT IS CONTAINED WITH THE ENGLISH LANGUAGE VERSION, WHICH IS POSTED AT WWW.PROGRAMMABLEPOWER.COM.

Date and Revision

March 2011 Revision S

Part Number

7004-981

Contact Information

Telephone: 800 733 5427 (toll free in North America) 858 450 0085 (direct) Fax: 858 458 0267 Email: sales@programmablepower.com service@programmablepower.com Web: www.programmablepower.com

This page intentionally left blank.

WARNING

Hazardous voltages may be present when covers are removed. Qualified personnel must use extreme caution when servicing this equipment. Circuit boards, test points, and output voltages also may be floating above (below) chassis ground.

WARNING

The equipment used contains ESD sensitive ports. When installing equipment, follow ESD Safety Procedures. Electrostatic discharges might cause damage to the equipment.

Important Safety Instructions

Before applying power to the system, verify that your product is configured properly for your particular application.

Only qualified personnel who deal with attendant hazards in power supplies, are allowed to perform installation and servicing.

Ensure that the AC power line ground is connected properly to the Power Rack input connector or chassis. Similarly, other power ground lines including those to application and maintenance equipment must be grounded properly for both personnel and equipment safety.

Always ensure that facility AC input power is de-energized prior to connecting or disconnecting any cable.

In normal operation, the operator does not have access to hazardous voltages within the chassis. However, depending on the user’s application configuration, HIGH VOLTAGES HAZARDOUS TO HUMAN SAFETY may be normally generated on the output terminals. The customer/user must ensure that the output power lines are labeled properly as to the safety hazards and that any inadvertent contact with hazardous voltages is eliminated.

Guard against risks of electrical shock during open cover checks by not touching any portion of the electrical circuits. Even when power is off, capacitors may retain an electrical charge. Use safety glasses during open cover checks to avoid personal injury by any sudden component failure.

Neither AMETEK Programmable Power Inc., San Diego, California, USA, nor any of the subsidiary sales organizations can accept any responsibility for personnel, material or inconsequential injury, loss or damage that results from improper use of the equipment and accessories.

SAFETY SYMBOLS

iii

Product Family: Lx\Lx Series II

Warranty Period: One Year

WARRANTY TERMS

AMETEK Programmable Power, Inc. (“AMETEK”), provides this written warranty covering the Product stated above, and if the Buyer discovers and notifies AMETEK in writing of any defect in material or workmanship within the applicable warranty period stated above, then AMETEK may, at its option: repair or replace the Product; or issue a credit note for the defective Product; or provide the Buyer with replacement parts for the Product.

The Buyer will, at its expense, return the defective Product or parts thereof to AMETEK in accordance with the return procedure specified below. AMETEK will, at its expense, deliver the repaired or replaced Product or parts to the Buyer. Any warranty of AMETEK will not apply if the Buyer is in default under the Purchase Order Agreement or where the Product or any part thereof:

is damaged by misuse, accident, negligence or failure to maintain the same as

specified or required by AMETEK;

is damaged by modifications, alterations or attachments thereto which are not

authorized by AMETEK;

is installed or operated contrary to the instructions of AMETEK; is opened, modified or disassembled in any way without AMETEK’s consent; or is used in combination with items, articles or materials not authorized by AMETEK.

The Buyer may not assert any claim that the Products are not in conformity with any warranty until the Buyer has made all payments to AMETEK provided for in the Purchase Order Agreement.

PRODUCT RETURN PROCEDURE

1. Request a Return Material Authorization (RMA) number from the repair facility (must be

done in the country in which it was purchased):

In the USA, contact the AMETEK Repair Department prior to the return of the

product to AMETEK for repair: Telephone: 800-733-5427, ext. 2295 or ext. 2463 (toll free North America)

858-450-0085, ext. 2295 or ext. 2463 (direct)

Outside the United States, contact the nearest Authorized Service Center

(ASC). A full listing can be found either through your local distributor or our website, www.programmablepower.com, by clicking Support and going to the Service Centers tab.

2. When requesting an RMA, have the following information ready:

Model number Serial number Description of the problem

NOTE: Unauthorized returns will not be accepted and will be returned at the shipper’s expense.

NOTE: A returned product found upon inspection by AMETEK, to be in specification is subject to

an evaluation fee and applicable freight charges.

Programming Manual Lx \ Ls Series II

Table of Contents

1. Introduction .......................................................................................................................................... 8

1.1 Documentation Summary ............................................................................................................... 8

1.2 Lx Series and Ls Series Differences............................................................................................... 9

1.3 Manual organization and format ................................................................................................... 10

1.4 Introduction to Programming ........................................................................................................ 10

2. Introduction to SCPI .......................................................................................................................... 12

2.1 Conventions Used in This Manual ................................................................................................ 12

2.2 The SCPI Commands and Messages .......................................................................................... 12

2.3 Using Queries ............................................................................................................................... 15

2.4 Coupled Commands ..................................................................................................................... 15

2.5 Structure of a SCPI Message ....................................................................................................... 15

2.6 SCPI Data Formats ....................................................................................................................... 18

3. System Considerations ..................................................................................................................... 20

3.1 IEEE-488 / GPIB Interface ............................................................................................................ 20

3.2 USB Interface ............................................................................................................................... 21

3.3 LAN Option ................................................................................................................................... 28

3.4 RS232C Serial Interface ............................................................................................................... 33

3.5 Instrument Drivers and Application Software ................................................................................ 34

4. SCPI Command Reference ................................................................................................................ 35

4.1 Introduction ................................................................................................................................... 35

4.2 Subsystem Commands................................................................................................................. 36

4.3 Calibration Subsystem .................................................................................................................. 37

4.4 Diagnostic Subsystem .................................................................................................................. 39

4.5 Display Subsystem ....................................................................................................................... 40

4.6 Instrument Subsystem .................................................................................................................. 42

4.7 Limit Subsystem ........................................................................................................................... 43

4.8 Array Measurement Subsystem ................................................................................................... 45

4.9 Current Measurement Subsystem ................................................................................................ 51

4.10 Frequency Measurement Subsystem ........................................................................................... 56

4.11 Power Measurement Subsystem .................................................................................................. 57

4.12 Voltage Measurement Subsystem ................................................................................................ 59

4.13 Output Subsystem ........................................................................................................................ 62

4.14 Power On Subsystem ................................................................................................................... 67

4.15 Sense Subsystem - Sweep ........................................................................................................... 69

4.16 Source Subsystem - Current ........................................................................................................ 71

4.17 Source Subsystem - Frequency.................................................................................................... 73

4.18 Source Subsystem - Function ....................................................................................................... 76

4.19 Source Subsystem - List ............................................................................................................... 79

4.20 Source Subsystem - Phase .......................................................................................................... 86

4.21 Source Subsystem - Pulse ........................................................................................................... 88

4.22 Source Subsystem - Voltage ........................................................................................................ 91

4.23 Status Subsystem Commands ..................................................................................................... 98

4.24 System Commands .................................................................................................................... 105

4.25 Trace Subsystem Commands .................................................................................................... 111

4.26 Trigger Subsystem ...................................................................................................................... 113

5. Common Commands ....................................................................................................................... 118

5.1 *CLS ............................................................................................................................................ 119

5.2 *ESR? ......................................................................................................................................... 119

5.3 *IDN? .......................................................................................................................................... 120

5.4 *OPC ........................................................................................................................................... 120

5.5 *OPT? ......................................................................................................................................... 120

5.6 *PSC ........................................................................................................................................... 120

Programming Manual Lx \ Ls Series II

5.7 *RCL ........................................................................................................................................... 121

5.8 *RST ........................................................................................................................................... 122

5.9 *SAV ........................................................................................................................................... 123

5.10 *SRE ........................................................................................................................................... 123

5.11 *STB?.......................................................................................................................................... 123

5.12 *TRG ........................................................................................................................................... 124

5.13 *TST? .......................................................................................................................................... 124

5.14 *WAI ............................................................................................................................................ 125

6. Programming Examples .................................................................................................................. 126

6.1 Introduction ................................................................................................................................. 126

6.2 Programming the Output ............................................................................................................ 126

6.3 Coupled Commands ................................................................................................................... 130

6.4 Programming Output Transients ................................................................................................ 131

6.5 Step and Pulse Transients .......................................................................................................... 132

6.6 List Transients ............................................................................................................................ 134

6.7 Triggering Output Changes ........................................................................................................ 135

6.8 Making Measurements ............................................................................................................... 139

6.9 Controlling the Instantaneous Voltage and Current Data Buffers ............................................... 144

6.10 Downloading Arbitrary Waveforms ............................................................................................. 148

6.11 Command Processing Times ..................................................................................................... 149

7. Programming the Status and Event Registers ............................................................................. 150

7.1 Power-On Conditions .................................................................................................................. 150

7.2 Operation Status Group .............................................................................................................. 150

7.3 Questionable Status Group ........................................................................................................ 153

7.4 Questionable Instrument Isummary Status Group ..................................................................... 154

7.5 Standard Event Status Group ..................................................................................................... 155

7.6 Status Byte Register ................................................................................................................... 156

7.7 Examples .................................................................................................................................... 157

7.8 Remote Inhibit and Discrete Fault Indicator ................................................................................ 160

7.9 SCPI Command Completion....................................................................................................... 161

8. Option Commands ........................................................................................................................... 162

8.1 Introduction ................................................................................................................................. 162

8.2 APE Command Language (Abbreviated Plain English) .............................................................. 163

8.3 ABLE Command Language (Atlas Based Language Extension)................................................ 183

8.4 RTCA/DO-160D (-160) ............................................................................................................... 188

8.5 RTCA/DO160 Rev E Test Option ............................................................................................... 195

8.6 MIL-STD 704 Rev D - F (-704) ................................................................................................... 196

8.7 MIL-STD 704 Rev A - F (-704F) ................................................................................................. 202

8.8 Airbus ABD0100.1.8 Test Option (-ABD) .................................................................................... 218

8.9 Airbus A350, ABD0100.1.8.1 Test Option (-A350) ..................................................................... 218

8.10 Airbus AMD24 Test Option (-AMD) ............................................................................................ 218

8.11 Boeing 787B3-0147 Test Option (-B787) ................................................................................... 218

Appendix A: SCPI Command tree .......................................................................................................... 219

Appendix B: SCPI Conformance Information ....................................................................................... 223

Appendix C: Error Messages ................................................................................................................. 226

Appendix D: iL Series / HP6834B Compatability ................................................................................. 231

Index .................................................................................................................................................. 234

Programming Manual Lx \ Ls Series II

Table of Figures

Figure 2-1: Partial Command Tree .............................................................................................................. 13

Figure 2-2: Command Message Structure .................................................................................................. 16

Figure 3-1: Windows XP Device Manager - USB Port ................................................................................ 26

Figure 3-2: LxGui Interface Settings for use of USB port. ........................................................................... 27

Figure 3-3: Pinging AC Source LAN IP address. ........................................................................................ 32

Figure 3-4: Position of LAN/RS232C selection jumper W2 on 7004-716-2 Range/Relay board. ............... 33

Figure 6-1: Model of transient system. ...................................................................................................... 132

Figure 6-2: Model of output trigger system................................................................................................ 136

Figure 6-3: Model of Measurement triggers. ............................................................................................. 142

Figure 6-4: Pre- and Post Event Triggering............................................................................................... 147

Figure 7-1: Status Register Model. ............................................................................................................ 151

Figure 7-2: SMA Connector Trigger Model. .............................................................................................. 159

Figure 8-1: APE Command Tree ............................................................................................................... 169

Table of Tables

Table 2-1: Command parameters Suffixes and Multipliers ......................................................................... 18

Table 3-1: LAN Setting screens. ................................................................................................................. 31

Table 4-1: PULSe:HOLD = WIDTh parameters ......................................................................................... 89

Table 4-2: PULSe:HOLD = DCYCle parameters ........................................................................................ 89

Table 4-3: Bit Configuration of Status Operation Registers ........................................................................ 99

Table 4-4: Bit Configuration of Questionable Registers ............................................................................ 100

Table 4-5: Bit Configuration of Questionable Instrument Summary Registers ......................................... 102

Table 5-1: Bit Configuration of Standard Event Status Enable Register ................................................... 119

Table 5-2 : factory-defined *RST states .................................................................................................... 122

Table 5-3: Bit Configuration of Status Byte Register ................................................................................. 124

Table 6-1: Command Processing Times. .................................................................................................. 149

Table 7-1: Operation Status registers ....................................................................................................... 150

Table 7-2: Bit Configurations of Status Registers ..................................................................................... 152

Table 7-3: Questionable Status registers .................................................................................................. 153

Table 7-4: Questionable Instrument Isummary Status registers ............................................................... 154

Table 8-1: APE to SCPI mode change commands ................................................................................... 163

Table 8-2: APE versus SCPI equivalent power initialization commands ................................................... 165

Table 8-3: APE language syntax program headers .................................................................................. 171

Table 8-4: APE Language TLK Arguments ............................................................................................... 173

Table 8-5: Example TALK responses for 3 phase systems ...................................................................... 179

Table 8-6: APE Status Byte Error Codes .................................................................................................. 181

Table 8-7: ABLE to SCPI mode change commands ................................................................................. 183

Table 8-8: ABLE languange synstax (-ABL option) ................................................................................... 186

Table 8-9: ABLE languange - Serial Poll Status Bytes. ............................................................................. 187

Table 8-10: MS704 Steady state frequency by group ............................................................................... 205

Table 8-11: SCPI error codes and messages. .......................................................................................... 231

Programming Manual Lx \ Ls Series II

1. Introduction

This instruction manual (P/N 7004-981) contains programming informationfor the Lx Series II and Ls Series II AC power sources. The Series II versions of the Lx and Ls Series are backward compatible with the Series I models. The Programming Manual for Series I models is CI P/N 7004-961 and is available for download at www.programmablepower.com.

Series II models are different from the original Lx/Ls Series in the following areas:

Standard USB interface has been added. Available 100Mbit Ethernet LAN interface has been added. (Option –LAN). The front panel graphic design has been enhanced for a more pleasing look. The Output D and E terminal block is no longer installed on the standard Lx and Ls units

unless the auxiliary output option –AX is installed. This makes the standard output terminal block more easily accessible.

No other functional differences exist between the Series I and Series II AC power sources. The RS232C interface is still available in addition to the USB interface.

The expression "AC source" as used in the manual also applies to the same series. You will find the following information in the rest of this manual:

Chapter 2 Introduction to SCPI Chapter 3 System Considerations Chapter 4 SCPI Command Reference Chapter 5 Common Commands Chapter 6 Programming Examples Chapter 7 Programming the Status and Event Registers Chapter 8 Options Appendix A SCPI command tree Appendix B SCPI conformance information Appendix C Error messages

1.1 Documentation Summary

The following document is related to this Programming Manual and may have additional helpful information for using the AC source.

User's Manual. P/N 7004-980 Includes specifications and supplemental characteristics, how

to use the front panel, how to connect to the instrument, and calibration procedures.

1.1.1 External References

SCPI References

The following documents will assist you with programming in SCPI:

Beginner's Manual to SCPI. Highly recommended for anyone who has not had previous

experience programming with SCPI.

Controller programming manuals: consult the documentation supplied with the IEEE-488

controller or IEEE-488 PC plug in card for information concerning general IEEE-488.2 conventions and concepts.

Programming Manual Lx \ Ls Series II

The following are two formal documents concerning the IEEE-488 interface:

ANSI/IEEE Std. 488.1-1987 IEEE Standard Digital Interface for Programmable

Instrumentation. Defines the technical details of the IEEE-488 interface. While much of the information is beyond the need of most programmers, it can serve to clarify terms used in this manual and in related documents.

ANSI/IEEE Std. 488.2-1987 IEEE Standard Codes, Formats, Protocols, and Common

Commands. Recommended as a reference only if you intend to do fairly sophisticated programming. Helpful for finding precise definitions of certain types of SCPI message formats, data types, or common commands.

The above two documents are available from the IEEE (Institute of Electrical and Electronics Engineers), 345 East 47th Street, New York, NY 10017, USA or via the web at www.ieee.org .

1.2 Lx Series and Ls Series Differences

The Lx Series and Ls Series of AC power sources are both based on the same AC power source hardware platform and share many common components. The differences are primarily in configuration and options. This manual covers both model series. Some commands listed may not apply to Ls Series AC sources without the –ADV option and / or –MODE option.

1.2.1 Firmware differences

The Lx Series is fully featured and supports all commands listed in the programming manual. The Ls Series provides most basic functions in its standard configurations. More advanced

features can be added by specifying the –ADV (advanced) option. If the –ADV option is installed, all commands listed in this programming manual are supported. If not, commands related to arbitrary waveforms and harmonic analysis measurements are not supported and will generate a “-113 Syntax Error” message.

1.2.2 Hardware differences

In addition to the firmware differences described, the following hardware differences exist between the standard Lx Ac source and the Ls AC source.

Lx has a 150V / 300 V rms output range pair. Optional ranges of 135/270 (-HV option)

and 200/400 (-EHV option) are available at time of order.

Ls has a 135 V / 270 V rms output range pair. Optional ranges of 156/312 (-HV option)

and 200/400 (-EHV option) are available at time of order.

The Lx rear panel connector labeling is compliant with the California Instruments iL Series

which it replaces and the HP/Agilent model 6834B. The Ls rear panel connector labeling is compliant with the California Instruments L Series. The Lx Series II comes standard with both GPIB, USB and RS232C interfaces. An

optional Ethernet interface (-LAN option) is available. The Ls Series II comes standard with USB and RS232C only. An optional GPIB interface

(-GPIB option) and Ethernet interface (-LAN option) is available.

Note: Both interfaces use the SCPI command syntax as described in the programming manual.

The Lx Series provides both three phase and single phase output modes which can be

selected from the front panel or over the bus.

Programming Manual Lx \ Ls Series II

The Ls Series provides either three phase (-3 models) or single phase (-1 models).

Three phase Ls Series sources may optionally be equipped with the –MODE option which

provides the same phase mode switching as the Lx Series.

1.3 Manual organization and format

All user documentation for AMETEK Programmable Power power sources is provided on CDROM in electronic format. (Adobe Portable Document Format) The required Adobe PDF viewer is supplied on the same CDROM. This manual may be printed for personal use if a hardcopy is desired. To request a hardcopy from AMETEK Programmable Power, contact customer service at

service@programmablepower.com. There will be an additional charge for printed manuals.

This manual contains sections on programming the Lx or Ls Series over the bus. The Lx Series is equipped with GPIB, USB and RS232C interfaces. The Ls Series is equipped with a USB and RS232C interface. An optional GPIB interface can be specified at the time of order. Refer to the Lx / Ls Series User manual for information on using the remote control interface and command syntax. The user manual (P/N 7004-980) is provided on the same CDROM as this user manual.

AMETEK Programmable Power may make updated versions of this manual available from time to time in electronic format through it‟s website. To obtain an updated manual revision if available, check the California Instruments Manual download page at www.programmablepower.com. You need to register as a customer to obtain free access to manual and software downloads.

1.4 Introduction to Programming

This section provides some general information regarding programming instrumentation and available interface types.

1.4.1 IEEE-488 Capabilities of the AC source

All AC source functions except for setting the IEEE-488 address are programmable over the IEEE-488. The IEEE 488.2 capabilities of the AC source are listed in Chapter 2 of the User's Manual. The Lx Series offers standard IEEE-488 interface. The Ls Series requires the –GPIB option.

The AC source operates from an IEEE-488 address that is set from the front panel. To set the IEEE-488 address, press the MENU key on the front panel repeatedly until the CONFIGURATION entry is shown on the LCD display.

Move the indicator on the right hand side of the display to point to CONFIGURATION and press the ENTER key.

This will display the IEEE ADRRESS currently set. To change the address, use the Voltage knob to increment or decrement the value. Press the ENTER key to confirm your selection.

To set up the GPIB/IEEE-488 interface on a Windows XP PC, refer to section 3.1, “IEEE-488 / GPIB Interface”.

Programming Manual Lx \ Ls Series II

1.4.2 USB Capabilities of the AC source

All AC source functions are programmable over the USB interface. The USB capabilities of the AC source are listed in Chapter 2 of the User's Manual. Some capabilities support on the GPIB interface such as ATN, GET and SRQ interrupts do not apply to the USB interface. The USB interface operates internally at a fixed baudrate of 460800 baud but USB 2.0 burst transfer rates are supported.

To set up the USB interface on a Windows XP PC, refer to section 3.2, “ USB Interface”. The USB interface may be used to install updated firmware for the Lx / Ls controller if needed.

Firmware updates and a Flash Loader utility program and instructions are available from the AMETEK Programmable Power website for this purpose. (www.programmablepower.com )

Multiple USB connections to same PC:

The Windows driver used to interface to the power source‟s USB port emulates a serial com port.

This virtual com port driver is unable to reliable differentiate between multiple units however so the use of more than one AC power source connected to the same PC via USB is not recommended. Use of the GPIB interface is recommended for these situations.

1.4.3 LAN Capabilities of the AC source

All AC source functions are programmable over the LAN (Ethernet) interface if the –LAN option is installed. The LAN capabilities of the AC source are listed in Chapter 2 of the User's Manual. Some capabilities support on the GPIB interface such as ATN, GET and SRQ interrupts do not apply to the LAN interface. The LAN interface operates internally at a fixed baudrate of 460800 baud but autodetection of 10Base-T, 100Base-T and 1000Base-T is supported.

To set up the LAN interface on a Windows XP PC, refer to section 3.3, “LAN Option”.

1.4.4 RS232C Capabilities of the AC source

All AC source functions are programmable over the RS232C interface. The RS232C capabilities of the AC source are listed in Chapter 2 of the User's Manual. Some capabilities support on the GPIB interface such as ATN, GET and SRQ interrupts do not apply to the RS232C interface. Baudrates from 9600 to 115200 are supported.

To set up the RS232C interface, refer to section 3.4, “RS232C Serial Interface”. The RS232C interface may be used to install updated firmware for the Lx / Ls controller if needed.

Firmware updates and a Flash Loader utility program and instructions are available from the AMETEK Programmable Power website for this purpose. (www.programmablepower.com )

Programming Manual Lx \ Ls Series II

2. Introduction to SCPI

SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling instrument functions over the IEEE-488. SCPI is layered on top of the hardware-portion of IEEE 488.2. The same SCPI commands and parameters control the same functions in different classes of instruments.

2.1 Conventions Used in This Manual

Angle brackets <> Items within angle brackets are parameter abbreviations. For

example, <NR1> indicates a specific form of numerical data.

Vertical bar | Vertical bars separate alternative parameters. For example,

NORM | TEXT indicates that either "TEXT" or "NORM" can be used as a parameter.

Square Brackets [] Items within square brackets are optional. The representation

[SOURce:]LIST means that SOURce: may be omitted.

Braces {} Braces indicate parameters that may be repeated zero or more

times. It is used especially for showing arrays. The notation <A> <,B> shows that parameter "A" must be entered, while parameter "B" may be omitted or may be entered one or more times.

2.2 The SCPI Commands and Messages

2.2.1 Types of SCPI Commands

SCPI has two types of commands, common and subsystem.

Common commands generally are not related to specific operation but to

controlling overall AC source functions, such as reset, status, and synchronization. All common

commands consist of a three-letter mnemonic preceded by an asterisk: *RST, *IDN?, *SRE 8

Subsystem commands perform specific AC source functions. They are organized

into an inverted tree structure with the "root" at the top. Some are single commands while others are grouped within specific subsystems.

Refer to appendix A for the AC source SCPI tree structure.

2.2.2 Types of SCPI Messages

There are two types of SCPI messages, program and response.

A program message consists of one or more properly formatted SCPI commands sent from

the controller to the AC source. The message, which may be sent at any time, requests the AC source to perform some action.

A response message consists of data in a specific SCPI format sent from the AC source to

the controller. The AC source sends the message only when commanded by a program message called a "query."

Programming Manual Lx \ Ls Series II

Root

:OUTPut

:COUPling

:DFI

:PROTection

:OPERation

:SOURce

:CLEar :DELay

:STATus

[:STATe]

[:EVEN]? :CONDition?

2.2.3 The SCPI Command Tree

As previously explained, the basic SCPI communication method involves sending one or more properly formatted commands from the SCPI command tree to the instrument as program messages. Figure 2-1 shows a portion of a subsystem command tree, from which you access the commands located along the various paths (you can see the complete tree in appendix A).

Figure 2-1: Partial Command Tree

The Root Level

Note the location of the ROOT node at the top of the tree. Commands at the root level are at the top level of the command tree. The SCPI interface is at this location when:

the AC source is powered on a device clear (DCL) is sent to the AC source the SCPI interface encounters a message terminator (LF) the SCPI interface encounters a root specifier (:)

Active Header Path

In order to properly traverse the command tree, you must understand the concept of the active header path. When the AC source is turned on (or under any of the other conditions listed above), the active path is at the root. That means the SCPI interface is ready to accept any command at the root level, such as OUTPut or STATe.

If you enter OUTPut, the active header path moves one colon to the right. The interface is now ready to accept :STATe, :COUPling,:DFI, or :PROTection as the next header. You must include the colon, because it is required between headers.

If you now enter :PROTection, the active path again moves one colon to the right. The interface is now ready to accept either :CLEar or :DELay as the next header.

If you now enter :CLEar, you have reached the end of the command string. The active header path remains at :CLEar. If you wished, you could have entered :CLEar;DELay 20 and it would be accepted as a compound message consisting of:

1. OUTPut:PROTection:CLEAr and

Programming Manual Lx \ Ls Series II

2. OUTPut:PROTection:DELay 20. The entire message would be: OUTPut:PROTection:CLEar;DELay 20 The message terminator after DELay 20 returns the path to the root.

The Effect of Optional Headers

If a command includes optional headers, the interface assumes they are there. For example, if you enter OUTPut OFF, the interface recognizes it as OUTPut:STATe OFF. This returns the active path to the root (:OUTPut). But if you enter OUTPut:STATe OFF, then the active path remains at :STATe. This allows you to send

OUTPut:STATe OFF;PROTection:CLEar in one message. If you tried to send OUTPut OFF;PROTection:CLEar the header path would return to :OUTPut instead of :PROTection. The optional header [SOURce] precedes the current, frequency, function, phase, pulse, list, and

voltage subsystems. This effectively makes :CURRent,:FREQuency, :FUNCtion, :PHASe, :PULse, :LIST, and :VOLTage root-level commands.

Moving Among Subsystems

In order to combine commands from different subsystems, you need to be able to restore the active path to the root. You do this with the root specifier (:). For example, you could clear the output protection and check the status of the Operation Condition register as follows:

OUTPut:PROTection:CLEAr STATus:OPERation:CONDition? Because the root specifier resets the command parser to the root, you can use the root specifier

and do the same thing in one message: OUTPut:PROTection:CLEAr;:STATus:OPERation:CONDition? The following message shows how to combine commands from different subsystems as well as

within the same subsystem: VOLTage:LEVel 70;PROTection 80;:CURRent:LEVel 3;PROTection:STATe ON Note the use of the optional header LEVel to maintain the correct path within the voltage and

current subsystems and the use of the root specifier to move between subsystems.

Note: The "Enhanced Tree Walking Implementation" given in appendix A of the IEEE 488.2

standard is not implemented in the AC source.

Including Common Commands

You can combine common commands with system commands in the same message. Treat the common command as a message unit by separating it with a semicolon (the message unit separator). Common commands do not affect the active header path; you may insert them anywhere in the message.

VOLTage:TRIGger 7.5;INITialize;*TRG OUTPut OFF;*RCL 2;OUTPut ON

Programming Manual Lx \ Ls Series II

2.3 Using Queries

Observe the following precautions with queries:

Set up the proper number of variables for the returned data. Read back all the results of a query before sending another command to the AC source.

Otherwise a Query Interrupted error will occur and the unreturned data will be lost.

2.4 Coupled Commands

When commands are coupled it means that the value sent by one command is affected by the settings of the other commands. The following commands are coupled in the AC source:

the voltage and function shape commands the step, pulse, and list commands that control output voltages and function shapes the pulse commands that program the width, duty cycle, period, and the hold parameter the voltage range and current limit commands

As explained later in chapter 4, the order in which data is sent by these coupled commands can be important when more than one parameter is changed.

2.5 Structure of a SCPI Message

SCPI messages consist of one or more message units ending in a message terminator. The terminator is not part of the syntax, but implicit in the way your programming language indicates the end of a line (such as a newline or end-of-line character).

2.5.1 The Message Unit

The simplest SCPI command is a single message unit consisting of a command header (or keyword) followed by a message terminator.

ABORt<newline> VOLTage?<newline> The message unit may include a parameter after the header. The parameter usually is

numeric, but it can be a string: VOLTage 20<newline> VOLTage MAX<newline>

2.5.2 Combining Message Units

The following command message is briefly described here, with details in subsequent paragraphs.

Programming Manual Lx \ Ls Series II

VOLT : LEV 80 ; PROT 88 ; : CURR? <NL>

Headers

Data

Message Unit

Query Indicator

Header

Separator

Message

Unit

Separator

Root Specifier

Message

Terminator

Figure 2-2: Command Message Structure

The basic parts of the above message are:

Message Component Example

Headers VOLT LEV PROT CURR Header Separator The colon in VOLT:LEV Data 80 88 Data Separator The space in VOLT 80 and PROT 88 Message Units VOLT:LEV 80 PROT 88 CURR? Message Unit Separator The semicolons in VOLT:LEV 80; and PROT 88; Root Specifier The colon in PROT 88;:CURR? Query Indicator The question mark in CURR? Message Terminator The <NL> (newline) indicator. Terminators are not part of the SCPI syntax

2.5.3 Headers

Headers are instructions recognized by the AC source. Headers (which are sometimes known as "keywords") may be either in the long form or the short form.

Long Form The header is completely spelled out, such as VOLTAGE, STATUS, and

DELAY.

Short Form The header has only the first three or four letters, such as VOLT, STAT,

and DEL.

The SCPI interface is not sensitive to case. It will recognize any case mixture, such as TRIGGER, Trigger, TRIGger. Short form headers result in faster program execution.

Header Convention

In the command descriptions in chapter 3 of this manual, headers are emphasized with boldface type. The proper short form is shown in upper-case letters, such as DELay.

Header Separator If a command has more than one header, you must separate them with a colon (VOLT:PROT

OUTPut:RELay:POLarity). Optional Headers

The use of some headers is optional. Optional headers are shown in brackets, such as

OUTPut[:STATe] ON. As previously explained under "The Effect of Optional Headers", if you

Programming Manual Lx \ Ls Series II

combine two or more message units into a compound message, you may need to enter the optional header.

2.5.4 Query Indicator

Following a header with a question mark turns it into a query (VOLTage?, VOLTage:PROTection?). If a query contains a parameter, place the query indicator at the end of the last header (VOLTage:PROTection? MAX).

2.5.5 Message Unit Separator

When two or more message units are combined into a compound message, separate the units with a semicolon (STATus:OPERation?;QUEStionable?).

2.5.6 Root Specifier

When it precedes the first header of a message unit, the colon becomes the root specifier. It tells the command parser that this is the root or the top node of the command tree. Note the difference between root specifiers and header separators in the following examples:

OUTPut:PROTection:DELay .1 All colons are header separators :OUTPut:PROTection:DELay .1 Only the first colon is a root specifier OUTPut:PROTection:DELay .1;:VOLTage 12.5 Only the third colon is a root specifier

Note: You do not have to precede root-level commands with a colon; there is an implied colon in

front of every root-level command.

2.5.7 Message Terminator

A terminator informs SCPI that it has reached the end of a message. Three permitted messages terminators are:

newline (<NL>), which is ASCII decimal 10 or hex 0A. end or identify (<END>) both of the above (<NL><END>).

In the examples of this manual, there is an assumed message terminator at the end of each message. If the terminator needs to be shown, it is indicated as <NL> regardless of the actual terminator character.

Programming Manual Lx \ Ls Series II

Class

Suffix

Unit

Multiplier

Amplitude V Volt

MV (millivolt)

Current A Ampere

MA (milliamp)

Frequency

Hertz

KHZ (kilohertz)

Time s second

MS (millisecond)

Common Multipliers

1E3

kilo 1E-3

milli 1E-6

micro

2.6 SCPI Data Formats

All data programmed to or returned from the AC source is ASCII. The data may be numerical or character string.

2.6.1 Numerical Data Formats

Symbol Data Form

Talking Formats

<NR1> Digits with an implied decimal point assumed at the right of the least-

significant digit. Examples: 273 <NR2> Digits with an explicit decimal point. Example: .0273 <NR3> Digits with an explicit decimal point and an exponent. Example: 2.73E+2 <Bool> Boolean Data. Example: 0 | 1or ON | OFF

Listening Formats

<Nrf> Extended format that includes <NR1>, <NR2> and <NR3>. Examples:

<Nrf+> Expanded decimal format that includes <Nrf> and MIN MAX. Examples:

<Bool> Boolean Data. Example: 0 | 1

2.6.2 Character Data

273 273. 2.73E2

273 273. 2.73E2 MAX. MIN and MAX are the minimum and maximum

limit values that are implicit in the range specification for the parameter.

Table 2-1: Command parameters Suffixes and Multipliers

Character strings returned by query statements may take either of the following forms, depending on the length of the returned string:

<CRD> Character Response Data. Permits the return of character strings. <AARD> Arbitrary ASCII Response Data. Permits the return of undelimited 7-bit ASCII.

This data type has an implied message terminator.

Programming Manual Lx \ Ls Series II

<SRD> String Response Data. Returns string parameters enclosed in double quotes.

Programming Manual Lx \ Ls Series II

3. System Considerations

This chapter addresses some system issues concerning setting up interfaces such as GPIB, USB or Ethernet.

3.1 IEEE-488 / GPIB Interface

All Lx Series power sources are equipped with an industry standard IEEE-488.2 interface (GPIB). On Ls models, the IEEE-488.2 interface is available as an option (Option –GPIB).

A GPIB controller such as a Windows PC with suitable GPIB controller card is required to use the GPIB interface.

3.1.1 Assigning the IEEE-488 Address

The AC source address cannot be set remotely. It must be set from the front panel. Once the address is set, you can assign it inside programs. The GPIB address can be set/changed from the CONFIGURATION menu screen. Press the MENU key and scroll to the CONFIGURATION menu using the Up/Down arrow keys or press the MENU key repeatedly until the CONFIGURATION screen appears. Press the ENTER key to enter the CONFIGURATION screen.

Scroll to the ADDRESS field using the Up/Down arrow keys on the front panel. The value of the ADDRESS can be set from 0 through 31. Avoid using address 0 as it is generally reserved for the GPIB bus controller. Once set, the GPIB address of the power source is retained in non-volatile memory.

For systems using the National Instruments VISA or IVI drivers, the address is specified in the

resource descriptor (GPIB::1). Consult you programmer‟s reference documentation on how to

address a GPIB instrument using your specific GPIB controller‟s function library.

3.1.2 LxGui and IEEE-488

The provided Windows LxGui program supports the GPIB interface on both Lx Series and Ls Series models but only in combination with a National Instruments GPIB controller. The default

controller ID is zero but controller ID‟s from 0 thorugh 3 can be selected in the LxGui Interface

screen if multiple GPIB controllers are present in the same PC. Note that the LxGui program only supports one Lx/Ls power source at a time.

Programming Manual Lx \ Ls Series II

3.2 USB Interface

Unlike RS232C, there are no generic drivers available as a rule for us in programming environments such as LabView, LabWindows/CVI or Visual Basic. However, support for USB is included under VISA and may be used to interface to the power source using the USB interface.

For other environments, a virtual serial port utility is provided on CD ROM CIC496 which ships with the Lx/Ls Series power source. This utility will provide a virtual COM port on a PC under Windows XP. This allows legacy programs to use the USB port as though it is a regular serial port on the PC. The baud rate for this mode of operation is fixed at 460,800. If you plan to use this feature, the USB-Serial Adaptor installation must be run to install the virtual com port driver. This option is only supported under Windows XP / Windows Vista.

3.2.1 USB Driver Installation

When connecting the AC source through the USB interface to Windows XP/Windows Vista PC, the presence of a new USB device will be detected. Windows will display a dialog after a short delay prompting the user to install the USB device drivers.

On the CIC496 CD browser, select “USB-to-COM(WinXP/Vista32), select “GUI Software” tab and click “Execute Selection” to complete the USB driver installation by selecting “Next”, “Next”, “Install”, then “Finish”.

Close CD browser and restart computer.

This driver will allow access to the AC source USB interface using a virtual COM port. Many programming environments support RS232 access but not USB. The USB-to-COM virtual port driver is distributed on the CIC496 CD ROM.

Programming Manual Lx \ Ls Series II

USB Device Driver installation

Plug in USB cable to power soure, turn on power soure.

When the “Found New Hardware Wizard” dialog appears, select the “No, not this time.”option.

The drivers are not available on line. Click on Next button to continue.

Programming Manual Lx \ Ls Series II

Select the second choice from the list to install the driver by browsing to a specific location. Click on Next button to continue.

For Windows Vista OS, browse to the following location: C:\Program Files\California Instruments\USB VCP Drivers\Vista(32-bits).

Programming Manual Lx \ Ls Series II

For Windows XP OS, browse to the following location: C:\Program Files\California Instruments\USB VCP Drivers\XP(32-bits).

Select “Browse”, “My Computer”, “C:\”, “Prgram Files”, “California Instrumnets”. “USB VCP Driver”, WinXP(32bit). then select “OK”. See picture below for detail.

The USB device drivers have not been Windows XP / Windows Vista Logo certified. Due to the limited distribution of these drivers, this is unlikely to be done. This Logo certification has no bearing on the functionality or legitimacy of this device driver so you can ignore this message.

Click the “Continue Anyway” button to continue. Note that some PCs may have this verification

disabled in which case this screen will not pop up.

The installation will now proceed. This process may take several minutes to complete.

Programming Manual Lx \ Ls Series II

Once completed, the dialog box shown above will appear signaling the device drivers have been installed. The USB interface is now available to the PC‟s operating system. To complete the install process, click on the “Finish” button.

To verify the USB port is available, you can access the Windows System Properties screen, select the Hardware tab and open the Windows Device Manager screen. The Lx/Ls Source should be listed under “Port (COM & LPT)” as shown in the image below.

Programming Manual Lx \ Ls Series II

Figure 3-1: Windows XP Device Manager - USB Port

Programming Manual Lx \ Ls Series II

3.2.2 USB Interface Use

Note that the power source will be detected automatically when turn on or plugged in once the drivers have been installed. It is recommended however to close any open USB connections to the AC source before turning it off.

To use the USB interface, you may use the Gui Windows software supplied with the power source or develop your own application code. In either case, set the baud rate on the power source to 460,800 in the Configuration menu. From Lx/Ls Front panel, press MENU key, scroll to CONFIGURATION and press ENTER key. Select BAUDRATE field and scroll to 460800.

For use with the LxGui program, select the “RS232C Serial” interface type and set the Baud rate

to match the baud rate on the Lx/Ls Source.

Figure 3-2: LxGui Interface Settings for use of USB port.

Note: Use of the USB port to control more than one power source from a single PC is not

recommended, as communication may not be reliable. Use GPIB interface for multiple power source control.

Programming Manual Lx \ Ls Series II

3.3 LAN Option

An Ethernet LAN interface option is available for the Lx/Ls Series II power sources. This option must be specified at the time of order. A LAN option indicator will appear on the model number tag at the rear-panel of the power source to indicate the presence of this option. Also, a RJ45 socket will be present on the rear panel.

Using LAN lets you communicate with the instrument remotely, it is fast, simple and the LAN from your PC does not require any additional proprietary software or cards.

Note: If a USB cable is plugged into the USB interface connector of the power source, the LAN

interface will be disabled. Remove any USB connection to use the LAN / Ethernet port.

3.3.1 MAC Address

Each power source with the –LAN option installed has a unique network address (MAC address). The MAC address (Media Access Conrol) is a unique hexadecimal address and is listed on a label on the rear panel of the power source. To operate the power source on a network, this MAC address needs to be assigned to a TCP/IP address which will be used to address the device on the network.

3.3.2 TCP/IP and Gateway Address

The first decision you need to make is how to connect the instrument. You can connect the instrument directly to a network LAN port with a LAN cable, or you can connect it directly to the PC. When connecting the instrument directly to the PC LAN port you will need a special cable called a cross connect cable. (For more on private network connections, see section 3.3.3) Once connected you must establish an IP address for the instrument. An IP address consists of four groups of numbers separated by a decimal. Dynamic Host Configuration Protocol (DHCP) is typically the easiest way to configure the instrument for LAN communication. DHCP automatically assigns a dynamic IP address to a device on a network. To set the power source to DHCP mode, see section 3.3.4.

Programming Manual Lx \ Ls Series II

3.3.3 Private Networks without DHCP servers

If you are setting up a private network that connects the power source to a Windows PC using a so called cross over RJ45 cable, the PC will assign itself an IP address in the absence of a DHCP server. The available IP address range assigned by the Internet Assigned Network Authority (IANA) for Automatic Private IP Addressing (APIPA) is 169.254.0.0 to 169.254.255.255.

When setting up a private network, you will have to log off and disconnect first from any network connection and re-log in to Windows.

To check the PC‟s IP address, you can run the “ipconfig.exe” program from the command prompt. The screen on a private network should look as follows:

Microsoft(R) Windows DOS (C)Copyright Microsoft Corp 1990-2001.

C:\>ipconfig

Windows IP Configuration

Ethernet adapter Local Area Connection:

Connection-specific DNS Suffix . :

IP Address. . . . . . . . . . . . : 169.254.0.208

Subnet Mask . . . . . . . . . . . : 255.255.0.0

Default Gateway . . . . . . . . . :

Since there is no DCHP server present in a private network like this, the power source has to be

set to a static IP address. To determine what IP address to use, use the first 2 octets of the PC‟s

IP address and set a unique value for the third and fourth octet as long as there are no conflicts with any other IP addresses (other instruments) on the same private network. In this example,

169.254.0.209 would work. Note: For private network configurations, no Gateway address is required. (0.0.0.0)

3.3.4 Setting LAN Parameters

There are two ways to set the required LAN information on the power source.

1. Through Ethernet connection: Use the “GetAssignIPAddress.exe” Windows utility

program that is distributed on the CIC496 CD ROM with every power source. This uitility uses the network connection to set parameters on the power source so the power source and the PC will have to be connected to the same network through a hub or to each other using a cross over network cable (local network).

2. Through Front Panel: Set the parameters from the front panel CONFIGURATION menu.

In this case, connection to a network is not required to set the LAN parameters. This front panel setup mode requires firmware revision 1.33 of higher. Check AMETEK Programmable Power web site for firmware downloads.

To use the CONFIGURATION menu, press the MENU and use the up/down error keys to display the CONFIGURATION entry. Place the pointer on CONFIGURATION and press the ENTER key. Then scroll down till you see LANetwork and press ENTER again.

Programming Manual Lx \ Ls Series II

Values

Description

LANetwork

LAN

If the –LAN option is installed; pressing Enter while the cursor is on the LANetwork entry provides access to the LAN interface setting screens listed below.1

IP Address

Displays the IP address setting. This value can be changed by pressing the SET key and entering a new value from the keypad or using the Voltage and Frequency shuttles. Use the numeric data pad or the voltage shuttle to enter each field. To move between the four fields, use the decimal point key on the keypad or the Frequency shuttle. To set a fixed IP address, press SET and enter the desired IP address. To set the unit to DHCP mode, press SET and enter all zeros (0.0.0.0) as the IP address and cycle power two times. The obtained IP address will be displayed after the second power on. For the DHCP setting to work however, the unit MUST be connected to a network with a DHCP server. Any change to this value will NOT take effect until after power on the unit has been cycled. When changing mode from static IP to DHCP, it is necessary to cycle power on the unit twice, once to change mode and again to obtain and display a new IP address from the network.

MAC Address

Displays the network Media Acces Control address. This value is fixed and cannot be changed. The same MAC is normally printed on the model serial tag. The MAC address is shown as six hexadecimal numbers separated by a colon, e.g.

00:20:4A:9A:02:FD. Note that the leading „0‟ is

never visible due to the maximum number of LCD characters per line.

Note: If the MAC Address displayed is corrupted or does not match the serial tag, there may have been a problem retrieving the LAN port settings.This can happen if a static IP was set that conflicts with another device on the network. To recover, turn on power to the unit while holding down the SET key. This will allow the unit to boot without attempting to collect the IP settings. You can then set the required IP values. [See IP Address above].

GWAddress

Gateway address setting. A default gateway is a node (a router) on a computer network that serves as an access point to another network.

The following fields are available in the LANetwork menu:

This feature requires firmware revision 1.40 or higher. If you upgraded from a lower firmware revision, the LAN configuration has

to be enabled to display this menu. Contact customer service for information on enabled this screen.

Programming Manual Lx \ Ls Series II

This value can be changed by pressing the SET key and entering a new value from the keypad or using the Voltage and Frequency shuttles. Use the numeric data pad or the Voltage shuttle to enter each field. To move between the four fields, use the decimal point key on the keypad or the Frequency shuttle. Any change to this value will NOT take effect until after power on the unit has been cycled.

HostBits

Number of host bits as opposed to network bits in network mask. A CIDR class C network uses 24 network bits and 8 host bits. (Class A = 24, Class B = 16). This value can be changed by pressing the SET key and entering a new value from the keypad. Any change to this value will NOT take effect until after power on the unit has been cycled.

Port No

TCP remote port number. This value must be set to 5025 (SCPI) to support the built in web page. This value can be changed by pressing the SET key and entering a new value from the keypad. Any change to this value will NOT take effect until after power on the unit has been cycled.

LAN Default

LAN default setting can be achieve by selecting the Mac address screen and press the set key followed by the Enter key. Press the Enter key again to confirm. The IP address is set to DHCP or AUTO IP.

Once you have an IP address, you can test the IP address from your Windows PC. An easy way to do so is to use the ping utility under MS DOS. To do so, bring up a DOS window using the start menu:

Start>Programs>Accessories>Command Prompt) At the command prompt type ping <IP address>. This will send an IP ping request to the power source. For this to work, the power source must be

turned on and connected to the same network as the PC. Also, the power source interface configuration must be set to use a baud rate of 460,800. If everything is working it will look like this:

Table 3-1: LAN Setting screens.

Programming Manual Lx \ Ls Series II

Microsoft(R) Windows DOS (C)Copyright Microsoft Corp 1990-2001.

C:\>ping 100.10.1.63

Pinging 100.10.1.63 with 32 bytes of data:

Reply from 100.10.1.63: bytes=32 time<1ms TTL=64 Reply from 100.10.1.63: bytes=32 time<1ms TTL=64 Reply from 100.10.1.63: bytes=32 time<1ms TTL=64 Reply from 100.10.1.63: bytes=32 time<1ms TTL=64

Ping statistics for 100.10.1.63: Packets: Sent = 4, Received = 4, Lost = 0 (0% loss), Approximate round trip times in milli-seconds: Minimum = 0ms, Maximum = 0ms, Average = 0ms

Figure 3-3: Pinging AC Source LAN IP address.

3.3.5 Socket Port Number

Now that a connection has been verified, you can develop your application code. If you are using one of the Microsoft environments, the Winsock protocol which is part of the Windows operating system can be used. Similar capabilities are supported on other operating systems.

To use Winsock, your will have to specificy the port number of the power source‟s LAN interface.

The port number determines the protocol for the communication. The Lx/Ls power source uses ASCII characters and instrument SCPI commands for remote control. The IANA registered Port number for the Instrument SCPI interface is 5025.

TCP Remote port = 5025

Programming Manual Lx \ Ls Series II

3.4 RS232C Serial Interface

The RS232C interface has been retained on the Lx/Ls Series II power source models for backward compatibility with the Series I products. It functions exactly like it did on the first generation products.

Note: If a USB cable is plugged into the USB interface connector of the power source, the RS232

interface will be disabled. Remove any USB connection to use the serial port.

The RS232C interface is factory enabled for all Lx/Ls models, except those ordered with the optional –LAN interface. Models with the –LAN option have the LAN interface enabled and the RS232C port disabled.

Note: If the –LAN option is installed, jumper W2 on the range/relay board (Assy P/N 7004-716-1)

must be installed. This jumper must be removed to enable the RS232C serial interface. Changing this setting requires the top cover to be removed. Contact customer service (service@programmablepower.com) to obtain authorization to perform this setting change.

Figure 3-4: Position of LAN/RS232C selection jumper W2 on 7004-716-2 Range/Relay board.

The RS232C cable required to connect the Lx/Ls Source to a PC serial port is a standard 9 pin Male to 9 pin Female straight-thorugh serial cable. A suitable 6 feet long RS232C cable is supplied with each power soruce. (CI P/N 250709). Replacement cables are available through customer service (service@programmablepower.com)

Programming Manual Lx \ Ls Series II

3.5 Instrument Drivers and Application Software

Instrument drivers for National Instruments LabWindows/CVI and LabView are generally available for download from the AMETEK Programmable Power ' web site at

www.programmablepower.com. Also available are ready to use interactive graphical user

interface (GUI) programs for download.

Programming Manual Lx \ Ls Series II

4. SCPI Command Reference

4.1 Introduction

This chapter provides a complete listing of all SCPI commands supported by the Lx\Ls Series of AC sources. Commands are grouped by function according the root level commands. Some general command related issues are:

Phases If a command can apply to individual phases of an AC source, the entry “Phase Selectable” will

appear in the command description. Related Commands Where appropriate, related commands or queries are included. These are listed because they are

either directly related by function, or because reading about them will clarify or enhance your understanding of the original command or query.

This chapter is organized as follows:

Subsystem commands, arranged by subsystem IEEE 488.2 common commands

Programming Manual Lx \ Ls Series II

4.2 Subsystem Commands

Subsystem commands are specific to AC source functions. They can be a single command or a group of commands. The groups are comprised of commands that extend one or more levels below the root. The description of common commands follows the description of the subsystem commands.

The subsystem command groups are listed in alphabetical order and the commands within each subsystem are grouped alphabetically under the subsystem. Commands followed by a question mark (?) take only the query form. When commands take both the command and query form, this is noted in the syntax descriptions.

You will find the subsystem command groups discussed on the following pages:

Programming Manual Lx \ Ls Series II

4.3 Calibration Subsystem

The commands in this subsystem allow you to do the following:

Enter the calibration password Calibrate the current and voltage output levels, and store new calibration constants in

nonvolatile memory.

Subsystem Syntax

CALibrate :MEASure :CURRent Begin current measurement calibration sequence :SPHase Query format returns single phase current mea coefficient. :VOLTage Begin current measurement calibration sequence :PASSword Unlock calibration :SAVE Save new cal constants in non-volatile memory [:SOURce] PHASe Phase offset calibration :VOLTage:HRANge Query output voltage cal coefficient

CALibrate:MEASure:CURRent

Phase Selectable This command can only be used in calibration mode. It initiates the calibration of the ac current

metering circuits and sets the reference value to calibrate to. The query format returns the actual calibration coefficient. Use the INST:SEL or INST:NSEL to select the desired phase.

Command Syntax CALibrate:MEASure:CURRent <Nrf> Parameters Reference instrument current reading Query Syntax CALibrate:MEASure:CURRent? Returned Parameters <NR3> Examples CAL:MEAS:CURR 12.23 Related Commands CAL:SAVE CAL:MEAS:VOLT

CALibrate:MEASure:CURRent:SPHase

This command can only be used in calibration mode and in query form. It applies only to phase 1 (Lx) or A (Ls). It returns the single-phase mode current measurement calibration coefficient for Lx models and Ls models that have the –MODE option. Its purpose is to be able to read the calibration status without having to switch the AC source to single phase mode.

If the Lx or Ls is in single phase mode, this command is equivalent to the the CAL:MEAS:CURR? query for phase 1/A except it can not be used to perform a calibration. It does not initiate a calibration. Use the CAL:MEAS:CURR? command to do this instead.

Query Syntax CALibrate:MEASure:CURRent:SPHase? Returned Parameters <NR3> Examples CAL:MEAS:CURR:SPH? Related Commands CAL:SAVE CAL:MEAS:VOLT

CALibrate:MEASure:VOLTage

Phase Selectable This command can only be used in calibration mode. It initiates the calibration of the ac voltage

metering circuits. The query format returns the actual calibration coefficient. Use the INST:SEL or INST:NSEL to select the desired phase.

Programming Manual Lx \ Ls Series II

Command Syntax CALibrate:MEASure:VOLTage <Nrf> Parameters Reference instrument voltage reading Query Syntax CALibrate:MEASure:VOLTage? Returned Parameters <NR3> Examples CAL:MEAS:VOLT Related Commands CAL:SAVE CAL:MEAS:CURR

CALibrate:PASSword

This command can only be used to unlock the calibration mode. Once unlocked, non-query calibration commands will be accepted. Query commands are always accepted.

Command Syntax CALibrate:PASSword<NRf> Parameters <high voltage range> (default) Examples CAL:PASS 300 Related Commands none

CALibrate:SAVE

This command can only be used in calibration mode. It saves any new calibration constants (after a current or voltage calibration procedure has been completed) in nonvolatile memory.

Command Syntax: CALibrate:SAVE Parameters None Examples CAL:SAVE Related Commands CAL:CURR CAL:VOLT

CALibrate[:SOURce]:PHASe

Phase Selectable This command can be used to set the phase calibration offset coefficient. Use the INST:SEL or

INST:NSEL to select the desired phase. This allows the phase for voltage 2 and 3 (B and C) to be adjusted with respect to phase A. The query format returns the actual calibration coefficient

Command Syntax CALibrate[:SOURce]:PHASe <Nrf> Parameters <NRf+> Query Syntax CALibrate[:SOURce]:PHASe? Returned Parameters <NR3> Examples CAL:PHAS 1.3 Related Commands none

CALibrate[:SOURce]:VOLTage:HRANge

Phase Selectable This command can be used to query the output voltage calibration coefficient. Only the query

format is available. Use the INST:SEL or INST:NSEL to select the desired phase. The parameter can be any integer value between 0 and 4000. Factory default is 450.

Command Syntax CALibrate[:SOURce]:VOLTage:HRANge <Nrf> Parameters 0 to 4000 Query Syntax CALibrate[:SOURce]:VOLTage:HRANge? Returned Parameters <NR3> Examples CAL:VOLT:HRAN 450 Related Commands none

Programming Manual Lx \ Ls Series II

4.4 Diagnostic Subsystem

These subsystem commands perform diagnostic functions which include reading and writing to the EEPROM, resetting the AC source and reading temperature.

Subsystem Syntax

DIAGnostic :RESet Force power-on reset :TEMPerature :AMBient? Returns ambient temperature in °C

DIAGnostic:RESet

This commands forces a power-on reset. Command Syntax DIAGnostic:RESet

Parameters None Examples DIAG:RES Related Commands *RST

DIAGnostic:TEMPerature:AMBient?

This query returns the temperature measured at the ambient sense thermistor in degrees C. Query Syntax DIAGnostic:TEMPerature:AMBient?

Parameters None Examples DIAG:TEMP:AMB? Returned Parameters <NR3>

Programming Manual Lx \ Ls Series II

4.5 Display Subsystem

This subsystem allows text information to be send to the power source LCD display. Typical applications are to display operator prompts or program status information on the power source display.

Note: The Display subsystem was added with firmware revision 1.21. If the power source

revision is less than 1.21, these commands are not supported. The firmware revision can be queried using the *IDN? Command.

The display on the Lx/Ls Series has a maximum capacity of 32 ASCII characters, both lower and upper case. The display system does not perform automatic word wrap between the 2 lines of the LCD display. The programming is responsible for formatting the two lines by padding the first line with spaces as needed. It is not necessary to pad out the complete 32 characters as the power source will fill any remaining character positions with spaces automatically.

Subsystem Syntax

DISPlay [:WINDow] [:STATe] on | off | 1 | 0 :MODe NORMal/TEXT :TEXT "xxxxxx"

DISPlay

This command turns the front panel display on and off. It does not affect the annunciators. In the off state, the LCD display will be blank but the backlight will remain on. Note that this state overrides the DISPLay:MODE state as well so the display will be blanked regardless of the display mode setting.

Command Syntax DISPlay[:WINDow][:STAT]<bool> Parameters 0 | 1 | OFF | ON *RST Value ON Examples DISP:STAT 1 DISP:STAT OFF Query Syntax DISPlay[:WINDow]:STAT? Returned Parameters 0 | 1 Related Commands DISP:MODE DISP:TEXT

DISPlay:MODE

This command sets the display to show either normal instrument functions, or to show a text message. Text messages are defined with DISPlay:TEXT:DATA.

Command Syntax DISPlay[:WINDow]:MODE<mode> Parameters NORMal|TEXT *RST Value NORMal Examples DISP:MODE TEXT Query Syntax DISPlay[:WINDow]:MODE? Returned Parameters <CRD> Related Commands DISP DISP:TEXT

Programming Manual Lx \ Ls Series II

DISPlay:TEXT

This command sets the character string that is displayed when the display mode is set to TEXT. The argument is a quoted string limited to upper case alpha characters and numbers. The display is capable of showing up to 32 characters divided over 2 lines of 16 characters each. If the string exceeds the display capacity, it will be truncated.

The display system does not perform automatic word wrap between the 2 lines of the LCD display. The programming is responsible for formatting the two lines by padding the first line with spaces as needed. It is not necessary to pad out the complete 32 characters as the power source will fill any remaining character positions with spaces automatically.

Command Syntax DISPlay[:WINDow]:TEXT[:DATA]<display_string> Parameters <display string> *RST Value null string Examples DISP:TEXT "DO TEST1” Query Syntax DISPlay[:WINDow]:MODE? Returned Parameters <SRD> (the last programmed string) Related Commands DISP DISP:TEXT

Programming Manual Lx \ Ls Series II

4.6 Instrument Subsystem

This subsystem programs the three-phase output capability of the AC Power Source.

Subsystem Syntax

INSTrument:COUPle

In a three-phase power source it is convenient to set parameters of all three output phases simultaneously with one programming command. When INST:COUP ALL is programmed, sending a command to any phase will result in that command being sent to all three phases.

INSTrument:COUPle only affects the operation of subsequent commands. It does not by itself immediately affect the AC source's output. The commands that are affected by INSTrument:COUPle are those with the designation: Phase Selectable.

INSTrument:COUPle has no affect on queries. There is no way to query more than one phase with a single command. Directing queries to individual phases is done with INSTrument:NSELect.

Command Syntax INSTrument:COUPle<coupling> Parameters ALL|NONE *RST Value ALL Examples INST:COUP ALL Query Syntax INSTrument:COUPle? Returned Parameters <CRD> Related Commands INST:NSEL

INSTrument:NSELect INSTrument:SELect

These commands allow the selection of individual outputs in a three-phase model for subsequent commands or queries. Their operation is dependent on the setting of INSTrument:COUPle. If INST:COUP NONE is programmed, then the phase selectable commands are sent only to the particular output phase set by INSTrument:NSELect. If INST:COUP ALL is programmed, then all commands are sent to all three output phases.

Note: If the power source is in SINGLE phase mode or does not support 3 phase mode of operation, an INST:NSEL 2 or INST:NSEL 3 command will result in a –222,”Data out of range” error.

INSTrument:NSELect selects the phase by its number, while INSTrument:SELect references it by name. These commands also select which output phase returns data when a query is sent.

Command Syntax INSTrument:NSELect <NR1> INSTrument:SELect <output> Parameters For INST:NSEL: 1 | 2 | 3 For INST:SEL: OUTPut1 | OUTPut2 | OUTPut3 *RST Value 1 or OUTPut1 Examples INST:NSEL 3 Query Syntax INSTrument:NSELect? Returned Parameters <NR1> Related Commands INST:COUP

Programming Manual Lx \ Ls Series II

Setting

Operation

Single-phase mode.

120

Three phase mode. Determines relative phase angle between phases A,

4.7 Limit Subsystem

These subsystem commands may be used to query the hardware limits (capabilities) of the AC power source. These commands are protected and can only be used in query format.

Subsystem Syntax

LIMit :CURRent Current limit setting :FREQuency :HIGH Frequency limit high :LOW Frequency limit low :PHASe Phase mode :VOLTage :HIGH Voltage limit high voltage range :LOW Voltage limit low voltage range

LIMit:CURRent

Query form returns the configuration current limit. This value determines the maximum current available from one amplifier in the low voltage range. Note that this is not the same as the available current maximum current, which is a function of voltage range and phase mode. To query the maximum available RMS current, use the CURR? MAX command.

Query Syntax LIMit:CURRent? Returned Parameters <NR3> Examples LIM:CURR? Related Commands CURR

LIMit:FREQuency:HIGH

Query form returns the maximum available output frequency. This value determines the maximum frequency available using a sinusoidal waveform. Note that this is not the same as the available maximum frequency, which is a function of the frequency harmonic content of the waveform. To query the maximum available frequency, use the FREQ? MAX command.

Query Syntax LIMit:FREQuency:HIGH? Returned Parameters <NR3> Examples LIM:FREQ:HIGH? Related Commands LIM:FREQ:LOW?

LIMit:FREQuency:LOW

Query form returns the maximum available output frequency. This value determines the minimum frequency available.

Query Syntax LIMit:FREQuency:LOW? Returned Parameters <NR3> Examples LIM:FREQ:LOW? Related Commands LIM:FREQ:HIGH?

LIMit:PHASe

Query form returns the phase configuration setting. This value determines the phase mode of operation according to the table below:

Programming Manual Lx \ Ls Series II

B and C (ø1, ø2 and ø3). If the MODE field is set (standard on Lx Series, optional on Ls Series) the AC source can operate in both 1 and 3 phase modes.

Other

Any value other than 0 or 120 indicates 2 phase configuration with phase angle between A and B set to value shown.

Query Syntax LIMit:PHASe? Returned Parameters <NR3> Examples LIM:PHAS? Related Commands SYST:CONF:NOUT?

LIMit:VOLTage:HIGH

Query form returns the maximum available output voltage for the high voltage range. This value determines the maximum AC RMS voltage available using a sinusoidal waveform. Note that this is not the same as the available maximum voltage, which is a function crest factor of the voltage waveform. To query the maximum available voltage, use the VOLT? MAX command.

Query Syntax LIMit:VOLTage:HIGH? Returned Parameters <NR3> Examples LIM:VOLT:HIGH? Related Commands LIM:VOLT:LOW?

LIMit:VOLTage:LOW

Query form returns the maximum available output voltage for the low voltage range. This value determines the maximum AC RMS voltage available using a sinusoidal waveform. Note that this is not the same as the available maximum voltage, which is a function crest factor of the voltage waveform. To query the maximum available voltage, use the VOLT? MAX command.

Query Syntax LIMit:VOLTage:LOW? Returned Parameters <NR3> Examples LIM:VOLT:LOW? Related Commands LIM:VOLT:HIGH?

Programming Manual Lx \ Ls Series II

4.8 Array Measurement Subsystem

This subsystem lets you retrieve arrays containing measurements data. Only current and voltage measurements are stored in an array. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new data before returning the readings from the array. FETCh returns previously acquired data from the array.

Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.

Subsystem Syntax MEASure | FETCh

:ARRay :CURRent [:DC]? Returns the digitized instantaneous current :HARMonic [:AMPLitude]? Returns amplitudes of the first 50 harmonics :PHASe? Returns phase angles of the first 50 harmonics :MODE Selects waveform data transfer format :NEUTral [:DC]? Returns the neutral digitized instantaneous current (3-

phase only) :HARMonic [:AMPLitude]? Returns neutral current harmonic amplitude :PHASe? Returns neutral current harmonic phase :VOLTage [:DC]? Returns the digitized instantaneous voltage :HARMonic [:AMPLitude]? Returns amplitudes of the first 50 harmonics :PHASe? Returns phase angles of the first 50 harmonics

MEASure:ARRay:CURRent? FETCh:ARRay:CURRent?

Phase Selectable These queries return an array containing the instantaneous output current in amperes. The data

returned in arbitrary block data format as follows:

#5<block length n><b0><b1><b2><b3>.....<bn-3><bn -2><bn-1><bn>

where b0,b1,b2,b3 are four hex bytes represent IEEE single precision floating number, where b0 is the most significant byte and b3 is the least significant byte. The number of bytes returned is contained in the data block header which always starts with the “#” pound character followed by a single decimal character indicating the number of digits that make up the block length of the data. Thus, “#516384…” indicates that there are 5 digits that follow containing the number of bytes in the data block (excluding the header and length information). The actual number of bytes in this case is 16384 or 16Kbytes.

The output voltage and current are digitized whenever a measure command is given or whenever an acquisition trigger occurs. The acquisition sampling time interval is set by SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the data buffer is determined by SENSe:SWEep:OFFSet:POINts.

Programming Manual Lx \ Ls Series II

start the data transfer. Valid offset values are from 0 thorugh 15. If both parameters are omitted, all 16 blocks are transferred starting from offset 0 (first block).

Query Syntax MEASure:ARRay:CURRent[:DC]? [<n>,<n>] FETCh:ARRay:CURRent[:DC]? [<n>,<n>] Parameters Optional block and offset parameters <n>,<n>. Where the first value <n>

is the number of 256 sample blocks to transfer and the second value <n> is the first block (offset) to start with. Number of blocks is from 1 to 16,

offset is from 0 to 15. Examples MEAS:ARR:CURR? FETC:ARR:CURR? 4,0 Returned Parameters 4096 NR3 values Related Commands INST:NSEL SENS:SWE

MEASure:ARRay:CURRent:HARMonic? FETCh:ARRay:CURRent:HARMonic?

Phase Selectable These queries return an array of harmonic amplitudes of output current in rms amperes. The first

value returned is the dc component, the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure:ARRay:CURRent:HARMonic[:AMPLitude]? FETCh:ARRay:CURRent:HARMonic[:AMPLitude]? Parameters None Examples MEAS:ARR:CURR:HARM? FETC:ARR:CURR:HARM? Returned Parameters 51 NR3 values Related Commands INST:NSEL

MEASure:ARRay:CURRent:HARMonic:PHASe? FETCh:ARRay:CURRent:HARMonic:PHASe?

Phase Selectable These queries return an array of harmonic phases of output current in degrees, referenced to the

positive zero crossing of the fundamental component. The first value returned is the dc component (always returned as 0 degrees phase), the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure:ARRay:CURRent:HARMonic:PHASe?<NRf> FETCh:ARRay:CURRent:HARMonic:PHASe?<NRf> Parameters None Examples MEAS:ARR:CURR:HARM:PHAS? FETC:ARR:CURR:HARM:PHAS? Returned Parameters 51 NR3 values Related Commands INST:NSEL

MEASure:ARRay:CURRent:NEUTral? FETCh:ARRay:CURRent:NEUTral?

These queries return an array containing the instantaneous output current of the neutral output terminal in amperes. The output voltage and current are digitized whenever a measure command is given or whenever an acquisition trigger occurs. The acquisition sampling time interval is set by

Programming Manual Lx \ Ls Series II

SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the data buffer is determined by SENSe:SWEep:OFFSet:POINts.

Query Syntax MEASure:ARRay:CURRent:NEUTral[:DC]? FETCh:ARRay:CURRent:NEUTral[:DC]? Parameters None Examples MEAS:ARR:CURR:NEUT? FETC:ARR:CURR:NEUT? Returned Parameters 4096 NR3 values Related Commands INST:NSEL SENS:SWE

MEASure:ARRay:CURRent:NEUTral:HARMonic? FETCh:ARRay:CURRent:NEUTral:HARMonic?

These queries return an array of harmonic amplitudes of output current of the neutral output terminal in rms amperes.

The first value returned is the dc component, the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure:ARRay:CURRent:NEUTral:HARMonic[:AMPLitude]? FETCh:ARRay:CURRent:NEUTral:HARMonic[:AMPLitude]? Parameters None Examples MEAS:ARR:CURR:NEUT:HARM? FETC:ARR:CURR:NEUT:HARM? Returned Parameters 51 NR3 values Related Commands INST:NSEL

MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe? FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe?

These queries return an array of harmonic phases of output current of the neutral output terminal in degrees, referenced to the positive zero crossing of the fundamental component. The first value returned is the dc component (always returned as 0 degrees phase); the second value is the fundamental frequency, and so on up to the 50th harmonic. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure:ARRay:CURRent:NEUTral:HARMonic:PHASe? FETCh:ARRay:CURRent:NEUTral:HARMonic:PHASe? Parameters None Example MEAS:ARR:CURR:NEUT:HARM:PHAS? FETC:ARR:CURR:NEUT:HARM:PHAS? Returned Parameters 51 NR3 values Related Commands INST:NSEL

MEASure:ARRay:MODe

This command selects the waveform array data format to be used. The default mode is binary (BIN) which uses an IEEE floating point data format in which each data sample is transferred as a 4 byte floating point binary data word. Alternatively, an ASCII format may be selected (ASCii) in which each data sample is sent as 8 ASCII Hex values representing the 4 byte IEEE floating point data. Note that the transfer mode only applies to MEAS:ARR:VOLT and MEAS:ARR:CURR queries. All other measurement queries always return ASCII data. Note that at power on, the default mode is always set to binary (BIN).

Programming Manual Lx \ Ls Series II

Syntax MEASure:ARRay:MODe Parameters BIN | ASCii Examples MEAS:ARR:MOD ASC Related Commands MEAS:ARR:VOLT MEAS:ARR:CURR

Note: The MEAS:ARR:MOD command is provided to allow waveform data transfers in ASCII on DBCS versions of MS Windows. Examples of DBCS versions are Chinese, Korean, Japanese etc. On most Windows versions, the binary mode can be used as it reduces the amount of data transferred and thus provides better throughput.

The ASCII mode will double the number of characters transferred so provisions for a larger receive buffer on the PC may have to be made. On the Lx/Ls, the full acquisition data size that can be sent with one command in BIN mode is 16KB, in ASC mode 32KB.

The binary data must be converted to a single precision floating point notation. Sample VB6 code is shown on the next page.

Conversion function sample VB6. Converting waveform data from either transfer mode to a single precision value can be accomplished using the following sample routine:

Public Function StringToIEEEFloat(ByVal sData As String, ByVal bAsciiMode As Boolean) As Single '============================================================= 'bAsciiMode flag is used if data is received as 8 ascii chars 'representing Hex 0-9,A-F. If bAsciiMode flag is false, then 'data is process as 4 char representing a byte each. Ascii 'mode is needed for DCBS windows '============================================================= Dim i As Integer Dim j As Integer Dim iChar As Integer Dim expo As Long Dim mantisse As Long Dim expo_val As Variant Dim mant_f As Single Dim c(3) As Long 'Must use 32 bit integers to allow for 'intermediate result of 24 bit shift Dim sign As Boolean '============================================================= Const MANT_MAX = &H7FFFFF Const EXPO_MAX = 2 ^ 126 '=============================================================

On Error GoTo FloatConvError If bAsciiMode Then 'Retrieve ASC values from eight hex byte input data sData = UCase(sData) For i = 0 To 3 c(i) = 0 For j = 0 To 1 iChar = AscB(Mid$(sData, i * 2 + j + 1, 1)) - 48 If iChar > 9 Then iChar = iChar - 7 c(i) = c(i) * 16 * j + iChar Next j Next i Else 'Retrieve ASC values from four byte input data 'Note: Don't use ASCB or ASCW functions as results will differ 'based on character sets, even on non DCBS Windows 'Retrieve ASC values from four byte input data For i = 0 To 3 c(i) = Asc(Mid$(sData, i + 1, 1)) Next i End If 'Get sign bit sign = ((c(0) And &H80) = &H80) 'Get exponent value less sign bit expo = (c(0) And &H7F) * 2 'Pick up exponent sign If (c(1) And &H80) = &H80 Then expo = expo Or 1

Programming Manual Lx \ Ls Series II

'get data less exponent sign bit c(1) = c(1) And &H7F mantisse = c(1) * &H10000 + c(2) * &H100 + c(3) mant_f = mantisse / MANT_MAX 'Process exponent If (expo <> 0) And (expo <> &HFF) Then expo = expo - 127 mant_f = mant_f + 1 expo_val = 2 ^ Abs(expo) If (expo > 0) Then mant_f = mant_f * expo_val If (expo < 0) Then mant_f = mant_f / expo_val Else If (mant_f <> 0) Then If expo = 0 Then mant_f = mant_f / EXPO_MAX Else mant_f = mant_f * EXPO_MAX End If End If End If 'Append number sign and return value If sign Then mant_f = -mant_f StringToIEEEFloat = mant_f Exit Function '=============================================================

FloatConvError: 'Conversion errors are truncated to zero StringToIEEEFloat = 0 Exit Function

End Function

MEASure:ARRay:VOLTage? FETCh:ARRay:VOLTage?

Phase Selectable These queries return an array containing the instantaneous output voltage in volts. The data

returned in arbitrary block data format as follows:

#5<block length n><b0><b1><b2><b3>.....<bn-3><bn -2><bn-1><bn>

Thus, “#516384…” indicates that there are 5 digits that follow containing the number of bytes in

the data block (excluding the header and length information). The actual number of bytes in this case is 16384 or 16Kbytes.

The output voltage and current are digitized whenever a measure command is given or whenever an acquire trigger occurs. If digitization is caused by a measure command, the time interval between samples is determined by the output frequency. For frequencies greater than 45 Hz, the time interval is 10.4 microseconds. If digitization is caused by an acquire trigger, the time interval is set by SENSe:SWEep:TINTerval, and the position of the trigger relative to the beginning of the data buffer is determined by SENSe:SWEep:OFFSet:POINts.

This command has two optional parameters. The first one may be used to specify the number of 256 data sample blocks to transfer. Valid parameter values are from 1 through 16. The second parameter may be used to specify the offset in number of 256 data sample blocks from which to start the data transfer. Valid offset values are from 0 thorugh 15. If both parameters are omitted, all 16 blocks are transferred starting from offset 0 (first block).

Programming Manual Lx \ Ls Series II

Query Syntax MEASure:ARRay:VOLTage[:DC]? [<n>, <n>] FETCh:ARRay:VOLTage[:DC]? [<n>, <n>] Parameters Optional block and offset parameters <n>,<n>. Where the first value <n>

is the number of 256 sample blocks to transfer and the second value <n>

is the first block (offset) to start with. Number of blocks is from 1 to 16,

offset is from 0 to 15. Examples MEAS:ARR:VOLT? FETC:ARR:VOLT? Returned Parameters 4096 or less NR3 values Related Commands INST:NSEL SENS:SWE

MEASure:ARRay:VOLTage:HARMonic? FETCh:ARRay:VOLTage:HARMonic?

Phase Selectable These queries return an array of harmonic amplitudes of output voltage in rms volts. The first

Query Syntax MEASure:ARRay:VOLTage:HARMonic[:AMPLitude]? FETCh:ARRay:VOLTage:HARMonic[:AMPLitude]? Parameters None Examples MEAS:ARR:VOLT:HARM? FETC:ARR:VOLT:HARM? Returned Parameters 51 NR3 values Related Commands INST:NSEL

Programming Manual Lx \ Ls Series II

4.9 Current Measurement Subsystem

This subsystem programs the current measurement capability of the 3000Lx and the 4500Lx. Two measurement commands are available: MEASure and FETCh.

MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data. Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.

Subsystem Syntax

MEASure | FETCh [:SCALar] :CURRent [:DC]? Returns dc component of the current :AC? Returns ac rms current :ACDC? Returns ac+dc rms current :AMPLitude :MAX? Returns non-recurring peak current :RESet Clear the non-recurring peak current. :CREStfactor? Returns current crestfactor :HARMonic [:AMPLitude]? <n> Returns amplitude of the Nth harmonic of current :PHASe? <n> Returns phase of the Nth harmonic of current :THD? Returns % of total harmonic distortion of current :NEUTral [:DC]? Returns neutral dc current (3-phase only) :AC? Returns neutral ac rms current (3-phase only) :ACDC? Returns neutral ac+dc rms current (3-phase only)

:HARMonic

[:AMPLitude]? <n> Returns neutral current harmonic amplitude

:PHASe? <n> Returns neutral current harmonic phase

:THD:MODE RMSQ | FUND Sets THD calculation to either RMS or Fundamental

mode.

MEASure:CURRent? FETCh:CURRent?

Phase Selectable These queries return the dc component of the output current being sourced at the output

terminals. Query Syntax MEASure[:SCALar]:CURRent[:DC]?

FETCh[:SCALar]:CURRent[:DC]? Parameters None Examples MEAS:CURR? FETC:CURR? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:AC? FETCh:CURRent:AC?

Phase Selectable These queries return the ac component rms current being sourced at the output terminals.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:CURRent:AC? FETCh[:SCALar]:CURRent:AC? Parameters None Examples MEAS:CURR:AC? FETC:CURR:AC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:ACDC? FETCh:CURRent:ACDC?

Phase Selectable These queries return the ac and dc components of the rms current being sourced at the output

terminals. Query Syntax MEASure[:SCALar]:CURRent:ACDC?

FETCh[:SCALar]:CURRent:ACDC? Parameters None Examples MEAS:CURR:ACDC? FETC:CURR:ACDC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:AMPLitude:MAXimum? FETCh:CURRent:AMPLitude:MAXimum?

Phase Selectable These queries return the absolute value of the peak current as sampled over one measurement

acquisition of 4096 data points. Note that the MEAS format returns the non-recurring peak current (as in a peak hold reading). This value can be cleared with the MEAS:CURR:AMP:RES command. The FETC format can be used to obtain the recurring or repetitive peak current this requires the acquisition to be triggered first by either an INIT:ACQ or a MEAS command for another paramter e.g. current, followed by the FETC:CURR:AMPL:MAX?

Query Syntax MEASure[:SCALar]:CURRent:AMPLitude:MAXimum? FETCh[:SCALar]:CURRent:AMPLitude:MAXimum? Parameters None Examples MEAS:CURR:AMPL:MAX? FETC:CURR:AMPL:MAX? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:AMPLitude:RESet FETCh:CURRent:AMPLitude:RESet

Phase Selectable These command resets the peak current hold value returned with the MEAS:CURR:AMPL:MAX?

query. Syntax MEASure[:SCALar]:CURRent:AMPLitude:RESet

FETCh[:SCALar]:CURRent:AMPLitude:RESet Parameters None Examples MEAS:CURR:AMPL:RES Returned Parameters None Related Commands MEAS:CURR:AMPL:MAX? FETC:CURR:AMPL:MAX?

MEASure:CURRent:CREStfactor? FETCh:CURRent:CREStfactor?

Phase Selectable

Programming Manual Lx \ Ls Series II

These queries return the output current crest factor. This is the ratio of peak output current to rms output current.

Query Syntax MEASure[:SCALar]:CURRent:CREStfactor? FETCh[:SCALar]:CURRent:CREStfactor? Parameters None Examples MEAS:CURR:CRES? FETC:CURR:CRES? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:HARMonic? FETCh:CURRent:HARMonic?

Phase Selectable These queries return the rms amplitude of the Nth harmonic of output current. The parameter is

the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure[:SCALar]:CURRent:HARMonic[:AMPLitude]?<NRf> FETCh[:SCALar]:CURRent:HARMonic[:AMPLitude]?<NRf> Parameters 0 to 50 Examples MEAS:CURR:HARM? 3 FETC:CURR:HARM? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:HARMonic:PHASe? FETCh:CURRent:HARMonic:PHASe?

Phase Selectable These queries return the phase angle of the Nth harmonic of output current, referenced to the

positive zero crossing of the fundamental component. The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure[:SCALar]:CURRent:HARMonic:PHASe?<NRf> FETCh[:SCALar]:CURRent:HARMonic:PHASe?<NRf> Parameters 0 to 50 Examples MEAS:CURR:HARM:PHAS? 3 FETC:CURR:HARM:PHAS? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:HARMonic:THD? FETCh:CURRent:HARMonic:THD?

Phase Selectable These queries return the percentage of total harmonic distortion and noise in the output current.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:CURRent:HARMonic:THD? FETCh[:SCALar]:CURRent:HARMonic:THD? Parameters None Examples MEAS:CURR:HARM:THD? FETC:CURR:HARM:THD? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:NEUTral? FETCh:CURRent:NEUTral?

These queries return the dc current in the neutral output terminal of a three-phase AC source. Query Syntax MEASure[:SCALar]:CURRent:NEUTral[:DC]?

FETCh[:SCALar]:CURRent:NEUTral[:DC]? Parameters None Examples MEAS:CURR:NEUT? FETC:CURR:NEUT? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:NEUTral:AC? FETCh:CURRent:NEUTral:AC?

These queries return the ac rms current in the neutral output terminal of a three-phase AC source. Query Syntax MEASure[:SCALar]:CURRent:NEUTral:AC?

FETCh[:SCALar]:CURRent:NEUTral:AC? Parameters None Examples MEAS:CURR:NEUT:AC? FETC:CURR:NEUT:AC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:NEUTral:ACDC? FETCh:CURRent:NEUTral:ACDC?

These queries return the ac+dc rms current in the neutral output terminal of a three-phase AC source.

Query Syntax MEASure[:SCALar]:CURRent:NEUTral:ACDC? FETCh[:SCALar]:CURRent:NEUTral:ACDC? Parameters None Examples MEAS:CURR:NEUT:ACDC? FETC:CURR:NEUT:ACDC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:NEUTral:HARMonic? FETCh:CURRent:NEUTral:HARMonic?

These queries return the rms amplitude of the Nth harmonic of current in the neutral output terminal of a three-phase AC source. The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:CURRent:NEUTral:HARMonic [:AMPLitude]?<NRf> FETCh[:SCALar]:CURRent:NEUTral:HARMonic [:AMPLitude]?<NRf> Parameters 0 to 50 Examples MEAS:CURR:NEUT:HARM? 3 FETC:CURR:NEUT:HARM? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:CURRent:NEUTral:HARMonic:PHASe? FETCh:CURRent:NEUTral:HARMonic:PHASe?

These queries return the phase angle of the Nth harmonic of current in the neutral output terminal of a three-phase, referenced to the positive zero crossing of the fundamental component.

The parameter is the desired harmonic number. Queries sent with a value of 0 return the dc component. A value of 1 returns the fundamental output frequency. Harmonic orders can be measured up to the fundamental measurement bandwidth of the measurement system, which is 16 kHz. Thus, the maximum harmonic that can be measured is dependent on the output frequency. Any harmonics that represent frequencies greater than 16 kHz are returned as 0.

Query Syntax MEASure[:SCALar]:CURRent:NEUTral:HARMonic :PHASe?<NRf> FETCh[:SCALar]:CURRent:NEUTral:HARMonic :PHASe?<NRf> Parameters 0 to 50 Examples MEAS:CURR:NEUT:HARM:PHAS? 3 FETC:CURR:NEUT:HARM:PHAS? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:THDistortion:MODE

This command sets the calculation method for THD measurements. The distortion calculation is based on the H2 through H50 with the RMS voltage or current in the denominator. Note that some definitions of THD use the fundamental component (H1) of the voltage or as the denominator.

Lx/Ls units with firmware revision 0.88 or higher can be programmed to use the fundamental component as the denominator instead of the RMS value. This mode can only be programmed

over the bus by sending the “MEAS:THD:MODE FUND” command. At power up or after a reset

command, the mode will revert back to the RMS mode. This mode setting is not saved in any of the set up registers.

Syntax MEASure:THDistortion:MODE Parameters RMSQuare | FUNDamental Examples MEAS:THD:MODE FUND Query Syntax MEAS:THD:MODE? Returned Parameters <CRD> Related Commands MEAS:VOLT:HARM:THD? MEAS:CURR:HARM:THD?

Programming Manual Lx \ Ls Series II

4.10 Frequency Measurement Subsystem

This subsystem programs the frequency measurement capability of the Lx\Ls Series. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data.

Subsystem Syntax

MEASure | FETCh [:SCALar] :FREQuency? Returns the output frequency

MEASure:FREQuency? FETCh:FREQuency?

This query returns the output frequency in Hertz. Query Syntax MEASure[:SCALar]:FREQuency?

FETCh[:SCALar]:FREQuency? Parameters None Examples MEAS:FREQ? FETC:FREQ? Returned Parameters <NR3>

Programming Manual Lx \ Ls Series II

4.11 Power Measurement Subsystem

This subsystem programs the power measurement capability of the Lx\Ls Series. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data.

Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.

Subsystem Syntax

MEASure | FETCh [:SCALar] :POWer [:DC]? Returns the dc component of power :AC [:REAL]? Returns real power :APParent? Returns VA :REACtive? Returns VAR :PFACtor? Returns power factor :TOTal? Returns real 3-phase total power

MEASure:POWer? FETCh:POWer?

Phase Selectable These queries return the dc component of the power being sourced at the output terminals in

watts. Query Syntax MEASure[:SCALar]:POWer[:DC]?

FETCh[:SCALar]:POWer[:DC]? Parameters None Examples MEAS:POW? FETC:POW? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:POWer:AC? FETCh:POWer:AC?

Phase Selectable These queries return the in-phase component of power being sourced at the output terminals in

watts. Query Syntax MEASure[:SCALar]:POWer:AC[:REAL]?

FETCh[:SCALar]:POWer:AC[:REAL]? Parameters None Examples MEAS:POW:AC? FETC:POW:AC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:POWer:AC:APParent? FETCh:POWer:AC:APParent?

Phase Selectable These queries return the apparent power being sourced at the output terminals in volt-amperes.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:POWer:AC:APParent? FETCh[:SCALar]:POWer:AC:APParent? Parameters None Examples MEAS:POW:AC:APP? FETC:POW:AC:APP? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:POWer:AC:REACtive? FETCh:POWer:AC:REACtive?

Phase Selectable These queries return the reactive power being sourced at the output terminals in volt-amperes

reactive. Reactive power is computed as: VAR = sqrt(square(apparent power) - square(real power))

Query Syntax MEASure[:SCALar]:POWer:AC:REACtive? FETCh[:SCALar]:POWer:AC:REACtive? Parameters None Examples MEAS:POW:AC:REAC? FETC:POW:AC:REAC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:POWer:AC:PFACtor? FETCh:POWer:AC:PFACtor?

Phase Selectable These queries return the output power factor. The power factor is computed as: pfactor = real power/apparent power

Query Syntax MEASure[:SCALar]:POWer:AC:PFACtor? FETCh[:SCALar]:POWer:AC:PFACtor? Parameters None Examples MEAS:POW:AC:PFAC? FETC:POW:AC:PFAC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:POWer:AC:TOTal? FETCh:POWer:AC:TOTal?

These queries return the total power being sourced at the output terminals of a three-phase AC source.

Query Syntax MEASure[:SCALar]:POWer:AC:TOTal? FETCh[:SCALar]:POWer:AC:TOTal? Parameters None Examples MEAS:POW:AC:TOT? FETC:POW:AC:TOT? Returned Parameters <NR3>

Programming Manual Lx \ Ls Series II

4.12 Voltage Measurement Subsystem

This subsystem programs the voltage measurement capability of the Lx\Ls Series. Two measurement commands are available: MEASure and FETCh. MEASure triggers the acquisition of new measurement data before returning a reading. FETCh returns a reading computed from previously acquired data.

Individual outputs of a three-phase source are specified by the setting of INSTrument:NSELect.

Subsystem Syntax

MEASure | FETCh [:SCALar] :VOLTage [:DC]? Returns the dc component of the voltage :AC? Returns ac rms voltage :ACDC? Returns ac+dc rms voltage :HARMonic [:AMPLitude]? <n> Returns amplitude of the Nth harmonic of voltage :PHASe? <n> Returns phase of the Nth harmonic of voltage :THD? Returns % of total harmonic distortion of voltage :THD:MODE RMS | FUND Sets THD calculation to either RMS or Fundamental

mode.

MEASure:VOLTage? FETCh:VOLTage?

Phase Selectable These queries return the dc component of the output voltage being sourced at the output

terminals. Query Syntax MEASure[:SCALar]:VOLTage[:DC]?

FETCh[:SCALar]:VOLTage[:DC]? Parameters None Examples MEAS:VOLT? FETC:VOLT? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:VOLTage:AC? FETCh:VOLTage:AC?

Phase Selectable These queries return the ac rms voltage being sourced at the output terminals.

Query Syntax MEASure[:SCALar]:VOLTage:AC? FETCh[:SCALar]:VOLTage:AC? Parameters None Examples MEAS:VOLT:AC? FETC:VOLT:AC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:VOLTage:ACDC? FETCh:VOLTage:ACDC?

Phase Selectable These queries return the ac or dc rms voltage being sourced at the output terminals.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:VOLTage:ACDC? FETCh[:SCALar]:VOLTage:ACDC? Parameters None Examples MEAS:VOLT:ACDC? FETC:VOLT:ACDC? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:VOLTage:HARMonic? FETCh:VOLTage:HARMonic?

Phase Selectable These queries return the rms amplitude of the Nth harmonic of output voltage. The parameter is

Query Syntax MEASure[:SCALar]:VOLTage:HARMonic[:AMPLitude]?<NRf> FETCh[:SCALar]:VOLTage:HARMonic[:AMPLitude]?<NRf> Parameters 0 to 50 Examples MEAS:VOLT:HARM? 3 FETC:VOLT:HARM? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:VOLTage:HARMonic:PHASe? FETCh:VOLTage:HARMonic:PHASe?

Phase Selectable These queries return the phase angle of the Nth harmonic of output voltage, referenced to the

Query Syntax MEASure[:SCALar]:VOLTage:HARMonic:PHASe?<NRf> FETCh[:SCALar]:VOLTage:HARMonic:PHASe?<NRf> Parameters 0 to 50 Examples MEAS:VOLT:HARM:PHAS? 3 FETC:VOLT:HARM:PHAS? 1 Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:VOLTage:HARMonic:THD? FETCh:VOLTage:HARMonic:THD?

Phase Selectable These queries return the percentage of total harmonic distortion and noise in the output voltage.

Programming Manual Lx \ Ls Series II

Query Syntax MEASure[:SCALar]:VOLTage:HARMonic:THD? FETCh[:SCALar]:VOLTage:HARMonic:THD? Parameters None Examples MEAS:VOLT:HARM:THD? FETC:VOLT:HARM:THD? Returned Parameters <NR3> Related Commands INST:NSEL

MEASure:THDistortion:MODE

Lx/Ls units with firmware revision 0.88 or higher can be programmed to use the fundamental component as the denominator instead of the RMS value. This mode can only be programmed

over the bus by sending the “MEAS:THD:MODE FUND” command. At power up or after a reset

command, the mode will revert back to the RMS mode. This mode setting is not saved in any of the set up registers.

Programming Manual Lx \ Ls Series II

4.13 Output Subsystem

This subsystem controls the main outputs, the signal outputs, the power-on state, and the output protection function of the Lx/Ls Series.

Subsystem Syntax

OUTPut [:STATe] <bool> Enable/disable output voltage, current, power, etc. :DFI [:STATE] <bool> Enable/disable DFI output :SOURce <source> Selects an event source (QUES|OPER|ESB|RQS|OFF) :PON [:STATe] RST | RCL0 Set power-on state to *RST or *RCL0 :PROTection :CLEar Reset latched protection :DELay <n> Delay after programming/before protection :RI

[:LEVel] LOW | HIGH Sets Remote Inhibit input level mode.

OUTPut

This command enables or disables the AC source output. The state of a disabled output is an output voltage amplitude set to 0 volts, with output relays opened. When opening the output relay, the output is set to 0 volt first, then the output relay is opened. A user settable delay may be

inserted before the output relay is opened. See the “PONSetup:RELay” command for details.

Your application program should allow for this delay. (default is 0.1 sec or 100 msec). The query form returns the output state.

Command Syntax OUTPut[:STATe]<bool> Parameters 0 | OFF | 1 | ON *RST Value OFF Examples OUTP 1 OUTP:STAT ON Query Syntax OUTPut[:STATe]? Returned Parameters 0 | 1 Related Commands *RCL *SAV PONS:REL

OUTPut:DFI

This command enables or disables the discrete fault indicator (DFI) signal to the Lx\Ls Series. The DFI is an active high open collector output with internal pull up to 5Vdc. The pull up can be removed by removing W1 on the 7004-716 range/relay board.

Command Syntax OUTPut:DFI[:STATe]<bool> Parameters 0|1|OFF|ON *RST Value OFF Examples OUTP:DFI 1 OUTP:DFI OFF Query Syntax OUTPut:DFI[:STATe]? Returned Parameters 0 | 1 Related Commands OUTP:DFI:SOUR

Programming Manual Lx \ Ls Series II

OUTPut:DFI:SOURce

This command selects the source for DFI events. The choices are:

QUEStionable Questionable summary bit OPERation Operation summary bit ESB Standard Event summary bit RQS Request Service summary bit OFF Never true

Command Syntax OUTP:DFI:SOUR<source> Parameters QUES | OPER | ESP | RQS | OFF *RST Value OFF Examples OUTP:DFI:SOUR OPER Query Syntax OUTPut:DFI:SOUR? Returned Parameters <CRD> Related Commands OUTP:DFI

OUTPut:PON[:STATe]

This command selects the power-on state of the AC source. The following states can be selected:

RST Sets the power-on state to *RST. Refer to the *RST command as

described later in this chapter for more information.

RCL0 Sets the power-on state to *RCL 0. Refer to the *RCL command as

described later in this chapter for more information. Command Syntax OUTPut:PON[:STATE] <state>

Parameters RST | RCL0 Examples OUTP:PON:STAT RST Query Syntax OUTPut:PON:STATe? Returned Parameters <CRD> Related Commands *RST *RCL

OUTPut:PROTection:CLEar

This command clears the latch that disables the output when an overvoltage (OV), overcurrent (OC), overtemperature (OT), or remote inhibit (RI) fault condition is detected. All conditions that generated the fault must be removed before the latch can be cleared. The output is then restored to the state it was in before the fault condition occurred.

Command Syntax OUTPut:PROTection:CLEar Parameters None Examples OUTP:PROT:CLE Related Commands OUTP:PROT:DEL *RCL *SAV

Programming Manual Lx \ Ls Series II

OUTPut:PROTection:DELay

This command sets the delay time between the programming of an output change that produces a CL or UNREG status condition and the recording of that condition by the Status Operation Condition register. The delay prevents momentary changes in status that can occur during programming from being registered as events by the status subsystem. In most cases these temporary conditions are not considered an event, and to record them as such would be a nuisance.

Command Syntax OUTPut:PROTection:DELay<NRf> Parameters 0 to 32 | MINimum | MAXimum Unit S (seconds) *RST Value 100 milliseconds Examples OUTP:PROT:DEL 75E-1 Query Syntax OUTPut:PROTection:DELay? Returned Parameters <NR3> Related Commands OUTP:PROT:CLE *RCL *SAV

OUTPut:RI[:LEVel]

This command sets the remote inhibit level mode. Factory default is LOW, which requires a contact closure to open the output relay. The level can be reversed by setting it to HIGH. Once set, the RI level setting is retained each time the power source is powered up. Note that this command is only implement with firmware revision 1.69 or higher. Lower firmware revisions only provide the default LOW setting.

Command Syntax OUTPut:RI:LEVel Parameters LOW | HIGH *RST Value LOW Examples OUTP:RI:LEV HIGH Query Syntax OUTP:RI:LEV? Returned Parameters <CRD> Related Commands OUTP OUTP:RI:MODE

OUTPut:RI:MODE

This command selects the mode of operation of the Remote Inhibit protection. The following modes can be selected:

LATChing A TTL low at the RI input latches the output in the protection shutdown

state, which can only be cleared by OUTPut:PROTection:CLEar.

LIVE The output state follows the state of the RI input. A TTL low at the RI

input turns the output off; a TTL high turns the output on.

OFF The instrument ignores the RI input.

The RI output state is saved as part of an instrument setup using the *SAV command. It can be made part of the power on setting if needed. The default state is LIVE.

Command Syntax OUTPut:RI:MODE <mode> Parameters LATChing | LIVE | OFF *RST Value OFF Examples OUTP:RI:MODE LIVE Query Syntax OUTPut:RI:MODE? Returned Parameters <CRD> Related Commands OUTP:PROT:CLE OUTP:RI:LEV

Programming Manual Lx \ Ls Series II

OUTPut:TTLTrg:MODE

This command sets the operation of the Trigger Out1 signal to either Function Strobe or Trigger mode. Factory default is Trigger state which means the OUTP:TTLT:STAT command is required to generate outputs. This mode is compatible with the Agilent HP6834B models. In Function Strobe mode, an output pulse is generated automatically any time an output parameter such as voltage, frequency or phase is programmed. The AC source Trigger Out1 signal is available at a SMA connector on the rear of the Lx\Ls Series units.

Command Syntax OUTPut:TTLTrg:MODE TRIG | FSTR Parameters TRIG | FSTR *RST Value TRIG Examples OUTP:TTLT:MODE FSTR Query Syntax OUTPut:TTLTrg:MODE? Returned Parameters <CRD> Related Commands OUTP:TTLT:STAT

Programming Manual Lx \ Ls Series II

OUTPut:TTLTrg[:STATe]

This command enables or disables the AC source Trigger Out1 signal, which is available at a SMA connector on the rear of the Lx\Ls Series units.

Command Syntax OUTPut:TTLTrg[:STATe]<bool> Parameters 0|1|OFF|ON *RST Value OFF Examples OUTP:TTLT 1 OUTP:TTLT OFF Query Syntax OUTPut:TTLTrg[:STATe]? Returned Parameters 0 | 1 Related Commands OUTP:TTLT:SOUR

OUTPut:TTLTrg:SOURce

This command selects the signal source for the Trig Out1 signal as follows:

BOT Beginning of transient output EOT End of transient output LIST Specified by the TTLTrg list

When an event becomes true at the selected TTLTrg source, a pulse is sent to the SMA connector on the rear of the AC source.

Command Syntax OUTPut:TTLTrg:SOURce<source> Parameters BOT | EOT | LIST *RST Value BOT Examples OUTP:TTLT:SOUR LIST Query Syntax OUTPut:TTLTrg:SOURce? Returned Parameters <CRD> Related Commands OUTP:TTLT

Programming Manual Lx \ Ls Series II

4.14 Power On Subsystem

This subsystem controls the specific configuration settings at power on. Most power on settings are determined by the power on register recall state using the OUTPut:PON:STATe command. Some aspects are not part of a register however and must be controlled using the PONS commands.

Subsystem Syntax

[SOURce:]PONSetup :CLOCk STD | MAST | AUX :PEAK:CURRent[:PROTection] Disables peak current protection. :RELay:HOLD Sets output off relay open delay in seconds. :SYNChronize[:SOURce] EXTernal | LINE

PONSetup:CLOCk

This command is used to set the clock and lock mode at power up. It is factory set and should not be changed unless the configuration has been modified in the field. Units with the –LKM option are fixed to MAST mode. Units with the –LKS option can be set to either STANdalone or AUX. When set to AUX, the –LKS unit will power up in external clock mode. When set to STANDalone, the –LKS unit will power up in internal clock mode. The –LKM unit always powers up in internal clock mode. It‟s clock state cannot be changed.

Command Syntax PONSetup:CLOCk Parameters STANdalone | MASTer | AUXiliary Examples PONS:CLOC Query Syntax PONS:CLOC? Returned Parameters <CRD> Related Commands None

PONSetup:PEAK:CURRent[:PROTection]

This command can be used to disable the peak current shutdown mode. It is factory disabled and should be left disabled for most situations. This command is not available on the HP6834B/CI4500iL.

Command Syntax PONSetup:PEAK:CURRent[:PROTection] Parameters 0 | 1 | OFF | ON Examples PONS:PEAK:CURR 1 Query Syntax PONS:PEAK:CURR? Returned Parameters 0 | 1 Related Commands OUTP:PROT:DEL

PONSetup:SYNChronize[:SOURce]

This command can be used to set the initial sync mode between External Sync or Line Sync. This requires the –EXT or –LNS option respectively. This command is supported in firmware revision

1.50 and higher. Command Syntax PONSetup:SYNChronize:[:SOURce]

Parameters EXTernal | LINE Examples PONS:SYNC:SOUR EXT Query Syntax PONS:SYNC:SOUR? Returned Parameters <CRD> Related Commands FREQuency:MODE SENSe

Programming Manual Lx \ Ls Series II

PONSetup:RELay[:HOLD]

This command is used to set a delay time between programming down the output voltage to 0 volt and opening the output relay. This provides some time for any inductive loads connected at the output of the power source to discharge into the amplifiers before opening the output relays

(OUTP 0 command or front panel On/Off).. Without this delay, inducative EUT‟s may kick up a

high flyback voltage. The same delay time is also used to program down and hold the voltage to zero volt before switching the voltage range relays when performing a voltage range change. (VOLT:RANG command or front panel RANGE change).

The default delay is set to 0.1 or 100 msec. This delay can be set to a value from 0.000 to 1.000 seconds. Once set, it is recalled at power up. Note that this delay affects the time it takes to execute the OUTP 0 and the VOLT:RANG commands. If a delay is set, the bus will be held by this amount of time while the power source executes either of these commands.

Note that this delay time is approximate only and may vary somewhat from unit to unit. Command Syntax PONSetup:RELay[:HOLD]

Parameters 0.000 through 1.000 Examples PONS:REL 0.2 Query Syntax PONS:REL? Returned Parameters <NR3> Related Commands OUTP 1 VOLT:RANG

Programming Manual Lx \ Ls Series II

4.15 Sense Subsystem - Sweep

This subsystem controls the measurement current range and the data acquire sequence of the AC source.

Subsystem Syntax

SENSe [:COUPle] AC | DC ADC coupling mode. :SWEep :OFFSet Define trigger delay in time relative to start of the

digitizer data record

:POINts <n> Define trigger points relative to the start of the

digitizer data record

:TINTerval <n> Sets the digitizer sample spacing

SENSe[:COUPle]

This command sets the coupling mode for the ADC of the measurement system. Available coupling modes are AC or DC. Factory default is DC coupled. This command requires firmware revision 0.95 or higher.

Command Syntax SENSe[:COUPle] <CRD> Parameters AC | DC *RST Value DC Examples SENS:COUP DC Query Syntax SENS:COUP? Returned Parameters <CRD> Related Commands SENS:SWE:TINT

SENSe:SWEep:OFFSet

This command defines the trigger point expressed in seconds relative to the start of the returned data record when an acquire trigger is used. The values can range from MIN to MAX depending on the phase mode and the selected sample interval. When the values are negative, the values in the beginning of the data record represent samples taken prior to the trigger.

Command Syntax SENSe:SWEep:OFFSet <NRf+> Parameters <NRf> | MINimum | MAXimum *RST Value 0 Examples SENS:SWE:OFFS -12E-3 Query Syntax SENSe:SWEep:OFFSet? Returned Parameters <NR3> Related Commands SENS:SWE:TINT MEAS:ARR

SENSe:SWEep:OFFSet:POINts

This command defines the trigger point expressed in sample points relative to the start of the returned data record when an acquire trigger is used. The values can range from -4095 to 2E9. When the values are negative, the values in the beginning of the data record represent samples taken prior to the trigger.

Programming Manual Lx \ Ls Series II

Command Syntax SENSe:SWEep:OFFSet:POINts<NRf+> Parameters 4096 through 2E9 | MINimum | MAXimum *RST Value 0 Examples SENS:SWE:OFFS:POIN -2047 Query Syntax SENSe:SWEep:OFFSet:POINts? Returned Parameters <NR3> Related Commands SENS:SWE:TINT MEAS:ARR

SENSe:SWEep:TINTerval

This command defines the time period between samples. The sample period can be programmed from 10.42 to 104.2 microseconds in 10 microsecond increments in single-phase mode and from

31.25 to 312.5 microseconds in three-phase mode. All the MEASure commands use the ACQuire trigger sequence implicitly.

Command Syntax SENSe:SWEep:TINTerval<NRf+> Parameters 10.42 through 104.2 (microseconds) *RST Value 10.42 µs or 31.25 µs Examples SENS:SWE:TINT 100 Query Syntax SENSe:SWEep:TINTerval? Returned Parameters <NR3> Related Commands SENS:SWE:OFFS:POIN MEAS:ARR

Programming Manual Lx \ Ls Series II

4.16 Source Subsystem - Current

This subsystem programs the output current of the AC source.

Subsystem Syntax

[SOURce:] CURRent [:LEVel] [:IMMediate] [:AMPLitude] <n> Sets the rms current limit :PROTection :DELay Current limit fault delay :STATe <bool> Enable/Disable rms current limit protection

CURRent

Phase Selectable This command sets the rms current limit of the specified output phase. If the output current

exceeds this limit, the output voltage amplitude is reduced until the rms current is within the limit. The CL bit of the questionable status register indicates that the current limit control loop is active. If the current protection state is programmed on, the output latches into a disabled state when current limiting occurs.

Note that the CURRent command is coupled with the VOLTage:RANGe.This means that the maximum current limit that can be programmed at a given time depends on the voltage range setting in which the unit is presently operating. Refer to Section 6.3 under "Coupled Commands" for more information. To determine the maximum available current, use the “curr? max” query

Command Syntax [SOURce:]CURRent[:LEVel] [:IMMediate][:AMPLitude]<NRf+> Parameters 0 to max. available current Unit: A (rms amperes) *RST 1 Examples CURR 5.0 CURR:LEV .5.0 Query Syntax [SOURce:]CURRent[:LEVel] [:IMMediate][:AMPLitude]? Returned Parameters <NR3> Related Commands CURR:PROT:STAT VOLT:RANG

CURRent:PROTection:DELay

This command holds off the over current trip of the output voltage for the time specified. Default value at *RST is 0.1 sec. The range is from 0.1 to 5.000 secs and can be queried with the CURR:PROT:DEL? MIN and CURR:PROT:DEL? MAX commands.

Command Syntax [SOURce:]CURRent:PROTection:DELay <NRf+> Parameters 0.100 to 5.000 | MINimum | MAXimum Unit: S (seconds) *RST Value 0.100 Examples CURR:PROT:DEL 1.5 Query Syntax [SOURce:]CURRent:PROTection:DELay?

CURRent:PROTection:DELay? Min

CURRent:PROTection:DELay? Max Returned Parameters <NR3> Related Commands CURR:PROT:STAT

Programming Manual Lx \ Ls Series II

CURRent:PROTection:STATe

This command enables or disables the AC source overcurrent (OC) protection function. If the overcurrent protection function is enabled and the AC source exceeds the programmed level, then the output is disabled and the Questionable Condition status register OC bit is set (see Chapter

7). An overcurrent condition can be cleared with OUTPut:PROTection:CLEar after the cause of the condition is removed.

Use OUTP:PROT:DEL to prevent momentary current limit conditions caused by programmed output changes from tripping the over current protection. Use CURR:PROT:DEL to hold off tripping the output due to temporary overload conditions.

Command Syntax [SOURce:]CURRent:PROTection:STATe<bool> Parameters 0 | 1 | OFF | ON *RST Value OFF Examples CURR:PROT:STAT 0 CURR:PROT:STAT OFF Query Syntax [SOURce:]CURRent:PROTection:STATe? Returned Parameters 0 | 1 Related Commands OUTP:PROT:CLE CURR:PROT:DEL

Programming Manual Lx \ Ls Series II

4.17 Source Subsystem - Frequency

This subsystem programs the output frequency of the AC source. Subsystem Syntax [SOURce:]

FREQuency

This command sets the frequency of the output waveform. Command Syntax [SOURce:]FREQuency[:CW|:IMMediate]<NRf+>

Parameters 45 to 5000 Unit HZ (Hertz) *RST Value 60 Hz Examples FREQ 50 Query Syntax [SOURce:]FREQuency? Returned Parameters <NR3> Related Commands FREQ:MODE FREQ:SLEW

FREQuency:MODE

This command determines how the output frequency is controlled. Available modes are:

FIXed The output frequency is unaffected by a triggered output transient. The

clock source is the internal controller timebase.

STEP The output frequency is programmed to the value set by

FREQuency:TRIGgered when a triggered transient occurs.

PULSe The output frequency is changed to the value set by

FREQuency:TRIGgered for a duration determined by the pulse

commands.

LIST The output frequency is controlled by the frequency list when a triggered

transient occurs.

SENSe External sync or line sync clock mode. The frequency is synchronized to

the external sync or line sync frequency. See Lx/Ls user manuals for

sync operation details.

EXTernal External clock mode. This mode is used on an Lx/Ls unit with the –LKS

option to sync to a master Lx/Ls unit. Command Syntax [SOURce:]FREQuency:MODE<mode>

Programming Manual Lx \ Ls Series II

FREQuency:SLEW

This command sets the rate at which frequency changes for all programmed changes in output frequency. Instantaneous frequency changes can be obtained by sending MAXimum or INFinity. The SCPI keyword INFinity is represented by the number 9.9E37.

Command Syntax [SOURce:]FREQuency:SLEW[:IMMediate]<NRf+> |INFinity Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum Unit HZ (Hertz per second) *RST Value MAXimum Examples FREQ:SLEW:IMM 75 FREQ:SLEW MAX Query Syntax [SOURce:]FREQuency:SLEW? Returned Parameters <NR3> Related Commands FREQ:SLEW:MODE FREQ

FREQuency:SLEW:MODE

This command determines how the frequency slew rate is controlled during a triggered output transient. The choices are:

FIXed The frequency slew rate is unaffected by a triggered output transient. STEP The frequency slew rate is programmed to the value set by

FREQuency:TRIGgered when a triggered transient occurs.

PULSe The frequency slew rate is changed to the value set by

FREQuency:TRIGgered for a duration determined by the pulse

commands.

LIST The frequency slew rate is controlled by the frequency list when a

triggered transient occurs. Command Syntax [SOURce:]FREQuency:SLEW:MODE<mode>

Parameters FIXed | STEP | PULSe | LIST *RST Value FIXed Examples FREQ:SLEW:MODE FIX Query Syntax [SOURce:]FREQuency:SLEW:MODE? Returned Parameters <CRD> Related Commands FREQ FREQ:SLEW:TRIG

FREQency:SLEW:TRIGgered

This command sets the rate at which frequency changes during a triggered output transient. Instantaneous frequency changes can be obtained by sending MAXimum or INFinity. The SCPI keyword INFinity is represented by the number 9.9E37.

Command Syntax [SOURce:]FREQuency:SLEW:TRIGgered<NRf+> |INFinity Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum Unit HZ (Hertz per second) *RST Value MAXimum Examples FREQ:SLEW:TRIG 75 FREQ:SLEW:TRIG MAX Query Syntax [SOURce:]FREQuency:SLEW:TRIG? Returned Parameters <NR3> Related Commands FREQ:SLEW:MODE FREQ

Programming Manual Lx \ Ls Series II

FREQuency:TRIGgered

This command programs the frequency that the output will be set to during a triggered step or pulse transient.

Command Syntax [SOURce:]FREQuency:TRIGgered<NRf+> Parameters Refer to specifications table in User Manual Unit HZ (Hertz) *RST Value 60 Hz Example FREQ:TRIG 50 Query Syntax [SOURce:]FREQuency:TRIGgered? Returned Parameters <NR3> Related Commands FREQ FREQ:MODE

Programming Manual Lx \ Ls Series II

4.18 Source Subsystem - Function

This subsystem programs the output function of the AC source.

Subsystem Syntax

[SOURce:] FUNCtion [:SHAPe] [:IMMediate] <shape> Sets the periodic waveform shape

(SIN|SQU|CSIN|<user-defined>) :CSINusoid <n> [THD] Sets the % of peak at which the clipped sine clips (or %

THD)

FUNCtion

This command selects the shape of the output voltage waveform as follows:

SINusoid A sinewave is output SQUare A squarewave is output CSINusoid The output is a clipped sine waveform. Both positive and negative peak

amplitudes are clipped at a value determined by the SOURce:FUNCtion:SHAPe:CSINusoid setting.

<user_defined> The output shape is described by one of the user-defined waveform

tables.

The maximum peak voltage that the AC source can output is 425 V peak. This includes any combination of voltage and function shape values. Therefore, the maximum value that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a sinewave, the maximum voltage that can be programmed is 300 V rms.

Before programming a different waveform shape, the output voltage should be programmed to zero volts. After the shape is changed, the voltage maybe programmed to the desired value.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Command Syntax [SOURce:]FUNCtion[:SHAPe][:IMMediate]<shape> Parameters SINusoid|SQUare|CSINusoid|<waveform_name> *RST Value SINusoid Examples FUNC SIN FUNC USERNAME Query Syntax [SOURce:]FUNCtion[:SHAPe]? Returned Parameters <CRD> Related Commands FUNC:MODE FUNC:TRIGVOLT

FUNCtion:MODE

This command determines how the waveform shape is controlled during a triggered output transient. The choices are:

FIXed The waveform shape is unaffected by a triggered output transient. STEP The waveform shape is programmed to the value set by

FUNCtion:TRIGgered when a triggered transient occurs.

Programming Manual Lx \ Ls Series II

PULSe The waveform shape is changed to the value set by

FUNCtion:TRIGgered for a duration determined by the pulse commands.

LIST The waveform shape is controlled by the waveform shape list when a

triggered transient occurs.

Command Syntax [SOURce:]FUNCtion[:SHAPe]:MODE<mode> Parameters FIXed | STEP | PULSe | LIST *RST Value FIXed Examples FUNC:MODE FIX Query Syntax [SOURce:]FUNCtion[:SHAPe]:MODE? Returned Parameters <CRD> Related Commands FUNC FUNC:TRIG

FUNCtion:TRIGgered

This command selects the shape of the output voltage waveform when a triggered step or pulse transient occurs. The parameters are:

SINusoid A sinewave is output SQUare A squarewave is output CSINusoid The output is a clipped sine waveform. Both positive and negative peak

amplitudes are clipped at a value determined by SOURce:FUNCtion:SHAPe:CSINusoid.

<waveform_name> The output shape is described by one of the user-defined waveform

tables.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Command Syntax [SOURce:]FUNCtion[:SHAPe]:TRIGgered<shape> Parameters SINusoid|SQUare|CSINusoid|<waveform_name> *RST Value SINusoid Examples FUNC:TRIG SIN FUNC:TRIG TABLE1 Query Syntax [SOURce:]FUNCtion[:SHAPe]:TRIGgered? Returned Parameters <CRD> Related Commands FUNC FUNC:MODEVOLT

FUNCtion:CSINusoid

This command sets the clipping level when a clipped sine output waveform is selected. The clipping characteristics can be specified in two ways:

The clipping level is expressed as a percentage of the peak amplitude at which clipping

occurs. The range is 1.33 to 100. These are the default units when the optional THD suffix is not sent.

The clipping level is expressed at the percentage of total harmonic distortion in the output

voltage. The range is 0 to 43 percent. The optional THD suffix is sent to program in these units.

Programming Manual Lx \ Ls Series II

Command Syntax [SOURce:]FUNCtion[:SHAPe]:CSINusoid<NRf>[THD] Parameters 1.33 to 100 | 0 to 43 THD *RST Value 100 | 0 THD (no clipping) Examples FUNC:CSIN 80 FUNC:CSIN 10 THD Query Syntax [SOURce:]FUNCtion[:SHAPe]:CSINusoid? Returned Parameters <NR3> Related Commands FUNC:MODE

Programming Manual Lx \ Ls Series II

4.19 Source Subsystem - List

This subsystem controls the generation of complex sequences of output changes with rapid, precise timing and synchronized with internal or external signals. Each subsystem command for which lists can be generated has an associated list of values that specify the output at each list step. LIST:COUNt determines how many times the AC source sequences through a list before that list is completed. LIST:DWELl specifies the time interval that each value (point) of a list is to remain in effect. LIST:STEP detemines if a trigger causes a list to advance only to its next point or to sequence through all of its points.

All active subsystems that have their modes set to LIST must have the same number of points (up to 100), or an error is generated when the first list point is triggered. The only exception is a list consisting of only one point. Such a list is treated as if it had the same number of points as the other lists, with all of the implied points having the same value as the one specified point. All list point data is stored in nonvolatile memory.

MODE commands such as VOLTage:MODE LIST are used to activate lists for specific functions (See . However, the LIST:DWELl command is active whenever any function is set to list mode. Therefore, LIST:DWELl must always be set either to one point, or to the same number of points as the active list.

Subsystem Syntax

[SOURce:] LIST :COUNt <n> | INFinity Sets the list repeat count :DWELl <n>{,<n>} Sets the list of dwell times :POINts? Returns the number of dwell list points :FREQuency [:LEVel] <n>{,<n>} Sets the frequency list :POINts? Returns the number of frequency points :SLEW <n>{,<n>} Sets the frequency slew list :POINts? Returns the number of frequency slew points :MODE BOT | EOT Sets the list operation mode :PHASe <n>{,<n>} Sets the phase list :POINts? Returns the number of phase list points :SHAPe <shape>{,<shape>} Sets the waveform shape list :POINts? Returns the number of shape list points :STEP ONCE | AUTO Defines whether list is dwell- or trigger-paced :TTLTrg <bool>{,<bool>} Defines the output marker list :POINts? Returns the number of output marker list points :VOLTage [:LEVel] <n>{,<n>} Sets the voltage list :POINts? Returns the number of voltage level points :SLEW <n>{,<n>} Sets the voltage slew list :POINts? Returns the number of voltage slew points

Programming Manual Lx \ Ls Series II

LIST:COUNt

This command sets the number of times that the list is executed before it is completed. The command accepts parameters in the range 1 through 2E8. Use MAX to set the list to maximum.

Command Syntax [SOURce:]LIST:COUNt<NRf+> | MAX Parameters 1 to 2E8 | MINimum | MAXimum *RST Value 1 Examples LIST:COUN 3 LIST:COUN INF Query Syntax [SOURce:]LIST:COUNt? Returned Parameters <NR3> Related Commands LIST:CURRLIST:FREQ LIST:TTLTLIST:VOLT

LIST:DWELl

This command sets the sequence of list dwell times. Each value represents the time in seconds that the output will remain at the particular list step point before completing the step. At the end of the dwell time, the output of the AC source depends upon the following conditions:

If LIST:STEP AUTO has been programmed, the output automatically changes to the next

point in the list.

If LIST:STEP ONCE has been programmed, the output remains at the present level until a

trigger sequences the next point in the list.

The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Command Syntax [SOURce:]LIST:DWELl<NRf+>{,<NRf+>} Parameters 3-phase mode: 0 to 1.07533E6|MINimum|MAXimum 1-phase mode: 0 to 4.30133E5|MINimum|MAXimum Unit S (seconds) Examples LIST:DWEL .5,.5,1.5 Query Syntax [SOURce:]LIST:DWEL? Returned Parameters <NR3> Related Commands LIST:FREQ LIST:TTLT LIST:VOLT

LIST:DWELl:POINts?

This query returns the number of points specified in LIST:DWELl. Note that it returns only the total number of points, not the point values.

Query Syntax [SOURce:]LIST:DWELl:POINts? Returned Parameters <NR1> Example LIST:DWEL:POIN? Related Commands LIST:DWEL

LIST:FREQuency

This command sets the sequence of frequency list points. The frequency points are given in the command parameters, which are separated by commas.

The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Programming Manual Lx \ Ls Series II

Command Syntax [SOURce:]LIST:FREQuency[:LEVel]<NRf+>{,<NRf+>} Parameters 45 to 5000 Unit HZ (Hertz) Examples LIST:FREQ 60,65,70 Query Syntax [SOURce:]LIST:FREQ? Returned Parameters <NR3> Related Commands LIST:FREQ:POIN? LIST:COUN LIST:DWEL LIST:STEP LIST:FREQ:SLEW

LIST:FREQuency:POINts?

This query returns the number of points specified in LIST:FREQuency. Note that it returns only the total number of points, not the point values.

Query Syntax [SOURce:]LIST:FREQ[:LEVel]:POINts? Returned Parameters <NR1> Example LIST:FREQ:POIN? Related Commands LIST:FREQ

LIST:FREQuency:SLEW

This command sets the sequence of frequency slew list points. The frequency points are given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Command Syntax [SOURce:]LIST:FREQuency:SLEW<NRf+>{,<NRf+>} Parameters 0 to 9.9E31 | INFinity Unit HZ (Hertz) per second Examples LIST:FREQ:SLEW 10, 1E2, INF Query Syntax [SOURce:]LIST:FREQ:SLEW? Returned Parameters <NR3> Related Commands LIST:FREQ:SLEW:POIN? LIST:COUN LIST:DWEL LIST:STEP LIST:FREQ

LIST:FREQuency:SLEW:POINts?

This query returns the number of points specified in LIST:FREQuency:SLEW. Note that it returns only the total number of points, not the point values.

Query Syntax [SOURce:]LIST:FREQ:SLEW:POINts? Returned Parameters <NR1> Example LIST:FREQ:SLEW:POIN? Related Commands LIST:FREQ:SLEW

LIST:MODE

This command sets the mode of operation for the transient list system. The default mode after *RST is always BOT. In BOT mode, the output of the power source will return to the steady state program values when the transient list execution completes. This mode is compatible with the HP843B and CI iL series power sources. In EOT mode, the output of the power source will remain at the final value reached at the end of the transient list execution. This mode is compatible with other CI power source models. This command requires firmware revision 1.31 or higher.

This mode is not stored in any setup register so the unit will always revert to BOT mode at power up or after a *RST command.

Note that sending the ABORT command will always cause the output to revert to the last steady state program values.

Programming Manual Lx \ Ls Series II

Command Syntax [SOURce:]LIST:MODE Parameters BOT | EOT Examples LIST:MODE EOT Query Syntax [SOURce:]LIST:MODE? Returned Parameters <CRD> Related Commands LIST:COUN LIST:DWEL LIST:STEP

LIST:PHASe

Phase Selectable This phase selectable command sets the sequence of phase list points. The phase points are

given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which they are output when a list is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Command Syntax [SOURce:]LIST:PHASe<NRf+>{,<NRf+>} Parameters 360 through +360 Examples LIST:PHAS 90,120,135 Query Syntax [SOURce:]LIST:PHAS? Returned Parameters <NR3> Related Commands LIST:PHAS:POIN? LIST:COUN LIST:DWEL LIST:STEP

LIST:PHASe:POINts?

This query returns the number of points specified in LIST:PHASe. Note that it returns only the total number of points, not the point values.

Query Syntax SOURce:]LIST:PHASe:POINts? Returned Parameters NR3> Example IST:PHAS:POIN? Related Commands IST:FREQ LIST:DWEL

LIST:SHAPe

This command sets the sequence of the waveform shape entries. The order in which the shapes are given determines the sequence in which the list of shape will be output when a list transient is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt. The following shapes may be specified:

SINusoid A sinewave is output SQUare A squarewave is output CSINusoid The output is a clipped sine waveform. Both positive and negative peak

amplitudes are clipped at a value determined by the SOURce:FUNCtion:SHAPe:CSINusoid setting.

<waveform_name> The output shape is described by one of the user-defined waveform

tables.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Programming Manual Lx \ Ls Series II

Command Syntax [SOURce:]LIST:SHAPe<shape>{,<shape>} Parameters SINusoid|SQUare|CSINusoid|<waveform_name> Examples LIST:SHAP Query Syntax [SOURce:]LIST:SHAP? Returned Parameters <CRD> Related Commands LIST:SHAP:POIN? LIST:COUN LIST:DWEL LIST:STEP LIST:VOLT

LIST:SHAPe:POINts?

This query returns the number of points specified in LIST:SHAP. Note that it returns only the total number of points, not the point values.

Query Syntax [SOURce:]LIST:SHAPe:POINts? Returned Parameters <NR1> Example LIST:SHAP:POIN? Related Commands LIST:SHAP

LIST:STEP

This command specifies how the list sequencing responds to triggers. ONCE causes the list to advance only one point after each trigger. Triggers that arrive during a

dwell delay are ignored. AUTO causes the entire list to be output sequentially after the starting trigger, paced by its dwell

delays. As each dwell delay elapses, the next point is immediately output. Command Syntax [SOURce:]LIST:STEP<step>

Parameters ONCE | AUTO *RST Value AUTO Examples LIST:STEP ONCE Query Syntax [SOURce:]LIST:STEP? Returned Parameters <CRD> Related Commands LIST:COUN LIST:DWEL

LIST:TTLTrg

This command sets the sequence of Trigger Out list points. Each point which is set ON will cause a pulse to be output at Trigger Out when that list step is reached. Those entries which are set OFF will not generate Trigger Out pulses. The order in which the list points are given determines the sequence in which Trigger Out pulses will be output when a list transient is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Command Syntax [SOURce:]LIST:TTLTrg<bool>{,<bool>} Parameters 0 | 1 | OFF | ON Examples LIST:TTLT 1,0,1 LIST:TTLT ON,OFF,ON Query Syntax LIST:TTLT? Returned Parameters 0 | 1 Related Commands LIST:TTLT:POIN? LIST:COUN LIST:DWEL LIST:STEP OUTP:TTLT:STAT OUTP:TTLT:SOUR

LIST:TTLTrg:POINts?

This query returns the number of points specified in LIST:TTLT. Note that it returns only the total number of points, not the point values.

Programming Manual Lx \ Ls Series II

Query Syntax [SOURce:]LIST:TTLTrg:POINts? Returned Parameters <NR1> Example LIST:TTLT:POIN? Related Commands LIST:TTLT

LIST:VOLTage

This command specifies the output voltage points in a list. The voltage points are given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which the list will be output when a list transient is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

The maximum peak voltage that the AC source can output is 425 V peak. This includes any combination of voltage, voltage offset, and function shape values. Therefore, the maximum value that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a sinewave, the maximum voltage that can be programmed is 300 V rms.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Command Syntax [SOURce:]LIST:VOLTage[:LEVel] <NRf+>{,<NRf+>} Parameters 0 to 300 (for sinewaves) Unit V (rms voltage) Examples LIST:VOLT 2.0,2.5,3.0 LIST:VOLT MAX,2.5,MIN Query Syntax [SOURce:]LIST:VOLTage[:LEVel]? Returned Parameters <NR3> Related Commands LIST:VOLT:POIN? LIST:COUN LIST:DWEL LIST:STEP LIST:SHAP LIST:VOLT:OFFS

LIST:VOLTage:POINts?

This query returns the number of points specified in LIST:VOLT. Note that it returns only the total number of points, not the point values.

Query Syntax [SOURce:]LIST:VOLTage:POINts? Returned Parameters <NR1> Example LIST:VOLT:POIN? Related Commands LIST:VOLT

LIST:VOLTage:SLEW

This command specifies the output offset slew points in a list. The slew points are given in the command parameters, which are separated by commas. The order in which the points are entered determines the sequence in which the list will be output when a list transient is triggered. Changing list data while a subsystem is in list mode generates an implied ABORt.

Command Syntax [SOURce:]LIST:VOLTage:SLEW <NRf+>{,<NRf+>} Parameters 1E-4 to 9.9E37 | INFinity | MINimum | MAXimum Unit V/S (volts per second) Example LIST:VOLT:SLEW 10, 1E2, INF Query Syntax [SOURce:]LIST:VOLTage:SLEW? Returned Parameters <NR3> Related Commands LIST:VOLT:SLEW:POIN? LIST:COUN LIST:DWEL LIST:STEP

LIST:VOLTage:SLEW:POINts?

This query returns the number of points specified in LIST:VOLTage:SLEW. Note that it returns only the total number of points, not the point values.

Programming Manual Lx \ Ls Series II

Query Syntax [SOURce:]LIST:VOLTage:SLEW:POINts? Returned Parameters <NR1> Example LIST:VOLT:SLEW:POIN? LIST:VOLT:SLEW:POIN? MAX Related Commands LIST:VOLT:SLEW

Programming Manual Lx \ Ls Series II

4.20 Source Subsystem - Phase

This subsystem programs the output phases of the AC source. When phase commands are used to program single-phase units, the only discernible effect in using the phase commands is to cause an instantaneous shift in the output waveform phase.

Subsystem Syntax

[SOURce:] PHASe [:IMMediate] <n> Sets the output phase :MODE <mode> Sets the phase mode (FIX|STEP|PULS|LIST) :TRIGgered <n> Sets the triggered phase (step or pulse mode only)

PHASe

Phase Selectable This commands sets the phase of the output voltage waveform relative to an internal reference.

The phase angle is programmed in degrees. Positive phase angles are used to program the leading phase, and negative phase angles are used to program the lagging phase.

The PHASe command is not influenced by INSTrument:COUPle ALL. It applies only to the current output phase selected by INSTrument:NSELect.

Command Syntax [SOURce:]PHASe[IMMediate]<NRf+> Parameters -360º through +360º *RST Value phase ø1 = 0°, phase ø2 = 240°, phase ø3 = 120° Examples PHAS 45 PHASE MAX Query Syntax [SOURce:]PHASe? Returned Parameters <NR3> Related Commands PHAS:MODE PHAS:TRIG

PHASe:MODE

Phase Selectable This command determines how the output phase is controlled during a triggered output transient.

The choices are:

FIXed The output phase is unaffected by a triggered output transient. STEP The output phase is programmed to the value set by PHASe:TRIGgered

when a triggered transient occurs.

PULSe The output phase is changed to the value set by PHASe:TRIGgered for a

duration determined by the pulse commands.

LIST The waveform shape is controlled by the phase list when a triggered

transient occurs.

Command Syntax [SOURce:]PHASe:MODE<mode> Parameters FIXed | STEP | PULSe | LIST *RST Value FIX Examples PHAS:MODE LIST PHAS:MODE FIX Query Syntax [SOURce:]PHASe:MODE? Returned Parameters <CRD> Related Commands PHAS:TRIG PHAS

PHASe:TRIGgered

Programming Manual Lx \ Ls Series II

Phase Selectable This command sets the output phase when a triggered step or pulse transient occurs. The phase

of the output voltage waveform is expressed relative to an internal reference. The phase angle is programmed in degrees. Positive phase angles are used to program the leading phase, and negative phase angles are used to program the lagging phase.

The PHASe command is not influenced by INSTrument:COUPle ALL. It applies only to the current output phase selected by INSTrument:NSELect.

Command Syntax [SOURce:]PHASe:TRIGgered<NRf+> Parameters -360° through +360° *RST Value triggered phase ø1 = 0°, triggered phase ø2 = 120°, triggered phase ø3 = 240° Examples PHAS:TRIG 120 PHASE MAX Query Syntax [SOURce:]PHASe:TRIGgered? Returned Parameters <NR3> Related Commands PHAS:MODE PHAS

Programming Manual Lx \ Ls Series II

4.21 Source Subsystem - Pulse

This subsystem controls the generation of output pulses. The PULSe:DCYCle, PULSe:HOLD, PULSe:PERiod, and PULSe:WIDTh commands are coupled, which means that the values programmed by any one of these commands can be affected by the settings of the others. Refer to the tables under PULSe:HOLD for an explanation of how these commands affect each other.

Subsystem Syntax [SOURce:]

PULSe :COUNt <n> | INFinity Selects transient pulse count :DCYCle <n> Selects pulse duty cycle :HOLD WIDTh |DCYCle Selects parameter that is held constant :PERiod <n> Selects pulse period when the count is greater than 1 :WIDTh <n> Selects width of the pulses

PULSe:COUNt

This command sets the number of pulses that are output when a triggered output transient occurs. The command accepts parameters in the range 1 through 2E8. If INFinity or MAXimum is sent, the output pulse repeats indefinitely.

Command Syntax [SOURce:]PULSe:COUNt<NRf+> | INFinity Parameters 1 to 2E8 | MINimum | MAXimum | INFinity *RST Value 1 Examples PULS:COUN 3 PULS:COUN MIN PULS:COUN INF Query Syntax [SOURce:]PULS:COUNt? Returned Parameters <NR3> Related Commands PULS:DCYC PULS:HOLD PULS:PER PULS:WIDT

PULSe:DCYCle

This command sets the duty cycle of the triggered output pulse. The duty cycle units are specified in percent.

Command Syntax [SOURce:]PULSe:DCYCle<NRf+> Parameters 0 to 100%|MINimum|MAXimum *RST Value 50% Examples PULS:DCYC 75 PULS:DCYC MAX Query Syntax [SOURce:]PULSe:DCYCle? Returned Parameters <NR3> Related Commands PULS:COUN PULS:HOLD PULS:PER PULS:WIDT

PULSe:HOLD

This command specifies whether the pulse width or the duty cycle is to be held constant when the pulse period changes. The following tables describe how the duty cycle, period, and width are affected when one, two, or all three parameters are set in a single program message.

Command Syntax [SOURce:]PULSe:HOLD<parameter> Parameters WIDTh|DCYCle *RST Value WIDTh Examples PULS:HOLD DCYC Query Syntax [SOURce:]PULSe:HOLD? Returned Parameters <CRD> Related Commands PULS:COUN PULS:DCYC PULS:PER PULS:WIDT

Programming Manual Lx \ Ls Series II

Parameter Set

Action

DCYCle

PERiod

WIDTh

Sets WIDTh. If WIDTh < PERiod, recalculates DCYCle;

otherwise, recalculates the PERiod and DCYCle.

Sets PERiod. If WIDTh < PERiod, recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle.

Sets WIDTh. If WIDTh < PERiod, sets the PERiod and recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle

Sets DCYCle and recalculates PERiod

Sets DCYCle and WIDTh and recalculates PERiod

Sets DCYCle and PERiod and recalculates WIDTh

Sets WIDTh. If WIDTh < PERiod, sets the PERiod and recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle

Parameter Set

Action

DCYCle

PERiod

WIDTh

Sets WIDTh and recalculates the PERiod

Sets PERiod and recalculates the WIDTh

Sets WIDTh. If WIDTh < PERiod, sets the PERiod and recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle

Sets DCYCle and recalculates PERiod

Sets DCYCle and WIDTh and recalculates PERiod

Sets DCYCle and PERiod and recalculates WIDTh

Sets WIDTh. If WIDTh < PERiod, sets the PERiod and recalculates DCYCle; otherwise, recalculates the PERiod and DCYCle

Table 4-1: PULSe:HOLD = WIDTh parameters

Table 4-2: PULSe:HOLD = DCYCle parameters

PULSe:PERiod

This command sets the period of a triggered output transient The command parameters are model-dependent.

Command Syntax [SOURce:]PULSe:PERiod<NRf+> Parameters 3-phase models: 0 to 1.07533E6 | MINimum | MAXimum 1-phase models: 0 to 4.30133E5 | MINimum | MAXimum Unit s (seconds) *RST Value 0.03333 Examples PER 0.001 PER MIN Query Syntax [SOURce:]PERiod? Returned Parameters <NR3> Related Commands PULS:COUN PULS:DCYC PULS:HOLD PULS:WIDT

PULSe:WIDTh

Programming Manual Lx \ Ls Series II

This command sets the width of a transient output pulse. The command parameters are modeldependent.

Command Syntax [SOURce:]PULSe:WIDTh<NRf+> Parameters 3-phase models: 0 to 1.07533E6 | MINimum | MAXimum 1-phase models: 0 to 4.30133E5 | MINimum | MAXimum Unit s (seconds) *RST Value 0.01667 (equals the period of a single 60 Hz cycle) Examples PULS:WIDT 0.001 PULS:WIDT MIN Query Syntax [SOURce:]PULSe:WIDTh? Returned Parameters <NR3> Related Commands PULS:COUN PULS:DCYC PULS:HOLD PULS:PER

Programming Manual Lx \ Ls Series II

4.22 Source Subsystem - Voltage

This subsystem programs the output voltage of the Lx/Ls Series AC source.

Subsystem Syntax

[SOURce:] VOLTage :ALC [:STATe] ON | OFF | REG Sets Auto Level Control to on (trip), off, or regulation :SOURce INTernal | EXTernal Sets voltage sense source [:LEVel] [:IMMediate] [:AMPLitude] <n> Sets the ac rms voltage amplitude :TRIGgered [:AMPLitude] <n> Sets the transient voltage amplitude :MODE <mode> Sets the voltage mode (FIX|STEP|PULS|LIST) :PROTection [:LEVel] <n> Sets the overvoltage protection threshold :STATe <bool> Sets the overvoltage protection state :RANGe <n> Sets the voltage range :REFerance INTernal | EXTernal Set the voltage referance to internal or external(RPV) :SENSe [:SOURce] INTernal | EXTernal Sets voltage sense source :SLEW [:IMMediate] <n> | INFinity Sets the voltage slew rate :MODE <mode> Sets voltage slew mode (FIX|STEP|PULS|LIST) :TRIGgered <n> | INFinity Sets the transient voltage slew rate

VOLTage:ALC[:STATe]

These commands select the various auto level control (ALC) modes. The ALC mode uses the voltage measurement feedback to more precisely regulate the output voltage. The following ALC modes can be selected:

ON | 0 This enables the ALC trip mode. If the programmed voltage cannot be

maintained, the output is disabled (relay opens) and a 801 Voltage error

is generated. OFF | 1 This disables the ALC mode. REG | 2 This enables the ALC regulation mode. The output voltage is regulated

based on the readback voltage but if regulation cannot be maintained, the

output does not trip off. Instead, a status bit is set in the Event Status

requires firmware revision 0.98 or higher).

Note that the command format will take either alphanumeric or integer data but the query form always returns numeric data (NR1).

Command Syntax [SOURce:]VOLTage:ALC[:STATe] <source> Parameters ON | OFF | REG | 0 | 1 | 2 *RST Value REG Examples VOLT:ALC ON Query Syntax [SOURce:]VOLTage:ALC? Returned Parameters <NR1> Related Commands VOLT

Programming Manual Lx \ Ls Series II

VOLTage:ALC:SOURce

These commands select the source from which the output voltage is sensed. The following voltage sense sources can be selected:

INTernal This senses the voltage at the output of the power amplifier on the

inboard side of the output disconnect relay. EXTernal This senses the output voltage at the user's sense terminals, which

allows remote voltage sensing at the load.

Command Syntax [SOURce:]VOLTage:ALC:SOURce<source> Parameters INTernal | EXTernal *RST Value INTernal Examples VOLT:ALC:SOUR EXT Query Syntax [SOURce:]VOLTage:ALC:SOURce? Returned Parameters <CRD> Related Commands VOLT:SENS:DET

Note: The VOLT:ALC:SOUR command is an alias for the VOLT:SENS:SOUR command. Both perform the same function. This is done for backward compatability with the Agilent 6834B.

VOLTage

Phase Selectable This command programs the ac rms output voltage level of the AC source. The maximum peak

voltage that the AC source can output is 425 V peak. This includes any combination of voltage and function shape values. Therefore, the maximum value that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a sinewave, the maximum voltage that can be programmed is 300 V rms.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Command Syntax [SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude]<NRf+> Parameters 0 to 300 (for sinewaves) Unit V (rms voltage) *RST Value 1 volt Examples VOLT 250 VOLT:LEV 25 Query Syntax [SOURce:]VOLTage[:LEVel] [:IMMediate][:AMPLitude]? Returned Parameters <NR3> Related Commands VOLT:MODE VOLT:TRIG FUNC:SHAP

Programming Manual Lx \ Ls Series II

VOLTage:TRIGgered

Phase Selectable This command selects the ac rms amplitude that the output waveform will be set to during a

triggered step or pulse transient. The maximum peak voltage that the AC source can output is 425 V peak. This includes any

combination of voltage, and function shape values. Therefore, the maximum value that can be programmed depends on the peak-to-rms ratio of the selected waveform. For a sinewave, the maximum voltage that can be programmed is 300 V rms.

Note: You cannot program a voltage that produces a higher volt-second on the output than a

300V rms sinewave.

Command Syntax [SOURce:]VOLTage[:LEVel]:TRIGgered :AMPLitude]<NRf+> Parameters 0 to 300 (for sinewaves) Unit V (rms voltage) *RST Value 0 volt Examples VOLT:TRIG 120 VOLT:LEV:TRIG 120 Query Syntax SOURce:]VOLTage[:LEVel]:TRIGgered:AMPLitude]? Returned Parameters <NR3> If the TRIG level is not programmed, the IMM level is

returned.

Related Commands VOLT VOLT:MODE FUNC:SHAP

VOLTage:MODE

Phase Selectable This command determines how the ac rms output voltage is controlled during a triggered output

transient. The choices are:

FIXed The voltage is unaffected by a triggered output transient. STEP The voltage is programmed to the value set by VOLTage:TRIGgered

when a triggered transient occurs. PULSe The voltage is changed to the value set by VOLTage:TRIGgered for a

duration determined by the pulse commands. LIST The voltage is controlled by the voltage list when a triggered transient

occurs.

Command Syntax [SOURce:]VOLTage:MODE<mode> Parameters FIXed | STEP | PULSe | LIST *RST Value FIX Examples VOLT:MODE LIST VOLT:MODE FIX Query Syntax [SOURce:]VOLTage:MODE? Returned Parameters <CRD> Related Commands VOLT:TRG VOLT

Programming Manual Lx \ Ls Series II

VOLTage:PROTection

Phase Selectable This command sets the overvoltage protection (OVP) level of the AC source. If the peak output

voltage exceeds the OVP level, then the AC source output is disabled and the Questionable Condition status register OV bit is set (see Section 7 under Programming the Status and Event Registers). An overvoltage condition can be cleared with the OUTPut:PROTection:CLEar command after the condition that caused the OVP trip is removed. The OVP always trips with zero delay and is unaffected by the OUTPut:PROTection:DELay command.

Command Syntax [SOURce:]VOLTage:PROTection[:LEVel]<NRf+> Parameters 0 to 500 Unit V (peak voltage) *RST Value MAX Examples VOLT:PROT 400 VOLT:PROT:LEV MAX Query Syntax [SOURce:]VOLTage:PROTection[:LEVel]? Returned Parameters <NR3> Related Commands OUTP:PROT:CLE

VOLTage:RANGe

Phase Selectable This command sets the voltage range of the AC source. Two voltage ranges are available: a 150

volt range and a 300 volt range. Sending a parameter greater than 150 selects the 300 volt range, otherwise the 150 volt range is selected.

When the range is set to 150, the maximum rms voltage that can be programmed for a sine wave is 150 volts. For other waveshapes, the maximum programmable voltage may be different, depending on the waveform crest factor.

The VOLTage:RANGe command is coupled with the CURRent command. This means that the maximum current limit that can be programmed at a given time depends on the voltage range setting in which the unit is presently operating. Refer to chapter 4 under "Coupled Commands" for more information.

A user settable delay may be inserted between dropping the output voltage to zero and changing

the range relay state. See the “PONSetup:RELay” command for details. Your application program

should allow for this delay. (default is 0.1 sec or 100 msec). Command Syntax [SOURce:]VOLTage:RANGe<NRf+>

Parameters 150 | 300 *RST Value MAX Examples VOLT:RANG 150 VOLT:RANG MIN Query Syntax [SOURce:]VOLTage:RANGe? Returned Parameters <NR3> Related Commands VOLT PONS:REL

Programming Manual Lx \ Ls Series II

VOLTage:REFerance

This command select the referance Voltage. The following voltage refernace can be selected:

INTernal This is the internal voltage referance for programmable voltage EXTernal This is the external DC voltage referance input to program the output

voltage. 0 to +10 voltage represents 0 to full scale output voltage. This is

the RPV option.

Command Syntax [SOURce:]VOLTage:Refernace <source> Parameters INTernal | EXTernal *RST Value INTernal Examples VOLT:REF EXT Query Syntax [SOURce:]VOLTage:REFerance? Returned Parameters <CRD> Related Commands VOLT:ALC:SOUR OFF

Note: The VOLT:ALC:SOUR command must be set to off prior to selection of the referance to external.

Programming Manual Lx \ Ls Series II

VOLTage:SENSe:SOURce

These commands select the source from which the output voltage is sensed. The following voltage sense sources can be selected:

INTernal This senses the voltage at the output of the power amplifier on the

inboard side of the output disconnect relay. EXTernal This senses the output voltage at the user's sense terminals, which

allows remote voltage sensing at the load.

Command Syntax [SOURce:]VOLTage:SENSe:SOURce<source> [SOURce:]VOLTage:ALC:SOURce<source> Parameters INTernal | EXTernal *RST Value INTernal Examples VOLT:SENS:SOUR INT Query Syntax [SOURce:]VOLTage:SENSe:SOURce? Returned Parameters <CRD> Related Commands VOLT:ALC:SOUR EXT

Note: The VOLT:ALC:SOUR command is an alias for the VOLT:SENS:SOUR command. Both perform the same function. This is done for backward compatability with the Agilent 6834B.

VOLTage:SLEW

This command sets the slew rate for all programmed changes in the ac rms output voltage level of the AC source. A parameter of MAXimum or INFinity will set the slew to its maximum possible rate. The SCPI representation for INFinity is 9.9E37. This command does not affect the rate at which programmed dc offset changes occur.

Command Syntax [SOURce:]VOLTage:SLEW[:IMMediate]<NRf+>|INFinity Parameters 1E-3 to 9.9E37 | INFinity |MINimum | MAXimum Unit V/S (volts per second) *RST Value INFinity Examples VOLT:SLEW 1 VOLT:SLEW MAX VOLT:SLEW INF Query Syntax [SOURce:]VOLTage:SLEW[:IMMediate]? Returned Parameters <NR3> Related Commands VOLT:SLEW:MODE VOLT:SLEW:TRIG

AMETEK Lx User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual