Copper Mountain Technologies PLANAR TR1300/1 Owner's manual

TR Series
Planar TR1300/1,
TR5048, TR7530
Vector Network Analyzer
Programming Manual COM/DCOM
Software version: 18.3.0
December 2018

2
TABLE OF CONTENTS
Introduction .................................................................................................................11
1Registering COM Server ..........................................................................................11
2COM Technology Overview .....................................................................................11
3Automation Server ...................................................................................................12
4Automation Controllers ...........................................................................................12
5Local and Remote Server.........................................................................................13
6Structure of COM Objects ........................................................................................14
7Accessing the Application Object ...........................................................................15
8Object Methods ........................................................................................................17
9Object Properties .....................................................................................................17
10 Error Handling ........................................................................................................18
11 COM Automation Data Types................................................................................20
12 Measurement Data Arrays.....................................................................................21
13 COM Server Commands .........................................................................................22
NAME................................................................................................................................................ 22
Ready ...............................................................................................................................................22
SCPI.ABORt ....................................................................................................................................23
SCPI.CALCulate(Ch).FSIMulator.SENDed.DEEMbed.PORT(Pt).USER.
FILename........................................................................................................................................23
SCPI.CALCulate(Ch).FSIMulator.SENDed.DEEMbed.PORT(Pt).STATe ......................25
SCPI.CALCulate(Ch).FSIMulator.SENDed.PMCircuit.PORT(Pt).USER.
FILename........................................................................................................................................26
SCPI.CALCulate(Ch).FSIMulator.SENDed.PMCircuit.PORT(Pt).STATe ......................27
SCPI.CALCulate(Ch).FSIMulator.SENDed.ZCONversion.PORT(Pt).Z0.R ...................28
SCPI.CALCulate(Ch).FSIMulator.SENDed.ZCONversion.STATe .................................. 29
SCPI.CALCulate(Ch).PARameter.COUNt ..............................................................................30
SCPI.CALCulate(Ch).PARameter(Tr).DEFine.......................................................................31
SCPI.CALCulate(Ch).PARameter(Tr).SELect........................................................................ 32
SCPI.CALCulate(Ch).PARameter(Tr).SPORt........................................................................33
SCPI.CALCulate(Ch).SELected.CONVersion.FUNCtion ...................................................34
SCPI.CALCulate(Ch).SELected.CONVersion.STATe..........................................................35
SCPI.CALCulate(Ch).SELected.CORRection.EDELay.TIME ............................................ 36
SCPI.CALCulate(Ch).SELected.CORRection.OFFSet.PHASe .........................................37
SCPI.CALCulate(Ch).SELected.DATA.FDATa ...................................................................... 38
SCPI.CALCulate(Ch).SELected.DATA.FMEMory.................................................................39
SCPI.CALCulate(Ch).SELected.DATA.SDATa ...................................................................... 40
SCPI.CALCulate(Ch).SELected.DATA.SMEMory................................................................. 40
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.CENTer ........................................... 41
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.SHAPe ............................................. 42

3
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.SPAN ...............................................43
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.STARt .............................................. 44
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.STATe..............................................45
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.STOP................................................ 46
SCPI.CALCulate(Ch).SELected.FILTer.GATE.TIME.TYPE ................................................ 47
SCPI.CALCulate(Ch).SELected.FORMat................................................................................48
SCPI.CALCulate(Ch).SELected.FUNCtion.DATA ................................................................ 49
SCPI.CALCulate(Ch).SELected.FUNCtion.DOMain.COUPle ..........................................50
SCPI.CALCulate(Ch).SELected.FUNCtion.DOMain.STARt.............................................. 51
SCPI.CALCulate(Ch).SELected.FUNCtion.DOMain.STATe.............................................52
SCPI.CALCulate(Ch).SELected.FUNCtion.DOMain.STOP...............................................53
SCPI.CALCulate(Ch).SELected.FUNCtion.EXECute.......................................................... 54
SCPI.CALCulate(Ch).SELected.FUNCtion.PEXCursion....................................................55
SCPI.CALCulate(Ch).SELected.FUNCtion.POINts .............................................................56
SCPI.CALCulate(Ch).SELected.FUNCtion.PPOLarity ....................................................... 57
SCPI.CALCulate(Ch).SELected.FUNCtion.TARGet ............................................................ 58
SCPI.CALCulate(Ch).SELected.FUNCtion.TTRansition................................................... 59
SCPI.CALCulate(Ch).SELected.FUNCtion.TYPE.................................................................60
SCPI.CALCulate(Ch).SELected.LIMit.DATA ......................................................................... 61
SCPI.CALCulate(Ch).SELected.LIMit.DISPlay.STATe....................................................... 62
SCPI.CALCulate(Ch).SELected.LIMit.FAIL ...........................................................................62
SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.AMPLitude...............................................63
SCPI.CALCulate(Ch).SELected.LIMit.OFFSet.STIMulus.................................................. 64
SCPI.CALCulate(Ch).SELected.LIMit.REPort.ALL.............................................................. 65
SCPI.CALCulate(Ch).SELected.LIMit.REPort.DATA ..........................................................66
SCPI.CALCulate(Ch).SELected.LIMit.REPort.POINts .......................................................67
SCPI.CALCulate(Ch).SELected.LIMit.STATe ....................................................................... 68
SCPI.CALCulate(Ch).SELected.MARKer(Mk).ACTivate ....................................................69
SCPI.CALCulate(Ch).SELected.MARKer(Mk).BWIDth.DATA ..........................................70
SCPI.CALCulate(Ch).SELected.MARKer.BWIDth.REFerence.........................................71
SCPI.CALCulate(Ch).SELected.MARKer.BWIDth.STATe ................................................. 72
SCPI.CALCulate(Ch).SELected.MARKer.BWIDth.THReshold........................................ 73
SCPI.CALCulate(Ch).SELected.MARKer.BWIDth.TYPE.................................................... 74
SCPI.CALCulate(Ch).SELected.MARKer.COUPle ............................................................... 75
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.DOMain. STARt................... 76
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.DOMain. STATe..................77
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.DOMain. STOP.................... 78
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.EXECute ................................79
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.PEXCursion .......................... 80
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.PPOLarity..............................81
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.TARGet .................................. 82
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.TRACking..............................83
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.TTRansition .........................84
SCPI.CALCulate(Ch).SELected.MARKer(Mk).FUNCtion.TYPE .......................................85
SCPI.CALCulate(Ch).SELected.MARKer.REFerence.STATe ........................................... 86
SCPI.CALCulate(Ch).SELected.MARKer(Mk).SET_............................................................. 87

