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