Agilent Technologies Infiniium 8000A User manual

Agilent Technologies

Infiniium
8000A Programmer’s
Reference

Programmer's Reference
Publication Number D8064-97004
December 2006
This reference applies directly to software revision code A.05.20 and later.
 Copyright Agilent Technologies 2005-2006
All Rights Reserved.
8000A Series Infiniium
Oscilloscopes

ii
In This Book
This book is your guide to programming the Infiniium Series Oscilloscopes.
Chapters 1-5 give you an introduction to programming the oscilloscopes, along
with necessary conceptual information. These chapters describe basic program
communications, interface, syntax, data types, and status reporting.
Chapter 6 shows example BASIC and C programs, and describes chunks of one
program to show you some typical applications. The BASIC and C example
programs are also shipped on a disk with the oscilloscope.
Chapters 7-25 describe the commands used to program the Infiniium
Oscilloscopes. Each chapter describes the set of commands that belong to an
individual subsystem, and explains the function of each command. These
chapters include:
Error Messages chapter describes error messages.
ACQuire HISTogram
BUS MARKer
CALibration MEASure
CHANnel POD
Common Root Level
DIGital SELFtest
DISK SYSTem
DISPlay TIMe Base
EXTernal Channel TRIGger
FUNCtion WAVeform
HARDcopy Waveform MEMory

Contents
Contents-1
1 Introduction to Programming
Communicating with the Oscilloscope 1-3
Output Command 1-4
Device Address 1-4
Instructions 1-4
Instruction Header 1-4
White Space (Separator) 1-5
Braces 1-5
Ellipsis 1-5
Square Brackets 1-5
Command and Query Sources 1-5
Program Data 1-6
Header Types 1-7
Duplicate Mnemonics 1-9
Query Headers 1-10
Program Header Options 1-11
Character Program Data 1-11
Numeric Program Data 1-12
Embedded Strings 1-13
Program Message Terminator 1-13
Common Commands within a Subsystem 1-14
Selecting Multiple Subsystems 1-14
Programming Getting Started 1-14
Initialization 1-15
Example Program using HP Basic 1-16
Using the DIGITIZE Command 1-17
Receiving Information from the Oscilloscope 1-19
String Variable Example 1-20
Numeric Variable Example 1-20
Definite-Length Block Response Data 1-21
Multiple Queries 1-22
Oscilloscope Status 1-22
2 LAN and GPIB Interfaces
LAN Interface Connector 2-3
GPIB Interface Connector 2-3
Default Startup Conditions 2-4
Interface Capabilities 2-5
GPIB Command and Data Concepts 2-6
Communicating Over the GPIB Interface 2-7
Communicating Over the LAN Interface 2-8
Bus Commands 2-10
3 Message Communication and System Functions
Protocols 3-3

Contents
Contents-2
4 Status Reporting
Status Reporting Data Structures 4-5
Status Byte Register 4-8
Service Request Enable Register 4-10
Message Event Register 4-10
Trigger Event Register 4-10
Standard Event Status Register 4-11
Standard Event Status Enable Register 4-12
Operation Status Register 4-13
Operation Status Enable Register 4-14
Mask Test Event Register 4-15
Mask Test Event Enable Register 4-16
Trigger Armed Event Register 4-17
Acquisition Done Event Register 4-17
Error Queue 4-18
Output Queue 4-18
Message Queue 4-19
Clearing Registers and Queues 4-19
5 Programming Conventions
Truncation Rule 5-3
The Command Tree 5-4
Infinity Representation 5-15
Sequential and Overlapped Commands 5-15
Response Generation 5-15
EOI 5-15
6 Sample Programs
Sample Program Structure 6-3
Sample C Programs 6-4
Listings of the Sample Programs 6-18
gpibdecl.h Sample Header 6-19
srqagi.c Sample Program 6-21
learnstr.c Sample Program 6-23
sicl_IO.c Sample Program 6-27
natl_IO.c Sample Program 6-32
init.bas Sample Program 6-37
srq.bas Sample Program 6-45
lrn_str.bas Sample Program 6-51
7 Acquire Commands
AVERage 7-3
AVERage:COUNt 7-4
COMPlete 7-5
COMPlete:STATe 7-7
INTerpolate 7-8

