Agilent Technologies 89400 Series Installation manual

Agilent Technologies 89400-Series
GPIB Command Reference
Agilent Technologies Part Number 89400-90039
For instruments with firmware version A.08.00
Printe in U.S.A.
Print Date: May, 2000
© Agilent Technologies, Inc., 1992, 1994, 1995, 1996, 1998, 1999, 2000 .
All rights reserve .
8600 Soper Hill Roa Everett, Washington 98205-1209 U.S.A.

TABLE OF CONTENTS
1 GPIB Programming with Agilent 89400-Series
Analyzers 1
Introduction to GPIB Programming 2
In This Boo 2
GPIB Setup and Verification 3
Equipment an Software Require 3
Proce ure 3
GPIB Interface Capabilities 4
General Status Register Model 5
Overview 5
Con ition Register 6
Transition Registers 6
Event Register 6
Enable Register 7
An Example Sequence 7
How to Use Registers 8
The Service Request Process 9
Generating a Service Request 9
The Agilent 89400A’s Register Sets 11
Register Summary 11
Status Byte Register Set 12
Device State Register Set 13
Questionable Status Register Set 14
Questionable Voltage Register Set 15
Questionable Frequency Register Set 16
Questionable Mo ulation Register Set 17
Stan ar Event Register Set 18
Operational Status Register Set 19
User Status Register Set 21
Agilent 89400 Series Register Set Summary 22
2 The S PI Instrument Model 23
Introduction 24
ROUTe 24
INPut 25
SENSe 25
iii

CALCulate 25
OUTPut 25
SOURce 25
TRIGger 25
ARM-TRIGger Mo el 26
Mo el Layers 26
MEMory 28
FORMat 28
Hard COPy 28
DISPlay 28
Mass MEMory 28
3 ommand Reference 29
A Error Messages 457
SYSTem:ERRor? 458
The Error/Event Queue 458
Error numbers 459
No Error 459
Comman Error 460
Execution Error 463
Device-Specific Error 466
Query Error 467
Instrument-Specific Error Messages
468
B Sockets Example Program 475
iv

OMMAND LISTING
*CAL? ..............................31
*CLS ...............................32
*ESE ...............................33
*ESR? ..............................34
*IDN? ..............................35
*OPC ...............................36
*OPT? ..............................37
*PCB ...............................38
*PSC ...............................39
*RST ...............................40
*SRE ...............................41
*STB? ..............................42
*TRG ...............................43
*TST? ..............................44
*WAI ...............................45
ABORt ..............................46
ARM:DEL y ............................47
ARM:LEVel ............................48
ARM:REGion ...........................49
ARM:SOURce ...........................50
CALCul te:CCDF:COUNt? .....................51
CALCul te:CCDF:POWer? .....................52
CALCul te:DATA? .........................53
CALCul te:DATA:HEADer:POINts? .................54
CALCul te:FEED ..........................55
CALCul te:FORM t ........................57
CALCul te:GDAPerture:APERture .................59
CALCul te:MARKer:BAND:STARt .................60
CALCul te:MARKer:BAND:STOP ..................61
CALCul te:MARKer:COUPled[:STATe] ...............62
CALCul te:MARKer:FCOunt ....................63
CALCul te:MARKer:FCOunt:RESult? ................64
CALCul te:MARKer:FUNCtion ...................65
CALCul te:MARKer:FUNCtion:DDEMod:RESult? ..........66
CALCul te:MARKer:FUNCtion:RESult? ...............68
CALCul te:MARKer:FUNCtion:STATistics ..............69
CALCul te:MARKer:FUNCtion:STATistics:PPCT ...........70
CALCul te:MARKer:FUNCtion:STATistics:RESult? ..........71
CALCul te:MARKer:FUNCtion:STATistics:SMPL? ..........72
CALCul te:MARKer:MAXimum ...................73
CALCul te:MARKer:MAXimum:LEFT ................74
CALCul te:MARKer:MAXimum:NEXT ...............75
CALCul te:MARKer:MAXimum:RIGHt ...............76
CALCul te:MARKer:MAXimum:TRACk ...............77
CALCul te:MARKer:MINimum[:GLOB l] ..............78
CALCul te:MARKer:OFFSet[:STATe] ................79
CALCul te:MARKer:OFFSet:X ...................80
CALCul te:MARKer:OFFSet:Y ...................81
CALCul te:MARKer:OFFSet:Z ...................82
CALCul te:MARKer:OFFSet:ZERO .................83
CALCul te:MARKer:POL r:UNIT:POWer ..............84
CALCul te:MARKer:READout ...................85
CALCul te:MARKer:SEARch:BUFFer[:STATe] ............86
CALCul te:MARKer:SEARch:LEFT .................87
CALCul te:MARKer:SEARch:OFFSet ................88
CALCul te:MARKer:SEARch:RIGHt .................89
CALCul te:MARKer:SEARch:TARGet ................90
CALCul te:MARKer[:STATe] ....................91
CALCul te:MARKer:TRACe ....................92
CALCul te:MARKer:X[:ABSolute] .................93
CALCul te:MARKer:X:ACH nnel? .................94
CALCul te:MARKer:X:CCH nnel? .................95
CALCul te:MARKer:X:CLAYer? ..................96
CALCul te:MARKer:X:CST tus? ..................97
CALCul te:MARKer:X:REL tive? ..................98
CALCul te:MARKer:Y? ......................99
CALCul te:MARKer:Y:REL tive? .................100
CALCul te:MARKer:Z[:ABSolute] .................101
CALCul te:MARKer:Z:REL tive? ................. 103
CALCul te:MARKer:Z:UNIT ...................104
v

