1998 Agilent Technologies 1998, 2000. All rights reserved.
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.
Notice
The material contained in this document is subject to change without
notice. Agilent Technologies makes no warranty of any kind with regard
to this material, including, but not limited to, the implied warranties of
merchantability and fitness for a particular purpose. Agilent
Technologies shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the furnishing,
performance, or use of this material.
Warranty
This Agilent Technologies product has a warranty against defects in
material and workmanship for a period of three years from date of
shipment. During the warranty period, Agilent Technologies will, at its
option, either repair or replace products that prove to be defective. For
warranty service or repair, this product must be returned to a service
facility designated by Agilent Technologies. The Buyer shall pay Agilent
Technologies round-trip travel expenses. For products returned to
Agilent Technologies for warranty service, the Buyer shall prepay
shipping charges to Agilent Technologies and Agilent Technologies shall
pay shipping charges to return the product to the Buyer. However, the
Buyer shall pay all shipping charges, duties and taxes for products
returned to Agilent Technologies from another country.
4
Notice
Agilent Technologies warrants that its software and firmware designated
by Agilent Technologies for use with an instrument will execute its
programming instructions when properly installed on that instrument.
Agilent Technologies does not warrant that the operation of the
instrument software, or firmware, will be uninterrupted or error free.
Limitation of Warranty
The foregoing warranty shall not apply to defects resulting from
improper or inadequate maintenance by the Buyer, Buyer-supplied
software or interfacing, unauthorized modification or misuse, operation
outside of the environmental specifications for the product, or improper
site preparation or maintenance. No other warranty is expressed or
implied. Agilent Technologies specifically disclaims the implied
warranties of merchantability and fitness for a particular purpose.
Exclusive Remedies
The remedies supplied are the Buyer's sole and exclusive remedies.
Agilent Technologies shall not be liable for any direct, indirect, special,
incidental, or consequential damages, whether based on contract, tort or
any other legal theory.
Certification
Agilent Technologies certifies that this product met its published
specifications at the time of shipment. Agilent Technologies further
certifies that its calibration measurements are traceable to the United
States Institute of Standards and Technology, to the extent allowed by
the Institute's calibrating facility, and to the calibration facilities of other
International Standards Organization members.
Services and Support
Any adjustment, maintenance, or repair of this product must be
performed by qualified personnel. Contact your customer engineer
through your local Agilent Technologies Service Center. You can find a
list of local service representatives on the Web at:
http://www.agilent.com/Service/English/index.html
5
Safety Summary
Safety Summary
The following general safety precautions must be observed during all
phases of operation of this instrument. Failure to comply with these
precautions or with specific warnings elsewhere in this manual violates
safety standards of design, manufacture, and intended use of the
instrument. Agilent Technologies Inc. assumes no liability for the
customer's failure to comply with these requirements.
General
This product is a Safety Class 1 instrument (provided with a protective
earth terminal). The protective features of this product may be impaired
if it is used in a manner not specified in the operation instructions.
All Light Emitting Diodes (LEDs) used in this product are Class 1 LEDs
as per IEC 60825-1.
Environmental Conditions
This instrument is intended for indoor use in an installation category II,
pollution degree 2 environment. It is designed to operate at a maximum
relative humidity of 95% and at altitudes of up to 2000 meters. Refer to
the specifications tables for the ac mains voltage requirements and
ambient operating temperature range.
Before Applying Power
Verify that the product is set to match the available line voltage, the
correct fuse is installed, and all safety precautions are taken. Note the
instrument's external markings described under Safety Symbols on
page 8.
6
Safety Summary
Ground the Instrument
To minimize shock hazard, the instrument chassis and cover must be
connected to an electrical protective earth ground. The instrument must
be connected to the ac power mains through a grounded power cable,
with the ground wire firmly connected to an electrical ground (safety
ground) at the power outlet. Any interruption of the protective
(grounding) conductor or disconnection of the protective earth terminal
will cause a potential shock hazard that could result in personal injury.
Fuses
Only fuses with the required rated current, voltage, and specified type
(normal blow, time delay, etc.) should be used. Do not use repaired fuses
or short-circuited fuse holders. To do so could cause a shock or fire
hazard.
Do Not Operate in an Explosive Atmosphere
Do not operate the instrument in the presence of flammable gases or
fumes.
Do Not Remove the Instrument Cover
Operating personnel must not remove instrument covers. Component
replacement and internal adjustments must be made only by qualified
service personnel.
Instruments that appear damaged or defective should be made
inoperative and secured against unintended operation until they can be
repaired by qualified service personnel.
7
Safety Summary
Safety Symbols
Caution (refer to accompanying documents)
Protective earth (ground) terminal
In the manuals:
WARNING
CAUTION
The WARNING sign denotes a hazard. It calls attention to a
procedure, practice, or the like, which, if not correctly performed
or adhered to, could result in personal injury. Do not proceed
beyond a WARNING sign until the indicated conditions are fully
understood and met.
The CAUTION sign denotes a hazard. It calls attention to an operating
procedure, or the like, which, if not correctly performed or adhered to,
could result in damage to or destruction of part or all of the product. Do
not proceed beyond a CAUTION sign until the indicated conditions are
fully understood and met.
8
About this Book
About this Book
This guide provides reference information primarily for programming the
Agilent 81130A via remote control.
Chapter 1 General Programming Aspects on page 13 gives general
hints for programming instruments like the Agilent 81130A using SCPI
commands.
Chapter 2 Programming Reference on page 25 provides detailed
information on the SCPI commands supported by the instrument.
Chapter 3 Specifications on page 95 lists the instruments technical
specifications and provides exact definitions for the instruments
parameters.
For an introduction and information on the Agilent 81130As user
interface, please refer to the Quick Start Guide, p/n 81130-91020.
9
About this Book
Conventions Used in this Book
This book uses certain conventions to indicate elements of the
Agilent 81130As user interface. The following table shows some
examples:
SoftkeysPress the MODE/TRG softkey to access the Mode/
Trigger screen.
HardkeysPress the MORE key to switch to the alternative
softkey layout.
Alternate KeysPress SHIFT + 0 (ON/OFF1) to switch on output1.
The alternate key labelwhich is selected by
pressing the SHIFT keyis given in parentheses.
Screen QuotesMove the entry focus down to P
turn the knob to select
INTERNAL
ULSE-PERIOD
PLL.
and
Entry FocusThe highlight field, that can be moved with the
cursor keys, to change modes, parameters, or
parameter formats.
:VOLTage:HIGH 3V
Full command for programming a 3 V high level.
The upper case letters represent the short form
of the command, which results in faster programming times.
*RST
Common IEEE 488 command, to reset instrument to default status.
This chapter provides general information on writing GP-IB/SCPI
programs for instruments like the Agilent 81130A.
Detailed information on programming the Agilent 81130A can be found in
Chapter 2 Programming Reference on page 25.
13
General Programming Aspects
The GP-IB Interface Bus
The GP-IB Interface Bus
The GP Interface Bus is the interface used for communication between a
controller and an external device, such as the Agilent 81130A. The GP-IB
conforms to IEEE standard 488-1987, ANSI standard MC 1.1, and IEC
recommendation 625-1.
If you are not familiar with the GP-IB, please refer to the following
books:
The Institute of Electrical and Electronic Engineers: IEEE Standard
488.1-1987, IEEE Standard Digital Interface for Programmable Instrumentation.
The Institute of Electrical and Electronic Engineers: IEEE Standard
488.2-1987, IEEE Standard Codes, Formats, and Common
Commands for Use with IEEE Standard 488.1-1987.
14
General Programming Aspects
Agilent 81130A Remote Control
Agilent 81130A Remote Control
GP-IB Address
Modes of
Operation
You can only set the GP-IB address from the front panel of the instrument
(refer to the Quick Start Guide).
The default GP-IB address is 10.
The Agilent 81130A has two modes of operation:
Local
The instrument is operated using the front panel keys.
Remote
After receiving the first command or query via the GP-IB, the
instrument is put into remote state. The front panel is locked.
To return to local operating mode, press SHIFT (LOCAL).
15
General Programming Aspects
Programming Recommendations
Programming Recommendations
Here are some recommendations for programming the instrument:
Start programming from the default setting. The common command
for setting the default setting is:
*RST
Switch off the automatic update of the display to increase the
programming speed. The device command for switching off the
display is:
:DISPlay OFF
The SCPI standard defines a long and a short form of the commands.
For fast programming speed it is recommended to use the short
forms. The short forms of the commands are represented by upper
case letters. For example the short form of the command to set 100 ns
delay is:
:PULS:DEL 100NS
To improve programming speed it is also allowed to skip optional
subsystem command parts. Optional subsystem command parts are
depicted in square brackets, e.g.: set amplitude voltage of output 1:
For the commands to set the timing and level parameters, except of
period/frequency, you can explicitly specify the output to be
programmed (for compatibility reasons). If there is no output
specified, the commands will set the default output 1.
So, for setting a high level of 3 Volts for output 1 the commands are:
:VOLT:HIGH 3V# sets high level of 3 V at out 1
:VOLT1:HIGH 3V# sets high level of 3 V at out 1
16
:VOLT 1.2V
.
General Programming Aspects
Programming Recommendations
It is recommended to test a new setting that will be programmed on
the instrument by setting it up manually.
Enable the outputs so that the instruments error check system is on
and possible parameter conflicts are immediately displayed.
When you have found the correct setting, then use this to create the
program. In the program it is recommended to send the command for
enabling outputs (for example, :
Selftest of the instrument can be invoked by the common command
*TST
If it is important to know whether the last command is completed,
then send the common command
*OPC?
OUTPut ON
) as the last command.
17
General Programming Aspects
Common Command Summary
Common Command Summary
This table summarizes the IEEE 488.2 common commands supported by
the Agilent 81130A:
CommandParameter Description
*CLSClear the status structure
*ESE <0255>Set the Standard Event Status register mask
*ESE?Read the state of the Standard Event Status enable register
*ESR?Read the state of the Standard Event Status event register
*IDN?Read the Instrument's Identification string
*LRN?Read the complete Instrument Setting
*OPCSet the Operation Complete bit when all pending actions
are complete
*OPC?Read the status of the Operation Complete bit
*OPT?Read the installed options
*RCL <04>Recall a complete Instrument Setting from memory
*RSTReset the instrument to standard settings
*SAV<14>Save the complete Instrument Setting to memory
*SRE <0255>Set the Service Request Enable Mask
*SRE?Read the Service Request Enable Mask
*STB?Read the Status Byte
*TRGTrigger
*TST?Execute instruments selftest
*WAI Wait until all pending actions are complete
18
Status Model
QUESTIONABLE STATUS
Voltage Warning
Current Warning
Timin g Warni ng
Frequency Warning
Pattern Warning
Operatio n Complete
Query Error
Device Dependent Error
Execution Error
Command Error
Power On
0
1
2
3
4
5
6
7
8
9
15
OPERation Status
(NOT USED)
0
1
2
3
4
5
6
7
8
9
15
Standard Event Status
0
1
2
3
4
5
6
7
MAV
SRQ
Status
Byte
0
1
2
3
4
5
6
7
General Programming Aspects
Status Model
The instrument has a status reporting system conforming to IEEE 488.2
and SCPI. The above figure shows the status groups available in the
instrument.
Each status group is made up of component registers, as shown in the
following figure.
19
General Programming Aspects
Status Model
Condition
Register
Hardware
and Firmware
condition
Transition
Filters
1
0
PTR NTR
1
0
Event
Register
Latched
Enable
Register
OR
Summary Bit
Condition Register
A condition register contains the current status of the hardware and
firmware. It is continuously updated and is not latched or buffered. You
can only read condition registers. If there is no command to read the
condition register of a particular status group, then it is simply invisible
to you.
Transition Filters
Transition filters are used to detect changes of state in the condition
register and set the corresponding bit in the event register. You can set
transition filter bits to detect positive transitions (PTR), negative
transitions (NTR) or both. Transition filters are therefore read/write
registers. They are unaffected by *CLS.
Event Register
An event register latches transition events from the condition register as
specified by the transition filters or records status events. Querying
(reading) the event register clears it, as does the *CLS command. There is
no buffering, so while a bit is set, subsequent transition events are not
recorded. Event registers are read only.
20
General Programming Aspects
Status Model
Enable Register
The enable register defines which bits in an event register are included in
the logical OR into the summary bit. The enable register is logically
ANDed with the event register and the resulting bits ORed into the
summary bit. Enable registers are read/write, and are not affected by
*CLS
or querying.
Although all status groups have all of these registers, not all status
groups actually use all of the registers. The following table summarizes
the registers used in the instrument status groups.
Registers in Group
Status Group
QUEStionable
OPERation1
Standard Event Status
Status Byte
1 Present, but not used. COND and EVEN always 0.
*ESR?
2 Use
3 Use
4 Use
5 Use
*ESE
*STB?
*SRE
to query.
to set,
to query
to set,
CONDitionNTRPTREVENtENABLe
√√√√√
xxxxx
xxx
xxx
*ESE?
to query
*SRE?
to query
2
√
4
√
3
√
5
√
21
General Programming Aspects
Status Model
Status Byte
The status byte summarizes the information from all other status groups.
The summary bit for the status byte actually appears in bit 6 (RQS) of the
status byte. When RQS is set it generates an SRQ interrupt to the
controller indicating that at least one instrument on the bus requires
attention. You can read the status byte using a serial poll or *STB?
Bit Description
0 Unused, always 0
1 Unused, always 0
2Unused, always 0
3 QUESTionable Status Summary Bit
4 MAVMessage AVailable in output buffer
5 Standard Event Status summary bit
6RQS; ReQuest Service
7 OPERation Status summary Bit, unused
Standard Event Status Group
BitDescription
0Operation Complete, set by *OPC
1Unused, always 0
2Query Error
3Device Dependent Error
4Execution Error
5Command Error
6Unused, always 0
7Power On
22
General Programming Aspects
OPERation Status Group
This Status Group is not used in the instrument.
BitDescription
0Unused, always 0
1Unused, always 0
2Unused, always 0
3Unused, always 0
4Unused, always 0
5 Unused, always 0
6 Unused, always 0
7Unused, always 0
8Unused, always 0
9Unused, always 0
Status Model
10Unused, always 0
11Unused, always 0
12Unused, always 0
13Unused, always 0
14Unused, always 0
15Always 0
23
General Programming Aspects
Status Model
QUEStionable Status Group
BitQUEStionable
0Voltage warning
1Current warning
2Time warning
3Unused, always 0
4 Unused, always 0
5Frequency warning
6Unused, always 0
7 Unused, always 0
8Unused, always 0
9Pattern warning
10Unused, always 0
11Unused, always 0
12Unused, always
13Unused, always 0
14Unused, always 0
15Always 0
The QUEStionable Status group is used to report warning conditions
amongst the voltage, current, pulse timing, frequency and pattern
parameters. Warnings occur when a parameter, although not outside its
maximum limits, could be causing an invalid signal at the output because
of the actual settings and uncertainties of related parameters.
24
2
2Programming Reference
This chapter provides reference information on the following topics:
Agilent 81130A SCPI Command Summary on page 26
Default Values, Standard Settings on page 34
Programming the Instrument Trigger Modes on page 38
SCPI Instrument Command List on page 42
For general programming information, please refer to Chapter 1
General Programming Aspects on page 13.
25
Programming Reference
Agilent 81130A SCPI Command Summary
Agilent 81130A SCPI Command
Summary
CommandParameterDescriptionsee page
:ARM
[:SEQuence[1] | :STARt]
[:LAYer[1]]
:LEVel
[:THReshold]
:TERMination
:MODE
:SENSe
:SOURce
:INITiate
:CONTinuous
:CHANnel
:MATH
(Trigger mode and source)
<value>Set/read threshold level at EXT INPUT
<value>Set/read the termination voltage at EXT IN-
GATed | STARtedSet/read the trigger mode, if the source is
POSitive | NEGativeSet/read trigger on edge or gate on level
EXT1| IMM | MANSet/read trigger source
ON | OFF | 1 | 0Starts or stops the instrument, if the arming
OFF|DIGitalSet/read addition of channels of channels 1
PUT
IMMediate
not
(EXT INPUT| IMMediate | MAN key)
source is
& 2 at output 1
IMMediate
not
43
43
43
44
44
45
45
26
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
:DIGital
[:STIMulus]
:PATTern
:LOOP
:INFinite
[:STATe]
:STARt
[:LEVel[1]]
[:COUNt]
:STARt
:LENGth
:PRBS
:SEGMent[1|2|3|4]
:DATA[1|2]
:LENGth
:PRESet[1|2]
:TYPE[1|2]
[:STATe]
:UPDate
:SIGNal[1|2]
:FORMat
ON | OFF | 1 | 0Enables/Disables the infinite loop
SEGM1 | SEGM2 |
SEGM3 | SEGM4
<value>Set/read the segment loop count
SEGM1 | SEGM2 |
SEGM3 | SEGM4
1 | 2 | 3 | 4Set/read the number of segments within the
<base>Set/read the PRBS base (the same for all
<data>Set/read pattern data
<segment-length>Set/read the length of the segment (if the
[<n>,]<length>Set preset pattern with frequency CLOCK÷ n
DATA|
PRBS|HIGH|LOW
OFF|ON|0|1Switch PATTERN pulse-mode on or off
OFF|ON|ONCEUpdate the hardware with pattern data
RZ | R1 | NRZSet/read data format of output channel
Set/read the start of the infinite loop (the
segment to restart the output after the last
bit of the last used segment)
Set/read the start segment for the counted
segment loop
segment loop
PRBS segments!)
length is increased, 0 bits are appended)
Set/read the type of the segment
48
45
46
47
47
48
48
49
52
53
53
54
54
27
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
:DISPlay
[:WINDow]
[:STATe]
:MMEMory
:CATalog?
:CDIRectory
:COPY
:DELete
:INITialize
:LOAD
:STATe
:STORe
:STATe
:OUTPut[1|2]
[:NORMal]
[:STATe]
:COMPlement
[:STATe]
ON|OFF|1|0Set/read frontpanel display state
[A:]Read directory of memory card
[<name>]Change directory on memory card
<source>[,A:],<dest>
[,A: ]
<name>[,A:]Delete a file from memory card
[A:[DOS]]Initialize memory card to DOS format
<n>,<name>Load file from memory card to memory n
<n>,<name>Store memory n to memory card
OFF|ON|1|0Set/read normal output state
OFF|ON|1|0Set/read complement output state
Copy a file on memory card
55
56
56
57
57
58
58
58
59
59
28
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
[:SOURce]
:CORRection[1|2]
:EDELay
[:TIMe]
:CURRent[1|2]
[:LEVel]
[:IMMediate]
[:AMPLitude]
:OFFSet
:HIGH
:LOW
:LIMit
:HIGH
:LOW
:STATe
:FREQency
[:CW]
[:FIXed]
:AUTO
:HOLD[1|2]
<value>Set/read channel delay deskew
The CURRent and VOLTage subsystem cannot be used at the same time. Use the :HOLD
command to select between them.
<value>Set/read channel amplitude current
<value>Set/read channel offset current
<value>Set/read channel high-level current
<value>Set/read channel low-level current
<value>Set/read maximum current limits
<value>Set/read minimum current limits
ON|OFF|1|0Enable/Disable the current limits
<value>Set/read frequency of pulses
ONCEDo a frequency measurement at CLK IN
VOLT|CURRSwitch between VOLTage and CURRent
command subtrees
60
60
61
62
63
63
64
64
65
66
66
29
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
[:SOURce]
:PHASe[1|2]
[:ADJust]
:PULSe
:DCYCle[1|2]
:DELay[1|2]
:HOLD
:UNIT
:HOLD[1|2]
:PERiod
:AUTO
:TDelay[1|2]
:TRANsition[1|2]
:UNIT
[:LEADing]
:TRAiling
:TRIGger[1]
:MODE
:POSition
:VOLTage
[:LEVel]
[:IMMediate]
:WIDTh[1|2]
<value>
<value>Set/read channel phase
<value>Set/read channel dutycycle
<value>Set/read channel delay (to leading edge)
TIME|PRATioHold absolute delay|delay as period fixed
S|SEC|PCT|DEG|
RAD
WIDTh | DCYCle |
TDELay
<value>Set/read pulse period
ONCEMeasure pulse period at CLK IN
<value>Set/read trailing edge delay
S|SEC|PCTSet/read transition-time units
<value>Set/read leading-edge transition
<value>Set/read trailing-edge transition
CONTinuous | STARtSet/read the mode of the trigger output sig-
1 | 2 | 3 | 4Set/read the trigger output signal position
TTL | PECL | SYM |
ECLGND | ECLN2V
<value>Set/read channel pulse-width
with varying frequency
Set/read delay units
Hold Width|Dutycycle|Trailing edge delay
fixed with varying frequency
nal generation (ignored if not in pattern
mode)
Set/read TRIGGER OUTput levels
67
67
68
69
70
70
70
71
72
72
72
73
74
74
74
75
30
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
[:SOURce]
:ROSCillator
:SOURce
:EXTernal
:FREQuency
:VOLTage[1|2]
[:LEVel]
[:IMMediate]
[:AMPLitude]
:OFFSet
:HIGH
:LOW
:LIMit
[:HIGH]
:LOW
:STATe
INTernal|EXTernalSet/read PLL reference source
<value>Set/read frequency of external PLL
reference. Value will be rounded to 1 MHz,
2MHz, 5MHz or 10MHz.
<value>Set/read channel amplitude voltage
<value>Set/read channel offset voltage
<value>Set/read channel high-level voltage
<value>Set/read channel low-level voltage
<value>Set/read maximum voltage limit
<value>Set/read minimum voltage limit
ON|OFF|1|0Enable|Disable the voltage limits
76
76
77
77
78
79
80
80
81
31
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
:STATus
:OPERation
[:EVENt]?
:CONDition
:ENABle
:NTRansition
:PTRansition
:PRESet
:QUEStionable
[:EVENt]?
:CONDition?
:ENABle
:NTRansition
:PTRansition
Read Operation event register
Read Operation condition register
NumericSet/Read Operation enable register
NumericSet/Read Operation negative-transition
register
NumericSet/Read positive-transition register
Clear and preset status groups
Read Questionable event register
Read Questionable condition register
NumericSet/Read Questionable enable register
NumericSet/Read Questionable negative-transition
register
NumericSet/Read Questionable positive-transition
register
81
81
81
81
81
81
82
82
82
82
82
82
32
Programming Reference
Agilent 81130A SCPI Command Summary
CommandParameterDescriptionsee page
:SYSTem
:ERRor?
:KEY
:PRESet
:SECurity
[:STATe]
:SET
:VERSion?
:WARNing
[:COUNt]?
:STRing?
:BUFFer?
NumericSimulate key press or read last key pressed
ON|OFFSwitch security on and off
Block dataSet/read complete instrument setting
Read error queue
no function
Read SCPI compliance setting
Read number of active warnings
Read active warnings as concatenated string
Read maximum possible length of
concatenated string
84
84
87
87
88
88
88
89
89
:TRIGger
[:SEQuence [1]] | :STARt]
:COUNt
:PULSes[1|2]
:LEVel
:TERMination
:SOURce
(Pulse mode and period source)
<value>Set/read number of triggered periods to be
generated per ARM event (BURST period)
<value>Set/red the number of pulses within the trig-
gered periods at OUTput 1 or OUTput 2
<value>Set/read termination voltage level at CLK IN
:PULSe:DCYCle10.0% (derived from Width and Period)
:DELay0.00
:HOLDTIME
:UNITSEC
:HOLDWIDTh
:PERiod1
:AUTOnot applicable
:TDELay100 ns
:TRANsition:HOLDTIME
:UNITSEC
20 mA (50
0.0
+10 mA (50
10 mA (50
µ
Ω
into 50Ω)
µ
A (50Ω into 50Ω)
Ω
into 50Ω)
Ω
into 50Ω)
s
35
Programming Reference
Default Values, Standard Settings
Parameter*RST, Default Values
[:LEADING]0.8 ns (Agilent 81131A) or not applicable
:TRAiling0.8 ns (Agilent 81131A) or not applicable
:TRAiling:AUTOON
:TRIGger::MODESTARt
:POSition1
:VOLTageTTL
:WIDTh100 ns
:ROSCillator:SOURceINT
:EXTernal:FREQuency5 MHz
:VOLTage1.00 V
:OFFSet0.0 mV
:HIGH500 mV
:LOW500 mV
:LIMit[HIGH]+500 mV
:LOW500 mV
:STATeOFF
:STATus:OPERationnot applicable
:PRESetnot applicable
:QUESTionableON
:SYSTem:ERRor?not applicable
:KEYnot applicable
:PRESetnot applicable
:SECurityOFF
:SETnot applicable
:VERSion?1992.0
:WARN?[:COUNt]not applicable
:STRing?not applicable
:BUFFer?not applicable
36
Programming Reference
Default Values, Standard Settings
Parameter*RST, Default Values
:TRIGger:COUNt1
:PULSes2
:LEVel:TERMination0.0 V
:SOURceINT
37
Programming Reference
Programming the Instrument Trigger Modes
Programming the Instrument
Trigge r M odes
The following figure shows the instruments arming/triggering model:
*RST or power on
Trigger system
(1)
initiated
(still) initiated
ARM conditions
(1)
satisfied
For details of the
trigger count
command, refer to
“:TRIG:COUN” on
page 89.
Idle
loops
(1)
(2)
or
Notes:
(1) The instrument is always initiated in CONTINUOUS modes.
The instrument is automatically initiated in MANual started/gated modes.
(2) 1 in Pulses Mode (same as :TRIGger:COUNt)
:TRIGger:COUNt in Continuous/Gated Mode
Maximum of :TRIGger:COUNt:PULSes1 and :TRIGger:COUNt:PULSes2
in Started Burst mode
Depends on sequence in Pattern Mode (may be infinite)
no longer initiated
Initiated
wait for Arm
completed # of Trigger
no longer initiated
wait for Trigger
Trigger conditions
satisfied
You program the comprehensive triggering capabilities of the instrument
using the SCPI :ARM and :TRIGger subsystems. Using these two
command subsystems you can program the operating modes of the
instrument which are set up using the M
ODE/TRG
screen on the
frontpanel.
Use the :ARM subsystem to select the overall triggering mode of the
instrument (
CONTINUOUS, STARTED, GATED
, and the
)
:TRIGger
subsystem to select the pulse period source, triggering and number of
pulse periods per
:ARM
event (
BURST
length). In pattern mode the
pattern length is the sum of each used segments length.
38
Programming Reference
Programming the Instrument Trigger Modes
Continuous
Set Continuous mode by arming the instrument from its internal PLL:
:ARM:SOURce IMMediateArm from internal PLL
Started
Set Started mode by arming the instrument on low to high level transition
from the EXT INPUT:
:ARM:SOURce EXTernal1Arm from EXT INPUT
:ARM:MODE STARtedStart on the arm event
:ARM:SENSe POSitiveArm on positive (high) level
:ARM:LEVel:THReshold 1VSet EXT INPUT threshold
Gated
Set Gated mode by arming the instrument on levels from the EXT INPUT:
:ARM:SOURce EXTernal1Arm from EXT INPUT
:ARM:MODE GATed Select gated mode
:ARM:SENSe POSitiveArm on positive level
Pulses
Set Pulses mode by setting the
triggered pulse period is generated for every :ARM event. The trigger
source sets the pulse period:
:TRIGger:COUNt 1Single pulse period per arm event
:TRIGger:SOURce INTernal 1 Pulse period from internal PLL
:DIGital:PATTern OFFDisable pattern data.
Pulse period source:TRIGger SOURce
internal PLL
CLK-IN
:TRIGger:COUNt
INTernal[1] or IMMediate
EXTernal2
to 1 so that a single
39
Programming Reference
Programming the Instrument Trigger Modes
Burst
Set Burst mode by setting the
:TRIGger:COUNt
to the burst count
required. The trigger source sets the pulse period for the pulses within
the burst (See table in Pulses on page 39).
:TRIGger:COUNt 16Burst of 16 pulse periods
:TRIGger:SOURce INTernal1Pulse period from internal PLL.
:DIGital:PATTern OFFDisable pattern data
#Jump back to start of segment 1 after the last bit of the last
segment (here: segment 1)
:DIGital[:STIMulus]:PATTern:LOOP:INFinite[:STATe] ON
:DIGital[:STIMulus]:PATTern:LOOP:INFinite:STARt SEGM1
to the
:TRIGger:SOURce INTernal1Pulse period from internal PLL
:DIGital:PATTern ONEnable pattern data
:DIGital:SIGNal1:FORMat NRZSet OUTPUT 1 data to NRZ
:ARM:MODE STARted
:ARM:SOURce EXT1Switch to started by EXT1
40
Programming Reference
Programming the Instrument Trigger Modes
Manually Starting and Gating
When starting and gating with the MAN key use the following commands:
STARTED *TRG or :INITiate:CONTinuous ON to start the instrument
:INITiate:CONTinuous OFF to stop the instrument
GATED :INITiate:CONTinuous ON to 'open the gate'
:INITiate:CONTinuous OFF to 'close the gate'
*TRG to gate for approx. 10ms
41
Programming Reference
SCPI Instrument Command List
SCPI Instrument Command List
The following reference sections list the instrument commands in
alphabetical order. In addition to a command description, the attributes
of each command are described under the following headings. Not all of
these attributes are applicable to all commands. The commands are
conform to the IEEE 488.2 SCPI standard.
Command
Long
Form
Shows the short form of the command.
Shows the long form of the command.
Most commands can be used in different forms:
SetThe command can be used to program the instrument
QueryThe command can be used to interrogate the instrument. Add a ? to
Event The command performs a one-off action.
the command if necessary.
Parameter
Parameter Suffix
Functional
Coupling
Value Coupling
Range Coupling
*RST value
Specified Limits
Absolute Limits
Example
The type of parameter, if any, accepted by the command. The minimum
and maximum value of numeric parameters can be accessed by the
option MINimum or MAXimum.
The suffixes that may follow the parameter.
Any other commands that are implicitly executed by the command.
Any other parameter that is also changed by the command.
Any other parameters whose valid ranges may be changed by the
command.
The value/state following a *RST command.
The specified limits of a parameter.
Some parameters can be programmed beyond their specified limits.
Use this command to set up a counted loop across one or more
segments.
If nested loops are used, the counted loop must be embedded into the
infinite loop completely.
To set up an infinite loop over segment 2 to segment 4 and a counted loop
across segment 2 and segment 3:
:ARM:SOUR EXT1
:ARM:MODE STAR
:ARM:SENS POS
:DIG:PATT:LOOP:INF:STAR SEGM2
:DIG:PATT:LOOP 100
:DIG:PATT:LOOP:STAR SEGM2
:DIG:PATT:LOOP:LENG 2
:DIG:PATT ON
Set arming source to EXT-IN
Set arming mode to started
Arm on positive level
Set jump destination to segment 2
Set number of repetitions of
segment2 and segment 3
Set start of counted loop
Set length of counted loop
Switch on PATTERN mode
:DIG:PATT:LOOP:INF
:DIGital[:STIMulus]:PATTern:LOOP:INFinite[:STATe]
Set & Query
ON | OFF | 1 | 0
ON
Use this command to set up an infinite loop from the last used segment
to the destination segment.
The infinite loop is ignored, if
:ARM:SOURce
IMMediate
is
(CONTINUOUS mode), since in continuous mode there has to be a jump
back to the start of the pattern (always from segment 4 to segment 1).
To setup an infinite loop over segment 2 to segment 4:
:ARM:SOUR EXT1
:ARM:MODE STAR
:ARM:SENS POS
:DIG:PATT:LOOP:INF ON
:DIG:PATT:LOOP:INF:STAR SEGM2
:DIG:PATT:LOOP 1
:DIG:PATT ON
Set arming source to EXT-IN
Set arming mode to started
Arm on positive level
Enable infinite loop
Set jump destination to segment 2
Disable counted loop
Switch on PATTERN mode
46
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Example
:DIG:PATT:LOOP:INF:STAR
:DIGital[:STIMulus]:PATTern:LOOP:INFinite:STARt
Set & Query
SEGM1 | SEGM2 | SEGM3 | SEGM4 | 1 | 2 | 3 | 4
SEGM1
Use this command to set up the destination segment.
The infinite loop is ignored, if :ARM:SOURce is IMMediate
(CONTINUOUS mode), since in continuous mode there has to be a jump
back to the start of the pattern (always from segment 4 to segment 1).
Use this command to set the first segment within a counted loop. The
start of the counted loop must be within the infinite loop (if used).
To set up an infinite loop over segment 2 to segment 4 and a counted loop
across segment 2 and segment 3:
:ARM:SOUR EXT1
:ARM:MODE STAR
:ARM:SENS POS
:DIG:PATT:LOOP:INF ON
:DIG:PATT:LOOP:INF:STAR SEGM2
:DIG:PATT:LOOP 100
:DIG:PATT:LOOP:STAR SEGM2
:DIG:PATT:LOOP:LENG 2
:DIG:PATT ON
Set arming source to EXT-IN
Set arming mode to started
Arm on positive level
Switch on infinite loop
Set jump destination to segment 2
Set number of repetitions of
segment2 and segment 3
Set start of counted loop
Set length of counted loop
Switch on PATTERN mode
Set continuous mode
Set segment 1 pattern length (last
bit) to 1023
Set segment 2 to be ignored
Set segment 3 to be ignored
Set segment 4 to be ignored
Set type of segment 1 on channel 1
to PRBS
Disable segment looping
Set PRBS base to 10
Switch on PATTERN mode
Segment 2 to Segment 4 set to all bits set to zero.
49
Programming Reference
SCPI Instrument Command List
Description
NOTE
Use this command to set or read a segments data of one or all channels
starting from Bit 1. The <data> is an arbitrary block of program data as
defined in IEEE 488.2 7.7.6.2, for example:
#1511213
#
1
5
11213
#2161000100010001000
#
2
16
10...00
#011213
#
0
11213
The data length meets the same restrictions, than the segment length
(see page 52).
Start of block
Length of the length of the data
Length of the data
5 bytes of data
Start of block
Length of the length of the data
Length of the data
16 bytes of data
Start of block
Replaces the data block length specification. Length is
calculated automatically.
5 bytes of data
Example
:DIG:PATT:SEGM1:DATA #1511213
50
Programming Reference
SCPI Instrument Command List
The instrument uses each byte of data set one Bit in the pattern memory.
If you dont specify a particular channel, the lowest two bits of each byte
are used to set all three channels, and the top six bits are ignored. Note
that you can therefore use the ASCII characters 0,1,2 and 3, to
program Outputs 1 and 2 in binary:
DATACH2
OUTPUT2
ASCII
0
1
2
3
ignoredused
D7 D6 D5 D4 D3 D2D1 D0
0 0 1 1 0 0
0 0 1 1 0 0
0 0 1 1 0 0
0 0 1 1 0 0
0 0
0 1
1 0
1 1
0
0
1
1
CH1
OUTPUT1
0
1
0
1
:DIG:PATT:SEGM1:DATA2 #1501011
If you specify a particular channel, the least significant bit of each byte is
used to set the selected channel, and the top seven bits are ignored. Note
that you can therefore use the ASCII characters 1 and 0 to set
individual bits to 1 and 0:
DATACH2
ASCII
0
1
ignored
D7 D6 D5 D4 D3 D2 D1D0
0 0 1 1 0 0 0
0 0 1 1 0 0 0
OUTPUT2
LSB
0
1
0
1
CH1
OUTPUT1
remains unchanged
remains unchange
d
Example
:ARM:SOUR IMM
:DIG:PATT:SEGM1:DATA1 #1501011
:DIG:PATT:SEGM1:LENG 5
:DIG:PATT ON
Set continuous mode
Set up pattern data for channel 1
Set pattern length (last bit) to 5
Switch on PATTERN mode
Use this command to set the type of the segment for one channel.
If the segment type of one channel is set to PRBS the other channel may
not be set to DATA.
If at least one channel uses PRBS, then the segment type combination
used in this segment has to be used in every segment that shall generate a
PRBS.
:DIG:PATT:UPD
:DIGital[:STIMulus]:PATTern:UPDate
Set & query
ON | OFF | ONCE
ON
Use this command to enable and disable the automatic updating of the
pattern generating hardware following a
:DIG:PATT:SEGM[1|2|3|4]:DATA
command. Disable the automatic
updating if you want to set up new pattern data in the instrument without
affecting the pattern which is currently being generated. You can then
update the hardware with the new pattern data by sending a
:DIG:PATT:UPD ONCE
command.
Command
Long
Format
Parameter
Range Coupling
*RST value
:DIG:SIGN[1|2]:FORM
:DIGital[:STIMulus]:SIGNal[1|2]:FORMat
Set & Query
RZ | NRZ | R1
Period, Frequency
RZ
54
Programming Reference
SCPI Instrument Command List
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Use this command to set and read the data format of channels 1 and 2
when using PATTERN mode. If you dont specify a channel number in the
command, channel 1 is assumed.
RZReturn to Zero. An RZ pulse is generated for each 1 in
the data. You can vary the width, edges and levels of the
pulse.
R1Return to One. An R1 pulse is generated for each 0 in
the data. You can vary the width, edges and levels of the
pulse.
NRZNon Return to Zero. A pulse of 100% dutycycle is
generated for each 1 in the data. You can vary the
edges and levels of the pulse.
:DIG:SIGN:FORM NRZ
Set channel 1 data format to NRZ
:DISP
:DISPlay[:WINDow][:STATe]
Set & Query
ON | OFF | 1 | 0
ON
This command is used to turn the frontpanel display on and off.
Switching off the display improves the programming speed of the
instrument.
NOTE
Example
*RST switches the display back on.
DISP OFF
Switch off the frontpanel display
55
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
NOTE
:MMEM:CAT?
:MMEMory:CATalog?
Query
["A:"]
Not applicable
Use this command to get a listing of the contents of the currently
selected directory on the memory card. As there is only one memory card
slot, the parameter A: is optional. The information returned is:
<
BYTES_USED
>,<
BYTES_FREE
>{,<
FILE_ENTRY
>}
<bytes_used> The total number of bytes used on the memory card.
<bytes_free>The total number of bytes still available on the memory
card.
<file_entry>String containing the name, type and size of one file:
"<
FILE_NAME
>,<
FILE_TYPE
>,<
FILE_SIZE
>"
The <file_type> is always blank. A directory name has <file_size> = 0
Command
Long
Form
Parameter
*RST value
Description
:MMEM:CDIR
:MMEMory:CDIRectory
Event
["directory_name"]
Not applicable
Use this command to change the current directory on the memory card.
If you dont specify a directory name parameter, the root directory is
selected.
56
Programming Reference
SCPI Instrument Command List
NOTE
Examples
Command
Long
Form
Parameter
*RST value
Description
Examples
Note that you cannot use DOS pathnames as directory names, you can
only select a directory name within the current directory.
Use the directory name ".." to move back to the parent directory of the
current directory, unless you are already in the root directory "\".
Use this command to copy an existing file filename in the current
directory to a new file copyname. If copyname is the name of a subdirectory in the current directory, a copy of the file filename is made in
the sub-directory. Use ".." as copyname to copy a file into the parent
directory of the current directory.
Load FREQPERF into memory 1
Load AMPTEST as current setting
Save current setting in memory 2
Store memory 2 to file SETTING2
Recall memory 3 as current setting
:OUTP[1|2]
:OUTPut[1|2][:NORMal][:STATe]
Set & Query
ON | OFF | 1 | 0
OFF
Use this command to switch the normal OUTPUTs on or off.
:OUTP1 ON
:OUTP2 OFF
Switch on OUTPUT 1
Switch off OUTPUT 2
Command
Long
Form
Parameter
*RST value
Description
Example
:OUTP[1|2]:COMP
:OUTPut[1|2]:COMPlement[:STATe]
Set & Query
ON | OFF | 1 | 0
OFF
Use this command to switch the complement OUTPUTs on or off.
:OUTP1:COMP ON
:OUTP2:COMP OFF
Switch on complement OUTPUT 1
Switch off complement OUTPUT 2
59
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
:CORR[1|2]:EDELay
[:SOURce]:CORRection[1|2]:EDELay[:TIMe]
Set & Query
Numeric
S
with engineering prefixes.
0.0 s
25.0 ns to +25.0 ns
Use this command to program the OUTPUT Deskew delay. This allows
you to deskew the OUTPUTS so that the zero-delay points of both
OUTPUT signals are the same at the device-under-test.
:CORR1:EDEL 0NS
:CORR2:EDEL 5.18NS
Set OUTPUT 1 DESKEW to 0
Set OUTPUT 2 DESKEW to 5.18 ns
3.8 V Outputs (50 Ω into short): max. 152 mA typical
3.0 V Outputs (50 Ω into short): max. 120 mA typical
Value coupling
Range coupling
Amplitude = High – Low
Offset =
High – Low
2
Offset
60
Programming Reference
SCPI Instrument Command List
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Value coupling
This command programs the amplitude current of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of current, you first have to
execute the
[:SOURce]:CURRent
[:SOURce]:HOLD CURRent
subsystem.
command to enable the
The available current range is limited by the specified voltage limits.
:HOLD CURR
:CURR1 75MA
Enable CURRENT subsystem
Set OUTPUT 1 amplitude to 75 mA
:CURR[1|2]:OFFSet
[:SOURce]:CURRent[1|2][:LEVel][:IMMediate]:OFFSet
Set & Query
Numeric
A
with engineering prefixes.
0.0 µA (50 Ω into 50 Ω)
3.8 V Outputs (50 Ω into short): max. 152 mA typical
3.0 V Outputs (50 Ω into short): max. 120 mA typical
Amplitude = High – Low
Offset =
High – Low
2
Range coupling
Description
Example
Amplitude
This command programs the offset current of the OUTPUT signal. Note
that to set the OUTPUT levels in terms of current, you first have to
execute the
[:SOURce]:CURRent
[:SOURce]:HOLD CURRent
subsystem
.
command to enable the
The available current range is limited by the specified voltage limits.
:HOLD CURR
:CURR1:OFF 50MA
Enable CURRENT subsystem
Set OUTPUT 1 offset to 50 mA
61
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Value coupling
Range coupling
Description
Example
:CURR[1|2]:HIGH
[:SOURce]:CURRent[1|2][:LEVel][:IMMediate]:HIGH
Set & Query
Numeric
A
with engineering prefixes.
+10 mA (50 Ω into 50 Ω)
3.8 V Outputs (50 Ω into short): max. 152 mA typical
3.0 V Outputs (50 Ω into short): max. 120 mA typical
Amplitude = High – Low
Offset =
High – Low
2
Low-level
This command programs the High-level current of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of current, you first have to
execute
[:SOURCE]:CURRent
The available current range is limited by the specified voltage limits.
:HOLD CURR
:CURR1:HIGH 150MA
[:SOURCE]:HOLD CURRent
subsystem.
Enable CURRENT subsystem
Set OUTPUT 1 High-level to 150 mA
command to enable the
62
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Value coupling
Range coupling
Description
Example
:CURR[1|2]:LOW
[:SOURce]:CURRent[1|2][:LEVel][:IMMediate]:LOW
Set & Query
Numeric
A
with engineering prefixes.
10 mA (50 Ω into 50 Ω)
3.8V Outputs (50 Ω into short): max. 152 mA typical
3.0V Outputs (50 Ω into short): max. 120 mA typical
Amplitude = High – Low
Offset =
High – Low
2
High-level
This command programs the Low-level current of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of current, you first have to
execute the
[:SOURce]:CURRent
The available current range is limited by the specified voltage limits.
:HOLD CURR
:CURR1:LOW 50 MA
[:SOURce]:HOLD CURRent
subsystem.
Enable CURRENT subsystem
Set OUTPUT 1 Low-level to 50 mA
command to enable the
Command
Long
Form
Parameter
Parameter suffix
*RST value
:CURR[1|2]:LIM
[:SOURce]:CURRent[1|2]:LIMit[:HIGH]
Set & Query
Numeric
A
with engineering prefixes.
+10.0 mA
63
Programming Reference
SCPI Instrument Command List
Description
NOTE
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Description
Use this command to set/read the High-level current limit. If you switch
on current limiting, the High-level current cannot be set above the
programmed limit.
The current is NOT limited by the OUTPUT hardware, this is a software
limit.
:HOLD CURR
:CURR1:LIM 50 MA
:CURR1:LIM:STAT ON
Enable CURRENT subsystem
Set OUTPUT 1 High-level current limit to 50 mA
Switch on OUTPUT 1 limits
:CURR[1|2]:LIM:LOW
[:SOURce]:CURRent[1|2]:LIMit:LOW
Set & Query
Numeric
A
with engineering prefixes.
10.0 mA
Use this command to set/read the Low-level current limit. If you switch
on current limiting, the Low-level current cannot be set below the
programmed limit.
NOTE
Example
Command
Long
Form
Parameter
The current is NOT limited by the OUTPUT hardware, this is a software
limit.
:HOLD CURR
:CURR1:LIM:LOW -50MA
:CURR1:LIM:STAT ON
Enable CURRENT subsystem
Set OUTPUT 1 Low-level current limit to 50mA
Switch on OUTPUT 1 limits
:CURR[1|2]:LIM:STAT
[:SOURce]:CURRent[1|2]:LIMit:STATe
Set & Query
ON | OFF | 1 | 0
64
Programming Reference
SCPI Instrument Command List
*RST value
Description
NOTE
Example
Command
Long
Form
Parameter
Parameter Suffix
*RST value
Specified limits
Value coupling
OFF
This command switches the output limits on or off. When you switch on
the output limits cannot program the output-levels beyond the
programmed limits, until you switch off the output-limits. The limits
apply whether you program High/Low levels or Amplitude/Offset levels.
You can switch the limits on and off in both the
[:SOURce]:CURRent
and the [
:SOURce]:VOLTage
subsystems
but the current and voltage limits are not enabled/ disabled
independently
. The voltage and current limits are always enabled/
disabled together.
:HOLD CURR
:CURR1:LIM 50MA
:CURR1:LIM:LOW -50MA
:CURR1:LIM:STAT ON
:FREQ
[:SOURce]:FREQuency[:CW][:FIXed]
Set & Query
Numeric
Hz
with engineering prefixes, or
1.00 MHz
Agilent 81131A: 1 kHz to 400 MHz
Agilent 81132A: 1 kHz to 660 MHz
Period =
1
Enable CURRENT subsystem
Set OUTPUT 1 High-level current limit to 50 m
Set OUTPUT 1 LOW-level current limit to 50mA
Switch on OUTPUT 1 limits
MHZ
for Megahertz.
Frequency
65
Programming Reference
SCPI Instrument Command List
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Example
Use this command to set/read the pulse frequency. Select the frequency
source for the pulse frequency using
:TRIGg er:S OU Rce
. The currently
selected source is programmed by this command. Note that the specified
limits and available resolution depend on the selected source.
You cannot set the pulse frequency if you have selected the CLK IN
connector as the frequency source (
:TRIG:SOUR INT
:FREQ 75MHz
:TRIG:SOUR EX T
Select internal PLL as pulse trigger
Set pulse frequency to 75 MHz
).
:FREQ:AUTO
[:SOURce]:FREQuency[:CW][:FIXed]:AUTO
Event
ONCE
Not applicable
Use this command to measure the frequency at the CLK IN connector. If
the CLK IN connector is the selected pulse frequency source, you can
then read the measured value with
:TRIG:SOUR EXT2
:FREQ:AUTO ONCE
:FREQ?
:FREQ?
Select ext CLK IN as pulse trigger
Measure frequency at CLK IN
Query pulse frequency
Command
Long
Form
Parameter
*RST value
Description
:HOLD
[:SOURce]:HOLD
Set & Query
VOLTage | CURRent
VOLT
Use this command to enable either of the
[:SOURce]:CURRent
subsystems.
[:SOURce]:VOLTage
or
You can control the signal levels of the instrument OUTPUTs in terms of
voltage or current.
66
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified limits
Value coupling
Functional
coupling
Description
Example
:PHAS[1|2]
[:SOURce]:PHASe[1|2][:ADJust]
Set & Query
Numeric
DEG
or
RAD
. A parameter without a suffix is interpreted as
RAD
.
0.0
0 to 360° constrained by delay and period limits.
Phase
360
Programming the pulse phase also executes
PHASe
Period×
elay =
[:SOURce]:PULSe:HOLD
so that the pulse phase is held constant when the signal frequency
is changed.
Use this command to set/read the relative phase-delay of the output
signal. This is equivalent to setting an absolute or percentage pulse-delay
[:SOURce]:PULSe:DELay
with
.
If you want the phase delay to remain constant when the pulse period is
varied (rather than the absolute pulse delay) use
[:SOURce]:PULSe:DELay[1|2]:HOLD PRATio
:PULS:DEL1 500NS
:PHAS2 180 DEG
:PULS:DEL1:HOLD TIM
:PULS:DEL2:HOLD PRAT
Set OUTPUT 1 delay to 500ns
Set OUTPUT 2 phase to 180
Hold OUTPUT 1 delay constant with varying perio
Hold OUTPUT 2 phase constant with varying period
.
°
d
Command
Long
Form
Parameter
Parameter suffix
*RST value
:PULS:DCYC[1|2]
[:SOURce]:PULSe:DCYCle[1|2]
Set & Query
Numeric
PCT
10.0% (derived from Width and Period)
67
Programming Reference
SCPI Instrument Command List
Specified limits
Value coupling
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified limits
0.1 99.9%, depends on Width & Period.
Width =
Use this command to program the dutycycle of the pulse signal. If you
want to set an absolute pulse-width use
[:SOURce]:PULSe:WIDTh[1|2]
If you want the pulse dutycycle to remain constant when the pulse period
is varied (rather than the absolute pulse width use)
[:SOURce]:PULSe:HOLD[1|2] DCYCle
:PULS:DCYC1 25PCT
:PULS:HOLD1 DCYC
:PULS:DEL[1|2]
[:SOURce]:PULSe:DELay[1|2]
Set & Query
Numeric
S
with engineering prefixes. You can change the default unit using
[:SOURce]:PULSe:DELay[1|2]:UNIT
0.0
0 to 3.00 µs
Duty Cycle
100
×
Period
.
Set OUTPUT 1 dutycycle to 25%
Hold dutycycle constant with varying period
.
Value coupling
Phase =
Delay% =
68
Delay
Period
Delay
Period
×360
×100
Programming Reference
SCPI Instrument Command List
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Use this command to set/read the pulse-delay. Delay is the time between
the start of the pulse period and the start of the leading-edge of the pulse.
If you want the pulse-delay to remain constant when the pulse period is
varied (rather than the phase-delay) use
[:SOURce]:PULSe:DELay[1|2]:HOLD TIME
:PULS:DEL1 500NS
:PHAS2 180 DEG
:PULS:DEL1:HOLD TIME
:PULS:DEL2:HOLD PRAT
Set OUTPUT1 delay to 500 ns
Set OUTPUT 2 phase to 180
Hold OUTPUT 1 delay constant with
varying period
Hold OUTPUT 2 phase constant with
varying period
.
°
:PULS:DEL[1|2]:HOLD
[:SOURce]:PULSe:DELay[1|2]:HOLD
Set & Query
TIME | PRATio
TIME
Use this command to set/read the coupling between the pulse period and
the pulse-delay:
Example
TIMEThe absolute pulse-delay is held fixed when the pulse period is
PRATioThe pulse phase-delay (delay as ratio of period) is held fixed
:PULS:DEL1 500ns
:PHAS2 180DEG
:PULS:DEL1:HOLD TIME
:PULS:DEL2:HOLD PRAT
varied (Pulse phase varies).
when the pulse period is varied. (Pulse-delay varies).
Set OUTPUT 1 delay to 500ns
Set OUTPUT 2 phase to 180°
Hold OUTPUT 1 delay constant with varying period
Hold OUTPUT 2 phase constant with varying period
69
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Example
:PULS:DEL[1|2]:UNIT
[:SOURce]:PULSe:DELay[1|2]:UNIT
Set & Query
S | SEC | PCT | DEG | RAD
SEC
Use this command to set/read the default units for the pulse-delay
parameter. The default unit of a parameter is the unit used when the
parameter is programmed to a value without a unit suffix.
:PULS:DEL1:UNIT PCT
:PULS:DEL1 50
Set OUTPUT 1 delay unit to %
Set OUTPUT 1 delay to 50% of period
:PULS:HOLD[1|2]
[:SOURce]:PULSe:HOLD[1|2]
Set & Query
WIDTh | DCYCle | TDELay
WIDTh
Use this command to set whether the pulse-width, the pulse-dutycycle or
the pulse trailing-edge delay is held constant when the pulse period is
changed.
:PULS:DEL:HOLD1 TIME
:PULS:DEL 20NS
:PULS:HOLD1 DCYC
:PULS:DCYC 25PCT
Hold OUTPUT 1 delay fixed when frequency varies
Set OUTPUT 1 delay to 20ns
Hold OUTPUT 1 Dutycycle fixed when frequency
varies
Set OUTPUT 1 Dutycycle to 25%
Command
Long
Form
Parameter
:PULS:PER
[:SOURce]:PULSe:PERiod
Set & Query
Numeric
70
Parameter Suffix
*RST value
Specified limits
Value coupling
S
with engineering prefixes.
1 µs
Agilent 81131A: 2.5 ns to 1 ms
Agilent 81132A: 1.5 ns to 1 ms
Frequency =
1
Period
Programming Reference
SCPI Instrument Command List
Description
Example
Command
Long
Form
Parameter
*RST value
Description
Example
Use this command to set/read the pulse period. Select the pulse period
source using
:TRIGger:SOURce
. The currently selected source is
programmed by this command. Note that the specified limits and
available resolution depend on the selected source.
You cannot set the pulse period if you have selected the CLK IN
connector as the frequency source (
:TRIG:SOUR INT
:PULS:PER 25NS
:TRIG:SOUR EX T2
Select internal PLL as pulse trigger
Set pulse frequency to 25 ns
).
:PULS:PER:AUTO
[:SOURce]:PULSe:PERiod:AUTO
Event
ONCE
Not applicable
Use this command to measure the period at the CLK IN connector. If the
CLK IN connector is the selected pulse period source, you can then read
the measured value with
:TRIG:SOUR EXT2
:PULS:PER:AUTO ONCE
:PULS:PER?
:PULS:PER?
Select ext CLK IN as pulse trigger
Measure period at CLK IN
Query pulse period
71
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter Suffix
*RST value
Specified Limits
Description
Example
Command
Long
Form
Parameter
*RST value
Description
:PULS:TDEL[1|2]
[:SOURce]:PULSe:TDELay[1|2]
Set & Query
Numeric
S
with engineering prefixes.
100 ns
Agilent 81131A: 1.25 ns to 999.9 µs
Agilent 81132A: 0.75 ns to 999.9 µs
Use this command to program the delay of the trailing-edge of the pulse
relative to the start of the pulse period. This is an alternative method of
programming the pulse-width.
:PULS:DEL1 500NS
:PULS:DEL1:HOLD TIME
:PULS:TDEL1 750NS
Set OUTPUT 1 delay to 500 ns
Hold OUTPUT 1 delay constant with varying period
Set OUTPUT 1 trailing delay to 750 ns
:PULS:TRAN[1|2]:UNIT
[:SOURce]:PULSe:TRANsition[1|2]:UNIT
Set & Query
S | SEC | PCT
SEC
Use this command to set the default units for the pulse transition-times.
The default unit is used when the parameter is programmed to a value
without a unit suffix.
Command
Long
Form
Parameter
:PULS:TRAN[1|2]
[:SOURce]:PULSe:TRANsition[1|2][:LEADing]
Set & Query
Numeric
72
Parameter suffix
*RST value
Specified limits
Parameter
coupling
Description
Example
Programming Reference
SCPI Instrument Command List
S
with engineering prefixes
0.8 ns
Agilent 81131A: 0.8 ns or 1.6 ns
Trailing-edge = Leading-edge fixed coupled
Use this command to set/read the transition-time of the pulse leadingedge. Note that the leading and trailing edges of the pulse have to fit
within the defined pulse-width.
:PULS:TRAN1 1.6NS
Set OUTPUT 1 leading edge to 1.6 ns
NOTE
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified limits
Parameter
coupling
Description
NOTE
Selectable transition time is only available with Agilent 81131A.
:PULS:TRAN[1|2]:TRA
[:SOURce]:PULSe:TRANsition[1|2]:TRAiling
Set & Query
Numeric
S
with engineering prefixes.
0.8 ns
Agilent 81131A: 0.8 ns or 1.6 ns
Trailing-edge = Leading-edge fixed coupled
Use this command to set/read the transition-time of the pulse trailingedge. Note that the leading and trailing edges of the pulse have to fit
within the defined pulse-width.
Selectable transition time is only available with Agilent 81131A.
73
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
Command
Long
Form
Parameter
*RST value
Description
:PULS:TRIG[1]:MODE
[:SOURce]:PULSe:TRIGger[1]:MODE
Set & Query
CONTinuous | STARt
STARt
Use this command to set/read the TRIGGER OUT generation mode in
pattern mode.
:PULS:TRIG[1]:POS
[:SOURce]:PULSe:TRIGger[1]:POSition
Set & Query
1 | 2 | 3 | 4
1
Use this command to set/read the TRIGGER OUT position in pattern
mode. The specified value selects a segment number for the
Agilent 81130A.
Use this command to set/read the output levels at the TRIGGER OUT
connector.
Termination
ValueHigh LevelLow Level
TTL2,5V0V0V50
PECL4,2V3,3V3,0V50
SYM0,5V0.5V0V50
ECLGND0,8V1,7V0V50
ECLN2V0,8V1,7V2,0V50
Vol tage
Termination
Resistor
Ω
Ω
Ω
Ω
Ω
:PULS:WIDT[1|2]
[:SOURce]:PULSe:WIDTh[1|2]
Set & Query
Numeric
S
with engineering prefixes
100 ns
Agilent 81131A: 1.25 ns to 999.9 µs
Agilent 81132A: 0.75 ns to 999.9 µs
Description
Example
Use this command to program the width of the pulse signal. If you want
to set width as dutycycle use
[:SOURce]:PULSe:DCYCle[1|2]
.
If you want the pulse-width to remain constant when the pulse period is
varied (rather than the dutycycle) use
[:SOURce]:PULSe:HOLD[1|2]
WIDTh.
:PULS:WIDT1 50NS
:PULS:HOLD1 WIDTH
Set OUTPUT 1 pulse width to 50 ns
Hold pulse-width constant with varying period
75
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
Example
Command
Long
Form
Parameter
*RST value
Specified limits
Description
Example
:ROSC:SOUR
[:SOURce]:ROSCillator:SOURce
Set & Query
INTernal | EXTernal
INT
Use this command to set/read the reference source for the PLL. If you
select the external reference (CLK IN connector) you can choose to use a
1 MHz, 2 MHz, 5 MHz or 10 MHz reference signal using
:ROSC:EXT:FREQ.
INTernalLock the PLL to its internal reference
EXTernal Lock the PLL to a reference signal at the CLK IN connector. The exter-
nal reference signal can be 1, 2, 5 or 10 MHz.
:ROSC:SOUR EXT
:ROSC:EXT:FREQ 10 MHZ
Set external PLL reference (CLK IN)
Set expected PLL reference frequency
to 10 MHz
:ROSC:EXT:FREQ
[:SOURce]:ROSCillator:EXTernal:FREQuency
Set & Query
Numeric
5 MHz
1 MHz, 2 MHz , 5 MHz or 10 MHz
Use this command to set/read the expected reference frequency for the
PLL at the CLK IN connector. The external reference can be a 1, 2, 5 or 10
MHz signal. Note that if you program any value other than the specified
values, the value will be set to the nearest of the specified values.
:ROSC:SOUR EXT
:ROSC:EXT:FREQ 10MHZ
Set external PLL reference (CLK IN)
Set expected PLL reference frequency to 10 MHz
This command programs the amplitude voltage of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of voltage, you first have to
execute the
[:SOURce]:VOLTage
The available voltage range is limited by the specified current limits.
:HOLD VOLT
:VOLT1 2V
[:SOURce]:H OLD VOLT age
subsystem.
Enable VOLTAGE subsystem
Set OUTPUT 1 amplitude to 2 V
command to enable the
Command
Long
Form
Parameter
Parameter suffix
*RST value
:VOLT[1|2]:OFFSet
[:SOURce]:VOLTage[1|2][:LEVel][:IMMediate]:OFFSet
Set & Query
Numeric
V
with engineering prefixes.
0.0 mV
77
Programming Reference
SCPI Instrument Command List
Specified Limits
Value coupling
Range coupling
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Agilent 81131A: 1.95 V to 3.75 V
Agilent 81132A: 1.95 V to 2.95 V
High = Offset +
Amplitude
2
Low = Offset –
Amplitude
2
Amplitude
This command programs the offset voltage of the OUTPUT signal. Note
that to set the OUTPUT levels in terms of voltage, you first have to
execute the
[:SOURce]:VOLtage
The available voltage range is limited by the specified current limits.
:HOLD VOLT
:VOLT1:OFF -800MV
:VOLT[1|2]:HIGH
[:SOURce]:VOLTage[1|2][:LEVel][:IMMediate]:HIGH
Set & Query
Numeric
V
with engineering prefixes.
500 mV
Agilent 81131A: 1.90 V to 3.80 V
Agilent 81132A: 1.90 V to 2.50 V
[:SOURce]:HOLD VOLTage
subsystem.
Enable VOLTAGE subsystem
Set OUTPUT 1 offset to 800mV
command to enable the
Value coupling
Amplitude = High – Low
Offset =
High – Low
2
78
Programming Reference
SCPI Instrument Command List
Range coupling
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Specified Limits
Value coupling
Low-level
This command programs the High-level voltage of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of voltage, you first have to
execute the
[:SOURce]:VOLTage
[:SOURce]:HOLD VOLTage
subsystem.
command to enable the
The available voltage range is limited by the specified current limits.
:HOLD VOLT
:VOLT1:HIGH 2V
Enable VOLTAGE subsystem
Set OUTPUT 1 high level voltage to 2 V
:VOLT[1|2]:LOW
[:SOURce]:VOLTage[1|2][:LEVel][:IMMediate]:LOW
Set & Query
Numeric
V
with engineering prefixes.
500 mV
Agilent 81131A: 2.00 V to 3.70 V
Agilent 81132A: 2.00 V to 2.90 V
Range coupling
Description
Example
Amplitude = High – Low
Offset =
High – Low
2
High-level
This command programs the Low-level voltage of the OUTPUT signal.
Note that to set the OUTPUT levels in terms of voltage, you first have to
execute the
[:SOURce]:VOLTage
The available voltage range is limited by the specified current limits.
:HOLD VOLT
:VOLT1:LOW 500MV
[:SOURce]:HOLD VOLTage
subsystem.
Enable VOLTAGE subsystem
Set OUTPUT 1 low-level to 500mV
command to enable the
79
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
Parameter suffix
*RST value
Description
Example
Command
Long
Form
Parameter
Parameter suffix
*RST value
Description
Example
:VOLT[1|2]:LIM
[:SOURce]:VOLTage[1|2]:LIMit[:HIGH]
Set & Query
Numeric
V
with engineering prefixes.
+500 mV
Use this command to set/read the High-level voltage limit. If you switch
on voltage limiting, the High-level voltage cannot be set above the
programmed limit. Note that the voltage is NOT limited by the OUTPUT
hardware, this is a software limit.
:HOLD VOLT
:VOLT1:LIM 2V
:VOLT1:LIM:STAT ON
Enable VOLTAGE subsystem
Set OUTPUT 1 High-level limit to 2 V
Switch on OUTPUT 1 limits
:VOLT[1|2]:LIM:LOW
[:SOURce]:VOLTage[1|2]:LIMit:LOW
Set & Query
Numeric
V
with engineering prefixes.
500 mV
Use this command to set/read the Low-level voltage limit. If you switch
on voltage limiting, the Low-level voltage cannot be set below the
programmed limit. Note that the voltage is NOT limited by the OUTPUT
hardware, this is a software limit.
:HOLD VOLT
:VOLT1:LIM:LOW 0V
:VOLT1:LIM:STAT ON
Enable VOLTAGE subsystem
Set OUTPUT 1 Low-level voltage
Switch on OUTPUT 1 limits
80
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
NOTE
Example
Command
:VOLT[1|2]:LIM:STAT
[:SOURce]:VOLTage[1|2]:LIMit:STATe
Set & Query
ON | OFF | 1 | 0
OFF
This command switches the output limits on or off. When you switch on
the output limits cannot program the output-levels beyond the
programmed limits, until you switch off the voltage-limits. The limits
apply whether you program High/Low levels or Amplitude/Offset levels.
You can switch the limits on and off in both the
and the
[:SOURce]:VOLTage
subsystems but the current and voltage
[:SOURce]:CURRent
limits are not enabled/ disabled independently. The voltage and current
limits are always enabled/disabled together.
:HOLD VOLT
:VOLT1:LIM 2V
:VOLT1:LIM:LOW 0V
:VOLT1:LIM:STAT ON
Enable VOLTAGE subsystem
Set OUTPUT 1 High level voltage limit to 2
Set OUTPUT 1 Low-level voltage limit to 0
Switch on OUTPUT 1 limits
V
:STATus:OPERation
This command tree accesses the
OPERation
status group is not used by the instrument therefore this
OPERation
status group. The
command tree is redundant.
:STATus:OPERation[:EVENt]?
:STATus:OPERation:CONDition?
:STATus:OPERation:ENABle
:STATus:OPERation:NTRansition
:STATus:OPERation:PTRansition
81
Programming Reference
SCPI Instrument Command List
Command
Long
Form
*RST value
Description
:STATus:PRESet
:STATus:PRESet
Event
Not Applicable
This command
Clears all status group event-registers
Clears the error queue
Presets the status group enable-, PTR-, and NTR-registers as follows:
This command tree accesses the QUEStionable status group. The
QUEStionable status group contains warning bits for voltage, current,
time and frequency parameters. A warning occurs when the output signal
could be out of specification due to the combined specification
uncertainties of many parameters, although all parameters are set within
their individually specified limits. If a parameter is set outside its
specified limits an error is generated.
The following commands are used to access the registers within the
status group:
82
:STATus:QUEStionable[:EVENt]?
1.
Form
*RST value
Description
:STATus:QUEStionable:CONDition?
2.
Form
*RST value
Description
:STATus:QUEStionable:ENABle
3.
Form
Parameter
*RST value
Specified
limits
Description
:STATus:QUEStionable:NTRansition
4.
Form
Parameter
*RST value
Specified
limits
Description
Query
Not Applicable
This command reads the event register in the QUEStionable status
group.
Query
Not Applicable
This command reads the condition register in the QUEStionable
status group.
Set & Query
Numeric
Not affected by *RST
0 32767
This command sets or queries the enable register in the
QUEStionable status group.
Set & Query
Numeric
Not applicable
0 32767
This command sets or queries the negative transition register in
the QUEStionable status group.
Programming Reference
SCPI Instrument Command List
:STATus:QUEStionable:PTRansition
5.
Form
Parameter
*RST value
Specified
limits
Description
Set & Query
Numeric
Not applicable
0 32767
This command sets or queries the positive transition register in the
QUEStionable status group.
83
Programming Reference
SCPI Instrument Command List
Command
Long
Form
*RST value
Description
Example
:SYST:ERR?
:SYSTem:ERRor?
Query
Not Applicable
Use this command to read the instrument error queue. The instrument
error queue can store up to 30 error codes on a first-in-first-out basis.
When you read the error queue, the error number and associated
message are put into the instrument's output buffer.
If the queue is empty, the value 0 is returned, meaning
No Error
. If the
queue overflows at any time, the last error code is discarded and
replaced with
:SYS:ERR?
-350
meaning
Queue overflow
Query for errors
.
Output example:
-222 "Data out of range" overlap at output 1: Width>Period
The above message is an example of a customized description. Generic
descriptions are available in the SCPI 1995 Command Reference, items
21.8.4 to 21.8.11.
":SYST:WARN:STR?"
Send
. Alternatively, the HELP key shows the
current errors and warnings and their description on the instruments
display.
Command
Long
Form
Parameter
Parameter suffix
*RST value
:SYST:KEY
:SYSTem:KEY
Set & Query
Numeric
No suffix allowed
Not Applicable
84
Specified limits
No.Key Description
255No key pressed (Query only)
0DATA ENTRY 0
1DATA ENTRY 1
2DATA ENTRY 2
3DATA ENTRY 3
4DATA ENTRY 4
5DATA ENTRY 5
6DATA ENTRY 6
7DATA ENTRY 7
8DATA ENTRY 8
9DATA ENTRY 9
10DATA ENTRY .
11DATA ENTRY
12Cursor Up
13Cursor Down
14Cursor Left
15Cursor Right
16
17
18
19
20
21Softkey 1
22Softkey 2
23Softkey 3
24Softkey 4
25
MAN
STORE
HELP
SHIFT
MORE
NANO
+/
Programming Reference
SCPI Instrument Command List
85
Programming Reference
SCPI Instrument Command List
No.Key Description
Description
NOTE
26
27
28
29Modify Knob Left (counter-clockwise)
30Modify Knob Right (clockwise)
MICRO/MEGA
MILLI/KILO
ENTER
In query form, this command reads the last key pressed. The buffer is
emptied by *RST and returns the value -1 when empty.
In set form, the command simulates pressing a key on the frontpanel.
Simulated key-press are also recorded as the last key pressed.
:SYST:KEY 19
sets the instrument to LOCAL mode.
1. In remote mode only the softkeys under the display and the SHIFT
(LOCAL) key are active. Since the instrument normally switches to
remote mode when any command is received, including
:SYSTe m:KE Y
, simulating one of the other disabled keys has no
effect.
2. If you want to simulate full frontpanel operation, you must prevent
the instrument from entering remote mode by using the REN line of
the GP-IB to maintain local mode (LOCAL 7 in BASIC).
If you do this, the
:SYSTem:KEY
command is the only command which
works. Any other commands will be buffered in the instrument blocking
any further
:SYSTem:KEY
commands, until remote mode is enable.
86
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Command
Long
Form
Parameter
*RST value
Description
CAUTION
:SYST:PRES
:SYSTem:PRESet
Same as *RST
:SYST:SEC
:SYSTem:SECurity[:STATe]
Set & Query
ON|OFF
OFF
Do not switch on system security unless you are willing to erase the
instrument settings stored in the instrument. All instrument memories,
including the current setting, will be overwritten with the default settings
if you
Switch off system security
Switch the instrument off and on again
If you accidentally switch on system security, and want to rescue the
settings stored in the instrument, store the settings on a memory card.
You can then recall them from the memory card later.
Use this command to switch on system security mode. Switch on system
security if you need to make sure that all instrument settings stored in
the instrument are erased automatically when the instrument is switched
off, or when security mode is switched off.
The instrument settings are erased by overwriting them with the default
settings.
System security mode is not available via the frontpanel. If you want to
erase all settings by hand:
1
SHIFT STORE 0 to RECALL the default settings from memory 0.
2
STORE 1, STORE 2 ,...,STORE 4 to store the defaults in memories 1 to 4.
87
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
Command
Long
Form
*RST value
Description
:SYST:SET
:SYSTem:SET
Set & Query
Block data
Not applicable
In query form, the command reads a block of data containing the
instrument's complete set-up. The set-up information includes all
parameter and mode settings, but does not include the contents of the
instrument setting memories, the status group registers or the
:DISPlay[:WINDow][:STATe]
The data is in a binary format, not
ASCII, and cannot be edited.
In set form, the block data must be a complete instrument set-up read
using the query form of the command.
:SYST:VERS?
:SYSTem:VERSion?
Query
"1992.0"
This command reads the SCPI revision to which the instrument
complies.
Command
Long
Form
*RST value
Description
:SYST:WARN?
:SYSTem:WARNing[:COUNt]?
Query
Not applicable
Use this command to read the number of warnings which are currently
active. Note that the warning status of voltage, current, time and
frequency are also summarized by bits in the QUESTionable Status
register.
88
Programming Reference
SCPI Instrument Command List
Command
Long
Form
*RST value
Description
Command
Long
Form
*RST value
Description
Command
Long
Form
Parameter
*RST value
Specified limits
:SYST:WARN:STR?
:SYSTem:WARNing:STRing?
Query
Not applicable
Use this command to read all the currently active warning messages. The
warning messages are concatenated to form a single string with a ; as
separator between the messages.
:SYST:WARN:BUFF?
:SYSTem:WARNing:BUFFer?
Query
Not applicable
Use this command to read the maximum possible number of characters
which could be returned by
:SYST:WARN:STR?
if all warnings were
active.
:TRIG:COUN
:TRIGger[:SEQuence[1] | :STARt]:COUNt
Set & Query
Numeric
1
1 to 65504
89
Programming Reference
SCPI Instrument Command List
Description
NOTE
Examples
Use this command to set/read the number of trigger events (pulse
periods) to be generated for each arming event in pulse and burst mode
(in pattern mode the number of trigger events depends on the used
sequence). This corresponds to selecting the event mode on the MODE/TRG screen:
PULSES
BURST of
Set a trigger count of 1 so that a single pulse period is
generated for each arming event.
Set a trigger count of 2 to 65504 so that a burst of 2 to 65504
pulse periods is generated for each arming event. Switch off
pattern mode so that a pulse is generated in each pulse
period. (
:DIG:PATT OFF
)
For a started burst this command will reduce the number of pulses on
channel 1 and channel 2 (
:TRIGger:COUNt
set by
channels will increase the value to of
:TRIGger:COUNt:PULSes[1|2]
) to the value
. Changes of the number of pulses on the
:TRIGger:COUNt
to reflect the
changes on the channels.
STARTED BURST of 16 pulse periods
To s e t
Out1
, the burst are started by a positive level at the EXT INPUT:
:ARM:SOUR EXT1
:ARM:MODE STAR
:ARM:SENS POS
:TRIG:COUN 16
:TRIG:COUN:PULS1 6
:TRIG:SOUR INT1
:DIG:PATT OFF
Set arming from EXT INPUT
Set started mode
Set arming on positive level
Burst length 16
Number of pulses at OUTPUT 1
Pulse period trigger from internal PLL.
Disable pattern operating mode
6 Pulses at
and
GATED PULSES Pulses at Out1
To s e t
EXT INPUT:
:ARM:SOUR EXT1
:ARM:MODE GAT
:ARM:SENS POS
:TRIG:COUN 1
:TRIG:SOUR INT1
:DIG:PATT OFF
90
, gated by a positive level at the
Set arming from EXT INPUT
Set arming on levels
Set arming on positive level 1 pulse period
Single pulse output mode
Pulse period trigger from internal PLL.
Disable pattern data
Programming Reference
SCPI Instrument Command List
Influence of
:TRIGger:COU Nt
started burst mode:
:ARM:SOUR IMM
TRIG:COUN 1
:ARM:MODE STAR
:TRIG:COUN:PULS1 20
:TRIG:COUN 5
:TRIG:COUN:PULS1? ⇒ 5
:TRIG:COUN? ⇒ 5
:TRIG:COUN:PULS1 10
:TRIG:COUN? ⇒ 10
:TRIG:COUN 20
:TRIG:COUN? ⇒ 10
:TRIG:COUN 8
:TRIG:COUN:PULS1? ⇒ 8
:TRIG:COUN 1
:TRIG:COUN:PULS1? ⇒ 8
:TRIGger:COUNt:PULSes[1|2]
and
Set continuous mode
Set Pulse mode
Prepare started mode
Set number of pulses on channel 1 to 20
Set Burst mode with a length of 5 clocks,
the number of pulses on both channels
will be reduced to 5 if necessary.
Request number of pulses on channel 1
Request number of clock within the
started burst
Set number of pulses on channel 1 to 10
Request number of clocks within the
started burst
Set number of clocks within the started
burst to 20
Request the number of clocks with in
the started burst. The return value is 10,
because none of the channels will generate more than 10 pulses.
Set the number of clocks within the
started burst to 8.
Request the number of pulses on channel 1. The return value is 8, because the
number of clocks has been decreased to
a value less than the currently used
number of pulses on channel 1.
Set Pulse mode
Request the number of pulses on channel 1. The value stays unchanged, since
the instrument is no longer in started
burst mode.
in
91
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Specified limits
Description
Examples
Command
Long
Form
Parameter
Parameter Suffix
*RST value
Specified Limits
Description
Example
:TRIG:COUN:PULS[1|2]
:TRIGger[:SEQuence[1] | :STARt]:COUNt:PULSes[1|2]
Set & Query
Numeric
2
2 to 65504
Use this command to set/read the number of pulses within a burst at
OUTPUT 1 or OUTPUT 2.
STARTED BURST of 16 pulse periods
To s e t
Out1
, the burst is started by a positive level at the EXT INPUT:
:ARM:SOUR EXT1
:ARM:MODE STAR
:ARM:SENS POS
:TRIG:COUN 16
:TRIG:COUN:PULS1 6
:TRIG:SOUR INT1
:DIG:PATT OFF
Set arming from EXT INPUT
Set started mode
Set arming on positive level
Burst length 16
Set 6 pulses at OUTPUT 1
Pulse period trigger from internal PLL.
Disable pattern operating mode
6 Pulses at
and
:TRIG:LEV:TERM
:TRIGger[:SEQuence[1] | :STARt]:LEVel:TERMination
Set & Query
Numeric
V
with engineering prefixes.
0.0 V
2.1V to +3.3V
Use this command to program the termination voltage compensation of
the CLK IN connector.
:TRIG:LEV:TERM 2.5V
Set CLK IN termination voltage to 2.5 V
92
Programming Reference
SCPI Instrument Command List
Command
Long
Form
Parameter
*RST value
Description
:TRIG:SOUR
:TRIGger[:SEQuence[1] | :STARt]:SOURce
Set & Query
IMMediate | IN Tern al [1] | EX Tern al2
INT
Use this command to select the pulse period source of the
Agilent 81130A by selecting the source of the pulse period trigger signal:
Pulse period sources set by
:TRIG:SOUR
Pulse period source:TRIG:SOURce
internal PLL
CLK IN
IMMediate | INTernal[1]
EXTernal2
93
Programming Reference
SCPI Instrument Command List
94
3
3Specifications
In this chapter you will find the specifications of the Agilent 81130A
Pulse Generator and its output modules Agilent 81131A and Agilent
81132A.
At the end of this chapter, Pulse Parameter Definitions on page 111
provides detailed information on the definition of the pulse parameters
used by the instrument.
NOTE
War ranted Per form a nce
Specifications describe the instruments warranted performance. Nonwarranted values are described as typical. All specifications apply after a
30 minute warm-up phase with 50 Ohm source, a 50 Ohm load resistance
and separate channels. They are valid from 0 °C to 55 °C ambient
Agilent 81100Family of Pulse-/Data Generators
Agilent 81110 A330/165 MHz Pulse/Pattern Generator
Agilent 81104 A 80 MHz Pulse Pattern Generator
Agilent 81101 A 50 MHz Pulse Pattern Generator
Agilent 81112 A330 MHz , 3.5V Output Module
Agilent 81130 A *400/660 MHz Puls-/Pattern Generator
Agilent 81131 A *400 MHz , 3.5V Output Module
Agilent 81132 A *660 MHz , 2.5V Output Module
Agilent E 8305 A * VXI Plugin 250 MHz Pulse Generator
Agilent E 8306 A * VXI Plugin 100 MHz Clock Generator
conforms to the following standards:
IEC 1010-1:1990 +A1:1992 +A2:1995 EN61010-1:1993
EN 55011:1991 / CISPR 11 Group 1, Class B
* EN 55011:1991 / CISPR 11 Group 1, Class A
EN 61000-4-2:1995ESD: 4kVcd; 8 kVad;4kV c.p.
EN 61000-4-3:1995Radiated Immunity: 3V/m 80%AM
ENV 50204: 1995 Radiated Immunity: 3V/m; 50%Dty
EN 61000-4-4:1995Fast Transients/Bursts: 0.5kV, 1kV
EN 61000-4-5:1995Surges: 1kVdiff; 2kV com.mode
EN 61000-4-6:1995Conducted Immunity
EN 61000-4-8:1993Power freq. magn. field 3A/m; 50Hz
IEC1000-4-11:1994Voltage Dips and Interruptions
The product herewith complies with the requirements of the
Low Voltage Directive (73/23/EEC) and the
EMC Directive (89/336/EEC).
During the measurements against EN55011, the I/O ports were terminated with their
nominal impedance, the GP-IB connection was terminated with the cable Agilent 10833B.
When the product is connected to other devices, the user must ensure that the connecting
cables and the other devices are adequately shielded to prevent radiation.
under normal operation and at the typical operator position:
LpA = 52 dB (5.9 bel) typical {47 dB (5.3 bel) at 23°C) typical}
Measured in accordance with ISO 7779/EN 27779.
98
Specifications
Agilent 81130A Specifications
Timing Specifications
The timing characteristics are measured at 50% amplitude at fastest
transitions in continuous mode and 50 Ω load impedance.
NOTE
The Agilent 81130A is designed and recommended for an operation in the
frequency range of 170 kHz to 400/660 MHz. However it can be operated
in the extended range down to 1 kHz. Changes in specifications below
170 kHz are set in brackets [].
Period & Frequency
Period can also be entered as frequency.
Period & Frequency
Period range:2.5 ns to 1 ms1.5 ns to 1 ms
Frequency range:1 kHz to 400.0 MHz1 kHz to 660.0 MHz
Period/frequency
resolution:
Period accuracy
RMS-jitter:
(internal reference,
internal clock)
a
In burst mode the first period may be decreased by 150 ps.
Agilent 81130A with
Agilent 81131A
a
:
4 digits, 2 ps best case
± 100 ppm [0.01%]
0.001% + 15 ps
Repeatability is typically four times better than accuracy.
Agilent 81130A with
Agilent 81132A
99
Specifications
Agilent 81130A Specifications
Width
The width can be entered as absolute width, duty cycle, or trailing edge
delay.
Width
Width range:1.25 ns to (period 1.25 ns)750 ps to (period 750 ps)
Resolution:4 digits, 2 ps best case [0.05% of period]
Accuracy:
Jitter: 0.001%
Agilent 81130A with
Agilent 81131A
±
100 ppm ± 200 ps [± 0.06% of period]
Agilent 81130A with
Agilent 81132A
+
15 ps
Delay
Measured between trigger output and main output. Can be entered as
absolute delay, phase ° or % of period.
Delay
Variable delay range:0 to 3.00 µs: independent of period
Resolution:4 digits, 2 ps best case [0.05% of period]
Accuracy:
Jitter: 0.001% + 15 ps
Fixed Delay:32 ns typ.
Agilent 81130A with
Agilent 81131A
> 3.00 µs: 0 ns to 1 period
±
(0.01% + 100 ps) relative to the zero-delay
[±0.035% of period]
Agilent 81130A with
Agilent 81132A
100
Loading...
+ 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.