Contents
Contents-3
MODE 7-9
POINts 7-11
POINts:AUTO 7-21
SEGMented:COUNt 7-22
SEGMented:INDex 7-23
SEGMented:TTAGs 7-24
SRATe (Sample RATe) 7-25
SRATe:AUTO 7-27
8 Bus Commands
BIT<M> 8-3
BITS 8-4
CLEar 8-5
CLOCk 8-6
CLOCk:SLOPe 8-7
DISPlay 8-8
LABel 8-9
READout 8-10
9 Calibration Commands
Oscilloscope Calibration 9-3
Probe Calibration 9-4
Calibration Commands 9-5
OUTPut 9-6
SKEW 9-7
STATus? 9-8
10 Channel Commands
BWLimit 10-3
DISPlay 10-4
INPut 10-5
OFFSet 10-6
PROBe 10-7
PROBe:ATTenuation 10-9
PROBe:EADapter 10-10
PROBe:ECoupling 10-12
PROBe:EXTernal 10-14
PROBe:EXTernal:GAIN 10-15
PROBe:EXTernal:OFFSet 10-17
PROBe:EXTernal:UNITs 10-19
PROBe:GAIN 10-21
PROBe:ID? 10-22
PROBe:SKEW 10-24
PROBe:STYPe 10-25
RANGe 10-26

Contents
Contents-4
SCALe 10-27
UNITs 10-28
11 Common Commands
*CLS (Clear Status) 11-4
*ESE (Event Status Enable) 11-5
*ESR? (Event Status Register) 11-7
*IDN? (Identification Number) 11-9
*LRN? (Learn) 11-10
*OPC (Operation Complete) 11-12
*OPT? (Option) 11-13
*PSC (Power-on Status Clear) 11-14
*RCL (Recall) 11-15
*RST (Reset) 11-16
*SAV (Save) 11-17
*SRE (Service Request Enable) 11-18
*STB? (Status Byte) 11-20
*TRG (Trigger) 11-22
*TST? (Test) 11-23
*WAI (Wait) 11-24
12 Digital Commands
DISPlay 12-3
LABel 12-4
SIZE 12-5
THReshold 12-6
13 Disk Commands
CDIRectory 13-3
DELete 13-4
DIRectory? 13-5
LOAD 13-6
MDIRectory 13-7
MSTore (Obsolete) 13-8
PWD? 13-12
SAVe:IMAGe 13-13
SAVe:LISTing 13-14
SAVe:MEASurements 13-15
SAVe:SETup 13-16
SAVe:WAVeform 13-17
CSV, TSV and TXT Header Format 13-19
BIN Header Format 13-23
SEGMented 13-43
STORe (Obsolete) 13-44
14 Display Commands

Contents
Contents-5
CGRade 14-3
CGRade:LEVels? 14-5
COLumn 14-7
CONNect 14-8
DATA? 14-9
DCOLor 14-10
GRATicule 14-11
LABel 14-13
LINE 14-14
PERSistence 14-15
ROW 14-16
SCOLor 14-17
STRing 14-20
TEXT 14-21
15 External Trigger Commands
BWLimit 15-3
INPut 15-4
PROBe 15-5
PROBe:ATTenuation 15-6
PROBe:EADapter 15-7
PROBe:ECoupling 15-9
PROBe:EXTernal 15-11
PROBe:EXTernal:GAIN 15-12
PROBe:EXTernal:UNITs 15-14
PROBe:GAIN 15-16
PROBe:ID? 15-17
PROBe:SKEW 15-18
RANGe 15-19
UNITs 15-20
16 Function Commands
FUNCtion<N>? 16-4
ABSolute 16-5
ADD 16-6
AVERage 16-7
COMMonmode 16-8
DIFF (Differentiate) 16-9
DISPlay 16-10
DIVide 16-11
FFT:FREQuency 16-12
FFT:RESolution? 16-13
FFT:WINDow 16-14
FFTMagnitude 16-16
FFTPhase 16-17
FFTPhase 16-18

Contents
Contents-6
HIGHpass 16-19
HORizontal:POSition 16-20
HORizontal:RANGe 16-21
INTegrate 16-22
INVert 16-23
LOWPass 16-24
MAGNify 16-25
MAXimum 16-26
MAXimum 16-27
MINimum 16-28
MULTiply 16-29
OFFSet 16-30
RANGe 16-31
SMOoth 16-32
SQRT 16-33
SQUare 16-34
SUBTract 16-35
VERSus 16-36
VERTical 16-37
VERTical:OFFSet 16-38
VERTical:RANGe 16-39
17 Hardcopy Commands
AREA 17-3
DPRinter 17-4
FACTors 17-6
IMAGe 17-7
PRINters? 17-8
18 Histogram Commands
AXIS 18-4
MODE 18-5
SCALe:SIZE 18-6
WINDow:DEFault 18-7
WINDow:SOURce 18-8
WINDow:X1Position | LLIMit 18-9
WINDow:X2Position | RLIMit 18-10
WINDow:Y1Position | BLIMit 18-11
WINDow:Y2Position | TLIMit 18-12
19 InfiniiScan (ISCan) Commands
DELay 19-3
MEASurement:FAIL 19-4
MEASurement:LLIMit 19-5
MEASurement 19-6
MEASurement:TEST 19-7