CALCul te:MATH:CONSt nt ...................105
CALCul te:MATH:CONSt nt:IMAG ................106
CALCul te:MATH:CONSt nt:MAG ................107
CALCul te:MATH:CONSt nt:PHASe ...............108
CALCul te:MATH:CONSt nt:REAL ................109
CALCul te:MATH:CONSt nt:STEP ................110
CALCul te:MATH[:EXPRession] .................111
CALCul te:MATH:SELect ....................112
CALCul te:MATH:STATe .....................113
CALCul te:STATe ........................114
CALCul te:UNIT:AM .......................115
CALCul te:UNIT:ANGLe .....................116
CALCul te:UNIT:FREQuency ...................117
CALCul te:UNIT:POWer .....................118
CALCul te:UNIT:TIME ......................119
CALCul te:UPH se:CREFerence .................120
CALCul te:UPH se:OFFSet ....................121
CALCul te:X:UNIT:CODE .....................122
CALCul te:X:UNIT:FREQuency ..................123
CALCul te:X:UNIT:POW .....................124
CALCul te:X:UNIT:TIME .....................125
CALibr tion:AUTO ........................126
CALibr tion:ZERO:AUTO .....................127
CONTinue ............................128
DISPl y:ANNot tion[:ALL] ....................129
DISPl y:BRIGhtness .......................130
DISPl y:CMAP:COLor:HSL ....................131
DISPl y:CMAP:DEF ult .....................132
DISPl y:ENABle .........................133
DISPl y:FORM t ........................134
DISPl y:MFUNction .......................135
DISPl y:PROGr m[:MODE] ...................136
DISPl y:TCAPture:ENVelope ...................137
DISPl y[:WINDow]:ACTive ....................138
DISPl y[:WINDow]:SPECtrogr m:COLors .............139
DISPl y[:WINDow]:SPECtrogr m:ENH nce ............140
DISPl y[:WINDow]:SPECtrogr m:MAP ..............141
DISPl y[:WINDow]:SPECtrogr m[:STATe] ............142
DISPl y[:WINDow]:SPECtrogr m:THReshold ...........143
DISPl y[:WINDow]:TRACe:BUFFer ................144
DISPl y[:WINDow]:TRACe:DCARrier ...............145
DISPl y[:WINDow]:TRACe:EYE:COUNt ..............146
DISPl y[:WINDow]:TRACe:GRATicule:GRID[:STATe] .......147
DISPl y[:WINDow]:TRACe:INDic tor ...............148
DISPl y[:WINDow]:TRACe:INDic tor:SIZE ............149
DISPl y[:WINDow]:TRACe:INFO .................150
DISPl y[:WINDow]:TRACe:LABel? ................151
DISPl y[:WINDow]:TRACe:LABel:AUTO .............152
DISPl y[:WINDow]:TRACe:LABel:USER .............153
DISPl y[:WINDow]:TRACe[:STATe] ...............154
DISPl y[:WINDow]:TRACe:SYMBol ...............155
DISPl y[:WINDow]:TRACe:SYMBol:FORM t ...........156
DISPl y[:WINDow]:TRACe:X[:SCALe]:AUTO ...........157
DISPl y[:WINDow]:TRACe:X[:SCALe]:LEFT ............158
DISPl y[:WINDow]:TRACe:X[:SCALe]:RIGHt ...........159
DISPl y[:WINDow]:TRACe:X[:SCALe]:RLEVel ...........160
DISPl y[:WINDow]:TRACe:X[:SCALe]:SPACing ..........161
DISPl y[:WINDow]:TRACe:Y:RLINe ...............162
DISPl y[:WINDow]:TRACe:Y[:SCALe]:AUTO ...........163
DISPl y[:WINDow]:TRACe:Y[:SCALe]:PDIVision ..........164
DISPl y[:WINDow]:TRACe:Y[:SCALe]:RLEVel ...........165
DISPl y[:WINDow]:TRACe:Y[:SCALe]:RLEVel:AUTO ........166
DISPl y[:WINDow]:TRACe:Y[:SCALe]:RPOSition .........167
DISPl y[:WINDow]:WATerf ll:AZIMuth ..............168
DISPl y[:WINDow]:WATerf ll:BLINe[:STATe] ...........169
DISPl y[:WINDow]:WATerf ll:ELEV tion .............170
DISPl y[:WINDow]:WATerf ll:HEIGht ..............171
DISPl y[:WINDow]:WATerf ll:HLINe[:STATe] ...........172
DISPl y[:WINDow]:WATerf ll[:STATe] ..............173
DISPl y[:WINDow]:WATerf ll:THReshold .............174
FORM t[:DATA] .........................175
HCOPy:ABORt .........................176
HCOPy:DATA? .........................177
HCOPy:DESTin tion .......................178
HCOPy:DEVice:CMAP:DEF ult ..................179
HCOPy:DEVice:COLor ......................180
HCOPy:DEVice:LANGu ge ....................181
HCOPy:DEVice:RESolution ....................182
HCOPy:DEVice:SPEed ......................183
HCOPy[:IMMedi te] .......................184
HCOPy:ITEM:ALL[:IMMedi te] ..................185
HCOPy:ITEM:ANNot tion:COLor .................186
HCOPy:ITEM:FFEed:STATe ...................187
HCOPy:ITEM:TDST mp:CFORm t ................188
HCOPy:ITEM:TDST mp:FORM t .................189
HCOPy:ITEM:TDST mp:STATe ..................190
Command Listing
vi