4
SCPI.CALCulate(Ch).SELected.MARKer(Mk).STATe ......................................................... 88
SCPI.CALCulate(Ch).SELected.MARKer(Mk).X ................................................................... 89
SCPI.CALCulate(Ch).SELected.MARKer(Mk).Y.................................................................... 90
SCPI.CALCulate(Ch).SELected.MARKer.COUNt................................................................. 91
SCPI.CALCulate(Ch).SELected.MATH.DELete.................................................................... 91
SCPI.CALCulate(Ch).SELected.MATH.FUNCtion ...............................................................92
SCPI.CALCulate(Ch).SELected.MATH.MEMorize .............................................................. 93
SCPI.CALCulate(Ch).SELected.MAXhold.STATe ...............................................................93
SCPI.CALCulate(Ch).SELected.MSTatistics.DATA ............................................................ 94
SCPI.CALCulate(Ch).SELected.MSTatistics.DOMain.MARKer.STARt.........................95
SCPI.CALCulate(Ch).SELected.MSTatistics.DOMain.MARKer.STOP.......................... 96
SCPI.CALCulate(Ch).SELected.MSTatistics.DOMain.STATe ......................................... 97
SCPI.CALCulate(Ch).SELected.MSTatistics.STATe........................................................... 98
SCPI.CALCulate(Ch).SELected.RLIMit.DATA ...................................................................... 99
SCPI.CALCulate(Ch).SELected.RLIMit.DISPlay.LINE .................................................... 100
SCPI.CALCulate(Ch).SELected.RLIMit.FAIL...................................................................... 100
SCPI.CALCulate(Ch).SELected.RLIMit.REPort.DATA .................................................... 101
SCPI.CALCulate(Ch).SELected.RLIMit.STATe.................................................................. 102
SCPI.CALCulate(Ch).SELected.SMOothing.APERture .................................................. 103
SCPI.CALCulate(Ch).SELected.SMOothing.STATe ........................................................ 104
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.CENTer .......................................... 105
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.IMPulse.WIDTh........................... 106
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.KBESsel......................................... 107
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.LPFRequency .............................. 108
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.REFLection.TYPE ....................... 109
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.SPAN .............................................. 110
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.STARt ............................................. 111
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.STATe............................................. 112
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.STEP.RTIMe................................. 113
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.STIMulus....................................... 114
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.STOP .............................................. 115
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.TYPE ............................................... 116
SCPI.CALCulate(Ch).SELected.TRANsform.TIME.UNIT ............................................... 117
SCPI.CALCulate(Ch).TRACe(Tr).DATA.FDATa.................................................................. 118
SCPI.CALCulate(Ch).TRACe(Tr).DATA.FMEMory ............................................................ 119
SCPI.CALCulate(Ch). TRACe(Tr).DATA.SDATa ................................................................ 120
SCPI.CALCulate(Ch). TRACe(Tr).DATA.SMEMory........................................................... 121
SCPI.DISPlay.ANNotation.FREQuency.STATe................................................................ 122
SCPI.DISPlay.COLor.BACK..................................................................................................... 123
SCPI.DISPlay.COLor.GRATicule ........................................................................................... 124
SCPI.DISPlay.COLor.RESet .................................................................................................... 125
SCPI.DISPlay.COLor.TRACe(Tr).DATA................................................................................ 125
SCPI.DISPlay.COLor.TRACe(Tr).MEMory........................................................................... 126
SCPI.DISPlay.FSIGn.................................................................................................................. 127
SCPI.DISPlay.IMAGe................................................................................................................. 128
SCPI.DISPlay.MAXimize ......................................................................................................... 129

