Copper mountain Planar TR5048 Owner's manual









PlanarTR1300/1,TR5048andTR7530

VectorNetworkAnalyzer

ProgrammingManualSCPI








Oct,2015

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
TABLEOFCONTENTS
1Introduction....................................................................................................................................8
1.1 ProgrammingManualScope.................................................................................................... 8
1.2 RelatedDocuments .................................................................................................................. 8
1.3 References ................................................................................................................................ 8
2AnalyzerInterfaces.........................................................................................................................9
2.1 EthernetInterface .................................................................................................................... 9
3ControlComputer ........................................................................................................................10
3.1 SoftwareRequirements.......................................................................................................... 10
4SCPIOverview..............................................................................................................................10
4.1 CommandTree....................................................................................................................... 10
4.2 Subsystems............................................................................................................................. 11
4.3 OptionalSubsystems ............................................................................................................. 12
4.4 LongandShortFormats......................................................................................................... 12
4.5 CaseSensitivity....................................................................................................................... 12
4.6 Parameters ............................................................................................................................. 12
4.6.1 NumericValues.................................................................................................................. 13
4.6.1.1 MultiplierPrefixes ......................................................................................................... 13
4.6.1.2 Notations....................................................................................................................... 14
4.6.2 Booleans ............................................................................................................................ 14
4.6.3 CharacterData................................................................................................................... 14
4.6.4 StringParameters.............................................................................................................. 15
4.6.5 NumericLists ..................................................................................................................... 15
4.7 QueryCommands................................................................................................................... 16
4.8 NumericSuffixes .................................................................................................................... 16
4.9 CompoundCommands........................................................................................................... 16
4.10 IEEE488.2CommonCommandsOverview....................................................................... 17
4.11 StringTerminator .............................................................................................................. 17
5RemoteControlCommands ........................................................................................................18
5.1 Conventions............................................................................................................................ 18
5.1.1 Syntax ................................................................................................................................18
5.1.2 Identifiers ........................................................................................................................... 19
5.2 IEEE488.2CommonCommands ............................................................................................ 20
*CLS ............................................................................................................................................ 20
*ESE ............................................................................................................................................ 20
*ESR?........................................................................................................................................... 21
*IDN?........................................................................................................................................... 21
*OPC ........................................................................................................................................... 21
*OPC?.......................................................................................................................................... 22
*RST ............................................................................................................................................ 22
*SRE ............................................................................................................................................ 23
*STB?........................................................................................................................................... 23
*TRG............................................................................................................................................ 24
*WAI............................................................................................................................................ 24
5.3 NetworkAnalyzerCommands ............................................................................................... 25
ABOR ........................................................................................................................................... 25
CALC:CONV ................................................................................................................................25
CALC:CONV:FUNC...................................................................................................................... 26
CALC:CORR:EDEL:TIME ............................................................................................................. 27
CALC:CORR:OFFS:PHAS ............................................................................................................ 27
CALC:DATA:FDAT?..................................................................................................................... 28
CALC:DATA:FMEM? ................................................................................................................... 29
CALC:DATA:SDAT?..................................................................................................................... 30
CALC:DATA:SMEM? ................................................................................................................... 31
CALC:FILT:TIME.......................................................................................................................... 32
CALC:FILT:TIME:CENT ............................................................................................................... 33

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
3
CALC:FILT:TIME:SHAP ............................................................................................................... 34
CALC:FILT:TIME:SPAN ............................................................................................................... 35
CALC:FILT:TIME:STAR................................................................................................................ 36
CALC:FILT:TIME:STAT................................................................................................................ 36
CALC:FILT:TIME:STOP ............................................................................................................... 37
CALC:FORM ................................................................................................................................38
CALC:FSIM:SEND:DEEM:PORT:STAT ....................................................................................... 39
CALC:FSIM:SEND:DEEM:PORT:USER:FIL................................................................................. 39
CALC:FSIM:SEND:PMC:PORT:STAT.......................................................................................... 40
CALC:FSIM:SEND:PMC:PORT:USER:FIL ................................................................................... 40
CALC:FSIM:SEND:ZCON:PORT:Z0 ............................................................................................ 41
CALC:FSIM:SEND:ZCON:STAT .................................................................................................. 41
CALC:FUNC:DATA? .................................................................................................................... 42
CALC:FUNC:DOM ....................................................................................................................... 43
CALC:FUNC:DOM:COUP............................................................................................................ 44
CALC:FUNC:DOM:STAR............................................................................................................. 45
CALC:FUNC:DOM:STOP............................................................................................................. 46
CALC:FUNC:EXEC....................................................................................................................... 47
CALC:FUNC:PEXC....................................................................................................................... 47
CALC:FUNC:POIN? ..................................................................................................................... 48
CALC:FUNC:PPOL....................................................................................................................... 48
CALC:FUNC:TARG ...................................................................................................................... 49
CALC:FUNC:TTR ......................................................................................................................... 50
CALC:FUNC:TYPE ....................................................................................................................... 51
CALC:LIM..................................................................................................................................... 52
CALC:LIM:DATA.......................................................................................................................... 53
CALC:LIM:DISP ........................................................................................................................... 54
CALC:LIM:FAIL? .......................................................................................................................... 54
CALC:LIM:OFFS:AMPL ............................................................................................................... 55
CALC:LIM:OFFS:STIM................................................................................................................. 56
CALC:LIM:REP:ALL? ................................................................................................................... 57
CALC:LIM:REP:POIN? ................................................................................................................. 58
CALC:LIM:REP?........................................................................................................................... 58
CALC:MARK ................................................................................................................................59
CALC:MARK:ACT ........................................................................................................................ 60
CALC:MARK:BWID...................................................................................................................... 60
CALC:MARK:BWID:DATA? ......................................................................................................... 61
CALC:MARK:BWID:REF .............................................................................................................. 62
CALC:MARK:BWID:THR.............................................................................................................. 63
CALC:MARK:BWID:TYPE............................................................................................................ 64
CALC:MARK:COUN..................................................................................................................... 65
CALC:MARK:COUP ..................................................................................................................... 65
CALC:MARK:FUNC:DOM............................................................................................................ 66
CALC:MARK:FUNC:DOM:STAR ................................................................................................. 67
CALC:MARK:FUNC:DOM:STOP ................................................................................................. 68
CALC:MARK:FUNC:EXEC ........................................................................................................... 69
CALC:MARK:FUNC:PEXC ........................................................................................................... 70
CALC:MARK:FUNC:PPOL........................................................................................................... 71
CALC:MARK:FUNC:TARG........................................................................................................... 72
CALC:MARK:FUNC:TRAC ........................................................................................................... 72
CALC:MARK:FUNC:TTR.............................................................................................................. 73
CALC:MARK:FUNC:TYPE ........................................................................................................... 74
CALC:MARK:REF......................................................................................................................... 75
CALC:MARK:SET......................................................................................................................... 76
CALC:MARK:X............................................................................................................................. 77
CALC:MARK:Y? ........................................................................................................................... 78
CALC:MATH:FUNC ..................................................................................................................... 79

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
4
CALC:MATH:MEM ...................................................................................................................... 80
CALC:MST ................................................................................................................................... 80
CALC:MST:DATA?....................................................................................................................... 81
CALC:MST:DOM ......................................................................................................................... 81
CALC:MST:DOM:STAR............................................................................................................... 82
CALC:MST:DOM:STOP............................................................................................................... 82
CALC:PAR:COUN........................................................................................................................ 83
CALC:PAR:DEF............................................................................................................................ 84
CALC:PAR:SEL ............................................................................................................................ 85
CALC:PAR:SPOR......................................................................................................................... 85
CALC:RLIM .................................................................................................................................. 86
CALC:RLIM:DATA ....................................................................................................................... 87
CALC:RLIM:DISP:LINE................................................................................................................ 88
CALC:RLIM:FAIL?........................................................................................................................ 89
CALC:RLIM:REP?......................................................................................................................... 90
CALC:SMO .................................................................................................................................. 91
CALC:SMO:APER ........................................................................................................................ 91
CALC:TRAC:DATA:FDAT? .......................................................................................................... 92
CALC:TRAC:DATA:FMEM? ......................................................................................................... 93
CALC:TRAC:DATA:SDAT? .......................................................................................................... 94
CALC:TRAC:DATA:SMEM?......................................................................................................... 95
CALC:TRAN:TIME ....................................................................................................................... 96
CALC:TRAN:TIME:CENT............................................................................................................. 97
CALC:TRAN:TIME:IMP:WIDT ..................................................................................................... 98
CALC:TRAN:TIME:KBES ............................................................................................................. 99
CALC:TRAN:TIME:LPFR.............................................................................................................. 99
CALC:TRAN:TIME:SPAN........................................................................................................... 100
CALC:TRAN:TIME:STAR........................................................................................................... 101
CALC:TRAN:TIME:STAT ........................................................................................................... 101
CALC:TRAN:TIME:STEP:RTIM.................................................................................................. 102
CALC:TRAN:TIME:STIM............................................................................................................ 103
CALC:TRAN:TIME:STOP........................................................................................................... 104
DISP:COL:BACK ........................................................................................................................ 105
DISP:COL:GRAT........................................................................................................................ 106
DISP:COL:RES........................................................................................................................... 106
DISP:COL:TRAC:DATA ............................................................................................................. 107
DISP:COL:TRAC:MEM .............................................................................................................. 108
DISP:FSIG .................................................................................................................................. 109
DISP:IMAG................................................................................................................................. 109
SYST:HIDE................................................................................................................................. 110
DISP:MAX.................................................................................................................................. 110
SYSTem:SHOW......................................................................................................................... 110
DISP:SPL ................................................................................................................................... 111
DISP:WIND:ACT ........................................................................................................................ 112
DISP:WIND:ANN:MARK:ALIG .................................................................................................. 113
DISP:WIND:ANN:MARK:SING.................................................................................................. 114
DISP:WIND:MAX....................................................................................................................... 114
DISP:WIND:SPL......................................................................................................................... 115
DISP:WIND:TITL........................................................................................................................ 116
DISP:WIND:TITL:DATA............................................................................................................. 116
DISP:WIND:TRAC:ANN:MARK:POS:X ..................................................................................... 117
DISP:WIND:TRAC:ANN:MARK:POS:Y ..................................................................................... 118
DISP:WIND:TRAC:Y:AUTO....................................................................................................... 119
DISP:WIND:TRAC:Y:PDIV......................................................................................................... 119
DISP:WIND:TRAC:Y:RLEV ........................................................................................................ 120
DISP:WIND:TRAC:Y:RPOS ....................................................................................................... 121
DISP:WIND:Y:DIV...................................................................................................................... 122

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
5
FORM:BORD ............................................................................................................................. 123
FORM:DATA.............................................................................................................................. 124
HCOP ......................................................................................................................................... 125
HCOP:ABOR.............................................................................................................................. 125
HCOP:DATE:STAM ................................................................................................................... 125
HCOP:IMAG............................................................................................................................... 126
HCOP:PAIN ............................................................................................................................... 126
INIT ............................................................................................................................................ 127
INIT:CONT................................................................................................................................. 128
MMEM:COPY ............................................................................................................................ 128
MMEM:DEL ............................................................................................................................... 129
MMEM:LOAD............................................................................................................................ 129
MMEM:LOAD:CHAN................................................................................................................. 130
MMEM:LOAD:CKIT ................................................................................................................... 130
MMEM:LOAD:LIM..................................................................................................................... 131
MMEM:LOAD:RLIM .................................................................................................................. 132
MMEM:LOAD:SEGM................................................................................................................. 132
MMEM:MDIR............................................................................................................................. 133
MMEM:STOR ............................................................................................................................ 133
MMEM:STOR:CHAN ................................................................................................................. 133
MMEM:STOR:CHAN:CLE.......................................................................................................... 134
MMEM:STOR:CKIT ................................................................................................................... 134
MMEM:STOR:FDAT .................................................................................................................. 134
MMEM:STOR:IMAG .................................................................................................................. 135
MMEM:STOR:LIM ..................................................................................................................... 135
MMEM:STOR:RLIM................................................................................................................... 136
MMEM:STOR:SEGM ................................................................................................................. 137
MMEM:STOR:SNP .................................................................................................................... 137
MMEM:STOR:SNP:FORM......................................................................................................... 138
MMEM:STOR:STYP .................................................................................................................. 139
MMEM:TRAN?........................................................................................................................... 140
OUTP ......................................................................................................................................... 140
SENS:AVER ............................................................................................................................... 141
SENS:AVER:CLE........................................................................................................................ 141
SENS:AVER:COUN.................................................................................................................... 142
SENS:BAND .............................................................................................................................. 143
SENS:BWID ............................................................................................................................... 143
SENS:CORR:CLE ....................................................................................................................... 143
SENS:CORR:COEF?................................................................................................................... 144
SENS:CORR:COEF:METH:ERES ............................................................................................... 145
SENS:CORR:COEF:METH:OPEN.............................................................................................. 145
SENS:CORR:COEF:METH:SHOR.............................................................................................. 146
SENS:CORR:COEF:METH:SOLT1............................................................................................. 146
SENS:CORR:COEF:METH:THRU .............................................................................................. 147
SENS:CORR:COEF:SAVE .......................................................................................................... 148
SENS:CORR:COLL:CKIT ........................................................................................................... 149
SENS:CORR:COLL:CKIT:LAB ................................................................................................... 149
SENS:CORR:COLL:CKIT:RES.................................................................................................... 150
SENS:CORR:COLL:CKIT:STAN:C0 ........................................................................................... 150
SENS:CORR:COLL:CKIT:STAN:C1............................................................................................ 151
SENS:CORR:COLL:CKIT:STAN:C2 ........................................................................................... 152
SENS:CORR:COLL:CKIT:STAN:C3............................................................................................ 153
SENS:CORR:COLL:CKIT:STAN:DEL......................................................................................... 154
SENS:CORR:COLL:CKIT:STAN:L0............................................................................................ 155
SENS:CORR:COLL:CKIT:STAN:L1............................................................................................ 156
SENS:CORR:COLL:CKIT:STAN:L2............................................................................................ 157
SENS:CORR:COLL:CKIT:STAN:L3............................................................................................ 158

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
6
SENS:CORR:COLL:CKIT:STAN:LAB......................................................................................... 158
SENS:CORR:COLL:CKIT:STAN:LOSS ...................................................................................... 159
SENS:CORR:COLL:CKIT:STAN:TYPE....................................................................................... 160
SENS:CORR:COLL:CKIT:STAN:Z0 ........................................................................................... 161
SENS:CORR:COLL:CLE............................................................................................................. 161
SENS:CORR:COLL:ECAL:ORI:STAT......................................................................................... 162
SENS:CORR:COLL:ECAL:PATH................................................................................................ 162
SENS:CORR:COLL:ECAL:SOLT1 .............................................................................................. 163
SENS:CORR:COLL:ECAL:UCH.................................................................................................. 164
SENS:CORR:COLL:LOAD ......................................................................................................... 165
SENS:CORR:COLL:METH:ERES ............................................................................................... 166
SENS:CORR:COLL:METH:OPEN.............................................................................................. 166
SENS:CORR:COLL:METH:SHOR ............................................................................................. 167
SENS:CORR:COLL:METH:SOLT1............................................................................................. 167
SENS:CORR:COLL:METH:THRU .............................................................................................. 168
SENS:CORR:COLL:METH:TYPE? ............................................................................................. 169
SENS:CORR:COLL:OPEN ......................................................................................................... 169
SENS:CORR:COLL:SAVE .......................................................................................................... 170
SENS:CORR:COLL:SHOR ......................................................................................................... 171
SENS:CORR:COLL:THRU.......................................................................................................... 172
SENS:CORR:EXT ....................................................................................................................... 173
SENS:CORR:EXT:PORT:FREQ.................................................................................................. 174
SENS:CORR:EXT:PORT:INCL ................................................................................................... 175
SENS:CORR:EXT:PORT:LDC .................................................................................................... 175
SENS:CORR:EXT:PORT:LOSS.................................................................................................. 176
SENS:CORR:EXT:PORT:TIME................................................................................................... 177
SENS:CORR:IMP ....................................................................................................................... 178
SENS:CORR:STAT..................................................................................................................... 179
SENS:CORR:TYPE? ................................................................................................................... 180
SENS:FREQ ............................................................................................................................... 181
SENS:FREQ:DATA?................................................................................................................... 182
SENS:FREQ:CENT..................................................................................................................... 183
SENS:FREQ:SPAN .................................................................................................................... 184
SENS:FREQ:STAR..................................................................................................................... 185
SENS:FREQ:STOP.................................................................................................................... 186
SENS:OFFS................................................................................................................................187
SENS:OFFS:ADJ........................................................................................................................ 187
SENS:OFFS:ADJ:CONT............................................................................................................. 188
SENS:OFFS:ADJ:CONT:PER..................................................................................................... 189
SENS:OFFS:ADJ:EXEC.............................................................................................................. 190
SENS:OFFS:ADJ:PORT ............................................................................................................. 191
SENS:OFFS:ADJ:VAL................................................................................................................ 192
SENS:OFFS:PORT:DATA? ........................................................................................................ 193
SENS:OFFS:PORT:DIV.............................................................................................................. 194
SENS:OFFS:PORT:MULT.......................................................................................................... 195
SENS:OFFS:PORT:OFFS........................................................................................................... 196
SENS:OFFS:PORT:STAR........................................................................................................... 197
SENS:OFFS:PORT:STOP .......................................................................................................... 197
SENS:ROSC:SOUR.................................................................................................................... 198
SENS:SEGM:DATA.................................................................................................................... 199
SENS:SWE:POIN....................................................................................................................... 200
SENS:SWE:POIN:TIME ............................................................................................................. 201
SENS:SWE:TYPE....................................................................................................................... 202
SERV:CHAN:ACT?..................................................................................................................... 202
SERV:CHAN:COUN? ................................................................................................................. 203
SERV:CHAN:TRAC:ACT? .......................................................................................................... 203
SERV:CHAN:TRAC:COUN?....................................................................................................... 203

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
7
SERV:PORT:COUN?.................................................................................................................. 204
SERV:SWE:FREQ:MAX?............................................................................................................ 204
SERV:SWE:FREQ:MIN?............................................................................................................. 204
SERV:SWE:POIN? ..................................................................................................................... 205
SOUR:POW ............................................................................................................................... 205
SOUR:POW:CENT..................................................................................................................... 206
SOUR:POW:SLOP..................................................................................................................... 207
SOUR:POW:SPAN..................................................................................................................... 208
SOUR:POW:STAR ..................................................................................................................... 209
SOUR:POW:STOP..................................................................................................................... 210
STAT:OPER?.............................................................................................................................. 211
STAT:OPER:COND?.................................................................................................................. 211
STAT:OPER:ENAB .................................................................................................................... 212
STAT:OPER:NTR....................................................................................................................... 212
STAT:OPER:PTR ....................................................................................................................... 213
STAT:PRES................................................................................................................................213
STAT:QUES:COND?.................................................................................................................. 214
STAT:QUES:ENAB .................................................................................................................... 214
STAT:QUES:LIM:CHAN:COND?............................................................................................... 215
STAT:QUES:LIM:CHAN:ENAB ................................................................................................. 215
STAT:QUES:LIM:CHAN:NTR .................................................................................................... 216
STAT:QUES:LIM:CHAN:PTR .................................................................................................... 216
STAT:QUES:LIM:CHAN?........................................................................................................... 217
STAT:QUES:LIM:COND? .......................................................................................................... 217
STAT:QUES:LIM:ENAB............................................................................................................. 218
STAT:QUES:LIM:NTR ............................................................................................................... 218
STAT:QUES:LIM:PTR................................................................................................................ 219
STAT:QUES:LIM?...................................................................................................................... 219
STAT:QUES:NTR....................................................................................................................... 220
STAT:QUES:PTR ....................................................................................................................... 220
STAT:QUES:RLIM:CHAN:COND?............................................................................................. 221
STAT:QUES:RLIM:CHAN:ENAB ............................................................................................... 221
STAT:QUES:RLIM:CHAN:NTR.................................................................................................. 222
STAT:QUES:RLIM:CHAN:PTR .................................................................................................. 222
STAT:QUES:RLIM:CHAN? ........................................................................................................ 223
STAT:QUES:RLIM:COND?........................................................................................................ 223
STAT:QUES:RLIM:ENAB .......................................................................................................... 224
STAT:QUES:RLIM:NTR............................................................................................................. 224
STAT:QUES:RLIM:PTR ............................................................................................................. 225
STAT:QUES:RLIM?.................................................................................................................... 225
STAT:QUES? ............................................................................................................................. 226
SYST:CORR ............................................................................................................................... 227
SYST:DATE................................................................................................................................227
SYST:ERR?................................................................................................................................. 228
SYST:LOC.................................................................................................................................. 228
SYST:PRES ................................................................................................................................229
SYST:REM ................................................................................................................................. 229
SYST:RWL ................................................................................................................................. 229
SYST:TIME................................................................................................................................. 230
TRIG........................................................................................................................................... 231
TRIG:SING ................................................................................................................................. 232
TRIG:SOUR................................................................................................................................233
Appendix1.IEE488.2StatusReportingSystem .............................................................................234
Appendix2.ErrorCodes.....................................................................................................................240
Appendix3.ProgrammingExamples ...............................................................................................241


PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
8
1Introduction
ThisManualcontainsinformationonNetworkAnalyzerremotecontrolanditsdata
communicationbymeansofuserprogramswrittenwithSCPI(StandardCommands
forProgrammableInstruments).SCPIisusedforremotecontrolovertheAnalyzer
viaEthernetphysicalinterfaces.
1.1 ProgrammingManualScope
ThisManualdirectlyappliestothePlanar–TR1300/1,TR5048andTR7530models
NetworkAnalyzer.
1.2 RelatedDocuments
BeforereadingthisManual,familiarizeyourselfwithAnalyzerOperatingManual.
1.3 References
IEEEStandard488.2–1992,IEEEStandardCodes,Formats,ProtocolsandCommon
CommandsforUsewithANSI/IEEEStd488.1–1987.IEEE,NewYork,NY,1992.
SCPIStandard–1999,StandardCommandsforProgrammableInstrumentsVolume1:
SyntaxandStyle.SCPIConsortium,SanDiego,CA,1999.
VXI–11,TCP/IPInstrumentProtocolSpecification.VXIbusConsortium,Inc.

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
9
2AnalyzerInterfaces
2.1 EthernetInterface
Ethernetinterfaceispartoftheequipmentofapersonalcomputerthatconnectsto
thedevice"Planar‐TR1300/1»,«TR5048»or«TR7530».
DatatransferbetweenthePCuserandthecomputerthatisconnectedtothe
device,isperformedviaVXI‐11protocolorSocket(TCP,port5025).VXI‐11protocol
isintendedforcontrolovermeasurementinstrumentsandbasedonTCP/IP
protocol.
ConnectthedevicetoaPCinthelocalEthernetnetworkofyourcompany.
ActivatethefunctionofremotecontrolviaVXI–11protocolonyourAnalyzeras
describedbelow.