HCOPy:ITEM[:WINDow]:TRACe:COLor ..............191
HCOPy:ITEM[:WINDow]:TRACe:GRATicule:COLor .........192
HCOPy:ITEM[:WINDow]:TRACe:GRATicule[:IMMedi te] ......193
HCOPy:ITEM[:WINDow]:TRACe[:IMMedi te] ...........194
HCOPy:ITEM[:WINDow]:TRACe:LTYPe ..............195
HCOPy:ITEM[:WINDow]:TRACe:MARKer:COLor .........196
HCOPy:ITEM[:WINDow]:TRACe:MARKer[:IMMedi te] .......197
HCOPy:ITEM[:WINDow]:TRACe:MARKer:OFFSet[:IMMedi te] . . . 198
HCOPy:PAGE:DIMensions:AUTO .................199
HCOPy:PAGE:DIMensions:USER:LLEFt ..............200
HCOPy:PAGE:DIMensions:USER:URIGht .............201
HCOPy:PLOT:ADDRess .....................202
HCOPy:PRINt:ADDRess .....................203
INITi te:CONTinuous ......................204
INITi te[:IMMedi te] ......................205
INPut:COUPling .........................206
INPut:FILTer[:LPASs][:STATe] ..................207
INPut:IMPed nce ........................208
INPut[:STATe] .........................209
INSTrument:NSELect ......................210
INSTrument[:SELect] ......................211
MEMory:DELete[:NAME] ....................212
MEMory:MALLoc te:APPLic tion ................213
MEMory:MALLoc te:MEASurement:DEF ult ...........214
MEMory:MALLoc te:MEASurement:FPOints ...........215
MEMory:MALLoc te:MEASurement:MAXSp n ..........216
MEMory:MALLoc te:MEASurement:MSSR te ..........217
MEMory:MALLoc te:MEASurement:MTEMp ...........218
MEMory:MALLoc te:MEASurement:TPOints ...........219
MEMory:MALLoc te:PROGr m .................220
MMEMory:COPY ........................221
MMEMory:DATA ........................222
MMEMory:DELete ........................223
MMEMory:FSYStem? ......................224
MMEMory:INITi lize .......................225
MMEMory:LOAD:APPLic tion ..................227
MMEMory:LOAD:CONTinue ...................228
MMEMory:LOAD:MATH .....................229
MMEMory:LOAD:PROGr m ...................230
MMEMory:LOAD:STATe .....................231
MMEMory:LOAD:TCAPture ...................232
MMEMory:LOAD:TRACe .....................233
MMEMory:LOAD:TRACe:BUFFer .................234
MMEMory:MOVE ........................235
MMEMory:MSIS ........................ 236
MMEMory:NAME ........................237
MMEMory:STORe:CONTinue ..................239
MMEMory:STORe:MATH ....................240
MMEMory:STORe:PROGr m .................. 241
MMEMory:STORe:STATe ....................242
MMEMory:STORe:TCAPture ...................243
MMEMory:STORe:TRACe ....................244
MMEMory:STORe:TRACe:BUFFer ................245
OUTPut:FILTer[:LPASs][:STATe] .................246
OUTPut:IMPed nce .......................247
OUTPut[:STATe] ........................248
PAUSe .............................249
PROGr m:EXPLicit:DEFine ....................250
PROGr m[:SELected]:DEFine ...................251
PROGr m[:SELected]:DELete:ALL ................ 252
PROGr m[:SELected]:DELete[:SELected] .............253
PROGr m[:SELected]:MALLoc te ................ 254
PROGr m[:SELected]:NAME ...................255
PROGr m[:SELected]:NUMBer ..................256
PROGr m[:SELected]:STATe ...................258
PROGr m[:SELected]:STRing ..................259
ROUTe:RECeiver ........................260
SCReen:CONTents .......................261
[SENSe:]AVER ge:COUNt .................... 262
[SENSe:]AVER ge:COUNt:INTermedi te? ............ 263
[SENSe:]AVER ge:IRESult:RATE ................. 264
[SENSe:]AVER ge:IRESult[:STATe] ................265
[SENSe:]AVER ge[:STATe] ...................266
[SENSe:]AVER ge:TCONtrol ................... 267
[SENSe:]AVER ge:TYPE .....................268
[SENSe:]BANDwidth:MODE:ARBitr ry ..............269
[SENSe:]BANDwidth[:RESolution] ................270
[SENSe:]BANDwidth[:RESolution]:AUTO .............271
[SENSe:]BANDwidth[:RESolution]:AUTO:OFFSet .........272
[SENSe:]CORRection:EDEL y[:TIME] ...............273
[SENSe:]CORRection:EXTern l[:STATe] ..............274
[SENSe:]CORRection:FILTer:XTIMe:STATe ............275
[SENSe:]CORRection:IMPed nce[:INPut][:MAGNitude] ......276
[SENSe:]CORRection:LOSS[:INPut]:MAGNitude ..........277
[SENSe:]CORRection:OFFS ....................278
[SENSe:]DATA .........................279
Command Listing
vii