5
SCPI.DISPlay.SPLit ................................................................................................................... 130
SCPI.DISPlay.UPDate_.IMMediate...................................................................................... 131
SCPI.DISPlay.WINDow(Ch).ACTivate ................................................................................. 131
SCPI.DISPlay.WINDow(Ch).ANNotation.MARKer.ALIGn.TYPE.................................. 132
SCPI.DISPlay.WINDow(Ch).ANNotation.MARKer.SINGle.STATe ............................. 133
SCPI.DISPlay.WINDow(Ch).MAXimize............................................................................... 133
SCPI.DISPlay.WINDow(Ch).SPLit......................................................................................... 134
SCPI.DISPlay.WINDow(Ch).TITLe.DATA ........................................................................... 135
SCPI.DISPlay.WINDow(Ch).TITLe.STATe.......................................................................... 136
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).ANNotation.MARKer.MEMory.................... 136
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).ANNotation.MARKer.POSition.X .............. 137
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).ANNotation.MARKer.POSition.Y............... 138
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).MEMory. STATe .............................................. 139
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).STATe................................................................. 140
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).Y.SCALe.AUTO................................................. 141
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).Y.SCALe.PDIVision......................................... 142
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).Y.SCALe.RLEVel .............................................. 143
SCPI.DISPlay.WINDow(Ch).TRACe(Tr).Y.SCALe.RPOSition........................................ 144
SCPI.DISPlay.WINDow(Ch).Y.SCALe.DIVisions............................................................... 145
SCPI.HCOPy.ABORt .................................................................................................................. 146
SCPI.HCOPy.DATE.STAMp..................................................................................................... 146
SCPI.HCOPy.IMAGe .................................................................................................................. 147
SCPI.HCOPy.IMMediate.......................................................................................................... 147
SCPI.HCOPy.PAINt.................................................................................................................... 148
SCPI.IEEE4882.CLS .................................................................................................................. 149
SCPI.IEEE4882.IDN .................................................................................................................. 150
SCPI.IEEE4882.RST .................................................................................................................. 150
SCPI.IEEE4882.TRG.................................................................................................................. 151
SCPI.IEEE4882.WAI.................................................................................................................. 151
SCPI.INITiate.CONTinuous.................................................................................................... 152
SCPI.INITiate.IMMediate........................................................................................................ 153
SCPI.MMEMory.COPY(Src, Dst)............................................................................................. 153
SCPI.MMEMory.DELete(File)................................................................................................. 154
SCPI.MMEMory.LOAD.CHANnel.STATe ............................................................................ 154
SCPI.MMEMory.LOAD.CKIT(Ck)............................................................................................ 155
SCPI.MMEMory.LOAD.CALibration..................................................................................... 156
SCPI.MMEMory.LOAD.LIMit .................................................................................................. 157
SCPI.MMEMory.LOAD.RLIMit ............................................................................................... 158
SCPI.MMEMory.LOAD.SEGMent .......................................................................................... 159
SCPI.MMEMory.LOAD.SNP.DATA........................................................................................ 160
SCPI.MMEMory.LOAD.SNP.TRACe(Tr).MEMory ............................................................. 161
SCPI.MMEMory.LOAD.STATe................................................................................................ 162
SCPI.MMEMory.MDIRectory.................................................................................................. 163
SCPI.MMEMory.STORe.CHANnel.CLEar............................................................................ 163
SCPI.MMEMory.STORe.CHANnel.STATe .......................................................................... 164
SCPI.MMEMory.STORe.CKIT(Ck).......................................................................................... 165