Contents
Contents-7
MEASurement:ULIMit 19-8
MODE 19-9
NONMonotonic:EDGE 19-10
NONMonotonic:HYSTeresis 19-11
NONMonotonic:SOURce 19-12
RUNT:HYSTeresis 19-13
RUNT:LLEVel 19-14
RUNT:SOURce 19-15
RUNT:ULEVel 19-16
SERial:PATTern 19-17
SERial:SOURce 19-18
20 Limit Test Commands
FAIL 20-3
LLIMit 20-4
MEASurement 20-5
RESults? 20-6
TEST 20-7
ULIMit 20-8
21 Marker Commands
CURSor? 21-3
MEASurement:READout 21-4
MODE 21-5
TDELta? 21-6
TSTArt 21-7
TSTOp 21-9
VDELta? 21-11
VSTArt 21-12
VSTOp 21-14
X1Position 21-16
X2Position 21-17
X1Y1source 21-18
X2Y2source 21-19
XDELta? 21-20
Y1Position 21-21
Y2Position 21-22
YDELta? 21-23
22 Mask Test Commands
ALIGn 22-4
AlignFIT 22-5
AMASk:CREate 22-7
AMASk:SOURce 22-8
AMASk:[SAVE | STORe] 22-9
AMASk:UNITs 22-10

Contents
Contents-8
AMASk:XDELta 22-11
AMASk:YDELta 22-13
AUTO 22-15
AVERage 22-16
AVERage:COUNt 22-17
COUNt:FAILures? 22-18
COUNt:FWAVeforms? 22-19
COUNt:WAVeforms? 22-20
DELete 22-21
ENABle 22-22
FOLDing 22-23
FOLDing:BITS 22-24
HAMPlitude 22-25
IMPedance 22-26
INVert 22-28
LAMPlitude 22-29
LOAD 22-30
NREGions? 22-31
PROBe:IMPedance? 22-32
RUMode 22-33
RUMode:SOFailure 22-35
SCALe:BIND 22-36
SCALe:X1 22-37
SCALe:XDELta 22-38
SCALe:Y1 22-40
SCALe:Y2 22-41
SOURce 22-42
STARt | STOP 22-43
STIMe 22-44
TITLe? 22-45
TRIGger:SOURce 22-46
23 Measure Commands
AREA 23-7
CGRade:CROSsing 23-8
CGRade:DCDistortion 23-9
CGRade:EHEight 23-10
CGRade:EWIDth 23-11
CGRade:JITTer 23-12
CGRade:QFACtor 23-13
CLEar 23-14
CLOCk 23-15
CLOCk:METHod 23-16
CLOCk::VERTical 23-18
CLOCk::VERTical:OFFSet 23-19

Contents
Contents-9
CLOCk:VERTical:RANGe 23-20
CTCDutycycle 23-21
CTCJitter 23-23
CTCNwidth 23-25
CTCPwidth 23-26
DATarate 23-27
DEFine 23-29
DELTatime 23-34
DUTYcycle 23-36
FALLtime 23-38
FFT:DFRequency 23-40
FFT:DMAGnitude 23-41
FFT:FREQuency 23-42
FFT:MAGNitude 23-43
FFT:PEAK1 23-44
FFT:PEAK2 23-45
FFT:THReshold 23-46
FREQuency 23-47
HISTogram:HITS 23-49
HISTogram:M1S 23-51
HISTogram:M2S 23-53
HISTogram:M3S 23-55
HISTogram:MAX? 23-57
HISTogram:MEAN? 23-58
HISTogram:MEDian? 23-59
HISTogram:MIN? 23-60
HISTogram:PEAK? 23-61
HISTogram:PP? 23-62
HISTogram:STDDev? 23-63
HOLDtime 23-64
JITTer:HISTogram 23-66
JITTer:MEASurement 23-67
JITTer:SPECtrum 23-68
JITTer:SPECtrum:HORizontal 23-69
JITTer:SPECtrum:HORizontal:POSition 23-70
JITTer:SPECtrum:HORizontal:RANGe 23-71
JITTer:SPECtrum:VERTical 23-72
JITTer:SPECtrum:VERTical:OFFSet 23-73
JITTer:SPECtrum:VERTical:RANGe 23-74
JITTer:SPECtrum:WINDow 23-75
JITTer:STATistics 23-76
JITTer:TRENd 23-77
JITTer:TRENd:SMOoth 23-78
JITTer:TREND:SMOoth:POINts 23-79
JITTer:TRENd:VERTical 23-80