[SENSe:]DATA:HEADer:POINts? .................280
[SENSe:]DDEMod:ADAPt ....................281
[SENSe:]DDEMod:CLOCk ....................282
[SENSe:]DDEMod:CNVRg ....................283
[SENSe:]DDEMod:CRATe ....................284
[SENSe:]DDEMod:DVBQ m:NST te ...............285
[SENSe:]DDEMod:EDGE .....................286
[SENSe:]DDEMod:EQFLen ....................287
[SENSe:]DDEMod:EQRE .....................288
[SENSe:]DDEMod:EQU lize ...................289
[SENSe:]DDEMod:FILTer:ALPH .................290
[SENSe:]DDEMod:FILTer:MEASurement .............291
[SENSe:]DDEMod:FILTer:MEASurement:USER:FEED .......292
[SENSe:]DDEMod:FILTer:REFerence ...............293
[SENSe:]DDEMod:FILTer:REFerence:USER:FEED .........294
[SENSe:]DDEMod:FORM t ....................295
[SENSe:]DDEMod:FREQuency:MIRRor ..............296
[SENSe:]DDEMod:FSK:NST te ..................297
[SENSe:]DDEMod:LCODe ....................298
[SENSe:]DDEMod:LCODe:GROup .................299
[SENSe:]DDEMod:LCODe:MODE .................300
[SENSe:]DDEMod:MLENgth ...................301
[SENSe:]DDEMod:MSK:FORM t .................302
[SENSe:]DDEMod:NORM lize ..................303
[SENSe:]DDEMod:PRATe ....................304
[SENSe:]DDEMod:PRESet ....................305
[SENSe:]DDEMod:PSK:NST te ..................306
[SENSe:]DDEMod:QAM:NST te .................307
[SENSe:]DDEMod:QPSK:FORM t .................308
[SENSe:]DDEMod:SEARch:PULSe:STATe .............309
[SENSe:]DDEMod:SEARch:SYNC:OFFSet .............310
[SENSe:]DDEMod:SEARch:SYNC:PATTern ............311
[SENSe:]DDEMod:SEARch:SYNC:STATe .............312
[SENSe:]DDEMod:SEARch:TIME .................313
[SENSe:]DDEMod:SELect ....................314
[SENSe:]DDEMod:SRATe ....................315
[SENSe:]DDEMod:TIME .....................316
[SENSe:]DDEMod:TIME:CCH nnel ................317
[SENSe:]DDEMod:TIME:CLAYer .................318
[SENSe:]DDEMod:TIME:GATE:DEL y ...............319
[SENSe:]DDEMod:TIME:GATE[:SPAN] ..............320
[SENSe:]DDEMod:TIME:GATE:STATe ...............321
[SENSe:]DDEMod:VSB:NST te ..................322
[SENSe:]DDEMod:WCDM :FILTer:ALPH .............323
[SENSe:]DEMod .........................324
[SENSe:]DEMod:CARRier:AUTO .................325
[SENSe:]DEMod:CARRier:AUTO:PM ...............326
[SENSe:]DEMod:CARRier:FREQ? .................327
[SENSe:]DETector[:FUNCtion] ..................328
[SENSe:]FEED ..........................329
[SENSe:]FREQuency:BASeb nd .................330
[SENSe:]FREQuency:CENTer ...................331
[SENSe:]FREQuency:CENTer:TRACk ...............332
[SENSe:]FREQuency:EXTern l:BANDwidth ............333
[SENSe:]FREQuency:EXTern l:CENTer ..............334
[SENSe:]FREQuency:EXTern l:COMMunic te ...........335
[SENSe:]FREQuency:EXTern l:COMMunic te:ADDRess ......336
[SENSe:]FREQuency:EXTern l:MAXimum .............337
[SENSe:]FREQuency:EXTern l:MINimum .............338
[SENSe:]FREQuency:EXTern l:MIRRor ..............339
[SENSe:]FREQuency:MANu l ..................340
[SENSe:]FREQuency:SPAN ....................341
[SENSe:]FREQuency:SPAN:FULL .................342
[SENSe:]FREQuency:SPAN:PCHirp ................343
[SENSe:]FREQuency:SPAN:WIDE ................344
[SENSe:]FREQuency:STARt ...................345
[SENSe:]FREQuency:STEP:AUTO .................346
[SENSe:]FREQuency:STEP[:INCRement] .............347
[SENSe:]FREQuency:STOP ....................348
[SENSe:]SWEep:MODE .....................349
[SENSe:]SWEep:OVERl p ....................350
[SENSe:]SWEep:POINts .....................351
[SENSe:]SWEep:TIME:DEL y ..................352
[SENSe:]SWEep:TIME:GATE:DEL y ...............353
[SENSe:]SWEep:TIME:GATE:DEL y:STEP[:INCRement] ......354
[SENSe:]SWEep:TIME:GATE[:SPAN] ...............355
[SENSe:]SWEep:TIME:GATE:STATe ...............356
[SENSe:]SWEep:TIME:OVERl p .................357
[SENSe:]SWEep:TIME:RESolution:AUTO .............358
[SENSe:]SWEep:TIME[:SPAN] ..................359
[SENSe:]TCAPture:ABORt ....................360
[SENSe:]TCAPture:DIRection ..................361
[SENSe:]TCAPture[:IMMedi te] .................362
[SENSe:]TCAPture:LENGth ...................363
[SENSe:]TCAPture:POSition? ..................364
[SENSe:]TCAPture:RANGe ....................365
Command Listing
viii