6
SCPI.MMEMory.STORe.CALibration................................................................................... 166
SCPI.MMEMory.STORe.FDATa ............................................................................................. 167
SCPI.MMEMory.STORe.IMAGe ............................................................................................. 168
SCPI.MMEMory.STORe.LIMit ................................................................................................ 169
SCPI.MMEMory.STORe.RLIMit ............................................................................................. 170
SCPI.MMEMory.STORe.SEGMent ........................................................................................ 171
SCPI.MMEMory.STORe.SNP.DATA...................................................................................... 172
SCPI.MMEMory.STORe.SNP.FORMat................................................................................. 173
SCPI.MMEMory.STORe.SNP.TYPE.S1P.............................................................................. 174
SCPI.MMEMory.STORe.SNP.TYPE.S2P.............................................................................. 175
SCPI.MMEMory.STORe.STATe.............................................................................................. 176
SCPI.MMEMory.STORe.STYPe.............................................................................................. 177
SCPI.OUTPut.STATe................................................................................................................. 178
SCPI.SENSe(Ch).AVERage.CLEar.......................................................................................... 178
SCPI.SENSe(Ch).AVERage.COUNt ....................................................................................... 179
SCPI.SENSe(Ch).AVERage.CURRent ................................................................................... 180
SCPI.SENSe(Ch).AVERage.STATe ........................................................................................ 180
SCPI.SENSe(Ch).BANDwidth.RESolution.......................................................................... 181
SCPI.SENSe(Ch).CORRection.CLEar.................................................................................... 182
SCPI.SENSe(Ch).CORRection.COEFficient.DATA(Str, Pt_r, Pt_s) ............................... 183
SCPI.SENSe(Ch).CORRection.COEFficient.METHod.ERESponse ............................. 184
SCPI.SENSe(Ch).CORRection.COEFficient.METHod.RESPonse.OPEN ................... 185
SCPI.SENSe(Ch).CORRection.COEFficient.METHod.RESPonse.SHORt ................. 185
SCPI.SENSe(Ch).CORRection.COEFficient.METHod.RESPonse.THRU................... 186
SCPI.SENSe(Ch).CORRection.COEFficient.METHod.SOLT1 ...................................... 187
SCPI.SENSe(Ch).CORRection.COEFficient.SAVE............................................................ 188
SCPI.SENSe(Ch).CORRection.COLLect.ACQuire.LOAD................................................ 189
SCPI.SENSe(Ch).CORRection.COLLect.ACQuire.OPEN................................................ 190
SCPI.SENSe(Ch).CORRection.COLLect.ACQuire.SHORt .............................................. 191
SCPI.SENSe(Ch).CORRection.COLLect.ACQuire.THRU................................................ 192
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.LABel....................................................... 193
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.RESet ...................................................... 194
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.SELect..................................................... 195
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).C0........................................ 196
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).C1........................................ 197
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).C2........................................ 198
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).C3........................................ 199
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).DELay................................. 200
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).L0 ........................................ 201
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).L1 ........................................ 202
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).L2 ........................................ 203
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).L3 ........................................ 204
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).LABel ................................. 205
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).LOSS .................................. 206
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).TYPE................................... 207
SCPI.SENSe(Ch).CORRection.COLLect.CKIT.STAN(Std).Z0 ........................................ 208

7
SCPI.SENSe(Ch).CORRection.COLLect.CLEar ................................................................. 208
SCPI.SENSe(Ch).CORRection.COLLect.DATA.LOAD(Pt) .............................................. 209
SCPI.SENSe(Ch).CORRection.COLLect.DATA.OPEN(Pt) .............................................. 210
SCPI.SENSe(Ch).CORRection.COLLect.DATA.SHORt(Pt)............................................. 211
SCPI.SENSe(Ch).CORRection.COLLect.DATA.THRU.MATCh (Pt_r, Pt_s)................ 212
SCPI.SENSe(Ch).CORRection.COLLect.DATA.THRU. TRANsmission (Pt_r, Pt_s) 213
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.INFormation ........................................ 214
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.CHECK.Execute .................................. 215
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.ORIenation.Execute ......................... 215
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.ORIenation.STATe............................. 216
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.PATH(Pt)................................................ 217
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.SOLT1 .................................................... 218
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.SOLT2 .................................................... 219
SCPI.SENSe(Ch).CORRection.COLLect.ECAL.UCHar..................................................... 220
SCPI.SENSe(Ch).CORRection.COLLect.METHod.ERESponse .................................... 221
SCPI.SENSe(Ch).CORRection.COLLect.METHod.RESPonse.OPEN.......................... 222
SCPI.SENSe(Ch).CORRection.COLLect.METHod.RESPonse.SHORt ........................ 223
SCPI.SENSe(Ch).CORRection.COLLect.METHod.RESPonse.THRU.......................... 224
SCPI.SENSe(Ch).CORRection.COLLect.METHod.SOLT1 ............................................. 225
SCPI.SENSe(Ch).CORRection.COLLect.METHod.TYPE ................................................ 226
SCPI.SENSe(Ch).CORRection.COLLect.SAVE................................................................... 227
SCPI.SENSe(Ch).CORRection.EXTension.PORT(Pt).FREQuency(Ls)........................ 228
SCPI.SENSe(Ch).CORRection.EXTension.PORT(Pt).INCLude(Ls).STATe ............... 229
SCPI.SENSe(Ch).CORRection.EXTension.PORT(Pt).LDC ............................................. 230
SCPI.SENSe(Ch).CORRection.EXTension.PORT(Pt).LOSS(Ls).................................... 231
SCPI.SENSe(Ch).CORRection.EXTension.PORT(Pt).TIME ........................................... 232
SCPI.SENSe(Ch).CORRection.EXTension.STATe............................................................ 233
SCPI.SENSe(Ch).CORRection.IMPedance.INPut.MAGNitude .................................... 234
SCPI.SENSe(Ch).CORRection.STATe .................................................................................. 235
SCPI.SENSe(Ch).CORRection.TRANsform.TIME.FREQuency..................................... 236
SCPI.SENSe(Ch).CORRection.TRANsform.TIME.LOSS ................................................. 237
SCPI.SENSe(Ch).CORRection.TRANsform.TIME.RVELocity ....................................... 238
SCPI.SENSe(Ch).CORRection.TRANsform.TIME.STATe............................................... 239
SCPI.SENSe(Ch).CORRection.TYPE(Tr).............................................................................. 240
SCPI.SENSe(Ch).FREQuency.CENTer ................................................................................. 241
SCPI.SENSe(Ch).FREQuency.CW.......................................................................................... 242
SCPI.SENSe(Ch).FREQuency.DATA ..................................................................................... 243
SCPI.SENSe(Ch).FREQuency.SPAN ..................................................................................... 244
SCPI.SENSe(Ch).FREQuency.STARt.................................................................................... 245
SCPI.SENSe(Ch).FREQuency.STOP ..................................................................................... 246
SCPI.SENSe(Ch).OFFSet.ADJust.CONTinuous.PERiod ................................................. 247
SCPI.SENSe(Ch).OFFSet.ADJust.CONTinuous.STATe................................................... 248
SCPI.SENSe(Ch).OFFSet.ADJust.EXECute......................................................................... 248
SCPI.SENSe(Ch).OFFSet.ADJust.PORT............................................................................... 249
SCPI.SENSe(Ch).OFFSet.ADJust.STATe............................................................................. 250
SCPI.SENSe(Ch).OFFSet.ADJust.Value............................................................................... 251