Contents
Contents-10
JITTer:TRENd:VERTical:OFFSet 23-81
JITTer:TRENd:VERTical:RANGe 23-82
NCJitter 23-83
NWIDth 23-85
OVERshoot 23-87
PERiod 23-89
PHASe 23-91
PREShoot 23-93
PWIDth 23-95
QUALifier<M>:CONDition 23-97
QUALifier<M>:SOURce 23-98
QUALifier<M>:STATe 23-99
RESults? 23-100
RISetime 23-103
SCRatch 23-105
SENDvalid 23-106
SETuptime 23-107
SLEWrate 23-109
SOURce 23-110
STATistics 23-111
TEDGe 23-112
TIEClock2 23-114
TIEData 23-116
TMAX 23-118
TMIN 23-119
TVOLt 23-120
UNITinterval 23-122
VAMPlitude 23-124
VAVerage 23-125
VBASe 23-127
VLOWer 23-128
VMAX 23-129
VMIDdle 23-130
VMIN 23-131
VPP 23-132
VRMS 23-133
VTIMe 23-135
VTOP 23-136
VUPPer 23-137
24 Pod Commands
DISPlay 24-3
THReshold 24-4
PSKew 24-5
25 Root Level Commands

Contents
Contents-11
ADER? (Acquisition Done Event Register) 25-4
AER? (Arm Event Register) 25-5
ATER? (Auto Trigger Event Register) 25-6
AUToscale 25-7
BLANk 25-8
CDISplay 25-9
DIGitize 25-10
DISable 25-12
ENABle 25-13
MTEE 25-14
MTER? 25-15
MODel? 25-16
OPEE 25-17
OPER? 25-18
OVLEnable 25-19
OVLRegister? 25-20
PRINt 25-21
RECall:SETup 25-22
RUN 25-23
SERial (Serial Number) 25-24
SINGle 25-25
STATus? 25-26
STOP 25-27
STORe:SETup 25-28
STORe:WAVeform 25-29
TER? (Trigger Event Register) 25-30
VIEW 25-31
26 Self-Test Commands
CANCel 26-3
SCOPETEST 26-4
27 System Commands
DATE 27-3
DEBug 27-4
DSP 27-6
ERRor? 27-7
HEADer 27-8
LOCK 27-10
LONGform 27-11
SETup 27-13
TIME 27-15
28 Time Base Commands
POSition 28-3
RANGe 28-4

Contents
Contents-12
REFerence 28-5
ROLL:ENABLE 28-6
SCALe 28-7
VIEW 28-8
WINDow:DELay 28-9
WINDow:POSition 28-11
WINDow:RANGe 28-12
WINDow:SCALe 28-13
29 Trigger Commands
Organization of Trigger Modes and Commands 29-5
Summary of Trigger Modes and Commands 29-6
Trigger Modes 29-8
HOLDoff 29-9
HTHReshold 29-10
HYSTeresis 29-11
LEVel 29-12
LTHReshold 29-13
SWEep 29-14
Edge Trigger Mode and Commands 29-15
EDGE:COUPling 29-17
EDGE:SLOPe 29-18
EDGE:SOURce 29-19
Glitch Trigger Mode and Commands 29-20
GLITch:POLarity 29-22
GLITch:SOURce 29-23
GLITch:WIDTh 29-24
Advanced COMM Trigger Mode and Commands 29-25
COMM:BWIDth 29-26
COMM:ENCode 29-27
COMM:LEVel 29-28
COMM:PATTern 29-29
COMM:POLarity 29-30
COMM:SOURce 29-31
Advanced Pattern Trigger Mode and Commands 29-32
PATTern:CONDition 29-34
PATTern:LOGic 29-35
:PATTern:THReshold:LEVel 29-36