[SENSe:]TCAPture:STARt ....................366
[SENSe:]TCAPture:STOP .....................367
[SENSe:]VOLT ge[:DC]:RANGe:AUTO ..............368
[SENSe:]VOLT ge[:DC]:RANGe:AUTO:DIRection .........369
[SENSe:]VOLT ge[:DC]:RANGe:UNIT:VOLT ge ..........370
[SENSe:]VOLT ge[:DC]:RANGe[:UPPer] ..............371
[SENSe:]VOLT ge:PROTection:CLE r ...............372
[SENSe:]WINDow:GATE .....................373
[SENSe:]WINDow:GATE:COUPling ................374
[SENSe:]WINDow[:TYPE] ....................375
SOURce:FREQuency[:CW] ....................376
SOURce:FREQuency:OFFSet ...................377
SOURce:FUNCtion[:SHAPe] ...................378
SOURce:FUNCtion:USER:FEED ..................379
SOURce:IFINput:STATe .....................380
SOURce:RF ...........................381
SOURce:USER:REPe t ......................382
SOURce:VOLT ge[:LEVel][:IMMedi te][:AMPLitude] ........383
SOURce:VOLT ge[:LEVel][:IMMedi te]:OFFSet ..........385
SOURce:VOLT ge[:LEVel]:UNIT:VOLT ge .............386
SOURce:VOLT ge:PROTection:CLE r ...............387
STATus:DEVice:CONDition? ...................388
STATus:DEVice:ENABle .....................389
STATus:DEVice[:EVENt]? ....................390
STATus:DEVice:NTR nsition ...................391
STATus:DEVice:PTR nsition ...................392
STATus:OPER tion:CONDition? .................393
STATus:OPER tion:ENABle ...................394
STATus:OPER tion[:EVENt]? ...................395
STATus:OPER tion:NTR nsition .................396
STATus:OPER tion:PTR nsition .................397
STATus:PRESet .........................398
STATus:QUEStion ble:CONDition? ................399
STATus:QUEStion ble:ENABle ..................400
STATus:QUEStion ble[:EVENt]? .................401
STATus:QUEStion ble:FREQuency:CONDition? ..........402
STATus:QUEStion ble:FREQuency:ENABle ............403
STATus:QUEStion ble:FREQuency[:EVENt]? ...........404
STATus:QUEStion ble:FREQuency:NTR nsition ..........405
STATus:QUEStion ble:FREQuency:PTR nsition ..........406
STATus:QUEStion ble:MODul tion:CONDition? ..........407
STATus:QUEStion ble:MODul tion:ENABle ............408
STATus:QUEStion ble:MODul tion[:EVENt]? ...........409
STATus:QUEStion ble:MODul tion:NTR nsition ..........410
STATus:QUEStion ble:MODul tion:PTR nsition .......... 411
STATus:QUEStion ble:NTR nsition ................412
STATus:QUEStion ble:PTR nsition ................413
STATus:QUEStion ble:VOLT ge:CONDition? ........... 414
STATus:QUEStion ble:VOLT ge:ENABle ............. 415
STATus:QUEStion ble:VOLT ge[:EVENt]? ............416
STATus:QUEStion ble:VOLT ge:NTR nsition ........... 417
STATus:QUEStion ble:VOLT ge:PTR nsition ........... 418
STATus:USER:ENABle ......................419
STATus:USER[:EVENt]? .....................420
STATus:USER:PULSe ......................421
SYSTem:BEEPer:STATe .....................422
SYSTem:COMMunic te:GPIB:ADDRess ............. 423
SYSTem:COMMunic te:LAN:EADDress? ............. 424
SYSTem:COMMunic te:LAN:IPADdress ............. 425
SYSTem:COMMunic te:LAN:PORT ................ 426
SYSTem:COMMunic te:LAN:ROUTe:GATew y ..........427
SYSTem:COMMunic te:LAN:ROUTe:SMASk ...........428
SYSTem:COMMunic te:LAN:STATe ............... 429
SYSTem:COMMunic te:LAN:XWINdow:HOSTn me ........430
SYSTem:COMMunic te:LAN:XWINdow:RATE ..........431
SYSTem:COMMunic te:LAN:XWINdow[:STATe] ......... 432
SYSTem:COMMunic te:SERi l:CONTrol:DTR ...........433
SYSTem:COMMunic te:SERi l[:RECeive]:BAUD ..........434
SYSTem:COMMunic te:SERi l[:RECeive]:PACE ..........435
SYSTem:COMMunic te:SERi l[:RECeive]:PARity[:TYPE] ......436
SYSTem:DATE .........................437
SYSTem:ERRor? ........................438
SYSTem:GPIB:ECHO ......................439
SYSTem:KEY ..........................440
SYSTem:KLOCk .........................442
SYSTem:PRESet ........................443
SYSTem:TIME .........................444
TRACe:BUFFer:COPY ......................445
TRACe:COPY ..........................446
TRACe[:DATA] .........................447
TRACe[:DATA]:HEADer:POINts? .................449
TRACe:X[:DATA]? ........................450
TRACe:X:UNIT? .........................451
TRIGger:HOLDoff:DEL y ..................... 452
TRIGger:HOLDoff:STATe ....................453
TRIGger:LEVel .........................454
Command Listing
ix