8
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.DATA.................................................. 252
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.DIVisor .............................................. 253
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.MULTiplier....................................... 254
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.OFFSet .............................................. 255
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.STARt................................................. 256
SCPI.SENSe(Ch).OFFSet.PORT(Pt).FREQuency.STOP.................................................. 257
SCPI.SENSe(Ch).OFFSet.STATe............................................................................................ 258
SCPI.SENSe(Ch).ROSCillator.SOURce................................................................................ 259
SCPI.SENSe(Ch).SEGMent.DATA.......................................................................................... 260
SCPI.SENSe(Ch).SWEep.POINt.TIME.................................................................................. 261
SCPI.SENSe(Ch).SWEep.POINts ........................................................................................... 262
SCPI.SENSe(Ch).SWEep.REVerse.STATe........................................................................... 263
SCPI.SENSe(Ch).SWEep.TYPE............................................................................................... 264
SCPI.SENSe(Ch).VVM.DATA................................................................................................... 265
SCPI.SENSe(Ch).VVM.FORMat.............................................................................................. 266
SCPI.SENSe(Ch).VVM.FREQuency.CW................................................................................ 267
SCPI.SENSe(Ch).VVM.REFerence.CLEar ............................................................................ 267
SCPI.SENSe(Ch).VVM.REFerence.MEMorize.................................................................... 268
SCPI.SENSe(Ch).VVM.REFerence.DATA? .......................................................................... 268
SCPI.SENSe(Ch).VVM.TABLe.CLEar..................................................................................... 269
SCPI.SENSe(Ch).VVM.TABLe.DATA..................................................................................... 269
SCPI.SENSe(Ch).VVM.TABLe.INSert(Index) ..................................................................... 270
SCPI.SENSe(Ch).VVM.TABLe.MEMorize ............................................................................ 270
SCPI.SENSe(Ch).VVM.TABLe.REMove(Index).................................................................. 271
SCPI.SENSe(Ch).VVM.TABLe.SAVE(Name) ....................................................................... 271
SCPI.SENSe(Ch).VVM.DISPlay.RESolution ....................................................................... 272
SCPI.SENSe(Ch).VVM.DISPlay.FONT.SIZE........................................................................ 272
SCPI.SENSe(Ch).VVM.TYPE.................................................................................................... 273
SCPI.SERVice.CHANnel.ACTive............................................................................................ 274
SCPI.SERVice.CHANnel.COUNt............................................................................................ 274
SCPI.SERVice.CHANnel(Ch).TRACe.ACTive ..................................................................... 275
SCPI.SERVice.CHANnel.TRACe.COUNt ............................................................................. 275
SCPI.SERVice.PORT.COUNt................................................................................................... 276
SCPI.SERVice.SWEep.FREQency.MAXimum ................................................................... 276
SCPI.SERVice.SWEep.FREQency.MINimum..................................................................... 277
SCPI.SERVice.SWEep.POINts................................................................................................ 277
SCPI.SOURce(Ch).POWer.CENTer ....................................................................................... 278
SCPI.SOURce(Ch).POWer.LEVel.IMMediate.AMPLitude ............................................. 279
SCPI.SOURce(Ch).POWer.LEVel.SLOPe.DATA ................................................................ 280
SCPI.SOURce(Ch).POWer.PORT(Pt).CORRection.DATA............................................... 281
SCPI.SOURce(Ch).POWer.PORT(Pt).CORRection.STATe ............................................. 282
SCPI.SOURce(Ch).POWer.SPAN ........................................................................................... 283
SCPI.SOURce(Ch).POWer.STARt .......................................................................................... 284
SCPI.SOURce(Ch).POWer.STOP ........................................................................................... 285
SCPI.STATus.OPERation.CONDition.................................................................................. 286
SCPI.STATus.OPERation.ENABle ........................................................................................ 286