Toenable/disableremotecontrolviaVXI–11protocol
networkorSocket,usethefollowingsoftkeys:
System>MiscSetup>NetworkSetup>VXI–11ON/OFF
System>MiscSetup>NetworkSetup>SocketON/OFF

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
10
3ControlComputer
3.1 SoftwareRequirements
ToestablishcommunicationbetweentheAnalyzerandthecontrolcomputer,the
softwaresupportingVXI–11(Ethernet)input/outputprotocolsmustbeinstalledon
thePC.Thiscanbeimplementedbytheuserprogram,butusuallyathirdparty
softwareisusedforthispurpose.Belowarethetwomostcommonsolutions:
ProgramminglanguageswithGPIBsupport,suchasHTBasic.
VISAlibraryensurescontrolovermeasurementinstrumentsby
anyprogramminglanguage(C/C++,VisualBasic,MATLAB,
LabView,etc).VISAlibrarysupportsavarietyofinterfacesand
protocols,includingIEEE488.2(GPIB)andVXI–11(Ethernet)
protocolsbeingusedintheAnalyzer.Therearedifferent
implementationsofVISAlibrary.Youcanuseanyofthe
implementations,forexampleNationalInstrumentsNI–VISAor
AgilentIOLibrariesSuite.
4SCPIOverview
TheEthernetinterfaceimplementsamesetofcommandsbasedon1999SCPI
standard(StandardCommandsforProgrammableInstruments).Thiscommandset
allowstheexchangeofcharactermessages.
SCPIisdevelopedbySCPIConsortium(http:\\www.scpiconsortium.org).Themain
featuresofSCPIstandardaredescribedbelow.Foramoredetailedinformationon
SCPIstandard,seethewebsiteofSCPIConsortium.
4.1 CommandTree
TheSCPIcommandsareorganizedinatreestructure.Forexample:



Eachtreestructureformsafunctionalsystem.Thebaseofthetreeiscalledroot,
e.g.MEASureandSYSTem.Eachfunctionalsystemcanhavesubsystemsoflower

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
11
level.Thefinalnodesarecalledleaves.Theentiresequencefromroottotheleaf
makesupthecommand.Forexample,partofSOURCefunctionalsystemlooksas
follows:
:SOURce
:POWer
:CENTer
:STARt
:SPAN
:STOP
[:LEVel]
:SLOPe
[:DATA]
:STATe
ThisSOURcebranchhasseverallevels,whereCENTer,STARt,SPAN,STOP,DATA,
STATearetheleaves,whichrepresentthefollowingsixcommands:
:SOURce:POWer:CENTer
:SOURce:POWer:STARt
:SOURce:POWer:SPAN
:SOURce:POWer:STOP
:SOURce:POWer[:LEVel]:SLOPe[:DATA]
:SOURce:POWer[:LEVel]:SLOPe:STATe
Thetreecancontainsubsystemsandleaveswiththesamenamesiftheybelongto
differentbranches,e.g.CENTerleafisonthetipsofdifferentbranches:
:SOURce:SENSe
:POWer
:FREQuency
:CENTer:CENTer
4.2 Subsystems
Acolon(':')separatesthesubsystems.Thesubsystems,whichfollowthecolonare
ofalowerlevel.Forexample,incommand:
:SOURce:POWer:STARt
thestartpowerSTARtisapartofPOWersubsystem,whichisapartofSOURce
subsystem.Thestoppowerisalsoapartof:SOURce:POWersubsystem.Itis
specifiedby:
:SOURce:POWer:STOP
Thefirstcoloninthelinecanbeomitted,forexample:
SOURce:POWer:STOP

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
12
4.3 OptionalSubsystems
Somesubsystemscanbespecifiedasoptional,ifomissionofsuchasubsystemwill
notleadtoambiguity.Thismeansthatthesubsystemcanbeomittedincommand
line.Theoptionalsubsystemsarebracketed("[]").Forexample,iffullcommand
specificationiswrittenas:
SOURce:POWer[:LEVel]:SLOPe[:DATA]
subsystemsLEVelandDATAareoptional.Thereforethebothcommandsarevalid:
SOURce:POWer:LEVel:SLOPe:DATA
SOURce:POWer:SLOPe
4.4 LongandShortFormats
Eachkeywordinacommandspecificationhasalongformatandashortformat.
Theshortformatofacommandisindicatedbycapitalletters.Forexample,a
commandspecification:
SENSe:FREQuency:CENTer
canbewrittenas:
SENS:FREQ:CENT
SENS:FREQ:CENTer
Onlylongorshortformofeachkeywordisacceptable.Forexample,thefollowing
specificationisincorrect:
:SENS:FREQuen:CEN
4.5 CaseSensitivity
Thecommandsarenotcasesensitive.Uppercaseandlowercaselettersareonly
usedtoindicatethelongandshortformatsofacommandspecification.For
example,thefollowingcommandsareequivalent:
SENS:FREQ:STAR
sens:freq:star
4.6 Parameters
Thecommandscanhaveparameters.Theparametersareseparatedfromthe
commandbyaspace.Ifacommandhasseveralparameters,theyareseparatedby
commas(',').


PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
13
4.6.1 NumericValues
Thenumericvaluesareintegerorrealnumbers.Theseparameterscanhave
measurementunits.Forexample:
SENS:FREQ1000000000
SENS:FREQ1000MHz
SENS:FREQ1GHz
SENS:FREQ1E9

4.6.1.1 MultiplierPrefixes
TheSCPIstandardallowsspecificationofthenumericvalueswithmultiplierprefix
tothemeasurementunits.

PrefixMultiplier
A 1e–18
F 1e–15
P 1e–12
N 1e–9
U 18–6
M 1e–3
K 1e3
MA 1e6
G 1e9
T 1e12
PE 1e15
EX 1e18

Therearetwoexceptionstotheabovedesignation:prefixMincombinationwith
HZorOHMmeans1e6(Mega),andnot1e–3(milli),i.e.MHZmeansMegahertz,
sameasMAHZ.

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
14
4.6.1.2 Notations
TheSCPIstandardallowsnumericvaluespecificationindifferentnotations.
Decimalnotationisusedbydefault.Touseothernotations,specifythenumeric
valuesinthefollowingway:

NotationPrefixExample
Binary#B#B11001010=20210
Octal#Q#Q107=7110
Hexadecimal#H#H10FF=435110
4.6.2 Booleans
Thebooleanscanassumetwovalues:logicalyesandlogicalno(ONandOFF),and
specifiedincommandas:
ONor1–logicalyes
OFFor0–logicalno
Forexample:
DISPlay:ENABleOFF
DISPlay:ENABle0
4.6.3 CharacterData
TheSCPIstandardallowsspecificationofparametersascharacterdata,asinthe
followingcommand:
TRIGger:SOURce{BUS|IMMediate|EXTernal}
thepossiblevaluesofthecharacterdata–"BUS","IMMediate","EXTernal".
Thecharacterdatahavelongandshortformat,andtheformatsarespecifiedin
accordancewiththesamerulesasdescribedinSection4.4.
Apartfromthat,thecharacterdatacanbecombinedwithnumericalparameters.
Forexample:
SENSe:FREQuency:STARt{MINimum|MAXimum|<value>}
Thefollowingspecificationsareacceptable:
SENSe:FREQuency:STARtMIN

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
15
SENSe:FREQuency:STARtmaximum
SENSe:FREQuency:STARt1000000
4.6.4 StringParameters
Insomecases,theinstrumentcanacceptparametersmadeofcharacterstrings.
Suchstringsareenclosedwithsinglequotes(')ordoublequotes(").Forexample,
thefilenameinthestatesavingcommand:
MMEMory:STORe"state01.sta"
4.6.5 NumericLists
Thenumericlists(<numericlist>)areusedtospecifyavariablenumberofnumerical
parameters,forexample:
CALC:LIMit:DATA2,1,1E9,3E9,0,0,2,1E9,3E9,–3,–3

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
16
4.7 QueryCommands
Thequerycommandsreadouttheparametervaluesfromtheinstrument.Aftera
querycommandhasbeensent,theresponseshouldreturnviaremotecontrol
interface.
Thequerycommandshasaquestionmark('?')intheendofthecommand.Manyof
thecommandshavetwoforms.Theformwithaquestionmarkwritesthe
parameter,theformwithoutaquestionmarkreadsouttheparameter.For
expample:
SENSe:FREQuency:STARt1MHz
SENSe:FREQuency:STARt?
4.8 NumericSuffixes
Theinstrumentcontainsseveralitemsofthesametype,suchas9channels,eachof
whichinturncontains8traces,etc.Anumericsuffixisusedtodenotetheitem
numberinacommand.Thesuffixisaddedtothekeywordoftheitem(channel,
trace,etc).Forexpample,inthefollowingspecificationthechannelnumber<Ch>
andtracenumber<Tr>indicatethechannelandtrace,towhichthiscommandis
addressed:
CALCulate<Ch>:PARameter<Tr>:DEFine
Accordingtothisspecification,thecommandreferredtothetrace2ofthechannel
1willbewrittenasfollows:
CALC1:PAR2:DEF
Thenumericsuffixcanbeomitted.Inthiscase,itis1bydefault.Forexample,the
followingcommandsareequivalent:
CALC:PAR:DEF
CALC1:PAR1:DEF
4.9 CompoundCommands
Itispossibletoentermorethanonecommandinthesamecommandline.The
commandsinthelineareseparatedbyasemicolon(';').Thespecificationofthefirst
commandisvalidforthefollowingcommand,exceptforthelastleafbeforethe
semicolon.Forexpample:
SENS:FREQ:STAR1MHZ;STOP2MHZ

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
17
Ifyouneedtostartthenextcommandfromthehighestlevelofthestructure,this
commandshouldstartfromacolon(':'):
SENS:FREQ:STAR1MHZ;:CALC:PAR:DEFS21
4.10 IEEE488.2CommonCommandsOverview
ASCPIcompatibleinstrumentmustsupportasetofcommoncommandsof
IEEE488.2standard.Thesecommandsstartwithanasterix('*').Thelistofsuch
commandsseebelow:

*CLS
*ESE
*ESE?
*ESR?
*IDN?
*OPC
*OPC?
*RST
*SRE
*SRE?
*STB?
*TRG
*WAI
Thesecommandsareusedforresetting,statequeries,etc.
4.11 StringTerminator
The<newline>character(ASCII10)inthelastdatabyteofthecommandstringis
usedasacommandterminator.Thestringofinstructionssenttotheinstrumentis
executedaftertheinstructionterminatorisreceived.

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
18
5RemoteControlCommands
5.1 Conventions
ThefollowingconventionsareusedthroughouttheManual.
5.1.1 Syntax
Thefollowingsymbolsareusedincommandsyntax:
<>identifiersenclosedinangularbracketsindicatedthataparticular
typeofdatamustbespecified
[]partenclosedinsquarebracketscanbeomitted
{}partenclosedincurlybracketsindicatesthatyoumustselectoneof
theitemsinthispart.Individualitemsareseparatedbyavertical
bar"|"
Spacespaceseparatescommandsfromparameters
,commaseparatesadjacentparameters
…ellipsesindicatesthatparametersinthatpartareomitted

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
19
5.1.2 Identifiers

IdentifierParameterDescription
<numeric>Number{<integer>|<real>}
<frequency>Frequency<numeric>{[HZ]|KHZ|MHZ|GHZ}
<power>Power<numeric>{[DBM]|DBMW|DBW|KW|W|MW|UW|NW}
<time>Time<numeric>{[S]|MS|US|NS|PS|FS}
<logmag>LogAmplitude<numeric>[DB]
<phase>Phase<numeric>{[DEG]|MADEG|KDEG|MDEG|UDEG}
<stimulus>Stimulus{<frequency>|<power>|<time>}
<response>Response{<logmag>|<phase>|<time>}
<numericlist>NumericList<numeric1>,<numeric2>,...<numericN>

PlanarTR1300/1,TR5048,TR7530ProgrammingManualSCPI
20
5.2 IEEE488.2CommonCommands
*CLS
*CLS
Description
Clearsthefollowing(noquery)
•ErrorQueue
•StatusByteRegister
•StandardEventStatusRegister
•OperationStatusEventRegister
•QuestionableStatusEventRegister
•QuestionableLimitStatusEventRegister
•QuestionableLimitChannelStatusEventRegister
TargetStatusReportingSystem
EquivalentSoftkeysNone
*ESE
*ESE<numeric>
*ESE?
DescriptionSetsorreadsoutthevalueoftheStandardEventStatusEnable
Register(command/query).
TargetStatusReportingSystem
Parameter<numeric>0to255
OutofRangeBitwiseANDwith255number
QueryResponse<numeric>
PresetValue0
EquivalentSoftkeysNone