TRIGger:SLOPe .........................455
TRIGger:SOURce ........................456
Command Listing
x

1
GPIB Programming with
Agilent 89400-Series Analyzers
1

Introduction to GPIB Programming
For an intro uction to GPIB programming, rea the GPIB Programmer’s Guide. It is provi e to
help those not familiar with GPIB programming or remote control of an instrument. The book
intro uces the basic concepts of GPIB programming an escribes the Stan ar Comman s for
Programmable Instruments (SCPI). It also escribes how to operate an instrument in an GPIB
system an how to transfer ata between an external controller an an instrument.
In This Book
This is the GPIB Command Reference for the Agilent 89400-Series Vector Signal Analyzer. It
contains the comman syntax, structure, an a etaile escription of each GPIB comman
available for the Agilent 89400-Series analyzers.
Chapter 1 presents GPIB programming information specific to the analyzer:
How to connect the analyzer to an external controller and verify that it wor s.
A description of the analyzer’s status registers.
Chapter 2 escribes the SCPI instrument mo el.
Chapter 3 is the comman reference. It contains a etaile escription of each GPIB comman .
The comman s are organize alphabetically.
Appen ix A iscusses SCPI error messaging an lists error messages reporte by this instrument.
Appen ix B is an example program listing which emonstrates the sockets feature of option UFG.
Also, a car containing a comman quick-reference is inclu e .
Note Most front-panel ey presses that change the configuration or initiate an action
correspond to one SCPI command but some require more than one (see
[SENSe:]AVERage:TYPE). To display the SCPI command strings that correspond
to front-panel eys, activate the SCPI command echo by pressing [ Local/Setup ],
[SCPI cmd echo on ] or sending “SYST:GPIB:ECHO 1”. Subsequent SCPI command
strings are displayed in the upper-lefthand corner of the display.
Introduction to GPIB Programming
2