9
SCPI.STATus.OPERation.EVENt........................................................................................... 287
SCPI.STATus.OPERation.NTRansition............................................................................... 287
SCPI.STATus.OPERation.PTRansition ............................................................................... 288
SCPI.STATus.PRESet................................................................................................................ 288
SCPI.STATus.QUEStionable.CONDition ........................................................................... 289
SCPI.STATus.QUEStionable.ENABle.................................................................................. 289
SCPI.STATus.QUEStionable.EVENt .................................................................................... 290
SCPI.STATus.QUEStionable.LIMit.CHANnel(Ch).CONDition..................................... 290
SCPI.STATus.QUEStionable.LIMit.CHANnel(Ch).ENABle ........................................... 291
SCPI.STATus.QUEStionable.LIMit.CHANnel(Ch).EVENt.............................................. 291
SCPI.STATus.QUEStionable.LIMit.CHANnel(Ch).NTRansition ................................. 292
SCPI.STATus.QUEStionable.LIMit.CHANnel(Ch).PTRansition.................................. 293
SCPI.STATus.QUEStionable.LIMit.CONDition................................................................ 294
SCPI.STATus.QUEStionable.LIMit.ENABle ...................................................................... 294
SCPI.STATus.QUEStionable.LIMit.EVENt......................................................................... 295
SCPI.STATus.QUEStionable.LIMit.NTRansition............................................................. 295
SCPI.STATus.QUEStionable.LIMit.PTRansition ............................................................. 296
SCPI.STATus.QUEStionable.NTRansition ........................................................................ 297
SCPI.STATus.QUEStionable.PTRansition......................................................................... 298
SCPI.STATus.QUEStionable.RLIMit.CHANnel(Ch).CONDition.................................. 299
SCPI.STATus.QUEStionable.RLIMit.CHANnel(Ch).ENABle ........................................ 300
SCPI.STATus.QUEStionable.RLIMit.CHANnel(Ch).EVENt........................................... 301
SCPI.STATus.QUEStionable.RLIMit.CHANnel(Ch).NTRansition .............................. 302
SCPI.STATus.QUEStionable.RLIMit.CHANnel(Ch).PTRansition............................... 303
SCPI.STATus.QUEStionable.RLIMit.CONDition ............................................................. 304
SCPI.STATus.QUEStionable.RLIMit.ENABle.................................................................... 304
SCPI.STATus.QUEStionable.RLIMit.EVENt ...................................................................... 305
SCPI.STATus.QUEStionable.RLIMit.NTRansition.......................................................... 305
SCPI.STATus.QUEStionable.RLIMit.PTRansition .......................................................... 306
SCPI.SYSTem.COMMunicate.ECAL.TEMPerature.SENSor.......................................... 307
SCPI.SYSTem.CORRection.STATe....................................................................................... 308
SCPI.SYSTem.DATE.................................................................................................................. 309
SCPI.SYSTem.HIDe................................................................................................................... 309
SCPI.SYSTem.LOCal................................................................................................................. 310
SCPI.SYSTem.PRESet .............................................................................................................. 310
SCPI.SYSTem.REMote ............................................................................................................. 311
SCPI.SYSTem.RWLock............................................................................................................. 311
SCPI.SYSTem.SHOw ................................................................................................................ 312
SCPI.SYSTem.TEMPerature.SENSor(Idx).......................................................................... 312
SCPI.SYSTem.TERMinate....................................................................................................... 313
SCPI.SYSTem.TIME................................................................................................................... 313
SCPI.TRIGger.SEQuence.EXTernal.Delay......................................................................... 314
SCPI.TRIGger.SEQuence.EXTernal.POSition .................................................................. 315
SCPI.TRIGger.SEQuence.EXTernal.SLOPe....................................................................... 316
SCPI.TRIGger.SEQuence.IMMediate .................................................................................. 317
SCPI.TRIGger.SEQuence.POINt............................................................................................ 318

