Part No. 5964-8198 Printed in Malaysia
Microfiche No 5964-8199 March, 2002
Safety Summary
The beginning of the electronic load User’s Guide has a Safety Summary page. Be sure you are familiar
with the information on this page before programming the electronic load from a controller.
Printing History
The edition and current revision of this manual are indicated below. Reprints of this manual containing
minor corrections and updates may have the same printing date. Revised editions are identified by a new
printing date. A revised edition incorporates all new or corrected material since the previous printing date.
Changes to the manual occurring between revisions are covered by change sheets shipped with the
manual.
This document contains proprietary information protected by copyright. All rights are reserved. No part of
this document may be photocopied, reproduced, or translated into another language without the prior
consent of Agilent Technologies. The information contained in this document is subject to change without
notice.
SCPI Triggering Nomenclature 29
List Trigger Model 29
Initiating List Triggers 30
Specifying a Trigger Delay 30
Generating Transient and List Triggers 30
Making Measurements 31
Voltage and Current Measurements 31
Triggering Measurements 33
SCPI Triggering Nomenclature 33
Measurement Trigger Model 33
Initiating the Measurement Trigger System 34
Generating Measurement Triggers 34
Measuring Triggered Transients or Lists 36
Measuring Dwell-Paced Lists 37
Programming the Status Registers 38
Power-On Conditions 41
Channel Status Group 41
Channel Summary Group 41
Questionable Status Group 41
Standard Event Status Group 41
Operation Status Group 42
Status Byte Register 42
Determining the Cause of a Service Interrupt 43
Servicing Standard Event Status and Questionable Status Events 43
Programming Examples 44
CC Mode Example 44
CV Mode Example 44
CR Mode Example 45
Continuous Transient Operation Example 45
Pulsed Transient Operation Example 46
Synchronous Toggled Transient Operation Example 46
Battery Testing Example 47
Power Supply Testing Example 49
C++ Programming Example 50
4
4 - LANGUAGE DICTIONARY 53
Introduction 53
Subsystem Commands 53
Common Commands 54
Programming Parameters 54
*CLS 97
*ESE 97
Bit Configuration of Standard Event Status Enable Register 98
*ESR? 98
*IDN? 98
*OPC 98
*OPT? 99
*PSC 99
*RCL 99
*RDT? 100
*RST 100
*SAV 101
*SRE 101
*STB? 101
Bit Configuration of Status Byte Register 102
*TRG 102
*TST? 102
*WAI 102
7
A - SCPI COMMAND TREE 103
Command Syntax 103
B - ERROR MESSAGES 107
Error Number List 107
C - COMPARING N3300A ELECTRONIC LOADS WITH EARLIER MODELS 111
Introduction 111
INDEX 115
8
1
General Information
About this Guide
This manual contains programming information for the Agilent Technologies N3301A, N3302A, N3303A,
N3304A, N3305A, N3306A, and N3307A Electronic Load modules when installed in an Agilent
Technologies N3300A and N3301A Electronic Load mainframes. These units will be referred to as
"electronic load" throughout this manual. You will find the following information in the rest of this guide:
Chapter 1 Introduction to this guide.
Chapter 2 Introduction to SCPI messages structure, syntax, and data formats.
Chapter 3 Introduction to programming the electronic load with SCPI commands.
Chapter 4 Dictionary of SCPI commands.
Appendix A SCPI command tree.
Appendix B Error messages
Appendix C Comparison With Earlier Models
Documentation Summary
The following documents that are related to this Programming Guide have additional helpful information
for using the electronic load.
Quick Start Guide - located in the front part of the User's Guide. Information on how to quickly get
started using the electronic load.
User's Guide. Includes specifications and supplemental characteristics, how to use the front
panel, how to connect to the instrument, and calibration procedures.
External References
SCPI References
The following documents will assist you with programming in SCPI:
Beginner's Guide to SCPI. Part No. H2325-90001. Highly recommended for anyone who has not
had previous experience programming with SCPI.
Tutorial Description of the GPIB . Part No. 5952-0156. Highly recommended for those not familiar
with the IEEE 488.1 and 488.2 standards.
To obtain a copy of the above documents, contact your local Agilent Technologies Sales and Support
Office.
9
1 - General Information
GPIB References
The most important GPIB documents are your controller programming manuals - GW BASIC, GPIB
Command Library for MS DOS, etc. Refer to these for all non-SCPI commands (for example: Local
Lockout).
The following are two formal documents concerning the GPIB interface:
ANSI/IEEE Std. 488.1-1987 IEEE Standard Digital Interface for Programmable Instrumentation.
Defines the technical details of the GPIB interface. While much of the information is beyond the
need of most programmers, it can serve to clarify terms used in this guide 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.
VXIplug&play Power Products Instrument Drivers
VXIplug&play instrument drivers for Microsoft Windows 95 and Windows NT are now available on the
Web at http://www.agilent.com/find/drivers. These instrument drivers provide a high-level programming
interface to your Agilent Technologies electronic load. VXIplug&play instrument drivers are an alternative
to programming your instrument with SCPI command strings. Because the instrument driver's function
calls work together on top of the VISA I/O library, a single instrument driver can be used with multiple
application environments.
Supported Applications
y Agilent VEE
y Microsoft Visual BASIC
y Microsoft Visual C/C++
y Borland C/C++
y National Instruments LabVIEW
y National Instruments LabWindows/CVI
System Requirements
The VXIplug&play instrument driver complies with the following:
y Microsoft Windows 95
y Microsoft Windows NT 4.0
y HP VISA revision F.01.02
y National Instruments VISA 1.1
Downloading and Installing the Driver
NOTE: Before installing the VXIplug&play instrument driver, make sure that you have one of the
supported applications installed and running on your computer.
10
General Information - 1
1. Access Agilent Technologies W eb site at http://www.agilent.com/find/drivers.
2. Select the instrument for which you need the driver.
3. Click on the driver, either Windows 95 or Windows NT, and download the executable file to your
PC.
4. Locate the file that you downloaded from the Web. From the Start menu select Run
<path>:\agxxxx.exe - where <path> is the directory path where the file is located, and agxxxx is
the instrument driver that you downloaded .
5. Follow the directions on the screen to install the software. The default installation selections will
work in most cases. The readme.txt file contains product updates or corrections that are not
documented in the on-line help. If you decide to install this file, use any text editor to open and
read it.
6. To use the VXIplug&play instrument driver, follow the directions in the VXIplug&play online help
for your specific driver under “Introduction to Programming”.
Accessing Online Help
A comprehensive online programming reference is provided with the driver. It describes how to get
started using the instrument driver with Agilent VEE, LabVIEW, and LabWindows. It includes complete
descriptions of all function calls as well as example programs in C/C++ and Visual BASIC.
y To access the online help when you have chosen the default Vxipnp start folder, click on the Start
button and select Programs | Vxipnp | Agxxxx Help (32-bit).
- where Agxxxx is the instrument driver.
11
Introduction to Programming
GPIB Capabilities of the Electronic Load
All electronic load functions except for setting the GPIB address are programmable over the GPIB. The
IEEE 488.2 capabilities of the electronic load are described in Table 2-1. Refer to Appendix A of your
User's Guide for its exact capabilities.
Table 2-1. IEEE 488 Capabilities of Electronic Loads
GPIB Capabilities Response Interface
Function
Talker/Listener
Service Request The electronic load sets the SRQ line true if there is an enabled
Remote/Local
Device Trigger
Group Execute
Trigger
Device Clear
All electronic load functions except for setting the GPIB address are
programmable over the GPIB. The electronic load can send and
receive messages over the GPIB. Status information is sent using a
serial poll. Front panel annunciators indicate the present GPIB state
of the electronic load.
service request condition. Refer to Chapter 3 - Status Reporting for
more information.
In local mode, the electronic load is controlled from the front panel
but will also execute commands sent over the GPIB. The electronic
load powers up in local mode and remains in local mode until it
receives a command over the GPIB. Once the electronic load is in
remote mode the front panel RMT annunciator is on, all front panel
keys (except
metering mode. Pressing
electronic load to local mode.
lockout so that only the controller or the power switch can return the
electronic load to local mode.
The electronic load will respond to the device trigger function. DT1
The electronic load will respond to the group execute trigger function. GET
The electronic load responds to the Device Clear (DCL) and
Selected Device Clear (SDC) interface commands. They cause the
electronic load to clear any activity that would prevent it from
receiving and executing a new command (including *WAI and
*OPC?). DCL and SDC do not change any programmed settings.
) are disabled, and the display is in normal
on the front panel returns the
can be disabled using local
AH1, SH1,
T6. L4
SR1
RL1
DCL, SDC
2
GPIB Address
The electronic load operates from a GPIB address that is set from the front panel. To set the GPIB
address, press the Address key on the front panel and enter the address using the Entry keys. The
address can be set from 0 to 30. The GPIB address is stored in non-volatile memory.
13
2 - Introduction to Programming
RS-232 Capabilities of the Electronic Load
The electronic load provides an RS-232 programming interface, which is activated by commands located
under the front panel Address key. All SCPI commands are available through RS-232 programming.
When the RS-232 interface is selected, the GPIB interface is disabled.
The EIA RS-232 Standard defines the interconnections between Data Terminal Equipment (DTE) and
Data Communications Equipment (DCE). The electronic load is designed to be a DTE. It can be
connected to another DTE such as a PC COM port through a null modem cable.
NOTE:The RS-232 settings in your program must match the settings specified in the front panel
Address menu. Press the front panel Address key if you need to change the settings.
RS-232 Data Format
The RS-232 data is a 10-bit word with one start bit and one stop bit. The number of start and stop bits is
not programmable. However, the following parity options are selectable using the front panel Address key:
EVEN
ODD
MARK
SPACE
NONE
Parity options are stored in non-volatile memory.
Baud Rate
The front panel Address key lets you select one of the following baud rates, which is stored in non-volatile
memory:
300 600 1200 2400 4800 9600
Seven data bits with even parity
Seven data bits with odd parity
Seven data bits with mark parity (parity is always true)
Seven data bits with space parity (parity is always false)
Eight data bits without parity
RS-232 Flow Control
The RS-232 interface supports the following flow control options that are selected using the front panel
Address key. For each case, the electronic load will send a maximum of five characters after holdoff is
asserted by the controller. The electronic load is capable of receiving as many as fifteen additional
characters after it asserts holdoff.
RTS-CTS
NONE
Flow control options are stored in non-volatile memory.
The electronic load asserts its Request to Send (RTS) line to signal hold-off
when its input buffer is almost full, and it interprets its Clear to Send (CTS)
line as a hold-off signal from the controller.
There is no flow control.
14
Introduction to Programming - 2
Introduction to SCPI
SCPI (Standard Commands for Programmable Instruments) is a programming language for controlling
instrument functions over the GPIB and RS-232 interface. 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.
Conventions Used in This Guide
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:].
VOLTage 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.
Computer font Computer font is used to show program lines in text.
OUTPUT 723 "TRIGger:COUNt:CURRent 10" shows a program line.
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
electronic load 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 electronic load functions. They are organized into an
inverted tree structure with the "root" at the top. The following figure 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.
ROOT
:CURRent[:LEVel]
:MODE
:PROTection
:STATus
:OPERation[:EVENt]?
[:IMMediate]
[:LEVel]
:DELay
Figure 2-1. Partial Command Tree
:CONDition?
15
2 - Introduction to Programming
Multiple Commands in a Message
Multiple SCPI commands can be combined and sent as a single message with one message terminator.
There are two important considerations when sending several commands within a single message:
♦ Use a semicolon to separate commands within a message.
♦ There is an implied header path that affects how commands are interpreted by the electronic load.
The header path can be thought of as a string that gets inserted before each command within a message.
For the first command in a message, the header path is a null string. For each subsequent command the
header path is defined as the characters that make up the headers of the previous command in the
message up to and including the last colon separator. An example of a message with two commands is:
CURR:LEV 3;PROT:STAT OFF
which shows the use of the semicolon separating the two commands, and also illustrates the header path
concept. Note that with the second command, the leading header "CURR" was omitted because after the
"CURR:LEV 3" command, the header path became defined as "CURR" and thus the instrument
interpreted the second command as:
CURR:PROT:STAT OFF
In fact, it would have been syntactically incorrect to include the "CURR" explicitly in the second command,
since the result after combining it with the header path would be:
CURR:CURR:PROT:STAT OFF
which is incorrect.
Moving Among Subsystems
In order to combine commands from different subsystems, you need to be able to reset the header path to
a null string within a message. You do this by beginning the command with a colon (:), which discards any
previous header path. For example, you could clear the output protection and check the status of the
Operation Condition register in one message by using a root specifier as follows:
The following message shows how to combine commands from different subsystems as well as within the
same subsystem:
VOLTage:LEVel 20;PROTection 28; :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.
Including Common Commands
You can combine common commands with subsystem 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 header path; you may insert them anywhere in the message.
VOLTage:TRIGgered 17.5;:INITialize;*TRG
OUTPut OFF;*RCL 2;OUTPut ON
16
Introduction to Programming - 2
Using Queries
Observe the following precautions with queries:
♦ Set up the proper number of variables for the returned data. For example, if you are reading back
a measurement array, you must dimension the array according to the number of measurements
that you have placed in the measurement buffer.
♦ Read back all the results of a query before sending another command to the electronic load.
Otherwise a Query Interrupted error will occur and the unreturned data will be lost.
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 electronic load. The message, which may be sent at any time, requests the
electronic load to perform some action.
♦ A response message consists of data in a specific SCPI format sent from the electronic load to
the controller. The electronic load sends the message only when commanded by a program
message called a "query."
The following figure illustrates SCPI message structure:
Data
Headers
Header Separator
Message Unit Separators
Figure 2-2. Command Message Structure
Message Unit
;
Query Indicator
; : CURR?
Message Terminator
Root Specifier
<NL>VOLT:LEV 20TLEV 30
The Message Unit
The simplest SCPI command is a single message unit consisting of a command header (or keyword)
followed by a message terminator. The message unit may include a parameter after the header. The
parameter can be numeric or a string.
ABORt<NL>
VOLTage 20<NL>
Headers
Headers, also referred to as keywords, are instructions recognized by the electronic load. Headers may be
either in the long form or the short form. In the long form, the header is completely spelled out, such as
VOLTAGE, STATUS, and DELAY. In the short form, the header has only the first three or four letters,
such as VOLT, STAT, and DEL.
17
2 - Introduction to Programming
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).
Message Unit Separator
When two or more message units are combined into a compound message, separate the units with a
semicolon (STATus:OPERation?;QUEStionable?).
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.
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 guide, there is an assumed message terminator at the end of each message.
NOTE:All RS-232 response data sent by the electronic load is terminated by the ASCII character
pair <carriage return><newline>. This differs from GPIB response data which is
terminated by the single character <newline> with EOI asserted.
SCPI Data Formats
All data programmed to or returned from the electronic load is ASCII. The data may be numerical or
character string.
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>
<NR3>
Listening Formats
<Nrf>
<Nrf+>
<Bool>
Digits with an explicit decimal point. Example: .0273
Digits with an explicit decimal point and an exponent. Example: 2.73E+2
Extended format that includes <NR1>, <NR2> and <NR3>. Examples: 273 273. 2.73E2
Expanded decimal format that includes <NRf> and MIN MAX. Examples: 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.
Boolean Data. Example: 0 | 1 or ON | OFF
18
Introduction to Programming - 2
Suffixes and Multipliers
Class Suffix Unit Unit with Multiplier
Amplitude V volt MV (millivolt)
Current A ampere MA (milliampere)
Power W watt MW (milliwatt)
Resistance OHM ohm MOHM (megohm)
Slew Rate A/s
R/s
V/s
Time s second MS (millisecond)
1E3 K kilo
1E-3 M milli
1E-6 U micro
amps/second
ohms/second
volts/second
Common Multipliers
Response Data Types
Character strings returned by query statements may take either of the following forms, depending on the
length of the returned string:
<CRD>
<AARD>
<SRD>
Character Response Data. Permits the return of character strings.
Arbitrary ASCII Response Data. Permits the return of undelimited 7-bit ASCII. This data type
has an implied message terminator.
String Response Data. Returns string parameters enclosed in double quotes.
SCPI Command Completion
SCPI commands sent to the electronic load are processed either sequentially or in parallel. Sequential
commands finish execution before a subsequent command begins. Parallel commands allow other
commands to begin executing while the parallel command is still executing. Commands that affect trigger
actions are among the parallel commands.
The *WAI, *OPC, and *OPC? common commands provide different ways of indicating when all
transmitted commands, including any parallel ones, have completed their operations. The syntax and
parameters for these commands are described in chapter 4. Some practical considerations for using
these commands are as follows:
*WAI
*OPC?
*OPC
This prevents the electronic load from processing subsequent commands until all
pending operations are completed.
This places a 1 in the Output Queue when all pending operations have completed.
Because it requires your program to read the returned value before executing the next
program statement, *OPC? can be used to cause the controller to wait for commands
to complete before proceeding with its program.
This sets the OPC status bit when all pending operations have completed. Since your
program can read this status bit on an interrupt basis, *OPC allows subsequent
commands to be executed.
NOTE:The trigger system must be in the Idle state in order for the status OPC bit to be true.
Therefore, as far as triggers are concerned, OPC is false whenever the trigger system is
in the Initiated state.
19
2 - Introduction to Programming
Using Device Clear
You can send a device clear at any time to abort a SCPI command that may be hanging up the GPIB
interface. The status registers, the error queue, and all configuration states are left unchanged when a
device clear message is received. Device clear performs the following actions:
♦ The input and output buffers of the electronic load are cleared.
♦ The electronic load is prepared to accept a new command string.
The following statement shows how to send a device clear over the GPIB interface using GW BASIC:
CLEAR 705IEEE-488 Device Clear
The following statement shows how to send a device clear over the GPIB interface using the GPIB
command library for C or QuickBASIC:
IOCLEAR (705)
NOTE:For RS-232 operation, sending a Break will perform the same operation as the IEEE-488
device clear message.
RS-232 Troubleshooting
If you are having trouble communicating over the RS-232 interface, check the following:
♦ The computer and the electronic load must be configured for the same baud rate, parity, number
of data bits, and flow control options. Note that the electronic load is configured for 1 start bit and
1 stop bit (these values are fixed).
♦ The correct interface cables or adapters must be used, as described under RS-232 Connector.
Note that even if the cable has the proper connectors for your system, the internal wiring may be
incorrect.
♦ The interface cable must be connected to the correct serial port on your computer (COM1, COM2,
etc.).
20
Introduction to Programming - 2
SCPI Conformance Information
SCPI Conformed Commands
The Electronic Load conforms to SCPI Version 1995.0.
This chapter contains examples on how to program your electronic load. Simple examples show you how
to program:
Input functions such as voltage, current, and resistance
Transient functions, including lists
Measurement functions
The status and protection functions
NOTE:These examples in this chapter show which commands are used to perform a particular
function, but do not show the commands being used in any particular programming
environment.
Programming the Input
Power-on Initialization
When the electronic load is first turned on, it wakes up with the input state set OFF. The following
commands are given implicitly at power-on:
*RST
*CLS
*SRE 0
*ESE 0
*RST is a convenient way to program all parameters to a known state. Refer to the *RST command in
chapter 4 to see how each programmable parameter is set by *RST. Refer to the *PSC command in
chapter 4 for more information on the power-on initialization of the *ESE and the *SRE registers.
Enabling the Input
To enable the input, use the command:
INPut ON
Input Voltage
The input voltage is controlled with the VOLTage command. For example, to set the input voltage to 25
volts, use:
VOLTage 25
23
3 - Programming Examples
Maximum Voltage
The maximum input voltage that can be programmed can be queried with:
VOLTage? MAXimum
Input Current
All models have a programmable current function. The command to program the current is:
CURRent <n>
where <n> is the input current in amperes.
Maximum Current
The maximum input current that can be programmed can be queried with:
CURRent? MAXimum
Overcurrent Protection
The electronic load can also be programmed to turn off its input if the current protection level is reached.
As explained in chapter 4, this protection feature is implemented the following command:
CURRent:PROTection:STATe ON | OFF
NOTE:Use CURRent:PROTection:DELay to prevent momentary current limit conditions caused
by programmed input changes from tripping the overcurrent protection.
Setting the Triggered Voltage or Current Levels
To program voltage or current triggered levels, you must specify the voltage or current level that the input
will go to once a trigger signal is received. Use the following commands to set a triggered level:
VOLTage:TRIGgered <n> or
CURRent:TRIGgered <n>
NOTE:Until they are explicitly programmed, triggered levels will assume their corresponding
immediate levels. For example, if a electronic load is powered up and VOLTage:LEVel is
programmed to 6, then VOLTage:LEVel:TRIGger will also be 6 until you program it to
another value. Once you program VOLTage:LEVel:TRIGger to a value, it will remain at
that regardless of how you subsequently reprogram VOLTage:LEVel. Then, when the
trigger occurs, the VOLTage:LEVel is set to the VOLTage:LEVel:TRIGger value.
Generating Triggers
You can generate a single trigger by sending the following command over the GPIB:
TRIGger:IMMediate
Note that this command will always generate a trigger. Use the TRIGger:SOURce command to select
other trigger sources such as the mainframe's external trigger input.
24
Programming Examples - 3
Programming Transients
Transient operation is used to synchronize input changes with internal or external trigger signals, and
simulate loading conditions with precise control of timing, duration, and slew. The following transient
modes can be generated:
Continuous
Pulse
Toggled
NOTE: Before turning on transient operation, set the desired mode of operation as well as all of
Generates a repetitive pulse stream that toggles between two load levels.
Generates an load change that returns to its original state after some time period.
Generates a repetitive pulse stream that toggles between two load levels. Similar to
Continuous mode except that the transient points are controlled by explicit triggers
instead of an internal transient generator.
the parameters associated with transient operation. At *RST all transient functions are set
to OFF.
Continuous Transients
In continuous operation, a repetitive pulse train switches between two load levels, a main level (which can
be either the immediate or triggered level) and a transient level. The rate at which the level changes is
determined by the slew rate (see slew rate descriptions for CV, CR, or CV mode as applicable). In
addition, the frequency and duty cycle of the continuous pulse train are programmable. Use the following
commands to program continuous transients:
TRANsient:MODE CONTinuous
CURRent 5
CURRent:TLEVel 10
TRANsient:FREQuency 1000
TRANsient:DCYCle 40
TRANsient ON
This example assumes that the CC mode is active and the slew rate is at the default setting (maximum
rate). The load module starts conduction at the main level (in this case 5 amps). When transient
operation is turned on (no trigger is required in continuous mode), the module input current will slew to
and remain at 10 amps for 40% of the period (400 µs). The input current will then slew to and remain at 5
amps for the remaining 60% (600 µs) of that cycle.
Pulse Transients
Pulsed transient operation generates a load change that returns to its original state after some time
period. It is similar to continuous operation with the following exceptions:
a. To get a pulse, an explicit trigger is required. To specify the trigger source, use
TRIGger:SOURce. See "Triggering Transients".
b. One pulse results from each trigger. Therefore, frequency cannot be programmed.
Use the following commands to program pulsed transients:
25
3 - Programming Examples
TRIGger:SOURce EXTernal
TRANsient:MODE PULSe
CURRent 5
CURRent:TLEVel 10
TRANsient:TWIDth .01
TRANsient ON
This example assumes that the CC mode is active, the slew rate is at the factory default setting
(maximum rate), and a trigger signal is connected to the mainframe's external trigger input. The load
module starts conduction at the main current level setting (5 amps). When the transient mode is turned
on and an external trigger signal is received, the input level starts increasing at a rate determined by the
slew rate. When the value specified by the transient level setting (10 amps) is reached, it stays there for
the remainder of the time determined by the pulse width setting (10 milliseconds). After this time has
elapsed, the input level decreases to the main level again at the rate specified by the slew setting and
remains there until another trigger is received. Any triggers that occur during the time the transient level is
in effect will re-trigger the pulse, extending the pulse by another pulse-width value.
Toggled Transients
Toggled transient operation causes the module input to alternate between two pre-defined levels as in
continuous operation except that the transient transitions are controlled by explicit triggers instead of the
internal transient generator. See "Triggering Transients". Use the following commands to program toggled
transients:
TRIGger:SOURce EXTernal
TRANsient:MODE TOGGle
CURRent 5
CURRent:TLEVel 10
TRANsient ON
This example assumes that the CC mode is active, the slew rate is at the factory default setting
(maximum rate), and a trigger signal is connected to the mainframe's external trigger input. Toggled
transient operation is similar to that described for continuous and pulse operation, except that each time a
trigger is received the input alternates between the main and transient input current levels.
Programming Lists
List mode lets you generate complex sequences of input changes with rapid, precise timing, which may be
synchronized with internal or external signals. This is useful when running test sequences with a minimum
amount of programming overhead.
You can program up to 50 settings (or steps) in the list, the time interval (dwell) that each setting is
maintained, the number of times that the list will be executed, and how the settings change in response to
triggers. All list data is can be stored in nonvolatile memory when saved in locations 0, 7, 8, or 9 using the
*SAV command. This means that the programmed data for any list will be retained when the electronic
load is turned off. Use the *RCL command to recall the saved state. *RST clears the presently active list
but will not clear the lists saved in locations 0, 7, 8, or 9.
List steps can be either individually triggered, or paced by a separate list of dwell times that define the
duration of each step. Therefore, each of the up to 50 steps has an associated dwell time, which specifies
the time (in seconds) that the input remains at that step before moving on to the next step. The following
procedure shows how to generate a simple 9-step list of current and voltage changes.
26
Programming Examples - 3
Step 1
Step 2
Set the mode of each function that will participate in the sequence to LIST. For example:
CURRent:MODE LIST
Program the list of input values for each function. The list commands take a comma-separated
list of arguments. The order in which the arguments are given determines the sequence in
which the values will be input. For example, to vary the input current of the electronic load to
simulate a 25%, 50%, and 100% load, a list may include the following values:
You must specify a list for all current functions, whether or not the functions will be used. For
example, to synchronize the previous current list with another list that varies the slew rate from
0.01A/µs, to 0.1A/µs, to 1A/µs (programmed in A/s), the lists may include the following values:
All lists must have the same number of data values or points, or an error will occur when the list
system that starts the sequence is initiated. The exception is when a list has only one item or
point. In this case the single-item list is treated as if it had the same number of points as the
other lists, with all values being equal to the one item. For example:
LIST:CURRent 15, 30, 45, 60;SLEW 1E+6
is the same as:
LIST:CURRent 15, 30, 45, 60
LIST:CURRent:SLEW 1E+6, 1E+6, 1E+6, 1E+6
Step 3
Step 4
Step 5
Determine the time interval that the input remains at each level or point in the list before it
advances to the next point. The time is specified in seconds. For example, to specify five dwell
intervals, use:
LIST:DWELl 1, 1.5, 2, 2.5, 3
The number of dwell points must equal the number of input points. If a dwell list has only one
value, that value will be applied to all points in the input list.
Determine the number of times the list is repeated before it completes. For example, to repeat a
list 10 times use:
LIST:COUNt 10
Entering INFinity makes the list repeat indefinitely. At *RST, the count is set to 1.
Determines how the list sequencing responds to triggers. For a closely controlled sequence of
input levels, you can use a dwell-paced list. To cause the list to be paced by dwell time use:
LIST:STEP AUTO
As each dwell time elapses, the next point is immediately input. This is the *RST setting.
If you need the input to closely follow asynchronous events, then a trigger-paced list is more
appropriate. In a trigger-paced list, the list advances one point for each trigger received. To
enable trigger-paced lists use:
LIST:STEP ONCE
The dwell time of each point determines the minimum time that the input remains at that point.
If a trigger is received before the previous dwell time completes, the trigger is ignored.
Therefore, to ensure that no triggers are lost, program the dwell time to "MIN".
Step 6
Use the list trigger system to trigger the list. See "Triggering Transients and Lists".
27
3 - Programming Examples
Programming Lists for Multiple Channels
You can program separate lists for individual channels on a load mainframe. Once lists have been
programmed for each channel, they can all be triggered at the same time using the list trigger system.
NOTE:All lists must have the same number of data values or points, or an error will occur when
the list system that starts the sequence is initiated.
Step 1
Step 2
Step 3
Step 4
Select the channel for which you want to program the list. All subsequent list commands will be
sent to this channel until another channel is selected.
CHANnel 1
Program the list of values for each function for that channel. The list commands take a commaseparated list of arguments. For example:
Select the next channel for which you want to program a list. All subsequent list commands will
now be sent to this channel.
CHANnel 2
Program the list of values for each function for that channel. You can program different
functions for each channel, however all functions must have the same number of steps
Add other list functions. You do not have to program the same number of functions for each
channel.
Step 5
Step 6
Repeat steps 3 and 4 for any other channel that you wish to program.
Use the list trigger system to trigger the list. This is described under "Triggering Transients and
Lists".
28
Programming Examples - 3
Triggering Transients and Lists
Continuous, pulse, and toggled transient modes respond to triggers as soon as the trigger is received.
This is not the case for lists. Lists have an independent trigger system that is similar to the measurement
trigger system. This section describes the list trigger system. The measurement trigger system is
described under "Triggering Measurements".
SCPI Triggering Nomenclature
In SCPI terms, trigger systems are called sequences. When more than one trigger system exists, they are
differentiated by naming them SEQuence1 and SEQuence2. SEQuence1 is the list trigger system and
SEQuence2 is the measurement trigger system. The electronic load uses aliases with more descriptive
names for these sequences. These aliases can be used instead of the sequence forms.
Sequence Form Alias
SEQuence1 LIST
SEQuence2 ACQuire
List Trigger Model
Figure 3-3 is a model of the list trigger system. The rectangles represent states. The arrows show the
transitions between states. These are labeled with the input or event that causes the transition to occur.
INITiate:CONTinuous OFF
INITiate:CONTinuous ON
or
List not complete and
LIST:STEP ONCE
INITIATED STATE
DELAYING STATE
LIST STEP CHANGE
NO
WAIT FOR DWELL
TO COMPLETE
IDLE STATE
LIST:STEP
AUTO?
YES
ABORt
*RST
*RCL
INITiate[:IMMediate]
TRIGGER RECEIVED
DELAY COMPLETED
Figure 3-3. Model of List Triggers
29
3 - Programming Examples
Initiating List Triggers
When the electronic load is turned on, the list trigger system is in the idle state. In this state, the list
system ignores all triggers. Sending the following commands at any time returns the list system to the Idle
state:
ABORt
*RST
*RCL
The INITiate commands move the list system from the Idle state to the Initiated state. This enables the
list system to receive triggers. INITiate commands are not channel-specific, they affect all installed load
modules. To initiate the list system for a single triggered action, use:
INITiate:SEQuence1 or
INITiate:NAME LIST
NOTE:Whenever a list is initiated or triggered, the φ1 annunciator is lit on the front panel.
After a trigger is received and the action completes, the list system will return to the Idle state. Thus it will
be necessary to initiate the list system each time a triggered action is desired.
To keep the list system initiated for multiple actions without having to send an Initiate command for each
trigger, use:
INITiate:CONTinuous:SEQuence1 ON or
INITiate:CONTinuous:NAME LIST, ON
Specifying a Trigger Delay
A time delay can be programmed betweent he receipt of the trigger system and the start of the triggered
action. This delay applies to both list and measurement triggers. At *RST the trigger delay is set to 0,
which mens there is no trigger delay. To program a trigger delay use:
TRIGger:DELay <n>
Generating Transient and List Triggers
Use one of the following triggering methods to generate transients and lists:
TRIGger:SOURce BUS | EXTernal | HOLD | LINE | TIMer
After you have specified the appropriate trigger source, you can generate triggers as follows:
Single triggers over
the bus
Continuous triggers
synchronized with the
ac line frequency
Continuous triggers
synchronized with the
internal timer
Send one of the following commands over the GPIB:
TRIGger:IMMediate
*TRG
a group execute trigger
Send the following command over the GPIB:
TRIGger:SOURce LINE
Send the following commands over the GPIB:
TRIGger:TIMer <time>
TRIGger:SOURce TIMer
External trigger
Apply a low to high signal to the external trigger input at the back of the
mainframe.
30
Loading...
+ 89 hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.