GPIB Setup and Verification
This section contains a proce ure for configuring the Agilent 89400-Series Vector Signal Analyzer
an an external controller in a simple GPIB system. Although an HP 9000 Series 340 computer is
use in this proce ure example, other computers that support an GPIB interface can be use . If
you are using a computer other than the Series 340, the configuration proce ure shoul be use
as a general gui e. Consult your computer’s ocumentation for more complete information.
Equipment and Software Required
Agilent 89400-Series Vector Signal Analyzer
HP 9000 Series 340 computer
GPIB cable (Agilent 10833A, B, C or D)
Agilent Technologies BASIC programming language
Procedure
1. Turn off the analyzer and the HP 9000 Series 340
2. Connect them with the GPIB cable.
3. Turn on the computer. If necessary, load BASIC. Note that the following language
extensions must be installed for the verification program to wor :
CRTA
HPIB
IO
EDIT
Programs that are more complex than the verification program may require more language
extensions. For a complete list of loaded language extensions, execute the BASIC
command:
LIST BIN
4. Turn on the analyzer. When the startup processes are complete, press the [Local/Setup]
hard ey.
5. Verify that the analyzer’s address is set to 19. The current address setting is displayed in the
[n lyzer drs] soft ey. You can change the address by pressing the [ n lyzer drs] soft ey, entering
the number using the numeric eypad, and then pressing the [enter] soft ey. Instructions in
the verification procedure assume that the analyzer address is set to 19.
6. Verify that the analyzer is set to the addressable-only mode. The soft ey labels that appear
when you press the [Local /Setup] hard ey include [system controller] and [ ddress ble only]. Only one of
these two soft eys can be selected at a time, and the one that is selected is highlighted with
yellow text. If [ ddress ble only] is not selected, then press its soft ey.
7. Type REMOTE 719 on the computer and press Enter. The Remote indicator (near the
[Local/Setup] hard ey) should light up. This indicates that the analyzer is in remote control.
GPIB Setup and Verification
3

GPIB Interface apabilities
The Agilent 89400A-Series analyzers have the following interface capabilities, as efine by the
IEEE 488.1 stan ar :
SH1 full Source handshake capability
AH1 full Acceptor handshake capability
T6 basic Talker, Serial Poll, no Talk Only, unaddress if MLA
TE no Extended Talker capability
L4 basic Listener, no Listen Only, unaddress if MTA
LE no Extended Listener capability
SR1 full Service Request capability
RL1 full Remote/Local capability
PP ** no Parallel Poll capability
PP1* Parallel Poll capability
DC1 full Device Clear capability
DT1 full Device Trigger capability
C1 System Controller capability
C2 send IFC and take charge Controller capability
C3 send REN Controller capability
C4* respond to SRQ
C6* send IFC, receive control, pass control, parallel poll, pass control to
self
C1 * send IFC, receive control, pass control, parallel poll
C12** send IF messages, receive control, pass control
E2 tri-state drivers
* only when an Instrument BASIC program is running
** only when an Instrument BASIC program is not running
GPIB Interface Capabilities
4

General Status Register Model
Overview
The general status register mo el, shown in figure 1, is the buil ing block of the analyzer’s status
system. Most register sets in the analyzer inclu e all of the registers shown in the general mo el,
although comman s are not always available for rea ing or writing a particular register. The
information transfer within a register set starts at the con ition register an en s at the register
summary bit (see figure 2). The information is controlle by altering bits in the transition an
enable registers.
Figure 1. General Model of a Status Register Group
When a status group is implemente in a SCPI instrument, it always contains all of the component
registers. There is not always a correspon ing comman to rea or write every register, however.
The flow within a status group starts at the con ition register an en s at the register summary
bit as shown in figure 2. You control the flow by setting the bit patterns in the transition an
enable registers.
Figure 2. Flow of Information Within a Register Set
General Status Register Model
5

ondition Register
Con ition registers continuously monitor har ware an firmware status. They represent the
current state of the instrument. Bits in a con ition register are not latche or buffere . They are
up ate in real time. When the con ition monitore by a particular bit becomes true, the bit is set
to 1. When the con ition becomes false, the bit is reset to 0. Con ition registers are rea -only.
Transition Registers
Transition registers control the reporting of con ition changes to the event registers. They
specify which types of changes in the con ition register set correspon ing bits in the event
register. Transition registers are rea -write.
Transition register bits may be configure to signal positive changes, negative changes, or both.
Positive changes in the state of a con ition bit (0 to 1) are reporte to the event register if the
correspon ing positive transition bit is set to 1. Negative changes in the state of a con ition bit (1
to 0) are reporte to the event register if the correspon ing negative transition bit is set to 1. If
you set both transition bits to 1, positive an negative changes are reporte to the correspon ing
event bit.
Transition registers are not affecte by *CLS (clear status) or queries. They are set to efault
values when power is turne on an after receiving *RST. Some registers have a fixe setting if
there are no comman s to access a particular transition register. This fixe setting, along with
epen ent values, are specifie in the GPIB Command Reference.
Event Register
Event registers latch any reporte con ition changes. When a transition bit allows a con ition
change to be reporte , the correspon ing event bit is set to 1. Once set, an event bit is no longer
affecte by con ition changes. It remains set until the event register is cleare — either when you
rea the register or when you sen the *CLS (clear status) comman . Event registers are
rea -only.
Notes Reading the Event Register, clears the Event Register.
All event registers are cleared by the *CLS command.
General Status Register Model
6