10
SCPI.TRIGger.SEQuence.SINGle.......................................................................................... 319
SCPI.TRIGger.SEQuence.SOURce ....................................................................................... 320
SCPI.TRIGger.SEQuence.STATe........................................................................................... 321
Appendix 1. Error Codes.......................................................................................... 322
Appendix 2. Programming Examples..................................................................... 323

11
Introduction
This Programming Manual contains information on remote control over Planar
TR1300/1, TR5048 or TR7530 Vector Network Analyzer (Analyzer) and its data
communication by means of user programs written with COM/DCOM technology.
COM technology is used when a user program runs together with an external
measurement instrument program on one PC. DCOM technology is used when a
user program runs on a PC connected with the measurement instrument by LAN.
Methods and techniques for writing of user programs are the same for both
technologies. The only difference between the technologies is that the DCOM
technology requires additional LAN setting performed by the LAN administrator.
Before reading this Manual, familiarize yourself with Analyzer Operating Manual.
1Registering COM Server
To register COM server of the analyzer run the executable module from command
prompt with the /regserver keyword. To unregister COM server of the analyzer run
the executable module from command prompt with the /unregserver keyword.
Administrative rights are required to register/unregister COM server. Also user has
ability to register COM server during the software installation procedure.
Example of the COM server registration command:
TRVNA.exe /regserver
2COM Technology Overview
COM stands for Component Object Model. This programming technology was
developed by Microsoft for two purposes:
the model provides the specification for interaction of binary modules created
in different programming languages;
the model defines the interfacing between a client application and a server
application running either on the same PC or on two different PCs. In the latter
case, the technology has DCOM abbreviation –Distributed COM.

12
3Automation Server
The network analyzer executable module contains a built-in COM server that
enables other programs to access its functionality. The COM server was developed
in conformity with the COM automation specification. COM automation is a
technology allowing control over the COM server by the programs written in both
traditional compiling programming languages and interpreting programming
languages, such as VBScript. This enables the server applications to make their
functionality accessible to many more clients.
4Automation Controllers
Automation controllers are client programs, which use internal functionality of COM
servers. Automation controller programs are developed by users for writing their
own additions for the system.
User programs can be written in different languages:
programming languages with built-in COM support, such as Visual Basic®,
Delphi, Java;
universal programming languages, such as C, C++;
Microsoft Excel and Word office applications as they include built-in
programming language Visual Basic for Applications®;
program generators, such as National Instruments LabView®, or HP–VEE.
Examples represented in this Manual are written in Visual Basic (VB). Appendix 2
contains examples written in VB, and C++ languages.
Examples\COM\VBA folder contains source codes for examples written in Visual
Basic for Applications® (Microsoft Excel files).
Examples\COM\CPP folder contains source codes for the C++ language examples.

13
5Local and Remote Server
The network analyzer executable module can function either as a local server or as
a remote server of COM automation.
Local server runs on the same PC with the automation controller and each of the
programs is executed as an individual application in a separate window. COM
technology is used in this case (Figure 1).
Remote server and the automation controller run on different PCs connected by
LAN. DCOM (Distributed COM) technology is used in this case (Figure 2). When
using DCOM it is necessary to configure the local network by means of DCOM
Windows tools.
The same automation controller is used for the both COM and DCOM technology.
Some changes to the user program may be required in operators, which establish
connection with the server. Moreover, DCOM technology requires additional
settings of the LAN performed by the LAN administrator.
Figure 1. COM technology
Figure 2. DCOM technology

14
6Structure of COM Objects
COM server contains several objects, which provide different functionality of the
server. The COM objects of the network analyzer executable module are organized
in a hierarchical structure. Figure 3 shows the main COM objects, which comprise
the first three levels of the hierarchical structure of the COM server. COM objects
provide various methods and properties, which allow access to the server functions;
besides, they allow access to the objects of the lower levels, which are not shown
in Figure 3.
Figure 3. The structure of COM objects
The Object Application is in the top of the hierarchy COM server. Access to the
lower level objects is implemented via higher level objects.
Note
The hierarchy of COM objects is organized in accordance with the
standard and syntax of the SCPI programming language.
Operators in SCPI have hierarchical chain structure, for example:
CALCulate:PARameter:DEFine S11
The same COM command written in VB programming language is
as follows:
app.SCPI.CALCulate.PARameter.DEFine = "S11"
Application
CALCulate
DISPlay
INITiate
IEEE4882
SENSe
SYSTem
SOURce
MMEMory
SCPI
TRIGer
OUTPut
HCOPy
SERVice