Contents
Contents-13
:PATTern:THReshold:POD<N> 29-37
Advanced State Trigger Mode and Commands 29-38
STATe:CLOCk 29-40
STATe:LOGic 29-41
STATe:LTYPe 29-42
STATe:SLOPe 29-43
:STATe:THReshold:LEVel 29-44
Advanced Delay By Event Mode and Commands 29-45
EDLY:ARM:SOURce 29-47
EDLY:ARM:SLOPe 29-48
EDLY:EVENt:DELay 29-49
EDLY:EVENt:SOURce 29-50
EDLY:EVENt:SLOPe 29-51
EDLY:TRIGger:SOURce 29-52
EDLY:TRIGger:SLOPe 29-53
Advanced Delay By Time Mode and Commands 29-54
TDLY:ARM:SOURce 29-56
TDLY:ARM:SLOPe 29-57
TDLY:DELay 29-58
TDLY:TRIGger:SOURce 29-59
TDLY:TRIGger:SLOPe 29-60
Advanced Standard TV Mode and Commands 29-61
STV:FIELd 29-63
STV:LINE 29-64
STV:SOURce 29-65
STV:SPOLarity 29-66
Advanced User Defined TV Mode and Commands 29-67
UDTV:ENUMber 29-69
UDTV:PGTHan 29-70
UDTV:POLarity 29-71
UDTV:SOURce 29-72
Advanced Trigger Violation Modes 29-73
VIOLation:MODE 29-74
Pulse Width Violation Mode and Commands 29-75
VIOLation:PWIDth:DIRection 29-77
VIOLation:PWIDth:POLarity 29-78
VIOLation:PWIDth:SOURce 29-79

Contents
Contents-14
VIOLation:PWIDth:WIDTh 29-80
Setup Violation Mode and Commands 29-81
VIOLation:SETup:MODE 29-84
VIOLation:SETup:SETup:CSOurce 29-85
VIOLation:SETup:SETup:CSOurce:LEVel 29-86
VIOLation:SETup:SETup:CSOurce:EDGE 29-87
VIOLation:SETup:SETup:DSOurce 29-88
VIOLation:SETup:SETup:DSOurce:HTHReshold 29-89
VIOLation:SETup:SETup:DSOurce:LTHReshold 29-90
VIOLation:SETup:SETup:TIME 29-91
VIOLation:SETup:HOLD:CSOurce 29-92
VIOLation:SETup:HOLD:CSOurce:LEVel 29-93
VIOLation:SETup:HOLD:CSOurce:EDGE 29-94
VIOLation:SETup:HOLD:DSOurce 29-95
VIOLation:SETup:HOLD:DSOurce:HTHReshold 29-96
VIOLation:SETup:HOLD:DSOurce:LTHReshold 29-97
VIOLation:SETup:HOLD:TIME 29-98
VIOLation:SETup:SHOLd:CSOurce 29-99
VIOLation:SETup:SHOLd:CSOurce:LEVel 29-100
VIOLation:SETup:SHOLd:CSOurce:EDGE 29-101
VIOLation:SETup:SHOLd:DSOurce 29-102
VIOLation:SETup:SHOLd:DSOurce:HTHReshold 29-103
VIOLation:SETup:SHOLd:DSOurce:LTHReshold 29-104
VIOLation:SETup:SHOLd:SetupTIMe (STIMe) 29-105
VIOLation:SETup:SHOLd:HoldTIMe (HTIMe) 29-106
Transition Violation Mode 29-107
VIOLation:TRANsition 29-109
VIOLation:TRANsition:SOURce 29-110
VIOLation:TRANsition:SOURce:HTHReshold 29-111
VIOLation:TRANsition:SOURce:LTHReshold 29-112
VIOLation:TRANsition:TYPE 29-113
30 Waveform Commands
BANDpass? 30-5
BYTeorder 30-6
COMPlete? 30-7
COUNt? 30-8
COUPling? 30-9
DATA? 30-10
DATA? Example for Analog Channels 30-12
DATA? Example for Digital Channels 30-26
FORMat 30-41
POINts? 30-44

Contents
Contents-15
PREamble 30-45
SEGMented:COUNt? 30-51
SEGMented:TTAG? 30-52
SOURce 30-53
TYPE? 30-55
VIEW 30-57
XDISplay? 30-59
XINCrement? 30-60
XORigin? 30-61
XRANge? 30-62
XREFerence? 30-63
XUNits? 30-64
YDISplay? 30-65
YINCrement? 30-66
YORigin? 30-67
YRANge? 30-68
YREFerence? 30-69
YUNits? 30-70
31 Waveform Memory Commands
DISPlay 31-3
LOAD 31-4
SAVE 31-5
XOFFset 31-6
XRANge 31-7
YOFFset 31-8
YRANge 31-9
32 Error Messages
Error Queue 32-3
Error Numbers 32-4
Command Error 32-5
Execution Error 32-6
Device- or Oscilloscope-Specific Error 32-7
Query Error 32-8
List of Error Messages 32-9

Contents-16