U2722A Programmer`s Reference Guide

U2722A Programmer`s Reference Guide
Agilent U2722A USB
Modular Source
Measure Unit
Programmer’s Reference
Guide
Agilent Technologies
Notices
® Agilent Technologies, Inc. 2008
Warranty
No part of this manual may be reproduced in
any form or by any means (including electronic storage and retrieval or translation
into a foreign language) without prior agreement and written consent from Agilent
Technologies, Inc. as governed by United
States and international copyright laws.
The material contained in this document is provided “as is,” and is subject to being changed, without notice,
in future editions. Further, to the maximum extent permitted by applicable
law, Agilent disclaims all warranties,
either express or implied, with regard
to this manual and any information
contained herein, including but not
limited to the implied warranties of
merchantability and fitness for a particular purpose. Agilent shall not be
liable for errors or for incidental or
consequential damages in connection with the furnishing, use, or performance of this document or of any
information contained herein. Should
Agilent and the user have a separate
written agreement with warranty
terms covering the material in this
document that conflict with these
terms, the warranty terms in the separate agreement shall control.
Manual Part Number
U2722-90022
Edition
Third Edition, November 28, 2008
Printed in Malaysia
Agilent Technologies, Inc.
Bayan Lepas FIZ, Phase III
11900 Penang, Malaysia
Safety Notices
Technology Licenses
The hardware and/or software described in
this document are furnished under a license
and may be used or copied only in accordance with the terms of such license.
Restricted Rights Legend
U.S. Government Restricted Rights. Software and technical data rights granted to
the federal government include only those
rights customarily provided to end user customers. Agilent provides this customary
commercial license in Software and technical data pursuant to FAR 12.211 (Technical
Data) and 12.212 (Computer Software) and,
for the Department of Defense, DFARS
252.227-7015 (Technical Data - Commercial
Items) and DFARS 227.7202-3 (Rights in
Commercial Computer Software or Computer Software Documentation).
2
CAUTION
A CAUTION notice denotes a hazard. It calls attention to an operating procedure, practice, or the like
that, if not correctly performed or
adhered to, could result in damage
to the product or loss of important
data. Do not proceed beyond a
CAUTION notice until the indicated
conditions are fully understood and
met.
WA R N I N G
A WARNING notice denotes a
hazard. It calls attention to an
operating procedure, practice, or
the like that, if not correctly performed or adhered to, could result
in personal injury or death. Do not
proceed beyond a WARNING
notice until the indicated conditions are fully understood and
met.
U2722A Programmer’s Reference Guide
Contents
1
Introduction to Programming 7
Introduction to the SCPI Language 8
SCPI Conventions and Data Formats 9
Command Separators 11
Querying Parameter Settings 11
SCPI Command Terminators 12
IEEE-488.2 Common Commands 12
Address/Channel List Parameter 13
2
SCPI Status Registers 9
SCPI Status Registers 10
Operation Status Registers 12
Questionable Status Registers 12
Standard Event Register 13
Status Byte Register 14
3
ABORt Subsystem 15
ABORt:TRANsient 16
4
CONFigure Subsystem 17
CONFigure:SSI 18
5
INITiate Subsystem 21
INITiate[:IMMediate]:TRANsient 22
6
MEASure Subsystem 23
MEASure[:SCALar]:CURRent[:DC]? 24
MEASure[:SCALar]:VOLTage[:DC]? 25
MEASure:ARRay:CURRent[:DC]? 26
MEASure:ARRay:VOLTage[:DC]? 27
U2722A Programmer’s Reference Guide
3
Contents
MEASure:TEMPerature? 28
7
OUTPut Subsystem 29
OUTPut[:STATe] 30
8
SENSe Subsystem 31
SENSe:CURRent[:DC]:APERture?
SENSe:CURRent[:DC]:NPLCycles
SENSe:SWEep:POINts 34
SENSe:SWEep:TINTerval 35
SENSe:VOLTage[:DC]:APERture?
SENSe:VOLTage[:DC]:NPLCycles
9
32
33
36
37
SOURce Subsystem 39
[SOURce:]CURRent 40
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude] 41
[SOURce:]CURRent:LIMit 42
[SOURce:]CURRent:RANGe 43
[SOURce:]VOLTage 44
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude] 45
[SOURce:]VOLTage:LIMit 46
[SOURce:]VOLTage:RANGe 47
10 STATus Subsystem 51
STATus:OPERation:CONDition? 52
STATus:OPERation:ENABle 53
STATus:OPERation[:EVENt]? 55
STATus:OPERation:NTRansition 57
STATus:OPERation:PTRansition 59
STATus:PRESet 61
STATus:QUEStionable:CONDition? 62
STATus:QUEStionable:ENABle 63
STATus:QUEStionable[:EVENt]? 65
STATus:QUEStionable:NTRansition 67
4
U2722A Programmer’s Reference Guide
Contents
STATus:QUEStionable:PTRansition 69
11 SYSTem Subsystem 71
SYSTem:CDEScription? 72
SYSTem:CHANnel[:COUNt]? 73
SYSTem:ERRor? 74
SYSTem:LFREQuency 75
SYSTem:VERSion? 76
12 TRIGger Subsystem 77
TRIGger:SOURce 78
13 IEEE-488.2 Common Commands 79
*CAL? 80
*CLS 81
*ESE/*ESE? 82
*ESR? 84
*IDN? 86
*OPC/OPC? 87
*RST 88
*SRE/SRE? 89
*STB? 92
*TST? 94
*WAI 95
14 Error Messages 97
Error Messages 98
Error List 98
15 Default Factory Settings 105
U2722A Programmer’s Reference Guide
5
Contents
6
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
1
Introduction to Programming
Introduction to the SCPI Language 8
SCPI Conventions and Data Formats 9
Command Separators 11
Querying Parameter Settings 11
SCPI Command Terminators 12
IEEE-488.2 Common Commands 12
Address/Channel List Parameter 13
This chapter introduces the remote programming basics of the U2722A
USB modular source measure unit. The programming commands provide
the means to control this instrument remotely via a PC.
Agilent Technologies
7
1
Introduction to Programming
Introduction to the SCPI Language
SCPI, also known as the Standard Commands for Programmable
Instruments, is an ASCII-based instrument command language designed for
test and measurement instruments. SCPI commands are based on a
hierarchical structure, also known as a tree system. In this system,
associated commands are grouped together under a common node or root,
thus forming subsystems. A portion of the SOURce subsystem is shown
below to illustrate the tree system.
SOURce:
VOLTage:
RANGe <CPD>, (<(@1)|(@2)|(@3)>)
RANGe? (<(@1)|(@2)|(@3)>)
CURRent:
LIMit <CPD>, (<(@1)|(@2)|(@3)>)
LIMit? (<(@1)|(@2)|(@3)>)
SOURce is the root keyword of the command, VOLTage and CURRent are
second-level keywords, and RANGe and LIMit are third-level keywords. A
colon ( : ) separates a command keyword from a lower-level keyword.
For example, in the above syntax statement, VOLT and VOLTAGE are both
acceptable forms. You can use upper- or lower-case letters. Therefore,
VOLTAGE, volt, and Volt are all acceptable. Other forms, such as VOL
and VOLTAG, are not valid and will generate an error.
8
U2722A Programmer’s Reference Guide
Introduction to Programming
1
SCPI Conventions and Data Formats
The following SCPI conventions are used throughout this guide.
Angle brackets
< >
Vertical bar
|
Square brackets
[ ]
Parenthesis
( )
Braces
{ }
Items within angle brackets are parameter abbreviations. For
example, <NR1> indicates a specific form of numerical data.
Vertical bars separate alternative parameters. For example,
VOLT|CURR indicates that either "VOLT" or "CURR" can be used as a
parameter.
Items within square brackets are optional. The representation
[SOURce:]VOLTage means that SOURce: may be omitted.
Items within parentheses are used in place of the usual parameter
types to specify a channel list. The notation (@1:3) specifies a
channel list that consists of channels 1, 2, and 3. The notation
(@1,3) specifies a channel list that includes only channels 1 and 3.
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.
U2722A Programmer’s Reference Guide
9
1
Introduction to Programming
Data programmed or queried from the instrument is ASCII. The data may
be numerical or character string.
<NR1>
Digits with an implied decimal point assumed at the right of the
least-significant digit. Example: 273
<NR2>
Digits with an explicit decimal point. Example: 27.3
<NR3>
Digits with an explicit decimal point and an exponent. Example: 2.73E+02
<NRf>
Extended format that includes <NR1>, <NR2>, and <NR3>.
Examples: 273
<NRf+>
27.3
2.73E+02
Expanded decimal format that includes <NRf> and MIN, MAX.
Examples: 273
27.3
2.73E+02 MAX
MIN and MAX are the minimum and maximum limit values that are implicit
in the range specification for the parameter.
<Bool>
Boolean Data. Can be numeric (0, 1), or named (OFF, ON).
<SPD>
String Program Data. Programs string parameters enclosed in single or
double quotes.
<CPD>
Character Program Data. Programs discrete parameters. Accepts both the
short form and long form.
<SRD>
String Response Data. Returns string parameters enclosed in single or
double quotes.
<CRD>
Character Response Data. Returns discrete parameters. Only the short form
of the parameter is returned.
<AARD>
Arbitrary ASCII Response Data. Permits the return of an undelimited 7-bit
ASCII. This data type has an implied message terminator.
<Block>
Arbitrary Block Response Data. Permits the return of definite length and
indefinite length arbitrary response data. This data type has an implied
message terminator.
10
U2722A Programmer’s Reference Guide
Introduction to Programming
1
Command Separators
A colon ( : ) is used to separate a command keyword from a lower-level
keyword. You must insert a blank space to separate a parameter from a
command keyword. If a command requires more than one parameter, you
must separate adjacent parameters using a comma as shown below.
SOUR:VOLT:RANG R2V, (@1)
A semicolon ( ; ) is used to separate commands within the same
subsystem, and can also minimize typing. For example, sending the
following command string.
SENS:SWE:POIN 1000, (@1); TINT 10, (@1)
... is the same as sending the following two commands.
SENS:SWE:POIN 1000, (@1)
SENS:SWE:TINT 10, (@1)
Use a colon and semicolon to link commands from different subsystems.
For example, in the following command string, an error is generated if you
do not use both the colon and semicolon.
SOUR:VOLT:RANG R2V, (@1);:SENS:SWE:POIN 1000, (@1)
Querying Parameter Settings
You can query the current value of most parameters by adding a question
mark ( ? ) to the command. For example, the following command sets the
current range to 10 mA for output 1.
SOUR:CURR:RANG R10mA, (@1)
You can then query the current range setting by sending:
SOUR:CURR:RANG? (@1)
Typical Response: R10mA
U2722A Programmer’s Reference Guide
11
1
Introduction to Programming
SCPI Command Terminators
A command string sent to the instrument must terminate with a <new
line> (<NL>) character. The IEEE-488 End-Of-Identify (EOI) message is
interpreted as a <NL> character and can be used to terminate a command
string in place of a <NL> character. A <carriage return> followed by a
<NL> is also accepted. Command string termination will always reset the
current SCPI command path to the root level.
IEEE-488.2 Common Commands
The IEEE-488.2 standard defines a set of common commands that perform
functions such as reset, self-test, and status operation. Common commands
always begin with an asterisk ( * ), are three characters in length, and
may include one or more parameters. The command keyword is separated
from the first parameter by a blank space. Use a semicolon ( ; ) to
separate multiple commands as shown below.
*RST; *CLS; *ESE 32; *OPC?
12
U2722A Programmer’s Reference Guide
Introduction to Programming
1
Address/Channel List Parameter
There are two ways to specify the U2722A address or channel list
parameter. To specify a single channel, use the following syntax.
(@<ch>)
For example, CURR 0.02, (@1), where (@1) specifies channel 1.
To specify a single address, use the following syntax.
(@<address>)
For example, CONF:SSI SLAV, (@1), where (@1) specifies address 1.
To specify more than one address, the following syntax must be used.
(@<address>[,<address>])
NOTE
• The command CONFigure:SSI is the only U2722A command that uses the range of
address list.
• When adding a channel list parameter to a query, you must include a space character
between the query indicator (?) and channel list parameter. Otherwise error –103,
''Invalid separator'' will occur.
U2722A Programmer’s Reference Guide
13
1
14
Introduction to Programming
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
2
SCPI Status Registers
SCPI Status Registers 10
Operation Status Registers 12
Questionable Status Registers 12
Standard Event Register 13
Status Byte Register 14
This chapter explains the SCPI status registers that record various
instrument conditions of the U2722A USB modular source measure unit.
Agilent Technologies
9
2
ROUTe Subsystem
SCPI Status Registers
Status register programming lets you determine the operating condition of
the instrument at any time. The instrument has three groups of status
registers; Operation, Questionable, and Standard Event. The Operation and
Questionable Status groups each consists of Condition, Enable, Event
registers, and Negative-Transition (NTR) and Positive-Transition (PTR)
filters. The Status subsystem is also programmed using Common
commands. Common commands control additional status functions such as
the Service Request Enable and the Status Byte registers.
The U2722A uses the Operation, Questionable, Standard Event, and Status
Byte register groups to record a variety of instrument conditions. The
relationship between various registers in the U2722A SCPI status system
is shown in Figure 2- 1.
10
U2722A Programmer’s Reference Guide
ROUTe Subsystem
2
QUESTIONABLE STATUS GROUP
(Identical Registers For Each Channel)
CONDITION PTR/NTR
Not Used 0 3
4
OT
16
16
EVENT
ENABLE
''OR''
16
''OR''
QSUM
+
16
+
Not Used 5 - 15
STAT:QUES:COND?
STAT:QUES:EVEN?
STAT:QUES:PTR I :NTR <n>
STAT:QUES:PTR I :NTR?
STAT:QUES:ENAB <n>
STAT:QUES:ENAB?
ERROR QUEUE
STANDARD EVENT STATUS GROUP
EVENT
OPC 0 1
1
2
Not Used
QYE 2 4
3
DDE 4 8
16
EXE
5 32
CMD
6 64
Not Used
7 128
PON
*ESR?
ENABLE
1
2
4
8
16
32
64
128
QUEUE
NOT
EMPTY
Error
Error
Error
''OR''
SYST:ERR?
+
OUTPUT QUEUE
Data
Data
Data
*ESE <n>
*ESE?
QUEUE
NOT
EMPTY
SERVICE
STATUS BYTE REQUEST
ENABLE
0-1
Not Used
ERR 2 4
4
QUES 3 8
8
MAV 4
16
16
ESB 5
32
32
RQS
MSS 6
64
OPER 7
128
128
*STB?
*SRE <n>
*SRE?
OPERATION STATUS GROUP
(Identical Registers For Each Channel)
CONDITION PTR/NTR EVENT ENABLE
Not Used 0 - 4
32
WTG1-tran 5 32
32
32
WTG2-tran 6 64
64
64
64
WTG3-tran 7 128
128
128
128
Not Used 8 - 15
STAT:OPER:COND?
+
.
SERVICE
REQUEST
GENERATION
''OR''
+
''OR''
WTG1-tran
CHAN 1
WTG2-tran
CHAN 2
WTG3-tran
CHAN 3
STAT:OPER:EVEN?
STAT:OPER:PTR I :NTR <n>
STAT:OPER:PTR I :NTR?
STAT:OPER:ENAB <n>
STAT:OPER:ENAB?
Figure 2-1 Status system diagram
U2722A Programmer’s Reference Guide
11
2
ROUTe Subsystem
Operation Status Registers
These registers record signals that occur during normal operation. The
group consists of a Condition, PTR/NTR, Event, and Enable register. The
outputs of the Operation Status register group are logically-ORed into the
OPERation summary bit (7) of the Status Byte register.
Bit Definitions: Operation Status Registers
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
All bits in the Operation Enable register will be cleared when you execute
the STATus:PRESet command. This command presets the Operation Status
registers.
Questionable Status Registers
These registers record signals that indicate abnormal operation. The group
consists of the same register types as the Operation Status group. The
outputs of the Questionable Status group are logically-ORed into the
QUEStionable summary bit (3) of the Status Byte register.
Bit Definitions: Questionable Status Registers
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
• Once a bit is set, it remains set until cleared by reading the event
register or the clear status (*CLS) command.
• The STATus:PRESet command will clear all bits in the enable register.
This command presets the Questionable Status registers.
12
U2722A Programmer’s Reference Guide
ROUTe Subsystem
2
Standard Event Register
The Standard Event register reports the following types of instrument
events: power-on detected, command syntax errors, command execution
errors, self-test or calibration errors, query errors, or when an *OPC
command is executed. All of these conditions can be reported in the
Standard Event summary bit through enable register. To set the enable
register mask, key in a decimal value to the register using the event status
enable (*ESE)command.
Bit Definitions: Standard Event Register
Bit number
Decimal value
Definition
0 Operation Complete
1
All commands prior to and including *OPC have been executed.
1 Not Used
2
Always zero.
2 Query Error
4
The instrument tried to read the output buffer but it was empty. Or, a
new command line was received before a previous query has been
read. Or, both the input and output buffers are full.
3 Device-Dependent Error
8
A self-test or calibration error occurred. For a complete listing of the
error messages, refer to Chapter 14, “Error Messages” on page 98.
4 Execution Error
16
An execution error occurred (an error in the –200 range has been
generated).
5 Command Error
32
A command syntax error occurred (an error in the –100 range has
been generated).
6 Not Used
64
Always zero.
7 Power On
128
Power has been turned off and on since the last time the event
register was read or cleared.
The Standard Event register is cleared when:
• you execute the clear status (*CLS)command
• querying the event register using the event status register (*ESR?)
command
The Standard Event Enable register is cleared when you execute the
*ESE 0 command.
U2722A Programmer’s Reference Guide
13
2
ROUTe Subsystem
Status Byte Register
The Status Byte summary register reports conditions from the other status
registers. Query data that is waiting in the U2722A's output buffer is
immediately reported via message available bit (bit 4). Bits in the
summary register are not latched. Clearing an event register will clear the
corresponding bits in the Status Byte summary register. The message
available bit will be cleared once all the messages in the output buffer,
including any pending queries, have been read.
Bit Definitions: Status Byte Register
Bit number
Decimal
value
Definition
0 Not Used
1
Always zero.
1 Not Used
2
Always zero.
2 Error Queue
4
There is at least one error code in the error queue.
3 Questionable Status Event
8
One or more bits are set in the Questionable Event register (bits
must be enabled in the enable register).
4 Message Available
16
Data is available in the instrument's output buffer.
5 Event Status Byte summary
32
One or more bits are set in the Standard Event register (bits must
be enabled in the enable register).
6 Master Status summary
(Request for Service)
64
One or more bits are set in the Status Byte register (bits must be
enabled in the enable register). Also used to indicate a request for
service.
7 Operation Status Event
128
One or more bits are set in the Operation Event register (bits must
be enabled in the enable register).
The Status Byte summary register will be cleared when:
• you execute the clear status (*CLS) command
• querying the Standard Event register (*ESR? command will clear only
bit 4 in the summary register)
The Status Byte Enable register is cleared when you execute the *SRE 0
command.
NOTE
14
Please refer to Chapter 13, “IEEE-488.2 Common Commands” on page 79 for more details
of the common IEEE commands mentioned above.
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
3
ABORt Subsystem
ABORt:TRANsient 16
This chapter describes the ABORt command subsystem which is used to
cancel any triggered actions.
Agilent Technologies
15
3
CALibration Subsystem
ABORt:TRANsient
Syntax
ABORt:TRANsient (@<ch>)
This command cancels any transient trigger actions and returns the
transient trigger state back to idle. It also resets the WTG transient bits in
the Operation Condition Status register.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Remark
These commands are executed at power-on and upon execution of *RST.
Example
ABOR:TRAN (@1)
16
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
4
CONFigure Subsystem
CONFigure:SSI 18
The CONFigure:SSI command from the CONFigure subsystem handles the
synchronization status when the U2722A is used in the U2781A modular
instrument chassis.
Agilent Technologies
17
4
CONFigure Subsystem
CONFigure:SSI
Syntax
CONFigure:SSI {NONE|MASTer|SLAVe}, (@<address_list>)
This command sets the synchronization status (master/slave) when used in
the U2781A modular instrument chassis. The CONF:SSI MAST command
causes the triggering to the slave unit immediately.
CONFigure:SSI?
This query command returns a string value, which represents the
synchronization status (master/slave).
Parameters
Item
Type
Range of values
Default value
<address_list>
NR1
0 through 5
Required
parameter
{NONE|MASTer|SLAVe}
CPD
NONE: None
NONE
MAST: To function as a SSI master triggering
source
SLAV: To receive triggering source from a master
NOTE
• This command is only operational when it is used in a U2781A modular instrument
chassis.
• Only one slave is allowed to attach to one master.
• Each U2722A occupies two slots in the U2781A.
Remark
This command will force all reference clock sources to SSI (Synchronous
Simultaneous Interface).
Returned Query Format
{NONE|MAST|SLAV}
18
U2722A Programmer’s Reference Guide
CONFigure Subsystem
4
Examples
The following example sets the U2722A USB1 to master and U2722A USB2
and USB3 to slaves.
U2781A
Master
Slave
Slave
(U2722A USB1)
(U2722A USB2)
(U2722A USB3)
For USB2: CONF:SSI SLAV, (@0)
For USB3: CONF:SSI SLAV, (@1)
For USB1: CONF:SSI MAST, (@0,1)
The following queries return the string values.
For USB1: CONF:SSI?
Typical Response: MAST, 0, 1
For USB2: CONF:SSI?
Typical Response: SLAV, 0
For USB3: CONF:SSI?
Typical Response: SLAV, 1
U2722A Programmer’s Reference Guide
19
4
20
CONFigure Subsystem
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
5
INITiate Subsystem
INITiate[:IMMediate]:TRANsient 22
This chapter discusses the INITiate command subsystem for the U2722A.
Agilent Technologies
21
5
MEASure Subsystem
INITiate[:IMMediate]:TRANsient
Syntax
INITiate[:IMMediate]:TRANsient (@<ch>)
This command enables the transient trigger system. When a transient or
output trigger is initiated, an event on a selected trigger source causes the
specified triggering action to occur. If the trigger system is not initiated,
all triggers are ignored.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Example
INIT:TRAN (@1)
See Also
ABORt:TRANsient
22
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
6
MEASure Subsystem
MEASure[:SCALar]:CURRent[:DC]? 24
MEASure[:SCALar]:VOLTage[:DC]? 25
MEASure:ARRay:CURRent[:DC]? 26
MEASure:ARRay:VOLTage[:DC]? 27
MEASure:TEMPerature? 28
The MEASure command subsystem is a group of instructions used to
acquire data from the U2722A.
Agilent Technologies
23
6
MEASure Subsystem
MEASure[:SCALar]:CURRent[:DC]?
Syntax
MEASure[:SCALar]:CURRent[:DC]? (@<ch>)
Queries the current measured across the current sense resistor inside the
U2722A for the specified channel. Commas are used to separate multiple
responses.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Returned Query Format
<NR3>
The reading is in the form of +1.000000E+01 for each channel specified.
Example
MEAS:CURR? (@1)
Typical Response: +1.000000E+01
See Also
MEASure[:SCALar]:VOLTage[:DC]?
MEASure:ARRay:CURRent[:DC]?
24
U2722A Programmer’s Reference Guide
MEASure Subsystem
6
MEASure[:SCALar]:VOLTage[:DC]?
Syntax
MEASure[:SCALar]:VOLTage[:DC]? (@<ch>)
Queries the voltage measured at the sense terminals of the U2722A for the
specified channel. Commas are used to separate multiple responses.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Returned Query Format
<NR3>
The reading is in the form of +1.000000E+01 for each channel specified.
Example
MEAS:VOLT? (@1)
Typical Response: +5.000000E+01
See also
MEASure[:SCALar]:CURRent[:DC]?
MEASure:ARRay:VOLTage[:DC]?
U2722A Programmer’s Reference Guide
25
6
MEASure Subsystem
MEASure:ARRay:CURRent[:DC]?
Syntax
MEASure:ARRay:CURRent[:DC]? (@<ch>)
This query initiates and triggers a measurement and returns an array
containing the digitized output current in amperes. The sampling rate is
set by SENSe:SWEep:TINTerval whereas the number of points is set by
SENSe:SWEep:POINts.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Returned Query Format
<NR3>[,<NR3>]
The reading is in the form of +1.000000E+01. Array values responses are
separated by commas.
Example
MEAS:ARR:VOLT? (@1)
See Also
MEASure:ARRay:VOLTage[:DC]?
SENSe:SWEep:POINts
SENSe:SWEep:TINTerval
26
U2722A Programmer’s Reference Guide
MEASure Subsystem
6
MEASure:ARRay:VOLTage[:DC]?
Syntax
MEASure:ARRay:VOLTage[:DC]? (@<ch>)
This query initiates and triggers a measurement and returns an array
containing the digitized output voltage in volts. The sampling rate is set by
SENSe:SWEep:TINTerval whereas the returned number of points is set by
SENSe:SWEep:POINts.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
Returned Query Format
<NR3>[,<NR3>]
The reading is in the form of +1.000000E+01.
Example
MEAS:ARR:VOLT? (@1)
Typical Response: +2.000000E+01
See Also
MEASure:ARRay:CURRent[:DC]?
SENSe:SWEep:POINts
SENSe:SWEep:TINTerval
U2722A Programmer’s Reference Guide
27
6
MEASure Subsystem
MEASure:TEMPerature?
Syntax
MEASure:TEMPerature?
Queries the temperature measured at the measurement board in degree
Celsius (° C).
Returned Query Format
<NR2>
Example
MEAS:TEMP?
28
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
7
OUTPut Subsystem
OUTPut[:STATe] 30
The OUTPut command subsystem is used to switch on or off the U2722A.
Agilent Technologies
29
7
OUTPut Subsystem
OUTPut[:STATe]
Syntax
OUTPut[:STATe] <mode>, (@<ch>)
This enables or disables the output of the given channel(s).
OUTPut[:STATe]? (@<ch>)
This query command returns a string value representing the status of the
output.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
<mode>
Bool
OFF or 0: Disables the output
Required
parameter
ON or 1: Enables the output
Returned Query Format
<NR1>
The query command returns 0 if the output is OFF, and 1 if the output is
ON.
Examples
The following command turns the output of channel 2 on.
OUTP 1, (@2)
The following query returns the output state of channel 1.
OUTP? (@1)
Typical Response: +1
30
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
8
SENSe Subsystem
SENSe:CURRent[:DC]:APERture?
SENSe:CURRent[:DC]:NPLCycles
SENSe:SWEep:POINts 34
SENSe:SWEep:TINTerval 35
SENSe:VOLTage[:DC]:APERture?
SENSe:VOLTage[:DC]:NPLCycles
32
33
36
37
The SENSe command subsystem directly affects the device specific settings
used to make measurements.
Agilent Technologies
31
8
SENSe Subsystem
SENSe:CURRent[:DC]:APERture?
Syntax
SENSe:CURRent[:DC]:APERture? (@<ch>)
This will query the sampling time for a single current measurement point.
The parameter has a unit of seconds.
Parameter
Item
<ch>
Type
NR1
Range of values
1 through 3
Default value
Required parameter
Remark
The aperture value is derived from the following equation.
Aperture = NPLCycles
Line frequency
Returned Query Format
<NR3>
The reading is in the form of +1.000000E+01.
Example
SENS:CURR:APER? (@2)
Typical Response: +2.000000E-02
See Also
SENSe:CURRent[:DC]:NPLCycles
SENSe:VOLTage[:DC]:APERture?
SENSe:VOLTage[:DC]:NPLCycles
SYSTem:LFREQuency
32
U2722A Programmer’s Reference Guide
SENSe Subsystem
8
SENSe:CURRent[:DC]:NPLCycles
Syntax
SENSe:CURRent[:DC]:NPLCycles <cycles>, (@<ch>)
This command sets the number of power line cycles for the current
measurement in the defined channels.
SENSe:CURRent[:DC]:NPLCycles? (@<ch>)
Returns the number of power line cycles set for the current measurement
in the defined channels.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
<cycles>
NR1
0 to 255
Required
parameter
Returned Query Format
<NR1>
Examples
SENS:CURR:NPLC 10, (@1)
SENS:CURR:NPLC? (@1)
See Also
SENSe:CURRent[:DC]:APERture?
SENSe:VOLTage[:DC]:NPLCycles
U2722A Programmer’s Reference Guide
33
8
SENSe Subsystem
SENSe:SWEep:POINts
Syntax
SENSe:SWEep:POINts <points>, (@<ch>)
This command defines the number of points in a measurement. It can
handle values from 1 to 4096 (4K).
SENSe:SWEep:POINts? (@<ch>)
This will query the number of points set.
Parameters
Item
<ch>
Type
NR1
Range of values
1 through 3
<points>
NR1
1 to 4096 (4K)
Default value
Required
parameter
Required
parameter
Returned Query Format
<NR1>
The query command returns the number of points for each channel
specified.
Examples
The following command specifies 1000 measurement points on channel 1.
SENS:SWE:POIN 1000, (@1)
SENS:SWE:POIN? (@2)
See Also
SENSe:SWEep:TINTerval
34
U2722A Programmer’s Reference Guide
SENSe Subsystem
8
SENSe:SWEep:TINTerval
Syntax
SENSe:SWEep:TINTerval <interval>, (@<ch>)
This command defines the time period between samples in miliseconds.
SENSe:SWEep:TINTerval? (@<ch>)
Queries the time interval set.
Parameters
Item
<ch>
<interval>
Type
NR1
NR1
Range of values
1 through 3
1 to 32767
Default value
Required parameter
Required parameter
Returned Query Format
<NR1>
The query command returns the time interval for each channel specified.
The returned value is the time period in microseconds.
Examples
The following command specifies a time interval of 10 miliseconds
between measurement points on channel 1.
SENS:SWE:TINT 10, (@1)
The following query returns the measurement time interval for channel 2.
SENS:SWE:TINT? (@2)
See Also
SENSe:SWEep:POINts
U2722A Programmer’s Reference Guide
35
8
SENSe Subsystem
SENSe:VOLTage[:DC]:APERture?
Syntax
SENSe:VOLTage[:DC]:APERture? (@<ch>)
This will query the sampling time for a single voltage measurement point.
The parameter has a unit of seconds.
Parameter
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required parameter
Remark
The aperture value is derived from the following equation.
Aperture = NPLCycles
Line frequency
Returned Query Format
<NR3>
The reading is in the form +1.000000E+01.
Example
SENS:VOLT:APER? (@2)
Typical Response: +2.000000E-02
See Also
SENSe:CURRent[:DC]:APERture?
SENSe:CURRent[:DC]:NPLCycles
SENSe:VOLTage[:DC]:NPLCycles
SYSTem:LFREQuency
36
U2722A Programmer’s Reference Guide
SENSe Subsystem
8
SENSe:VOLTage[:DC]:NPLCycles
Syntax
SENSe:VOLTage[:DC]:NPLCycles <cycles>, (@<ch>)
This command sets the number of power line cycles for the voltage
measurement in the defined channels.
SENSe:VOLTage[:DC]:NPLCycles? (@<ch>)
Returns the number of power line cycles set for the voltage measurement
in the defined channels.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
<cycles>
NR1
0 to 255
Required
parameter
Returned Query Format
<NR1>
Examples
SENS:VOLT:NPLC 10, (@1)
SENS:VOLT:NPLC? (@1)
See Also
SENSe:CURRent[:DC]:APERture?
SENSe:CURRent[:DC]:NPLCycles
U2722A Programmer’s Reference Guide
37
8
38
SENSe Subsystem
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
9
SOURce Subsystem
[SOURce:]CURRent 40
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude] 41
[SOURce:]CURRent:LIMit 42
[SOURce:]CURRent:RANGe 43
[SOURce:]VOLTage 44
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude] 45
[SOURce:]VOLTage:LIMit 46
[SOURce:]VOLTage:RANGe 47
The SOURce command subsystem configures the output voltage and
current of the U2722A.
Agilent Technologies
39
9
SOURce Subsystem
[SOURce:]CURRent
Syntax
[SOURce:]CURRent[:LEVel][:IMMediate][:AMPLitude] <current>,
(@<ch>)
Sets the actual current magnitude of the unswept output signal in terms
of the present operating units. The units are set to the default value, or
alternately to a different value under the UNIT subsystem. The AMPLitude
may be used to specify the level for either a time varying or non-time
varying signal.
[SOURce:]CURRent[:LEVel][:IMMediate][:AMPLitude]? (@<ch>)
Queries the sourced current.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required parameter
<current>
NRf
The maximum value is dependent on the current range set
Required parameter
Examples
The following command sets the output current to 0.02 A on channel 1.
CURR 0.02, (@1)
The following query returns the programmed current level on channel 1.
CURR? (@1)
Typical Response: +2.000000E-02
See Also
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude]
[SOURce:]CURRent:RANGe
[SOURce:]VOLTage
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude]
40
U2722A Programmer’s Reference Guide
SOURce Subsystem
9
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude]
Syntax
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude] <current>,
(@<ch>)
This command sets the current trigger level of the specified output
channel. Units are in amperes. The triggered level is a stored value that is
transferred to the output when an output Step is triggered.
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude]? (@<ch>)
Queries the stored value of triggered current.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required parameter
<current>
NRf
The maximum value is dependent on the current range set
Required parameter
Examples
The following command sets the current trigger level to 0.02 A on channel
1.
CURR:TRIG 0.02, (@1)
The following query returns the current trigger level on channel 1.
CURR:TRIG? (@1)
Typical Response: +2.000000E-02
See Also
INITiate[:IMMediate]:TRANsient
[SOURce:]CURRent:RANGe
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude]
U2722A Programmer’s Reference Guide
41
9
SOURce Subsystem
[SOURce:]CURRent:LIMit
Syntax
[SOURce:]CURRent:LIMit <value>, (@<ch>)
Sets the maximum bounds on the output current value. Setting a larger
value will cause the output level to be clamped to the LIMit value.
[SOURce:]CURRent:LIMit? (@<ch>)
This will query the set current limit.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required parameter
<value>
NRf
The maximum value is dependent on the current range set
Required parameter
Examples
The following command sets the current limit to 0.8 A on channel 1.
CURR:LIM 0.8, (@1)
The following query returns the programmed current limit on channel 1.
CURR:LIM? (@1)
Typical Response: +8.000000E-01
See Also
[SOURce:]VOLTage:LIMit
42
U2722A Programmer’s Reference Guide
SOURce Subsystem
9
[SOURce:]CURRent:RANGe
Syntax
[SOURce:]CURRent:RANGe <range>, (@<ch>)
This command sets the output current range. At *RST, low voltage range is
selected.
[SOURce:]CURRent:RANGe? (@<ch>)
Queries the selected current range.
Parameters
Item
<ch>
<range>
Type
NR1
CRD
Range of values
1 through 3
R1uA – 1 μA range
Default value
Required parameter
R1uA
R10uA – 10 μA range
R100uA – 100 μA range
R1mA – 1 mA range
R10mA – 10 mA range
R120mA – 120 mA range
Returned Query Format
<CRD>
Examples
The following command sets the output current range to 1 mA on channel
1.
CURR:RANG R1mA, (@1)
The following query returns the programmed current range on channel 1.
CURR:RANG? (@1)
Typical Response: R1mA
See Also
[SOURce:]VOLTage:RANGe
U2722A Programmer’s Reference Guide
43
9
SOURce Subsystem
[SOURce:]VOLTage
Syntax
[SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude] <voltage>,
(@<ch>)
Sets the actual voltage magnitude of the unswept output signal in terms of
the present operating units. The units are set to the default value, or
alternately to a different value under the UNIT subsystem. The AMPLitude
may be used to specify the level for either a time varying or non-time
varying signal.
[SOURce:]VOLTage[:LEVel][:IMMediate][:AMPLitude]? (@<ch>)
Queries the sourced voltage.
Parameters
Item
Type
Range of values
Default value
<ch>
<voltage>
NR1
1 through 3
Required parameter
NRf
The maximum value is dependent on the voltage range set
Required parameter
Examples
The following command sets the output current to 5 V on channel 1.
VOLT 5, (@1)
The following query returns the programmed voltage level on channel 1.
VOLT? (@1)
Typical Response: +5.000000E+00
See Also
[SOURce:]CURRent
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude]
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude]
44
U2722A Programmer’s Reference Guide
SOURce Subsystem
9
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude]
Syntax
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude] <voltage>,
(@<ch>)
This command sets the voltage trigger level of the specified output
channel. Units are in voltage. The triggered level is a stored value that is
transferred to the output when an output Step is triggered.
[SOURce:]VOLTage[:LEVel]:TRIGgered[:AMPLitude]? (@<ch>)
Query the stored value of triggered voltage.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
<voltage>
NRf
The maximum value is dependent on the
voltage range set
Required
parameter
Examples
The following command sets the voltage trigger level to 0.02 A on channel
1.
VOLT:TRIG 0.02, (@1)
The following query returns the voltage trigger level on channel 1.
VOLT:TRIG? (@1)
Typical Response: +2.000000E-02
See Also
INITiate[:IMMediate]:TRANsient
[SOURce:]CURRent[:LEVel]:TRIGgered[:AMPLitude]
[SOURce:]CURRent:RANGe
U2722A Programmer’s Reference Guide
45
9
SOURce Subsystem
[SOURce:]VOLTage:LIMit
Syntax
[SOURce:]VOLTage:LIMit <value>, (@<ch>)
Sets the maximum bounds on the output voltage value. Setting a larger
value will cause the output level to be clamped to the LIMit value.
[SOURce:]VOLTage:LIMit? (@<ch>)
This will query the set voltage limit.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required
parameter
<value>
NRf
The maximum value is dependent on the
voltage range set
Required
parameter
Examples
The following command sets the voltage limit to 0.5 V on channel 1.
VOLT:LIM 0.5, (@1)
The following query returns the programmed voltage limit on channel 1.
VOLT:LIM? (@1)
Typical Response: +5.000000E-01
See Also
[SOURce:]CURRent:LIMit
46
U2722A Programmer’s Reference Guide
SOURce Subsystem
9
[SOURce:]VOLTage:RANGe
Syntax
[SOURce:]VOLTage:RANGe <range>, (@<ch>)
Selects an output range to be programmed by the identifier. At *RST, low
voltage range is selected.
[SOURce:]VOLTage:RANGe? (@<ch>)
Queries the selected voltage range.
Parameters
Item
Type
Range of values
Default value
<ch>
NR1
1 through 3
Required parameter
<range>
CPD
R2V – 2 V range
Required parameter
R20V – 20 V range
Returned Query Format
<CRD>
Examples
The following command sets the output voltage range to 20 V on channel
1.
VOLT:RANG R20V, (@1)
The following query returns the programmed voltage range on channel 1.
VOLT:RANG? (@1)
Typical Response: R20V
See Also
[SOURce:]CURRent:RANGe
U2722A Programmer’s Reference Guide
47
9
48
SOURce Subsystem
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
10
STATus Subsystem
STATus:OPERation:CONDition? 52
STATus:OPERation:ENABle 53
STATus:OPERation[:EVENt]? 55
STATus:OPERation:NTRansition 57
STATus:OPERation:PTRansition 59
STATus:PRESet 61
STATus:QUEStionable:CONDition? 62
STATus:QUEStionable:ENABle 63
STATus:QUEStionable[:EVENt]? 65
STATus:QUEStionable:NTRansition 67
STATus:QUEStionable:PTRansition 69
The STATus command subsystem lets you determine the operating
condition of the U2722A at any time.
Agilent Technologies
51
10
SOURce Subsystem
STATus:OPERation:CONDition?
Syntax
STATus:OPERation:CONDition?
This query command returns the
register. The Condition register is
(unlatched) operational status of
Condition register does not clear
NOTE
value of the Operation Status Condition
a read-only register, which holds the live
the instrument. Reading the Operation
it.
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Remarks
The following table lists the bit definitions for the Operation Status
registers.
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register. For example, if bit 5 (decimal value = 32) and bit 6 (decimal
value = 64) are set, this query command will return ''+96'' (32 + 64).
Example
The following query command reads the Operation Status Condition
register.
STAT:OPER:COND?
Typical Response: +32
52
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:OPERation:ENABle
Syntax
STATus:OPERation:ENABle <value>
STATus:OPERation:ENABle?
This command and its query set and read the value of the Operation
Status Enable register. The enable register is a mask for enabling specific
bits from the Operation Event register to set the operation summary bit
(OPER) of the Status Byte register. This bit (bit 7) is the logical OR of all
the Operation Event register bits that are enabled by the Operation Status
Enable register.
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
NOTE
Parameters
Item
<value>
Type
NR1
Range of values
A decimal value which corresponds to the binary-weighted sum
of the bits in the register (refer to the table below).
Default value
Preset = 0
For example, to enable bit 5 (decimal value = 32) and bit 6 (decimal
value = 64), the corresponding decimal value would be 96 (32 + 64).
Remarks
• The following table lists the bit definitions for the Operation Status
registers.
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will clear all bits in the enable register.
U2722A Programmer’s Reference Guide
53
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register. For example, if bit 5 (decimal value = 32) and bit 6 (decimal
value = 64) are set, the query command will return ''+96''.
Examples
The following command enables bits 5 (decimal value = 32) and 6 (decimal
value = 64) in the enable register.
STAT:OPER:ENAB 96
The following query returns the bits enabled in the register.
STAT:OPER:ENAB?
Typical Response: +96
See Also
STATus:OPERation[:EVENt]?
STATus:PRESet
54
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:OPERation[:EVENt]?
Syntax
STATus:OPERation[:EVENt]?
This query returns the value of the Operation Status Event register. The
Event register is a read-only register, which stores (latches) all events that
are passed by the Operation NTR and/or PTR filter. Reading the Operation
Status Event register clears it.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11 .
Remarks
• The following table lists the bit definitions for the Operation Status
registers.
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
• Once a bit is set, it remains set until cleared by reading the event
register or the clear status (*CLS) command.
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register. For example, if bit 5 (decimal value = 32) and bit 6 (decimal
value = 64) are set, this query command will return ''+96''.
U2722A Programmer’s Reference Guide
55
10
SOURce Subsystem
Example
The following query command reads the Operation Status Event register.
STAT:OPER?
Typical Response: +96
See Also
STATus:OPERation:ENABle
*CLS
56
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:OPERation:NTRansition
Syntax
STATus:OPERation:NTRansition <value>
STATus:OPERation:NTRansition?
These command and query set and read the value of the Operation
Negative-Transition (NTR) register. This register serves as a polarity filter
between the Operation Condition and Operation Event registers.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Parameters
Item
Type
Range of values
Default value
<value>
NR1
A decimal value which corresponds to the binary-weighted
sum of the bits in the register (refer to the table below).
Preset = 0
For example, to enable bit 5 (decimal value = 32) and bit 6 (decimal
value = 64), the corresponding decimal value would be 96 (32 + 64).
Remarks
• The following table lists the bit definitions for the Operation Status
registers.
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will set all bits in the NTR register to 0.
U2722A Programmer’s Reference Guide
57
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register.
Examples
The following command enables bits 5 (decimal value = 32) and 6 (decimal
value = 64) in the NTR register.
STAT:OPER:NTR 96
The following query returns the bits enabled in the register.
STAT:OPER:NTR?
Typical Response: +96
See Also
STATus:OPERation:PTRansition
STATus:PRESet
58
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:OPERation:PTRansition
Syntax
STATus:OPERation:PTRansition <value>
STATus:OPERation:PTRansition?
These command and query set and read the value of the Operation
Positive-Transition (PTR) register. This register serves as a polarity filter
between the Operation Condition and Operation Event registers.
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
NOTE
Parameters
Item
Type
Range of values
Default value
<value>
NR1
A decimal value which corresponds to the binary-weighted
sum of the bits in the register (refer to the table below).
Preset = 224
For example, to enable bit 5 (decimal value = 32) and bit 6 (decimal
value = 64), the corresponding decimal value would be 96 (32 + 64).
Remarks
• The following table lists the bit definitions for the Operation Status
registers.
Bit number
Decimal value
Definition
0 to 4 Not Used
0
0 is returned.
5 WTG1-tran
32
The transient system is waiting for a trigger in channel 1.
6 WTG2-tran
64
The transient system is waiting for a trigger in channel 2.
7 WTG3-tran
128
The transient system is waiting for a trigger in channel 3.
8 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will set all bits in the PTR register to 1.
U2722A Programmer’s Reference Guide
59
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register.
Examples
The following command enables bits 5 (decimal value = 32) and 6 (decimal
value = 64) in the PTR register.
STAT:OPER:PTR 96
The following query returns the bits enabled in the register.
STAT:OPER:PTR?
Typical Response: +96
See Also
STATus:OPERation:NTRansition
STATus:PRESet
60
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:PRESet
Syntax
STATus:PRESet
This command sets all defined bits in the status system's PTR registers
and clears all bits in the NTR and enable registers.
Parameters
Operation register
Questionable register
Definition
STAT:OPER:ENAB
STAT:QUES:ENAB
0 – all bits disabled.
STAT:OPER:NTR
STAT:QUES:NTR
0 – all bits disabled.
STAT:OPER:PTR
224 – all defined bits enabled.
STAT:QUES:PTR
16 – all defined bits enabled.
Example
The following command presets the Operation and Questionable Status
registers.
STAT:PRES
U2722A Programmer’s Reference Guide
61
10
SOURce Subsystem
STATus:QUEStionable:CONDition?
Syntax
STATus:QUEStionable:CONDition?
This query returns the value of the Questionable Status Condition register.
The Condition register is a read-only register, which holds the live
(unlatched) questionable status of the instrument. Reading the
Questionable Condition register does not clear it.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Remarks
The following table lists the bit definitions for the Questionable Status
registers.
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register. For example, if bit 4 is set, this query command will return ''+16''.
Example
The following query command reads the Questionable Status Condition
register.
STAT:QUES:COND?
Typical Response: +16
62
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:QUEStionable:ENABle
Syntax
STATus:QUEStionable:ENABle <value>
STATus:QUEStionable:ENABle?
This command and its query set and read the value of the Questionable
Status Enable register. The enable register is a mask for enabling specific
bits from the Questionable Event register to set the questionable summary
bit (QUES) of the Status Byte register. This bit (bit 3) is the logical OR of
all the Questionable Event register bits that are enabled by the
Questionable Status Enable register.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Parameters
Item
Type
Range of values
Default value
<value>
NR1
A decimal value which corresponds to the binary-weighted
sum of the bits in the register (refer to the table below).
Preset = 0
For example, to enable bit 4, the corresponding decimal value would be
16.
Remarks
• The following table lists the bit definitions for the Questionable Status
registers.
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will clear all bits in the enable register.
U2722A Programmer’s Reference Guide
63
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register.
Examples
The following command enables bit 4 (decimal value = 16) in the enable
register.
STAT:QUES:ENAB 16
The following query returns the bits enabled in the register.
STAT:QUES:ENAB?
Typical Response: +16
See Also
STATus:QUEStionable[:EVENt]?
STATus:PRESet
64
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:QUEStionable[:EVENt]?
Syntax
STATus:QUEStionable[:EVENt]?
This query returns the value of the Questionable Status Event register. The
Event register is a read-only register, which stores (latches) all events that
are passed by the Questionable NTR and/or PTR filter. Reading the
Questionable Status Event register clears it.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Remarks
• The following table lists the bit definitions for the Questionable Status
registers.
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
• Once a bit is set, it remains set until cleared by reading the event
register or the clear status (*CLS) command.
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register. For example, if bit 4 is set, this query command will return ''+16''.
U2722A Programmer’s Reference Guide
65
10
SOURce Subsystem
Example
The following command reads the Questionable Status Event register.
STAT:QUES?
Typical Response: +0
See Also
STATus:QUEStionable:ENABle
*CLS
66
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:QUEStionable:NTRansition
Syntax
STATus:QUEStionable:NTRansition <value>
STATus:QUEStionable:NTRansition?
These command and query set and read the value of the Questionable
NTR (Negative-Transition) register. This register serves as a polarity filter
between the Questionable Condition and Questionable Event registers.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Parameter
Item
Type
Range of values
Default value
<value>
NR1
A decimal value which corresponds to the binary-weighted
sum of the bits in the register (refer to the table below).
Preset = 0
For example, to enable bit 4, the corresponding decimal value would be
16.
Remarks
• The following table lists the bit definitions for the Questionable Status
registers.
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will set all bits in the NTR register to 0.
U2722A Programmer’s Reference Guide
67
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register.
Examples
The following command enables bit 4 (decimal value = 16) in the NTR
register.
STAT:QUES:NTR 16
The following query returns the bits enabled in the register.
STAT:QUES:NTR?
Typical Response: +16
See Also
STATus:QUEStionable:PTRansition
STATus:PRESet
68
U2722A Programmer’s Reference Guide
SOURce Subsystem
10
STATus:QUEStionable:PTRansition
Syntax
STATus:QUEStionable:PTRansition <value>
STATus:QUEStionable:PTRansition?
These command and query set and read the value of the Questionable PTR
(Positive-Transition) register. This register serves as a polarity filter
between the Questionable Condition and Questionable Event registers.
NOTE
For more information on the SCPI Status System, refer to Chapter 2, “Status system
diagram” on page 11.
Parameter
Item
Type
Range of values
Default value
<value>
NR1
A decimal value which corresponds to the binary-weighted
sum of the bits in the register (refer to the table below).
Preset = 16
For example, to enable bit 4, the corresponding decimal value would be
16.
Remarks
• The following table lists the bit definitions for the Questionable Status
registers.
Bit number
Decimal value
Definition
0 to 3 Not Used
0
0 is returned.
4 OT
16
The over-temperature protection has tripped.
5 to 15 Not Used
0
0 is returned.
• The STATus:PRESet command will set all bits in the PTR register to 1.
U2722A Programmer’s Reference Guide
69
10
SOURce Subsystem
Returned Query Format
<NR1>
The returned value is the binary-weighted sum of all bits set in the
register.
Examples
The following command enables bit 4 (decimal value = 16) in the PTR
register.
STAT:QUES:PTR 16
The following query returns the bits enabled in the register.
STAT:QUES:PTR?
Typical Response: +16
See Also
STATus:QUEStionable:NTRansition
STATus:PRESet
70
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
11
SYSTem Subsystem
SYSTem:CDEScription? 72
SYSTem:CHANnel[:COUNt]? 73
SYSTem:ERRor? 74
SYSTem:LFREQuency 75
SYSTem:VERSion? 76
The SYSTem command subsystem is used to return slot description and
channel count of the U2722A when used in a chassis. This subsystem also
returns the error numbers and messages from the U2722A as well as sets
the line frequency and queries the SCPI version.
Agilent Technologies
71
11
SYSTem Subsystem
SYSTem:CDEScription?
Syntax
SYSTem:CDEScription?
Identifies which slot the U2722A is plugged into the U2781A modular
instrument chassis.
Remarks
• It is only applicable when the U2722A is used in the modular
instrument chassis.
• If the U2722A is not plugged into the chassis, then the returned query
value would be ''+7, +0'', where ''+7'' is an invalid slot number and ''+0''
is the chassis number.
• Please refer to the U2781A Modular Instrument Chassis User's Guide for
the details.
Returned Query Format
<NR1>, <NR1>
Examples
The following shows the query when the U2722A is slotted into slot 4 of
chassis #1.
SYST:CDES?
Typical Response: +4, +1
Below is the query when the U2722A is plugged into slot 2 of chassis #2.
SYST:CDES?
Typical Response: +2, +2
72
U2722A Programmer’s Reference Guide
SYSTem Subsystem
11
SYSTem:CHANnel[:COUNt]?
Syntax
SYSTem:CHANnel[:COUNt]?
Queries the number of output or measurement channels of the U2722A.
Returned Query Format
<NR1>
Example
Th following query returns the number of output channels.
SYST:CHAN?
Typical Response: +3
See Also
SYSTem:CDEScription?
U2722A Programmer’s Reference Guide
73
11
SYSTem Subsystem
SYSTem:ERRor?
Syntax
SYSTem:ERRor?
This query returns the next error number and its corresponding message
string from the error queue. The queue is a first-in, first-out (FIFO) buffer
that stores errors as they occur. As it is read, each error is removed from
the queue. When all the errors have been read, the query returns 0, "No
error". Refer to Chapter 14, “Error Messages” on page 97 for the error
codes.
Remarks
• Errors are retrieved in first-in-first-out (FIFO) order. The first error
returned is the first error that was stored.
• Errors are cleared as you read them. When you have read all the errors
from the error queue, the power indicator turns off and the errors are
cleared.
• The error queue is cleared by the clear status (*CLS) command and
when power is cycled. The errors are also cleared when you read the
error queue.
Returned Query Format
<NR1>, <SRD>
Example
SYST:ERR?
Typical Response: –101, "Invalid character"
74
U2722A Programmer’s Reference Guide
SYSTem Subsystem
11
SYSTem:LFREQuency
Syntax
SYSTem:LFREQuency <mode>
Sets the line frequency.
SYSTem:LFREQuency?
Queries the line frequency.
Parameter
Item
Type
Range of values
Default value
<mode>
CPD
F50HZ: 50 Hz frequency line
F50HZ
F60HZ: 60 Hz frequency line
Examples
The following command sets the line frequency to 60 Hz.
SYST:LFREQ F60HZ
The following query returns the line frequency.
SYST:LFREQ?
Typical Response: F60Hz
U2722A Programmer’s Reference Guide
75
11
SYSTem Subsystem
SYSTem:VERSion?
Syntax
SYSTem:VERSion?
This command returns the version of the SCPI (Standard Commands for
Programmable Instruments) standard in which the instrument complies
with.
Returned Query Format
<SRD>
The command returns a string in the form of "YYYY.V", where YYYY
represents the year of the version and V represents a version for that
year.
Example
SYST:VERS?
Typical Response: "1997.0"
76
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
12
TRIGger Subsystem
TRIGger:SOURce 78
The chapter describes the TRIGger command subsystem which controls the
remote triggering of the instrument. These commands specify the trigger
source for the transient and measurement system, and also generate
software triggers.
Agilent Technologies
77
12
SYSTem Subsystem
TRIGger:SOURce
Syntax
TRIGger:SOURce <NONE|STRG>
Selects the trigger source to NONE or STRG.
TRIGger:SOURce?
Queries the present trigger source.
Examples
The following command selects the trigger source to NONE.
TRIG:SOUR <NONE>
The following query returns the trigger source.
TRIG:SOUR?
Typical Response: NONE
78
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
13
IEEE-488.2 Common Commands
*CAL? 80
*CLS 81
*ESE/*ESE? 82
*ESR? 84
*IDN? 86
*OPC/OPC? 87
*RST 88
*SRE/SRE? 89
*STB? 92
*TST? 94
*WAI 95
This chapter contains information on the IEEE-488.2 Common (*)
Commands supported by the U2722A. It also describes the universal
command statements which form the nucleus of the GPIB programming
understood by all instruments in the network. When combined with the
programming language codes, the commands provide all management and
data communication instructions for the system
Agilent Technologies
79
13
IEEE-488.2 Common Commands
*CAL?
Syntax
*CAL?
Performs a self-calibration of the instrument and returns a pass/fail
indication.
Returned Query Format
<NR1>
The command returns "+0" (calibration test passed) or "+1" (calibration test
failed).
Example
*CAL?
Typical Response: +0
80
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
*CLS
Syntax
*CLS
This command is used to clear the event registers in all register groups
and also clears the error queue.
Example
The following command clears the event register bits.
*CLS
U2722A Programmer’s Reference Guide
81
13
IEEE-488.2 Common Commands
*ESE/*ESE?
Syntax
*ESE <enable_value>
This command enables bits in the enable register for the Standard Event
register group. The selected bits are then reported to bit 5 of the Status
Byte register.
*ESE?
This will query the Standard Event register group.
Parameter
Item
<enable_value>
Type
NRf
Range of values
A decimal value that corresponds to the binary-weighted
sum of the bits in the register. Refer to the table below.
Default value
This is a required
parameter.
Remarks
• The following table lists the bit definitions for the Standard Event
register.
82
Bit number
0 Operation Complete
Decimal value
1
1 Not Used
2 Query Error
2
4
3 Device-Dependent Error
8
4 Execution Error
16
5 Command Error
32
6 Not Used
7 Power On
64
128
Definition
All commands prior to and including *OPC have been
executed.
Always zero.
The instrument tried to read the output buffer but it was
empty. Or, a new command line was received before a
previous query has been read. Or, both the input and output
buffers are full.
A self-test or calibration error occurred. For a complete listing
of the error messages, refer to Chapter 14, “Error
Messages” on page 97.
An execution error occurred (an error in the –200 range has
been generated.
A command syntax error occurred (an error in the –100 range
has been generated).
Always zero.
Power has been turned off and on since the last time the
event register was read or cleared.
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
• Use the <enable_value> parameter to specify which bits will be
enabled. The specified decimal value corresponds to the binary-weighted
sum of the bits you wish to enable in the register. For example, to
enable bit 2 (decimal value = 4), bit 4 (decimal value = 16), and bit 5
(decimal value = 32), the corresponding decimal value would be 52 (4 +
16 + 32).
• The clear status (*CLS) command will not clear the enable register but
it clears all bits in the event register.
Returned Query Format
<NR1>
The query command reads the enable register and returns a decimal value
that corresponds to the binary-weighted sum of all bits set in the register.
For example, if bit 3 (decimal value = 8) and bit 7 (decimal value = 128)
are enabled, the query command will return ''+136''.
Examples
The following command enables bit 4 (decimal value = 16) in the enable
register. If an execution error occurs, this condition will be reported to
the Status Byte register (bit 5 will be set to high).
*ESE 16
The following query returns the bits enabled in the register.
*ESE?
Typical Response: +16
See Also
*ESR?
U2722A Programmer’s Reference Guide
83
13
IEEE-488.2 Common Commands
*ESR?
Syntax
*ESR?
This query returns the value of the event register of the Standard Event
Status group. Once it is read, it will be cleared automatically. The event
register is a read-only register, which stores (latches) all standard events.
Parameter
Item
Type
Range of values
Default value
<value>
NR1
A decimal value that corresponds to the binary-weighted
sum of the bits in the register. Refer to the table below.
This is a required
parameter.
Remarks
• The following table lists the bit definitions for the Standard Event
register.
84
Bit number
Decimal value
Definition
0 Operation Complete
1
All commands prior to and including *OPC have been
executed.
1 Not Used
2
Always zero.
2 Query Error
4
The instrument tried to read the output buffer but it was
empty. Or, a new command line was received before a
previous query has been read. Or, both the input and output
buffers are full.
3 Device-Dependent Error
8
A self-test or calibration error occurred. For a complete listing
of the error messages, refer to Chapter 14, “Error
Messages” on page 97.
4 Execution Error
16
An execution error occurred (an error in the –200 range has
been generated.
5 Command Error
32
A command syntax error occurred (an error in the –100 range
has been generated).
6 Not Used
64
Always zero.
7 Power On
128
Power has been turned off and on since the last time the
event register was read or cleared.
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
• To be reported to the Standard Event register, the corresponding bits in
the event register must be enabled using the *ESE/*ESE? command.
• Once a bit is set, it will remain set until cleared by reading the event
register or the clear status (*CLS) command.
Returned Query Format
<NR1>
The query command reads the enable register and returns a decimal value
that corresponds to the binary-weighted sum of all bits set in the register.
For example, if bit 3 (decimal value = 8) and bit 7 (decimal value = 128)
are enabled, the query command will return ''+136''.
Example
The following query returns the bits enabled in the register.
*ESR?
Typical Response: +16
See Also
*ESE/*ESE?
U2722A Programmer’s Reference Guide
85
13
IEEE-488.2 Common Commands
*IDN?
Syntax
*IDN?
This command reads the instrument's identification string which contains
four comma-separated fields. The first field is the manufacturer's name,
the second is the model number of the instrument, the third is the serial
number, and the fourth is the firmware revision code with the
measurement firmware version.
Returned Query Format
<AARD>
The command returns a string with the following format.
AGILENT TECHNOLOGIES,U2722A,<Serial Number>,Rf.ff-c.cc
f.ff
= firmware revision number
c.cc
= measurement firmware version
Example
The following query returns the instrument's identification string.
*IDN?
Typical Response:
AGILENT TECHNOLOGIES,U2722A,MY12345678,R1.00-1.00
86
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
*OPC/OPC?
Syntax
*OPC
The command is mainly used for program synchronization. It causes the
instrument to set the OPC bit (bit 0) of the Standard Event Status register
when the instrument has completed all pending operation sent before the
*OPC command.
*OPC?
This query returns "1" to the output buffer at the completion of the
current operation. *OPC? command does not suspend processing of
commands.
Remarks
Pending operation have completed when:
• all commands sent before *OPC, including paralleled commands, have
completed. Most commands are sequential and will be completed before
the next command is executed. Commands that affect the output
voltage, current, or state, relays, and trigger actions are executed in
parallel with subsequent commands. *OPC provides notification for the
completion of the parallel commands
• all triggered actions have completed
*OPC does not prevent processing of subsequent commands, however, the
OPC bit will not be set until all pending operation have completed.
Returned Query Format
<NR1>
The command returns "1" to the output buffer.
See Also
*ESE/*ESE?
*ESR?
U2722A Programmer’s Reference Guide
87
13
IEEE-488.2 Common Commands
*RST
Syntax
*RST
This command resets the instrument to the default configuration. Refer to
Chapter 15, “Default Factory Settings” on page 105 for a complete listing
of the instrument's default configuration.
Example
The following command resets the instrument.
*RST
88
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
*SRE/SRE?
Syntax
*SRE <enable_value>
This command enables the bits in the enable register for the Status Byte
register group. Once enabled, the corresponding bits may generate a
Request for Service (RQS) in the Status Byte. This RQS event may
generate a "call back" to your application as a type of asynchronous
interrupt.
*SRE?
The query command reads the enable register and returns a decimal value
that corresponds to the binary-weighted sum of all bits set in the register.
For example, if bit 2 (decimal value = 4) and bit 6 (decimal value = 64)
are enabled, the query command will return ''+68''.
Parameter
Item
Type
Range of values
Default value
<enable_value>
NRf
A decimal value that corresponds to the binary-weighted
sum of the bits in the register. Refer to the table below.
This is a required
parameter.
U2722A Programmer’s Reference Guide
89
13
IEEE-488.2 Common Commands
Remarks
• The following table lists the bit definitions for the Status Byte register.
Bit number
Decimal value
Definition
0 Not Used
1
Always zero.
1 Not Used
2
Always zero.
2 Error Queue
4
There is at least one error code in the error queue.
3 Questionable Status Event
8
One or more bits are set in the Questionable Event register
(bits must be enabled in the enable register).
4 Message Available
16
Data is available in the instrument's output buffer.
5 Event Status Byte summary
32
One or more bits are set in the Standard Event register (bits
must be enabled in the enable register).
6 Master Status summary
(Request for Service)
64
One or more bits are set in the Status Byte register (bits must
be enabled in the enable register). Also used to indicate a
request for service.
7 Operation Status Event
128
One or more bits are set in the Operation Event register (bits
must be enabled in the enable register).
• Use the <enable_value> parameter to specify which bits will be
enabled. The specified decimal value corresponds to the binary-weighted
sum of the bits you wish to enable in the register. For example, to
enable bit 3 (decimal value = 8) and bit 6 (decimal value = 64), the
corresponding decimal value would be 72 (8 + 64).
• The Status Byte Enable register will be cleared when you execute the
*SRE 0 command.
Returned Query Format
<NR1>
The query command reads the enable register and returns a decimal value
that corresponds to the binary-weighted sum of all bits set in the register.
For example, if bit 3 (decimal value = 8) and bit 7 (decimal value = 128)
are enabled, the query command will return ''+136''.
90
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
Examples
The following command enables bit 4 (decimal value = 16) in the enable
register. If an execution error occurs, this condition will be reported to
the Status Byte register (bit 5 will be set to high).
*SRE 16
The following query returns the bits enabled in the register.
*SRE?
Typical Response: +16
See Also
*STB?
U2722A Programmer’s Reference Guide
91
13
IEEE-488.2 Common Commands
*STB?
Syntax
*STB?
Queries the condition register for the Status Byte register group. This
query command is similar to a Serial Poll but it is processed like any
other instrument command. This is a read-only register and the bits will
not be cleared once they are read.
Remarks
• The following table lists the bit definitions for the Status Byte register.
Bit number
Decimal value
Definition
0 Not Used
1
Always zero.
1 Not Used
2
Always zero.
2 Error Queue
4
There is at least one error code in the error queue.
3 Questionable Status Event
8
One or more bits are set in the Questionable Event register
(bits must be enabled in the enable register).
4 Message Available
16
Data is available in the instrument's output buffer.
5 Event Status Byte summary
32
One or more bits are set in the Standard Event register (bits
must be enabled in the enable register).
6 Master Status summary
(Request for Service)
64
One or more bits are set in the Status Byte register (bits must
be enabled in the enable register). Also used to indicate a
request for service.
7 Operation Status Event
128
One or more bits are set in the Operation Event register (bits
must be enabled in the enable register).
• Use the <enable_value> parameter to specify which bits will be
enabled. The specified decimal value corresponds to the binary-weighted
sum of the bits you wish to enable in the register. For example, to
enable bit 3 (decimal value = 8) and bit 6 (decimal value = 64), the
corresponding decimal value would be 72 (8 + 64).
• The Status Byte Enable register will be cleared once you execute the
*SRE 0 command.
92
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
Returned Query Format
<NR1>
The command will return "1" to the output buffer.
Example
The following command reads the condition register (bits 3 and 4 are set).
*STB?
Typical Response: +24
See Also
*CLS
U2722A Programmer’s Reference Guide
93
13
IEEE-488.2 Common Commands
*TST?
Syntax
*TST?
This query command performs a self-test of the instrument and returns a
pass/fail indication.
Returned Query Format
<NR1>
The command returns "+0" (all tests passed) or "+1" (one or more tests
failed).
Example
The following query command performs a self-test and returns a pass/fail
indication.
*TST?
Typical Response: +0
94
U2722A Programmer’s Reference Guide
IEEE-488.2 Common Commands
13
*WAI
Syntax
*WAI
This command configures the instrument to wait for the completion of all
pending operation before executing any additional commands over the
interface.
See Also
*OPC/OPC?
U2722A Programmer’s Reference Guide
95
13
96
IEEE-488.2 Common Commands
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
14
Error Messages
Error Messages 98
Error List 98
The U2722A SCPI command errors are summarized in this chapter.
Agilent Technologies
97
10
Error Messages
Error Messages
Error messages are created once a command error or an erroneous
condition has been detected.
• Errors are retrieved in first-in, first-out (FIFO) order.
• Errors are cleared as you read them.
• No additional errors will be stored until you remove the errors from the
queue. If no errors occur when you read the error queue, the
instrument will respond with 0, "No error".
• SYSTem:ERRor? will read and clear one error from the queue.
Error List
The table below contains the device-dependent errors.
Table 14-1 Device-dependent errors
Error
Device-dependent errors (these errors set the Standard Event Status register bit #3)
0
No error
This is the response to the SYSTem:ERRor? query when there are no errors.
+101
Calibration state is off
Calibration is not enabled. The instrument will not accept calibration commands.
+103
Calibration voltage or current range is incorrect
Calibration voltage and current ranges are set incorrectly. Calibration cannot be executed.
+104
Bad sequence of calibration commands
Calibration commands have not been entered in the proper sequence.
+120
Configuration Multiple slave not allowed
Multiple slaves are not allowed in the configuration.
+130
Over Temperature Occurred
Over temperature has been detected. Please remove the load or switch off the device.
98
U2722A Programmer’s Reference Guide
Error Messages
10
The following table shows the list of command errors.
Table 14-2 Command errors
Error
Command errors (these errors set the Standard Event Status register bit #5)
–100
Command error
Generic syntax error.
–101
Invalid character
An invalid character was found in the command string. You may have inserted a character such as #, $, or
% in a command keyword or within a parameter.
–102
Syntax error
Invalid syntax was found in the command string. You may have inserted a blank space before or after a
colon in the command header, or before a comma.
–103
Invalid separator
An invalid separator was found in the command string. Check for proper usage of , ; :
–104
Data type error
The wrong parameter type was found in the command string. You may have specified a number where a
string was expected, or vice versa.
–105
GET not allowed
A group execute trigger is not allowed in a command string.
–108
Parameter not allowed
More parameters were received than expected for the command. You may have entered an extra
parameter, or you have added a parameter to a command that does not accept a parameter.
–109
Missing parameter
Fewer parameters were received than expected for the command. You may have omitted one or more
parameters that are required for this command.
–110
Command header error
An error was detected in the header.
–111
Header separator error
A character that was not a valid header separator was found in the command string.
–112
Program mnemonic too long
The header contains more than 12 characters.
U2722A Programmer’s Reference Guide
99
10
Error Messages
Table 14-2 Command errors (continued)
Error
Command errors (these errors set the Standard Event Status register bit #5)
–113
Undefined header
A command was received that is not valid. You may have misspelled the command or it may not be a valid
command. If you are using the short form of the command, remember that it may contain up to four letters.
–114
Header suffix out of range
The value of the numeric suffix is not valid.
–120
Numeric data error
Generic numeric data error.
–121
Invalid character in number
An invalid character was found in the number specified for a parameter value.
Example: *ESE #2
–123
Exponent too large
A numeric parameter was found where its exponent was larger than 32,000.
–124
Too many digits
The mantissa of a numeric parameter contained more than 255 digits, excluding leading zeros.
–128
Numeric data not allowed
A numeric parameter was received but a character string was expected.
–130
Suffix error
Generic suffix error.
–131
Invalid suffix
A suffix was incorrectly specified for a numeric parameter.
–134
Suffix too long
The suffix contains more than 12 characters.
–138
Suffix not allowed
A suffix is not supported for this command.
–140
Character data error
Generic character data error.
100
U2722A Programmer’s Reference Guide
Error Messages
10
Table 14-2 Command errors (continued)
Error
Command errors
–141
Invalid character data
Either the character data element contains an invalid character, or the element is not valid.
–144
Character data too long
The character data element contains more than 12 characters.
–148
Character data not allowed
A discrete parameter was received, but a string or numeric parameter was expected.
–150
String data error
Generic string data error.
–151
Invalid string data
An invalid character string was received. Check that the string is enclosed in quotation marks.
–158
String data not allowed
A character string was received, but is not allowed for this command.
–160
Block data error
Generic block data error.
–161
Invalid block data
The number of data bytes sent does not match the number of bytes specified in the header.
–168
Block data not allowed
Data was sent in arbitrary block format but is not allowed for this command.
–170
Expression error
Generic expression error.
–171
Invalid expression
The expression data element was invalid.
–178
Expression data not allowed
Expression data element was sent but is not allowed for this command.
U2722A Programmer’s Reference Guide
101
10
Error Messages
The execution errors are listed in the table below.
Table 14-3 Execution errors
Error
Execution errors (these errors set the Standard Event Status register bit #4)
–200
Execution error
Generic syntax error.
–210
Trigger error
Generic trigger error.
–211
Trigger ignored
A Group Execute Trigger (GET) was received but the trigger was ignored.
–220
Parameter error
A data element related error occurred.
–221
Settings conflict
A data element could not be executed because of the present instrument state.
–222
Data out of range
A data element could not be executed because the value was outside the valid range.
–223
Too much data
A data element was received that contains more data than the instrument can handle.
–224
Illegal parameter value
An exact value was expected but not received.
–225
Out of memory
The device has insufficient memory to perform the requested operation.
–230
Data corrupt or stale
Possibly an invalid data. A new reading was started but not completed.
–231
Data questionable
The measurement accuracy is in question.
–240
Hardware error
The command could not be executed due to a hardware problem with the instrument.
–241
Hardware missing
The command could not be executed due to missing hardware, such as an option.
102
U2722A Programmer’s Reference Guide
Error Messages
10
Table 14-3 Execution errors (continued)
Errors
Execution errors
–260
Expression error
An expression program data element related error occurred.
–261
Math error in expression
An expression program data element could not be executed due to a math error.
The list of query errors is shown in the following table.
Table 14-4 Query errors
Error
Query errors (these errors set the Standard Event Status register bit #2)
–400
Query error
Generic error query.
–410
Query INTERRUPTED
A condition causing an interrupted query error occurred.
–420
Query UNTERMINATED
A condition causing an unterminated query error occurred.
–430
Query DEADLOCKED
A condition causing a deadlocked query error occurred.
–440
Query UNTERMINATED after indefinite response
A query was received in the same program message after a query indicating an indefinite response was
executed.
U2722A Programmer’s Reference Guide
103
10
104
Error Messages
U2722A Programmer’s Reference Guide
Agilent U2722A USB Modular Source Measure Unit
Programmer’s Reference Guide
15
Default Factory Settings
The default factory settings are listed in this chapter.
Agilent Technologies
105
15
Default Factory Settings
Remarks
• These settings are used when the U2722A modular SMU is powered on.
• They are set once the *RST command is sent to the U2722A.
106
U2722A Programmer’s Reference Guide
www.agilent.com
Contact us
To obtain service, warranty or technical
support assistance, contact us at the following
phone numbers:
United States:
(tel) 800 829 4444 (fax) 800 829 4433
Canada:
(tel) 877 894 4414 (fax) 800 746 4866
China:
(tel) 800 810 0189 (fax) 800 820 2816
Europe:
(tel) 31 20 547 2111
Japan:
(tel) (81) 426 56 7832 (fax) (81) 426 56
7840
Korea:
(tel) (080) 769 0800 (fax) (080) 769 0900
Latin America:
(tel) (305) 269 7500
Taiwan:
(tel) 0800 047 866 (fax) 0800 286 331
Other Asia Pacific Countries:
(tel) (65) 6375 8100 (fax) (65) 6755 0042
Or visit Agilent worlwide web at:
www.agilent.com/find/assist
Product specifications and descriptions in
this document subject to change without notice.
® Agilent Technologies, Inc., 2008
Third Edition, November 28, 2008
U2722-90022
Agilent Technologies
Was this manual useful for you? yes no
Thank you for your participation!

* Your assessment is very important for improving the work of artificial intelligence, which forms the content of this project

Download PDF

advertising