7Accessing the Application Object
To establish connection with the COM server application, create an object
reference in the client program. In COM programming the object reference needs
to be acquired preliminarily, to be used later to access the object functionality. To
define an object in Visual Basic perform the following:
1) Declare a variable as an object;
2) Assign the object to this variable.
To declare a variable, use Dim operator or other declaration statement (Public,
Private or Static). The variables used for references should be of the types Variant,
Object, or a type of a specific object. For example, the following three operators
declare app variable:
Dim app
Dim app as Object
Dim app as TR1300.Application
Dim app as TRVNA.Application
Use Set operator and CreateObject (ObjectName, HostName) function to assign a
specific object to a variable.
ObjectName
Automation object name is always equal to
“TR1300.Application”, “TRVNA.Application”
HostName
Network name of the PC hosting the COM server. This parameter
is not specified in case of a local server.
For example, the following operators create Application object and assign it to app
variable:
Set app = CreateObject("TRVNA.Application")
Set app = CreateObject("TRVNA.Application", "Network_Name")
Set app = CreateObject("TRVNA.Application", "192.168.10.10")
Note
The first form of the operator is used to create the reference to the
local COM server, the second one is used to create the reference to
the remote DCOM server.

Accessing the Application Object
16
To allow access to the objects of a lower level of the hierarchy, these objects are
specified after the reference to the higher level object and separated from it by a
dot. For example:
Dim SystObj
Set SystObj = app.SCPI.SYSTem
COM objects can have indices. For example, CALCulate, INITiate, SENSe, SOURce
objects represent various aspects of the 4 measurement channels of the Analyzer.
Therefore, it is necessary to write the channel index from 1 to 4 to acquire the
data of these objects. For example:
Set SensObj1 = app.SCPI.SENSe(1)
Set SensObj2 = app.SCPI.SENSe(2)
Visual Basic allows omitting of such indices; in this case the indices are considered
as equal to 1. For example, the following VB operators are equivalent:
Set SensObj = app.SCPI.SENSe(1)
Set SensObj = app.SCPI.SENSe

8Object Methods
Objects have methods. Methods are actions that can be applied to objects. The
object methods are specified after the object name and separated from it by a dot.
The following example shows the PRESet method of SYSTem object. This method
performs setting of the Analyzer to the preset condition:
app.SCPI.SYSTem.PRESet
9Object Properties
Along with methods, objects have properties. Properties are object characteristics
that can be set or read out. The object properties are specified after the object
name and separated from it by a dot.
To modify an object characteristic, write the value of the corresponding property.
To define an object characteristic, read out the value of its property. The following
example show the setting of the POINts property of SWEep object, i.e. the number
of sweep points:
app.SCPI.SENSe.SWEp.POINts = 201
Note
Some object properties cannot be written, and some object
properties cannot be read. In such cases, the properties are
indicated as “read only” or “write only”.

10 Error Handling
You can use different approaches to error handling in VB program:
check the value of Err.Number variable after execution of VB operator, which
contains the call to COM server object;
use On Error GoTo VB operator.
These approaches are represented in the examples below. The following operator
causes an error in VB program as "S13" value of the DEFine property is incorrect.
app.SCPI.PARameter.DEFine = "S13"
In the first example, the value of the Err.Number variable is checked after
execution of the VB operator, which contains the call to COM server object. On
Error Resume Next directive instructs VB not to interrupt the program execution
when the error is detected but to pass control to the next operator in natural
order.
Dim app
Public Sub HandleError1()
Set app = CreateObject("TRVNA.Application")
On Error Resume Next
app.SCPI.PARameter.DEFine = "S13"
If Err.Number <> 0 Then
Msg = "Error # " & Str(Err.Number) & " was generated by " &_
Err.Source & Chr(13) & Err.Description
MsgBox Msg,,"Error"
End If
...
End Sub

Error Handling
19
In the second example, On Error GoTo ErrHandler directive instructs VB to interrupt
the program execution when the error is detected and to pass control to
ErrHandler label.
Dim app
Public Sub HandleError2()
Set app = CreateObject("TRVNA.Application")
On Error GoTo ErrHandler
app.SCPI.PARameter.DEFine = "S13"
...
Exit Sub
ErrHandler:
Msg = "Error # " & Str(Err.Number) & " was generated by " &_
Err.Source & Chr(13) & Err.Description
MsgBox Msg,,"Error"
End Sub

11 COM Automation Data Types
In COM automation, there are the following data types, which can be used for
client-to-server communication:
Long
32-bit signed integer, value range from –2147483648 to
2147483647
Double
64-bit double-precision floating point, value range from
–1.79769313486232E308 to –4.94065645841247E–324 for
negative values, and from 4.94065645841247E–324 to
1.79769313486232E308 for positive values
Boolean
16-bit integer, two values 0 –False, 1 –True
String
Variable-length string
Variant
Can be either a value of arbitrary type or an array of values of
arbitrary type. In this case, the term “arbitrary type” means any
allowed type of COM automation. A variable contains information
about its type and array size (if it is an array). It is used for
communication of data arrays between a client and a server.