Enable Register
Enable registers control the reporting of events (which are latche con ition register information)
to the register summary bit. If an enable bit is set to one, the correspon ing event bit is inclu e
in the logical ORing process that etermines the state of the summary bit. (The summary bit is
only set to 1 if one or more enable event bits are set to 1.) You can rea an write all enable
registers.
Enable registers are cleare by the *CLS (clear status) comman . Querying enable registers oes
not affect them. All enable registers have comman s to rea an write them.
An Example Sequence
The example illustrate in figure 3 presents four ifferent cases, as efine by the settings in the
leftmost block; each row contains a slightly ifferent variation of the sequence as efine by the
settings of the transition an enable registers. The changing state of the con ition in question is
shown at the bottom of the figure. A small binary table shows the state of the chosen bit in each
status register at selecte times (T1–T5). There are two ‘’events’’ or changes in the con ition
being monitore that cause register values to change. There are also three rea s of the event
register (in icate with asterisks), which clear it.
Figure 3. Example Sequence
In cases A an D, when the enable bit is zero, the summary bit cannot be set, regar less of the
transition register settings, an no service request is ma e. When the enable bit is one, the
summary bit is set when the transition occurs for which the correspon ing transition register is
configure to report.
General Status Register Model
7

How to Use Registers
There are two metho s you can use to access the information in status registers:
The polling method.
The service request (SRQ) method.
In the polling metho , the analyzer has a passive role. It only tells the controller that con itions
have change when the controller asks the right question. In the SRQ metho , the analyzer takes
a more active role. It tells the controller when there has been a con ition change without the
controller asking. Either metho allows you to monitor one or more con itions.
The polling metho works well if you o not nee to know about changes the moment they occur.
The SRQ metho shoul be use if you must know imme iately when a con ition changes. To
etect a change using the polling metho , the program must repeate ly rea the registers.
Use the SRQ metho when:
–you need time-critical notification of changes
–you are monitoring more than one device which supports SRQs
–you need to do have the controller do something else while waiting
–you can’t afford the performance penalty inherent to polling
Use polling when:
–your language/development environment does not support SRQ interrupts
–you want to write a simple, single-purpose program and don’t want the added complexity
of setting up an SRQ handler.
To monitor a con ition:
1. Determine which register contains the bit that reports the condition.
2. Send the unique GPIB query that reads that register.
3. Examine the bit to see if the condition has changed.
General Status Register Model
8

The Service Request Process
When you monitor a con ition with the SRQ metho , you must:
1. Determine which bit monitors the condition.
2. Determine how that bit reports to the request service (RQS) bit of the Status Byte.
3. Send GPIB commands to enable the bit that monitors the condition and to enable the
summary bits that report the condition to the RQS bit.
4. Enable the controller to respond to service requests.
When the con ition changes, the analyzer sets its RQS bit an the GPIB’s SRQ line. The controller
is informe of the change as soon as it occurs. The time the controller woul otherwise have use
to monitor the con ition can now be use to perform other tasks. Your program etermines how
the controller respon s to the SRQ.
Generating a Service Request
To use the SRQ metho , you must un erstan how service requests are generate . As shown in
figure 4, other register sets in the analyzer report to the Status Byte. Most of them report irectly,
but three report in irectly—via the Questionable Status register set (see figure 5).
Figure 4. Generating a Service Request
Bit 6 of the Status Byte serves two functions; the request service function (RQS) an the master
summary status function (MSS). The RQS bit is set whenever something (that it is configure to
report) changes an is cleare when the status byte is rea (with a serial poll). The MSS bit is set
in the same way as the RQS bit, but it clears only when the con ition that set it is cleare . The
MSS bit is rea with *STB?.
The Service Request Process
9

When a register set causes its summary bit in the Status Byte to change from 0 to 1, the analyzer
can initiate the service request (SRQ) process. However, the process is only initiate if both of
the following con itions are true:
The corresponding bit of the Service Request Enable register is also set to 1.
The analyzer does not have a service request pending. (A service request is considered to be
pending between the time the analyzer’s SRQ process is initiated and the time the controller
reads the Status Byte register with a serial poll.)
The SRQ process sets the GPIB’s SRQ line true. It also sets the Status Byte’s request service
(RQS) bit to 1. Both actions are necessary to inform the controller the analyzer requires service.
Setting the SRQ line only informs the controller that some evice on the bus requires service.
Setting the RQS bit allows the controller to etermine that the Agilent 89400-series analyzer, in
particular, requires service.
If your program enables the controller to etect an respon to service requests, it shoul instruct
the controller to perform a serial poll when the GPIB’s SRQ line is set true. Each evice on the
bus returns the contents of its Status Byte register in response to this poll. The evice whose
RQS bit is set to 1 is the evice that requeste service.
Notes When you read the analyzer’s Status Byte with a serial poll, the RQS bit is reset to
0. Other bits in the register are not affected.
Restarting a measurement (INIT) can cause the measuring bit to pulse low,
which causes an SRQ if the status register is configured to SRQ on
end-of-measurement. To avoid this:
1. INIT:CONT OFF
2. Set/enable status registers
3. Restart measurement (send INIT)
The Service Request Process
10