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.
Trademarks
Microsoft®, MS-DOS®, Windows®, Windows 2000®, and Windows XP® are U.S.
registered trademarks of Microsoft Corporation.
Adobe®, Acrobat®, and the Acrobat
Logo® are trademarks of Adobe Systems
Incorporated.
Manual Part Number
Version 04.10.0002
Edition
July 23, 2007
Available in electronic format only
Agilent Technologies, Inc.
1900 Garden of the Gods Road
Colorado Springs, CO 80907 USA
Warranty
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.
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
agency regulation or contract clause. Use,
duplication or disclosure of Software is
subject to Agilent Technologies’ standard
commercial license terms, and non-DOD
Departments and Agencies of the U.S. Government will receive no greater than
Restricted Rights as defined in FAR
52.227-19(c)(1-2) (June 1987). U.S. Government users will receive no greater than
Limited Rights as defined in FAR 52.227-14
(June 1987) or DFAR 252.227-7015 (b)(2)
(November 1995), as applicable in any
technical data.
Safety Notices
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.
WARNING
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.
If software is for use in the performance of
a U.S. Government prime contract or subcontract, Software is delivered and
licensed as “Commercial computer software” as defined in DFAR 252.227-7014
(June 1995), or as a “commercial item” as
defined in FAR 2.101(a) or as “Restricted
computer software” as defined in FAR
52.227-19 (June 1987) or any equivalent
In This Book
This programmer's reference gives detailed information on all the
commands available for controlling these oscilloscope models:
Table 16000 Series Oscilloscope Models
ChannelsInput Bandwidth
1 GHz500 MHz300 MHz100 MHz
4 analog + 16
digital
(mixed-signal)
2 analog + 16
digital
(mixed-signal)
4 analogDSO6104A/LDSO6054A/LDSO6034ADSO6014A/L
2 analogDSO6102ADSO6052ADSO6032ADSO6012A
The command descriptions in this reference show upper and lowercase
characters. For example, :AUToscale indicates that the entire command
name is :AUTOSCALE. The short form, :AUT, is also accepted by the
oscilloscope.
Command arguments and syntax are described for each command. Some
command descriptions have example code.
• "What's New" on page 17
• "Commands Quick Reference" on page 31
• "Commands by Subsystem" on page 73
• "Commands A- Z" on page 469
• "Obsolete and Discontinued Commands" on page 491
MSO6104A/LMSO6054A/LMSO6034AMSO6014A/L
MSO6102AMSO6052AMSO6032AMSO6012A
• "Error Messages" on page 533
• "Status Reporting" on page 541
• "More About Oscilloscope Commands" on page 563
• "Programming Examples" on page 585
See the Agilent 6000 Series Oscilloscopes Programmer's Quick Start
Guide for information on installing the IO libraries, connecting the
oscilloscope to the controller PC, and getting started with oscilloscope
programming.
See your oscilloscope's User's Guide for more information on front-panel
operation.
Agilent 6000 Series Oscilloscopes Programmer's Reference3
Mixed-Signal
Oscilloscope
Channel
Differences
Because both the "analog channels only" oscilloscopes (DSO models) and
the mixed-signal oscilloscopes (MSO models) have analog channels, topics
that describe analog channels refer to all oscilloscope models. Whenever a
topic describes digital channels, that information applies only to the
mixed-signal oscilloscope models.
Example
Programs
The example programs are designed to work with multiple 6000 Series
oscilloscopes. Therefore, the commands may not match the example code
exactly, but the example code should run because of the designed- in
backward compatibility with earlier commands.
4Agilent 6000 Series Oscilloscopes Programmer's Reference
Contents
1 What's New
2 Commands Quick Reference
In This Book3
What's New in Version 4.1018
What's New in Version 4.0020
What's New in Version 3.5022
What's New in Version 3.0024
Command Differences From 54620/54640 Series Oscilloscopes26
Program Message Syntax 565
Command Tree569
Duplicate Mnemonics579
Tree Traversal Rules and Multiple Commands579
Query Return Values582
All Oscilloscope Commands Are Sequential583
9 Programming Examples
SICL Example in C586
VISA Example in C595
VISA Example in Visual Basic604
VISA COM Example in Visual Basic614
Index
Agilent 6000 Series Oscilloscopes Programmer's Reference15
16Agilent 6000 Series Oscilloscopes Programmer's Reference
Agilent 6000 Series Oscilloscopes
Programmer's Reference
1
What's New
What's New in Version 4.10 18
What's New in Version 4.00 20
What's New in Version 3.50 22
What's New in Version 3.00 24
Command Differences From 54620/54640 Series Oscilloscopes 26
A
17
1What's New
What's New in Version 4.10
New features in version 4.10 of the 6000 Series oscilloscope software are:
• The ability to trigger on and decode FlexRay serial bus data using a
Decomsys BusDoctor 2 protocol analyzer with a four-channel
mixed-signal oscilloscope that includes the Option FRS license.
• The square root waveform math function.
• Several new hardcopy printer drivers.
More detailed descriptions of the new and changed commands appear
below.
New Commands
CommandDescription
:SBUS:BUSDoctor:ADDRess (see page 294)Sets/queries the four fields in the BusDoctor
:SBUS:BUSDoctor:BAUDrate (see page 295)Sets/queries the baud rate for the BusDosctor
LAN IP Address.
from 2.5 Mb/s to 10 Mb/s.
:SBUS:BUSDoctor:CHANnel (see page 296)Sets/queries the FlexRay channel that the
BusDoctor analyzes/preprocesses.
:SBUS:BUSDoctor:MODE (see page 297)Sets/queries the operating mode of the
:SBUS:FLEXray:COUNt:NULL? (see page 304)Returns the FlexRay null frame count.
:SBUS:FLEXray:COUNt:RESet (see page 305)Resets the FlexRay frame counters.
:SBUS:FLEXray:COUNt:SYNC? (see page 306)Returns the FlexRay sync frame count.
:SBUS:FLEXray:COUNt:TOTal? (see page 307)Returns the FlexRay total frame count.
:TRIGger:FLEXray:ERRor:TYPE (see page 371)Sets/queries the FlexRay error type to trigger
:TRIGger:FLEXray:FRAMe:CCBase (see
page 373)
:TRIGger:FLEXray:FRAMe:CCRepetition (see
page 374)
:TRIGger:FLEXray:FRAMe:ID (see page 375)Sets/queries the FlexRay frame ID to trigger
:TRIGger:FLEXray:FRAMe:TYPE (see page 376)Sets/queries the FlexRay frame type to trigger
BusDoctor.
on.
Sets/queries the base of the FlexRay cycle
count (in the frame header) to trigger on.
Sets/queries the repetition number of the
FlexRay cycle count (in the frame header) to
trigger on.
on.
on.
:TRIGger:FLEXray:TIME:CBASe (see page 377)Sets/queries the base of the FlexRay cycle to
trigger on.
:TRIGger:FLEXray:TIME:CREPetition (see
page 378)
18Agilent 6000 Series Oscilloscopes Programmer's Reference
Sets/queries the repetition number of the
FlexRay cycle to trigger on.
CommandDescription
What's New1
Changed
Commands
:TRIGger:FLEXray:TIME:SEGMent (see
page 379)
:TRIGger:FLEXray:TIME:SLOT (see page 380)Sets/queries the FlexRay slot type and ID.
:TRIGger:FLEXray:TRIGger (see page 381)Sets/queries the FlexRay trigger mode..
CommandDifferences
:FUNCtion:OPERation (see page 217)You can now select the SQRT (square root)
:SBUS:MODE (see page 310)You can now select the FLEXray serial bus
:TRIGger:MODE (see page 338)You can now select the FLEXray trigger mode.
:HARDcopy:PDRiver (see page 231)You can now select the new DJPR0kx50,
Sets/queries the FlexRay segment type.
waveform math function.
decode mode.
DJ55xx, PS470, and LJFastraster printer
drivers.
Agilent 6000 Series Oscilloscopes Programmer's Reference19
1What's New
What's New in Version 4.00
New features in version 4.00 of the 6000 Series oscilloscope software are:
• The ability to :AUToscale selected channels only and specify the
acquisition type and mode that is set after an :AUToscale.
• The :BUS command subsystem for controlling up to two buses made up
of digital channels.
• Additional :CALibrate commands for starting the user calibration
procedure, displaying the status of the last user calibration, and
displaying the temperature change since the last user calibration.
More detailed descriptions of the new and changed commands appear
below.
New Commands
CommandDescription
:AUToscale:AMODE (see page 107)Specifies whether to keep the current
acquisition type and mode after subsequent
autoscales.
:AUToscale:CHANnels (see page 108)Specifies whether to autoscale the currently
displayed channels or all channels.
:BUS<n>:BIT<m> (see page 152)Includes or excludes the selected bit in a bus
:BUS<n>:BITS (see page 153)Includes or excludes a list of bits in a bus
:BUS<n>:CLEar (see page 155)Excludes all digital channels from a bus
:BUS<n>:DISPlay (see page 156)Displays or hides the bus on the oscilloscope
:BUS<n>:LABel (see page 157)Assigns a label string to a bus.
:BUS<n>:MASK (see page 158)Includes or excludes bits in a bus definition
:CALibrate:STARt (see page 162)Starts the user calibration procedure.
:CALibrate:STATus? (see page 163)Displays the summary results of the last user
:CALibrate:TEMPerature? (see page 165)Displays the change in temperature since the
definition.
definition.
definition
display.
according to a mask.
calibration procedure.
last user calibration procedure.
20Agilent 6000 Series Oscilloscopes Programmer's Reference
Changed
Commands
What's New1
CommandDifferences
:AUToscale (see page 105)You can now specify which channels to
autoscale.
:BLANk (see page 109)Now, you can also use this command with
digital channel buses.
:DIGitize (see page 111)Now, you can also use this command with
digital channel buses.
:STATus (see page 134)Now, you can also use this command with
digital channel buses.
:VIEW (see page 137)Now, you can also use this command with
digital channel buses.
:WAVeform:SOURce (see page 456)Now, you can also use this command with
digital channel buses.
Agilent 6000 Series Oscilloscopes Programmer's Reference21
1What's New
What's New in Version 3.50
New features in version 3.50 of the 6000 Series oscilloscope software are:
• The CAN and LIN options have been added to the :SBUS:MODE (serial
decode mode) command.
• The :SBUS:CAN:COUNt commands have been added to count CAN bus
frames, count load utilization, and reset the counters.
• The ALLerrors, OVERload, and ACKerror options have been added to
the :TRIGger:CAN:TRIGger command.
• The :TRIGger:LIN:ID, :TRIGger:LIN:SAMPlepoint, :TRIGger:LIN:STANdard,
and :TRIGger:LIN:SYNCbreak commands have been added.
• The :SBUS:LIN:PARity command has been added.
• The ID (for Frame Id) option has been added to the
:TRIGger:LIN:TRIGger command.
• The :HWERegister:CONDition, :HWERegister[:EVENt], and :HWE
commands for the hardware event condition, event, and enable registers
have been added.
New Commands
More detailed descriptions of the new and changed commands appear
below.
CommandDescription
:SBUS:CAN:COUNt:ERRor? (see page 298)Returns the CAN bus error frame count.
:SBUS:CAN:COUNt:OVERload? (see page 298)Returns the CAN bus overload frame count.
:SBUS:CAN:COUNt:RESet (see page 298)Resets the CAN bus counters.
:SBUS:CAN:COUNt:TOTal? (see page 298)Returns the CAN bus total frame count.
:SBUS:CAN:COUNt:UTILization? (see page 298)Returns a percentage showing CAN bus
utilization.
:SBUS:IIC:ASIZe (see page 308)Determines whether the Read/Write bit is
included as the LSB in the display of the IIC
address field of the decode bus.
:SBUS:LIN:PARity (see page 309)Determines whether the parity bits are
included as the most significant bits (MSB) in
the display of the Frame Id field in the LIN
decode bus.
:TRIGger:LIN:ID (see page 401)Defines the LIN identifier searched for in each
CAN message when the LIN trigger mode is set
to frame ID.
22Agilent 6000 Series Oscilloscopes Programmer's Reference
What's New1
CommandDescription
:TRIGger:LIN:SAMPlepoint (see page 402)Sets the point during the bit time where the bit
level is sampled to determine whether the bit is
dominant or recessive. The sample point
represents the percentage of time between the
beginning of the bit time to the end of the bit
time.
:TRIGger:LIN:STANdard (see page 405)Sets the LIN standard in effect for triggering
and decoding to be LIN1.3 or LIN2.0.
:TRIGger:LIN:SYNCbreak (see page 406)Sets the length of the LIN sync break to be
greater than or equal to 11,12, or 13 clock
lengths. The sync break is the idle period in the
bus activity at the beginning of each packet
that distinguishes one information packet from
the previous one.
:HWEenable (see page 113)Sets or reads the hardware event enable mask
register.
Changed
Commands
Obsolete
Commands
:HWERegister:CONDition? (see page 115)Queries the hardware event condition register.
:HWERegister[:EVENt]? (see page 117)Queries the hardware event event register.
CommandDifferences
:SBUS:MODE (see page 310)The CAN and LIN serial bus decode modes
have been added.
:TRIGger:CAN:TRIGger (see page 352)The ALLerrors, OVERload, and ACKerror
options have been added.
:TRIGger:LIN:TRIGger (see page 407)The ID (for Frame Id) option has been added.
Agilent 6000 Series Oscilloscopes Programmer's Reference23
1What's New
What's New in Version 3.00
New features in version 3.00 of the 6000 Series oscilloscope software are:
• The :SBUS command subsystem for controlling serial decode bus
display, mode, and other options.
• The EBURst trigger mode and supporting :TRIGger:EBURst commands.
• The :ACQuire:AALias and :ACQuire:DAALias commands.
• The :WAVeform:POINts:MODE command.
• The :MEASure:SDEViation command.
• The :TIMebase:REFClock command.
• Changes to the :TRIGger:IIC commands.
• Changes to the :TRIGger:SEQuence:TRIGger command.
• Changes to the :ACQuire:TYPE and :WAVeform:TYPE commands to add
HRESolution type.
New Commands
• Changes to the :BLANk, :DIGitize, :STATus, :VIEW, and
:WAVeform:SOURce commands to include the serial decode bus.
• Changes to the :HARDcopy:FORMat command to support the PNG,
ASCiixy, and BINary format types.
• Changes to the :DISPlay:DATA? query and the :PRINt command to
support the PNG format.
• Changes to the :WAVeform:POINts command to set from 2000 to
8,000,000 points (in 1-2-5 sequence) when the waveform points mode is
MAXimum or RAW.
More detailed descriptions of the new and changed commands appear
below.
CommandDescription
:ACQuire:AALias? (see page 140)Returns the current state of the oscilloscope's
anti-alias control.
:ACQuire:DAALias (see page 143)Sets the oscilloscope's disable anti-alias mode.
:MEASure:SDEViation (see page 268)Measures the std deviation of a waveform.
:SBUS:DISPlay (see page 303)Controls the decoded serial bus display.
:SBUS:MODE (see page 310)Determines the decode mode for the serial bus.
:SBUS:SPI:WIDTh (see page 311)Determines the number of bits in a word of
decoded data for SPI.
:TIMebase:REFClock (see page 325)Enables or disables the 10 MHz REF BNC
input/output.
24Agilent 6000 Series Oscilloscopes Programmer's Reference
Changed
Commands
What's New1
CommandDescription
:TRIGger:EBURst:COUNt (see page 361)Sets the Nth edge of burst edge counter
resource.
:TRIGger:EBURst:IDLE (see page 362)Sets the Nth edge in a burst idle resource.
:TRIGger:EBURst:SLOPe (see page 361)Specifies whether the rising edge (POSitive) or
falling edge (NEGative) of the Nth edge in a
burst will generate a trigger.
:TRIGger:IIC:PATTern:DATa2 (see page 394)Sets IIC data 2.
:WAVeform:POINts:MODE (see page 451)Sets the waveform points mode.
CommandDifferences
:ACQuire:TYPE (see page 148)The HRESolution type has been added for
smoothing at slower sweep speeds.
:BLANk (see page 109)Now, you can also use this command with the
serial decode bus.
:DIGitize (see page 111)Now, you can also use this command with the
serial decode bus.
:DISPlay:DATA (see page 196)Now, the PNG format is supported in the query.
:HARDcopy:FORMat (see page 228)Now, the PNG, ASCiixy, and BINary formats are
also supported.
:PRINt (see page 130)Now, the PNG option is supported
:STATus (see page 134)Now, you can also use this command with the
serial decode bus.
:TRIGger:IIC:TRIGger[:TYPE] (see page 398)The ANACknowledge, R7Data2, and W7Data2
types have been added.
:TRIGger:MODE (see page 338)The EBURst mode has been added.
:TRIGger:SEQuence:TRIGger (see page 415)The EDGE2,COUNt,NREFind (no re-find) option
has been added.
:VIEW (see page 137)Now, you can now use this command with the
serial decode bus.
:WAVeform:POINts (see page 449)Now, you can set from 2000 to 8,000,000 points
(in 1-2-5 sequence) when the waveform points
mode is MAXimum or RAW.
:WAVeform:SOURce (see page 456)Now, you can also use this command with the
serial decode bus.
:WAVeform:TYPE (see page 460)The HRESolution type has been added for
smoothing at slower sweep speeds.
Agilent 6000 Series Oscilloscopes Programmer's Reference25
1What's New
Command Differences From 54620/54640 Series Oscilloscopes
The main differences between the version 1.00 programming command set
for the 6000 Series oscilloscopes and the 54620/54640 Series oscilloscopes
are related to:
• :HARDcopy and :DISPlay command subsystem changes for USB printers
and the high resolution color display.
• New standards supported by the :TRIGger:TV commands.
• Support for 113xA Series probes.
• New "RAW" :WAVeform:POINts option for retrieving raw acquisition
record data.
• Discontinuance of the common commands for macros.
More detailed descriptions of the new, changed, obsolete, and discontinued
commands appear below.
New Commands
CommandDescription
:ACQuire:RSIGnal (see page 146)Selects the 10 MHz reference signal mode.
:CHANnel<n>:PROBe:ID? (see page 178)Returns the type of probe attached to the
specified oscilloscope channel.
:CHANnel<n>:PROBe:STYPe (see page 180)Sets the channel probe signal type (STYPe) to
differential or single-ended when using the
113xA Series probes, and determines how
offset is applied.
:CHANnel<n>:VERNier (see page 185)Specifies whether the channel's vernier (fine
vertical adjustment) setting is ON (1) or OFF (0).
:DIGital<n>:SIZE (see page 191)Specifies the size of digital channels on the
display.
:EXTernal:PROBe:ID (see page 207)Returns the type of probe attached to the
external trigger input.
:EXTernal:PROBe:STYPe (see page 208)Sets the external trigger probe signal type
(STYPe) to differential or single-ended when
using the 113xA Series probes, and determines
how offset is applied.
:HARDcopy:FILename (see page 227)Sets the output filename for print formats
whose output is a file. Replaces the 5462x/4x
:HARDcopy:DESTination (see page 508)
command.
:HARDcopy:PDRiver (see page 231)Sets the hardcopy printer driver.
:HARDcopy:IGColors (see page 229)Specifies whether graticule colors are inverted.
26Agilent 6000 Series Oscilloscopes Programmer's Reference
Changed
Commands
What's New1
CommandDescription
:HARDcopy:PALette (see page 230)Sets the hardcopy palette color. Replaces the
5462x/4x :HARDcopy:GRAYscale (see
page 510) command.
:OPERegister:CONDition? (see page 122)Returns the integer value contained in the
“Operation Status Condition Register" on
page 122 (a new register in addition to the
“Operation Status Event Register" on page 124
whose value is returned by the
:OPERegister[:EVENt]? (see page 124) query).
:POD<n>:SIZE (see page 289)Specifies the size of digital channels on the
display.
:TIMebase:VERNier (see page 328)Specifies whether the time base control's
vernier (fine horizontal adjustment) setting is
ON (1) or OFF (0).
CommandDifferences From 5462x/4x Oscilloscopes
:ACQuire:COUNt (see page 142)The count can be set to any value from 1 to
65536 (instead of 16383).
:DISPlay:DATA (see page 196)The BMP8bit <format> option has been added
to the query. There is a new <palette> option
which can be MONochrome, GRAYscale, or
COLor in the query, or just MONochrome in the
command.
:DISPlay:SOURce (see page 201)The number of pixel memory locations is 10
(instead of 3).
:HARDcopy:FORMat (see page 228)There is now the BMP8bit format (instead of
TIFF) and the PRINter0 or PRINter1 formats (in
place of LASerjet, DESKjet, EPSon, or SEIKo).
See the new :HARDcopy:PDRiver (see
page 231) command for setting the hardcopy
printer driver.
*LRN (see page 85)The Learn Device Setup query return format
matches the IEEE 488.2 specification which
says that the query result must contain
":SYST:SET " before the binary block data.
(This was not the case in the 5462x/4x
oscilloscopes.)
:MERGe (see page 119)The number of pixel memory locations is 10
(instead of 3).
Agilent 6000 Series Oscilloscopes Programmer's Reference27
1What's New
CommandDifferences From 5462x/4x Oscilloscopes
*OPT (see page 87)The Option Identification query return format
now has license information (in addition to the
I/O module ID information fields which are
now always zero).
:OVLRegister (see page 128)The Overload Event Register is now a 16-bit
register (instead of 8-bit) and it contains bits
that identify when faults occur on the
oscilloscope channels (in addition to the bits
that identify when overloads occur).
:PRINt (see page 130)The options are now: COLor (instead of HIRes),
GRAYscale (instead of LORes), PRINter0
(instead of PARallel), BMP8bit (instead of
TIFF). (The PCL option is now invalid.)
*RCL (Recall) (see page 88)The number of instrument state locations is 10
(instead of 3 for the 54620 Series oscilloscopes
or 4 for the 54640 Series oscilloscopes).
*SAV (Save) (see page 92)The number of instrument state locations is 10
(instead of 3 for the 54620 Series oscilloscopes
or 4 for the 54640 Series oscilloscopes).
*TRG (Trigger) (see page 97)The *TRG has the same effect as the :DIGitize
command with no parameters (instead of the
:TRIGger:TV:MODE (see page 427)The modes have been renamed (however, old
:TRIGger:TV:STANdard (see page 430)The P480L60HZ, P720L60HZ, P1080L24HZ,
:VIEW (see page 137)The number of pixel memory locations is 10
:WAVeform:COUNt? (see page 445)The count can be any value from 1 to 65536
:WAVeform:POINts (see page 449)There is a new RAW "number of points" option
:RUN command).
forms of the mode names are still accepted).
P1080L25HZ, I1080L50HZ, and I1080L60HZ
standards are supported (in addition to
GENeric, NTSC, PALM, PAL, and SECam).
(instead of 3).
(instead of 16383).
for retrieving the raw acquisition record data.
Also the maximum number of points that can
be retrieved from the normal measurement
record is 1000 (instead of 2000).
:WAVeform:PREamble (see page 453)The xincrement format is 64-bit floating point
NR3 (instead of 32-bit), and the yreference
format is 32-bit NR1 (instead of 16-bit).
28Agilent 6000 Series Oscilloscopes Programmer's Reference
Obsolete
Commands
What's New1
CommandDifferences From 5462x/4x Oscilloscopes
:WAVeform:XINCrement (see page 463)The x-increment value from the preamble is
returned in 64-bit (instead of 32-bit) floating
point NR3 format.
:WAVeform:YREFerence (see page 468)The y-reference value from the preamble is
returned in 32-bit (instead of 16-bit) NR1
format.
The options are now: COLor
(instead of HIRes), GRAYscale
(instead of LORes), PRINter0
(instead of PARallel), BMP8bit
(instead of TIFF). (The DISK
and PCL options are now
invalid.)
Agilent 6000 Series Oscilloscopes Programmer's Reference29
1What's New
30Agilent 6000 Series Oscilloscopes Programmer's Reference
Agilent 6000 Series Oscilloscopes
Programmer's Reference
2
Commands Quick Reference
Command Summary 32
Syntax Elements 70
A
31
2Commands Quick Reference
Command Summary
Table 2Common (*) Commands Summary
CommandQueryOptions and Query Returns
*CLS (see page 79)n/an/a
*ESE <mask> (see
page 80)
n/a*ESR? (see page 82)<status> ::= 0 to 255; an integer in
n/a*IDN? (see page 82)AGILENT TECHNOLOGIES,<model>,
*ESE? (see page 81)<mask> ::= 0 to 255; an integer in
NR1 format:
Bit Weight Name Enables
--- ------ ---- ---------7128PONPower On
664URQUser Request
532CMECommand Error
416EXEExecution Error
38DDEDev. Dependent Error
24QYEQuery Error
12RQLRequest Control
01OPCOperation Complete
NR1 format
<serial number>,X.XX.XX
<model> ::= the model number of the
instrument
<serial number> ::= the serial
number of the instrument
<X.XX.XX> ::= the software revision
of the instrument
n/a*LRN? (see page 85)<learn_string> ::= current
instrument setup as a block of data
in IEEE 488.2 # format
*OPC (see page 86)*OPC? (see page 86)ASCII "1" is placed in the output
queue when all pending device
operations have completed.
32Agilent 6000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference2
Table 2Common (*) Commands Summary (continued)
CommandQueryOptions and Query Returns
n/a*OPT? (see page 87)<return_value> ::= 0,0,<license
<count> ::= Average count, or 1 if
PEAK detect type or NORMal; an
integer in NR1 format
<source> ::= {CHANnel<n> | FUNCtion
| MATH | SBUS} for DSO models
<source> ::= {CHANnel<n> | POD{1 |
2} | BUS{1 | 2} | FUNCtion | MATH |
SBUS} for MSO models
n/a:WAVeform:TYPE? (see
page 460)
:WAVeform:UNSigned {{0
| OFF} | {1 | ON}} (see
page 461)
:WAVeform:VIEW <view>
(see page 462)
n/a:WAVeform:XINCrement?
n/a:WAVeform:XORigin? (see
n/a:WAVeform:XREFerence?
n/a:WAVeform:YINCrement?
:WAVeform:UNSigned?
(see page 461)
:WAVeform:VIEW? (see
page 462)
(see page 463)
page 464)
(see page 465)
(see page 466)
<n> ::= 1-2 or 1-4 in NR1 format
<return_mode> ::= {NORM | PEAK |
AVER | HRES}
{0 | 1}
<view> ::= {MAIN}
<return_value> ::= x-increment in
the current preamble in NR3 format
<return_value> ::= x-origin value in
the current preamble in NR3 format
<return_value> ::= 0 (x-reference
value in the current preamble in NR1
format)
<return_value> ::= y-increment value
in the current preamble in NR3
format
68Agilent 6000 Series Oscilloscopes Programmer's Reference
Commands Quick Reference2
Table 3 2 :WAVeform Commands Summary (continued)
CommandQueryOptions and Query Returns
n/a:WAVeform:YORigin? (see
page 467)
n/a:WAVeform:YREFerence?
(see page 468)
<return_value> ::= y-origin in the
current preamble in NR3 format
<return_value> ::= y-reference value
in the current preamble in NR1
format
Agilent 6000 Series Oscilloscopes Programmer's Reference69
2Commands Quick Reference
Syntax Elements
• "Number Format" on page 70
• "<NL> (Line Terminator)" on page 70
• "[ ] (Optional Syntax Terms)" on page 70
• "{ } (Braces)" on page 70
• "::= (Defined As)" on page 70
• "< > (Angle Brackets)" on page 71
• "... (Ellipsis)" on page 71
• "n,..,p (Value Ranges)" on page 71
• "d (Digits)" on page 71
• "Quoted ASCII String" on page 71
• "Definite- Length Block Response Data" on page 71
Number Format
NR1 specifies integer data.
NR3 specifies exponential data in floating point format (for example,
-1.0E-3).
<NL> (Line Terminator)
<NL> = new line or linefeed (ASCII decimal 10).
The line terminator, or a leading colon, will send the parser to the "root"
of the command tree.
[ ] (Optional Syntax Terms)
Items enclosed in square brackets, [ ], are optional.
{ } (Braces)
When several items are enclosed by braces, { }, only one of these elements
may be selected. Vertical line ( | ) indicates "or". For example, {ON | OFF}
indicates that only ON or OFF may be selected, not both.
::= (Defined As)
::= means "defined as".
70Agilent 6000 Series Oscilloscopes Programmer's Reference
For example, <A> ::= <B> indicates that <A> can be replaced by <B> in any
statement containing <A>.
< > (Angle Brackets)
< > Angle brackets enclose words or characters that symbolize a program
code parameter or an interface command.
... (Ellipsis)
... An ellipsis (trailing dots) indicates that the preceding element may be
repeated one or more times.
n,..,p (Value Ranges)
n,..,p ::= all integers between n and p inclusive.
d (Digits)
Commands Quick Reference2
d ::= A single ASCII numeric character 0 - 9.
Quoted ASCII String
A quoted ASCII string is a string delimited by either double quotes (") or
single quotes ('). Some command parameters require a quoted ASCII
string. For example, when using the Agilent VISA COM library in Visual
Basic, the command:
myScope.WriteString ":CHANNEL1:LABEL 'One'"
has a quoted ASCII string of:
'One'
In order to read quoted ASCII strings from query return values, some
programming languages require special handling or syntax.
Definite-Length Block Response Data
Definite- length block response data allows any type of device-dependent
data to be transmitted over the system interface as a series of 8- bit binary
data bytes. This is particularly useful for sending large quantities of data
or 8- bit extended ASCII codes. This syntax is a pound sign (#) followed by
a non- zero digit representing the number of digits in the decimal integer.
After the non-zero digit is the decimal integer that states the number of
8- bit data bytes being sent. This is followed by the actual data.
For example, for transmitting 1000 bytes of data, the syntax would be
Agilent 6000 Series Oscilloscopes Programmer's Reference71
2Commands Quick Reference
#800001000<1000 bytes of data> <NL>
8 is the number of digits that follow
00001000 is the number of bytes to be transmitted
<1000 bytes of data> is the actual data
72Agilent 6000 Series Oscilloscopes Programmer's Reference
Agilent 6000 Series Oscilloscopes
Programmer's Reference
3
Commands by Subsystem
SubsystemDescription
"Common (*) Commands" on page 75Commands defined by IEEE 488.2 standard that
are common to all instruments.
"Root (:) Commands" on page 100Control many of the basic functions of the
oscilloscope and reside at the root level of the
command tree.
":ACQuire Commands" on page 138Set the parameters for acquiring and storing
data.
":BUS<n> Commands" on page 150Control all oscilloscope functions associated
with the digital channels bus display.
":CALibrate Commands" on page 159Utility commands for determining the state of
the calibration factor protection switch.
":CHANnel<n> Commands" on page 167Control all oscilloscope functions associated
with individual analog channels or groups of
channels.
":DIGital<n> Commands" on page 186Control all oscilloscope functions associated
with individual digital channels.
":DISPlay Commands" on page 193Control how waveforms, graticule, and text are
displayed and written on the screen.
":EXTernal Trigger Commands" on page 203Control the input characteristics of the external
trigger input.
":FUNCtion Commands" on page 212Control functions in the measurement/storage
module.
":HARDcopy Commands" on page 224Set and query the selection of hardcopy device
and formatting options.
":MARKer Commands" on page 232Set and query the settings of X-axis markers
(X1 and X2 cursors) and the Y-axis markers (Y1
and Y2 cursors).
":MEASure Commands" on page 243Select automatic measurements to be made
and control time markers.
A
73
3Commands by Subsystem
SubsystemDescription
":POD Commands" on page 287Control all oscilloscope functions associated
":SBUS Commands" on page 292Control oscilloscope functions associated with
":SYSTem Commands" on page 312Control basic system functions of the
":TIMebase Commands" on page 320Control all horizontal sweep functions.
":TRIGger Commands" on page 332Control the trigger modes and parameters for
":WAVeform Commands" on page 436Provide access to waveform data.
Command TypesThree types of commands are used:
• Common (*) Commands — See "Introduction to Common (*)
Commands" on page 77 for more information.
with groups of digital channels.
the serial decode bus.
oscilloscope.
each trigger type.
• Root Level (:) Commands — See "Introduction to Root (:) Commands"
on page 102 for more information.
• Subsystem Commands — Subsystem commands are grouped together
under a common node of the "Command Tree" on page 569, such as the
:TIMebase commands. Only one subsystem may be selected at any given
time. When the instrument is initially turned on, the command parser is
set to the root of the command tree; therefore, no subsystem is
selected.
74Agilent 6000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem3
Common (*) Commands
Commands defined by IEEE 488.2 standard that are common to all
instruments. See "Introduction to Common (*) Commands" on page 77.
Table 3 3 Common (*) Commands Summary
CommandQueryOptions and Query Returns
*CLS (see page 79)n/an/a
*ESE <mask> (see
page 80)
n/a*ESR? (see page 82)<status> ::= 0 to 255; an integer in
n/a*IDN? (see page 82)AGILENT TECHNOLOGIES,<model>,
*ESE? (see page 81)<mask> ::= 0 to 255; an integer in
NR1 format:
Bit Weight Name Enables
--- ------ ---- ---------7128PONPower On
664URQUser Request
532CMECommand Error
416EXEExecution Error
38DDEDev. Dependent Error
24QYEQuery Error
12RQLRequest Control
01OPCOperation Complete
NR1 format
<serial number>,X.XX.XX
<model> ::= the model number of the
instrument
<serial number> ::= the serial
number of the instrument
<X.XX.XX> ::= the software revision
of the instrument
n/a*LRN? (see page 85)<learn_string> ::= current
instrument setup as a block of data
in IEEE 488.2 # format
*OPC (see page 86)*OPC? (see page 86)ASCII "1" is placed in the output
queue when all pending device
operations have completed.
Agilent 6000 Series Oscilloscopes Programmer's Reference75
3Commands by Subsystem
Table 3 3 Common (*) Commands Summary (continued)
CommandQueryOptions and Query Returns
n/a*OPT? (see page 87)<return_value> ::= 0,0,<license
n/a*TST? (see page 98)<result> ::= 0 or non-zero value; an
integer in NR1 format
*WAI (see page 99)n/an/a
Introduction to
Common (*)
Commands
The common commands are defined by the IEEE 488.2 standard. They are
implemented by all instruments that comply with the IEEE 488.2 standard.
They provide some of the basic instrument functions, such as instrument
identification and reset, reading the instrument setup, and determining
how status is read and cleared.
Common commands can be received and processed by the instrument
whether they are sent over the interface as separate program messages or
within other program messages. If an instrument subsystem has been
selected and a common command is received by the instrument, the
instrument remains in the selected subsystem. For example, if the program
message ":ACQuire:TYPE AVERage; *CLS; COUNt 256" is received by the
instrument, the instrument sets the acquire type, then clears the status
information and sets the average count.
In contrast, if a root level command or some other subsystem command is
within the program message, you must re-enter the original subsystem
after the command. For example, the program message ":ACQuire:TYPE
AVERage; :AUToscale; :ACQuire:COUNt 256" sets the acquire type,
completes the autoscale, then sets the acquire count. In this example,
:ACQuire must be sent again after the :AUToscale command in order to
re- enter the ACQuire subsystem and set the count.
Agilent 6000 Series Oscilloscopes Programmer's Reference77
3Commands by Subsystem
NOTE
Each of the status registers has an enable (mask) register. By setting the bits in the enable
register, you can select the status information you want to use.
78Agilent 6000 Series Oscilloscopes Programmer's Reference
*CLS (Clear Status)
(see page 564)
Commands by Subsystem3
Command Syntax
NOTE
See Also• "Introduction to Common (*) Commands" on page 77
*CLS
The *CLS common command clears the status data structures, the
device-defined error queue, and the Request-for- OPC flag.
If the *CLS command immediately follows a program message terminator, the output queue
and the MAV (message available) bit are cleared.
• "*STB (Read Status Byte)" on page 95
• "*ESE (Standard Event Status Enable)" on page 80
• "*ESR (Standard Event Status Register)" on page 82
• "*SRE (Service Request Enable)" on page 93
• ":SYSTem:ERRor" on page 315
Agilent 6000 Series Oscilloscopes Programmer's Reference79
3Commands by Subsystem
*ESE (Standard Event Status Enable)
(see page 564)
Command Syntax
*ESE <mask_argument>
<mask_argument> ::= integer from 0 to 255
The *ESE common command sets the bits in the Standard Event Status
Enable Register. The Standard Event Status Enable Register contains a
mask value for the bits to be enabled in the Standard Event Status
Register. A "1" in the Standard Event Status Enable Register enables the
corresponding bit in the Standard Event Status Register. A zero disables
the bit.
321854(;(''(4<(54/23&&0(
(65"
(6(
(6("
6WDQGDUG(YHQW
6WDWXV5HJLVWHU
6WDQGDUG(YHQW
6WDWXV(QDEOH
0DVN5HJLVWHU
25
7R(6%ELWLQ
6WDWXV%\WH
5HJLVWHU
Table 3 4 Standard Event Status Enable (ESE)
BitNameDescriptionWhen Set (1 = High = True), Enables:
7PONPower OnEvent when an OFF to ON transition occurs.
6URQUser RequestEvent when a front-panel key is pressed.
5CMECommand ErrorEvent when a command error is detected.
4EXEExecution ErrorEvent when an execution error is detected.
3DDEDevice Dependent ErrorEvent when a device-dependent error is detected.
2QYEQuery ErrorEvent when a query error is detected.
80Agilent 6000 Series Oscilloscopes Programmer's Reference
Table 3 4 Standard Event Status Enable (ESE) (continued)
BitNameDescriptionWhen Set (1 = High = True), Enables:
1RQLRequest ControlEvent when the device is requesting control. (Not
0OPCOperation CompleteEvent when an operation is complete.
Query Syntax*ESE?
The *ESE? query returns the current contents of the Standard Event
Status Enable Register.
Commands by Subsystem3
used.)
Return Format
See Also• "Introduction to Common (*) Commands" on page 77
<mask_argument><NL>
<mask_argument> ::= 0,..,255; an integer in NR1 format.
• "*ESR (Standard Event Status Register)" on page 82
• "*OPC (Operation Complete)" on page 86
• "*CLS (Clear Status)" on page 79
Agilent 6000 Series Oscilloscopes Programmer's Reference81
3Commands by Subsystem
*ESR (Standard Event Status Register)
(see page 564)
Query Syntax
*ESR?
The *ESR? query returns the contents of the Standard Event Status
Register. When you read the Event Status Register, the value returned is
the total bit weights of all of the bits that are high at the time you read
the byte. Reading the register clears the Event Status Register.
The following table shows bit weight, name, and condition for each bit.
321854(;(''(4<(54/23&&0(
25
(65"
(6(
(6("
6WDQGDUG(YHQW
6WDWXV5HJLVWHU
6WDQGDUG(YHQW
6WDWXV(QDEOH
0DVN5HJLVWHU
7R(6%ELWLQ
6WDWXV%\WH
5HJLVWHU
Table 3 5 Standard Event Status Register (ESR)
BitNameDescriptionWhen Set (1 = High = True), Indicates:
7PONPower OnAn OFF to ON transition has occurred.
6URQUser RequestA front-panel key has been pressed.
5CMECommand ErrorA command error has been detected.
4EXEExecution ErrorAn execution error has been detected.
3DDEDevice Dependent ErrorA device-dependent error has been detected.
2QYEQuery ErrorA query error has been detected.
82Agilent 6000 Series Oscilloscopes Programmer's Reference
Table 3 5 Standard Event Status Register (ESR) (continued)
BitNameDescriptionWhen Set (1 = High = True), Indicates:
1RQLRequest ControlThe device is requesting control. (Not used.)
0OPCOperation CompleteOperation is complete.
Return Format<status><NL>
<status> ::= 0,..,255; an integer in NR1 format.
Commands by Subsystem3
NOTE
See Also• "Introduction to Common (*) Commands" on page 77
Reading the Standard Event Status Register clears it. High or 1 indicates the bit is true.
• "*ESE (Standard Event Status Enable)" on page 80
• "*OPC (Operation Complete)" on page 86
• "*CLS (Clear Status)" on page 79
• ":SYSTem:ERRor" on page 315
Agilent 6000 Series Oscilloscopes Programmer's Reference83
3Commands by Subsystem
*IDN (Identification Number)
(see page 564)
Query Syntax
Return Format
See Also• "Introduction to Common (*) Commands" on page 77
*IDN?
The *IDN? query identifies the instrument type and software version.
<serial number> ::= the serial number of the instrument
X.XX.XX ::= the software revision of the instrument
• "*OPT (Option Identification)" on page 87
84Agilent 6000 Series Oscilloscopes Programmer's Reference
*LRN (Learn Device Setup)
(see page 564)
Commands by Subsystem3
Query Syntax
Return Format<learn_string><NL>
NOTE
See Also• "Introduction to Common (*) Commands" on page 77
*LRN?
The *LRN? query result contains the current state of the instrument. This
query is similar to the :SYSTem:SETup? (see page 317) query, except that
it contains ":SYST:SET " before the binary block data. The query result is a
valid command that can be used to restore instrument settings at a later
time.
<learn_string> ::= :SYST:SET <setup_data>
<setup_data> ::= binary block data in IEEE 488.2 # format
<learn string> specifies the current instrument setup. The block size is
subject to change with different firmware revisions.
The *LRN? query return format has changed from previous Agilent oscilloscopes to match
the IEEE 488.2 specification which says that the query result must contain ":SYST:SET "
before the binary block data.
• "*RCL (Recall)" on page 88
• "*SAV (Save)" on page 92
• ":SYSTem:SETup" on page 317
Agilent 6000 Series Oscilloscopes Programmer's Reference85
3Commands by Subsystem
*OPC (Operation Complete)
(see page 564)
Command Syntax
Query Syntax
Return Format
See Also• "Introduction to Common (*) Commands" on page 77
*OPC
The *OPC command sets the operation complete bit in the Standard Event
Status Register when all pending device operations have finished.
*OPC?
The *OPC? query places an ASCII "1" in the output queue when all
pending device operations have completed. The interface hangs until this
query returns.
<complete><NL>
<complete> ::= 1
• "*ESE (Standard Event Status Enable)" on page 80
• "*ESR (Standard Event Status Register)" on page 82
• "*CLS (Clear Status)" on page 79
86Agilent 6000 Series Oscilloscopes Programmer's Reference
*OPT (Option Identification)
(see page 564)
Commands by Subsystem3
Query Syntax
Return Format
*OPT?
The *OPT? query reports the options installed in the instrument. This
query returns a string that identifies the module and its software revision
level.
The <Factory MSO> <Upgraded MSO> fields indicate whether the unit is a
mixed-signal oscilloscope and, if so, whether it was factory installed
or upgraded from an analog channels only oscilloscope (DSO).
The *OPT? query returns the following:
ModuleModule Id
No modules attached0,0,0,0,MSO,0,0,mem8M,0,0,0
See Also• "Introduction to Common (*) Commands" on page 77
• "*IDN (Identification Number)" on page 84
Agilent 6000 Series Oscilloscopes Programmer's Reference87
3Commands by Subsystem
*RCL (Recall)
(see page 564)
Command Syntax
See Also• "Introduction to Common (*) Commands" on page 77
*RCL <value>
<value> ::= {0|1|2|3|4|5|6|7|8|9}
The *RCL command restores the state of the instrument from the specified
save/recall register.
• "*SAV (Save)" on page 92
88Agilent 6000 Series Oscilloscopes Programmer's Reference
*RST (Reset)
Commands by Subsystem3
(see page 564)
Command Syntax
*RST
The *RST command places the instrument in a known state. Reset
conditions are:
Acquire Menu
ModeNormal
RealtimeOn
AveragingOff
# Averages8
Analog Channel Menu
Channel 1On
Channel 2Off
Volts/division5.00 V
Offset0.00
CouplingDC
Probe attenuationAutoProbe (if AutoProbe is connected),
otherwise 1.0:1
VernierOff
InvertOff
BW limitOff
Impedance1 M Ohm
UnitsVolts
Skew0
Cursor Menu
SourceChannel 1
Digital Channel Menu (MSO models only)
Channel 0 - 15Off
Agilent 6000 Series Oscilloscopes Programmer's Reference89
3Commands by Subsystem
Digital Channel Menu (MSO models only)
LabelsOff
ThresholdTTL (1.4V)
Display Menu
Definite persistenceOff
Grid33%
VectorsOn
Quick Meas Menu
SourceChannel 1
Run Control
Scope is running
Time Base Menu
Main time/division100 us
Main time base delay0.00 s
Delay time/division500 ns
Delay time base delay0.00 s
Referencecenter
Modemain
VernierOff
Trigger Menu
Ty p eEd g e
ModeAuto
Couplingdc
SourceChannel 1
Level0.0 V
SlopePositive
HF Reject and noise rejectOff
90Agilent 6000 Series Oscilloscopes Programmer's Reference
Commands by Subsystem3
Trigger Menu
Holdoff60 ns
External probe attenuationAutoProbe (if AutoProbe is connected),
otherwise 1.0:1
External UnitsVolts
External Impedance1 M Ohm
See Also• "Introduction to Common (*) Commands" on page 77
Example Code
' RESET - This command puts the oscilloscope into a known state.
' This statement is very important for programs to work as expected.
' Most of the following initialization commands are initialized by
' *RST.It is not necessary to reinitialize them unless the default
' setting is not suitable for your application.
myScope.WriteString "*RST"' Reset the oscilloscope to the defaults.
Example program from the start: "VISA COM Example in Visual Basic" on
page 614
Agilent 6000 Series Oscilloscopes Programmer's Reference91
3Commands by Subsystem
*SAV (Save)
(see page 564)
Command Syntax
See Also• "Introduction to Common (*) Commands" on page 77
*SAV <value>
<value> ::= {0|1|2|3|4|5|6|7|8|9}
The *SAV command stores the current state of the instrument in a save
register. The data parameter specifies the register where the data will be
saved.
• "*RCL (Recall)" on page 88
92Agilent 6000 Series Oscilloscopes Programmer's Reference
*SRE (Service Request Enable)
(see page 564)
Commands by Subsystem3
Command Syntax
*SRE <mask>
<mask> ::= integer with values defined in the following table.
The *SRE command sets the bits in the Service Request Enable Register.
The Service Request Enable Register contains a mask value for the bits to
be enabled in the Status Byte Register. A one in the Service Request
Enable Register enables the corresponding bit in the Status Byte Register.
A zero disables the bit.
)URP
)URP
2SHUDWLRQ
6WDWXV
5HJLVWHUV
23(575*0$9(6%
546
066
6WDQGDUG
(YHQW
6WDWXV
5HJLVWHUV
2XWSXW
4XHXH
06*
865
75*
7(5"7ULJJHU(YHQW5HJLVWHU
5HJ
67%"6WDWXV%\WH5HJLVWHU
65(
65("
25
654
Table 3 6 Service Request Enable Register (SRE)
BitNameDescriptionWhen Set (1 = High = True), Enables:
7OPEROperation Status RegisterInterrupts when enabled conditions in the
6------(Not used.)
6HUYLFH5HTXHVW
Operation Status Register (OPER) occur.
6HUYLFH5HTXHVW(QDEOH
0DVN5HJLVWHU
Agilent 6000 Series Oscilloscopes Programmer's Reference93
3Commands by Subsystem
Table 3 6 Service Request Enable Register (SRE) (continued)
BitNameDescriptionWhen Set (1 = High = True), Enables:
5ESBEvent Status BitInterrupts when enabled conditions in the
4MAVMessage AvailableInterrupts when messages are in the Output
3------(Not used.)
2MSGMessageInterrupts when an advisory has been displayed
1USRUser EventInterrupts when enabled user event conditions
0TRGTriggerInterrupts when a trigger occurs.
Query Syntax*SRE?
Standard Event Status Register (ESR) occur.
Queue.
on the oscilloscope.
occur.
The *SRE? query returns the current value of the Service Request Enable
Register.
Return Format
<mask><NL>
<mask> ::= sum of all bits that are set, 0,..,255;
an integer in NR1 format
See Also• "Introduction to Common (*) Commands" on page 77
• "*STB (Read Status Byte)" on page 95
• "*CLS (Clear Status)" on page 79
94Agilent 6000 Series Oscilloscopes Programmer's Reference
*STB (Read Status Byte)
(see page 564)
Commands by Subsystem3
Query Syntax
Return Format
*STB?
The *STB? query returns the current value of the instrument's status byte.
The MSS (Master Summary Status) bit is reported on bit 6 instead of the
RQS (request service) bit. The MSS indicates whether or not the device
has at least one reason for requesting service.
<value><NL>
<value> ::= 0,..,255; an integer in NR1 format
)URP
)URP
2SHUDWLRQ
6WDWXV
5HJLVWHUV
23(575*0$9(6%
546
066
6WDQGDUG
(YHQW
6WDWXV
5HJLVWHUV
2XWSXW
4XHXH
06*
865
75*
7(5"7ULJJHU(YHQW5HJLVWHU
5HJ
67%"6WDWXV%\WH5HJLVWHU
65(
65("
25
654
Table 3 7 Status Byte Register (STB)
BitNameDescriptionWhen Set (1 = High = True), Indicates:
7OPEROperation Status RegisterAn enabled condition in the Operation Status
6HUYLFH5HTXHVW
Register (OPER) has occurred.
6HUYLFH5HTXHVW(QDEOH
0DVN5HJLVWHU
Agilent 6000 Series Oscilloscopes Programmer's Reference95
3Commands by Subsystem
Table 3 7 Status Byte Register (STB) (continued)
BitNameDescriptionWhen Set (1 = High = True), Indicates:
6RQSRequest ServiceWhen polled, that the device is requesting service.
5ESBEvent Status BitAn enabled condition in the Standard Event Status
4MAVMessage AvailableThere are messages in the Output Queue.
3------(Not used, always 0.)
2MSGMessageAn advisory has been displayed on the
1USRUser EventAn enabled user event condition has occurred.
0TRGTriggerA trigger has occurred.
MSSMaster Summary StatusWhen read (by *STB?), whether the device has a
reason for requesting service.
Register (ESR) has occurred.
oscilloscope.
NOTE
See Also• "Introduction to Common (*) Commands" on page 77
To read the instrument's status byte with RQS reported on bit 6, use the interface Serial
Poll.
• "*SRE (Service Request Enable)" on page 93
96Agilent 6000 Series Oscilloscopes Programmer's Reference
*TRG (Trigger)
Commands by Subsystem3
(see page 564)
Command Syntax
See Also• "Introduction to Common (*) Commands" on page 77
*TRG
The *TRG command has the same effect as the :DIGitize command with no
parameters.
• ":DIGitize" on page 111
• ":RUN" on page 131
• ":STOP" on page 135
Agilent 6000 Series Oscilloscopes Programmer's Reference97
3Commands by Subsystem
*TST (Self Test)
(see page 564)
Query Syntax
Return Format
See Also• "Introduction to Common (*) Commands" on page 77
*TST?
The *TST? query performs a self- test on the instrument. The result of the
test is placed in the output queue. A zero indicates the test passed and a
non-zero indicates the test failed. If the test fails, refer to the
troubleshooting section of the Service Guide.
<result><NL>
<result> ::= 0 or non-zero value; an integer in NR1 format
98Agilent 6000 Series Oscilloscopes Programmer's Reference
*WAI (Wait To Continue)
(see page 564)
Commands by Subsystem3
Command Syntax
See Also• "Introduction to Common (*) Commands" on page 77
*WAI
The *WAI command has no function in the oscilloscope, but is parsed for
compatibility with other instruments.
Agilent 6000 Series Oscilloscopes Programmer's Reference99
3Commands by Subsystem
Root (:) Commands
Control many of the basic functions of the oscilloscope and reside at the
root level of the command tree. See "Introduction to Root (:) Commands"
on page 102.
Table 3 8 Root (:) Commands Summary
CommandQueryOptions and Query Returns
:ACTivity (see
page 103)
n/a:AER? (see page 104){0 | 1}; an integer in NR1 format
:AUToscale
[<source>[,..,<source>]
] (see page 105)
:AUToscale:AMODE
<value> (see page 107)
:AUToscale:CHANnels
<value> (see page 108)
:BLANk [<source>] (see
page 109)
:ACTivity? (see
page 103)
n/a<source> ::= CHANnel<n> for DSO
:AUToscale:AMODE? (see
page 107)
:AUToscale:CHANnels?
(see page 108)
n/a<source> ::= {CHANnel<n>} | FUNCtion
<return value> ::= <edges>,<levels>
<edges> ::= presence of edges
(32-bit integer in NR1 format)
<levels> ::= logical highs or lows
(32-bit integer in NR1 format)