Programmer’s Guide Agilent Technologies E4406A VSA Series Transmitter Tester Manufacturing Part Number: E4406-90176 Supersedes E4406-90135 Printed in USA September 2001 © Copyright 1999 - 2001 Agilent Technologies, Inc.
The information contained in this document is subject to change without notice. Agilent Technologies makes no warranty of any kind with regard to this material, including but not limited to, the implied warranties of merchantability and fitness for a particular purpose. Agilent Technologies shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material.
Warranty This Agilent Technologies instrument product is warranted against defects in material and workmanship for a period of one year from date of shipment. During the warranty period, Agilent Technologies Company will, at its option, either repair or replace products which prove to be defective. For warranty service or repair, this product must be returned to a service facility designated by Agilent Technologies.
Contents 1. Preparing for Use What’s in This Chapter? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . www.agilent.com/find/vsa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Digital Communications Measurements Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Programming the Transmitter Tester. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents General LAN Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105 C Programming Using VTL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113 Typical Example Program Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113 Linking to VTL Libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Query Instrument Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Recall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Reset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Save . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Align the Trigger Delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226 Align the Trigger Interpolator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226 Calibration Wait . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226 CONFigure Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents INSTrument Subsystem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Catalog Query . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Select Application by Number . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Select Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Contents Questionable Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .367 Questionable Calibration Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369 Questionable Frequency Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .371 Questionable Integrity Register . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands *CAL? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 *CLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 *ESE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187 *ESE? . . . . . . . . . . . . . .
List of Commands :CALCulate::MARKer[1]|2|3|4:X:POSition . . . . . . . . . . . . . . . . . . . . .211 :CALCulate::MARKer[1]|2|3|4:X:POSition?. . . . . . . . . . . . . . . . . . . . . . . . . . . . .211 :CALCulate::MARKer[1]|2|3|4:X?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211 :CALCulate::MARKer[1]|2|3|4:Y?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :CALibration:COMB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 :CALibration:COMB? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 215 :CALibration:CORRections 0|1|OFF|ON . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 :CALibration:CORRections?. . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :CALibration:PFILter:LC:NARRow? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220 :CALibration:PFILter:LC:WIDE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 :CALibration:PFILter:LC:WIDE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221 :CALibration:PFILter:XTAL:NARRow . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :CONFigure:PVTime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271 :CONFigure:SENSors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274 :CONFigure:SPECtrum . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275 :CONFigure:TBFRequency . . . . . . . . . . . . . . . . . . . .
List of Commands :FETCh:CHPower[n]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .268 :FETCh:PSTatistic[n]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269 :FETCh:PVTime[n]?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271 :FETCh:SENSors[n]? . . . . . . . . . . . . . . . . . . .
List of Commands :HCOPy[:IMMediate] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243 :INITiate:. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 :INITiate:CONTinuous OFF|ON|0|1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 :INITiate:CONTinuous? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :MEMory:INSTall:APPLication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281 :MEMory:UNINstall:APPLication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281 :MMEMory:FREE?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282 :MMEMory:MSIS A|[C] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :STATus:PRESet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367 :STATus:QUEStionable:CALibration:CONDition?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 :STATus:QUEStionable:CALibration:ENABle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369 :STATus:QUEStionable:CALibration:ENABle? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :STATus:QUEStionable:INTegrity:SIGNal:NTRansition? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375 :STATus:QUEStionable:INTegrity:SIGNal:PTRansition . . . . . . . . . . . . . . . . . . . . . . . .375 :STATus:QUEStionable:INTegrity:SIGNal:PTRansition?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375 :STATus:QUEStionable:INTegrity:SIGNal[:EVENt]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :STATus:QUEStionable:TEMPerature:PTRansition? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381 :STATus:QUEStionable:TEMPerature[:EVENt]?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380 :STATus:QUEStionable[:EVENt]?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368 :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands :TRIGger[:SEQuence]:AUTO:STATe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .391 :TRIGger[:SEQuence]:AUTO[:TIME]
List of Commands [:SENSe]:ACP:AVERage:COUNt? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286 [:SENSe]:ACP:AVERage:TCONtrol EXPonential|REPeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 [:SENSe]:ACP:AVERage:TCONtrol? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287 [:SENSe]:ACP:AVERage:TYPE MAXimum|RMS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:ACP:LIST:POWer INTeg|PEAK,INTeg|PEAK,INTeg|PEAK,INTeg|PEAK,INTeg|PEAK . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294 [:SENSe]:ACP:LIST:POWer?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294 [:SENSe]:ACP:LIST:RLIMit ,,,, . . . . . .294 [:SENSe]:ACP:LIST:RLIMit? . . . . . .
List of Commands [:SENSe]:ACP:OFFSet:LIST:POINts?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302 [:SENSe]:ACP:OFFSet:LIST:RATTenuation:AUTO OFF|ON|0|1 . . . . . . . . . . . . . . . . . . . . . . . . 303 [:SENSe]:ACP:OFFSet:LIST:RATTenuation:AUTO? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303 [:SENSe]:ACP:OFFSet:LIST:RATTenuation ,,,,. . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:ACP:OFFSet:RPSDensity? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305 [:SENSe]:ACP:OFFSet:TEST ABSolute|AND|OR|RELative . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310 [:SENSe]:ACP:OFFSet:TEST? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310 [:SENSe]:ACP:OFFSet[:FREQuency] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:ACP:OFFSet[n]:LIST[n]:RCARrier? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304 [:SENSe]:ACP:OFFSet[n]:LIST[n]:RPSDensity ,,,, . . . . . . . . . . . . . . . . . . . . . . . . . 306 [:SENSe]:ACP:OFFSet[n]:LIST[n]:RPSDensity? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:ACP:SWEep:TYPE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315 [:SENSe]:ACP:SWEep:TYPE? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316 [:SENSe]:ACP:TRIGger:SOURce EXTernal[1]|EXTernal2|FRAMe|IF|IMMediate|RFBurst . .316 [:SENSe]:ACP:TRIGger:SOURce?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 [:SENSe]:CHPower:FREQuency:SPAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326 [:SENSe]:CHPower:FREQuency:SPAN? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:POWer[:RF]:RANGe[:UPPer]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332 [:SENSe]:PSTatistic:BANDwidth|BWIDth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333 [:SENSe]:PSTatistic:BANDwidth|BWIDth? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333 [:SENSe]:PSTatistic:COUNts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:RADio:CARRier[:TYPE]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339 [:SENSe]:RADio:DEVice BS|MS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 [:SENSe]:RADio:DEVice BTS|MS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340 [:SENSe]:RADio:DEVice INBound|OUTBound . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:SPECtrum:ADC:DITHer[:STATe]? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347 [:SENSe]:SPECtrum:ADC:RANGe AUTO|APEak|APLock|M6|P0|P6|P12|P18|P24| . . . . . .347 [:SENSe]:SPECtrum:ADC:RANGe? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347 [:SENSe]:SPECtrum:AVERage:CLEar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:SPECtrum:FFT:LENGth? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353 [:SENSe]:SPECtrum:FFT:RBWPoints . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 [:SENSe]:SPECtrum:FFT:RBWPoints? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354 [:SENSe]:SPECtrum:FFT:WINDow:DELay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
List of Commands [:SENSe]:WAVeform:AVERage:COUNt?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .359 [:SENSe]:WAVeform:AVERage:TCONtrol EXPonential|REPeat . . . . . . . . . . . . . . . . . . . . . . . . . . .360 [:SENSe]:WAVeform:AVERage:TCONtrol?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .360 [:SENSe]:WAVeform:AVERage:TYPE LOG|MAXimum|MINimum|RMS|SCALar . . . . . . . . . . .360 [:SENSe]:WAVeform:AVERage:TYPE? . . . .
1 Preparing for Use This instrument uses the Standard Commands for Programmable Instruments (SCPI) programming language. For information on writing SCPI commands see “SCPI Language Basics” on page 59.
Preparing for Use What’s in This Chapter? What’s in This Chapter? • “Programming the Transmitter Tester” on page 38. • “Installing Optional Measurement Personalities” on page 41. • “Writing Your First Program” on page 46. • “Cables for Connecting to RS-232” on page 48. • “Connecting to a LAN Server” on page 55. • “Connecting to a GPIB Server” on page 56. www.agilent.com/find/vsa Get the latest listing of SCPI commands for this instrument at the above web location. Look under technical support information.
Preparing for Use What’s in This Chapter? Description Agilent Part Number Understanding GSM Transmitter Measurements for Base Transceiver Stations and Mobile Stations 5966-2833E Application Note 1312 Understanding PDC and NADC Transmitter Measurements for Base Transceiver Stations and Mobile Stations 5968-5537E Application Note 1324 Chapter 1 37
Preparing for Use Programming the Transmitter Tester Programming the Transmitter Tester The E4406A VSA Series Transmitter Tester has several different measurement modes. The measurement commands that are available to you vary, depending on which mode you select. Use INSTrument:SELect to select the desired mode. Most modes are optional and must be installed into instrument memory before they can be used.
Preparing for Use Programming the Transmitter Tester Table 1-1 Available Modes and Measurements Modes Measurement Keywords W-CDMA (3GPP) - Option BAF • ACP - adjacent channel power ratio measurement INST:SELECT WCDMA • CDPower - code domain power measurement • CHPower - channel power measurement • PSTatistic - power statistics (CCDF) measurement • EVMQpsk - QPSK error vector magnitude measurement • RHO - modulation accuracy (composite EVM) measurement • OBW - occupied bandwidth measurement • SEMask -
Preparing for Use Programming the Transmitter Tester Table 1-1 Available Modes and Measurements Modes Measurement Keywords NADC - Option BAE • ACP - adjacent channel power measurement INST:SELECT NADC • EVM - error vector magnitude measurement or • OBWidth - occupied bandwidth measurement PDC - Option BAE • SPECtrum - spectrum (frequency domain) Measurement INST:SELECT PDC • WAVeform - waveform (time domain) measurement iDEN - Option HN1 • ACP - adjacent channel power measurement INST:SELECT
Preparing for Use Installing Optional Measurement Personalities Installing Optional Measurement Personalities When you install a measurement personality, you follow a two step process. 1. Install the measurement personality firmware into the instrument memory. See “Loading an Optional Measurement Personality” on page 42. 2. Enter a license key number that activates the measurement personality. See “Installing a License Key” on page 43.
Preparing for Use Installing Optional Measurement Personalities Required Information: Key Path: Instrument Serial Number: __________________ System, Show System Loading an Optional Measurement Personality You must load the desired option into your instrument memory. Loading can be done from a CD-ROM or a www location. The automated loading program runs from your PC and comes with the firmware.
Preparing for Use Installing Optional Measurement Personalities a. This application uses the shared library, so you have to add its memory requirements to this value. The Exit Main Firmware key is used during the firmware installation process. This key is only for use when you want to update core firmware using a LAN connection. The Exit Main Firmware key halts the operation of the instrument firmware so you can install an updated version of firmware using a LAN connection.
Preparing for Use Installing Optional Measurement Personalities Viewing a License Key Measurement personalities purchased with your instrument have been installed and activated at the factory. You will receive a unique License Key number with every measurement personality purchased. The license key number is a hexadecimal number that is for your specific measurement personality, instrument serial number and host ID. It enables you to install, or reactivate that particular personality.
Preparing for Use Installing Optional Measurement Personalities NOTE Using the Uninstall key does not remove the personality from the instrument memory, and does not free memory to be available to install another option. If you need to free memory to install another option, refer to the instructions for loading firmware updates located at the URL: www.agilent.com/find/vsa/ 1. Press System, More(1 of 3), More(2 of 3), Uninstall, Choose Option.
Preparing for Use Writing Your First Program Writing Your First Program When the instrument has been connected to a computer, the computer can be used to send instrument instructions to make fast, repeatable measurements. A variety of different programming languages, computer types, and interface buses can be used for this process. The following section describes some basic steps for making a measurement program.
Preparing for Use Writing Your First Program • Use variables for function values. List the variables at the beginning of the program. • Perform the measurement manually, keeping track of the key functions used. Identify the programming commands equivalent to these front panel keys. • Select the instrument mode with INST:SELect. Set the mode setup for things like your desired communications standard, channel frequency and triggering.
Preparing for Use Cables for Connecting to RS-232 Cables for Connecting to RS-232 There are a variety of cables and adapters available for connecting to PCs, and printers. Several of these are documented in the following wiring diagrams. You need to find out what connections your equipment uses to identify the cables and/or adapters that you will need.
Preparing for Use Cables for Connecting to RS-232 Figure 1-2 HP/Agilent F1047-80002 Cable F1047-80002 Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI PC 1 2 3 4 5 6 7 8 9 DB9 Male 1 2 3 4 5 6 7 8 9 DB9 Female DCD RX TX DTR GND DSR RTS CTS RI DB9 Female DB9 Male ca86a Figure 1-3 HP/Agilent 24542G/H Cable 24542G/H Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6 7 8 9 PC 2 3 4 5 6 7 8 20 TX RX RTS CTS DSR GND DCD DTR DB25 Male 24542H DB9 Male DB9 Female DB25 Female 24542G
Preparing for Use Cables for Connecting to RS-232 Figure 1-5 HP/Agilent 13242G Cable 13242G Cable Instrument PC/Printer 1 2 3 8 20 Shield TX RX CD DTR 7 4 19 11 12 5 6 GND RTS SRTS SRTS DTR 1 2 3 4 5 6 7 8 12 11 19 20 DB25 Female DB25 Male DB25 Male DB25 Female TX RX RTS CTS DSR GND CD SCD SCD CTS DSR ca84a Figure 1-6 HP/Agilent 24542M Modem Cable 24542M Modem Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI DB9 Male 1 2 3 4 5 6 7 8 9 DB9 Female Modem 8 3 2 20 7 6 4 5 22 DCD RX TX DTR
Preparing for Use Cables for Connecting to RS-232 Figure 1-7 HP/Agilent C2913A/C2914A Cable C2913A/C2914A Instrument PC TX RX RTS CTS DSR GND DTR 1 2 3 4 5 6 7 20 1 2 3 4 5 6 7 20 TX RX RTS CTS DSR GND DTR DB25 Female DB25 Male DB25 Female DB25 Male DB25 Female DB25 Male DB25 Male DB25 Female ca89a Figure 1-8 Mouse Adapter (typical) Typical Mouse Adapter Instrument PC DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6 7 8 9 2 3 4 5 6 7 8 20 22 TX RX RTS CTS DSR GND DCD DTR RI DB9 Female
Preparing for Use Cables for Connecting to RS-232 Figure 1-9 HP/Agilent 24542U Cable with 5181-6641 Adapter 24542U Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6 7 8 9 DB9 Female DB9 Male 5181-6641 Adapter (Black) PC 1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9 2 3 4 5 6 7 8 20 TX RX RTS CTS DSR GND DCD DTR DB9 Female DB9 Male DB25 Female DB25 Male ca811a Figure 1-10 HP/Agilent 24542U Cable with 5181-6640 Adapter 24542U Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI 5181-6640 Ada
Preparing for Use Cables for Connecting to RS-232 Figure 1-12 HP/Agilent 24542U Cable with 5181-6639 Adapter 24542U Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI DB9 Male 1 2 3 4 5 6 7 8 9 DB9 Female 5181-6639 Adapter (Black) 1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9 DB9 Female DB9 Male Modem 1 2 3 4 5 6 7 8 9 DB9 Male DCD RX TX DTR GND DSR RTS CTS RI DB9 Female ca814a Figure 1-13 HP/Agilent F1047-80002 Cable with 5181-6641 Adapter DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6 7 8 9 DB9 Male 51
Preparing for Use Cables for Connecting to RS-232 Figure 1-15 HP/Agilent F1047-80002 Cable with 5181-6642 Adapter F1047-80002 Cable Instrument DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6 7 8 9 DB9 Male DB9 Female 5181-6642 Adapter (Gray) Modem 1 2 3 4 5 6 7 8 9 1 2 3 4 5 6 7 8 9 2 3 4 5 6 7 8 20 22 TX RX RTS CTS DSR GND DCD DTR RI DB9 Female DB9 Male DB25 Male DB25 Female ca817a Figure 1-16 HP/Agilent F1047-80002 Cable with 5181-6639 Adapter DCD RX TX DTR GND DSR RTS CTS RI 1 2 3 4 5 6
Preparing for Use Connecting to a LAN Server Connecting to a LAN Server Connect a cable to the standard LAN connector on the rear panel of the instrument. The LAN can then be used several different ways: • To ftp files from the instrument • To use telnet to send SCPI commands • To use sockets to send SCPI commands • To use as a SICL server emulating IEEE 488.2 GPIB Several LAN parameters can be queried from the front panel key menus by pressing System, Config I/O and then pressing the appropriate keys.
Preparing for Use Connecting to a GPIB Server Connecting to a GPIB Server Connect a cable to the standard GPIB connector on the rear panel of the instrument. The GPIB can then be used to send SCPI commands to control the instrument and to return measurement data to the computer. The GPIB address can be queried and set from the front panel key menus by pressing System, Config I/O, GPIB Address. This can also be done remotely using SYST:COMM:GPIB:ADDR. Pressing Preset will not change the GPIB address.
2 Programming Fundamentals 57
Programming Fundamentals • “SCPI Language Basics” on page 59. • “Improving the Speed of Your Measurements” on page 67. • “Preventing Local or Remote Interference While Programming” on page 75. • “Using the Instrument Status Registers” on page 76. • “Using the LAN to Control the Analyzer” on page 89. • “C Programming Using VTL” on page 113. • “Overview of the GPIB Bus” on page 122. • “Overview of the RS-232 Bus” on page 124.
Programming Fundamentals SCPI Language Basics SCPI Language Basics This section is not intended to teach you everything about the SCPI (Standard Commands for Programmable Instruments) programming language. The SCPI Consortium or IEEE can provide that level of detailed information. Topics covered in this chapter include: • “Creating Valid Commands” on page 60. • “Command Keywords and Syntax” on page 59. • “Special Characters in Commands” on page 61. • “Parameters in Commands” on page 62.
Programming Fundamentals SCPI Language Basics Creating Valid Commands Commands are not case sensitive and there are often many different ways of writing a particular command. These are examples of valid commands for a given command syntax: Command Syntax Sample Valid Commands [SENSe:]BANDwidth[:RESolution] The following sample commands are all identical. They will all cause the same result. • Sense:Band:Res 1700 • BANDWIDTH:RESOLUTION 1.7e3 • sens:band 1.7KHZ • SENS:band 1.7E3Hz • band 1.
Programming Fundamentals SCPI Language Basics Special Characters in Commands Special Character Meaning Example | A vertical stroke between parameters indicates alternative choices. The effect of the command is different depending on which parameter is selected. Command: TRIGger:SOURce EXTernal|INTernal|LINE The choices are external, internal, and line. Ex: TRIG:SOURCE INT is one possible command choice. [] <> A vertical stroke between keywords indicates identical effects exist for both keywords.
Programming Fundamentals SCPI Language Basics Parameters in Commands There are four basic types of parameters: booleans, keywords, variables and arbitrary block program data. OFF|ON|0|1 (Boolean) This is a two state boolean-type parameter. The numeric value 0 is equivalent to OFF. Any numeric value other than 0 is equivalent to ON. The numeric values of 0 or 1 are commonly used in the command instead of OFF or ON. Queries of the parameter always return a numeric value of 0 or 1.
Programming Fundamentals SCPI Language Basics Variable Parameters
Programming Fundamentals SCPI Language Basics Block Program Data Some parameters consist of a block of data. There are a few standard types of block data. Arbitrary blocks of program data can also be used. Is an array of rational numbers corresponding to displayed trace data. See FORMat:DATA for information about available data formats. A SCPI command often refers to a block of current trace data with a variable name such as: Trace1, TRACE2, or trace3, depending on which trace is being accessed.
Programming Fundamentals SCPI Language Basics SCPI Termination and Separator Syntax A terminator must be provided when an instrument is controlled using RS-232. There are several issues to be understood about choosing the proper SCPI terminator and separator when this is the case. There is no current SCPI standard for RS-232. Although one intent of SCPI is to be interface independent, is only defined for IEEE 488 operation.
Programming Fundamentals SCPI Language Basics The following are some examples of good and bad commands. The examples are created from a theoretical instrument with the simple set of commands indicated below: [:SENSe] :POWer [:RF] :ATTenuation 40dB :TRIGger [:SEQuence] :EXTernal [1] :SLOPe POSitive [:SENSe] :FREQuency :STARt :POWer [:RF] :MIXer :RANGe [:UPPer] Bad Command Good Command PWR:ATT 40dB POW:ATT 40dB The short form of POWER is POW, not PWR.
Programming Fundamentals Improving the Speed of Your Measurements Improving the Speed of Your Measurements There are a number of things you can do in your programs to make them run faster: “Turn off the display updates.” on page 67. “Use binary data format instead of ASCII.” on page 67. “Minimize the number of GPIB transactions.” on page 68. “Avoid unnecessary use of *RST.” on page 70. “Minimize DUT/instrument setup changes.” on page 70. “Consider using LAN instead of GPIB.” on page 70.
Programming Fundamentals Improving the Speed of Your Measurements To parse the data: • Read two characters (#D), where D tells you how many N characters follow the D character. • Read D characters, the resulting integer specifies the number of data bytes sent. • Read the bytes into a real array. For example, suppose the header is #512320. • The first character/digit in the header (5) tells you how many additional digits there are in the header.
Programming Fundamentals Improving the Speed of Your Measurements If you are doing bottom/middle/top measurements on base stations, you can reduce transactions by making a time slot active at each of the B,M,T frequencies. Then issue three measurements at once in the programming code and retrieve three data sets with just one GPIB transaction pair (write, read).
Programming Fundamentals Improving the Speed of Your Measurements Avoid unnecessary use of *RST. Remember that while *RST does not change the current mode, it presets all the measurements and settings to their factory defaults. This forces you to reset your analyzer’s measurement settings even if they use similar mode settings or measurement settings. See Minimize DUT/instrument setup changes. below. Also remember that *RST command puts the instrument in the single measurement (or sweep) mode.
Programming Fundamentals Improving the Speed of Your Measurements These types of measurements begin tuned to the signal, then tune away from it and must be able to reset the attenuation value as needed. Optimize your GSM output RF spectrum switching measurement. For ORFS (switching), setting the break frequency to zero (0) puts the analyzer in a measurement setup where it can use a direct time measurement algorithm, instead of an FFT-based algorithm. This non-FFT approach is faster.
Programming Fundamentals Improving the Speed of Your Measurements These two commands are repeated until the condition is set, so we know that the trigger is armed and ready. • Trigger your DUT to send the burst. • Return the measurement data to your computer. NOTE This process cannot be done by using with the current VXI plug-n-play driver implementation. You will need to use the above SCPI commands.
Programming Fundamentals Improving the Speed of Your Measurements There are two versions of this command depending on your firmware revision. Earlier revisions require the optional variables be entered in terms of their position in the trace data array. Versions after A.05.00 allow the variables to be entered in terms of time. For early firmware revisions you need to know the sample interval. In the waveform measurement it is equal to the aperture value.
Programming Fundamentals Improving the Speed of Your Measurements Table 2-1 GSM Parameters for 1 Slot/Frame Measurement Requirements Resolution Bandwidth Filter Type Decimation Aperture Start Length Repeat 300 kHz Flat 1 0.6667 µsec 36 789 865.31 300 kHz Flat 4 2.667 µsec 9 197 216.33 a. The use of time values is only allowed in firmware versions of A.05.00 and later.
Programming Fundamentals Preventing Local or Remote Interference While Programming Preventing Local or Remote Interference While Programming The following SCPI commands can help prevent interference from other users while you are programming the instrument remotely. See the SYSTem subsystem section of the Language Reference chapter for a full description of these commands. • :SYSTem:KLOCk 0|1|OFF|ON locks the transmitter tester’s keyboard.
Programming Fundamentals Using the Instrument Status Registers Using the Instrument Status Registers When you are programming the instrument you may need to monitor instrument status to check for error conditions or monitor changes.You can determine the state of certain instrument events/conditions by programming the status register system. IEEE common commands (those beginning with *) access the higher-level summary registers.
Programming Fundamentals Using the Instrument Status Registers Condition Register Reports the real-time state of the signals monitored by this register set.There is no latching or buffering for a condition register. Positive Transition Register This filter register controls which signals will set a bit in the event register when the signal makes a low to high transition (when the condition bit changes from 0 to 1).
Programming Fundamentals Using the Instrument Status Registers What are the Status Register SCPI Commands? Most monitoring of the instrument conditions is done at the highest level using the IEEE common commands indicated below. Complete command descriptions are available in the IEEE commands section at the beginning of the language reference. Individual status registers can be set and queried using the commands in the STATus subsystem of the language reference.
Programming Fundamentals Using the Instrument Status Registers Use the SRQ method when: — — — — you need time-critical notification of changes you are monitoring more than one device which supports SRQs you need to have the controller do something else while waiting you can’t afford the performance penalty inherent to polling Use polling when: — your programming language/development environment does not support SRQ interrupts — you want to write a simple, single-purpose program and don’t want the added c
Programming Fundamentals Using the Instrument Status Registers Using a Status Register Each bit in a register is represented by a numerical value based on its location. See Figure 2-1 below. This number is sent with the command, to enable a particular bit. If you want to enable more than one bit, you would send the sum of all the bits that you are interested in. For example, to enable bit 0 and bit 6 of standard event status register, you would send the command *ESE 65 because 1 + 64 = 65.
Programming Fundamentals Using the Instrument Status Registers Generating a Service Request To use the SRQ method, you must understand how service requests are generated. Bit 6 of the status byte register is the request service (RQS) bit. The *SRE command is used to configure the RQS bit to report changes in instrument status. When such a change occurs, the RQS bit is set. It is cleared when the status byte register is queried using *SRE? (with a serial poll.
Programming Fundamentals Using the Instrument Status Registers Overall Status Register System 82 Chapter 2
Programming Fundamentals Using the Instrument Status Registers Status Byte Register The RQS bit is read and reset by a serial poll. MSS (the same bit position) is read, non-destructively by the *STB? command. If you serial poll bit 6 it is read as RQS, but if you send *STB it reads bit 6 as MSS. For more information refer to IEEE 488.2 standards, section 11.
Programming Fundamentals Using the Instrument Status Registers Bit Description 0, 1 These bits are always set to 0. 2 A 1 in this bit position indicates that the SCPI error queue is not empty which means that it contains at least one error message. 3 A 1 in this bit position indicates that the data questionable summary bit has been set. The data questionable event register can then be read to determine the specific condition that caused this bit to be set.
Programming Fundamentals Using the Instrument Status Registers In addition to the status byte register, the status byte group also contains the service request enable register. This register lets you choose which bits in the status byte register will trigger a service request. Send the *SRE command where is the sum of the decimal values of the bits you want to enable plus the decimal value of bit 6.
Programming Fundamentals Using the Instrument Status Registers Standard Event Status Register 86 Chapter 2
Programming Fundamentals Using the Instrument Status Registers The standard event status register contains the following bits: Bit Description 0 A 1 in this bit position indicates that all pending operations were completed following execution of the *OPC command. 1 This bit is always set to 0. (The instrument does not request control.) 2 A 1 in this bit position indicates that a query error has occurred. Query errors have SCPI error numbers from −499 to −400.
Programming Fundamentals Using the Instrument Status Registers In addition to the standard event status register, the standard event status group also contains a standard event status enable register. This register lets you choose which bits in the standard event status register will set the summary bit (bit 5 of the status byte register) to 1. Send the *ESE command where is the sum of the decimal values of the bits you want to enable.
Programming Fundamentals Using the LAN to Control the Analyzer Using the LAN to Control the Analyzer Refer to the User’s Guide “Using System Features” chapter for information about configuring the analyzer input/output settings from the front panel. Use the SYSTem commands to change settings remotely. NOTE Remember that in any type programming using LAN you should avoid constantly opening and closing connections.
Programming Fundamentals Using the LAN to Control the Analyzer The Standard UNIX FTP Command: Synopsis ftp [-g] [-i] [-n] [-v] [server-host] [-B DataSocketBufferSize] Description The ftp command is used to transfer files using the File Transfer Protocol. ftp transfers files over a network connection between a local machine and the remote server-host. Options and Parameters When ftp is invoked with a server-host specified, a connection is opened immediately. Otherwise, ftp waits for user commands.
Programming Fundamentals Using the LAN to Control the Analyzer Table 2-2 ftp Commands Command Description ls [remote_directory] Lists the contents of the specified remote_directory. If the remote_directory is unspecified, the contents of the current remote directory are listed. mget remote_file [local_file] Copy remote_file to the local system. If local_file is unspecified, ftp uses the remote_file name as the local_file name. mput local_file [remote_file] Copies local_file to remote file.
Programming Fundamentals Using the LAN to Control the Analyzer Using Telnet to Send Commands Using telnet to send commands to your analyzer works in a similar way to communicating over GPIB. You establish a connection with the analyzer, and then send or receive information using SCPI commands. NOTE If you need to control the GPIB using “device clear” or SRQ’s, you can use SICL LAN. SICL LAN provides control of your analyzer via IEEE 488.2 GPIB over the LAN.
Programming Fundamentals Using the LAN to Control the Analyzer The small program above sets the analyzer to measure a signal in the frequency domain, places a marker on the maximum point, and then queries the analyzer for the amplitude of the marker. You need to press Enter after typing in each command. After pressing Enter on the last line in the example above, the analyzer returns the amplitude level of the marker to your computer and displays it on the next line.
Programming Fundamentals Using the LAN to Control the Analyzer The Standard UNIX TELNET Command: Synopsis telnet [host [port]] Description The telnet command is used to communicate with another host using the TELNET protocol. When telnet is invoked with host or port arguments, a connection is opened to host, and input is sent from the user to host. Options and Parameters telnet operates in line-by-line mode or in character-at-a-time mode. In line-by-line mode, typed text is first echoed on the screen.
Programming Fundamentals Using the LAN to Control the Analyzer Using SICL LAN to Control the Analyzer SICL LAN is a LAN protocol using the Standard Instrument Control Library (SICL). It provides control of your analyzer over the LAN, using a variety of computing platforms, I/O interfaces, and operating systems. With SICL LAN, you control your remote analyzer over the LAN with the same methods you use for a local analyzer connected directly to the controller with the GPIB.
Programming Fundamentals Using the LAN to Control the Analyzer Emulated GPIB Address The emulated GPIB address (bus address) is assigned to the device to be controlled using SICL LAN. The emulated GPIB address is automatically set to be the same as the current GPIB address. The instrument is shipped with the emulated GPIB address set to 18. The SICL LAN server uses the GPIB name, GPIB logical unit number, and GPIB address configuration on the SICL LAN client to communicate with the client.
Programming Fundamentals Using the LAN to Control the Analyzer 8. Select VISA LAN Client from the available interface types. 9. Press Configure. 10.Enter a VISA interface name, such as GPIB1. 11.Enter the hostname or IP address of your analyzer in the hostname field, such as my4406a.companyname.com 12.Enter a Remote SICL address, such as GPIB1. 13.Set the LAN interface to match the defined LAN client (lan1 in this example). 14.Select OK. 15.Close I/O Configuration by selecting OK.
Programming Fundamentals Using the LAN to Control the Analyzer After you have the VISA/SICL LAN I/O drivers installed, perform the steps below to set up VEE to control your analyzer: 1. On your computer or workstation, select I/O|Instrument Manager. Figure 2-3 I/O|Instrument Manager Menu 2. Add a new GPIB device with an address of 7XX, where XX is the GPIB device address from your analyzer.
Programming Fundamentals Using the LAN to Control the Analyzer Figure 2-4 Adding Your Analyzer as a VEE Device Chapter 2 99
Programming Fundamentals Using the LAN to Control the Analyzer To send SCPI commands to the analyzer, select I/O|Instrument Manager, and the GPIB device just added. Select Direct I/O. You can now type SCPI commands in the command window, and they are sent over the LAN to your analyzer. Figure 2-5 Sending SCPI Commands Directly to your Analyzer See the VEE example program for more details.
Programming Fundamentals Using the LAN to Control the Analyzer Controlling Your Analyzer with SICL LAN and HP/Agilent BASIC for Windows Before you can use HP/Agilent BASIC for Windows with SICL LAN, you need to set up VISA/SICL LAN I/O drivers for use with your BASIC applications. Consult your BASIC documentation for information how to do this.
Programming Fundamentals Using the LAN to Control the Analyzer Controlling Your Analyzer with SICL LAN and BASIC for UNIX (Rocky Mountain BASIC) Before you can use Rocky Mountain Basic (HPRMB) with SICL LAN, you will need to set up the SICL LAN I/O drivers for HPRMB. Consult your system administrator for details. Create a .
Programming Fundamentals Using the LAN to Control the Analyzer Using HP/Agilent VEE Over Socket LAN To control your analyzer via socket LAN using VEE, click on the VEE menu titled "I/O." Then select "To/From Socket" and position the I/O object box on the screen. Fill in the following fields: Connect Port: Host Name: Timeout: 5025 15 For faster troubleshooting, you may want to set the timeout to a smaller number.
Programming Fundamentals Using the LAN to Control the Analyzer Using a Java™ Applet Over Socket LAN The example program “Using Java Programming Over Socket LAN” on page 171 demonstrates simple socket programming with Java. It is written in Java programming language, and will compile with Java compilers versions 1.0 and above. This program is on your documentation CD ROM that shipped with the product.
Programming Fundamentals Using the LAN to Control the Analyzer General LAN Troubleshooting • “Troubleshooting the Initial Connection” on page 105 • “Common Problems After You’ve Made the Connection” on page 107 • “Pinging the Analyzer from Your Computer or Workstation” on page 109 • “EIA/TIA 568B Wiring Information” on page 111 Troubleshooting the Initial Connection Getting the analyzer to work with your network often requires detailed knowledge of your local network software.
Programming Fundamentals Using the LAN to Control the Analyzer Communications Not Established If you have just installed and configured the LAN interface and you have never been able to access the analyzer via ftp or telnet, go directly to “Pinging the Analyzer from Your Computer or Workstation” on page 109.
Programming Fundamentals Using the LAN to Control the Analyzer Packets Routinely Lost If packets are routinely lost, proceed to the troubleshooting section in this chapter relating to your network. Problems Transferring or Copying Files If you have problems copying files out of or into the analyzer, you might be experiencing timeout problems. See the previous section on "Timeout Errors.
Programming Fundamentals Using the LAN to Control the Analyzer You cannot access the file system via ftp • If you get a "connection refused" message, try the following solutions: — If the power to the analyzer was just turned on, make sure that you wait about 25 seconds before attempting the connection. • If you get a "connection timed out" message — Verify the LAN connection between your computer and the analyzer. Refer to "If you cannot connect to the analyzer" earlier in this section.
Programming Fundamentals Using the LAN to Control the Analyzer Pinging the Analyzer from Your Computer or Workstation Verify the communications link between the computer and the analyzer remote file server using the ping utility. From a UNIX workstation, type: ping hostname 64 10 where 64 is the packet size, and 10 is the number of packets transmitted. From a DOS or Windows environment, type: ping hostname 10 where 10 is the number of echo requests.
Programming Fundamentals Using the LAN to Control the Analyzer Check that the hostname and IP address are correctly entered in the node names database. If you are using a UNIX environment, ping each node along the route between your workstation and the analyzer, starting with the your workstation. Ping each gateway, then attempt a ping of the remote file server. If the analyzer still does not respond to ping, then you should suspect a hardware problem with the analyzer.
Programming Fundamentals Using the LAN to Control the Analyzer EIA/TIA 568B Wiring Information Table 2-3 Straight-Through Cable (Unshielded-twisted-pair (UTP) cable with RJ-45 connectors) Standard, Straight-Through Wiring (each end) Signal Name RJ-45 Pin # Wire Color Pair # RX+ 1 white/orange 2 RX- 2 orange TX+ 3 white/green TX- 6 green Not Used 4 blue 5 white/blue 7 white/brown 8 brown 3 1 4 Table 2-4 Cross-Over Cable (Unshielded-twisted-pair (UTP) cable with RJ-45 connectors
Programming Fundamentals Using the LAN to Control the Analyzer NOTE A convenient way to make a cross-over adapter is to use two RJ-45 jacks wired according to Table 2-4. Standard straight-through patch cables can then be used from the analyzer to the adapter, and from the adapter to other LAN devices. If you use a special-purpose adapter, you will avoid having a cross-over cable mistaken for a standard, straight-through patch cable.
Programming Fundamentals C Programming Using VTL C Programming Using VTL The programming examples that are provided are written using the C programming language and the HP/Agilent VTL (VISA transition library). This section includes some basic information about programming in the C language. Refer to your C programming language documentation for more details. (This information is taken from the manual “VISA Transition Library”, part number E2090-90026.
Programming Fundamentals C Programming Using VTL viPrintf viScanf viClose These are the VTL formatted I/O functions that are patterned after those used in the C programming language. The viPrintf call sends the IEEE 488.2 *RST command to the instrument and puts it in a known state. The viPrintf call is used again to query for the device identification (*IDN?). The viScanf call is then used to read the results. This function must be used to close each session.
Programming Fundamentals C Programming Using VTL • Select Project | Update All Dependencies from the menu. • Select Project | Settings from the menu. Click on the C/C++ button. Select Code Generation from the Use Run-Time Libraries list box. VTL requires these definitions for WIN32. Click on OK to close the dialog boxes. • Select Project | Settings from the menu. Click on the Link button and add visa32.lib to the Object / Library Modules list box.
Programming Fundamentals C Programming Using VTL 16-bit Applications The following is a summary of important compiler-specific considerations for the Windows compiler. For Microsoft Visual C++ version 1.5: • To set the memory model, do the following: 1. Select Options | Project. 2. Click on the Compiler button, then select Memory Model from the Category list. 3. Click on the Model list arrow to display the model options, and select Large. 4. Click on OK to close the Compiler dialog box.
Programming Fundamentals C Programming Using VTL viClose (vi); viClose (defaultRM); } Including the VISA Declarations File For C and C++ programs, you must include the visa.h header file at the beginning of every file that contains VTL function calls: #include “visa.h” This header file contains the VISA function prototypes and the definitions for all VISA constants and error codes. The visa.h header file includes the visatype.h header file. The visatype.h header file defines most of the VISA types.
Programming Fundamentals C Programming Using VTL NOTE All devices that you will be using need to be connected and in working condition prior to the first VTL function call (viOpenDefaultRM). The system is configured only on the first viOpenDefaultRM per process. Therefore, if viOpenDefaultRM is called without devices connected and then called again when devices are connected, the devices will not be recognized.
Programming Fundamentals C Programming Using VTL vi This is a pointer to the session identifier for this particular device session. This pointer will be used to identify this device session when using other VTL functions. The following is an example of opening sessions with a GPIB multimeter and a GPIB-VXI scanner: ViSession defaultRM, dmm, scanner; . .
Programming Fundamentals C Programming Using VTL The following describes the parameters used above: board VSI logical address This is the logical address of the VXI instrument. primary address This is the primary address of the GPIB device. secondary address INSTR NOTE This optional parameter is used if you have more than one interface of the same type. The default value for board is 0. This optional parameter is the secondary address of the GPIB device.
Programming Fundamentals C Programming Using VTL Closing a Session The viClose function must be used to close each session. You can close the specific device session, which will free all data structures that had been allocated for the session. If you close the default resource manager session, all sessions opened using that resource manager will be closed.
Programming Fundamentals Overview of the GPIB Bus Overview of the GPIB Bus GPIB Instrument Nomenclature An instrument that is part of an GPIB network is categorized as a listener, talker, or controller, depending on its current function in the network. Listener A listener is a device capable of receiving data or commands from other instruments. Any number of instruments in the GPIB network can be listeners simultaneously.
Programming Fundamentals Overview of the GPIB Bus • A local function that is the complement to the remote command, causing an instrument to return to local control with a fully enabled front panel (sometimes called: local, resume). • A clear function that causes all GPIB instruments, or addressed instruments, to assume a cleared condition. The definition of clear is unique for each instrument (sometimes called: clear, reset, control, send).
Programming Fundamentals Overview of the RS-232 Bus Overview of the RS-232 Bus This feature is not implemented. Serial interface programming techniques are similar to most general I/O applications. Refer to your programming language documentation for information on how to initiate the card and verify the status. Due to the asynchronous nature of serial I/O operations, special care must be exercised to ensure that data is not lost by sending to another device before the device is ready to receive.
Programming Fundamentals Overview of the RS-232 Bus Character Format Parameters To define the character format, you must know the requirements of the peripheral device for the following parameters: • Character Length: Eight data bits are used for each character, excluding start, stop, and parity bits. • Parity Enable: Parity is disabled (absent) for each character. • Stop Bits: One stop bit is included with each character.
Programming Fundamentals Overview of the RS-232 Bus Data Transfer Errors The serial interface can generate several types of errors when certain conditions are encountered while receiving data from the peripheral device. Errors can be generated by any of the following conditions: • Parity error. The parity bit on an incoming character does not match the parity expected by the receiver. This condition is most commonly caused by line noise. • Framing error.
3 Programming Examples 127
Programming Examples Types of Examples Types of Examples This section includes examples of how to program the instrument using the instrument SCPI programming commands. Most of the examples are written for a PC, using GPIB. They are written in C using the Agilent VISA transition library. The VISA transition library must be installed and the GPIB card configured. The Agilent I/O libraries contain the latest VISA transition library and is available at: www.agilent.com/iolib.
Programming Examples Using Markers Using Markers This is the C programming example Markers.c. /*************************************************************************** *Markers.
Programming Examples Using Markers #include #include "visa.
Programming Examples Using Markers while (!lComplete) viScanf (viVSA,"%d",&lComplete); /*assign marker 1 to the average trace of the spectrum*/ viPrintf(viVSA, "CALC:SPEC:MARK1:TRAC ASP\n"); /*put the marker 1 on the signal peak*/ viPrintf(viVSA, "CALC:SPEC:MARK1:MAX\n"); /*query the 50 MHz signal amplitude*/ viPrintf(viVSA, "CALC:SPEC:MARK1:Y?\n"); /*get the the 50 MHz signal amplitude*/ viScanf (viVSA,"%lf",&dPeakPower); /*assign marker 2 to the average trace of the spectrum*/ viPrintf(viVSA, "CALC:SPEC:M
Programming Examples Saving Binary Trace Data in an ASCII File Saving Binary Trace Data in an ASCII File This is the C programming example Trace.c /*************************************************************************** *Trace.c *Agilent Technologies 2001 * *E4406A VSA Series Transmitter Tester using VISA for I/O *This Program shows how to get and save a binary trace data * *Set up VSA commands so they can be done FAST (all in one transaction). *Reset the device and clear status.
Programming Examples Saving Binary Trace Data in an ASCII File ViSession defaultRM, viVSA; ViStatus viStatus= 0; char sBuffer[80]= {0}; FILE *fTraceFile; long lNumberPoints= 0; long lNumberBytes= 0; long lLength= 0; long i = 0; unsigned long lBytesRetrieved; ViReal64 adTraceArray[10240]; char *vsaSetup = /* setup commands for VSA */ "*RST;*CLS;"/* Reset the device and clear status */ ":FEED AREF;"/* set the input port to the internal 50MHz reference source*/ ":DISP:FORM:ZOOM1;"/* zoom the spectrum display*
Programming Examples Saving Binary Trace Data in an ASCII File viPrintf(viVSA,"%s\n",vsaSetup); /*print message to the standard output*/ printf("Getting the spectrum trace in binary format...\nPlease wait...
Programming Examples Saving Binary Trace Data in an ASCII File /*set the analyzer to continuous mode for manual use */ viPrintf(viVSA, "INIT:CONT 1\n"); /*save trace data to an ASCII file*/ fTraceFile=fopen("C:\\Trace.txt","w"); fprintf(fTraceFile,"Trace.exe Output\nAgilent Technologies 2001\n\n"); fprintf(fTraceFile,"List of %d points of the averaged spectrum trace:\n\n",lNumberPoints); for (i=0;i
Programming Examples Saving ASCII Trace Data in an ASCII File Saving ASCII Trace Data in an ASCII File This is the C programming example TraceASC.c /*************************************************************************** *TraceASC.
Programming Examples Saving ASCII Trace Data in an ASCII File ViSession defaultRM, viVSA; ViStatus viStatus= 0; char sTraceInfo [256]= {0}; char sTraceBuffer[1024*100]= {0}; FILE *fTraceFile; long lComplete= 0; unsigned long lBytesRetrieved; /*open session to GPIB device at address 18 */ viStatus=viOpenDefaultRM (&defaultRM); viStatus=viOpen (defaultRM, "GPIB0::18::INSTR", VI_NULL,VI_NULL, &viVSA); /*check opening session sucess*/ if(viStatus) { printf("Could not open a session to GPIB device at address 1
Programming Examples Saving ASCII Trace Data in an ASCII File /*query the spectrum trace data*/ viPrintf(viVSA, "FETCH:SPEC7?\n"); /*save the spectrum trace data to buffer*/ viRead (viVSA,(ViBuf)sTraceBuffer,1024*100,&lBytesRetrieved); /*set the analyzer back to continuous mode*/ viPrintf(viVSA, "INIT:CONT 1\n"); /*save trace data to an ASCII file*/ fTraceFile=fopen("C:\\TraceASC.txt","w"); fprintf(fTraceFile,"TraceASC.
Programming Examples Saving and Recalling Instrument State Data Saving and Recalling Instrument State Data This is the C programming example State.c /*************************************************************************** *State.
Programming Examples Saving and Recalling Instrument State Data #include #include #include #include "visa.
Programming Examples Saving and Recalling Instrument State Data viPrintf(viVSA, "INIT:IMM;*WAI\n"); /*save this state in register 10.
Programming Examples Saving and Recalling Instrument State Data viPrintf(viVSA, "INIT:CONT 1\n"); /* close session */ viClose (viVSA); viClose (defaultRM); } 142 Chapter 3
Programming Examples Performing Alignments and Getting Pass/Fail Results Performing Alignments and Getting Pass/Fail Results This is the C programming example Align.c /************************************************************ *Align.
Programming Examples Performing Alignments and Getting Pass/Fail Results viStatus=viOpen (defaultRM, "GPIB0::18::INSTR", VI_NULL,VI_NULL, &viVSA); /*check opening session sucess*/ if(viStatus) { printf("Could not open a session to GPIB device at address 18!\n"); exit(0); } /*increase timeout to 75 sec*/ viSetAttribute(viVSA,VI_ATTR_TMO_VALUE,75000); /*Lock out the front panel keypad*/ viPrintf(viVSA, "SYST:KLOCK 1\n"); /*reset the analyzer*/ viPrintf(viVSA, "*RST\n"); /*print message*/ printf("The auto-alig
Programming Examples Making an ACPR Measurement in cdmaOne (Option BAC) Making an ACPR Measurement in cdmaOne (Option BAC) This is the C programming example ACPR.c /*************************************************************************** *ACPR.
Programming Examples Making an ACPR Measurement in cdmaOne (Option BAC) ViStatus viStatus char sTraceInfo = 0; [1024]= {0}; FILE *fTraceFile; unsigned long lBytesRetrieved; /*open session to GPIB device at address 18 */ viStatus=viOpenDefaultRM (&defaultRM); viStatus=viOpen (defaultRM, "GPIB0::18::INSTR", VI_NULL,VI_NULL, &viVSA); /*check opening session sucess*/ if(viStatus) { printf("Could not open a session to GPIB device at address 18!\n"); exit(0); } /*increase timeout to 60 sec*/ viSetAttribute(viV
Programming Examples Making an ACPR Measurement in cdmaOne (Option BAC) /*print message to the standard output*/ printf("The The ACPR Measurement Result was saved to C:\\ACPR.
Programming Examples Using C Programming Over Socket LAN Using C Programming Over Socket LAN This is the C programming example socketio.c. It demonstrates simple socket programming. It is written in C, and compiles in the HP-UX UNIX environment, or the WIN32 environment. It is portable to other UNIX environments with only minor changes. In UNIX, LAN communication via sockets is very similar to reading or writing a file.
Programming Examples Using C Programming Over Socket LAN * E4406A Examples: * * * Query the center frequency: lanio 15.4.43.
Programming Examples Using C Programming Over Socket LAN */ /* Support both Win32 and HP-UX UNIX environment */ #ifdef _WIN32 # /* Visual C++ 4.0 will define this */ define WINSOCK #endif #ifndef WINSOCK # ifndef _HPUX_SOURCE # define _HPUX_SOURCE # endif #endif #include /* for fprintf and NULL */ #include /* for memcpy and memset */ #include /* for malloc(), atol() */ #include /* for strerror */ #ifdef WINSOCK #include
Programming Examples Using C Programming Over Socket LAN #endif /* WINSOCK */ #ifdef WINSOCK /* Declared in getopt.c. See example programs disk. */ extern char *optarg; extern int optind; extern int getopt(int argc, char * const argv[], const char* optstring); #else # include
Programming Examples Using C Programming Over Socket LAN WORD wVersionRequested; WSADATA wsaData; int err; wVersionRequested = MAKEWORD(1, 1); wVersionRequested = MAKEWORD(2, 0); err = WSAStartup(wVersionRequested, &wsaData); if (err != 0) { /* Tell the user that we couldn’t find a useable */ /* winsock.dll. */ fprintf(stderr, "Cannot initialize Winsock 1.1.
Programming Examples Using C Programming Over Socket LAN * Use 5025 for the SCPI port. * * $Return: (int) . . . . . . . . A file descriptor similar to open(1).
Programming Examples Using C Programming Over Socket LAN memcpy(&peeraddr_in.sin_addr.s_addr, hostPtr->h_addr, hostPtr->h_length); peeraddr_in.sin_family = AF_INET; peeraddr_in.
Programming Examples Using C Programming Over Socket LAN /* fprintf(stderr, "Sending \"%s\".\n", command); */ if (strchr(command, ’\n’) == NULL) { fprintf(stderr, "Warning: missing newline on command %s.
Programming Examples Using C Programming Over Socket LAN /* If we hit a newline, stop. */ if (*ptr == ’\n’) { ptr++; err = 0; break; } ptr++; } *ptr = ’\0’; if (err) { return NULL; } else { return result; } #else /*********************************************************************** * Simpler UNIX version, using file I/O. recv() version works too. * This demonstrates how to use file I/O on sockets, in UNIX.
Programming Examples Using C Programming Over Socket LAN /*************************************************************************** * > $Function: queryInstrument$ * * $Description: send a SCPI command to the instrument, return a response.$ * * $Parameters: $ * (FILE *) . . . . . . . . . file pointer associated with TCP/IP socket. * (const char *command) * (char *result) . . . . . . where to put the result. * (size_t) maxLength . . . . maximum size of result array in bytes. . .
Programming Examples Using C Programming Over Socket LAN count = recv(sock, tmp_buf, 1, 0); /* read 1 char */ ch = tmp_buf[0]; if ((count < 1) || (ch == EOF) || (ch == ’\n’)) { *result = ’\0’; /* null terminate result for ascii */ return 0; } /* use a do-while so we can break out */ do { if (ch == ’#’) { /* binary data encountered - figure out what it is */ long numDigits; long numBytes = 0; /* char length[10]; */ count = recv(sock, tmp_buf, 1, 0); /* read 1 char */ ch = tmp_buf[0]; if ((count < 1) |
Programming Examples Using C Programming Over Socket LAN resultBytes = 0; /* Loop until we get all the bytes we requested. */ /* Each call seems to return up to 1457 bytes, on HP-UX 9.05 */ do { int rcount; rcount = recv(sock, result, (int)numBytes, 0); resultBytes += rcount; result += rcount; /* Advance pointer */ } while ( resultBytes < numBytes ); /************************************************************ * For LAN dumps, there is always an extra trailing newline * Since there is no EOI line.
Programming Examples Using C Programming Over Socket LAN *result = (char)ch; if (recv_line(sock, result+1, maxLength-1) == NULL) return 0; /* REMOVE trailing newline, if present. And terminate string.
Programming Examples Using C Programming Over Socket LAN * +0,"No error" * Don’t bother decoding. ******************************************************************/ if (strncmp(result_str, "+0,", 3) == 0) { /* Matched +0,"No error" */ break; } puts(result_str); } while (1); } /*************************************************************************** * > $Function: isQuery$ * * $Description: Test current SCPI command to see if it a query. $ * * $Return: (unsigned char) . . .
Programming Examples Using C Programming Over Socket LAN /* Make sure we don’t have a marker value query, or * any command with a ’?’ followed by a ’)’ character. * This kind of command is not a query from our point of view. * The analyzer does the query internally, and uses the result.
Programming Examples Using C Programming Over Socket LAN SOCKET instSock; char *charBuf = (char *) malloc(INPUT_BUF_SIZE); char *basename; int chr; char command[1024]; char *destination; unsigned char quiet = 0; unsigned char show_errs = 0; int number = 0; basename = strrchr(argv[0], ’/’); if (basename != NULL) basename++ ; else basename = argv[0]; while ( ( chr = getopt(argc,argv,"qune")) != EOF ) switch (chr) { case ’q’: quiet = 1; break; case ’n’: number = 1; break ; case ’e’: show_errs = 1; break
Programming Examples Using C Programming Over Socket LAN if (optind < argc) { strcat(command, " "); } else { strcat(command, "\n"); } } } else { /* Only provided; input on */ strcpy(command, ""); if (optind > argc) { usage(basename); exit(1); } } } else { /* no hostname! */ usage(basename); exit(1); } /**********************************************/ /* open a socket connection to the instrument */ /**********************************************/ #ifdef WINSOCK if (init_winsock() != 0) {
Programming Examples Using C Programming Over Socket LAN if (instSock == INVALID_SOCKET) { fprintf(stderr, "Unable to open socket.\n"); return 1; } /* fprintf(stderr, "Socket opened.\n"); */ if (strlen(command) > 0) { /********************************************************/ /* if the command has a ’?’ in it, use queryInstrument. */ /* otherwise, simply send the command.
Programming Examples Using C Programming Over Socket LAN if ( *charBuf == ’#’ || *charBuf == ’!’ ) continue ; strcat(charBuf, "\n"); if (!quiet) { if (number) { char num[10]; sprintf(num,"%d: ",number); fwrite(num, strlen(num), 1, stdout); } fwrite(charBuf, strlen(charBuf), 1, stdout) ; fflush(stdout); } if ( isQuery(charBuf) ) { long bufBytes; /* Put the query response into the same buffer as the * command string appended after the null terminator.
Programming Examples Using C Programming Over Socket LAN else { commandInstrument(instSock, charBuf); } if (number) number++; } } if (show_errs) { showErrors(instSock); } #ifdef WINSOCK closesocket(instSock); close_winsock(); #else close(instSock); #endif /* WINSOCK */ return 0; } /* End of lanio.
Programming Examples Using C Programming Over Socket LAN (Windows NT) Using C Programming Over Socket LAN (Windows NT) This is the C programming example getopt.c that demonstrates simple socket programming. It is written in C, and compiles in the Windows NT environment. In Windows, the routines send() and recv() must be used, since fread() and fwrite() may not work on sockets. The program reads the analyzer’s host name from the command line, followed by the SCPI command.
Programming Examples Using C Programming Over Socket LAN (Windows NT) getopt places in optind the argv index of the next argument to be processed. The external variable optind is initialized to 1 before the first call to the function getopt. When all options have been processed (i.e., up to the first non-option argument), getopt returns EOF. The special option -- can be used to delimit the end of the options; EOF is returned, and -- is skipped.
Programming Examples Using C Programming Over Socket LAN (Windows NT) } scan = argv[optind]+1; optind++; } c = *scan++; posn = strchr(optstring, c); /* DDP */ if (posn == NULL || c == ’:’) { fprintf(stderr, "%s: unknown option -%c\n", argv[0], c); return(’?’); } posn++; if (*posn == ’:’) { if (*scan != ’\0’) { optarg = scan; scan = NULL; } else { optarg = argv[optind]; optind++; } } return(c); } 170 Chapter 3
Programming Examples Using Java Programming Over Socket LAN Using Java Programming Over Socket LAN This is the Java programming example ScpiDemo.java that demonstrates simple socket programming with Java. It is written in Java programming language, and will compile with Java compilers versions 1.0 and above. import java.awt.*; import java.io.*; import java.net.*; import java.applet.*; // This is a SCPI Demo to demonstrate how one can communicate with the // E4406A VSA with a JAVA capable browser.
Programming Examples Using Java Programming Over Socket LAN Panel p; // Initialize the applets public void init() { SetupSockets(); SetupPanels(); // Set up font type for both panels Font font = new Font("TimesRoman", Font.BOLD,14); scpiResponse.setFont(font); scpiCommand.setFont(font); scpiResponse.appendText("SCPI Demo Program: Response messages\n"); scpiResponse.
Programming Examples Using Java Programming Over Socket LAN public boolean action(Event evt, Object what) { // If this is the correct target if (evt.target == scpiCommand) { // Get the scpi command String str = scpiCommand.getText(); // Send it out to the Scpi socket sck.ScpiWriteLine(str); String tempStr = str.toLowerCase(); // If command str is "syst:err?", don’t need to send another one. if ( (tempStr.indexOf("syst") == -1) || (tempStr.indexOf("err") == -1) ) { // Query for any error sck.
Programming Examples Using Java Programming Over Socket LAN // Clear the error queue before starting the thread // in case if there’s any error messages from the previous actions while ( str.indexOf("No error") == -1 ) { sck.ScpiWriteLine("syst:err?"); str = sck.ScpiReadLine(); } // Start receiving response or error messages while(true) { str = sck.ScpiReadLine(); if ( str != null ) { // If response messages is "No error", do no display it, // replace it with "OK" instead. if ( str.
Programming Examples Using Java Programming Over Socket LAN p.add("West", new Label("SCPI command:")); p.add("Center", scpiCommand); southPanel.add(p); // Set up the Response panel setLayout(new BorderLayout(2,2)); add("Center", scpiResponse); add("South", southPanel); } } // Socks class is responsible for open/close/read/write operations // from the predefined socket ports. // the only port used is 5025 for the SCPI port. For this example program, class Socks extends java.applet.
Programming Examples Using Java Programming Over Socket LAN Socks(URL appletB) { appletBase = appletB; // Set up for port array.
Programming Examples Using Java Programming Over Socket LAN } } // Close the socket(s) if opened public void CloseSocket(int s) { try { if ( sockOpen[s] == true ) { // write blank line to exit servers elegantly sockOut[s].println(); sockOut[s].flush(); sockIn[s].close(); sockOut[s].close(); sock[s].close(); sockOpen[s] = false; } } catch (IOException e) { System.out.println("Sock, Close Error "+e.
Programming Examples Using Java Programming Over Socket LAN //************* Socket I/O routines. //*** I/O routines for SCPI socket // Write an ASCII string with carriage return to SCPI socket public void ScpiWriteLine(String command) { if ( SockOpen(SCPI) ) { sockOut[SCPI].println(command); sockOut[SCPI].flush(); } } // Read an ASCII string, terminated with carriage return from SCPI socket public String ScpiReadLine() { try { if ( SockOpen(SCPI) ) { return sockIn[SCPI].
Programming Examples Using Java Programming Over Socket LAN catch (IOException e) { System.out.println("Scpi Read Byte Error "+e.
Programming Examples Using Java Programming Over Socket LAN 180 Chapter 3
4 Programming Command Cross References 181
Programming Command Cross References Functional Sort of SCPI Commands Functional Sort of SCPI Commands Function SCPI Command Subsystems Averaging SENSe::AVERage Bandwidth SENSe::BWIDth Calibration CALibration Channel: setting SENSe:CHANnel Commands: listing of all SYSTem:HELP:HEADers Lists only the commands in the current selected mode.
Programming Command Cross References Functional Sort of SCPI Commands Function SCPI Command Subsystems Input/Output/ Configuration INPut:IMPedance SYSTem:CONFigure SYStem:COMMunicate Markers CALCulate::MARKer: Measurements: control ABORt INITiate:IMMediate INITiate:CONTinuous INItiate:RESTart Measurements: select mode INSTrument:SELect Modes include Basic, Service, GSM, and CDMA.
Programming Command Cross References Functional Sort of SCPI Commands Function SCPI Command Subsystems Preset SYSTem:PRESet: Printing HCOPy: SYSTem:COMMunicate Reference level DISPlay:WINDow:TRACe Save/Recall: display images DISPlay:IMAGe: HCOPy:IMMediate: Save/Recall: instrument states *SAV *RCL Save/Recall: trace data MEASure:[n]? FETCh:[n]? FORMat:DATA FORMat:BORDer Triggering TRIGger: SENSe:: Standards, selection SENSe:RADio 184 Remarks Descrip
5 Language Reference This chapter includes the commands that are common to all of the instrument modes. It also contains the commands unique to the basic and service modes. For commands specific to a measurement mode, like the GSM personality, look in the GSM Programming Commands chapter. Only commands in the current selected mode can be executed.
Language Reference SCPI Command Subsystems SCPI Command Subsystems “SCPI Command Subsystems” on page 186. “ABORt Subsystem” on page 193. “CALCulate Subsystem” on page 194. “CALibration Subsystem” on page 213. “CONFigure Subsystem” on page 227. “DISPlay Subsystem” on page 228. “FETCh Subsystem” on page 238. “FORMat Subsystem” on page 239. “HCOPy Subsystem” on page 241. “INITiate Subsystem” on page 247. “INPut Subsystem” on page 249. “INSTrument Subsystem” on page 252.
Language Reference Common IEEE Commands Common IEEE Commands These commands are specified in IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and Common Commands for Use with ANSI/IEEE Std 488.1-1987. New York, NY, 1992. Numeric values for bit patterns can be entered using decimal or hexidecimal representations. (i.e. 0 to 32767 is equivalent to #H0 to #H7FFF) See the SCPI Basics information about using bit patterns for variable parameters.
Language Reference Common IEEE Commands The query returns the state of the standard event status enable register. Range: Integer, 0 to 255 Standard Event Status Register Query *ESR? Queries and clears the standard event status event register. (This is a destructive read.) Range: Integer, 0 to 255 Identification Query *IDN? Returns an instrument identification information string to GPIB. The string will contain the model number, serial number and firmware revision.
Language Reference Common IEEE Commands SYST:SET #NMMMM The following example is a response to *LRN? The actual sizes will vary depending on the instrument state data size. Example: :SYST:SET #42016 Where: 4 (the N in the preceding query response example) represents the number of digits to follow Where: 2016 (the MMMM in the preceding query response example) represents the number of bytes that follow in the .
Language Reference Common IEEE Commands VSAProcess STATus:OPER Register Bit Byte Value Waiting for trigger 5 16 Printing 11 1024 Mass memory access (floppy drive) 12 2048 For example, if you want to verify the completion of both calibrating and waiting for trigger set :STAT:OPER:ENAB 17 and monitor any changes. Key Type: There is no equivalent front panel key. Query Instrument Options *OPT? Returns a string of all the installed instrument options.It is a comma separated list such as: BAC,BAH.
Language Reference Common IEEE Commands The :SYSTem:PRESet command is equivalent to a front panel Preset. The front panel Preset sets instrument parameters to values for good front panel usage in the current mode. The *RST and front panel Preset will be different. For example, the *RST will place the instrument in single sweep while the front panel Preset will place the instrument in continuous sweep.
Language Reference Common IEEE Commands Trigger *TRG This command triggers the instrument. Use the :TRIGger[:SEQuence]:SOURce command to select the trigger source. The desired measurement has been selected and is waiting. The command causes the system to exit this “waiting” state and go to the “initiated” state. The trigger system is initiated and completes one full trigger cycle. It returns to the “waiting” state on completion of the trigger cycle.
Language Reference ABORt Subsystem ABORt Subsystem Abort Command :ABORt Stops any sweep or measurement in progress and resets the sweep or trigger system. A measurement refers to any of the measurements found in the MEASURE menu. If :INITiate:CONTinuous is off (single measure), then :INITiate:IMMediate will start a new single measurement. If :INITiate:CONTinuous is on (continuous measure), a new continuous measurement begins immediately.
Language Reference CALCulate Subsystem CALCulate Subsystem This subsystem is used to perform post-acquisition data processing. In effect, the collection of new data triggers the CALCulate subsystem. In this instrument, the primary functions in this subsystem are markers and limits. The SCPI default for data output format is ASCII. The format can be changed to binary with FORMat:DATA which transports faster over the bus.
Language Reference CALCulate Subsystem Baseband IQ Commands BbIQ in Spectrum - I/Q Marker Query :CALCulate:SPECtrum:MARKer:IQ [1]|2|3|4:? Reads out current I and Q marker values when spectrum mode is selected. Remarks: Implemented for BASIC and W-CDMA modes. History: Version A.05.00 or later Baseband IQ in Waveform - I/Q Marker Query :CALCulate:WAVeform:MARKer:IQ [1]|2|3|4:? Reads out current I and Q marker values when waveform is selected. Remarks: Implemented for BASIC and W-CDMA modes.
Language Reference CALCulate Subsystem Calculate/Compress Trace Data Query :CALCulate:DATA[n]:COMPress? BLOCk|CFIT|MAXimum|MEAN|MINimum|RMS|SAMPle|SDEViation [,[,[,[,]]]] Returns compressed data for the designated trace data in the currently selected measurement. The command can be used with sub-opcodes (n) for measurements that return several types of trace data. The data is returned in the same units as the original trace.
Language Reference CALCulate Subsystem Example: To query the mean power of a set of GSM bursts: 1. Set the waveform measurement sweep time to acquire at least one burst. 2. Set the triggers such that acquisition happens at a known position relative to a burst. 3. Then query the mean burst levels using, CALC:DATA2:COMP? MEAN,24e-6,526e-6 (These parameter values correspond to GSM signals, where 526e-6 is the length of the burst in the slot and you just want 1 burst.
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? CHPower - channel power SPECtrum (n=2)a no markers CSPur - spurs close SPECtrum (n=2)a yes (cdmaOne mode) ULIMit (n=3)a EEVM - EDGE error vector magnitude EVMerror (n=2)a (EDGE mode) MERRor (n=3)a (Basic, cdmaOne, cdma2000, W-CDMA (3GPP) modes) yes PERRor (n=4)a EORFspectr - EDGE output RF spectrum (EDGE mode) RFEMod (n=2)a RFESwitching (n=3)a SPEMod (n=4)a yes, only for a single offset LIMMod (n=5)a
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? OBW - occupied bandwidth no traces no markers ORFSpectrum - output RF spectrum RFEMod (n=2)a (GSM, EDGE mode) RFESwitching (n=3)a yes, only for a single offset (cdmaOne, cdma2000, iDEN, PDC, W-CDMA (3GPP) modes) SPEMod (n=4)a LIMMod (n=5)a yes, only for multiple offsets PFERror - phase and frequency error PERRor (n=2)a yes (GSM, EDGE mode) PFERror (n=3)a RFENvelope (n=4)a PSTatistic - power statistics
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? SPECtrum - (frequency domain) RFENvelope (n=2)a for Service mode yes (all modes) IQ (n=3)a SPECtrum (n=4)a ASPectrum (n=7)a WAVEform - (time domain) RFENvelope (n=2)a (all modes) IQ (n=8)a yes a. The n number indicates the sub-opcode that corresponds to this trace.
Language Reference CALCulate Subsystem Example: Select the spectrum measurement. Use CALC:DATA4:PEAK? -40,10,FREQ to identify the peaks above −40 dBm, with excursions of at least 10 dB, in order of increasing frequency. Query Results: Returns a list of floating-point numbers. The first value in the list is the number of peak points that follow. A peak point consists of two values: a peak amplitude followed by the its corresponding frequency (or time).
Language Reference CALCulate Subsystem Basic Mode - key words • • • • • ACPr - no markers CHPower - no markers PSTatistic - markers available SPECtrum - markers available WAVeform - markers available Service Mode - key words • PVTime - no markers • SPECtrum - markers available • WAVeform - markers available cdmaOne Mode - key words • • • • • • • ACPr - no markers CHPower - no markers CDPower - markers available CSPur - markers available RHO - markers available S
Language Reference CALCulate Subsystem GSM Mode - key words • • • • • • • ORFSpectrum - markers available PFERror - markers available PVTime - no markers SPECtrum - markers available TSPur - markers available TXPower - no markers WAVeform - markers available iDEN Mode - key words • • • • • ACP - no markers BER - no markers OBW - no markers SPECtrum - markers available WAVeform - markers available NADC Mode - key words • • • • ACP - no markers EVM - markers ava
Language Reference CALCulate Subsystem • • • • • • CHPower - no markers EVMQpsk - markers available PSTatistic - markers available RHO - markers available SPECtrum - markers available WAVeform - markers available Example: Suppose you are using the Spectrum measurement. To position marker 2 at the maximum peak value of the trace that marker 2 is currently on, the command is: :CALCulate:SPECtrum:MARKer2:MAXimum You must make sure that the measurement is completed before trying to query the marker value.
Language Reference CALCulate Subsystem Band Power − is the integrated power between the two markers for traces in the frequency domain and is the mean power between the two markers for traces in the time domain. Noise − is the noise power spectral density in a 1 Hz bandwidth. It is averaged over 32 horizontal trace points. Off − turns off the marker functions Example: CALC:SPEC:MARK3:FUNC Noise Remarks: The keyword for the current measurement must be specified in the command.
Language Reference CALCulate Subsystem Remarks: Front Panel Access: The keyword for the current measurement must be specified in the command. (Some examples include: SPECtrum, WAVeform) Search Marker Peak (Minimum) Search :CALCulate::MARKer[1]|2|3|4:MINimum Places the selected marker on the lowest point on the trace that is assigned to that particular marker number. The marker must have already been assigned to a trace.
Language Reference CALCulate Subsystem Marker On/Off :CALCulate::MARKer[1]|2|3|4[:STATe] OFF|ON|0|1 :CALCulate::MARKer[1]|2|3|4[:STATe]? Turns the selected marker on or off. The marker must have already been assigned to a trace. Use :CALCulate::MARKer[1]|2|3|4:TRACe to assign a marker to a particular trace. Example: CALC:SPEC:MARK2: on Remarks: The keyword for the current measurement must be specified in the command.
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? ACP - adjacent channel power no traces no markers no traces no markers CDPower - code domain power POWer (n=2)a yes (cdmaOne mode) TIMing (n=3)a (Basic, cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), iDEN, NADC, PDC modes) BER - bit error rate (iDEN mode) PHASe (n=4)a CDPower - code domain power CDPower (n=2)a (cdma2000, W-CDMA (3GPP) modes) EVM (n=5)a yes MERRor (n=6)a PERRor (n=7)a SPOWer (
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? EORFspectr - EDGE output RF spectrum RFEMod (n=2)a yes, only for a single offset (EDGE mode) RFESwitching (n=3)a SPEMod (n=4)a LIMMod (n=5)a yes, only for multiple offsets EPVTime - EDGE power versus time RFENvelope (n=2)a yes (EDGE mode) UMASk (n=3)a LMASk (n=4)a EVM - error vector magnitude EVM (n=2)a (NADC, PDC modes) MERRor (n=3)a yes PERRor (n=4)a EVMQpsk - QPSK error vector magnitude (cdma2000, W
Language Reference CALCulate Subsystem Measurement Available Traces Markers Available? PSTatistic - power statistics CCDF MEASured (n=2)a yes (Basic, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib) modes) GAUSian (n=3)a REFerence (n=4)a PVTime - power versus time RFENvelope (n=2)a (GSM, Service modes) UMASk (n=3)a yes LMASk (n=4)a yes RHO - modulation quality EVM (n=2)a (cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib) modes) MERRor (n=3)a SEMask - spectrum emissions mask SPECtrum
Language Reference CALCulate Subsystem Marker X Value :CALCulate::MARKer[1]|2|3|4:X :CALCulate::MARKer[1]|2|3|4:X? Position the designated marker on its assigned trace at the specified X value. The parameter value is in X-axis units (which is often frequency or time). The marker must have already been assigned to a trace. Use :CALCulate::MARKer[1]|2|3|4:TRACe to assign a marker to a particular trace.
Language Reference CALCulate Subsystem SPECtrum, WAVeform) Front Panel Access: Marker, , RPG Marker Readout Y Value :CALCulate::MARKer[1]|2|3|4:Y? Readout the current Y value for the designated marker on its assigned trace. The value is in the Y-axis units for the trace (which is often dBm). The marker must have already been assigned to a trace. Use :CALCulate::MARKer[1]|2|3|4:TRACe to assign a marker to a particular trace.
Language Reference CALibration Subsystem CALibration Subsystem These commands control the self-alignment and self-diagnostic processes. Calibration Abort :CALibration:ABORt Abort any alignment in progress. Front Panel Access: ESC, when alignment is in progress Align the ADC Auto-range Threshold :CALibration:ADC:ARANge :CALibration:ADC:ARANge? Align the ADC auto-range thresholds. This same alignment is run as part of the CAL:ALL routine.
Language Reference CALibration Subsystem Align the ADC Offset :CALibration:ADC:OFFSet :CALibration:ADC:OFFSet? Align the six ADC offset DACs. This same alignment is run as part of the CAL:ALL routine. The query performs the alignment and returns a zero if the alignment is successful. Front Panel Access: System, Alignments, Align subsystem, Align ADC Align the ADC RAM Gain :CALibration:ADCRam:GAIN :CALibration:ADCRam:GAIN? Align the gain of the six ADC RAM pages.
Language Reference CALibration Subsystem Calculate the gain error of 40 RF attenuator steps. The nominal setting of 10 dB is assumed to have 0 dB error. The query performs the alignment and returns a zero if the alignment is successful. Remarks: Front Panel Access: A valid service password needs to be entered prior to sending the command. System, Alignments, Align subsystem, RF Automatic Alignment :CALibration:AUTO OFF|ALERT|ON :CALibration:AUTO? Turns the automatic alignment routines on and off.
Language Reference CALibration Subsystem Front Panel Access: System, Alignments, Align Subsystem, RF Turn Background Calibration Corrections Off :CALibration:CORRections 0|1|OFF|ON :CALibration:CORRections? When set to OFF deactivates background flatness and IF gain alignments, for which nominal values are substituted. Several video shift gain corrections are set to zero, including absolute gain err, gain err vs attenuation, and RF flatness err vs frequency.
Language Reference CALibration Subsystem The query performs the alignment and returns a zero if the alignment is successful. Remarks: Front Panel Access: A valid service password needs to be entered prior to sending the command. System, Diagnostics Align the IF Flatness :CALibration:FLATness:IF :CALibration:FLATness:IF? Finds the flatness shape of the current IF setup (prefilter, mgain, natBW).
Language Reference CALibration Subsystem Align the ADC :CALibration:GADC :CALibration:GADC? Performs the ADC group of alignments. The query returns a 0 if the alignments occurred without problems. The query performs the alignment and returns a zero if the alignment is successful. Front Panel Access: System, Alignments, Align Subsystem, Align ADC Align the IF Gain :CALibration:GAIN:IF :CALibration:GAIN:IF? Calculate the curve coefficients for the IF gain DAC.
Language Reference CALibration Subsystem Remarks: You must be in the Basic, W-CDMA, cdma2000 mode to use this command. Use INSTrument:SELect to set the mode. History: Added revision A.05.00 Baseband I/Q - IQ Flatness Calibration :CALibration:IQ:FLATness :CALibration:IQ:FLATness? Activates a flatness calibration for all I/Q ranges and impedance settings. Remarks: You must be in the Basic, W-CDMA, cdma2000 mode to use this command. Use INSTrument:SELect to set the mode. History: Added revision A.05.
Language Reference CALibration Subsystem Align the IF :CALibration:GIF :CALibration:GIF? Performs the IF group of alignments. The query returns a 0 if the alignments occurred without problems. The query performs the alignment and returns a zero if the alignment is successful. Front Panel Access: System, Alignments, Align Subsystem, Align IF Align the RF :CALibration:GRF :CALibration:GRF? Performs the RF group of alignments. The query returns a 0 if the alignments occurred without problems.
Language Reference CALibration Subsystem Remarks: Front Panel Access: A valid service password needs to be entered prior to sending the command. System, Alignments, Align Subsystem, IF Align the Wide LC Prefilter :CALibration:PFILter:LC:WIDE :CALibration:PFILter:LC:WIDE? Align the wide LC prefilter. (1.2 MHz to 7.5 MHz) The query performs the alignment and returns a zero if the alignment is successful.
Language Reference CALibration Subsystem Remarks: Front Panel Access: A valid service password needs to be entered prior to sending the command. Enter service password and press System, Diagnostics Adjust the Level of the 321.4 MHz Alignment Signal :CALibration:REF321 :CALibration:REF321? Calculate the curve coefficients for setting the level of the 321.4 MHz alignment signal. Remarks: Front Panel Access: A valid service password needs to be entered prior to sending the command.
Language Reference CALibration Subsystem This is used for aligning the 50 MHz amplitude reference with CAL:REF50. Preset and *RST: −25.00 dBm Range: −30 to −20 dBm Default Unit: dBm Remarks: You must be in the Service mode to use this command. Use INSTrument:SELect. A valid service password needs to be entered prior to sending this command.
Language Reference CALibration Subsystem A valid service password needs to be entered prior to sending this command. Front Panel Access: System, Alignments, Align subsystem, Align 50 MHz Reference Enter Interactive Mode for Internal 50 MHz Amplitude Reference Alignment :CALibration:REF50:ENTer Turns on the interactive mode for alignment of the internal 50 MHz amplitude reference signal. Use CAL:REF50:ANOW to do the alignment and CAL:REF50:EXIT to exit the interactive mode.
Language Reference CALibration Subsystem Remarks: You must be in the Service mode to use this command. Use INSTrument:SELect. A valid service password needs to be entered prior to sending this command. Front Panel Access: System, Alignments, Align subsystem, Align 50 MHz Reference Query the ALC DAC Value for the 50 MHz Amplitude Reference :CALibration:REF50:LAST:ALCDac? Query returns the last value of the ALC DAC of the 50 MHz reference alignment.
Language Reference CALibration Subsystem Align the Trigger Delay :CALibration:TRIGger:DELay :CALibration:TRIGger:DELay? Align any trigger delays needed. One place that this alignment is used is for the even second clock functionality in cdmaOne mode. This same alignment is run as part of the CAL:ALL routine. The query performs the alignment and returns a zero if the alignment is successful.
Language Reference CONFigure Subsystem CONFigure Subsystem The CONFigure commands are used with several other commands to control the measurement process. The full set of commands are described in the section “MEASure Group of Commands” on page 255. Selecting measurements with the CONFigure/FETCh/MEASure/READ commands sets the instrument state to the defaults for that measurement and to make a single measurement.
Language Reference DISPlay Subsystem DISPlay Subsystem The DISPlay controls the selection and presentation of textual, graphical, and TRACe information. Within a DISPlay, information may be separated into individual WINDows. Adjacent Channel Power - View Selection :DISPlay:ACP:VIEW BGRaph|SPECtrum :DISPlay:ACP:VIEW? Select the adjacent channel power measurement display of bar graph or spectrum.
Language Reference DISPlay Subsystem Date and Time Display :DISPlay:ANNotation:CLOCk[:STATe] OFF|ON|0|1 :DISPlay:ANNotation:CLOCk[:STATe]? Turns on and off the display of the date and time on the spectrum analyzer screen. The time and date pertain to all windows. Factory Preset and *RST: On This parameter is persistent, which means that it retains the setting previously selected, even through a power cycle.
Language Reference DISPlay Subsystem 1. If in local, press any key 2. If in remote, press the local (system) key 3. If in local lockout, no key Front Panel Access: System, Disp Updates for VSA Select Display Format :DISPlay:FORMat:TILE Selects the viewing format that displays multiple windows of the current measurement data simultaneously. Use DISP:FORM:ZOOM to return the display to a single window.
Language Reference DISPlay Subsystem — n=2, m=1 I Waveform (Option B7C) — n=2, m=2 Q Waveform (Option B7C) — n=3, m=1 I/Q Polar (Basic, W-CDMA, cdma2000) — n=4, m=1 Linear Spectrum (Basic, W-CDMA, cdma2000) m − selects the window within the view. The default is 1. Factory Preset: 10 dB per division, for Spectrum Range: .1 dB to 20 dB per division, for Spectrum Default Unit: 10 dB per division, for Spectrum Remarks: May affect input attenuator setting.
Language Reference DISPlay Subsystem Default Unit: dBm, for Spectrum Remarks: May affect input attenuator setting. To use this command, the appropriate mode should be selected with INSTrument:SELect. Front Panel Access: When in Spectrum measurement: Amplitude Y Scale, Ref Level Turn a Trace Display On/Off :DISPlay:TRACe[n][:STATe] OFF|ON|0|1 :DISPlay:TRACe[n][:STATe]? Controls whether the specified trace is visible or not. n is a sub-opcode that is valid for the current measurement.
Language Reference DISPlay Subsystem Measurement Available Traces Markers Available? CDPower - code domain power POWer (n=2)a yes (cdmaOne mode) TIMing (n=3)a PHASe (n=4)a CDPower - code domain power CDPower (n=2)a (cdma2000, W-CDMA (3GPP) modes) EVM (n=5)a yes MERRor (n=6)a PERRor (n=7)a SPOWer (n=9)a CPOWer (n=10)a CDPower - code domain power CDPower (n=2)a (W-CDMA (Trial & Arib) mode) EVM (n=4)a yes MERRor (n=5)a PERRor (n=6)a SPOWer (n=8)a CHPower - channel power SPECtrum (n=2)a no
Language Reference DISPlay Subsystem Measurement Available Traces Markers Available? EPVTime - EDGE power versus time RFENvelope (n=2)a yes (EDGE mode) UMASk (n=3)a LMASk (n=4)a EVM - error vector magnitude EVM (n=2)a (NADC, PDC modes) MERRor (n=3)a yes PERRor (n=4)a EVMQpsk - QPSK error vector magnitude (cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib) modes) IM - intermodulation EVM (n=2)a yes MERRor (n=3)a PERRor (n=4)a SPECtrum (n=2)a yes no traces no markers no traces no markers OR
Language Reference DISPlay Subsystem Measurement Available Traces Markers Available? PVTime - power versus time RFENvelope (n=2)a yes (GSM, Service modes) UMASk (n=3)a LMASk (n=4)a RHO - modulation quality EVM (n=2)a (cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib) modes) MERRor (n=3)a SEMask - spectrum emissions mask SPECtrum (n=2)a yes TSPur - transmit band spurs SPECtrum (n=2)a yes (GSM mode) ULIMit (n=3)a TXPower - transmit power RFENvelope (n=2)a (GSM mode) IQ (n=8)a SP
Language Reference DISPlay Subsystem n=1, m=1 RF envelope n=2, m=1 I/Q Waveform n=2, m=1 I and Q Waveform (Option B7C) n=4, m=1 I/Q Polar (Basic, W-CDMA, cdma2000) n=5, m=1 Linear Envelope (Option B7C) m, selects the window within the view. The default is 1. Factory Preset: 10 dBm, for RF envelope Range: .1 dB to 20 dB, for RF envelope Default Unit: dBm, for RF envelope Remarks: May affect input attenuator setting. To use this command, the appropriate mode should be selected with INSTrument:SELect.
Language Reference DISPlay Subsystem To use this command, the appropriate mode should be selected with INSTrument:SELect.
Language Reference FETCh Subsystem FETCh Subsystem The FETCh? commands are used with several other commands to control the measurement process. These commands are described in the section on the “MEASure Group of Commands” on page 255. Fetch the Current Measurement Results :FETCh:[n]? A FETCh? command must specify the desired measurement. It will return the valid results that are currently available, but will not initiate the taking of any new data.
Language Reference FORMat Subsystem FORMat Subsystem The FORMat subsystem sets a data format for transferring numeric and array information. Byte Order :FORMat:BORDer NORMal|SWAPped :FORMat:BORDer? Selects the binary data byte order for numeric data transfer. In normal mode the most significant byte is sent first. In swapped mode the least significant byte is first. (PCs use the swapped order.) Binary data byte order functionality does not apply to ASCII.
Language Reference FORMat Subsystem • The first digit in the header (5) tells you how many additional digits/bytes there are in the header. • The 12320 means 12 thousand, 3 hundred, 20 data bytes follow the header. • Divide this number of bytes by your selected data format bytes/point, either 8 (for real 64), or 4 (for real 32). In this example, if you are using real 64 then there are 1540 points in the block.
Language Reference HCOPy Subsystem HCOPy Subsystem The HCOPy subsystem controls the setup of printing to an external device. Screen Printout Destination :HCOPy:DESTination FPANel|PRINter :HCOPy:DESTination? This command was created to support backward compatibility to early instrument functionality. It is used to specify whether the hardcopy printout goes to the printer or to a destination that is specified from the front panel key Print Setup, Print To File|Printer.
Language Reference HCOPy Subsystem Custom Printer Language :HCOPy:DEVice:LANGuage PCL3|PCL5 :HCOPy:DEVice:LANGuage? Specifies the type of printer control language that your custom printer uses. HCOPY:DEVICE:TYPE CUSTOM must be selected. Example: HCOP:DEV:LANG pcl3 Factory Preset and *RST: PCL3. This parameter is persistent, which means it retains the value previously selected even through a power cycle. History: Front Panel Access: Revision A.04.
Language Reference HCOPy Subsystem Color Hard Copy :HCOPy:IMAGe:COLor[:STATe] OFF|ON|0|1 :HCOPy:IMAGe:COLor[:STATe]? Selects between color and monochrome mode for hard copy output. You must set HCOP:DEV:COLOR YES before using this command. Factory Preset and *RST: On. This parameter is persistent, which means that it retains the setting previously selected, even through a power cycle. Remarks: Revision A.04.
Language Reference HCOPy Subsystem NOTE Landscape mode is not presently supported for PCL-3 printers. Factory Preset and *RST: Portrait. This parameter is persistent, which means that it retains the setting previously selected, even through a power cycle. History: Revision A.04.
Language Reference HCOPy Subsystem Screen Dump Query :HCOPy:SDUMp:DATA? [GIF]|BMP|WMF The query returns the current screen image as a file. If the optional file type is not specified it returns GIF type graphic data. The orientation is always portrait and the image is always in color. The data is formatted as block data where the block of data starts with an ASCII header that indicates how many additional binary data bytes are following in the block. (e.g.
Language Reference HCOPy Subsystem Screen Dump to a Printer :HCOPy:SDUMp[:IMMediate] The entire screen image is output to the printer (remote interface). The image is always inverted. History: 246 Revision A.04.
Language Reference INITiate Subsystem INITiate Subsystem The INITiate subsystem is used to control the initiation of the trigger. Refer to the TRIGger and ABORt subsystems for related commands. Take New Data Acquisition for Selected Measurement :INITiate: This command initiates a trigger cycle for the measurement specified. The available measurement names are described in the MEASure subsystem. It also holds off additional commands on GPIB until the acquisition is complete.
Language Reference INITiate Subsystem Access: Meas Control, Measure Cont Single Take New Data Acquisitions :INITiate[:IMMediate] The instrument must be in the single measurement mode. If INIT:CONT is ON, then the command is ignored. The desired measurement must be selected and waiting. The command causes the system to exit the “waiting” state and go to the “initiated” state. The trigger system is initiated and completes one full trigger cycle.
Language Reference INPut Subsystem INPut Subsystem The INPut subsystem controls the characteristics of all the instrument input ports. The INPut subsystem controls the characteristics of all the instrument input ports. Baseband I/Q - Select Input Impedance :INPut:IMPedance:IQ U50|B600|U1M|B1M :INPut:IMPedance:IQ? Selects the characteristic input impedance when input port is set to I or Q. This is the impedance value as well as the unbalanced (U) or balanced (B) impedence mode.
Language Reference INPut Subsystem Baseband I/Q - Activate IQ Alignment :INPut:IQ:ALIGn OFF|ON|0|1 :INPut:IQ:ALIGn? Activates or deactivates IQ alignment. Factory Preset and *RST: Off Remarks: You must be in the Basic, W-CDMA, cdma2000 mode to use this command. Use INSTrument:SELect to set the mode. History: Added revision A.05.00 Baseband I/Q - I Input DC Offset :INPut:OFFSet:I :INPut:OFFSet:I? Sets adjustment to compensate for I voltage bias on signals when the I input port is selected.
Language Reference INPut Subsystem Remarks: You must be in the Basic, W-CDMA, cdma2000 mode to use this command. Use INSTrument:SELect to set the mode. History: Added revision A.05.
Language Reference INSTrument Subsystem INSTrument Subsystem This subsystem includes commands for querying and selecting instrument measurement (personality option) modes. Catalog Query :INSTrument:CATalog[:FULL]? Returns a comma separated list of strings which contains the names of all the installed applications. These names can only be used with the INST:SELECT command. If the optional keyword FULL is specified, each name is immediately followed by its associated instrument number.
Language Reference INSTrument Subsystem Factory Preset and *RST: Persistent state with factory default of 8 (BASIC) Range: Front Panel Access: 1 to x, where x depends upon which applications are installed. Mode Select Application :INSTrument[:SELect] BASIC|SERVICE|CDMA|CDMA2K|GSM|EDGEGSM|IDEN|NADC|PDC| WCDMA|ARIBWCDMA :INSTrument[:SELect]? Select the measurement mode. The actual available choices depend upon which modes (measurement applications) are installed in the instrument.
Language Reference INSTrument Subsystem Example: INST:SEL GSM Factory Preset and *RST: Persistent state with factory default of Basic mode.
Language Reference MEASure Group of Commands MEASure Group of Commands This group includes the CONFigure, FETCh, MEASure, and READ commands that are used to make measurements and return results. The different commands can be used to provide fine control of the overall measurement process, like changing measurement parameters from their default settings. Most measurements should be done in single measurement mode, rather than measuring continuously. The SCPI default for data output format is ASCII.
Language Reference MEASure Group of Commands initiate the measurement and query the results. See Figure 5-1. If you need to repeatedly make a given measurement with settings other than the factory defaults, you can use the commands in the SENSe: and CALCulate: subsystems to set up the measurement. Then use the READ? command to initiate the measurement and query results. Measurement settings persist if you initiate a different measurement and then return to a previous one.
Language Reference MEASure Group of Commands Fetch Commands :FETCh:[n]? This command puts selected data from the most recent measurement into the output buffer. Use FETCh if you have already made a good measurement and you want to return several types of data (different [n] values, e.g. both scalars and trace data) from a single measurement. FETCh saves you the time of re-making the measurement.
Language Reference MEASure Group of Commands See each command for details of what types of scalar results or trace data results are available. The binary data formats should be used when handling large blocks of data since they are smaller and faster then the ASCII format.
Language Reference MEASure Group of Commands Adjacent Channel Power Ratio (ACP) Measurement This measures the total rms power in the specified channel and in 5 offset channels. You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), iDEN, NADC or PDC mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section.
Language Reference MEASure Group of Commands Measurement Type n Results Returned not specified or n=1 Returns 13 comma-separated scalar results, in the following order: iDEN mode Total power reference not specified or n=1 Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode 1. Center frequency – relative power (dB) 2. Center frequency – absolute power (dBm) 3. Lower offset frequency – relative power (dB) 4. Lower offset freq– absolute power (dBm) 5.
Language Reference MEASure Group of Commands Measurement Type n Results Returned Power spectral density reference not specified or n=1 Returns 24 comma-separated scalar results, in the following order: Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode 1. Upper adjacent chan center frequency - relative power (dB) 2. Upper adjacent chan center frequency - absolute power (dBm/Hz) 3. Lower adjacent chan center frequency - relative power (dB) (same as upper) 4.
Language Reference MEASure Group of Commands Measurement Type n Results Returned 3 Returns 10 comma-separated scalar values of the pass/fail (0=passed, or 1=failed) results determined by testing the relative power of the offset frequencies: NADC and PDC mode 1. Negative offset frequency (1) relative power 2. Positive offset frequency (1) relative power . . . 1. Negative offset frequency (5) relative power 2.
Language Reference MEASure Group of Commands Measurement Type n Results Returned (For cdma2000 and W-CDMA the data is only available with spectrum display selected) 4 Returns the frequency-domain spectrum trace data for the entire frequency range being measured.
Language Reference MEASure Group of Commands Measurement Type n Results Returned 6 Returns 4 comma-separated pass/fail test results for the absolute power of the reference and offset channels: iDEN mode Total power reference 6 Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode 1. Reference channel absolute power pass/fail 2. Reference channel absolute power pass/fail (duplicate of above) 3. Lower offset channel absolute power pass/fail 4.
Language Reference MEASure Group of Commands Measurement Type n Results Returned Total power reference 7 Returns 12 comma-separated scalar values of the pass/fail (0=passed, or 1=failed) results determined by testing the absolute power limit of the center and offset frequencies (measured as total power in dB): Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode 1. 2. 3. 4.
Language Reference MEASure Group of Commands Measurement Type n Results Returned Power spectral density reference 8 Returns 12 comma-separated scalar values of the pass/fail (0=passed, or 1=failed) results determined by testing the power limit relative to the center frequency (measured as power spectral density in dB): Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode 1. 2. 3. 4.
Language Reference MEASure Group of Commands 50 MHz Amplitude Reference Measurement This aligns the internal 50 MHz reference signal to an external reference signal that you supply. You must be in the Service mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:AREFerence commands for more measurement related commands.
Language Reference MEASure Group of Commands Channel Power Measurement This measures the total rms power in a specified integration bandwidth. You must be in the Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:CHPower commands for more measurement related commands.
Language Reference MEASure Group of Commands Power Statistics CCDF Measurement This is a statistical power measurement of the complimentary cumulative distribution function (CCDF). You must be in the Basic, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:PSTat commands for more measurement related commands.
Language Reference MEASure Group of Commands n 2 Returns a series of 5001 floating point numbers (in percent) that represent the current measured power stat trace. This is the probability at particular power levels (average power), in the following order: 1. Probability at 0.0 dB power 2. Probability at 0.01 dB power 3. Probability at 0.02 dB power . . . 1. Probability at 49.9 dB power 2. Probability at 50.
Language Reference MEASure Group of Commands Power vs. Time Measurement This measures the average power during the “useful part” of the burst comparing the power ramp to required timing mask. You must be in EDGE, GSM or Service mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:PVTime commands for more measurement related commands.
Language Reference MEASure Group of Commands n Results Returned not specified or n=1 Returns the following comma-separated scalar results: 1. Sample time is a floating point number that represents the time between samples when using the trace queries (n=0,2,etc.). 2. Power of single burst is the mean power (in dBm) across the useful part of the selected burst in the most recently acquired data, or in the last data acquired at the end of a set of averages.
Language Reference MEASure Group of Commands n Results Returned 8, only available when averaging is set to both maximum and minimum Returns comma-separated trace points of the minimum waveform data. These data points are floating point numbers representing the power of the signal (in dBm). There are N data points, where N is the number of samples. The period between the samples is defined by the sample time. Use SENSe:PVT:AVERage:TYPE MXMinimum to set averaging to max and min.
Language Reference MEASure Group of Commands Sensor Measurement This checks the output of three sensors in the RF and IF circuitry. You must be in the Service mode to use these commands. Use INSTrument:SELect to set the mode. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section.
Language Reference MEASure Group of Commands Spectrum (Frequency Domain) Measurement This measures the amplitude of your input signal with respect to the frequency. It provides spectrum analysis capability using FFT (fast Fourier transform) measurement techniques. You must select the appropriate mode using INSTrument:SELect, to use these commands. The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section.
Language Reference MEASure Group of Commands n Results Returned not specified or n=1 Returns the following comma-separated scalar results: 1. FFT peak is the FFT peak amplitude. 2. FFT frequency is the FFT frequency of the peak amplitude. 3. FFT points is the Number of points in the FFT spectrum. 4. First FFT frequency is the frequency of the first FFT point of the spectrum. 5. FFT spacing is the frequency spacing between the FFT points of the spectrum. 6.
Language Reference MEASure Group of Commands n Results Returned 10, Service mode only Returns trace data of the phase of the FFT versus frequency. 11, cdma2000, W-CDMA, Basic modes only Returns comma-separated linear spectrum trace data in Volts RMS. 12, cdma2000, W-CDMA, Basic modes only Returns comma-separated averaged linear spectrum trace data in Volts RMS.
Language Reference MEASure Group of Commands Timebase Frequency Measurement The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:TBFRequency commands for more measurement related commands. You must be in the Service mode to use these commands. Use INSTrument:SELect to set the mode.
Language Reference MEASure Group of Commands The general functionality of CONFigure, FETCh, MEASure, and READ are described at the beginning of this section. See the SENSe:WAVeform commands for more measurement related commands. :CONFigure:WAVeform :FETCh:WAVeform[n]? :READ:WAVeform[n]? :MEASure:WAVeform[n]? Front Panel Access: Measure, Waveform (Time Domain) After the measurement is selected, press Restore Meas Defaults to restore factory defaults.
Language Reference MEASure Group of Commands n Results Returned not specified or n=1 Returns the following comma-separated scalar results: 1. Sample time is a floating point number representing the time between samples when using the trace queries (n=0,2,etc). 2. Mean power is the mean power (in dBm). This is either the power across the entire trace, or the power between markers if the markers are enabled. If averaging is on, the power is for the latest acquisition. 3.
Language Reference MEMory Subsystem MEMory Subsystem The purpose of the MEMory subsystem is to manage instrument memory. This specifically excludes memory used for mass storage which is defined in the MMEMory Subsystem. Install Application :MEMory:INSTall:APPLication Installs the specified application from an external drive to the instrument. Each application allows you to make a specific set of measurements easily and accurately.
Language Reference MMEMory Subsystem MMEMory Subsystem The purpose of the MMEMory subsystem is to provide access to mass storage devices such as internal or external disk drives. Any part of memory that is treated as a device will be in the MMEMory subsystem. If mass storage is not specified in the filename, the default mass storage specified in the MSIS command will be used.
Language Reference MMEMory Subsystem Store a Screen Image in a Graphic File :MMEMory:STORe:SCReen[:IMMediate] The :MMEMory:STORe:SCReen[:IMMediate] command will write the screen image to a file regardless of what the front panel Print Setup, Print To key function is set to. Screen files are always saved in color with an orientation of portrait. The variable is composed of: [:][.
Language Reference MMEMory Subsystem Screen File Type :MMEMory:STORe:SCReen:FILE[:TYPE] GIF|BMP|WMF Sets the default file type for the :MMEMory:STORe:SCReen command. Factory Preset and *RST: GIF. The file type setting is persistant. It stays at the last user-selected setting even through a power cycle. Default: GIF History: Added in version A.04.
Language Reference READ Subsystem READ Subsystem The READ? commands are used with several other commands and are documented in the section on the “MEASure Group of Commands” on page 255. Initiate and Read Measurement Data :READ:[n]? A READ? query must specify the desired measurement. It will cause a measurement to occur without changing any of the current settings and will return any valid results. The code number n selects the kind of results that will be returned.
Language Reference SENSe Subsystem SENSe Subsystem Sets the instrument state parameters so that you can measure the input signal. The SCPI default for data output format is ASCII. The format can be changed to binary with FORMat:DATA which transports faster over the bus. Adjacent Channel Power Measurement Commands for querying the adjacent channel power measurement results and for setting to the default values are found in the “MEASure Group of Commands” on page 255.
Language Reference SENSe Subsystem Adjacent Channel Power—Averaging Termination Control [:SENSe]:ACP:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:ACP:AVERage:TCONtrol? Select the type of termination control used for averaging. This determines the averaging action after the specified number of data acquisitions (average count) is reached. EXPonential – Each successive data acquisition after the average count is reached, is exponentially weighted and combined with the existing average.
Language Reference SENSe Subsystem [:SENSe]:ACP:BANDwidth[n]|BWIDth[n]:INTegration [:SENSe]:ACP:BANDwidth[n]|BWIDth[n]:INTegration? cdmaOne, W-CMDA (Trial & Arib) mode [:SENSe]:ACP:BANDwidth[n]|BWIDth[n]:INTegration[m] [:SENSe]:ACP:BANDwidth[n]|BWIDth[n]:INTegration[m]? Set the Integration bandwidth that will be used for the main (carrier) channel. BANDwidth[n]|BWIDth[n]: m=1 is base station and 2 is mobiles. The default is base station (1).
Language Reference SENSe Subsystem Remarks: With measurement type set at (TPR) total power reference, 1.40 MHz is sometimes used. Using 1.23 MHz will give a power that is very nearly identical to the 1.40 MHz value, and using 1.23 MHz will also yield the correct power spectral density with measurement type set at (PSD) reference. However, a setting of 1.40 MHz will not give the correct results with measurement type set at PSD reference.
Language Reference SENSe Subsystem History: Added revision A.05.00 or later Adjacent Channel Power—Fast Mode ADC Range [:SENSe]:ACP:FAST:OFFSet:ADC:RANGe AUTO|APEak|APLock|M6|P0|P6|P12|P18|P24 [:SENSe]:ACP:FAST:OFFSet:ADC:RANGe? Select the range for the gain-ranging that is done in front of the ADC when the [:SENSe]:ACP:SWEep:TYPE is set to Fast. This is an advanced control that normally does not need to be changed. If you are measuring a CW signal, see the description below.
Language Reference SENSe Subsystem measure the offset channels and wider dynamic range for the measurement is available. Factory Preset and *RST: 0 Range: −40.00 to 0.00 dB Remarks: You must be in the W-CDMA (3GPP) mode to use this command. Use INSTrument:SELect to set the mode. Adjacent Channel Power—Root Raised Cosine Filter Alpha [:SENSe]:ACP:FILTer[:RRC]:ALPHa [:SENSe]:ACP:FILTer[:RRC]:ALPHa? Set the alpha value of the Root Raised Cosine (RRC) filter. Factory Preset and *RST: 0.
Language Reference SENSe Subsystem Selecting more than the minimum number of segments will give you more dynamic range for making the measurement, but the measurement will take longer to execute. To use this command you must first set SENSe:ACP:FFTS:AUTO to off. Factory Preset and *RST: 1 Range: 1 to 12 Remarks: You must be in Basic, cdmaOne mode to use this command. Use INSTrument:SELect to set the mode. History: Revision A.03.00 or later, in cdmaOne revision A.04.
Language Reference SENSe Subsystem Adjacent Channel Power—Offset Frequency Absolute Limit [:SENSe]:ACP:LIST:ALIMit ,,,, [:SENSe]:ACP:LIST:ALIMit? Set the absolute limit on offset frequencies relative to the carrier. You can turn off (not use) specific offsets with the [:SENSe]:ACP:LIST:STATe command.
Language Reference SENSe Subsystem Adjacent Channel Power—Offset Frequency Power Mode [:SENSe]:ACP:LIST:POWer INTeg|PEAK,INTeg|PEAK,INTeg|PEAK,INTeg|PEAK,INTeg|PEAK [:SENSe]:ACP:LIST:POWer? Define the power measurement mode for each of the offset frequencies. You can turn off (not use) specific offsets with the SENS:ACP:LIST:STATe command. Factory Preset and *RST: INTeg, INTeg, INTeg, INTeg, INTeg Remarks: You must be in the NADC mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem Factory Preset and *RST: Mode Offset A Offset B Offset C Offset D Offset E NADC ON ON ON OFF OFF PDC ON ON OFF OFF OFF Remarks: You must be in the NADC, cdmaOne, or PDC mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem [:SENSe]:ACP:OFFSet[n]:LIST:ABSolute? W-CDMA (Trial & Arib) mode [:SENSe]:ACP:OFFSet[n]:LIST[m]:ABSolute ,,,, [:SENSe]:ACP:OFFSet[n]:LIST[m]:ABSolute? Sets the absolute amplitude levels to test against for each of the custom offsets. The list must contain five (5) entries. If there is more than one offset, the offset closest to the carrier channel is the first one in the list.
Language Reference SENSe Subsystem Range: −200.0 dBm to 50.0 dBm Default Unit: dBm Remarks: You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or iDEN mode to use this command. Use INSTrument:SELect to set the mode. Adjacent Channel Power—Type of Offset Averaging [:SENSe]:ACP:OFFSet:LIST:AVERage:TYPE MAXimum|RMS [:SENSe]:ACP:OFFSet:LIST:AVERage:TYPE? Selects the type of averaging to be used for the measurement at each offset.
Language Reference SENSe Subsystem cdmaOne, W-CDMA (Trial & Arib) mode [:SENSe]:ACP:OFFSet[n]:LIST[n]:BANDwidth|BWIDth ,,,, [:SENSe]:ACP:OFFSet[n]:LIST[n]:BANDwidth|BWIDth? Define the custom resolution bandwidth(s) for the adjacent channel power testing. If there is more than one bandwidth, the list must contain five (5) entries. Each resolution bandwidth in the list corresponds to an offset frequency in the list defined by [:SENSe]:ACP:OFFSet[n]:LIST[n][:FREQuency].
Language Reference SENSe Subsystem Default Unit: Hz Remarks: You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or iDEN mode to use this command. Use INSTrument:SELect to set the mode. Adjacent Channel Power—FFT Segments [:SENSe]:ACP:OFFSet:LIST:FFTSegment ,,,, [:SENSe]:ACP:OFFSet:LIST:FFTSegment? Selects the number of FFT segments used in making the measurement.
Language Reference SENSe Subsystem Factory Preset and *RST: Mode Offset A Offset B Offset C Offset D Offset E Basic & cdmaOne ON ON ON ON ON Remarks: You must be in Basic mode to use this command. Use INSTrument:SELect to set the mode. History: Revision A.03.
Language Reference SENSe Subsystem List[n] cdmaOne mode n=1 is cellular bands and 2 is pcs bands. The default is cellular. W-CDMA (Trial & Arib) mode n=1 is ARIB, 2 is 3GPP, and 3 is Trial. The default is ARIB (1). Factory Preset and *RST: Mode Offset A Offset B Offset C Offset D Offset E iDEN 25 kHz n/a n/a n/a n/a Basic 750 kHz 1.98 MHz 0 Hz 0 Hz 0 Hz BS cellular 750 kHz 1.98 MHz 0 Hz 0 Hz 0 Hz BS pcs 885 kHz 1.25625 MHz 2.75 MHz 0 Hz 0 Hz MS cellular 885 kHz 1.
Language Reference SENSe Subsystem Adjacent Channel Power—Number of Measured Points [:SENSe]:ACP:OFFSet:LIST:POINts ,,,, [:SENSe]:ACP:OFFSet:LIST:POINts? Selects the number of data points. The automatic mode chooses the optimum number of points for the fastest measurement time with acceptable repeatability. The minimum number of points that could be used is determined by the sweep time and the sampling rate.
Language Reference SENSe Subsystem Adjacent Channel Power—Relative Attenuation [:SENSe]:ACP:OFFSet:LIST:RATTenuation ,,,, [:SENSe]:ACP:OFFSet:LIST:RATTenuation? Sets a relative amount of attenuation for the measurements made at your offsets. The amount of attenuation is always specified relative to the attenuation that is required to measure the carrier channel.
Language Reference SENSe Subsystem Factory Preset and *RST: ON Remarks: You must be in Basic or cdmaOne mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem W-CDMA (Trial & Arib) mode n=1 is ARIB, 2 is 3GPP, and 3 is Trial. The default is ARIB (1).
Language Reference SENSe Subsystem [:SENSe]:ACP:OFFSet:LIST:RPSDensity? cdma2000, W-CDMA (3GPP) mode [:SENSe]:ACP:OFFSet[n]:LIST:RPSDensity ,,,, [:SENSe]:ACP:OFFSet[n]:LIST:RPSDensity? cdmaOne, W-CDMA (Trial & Arib) mode [:SENSe]:ACP:OFFSet[n]:LIST[n]:RPSDensity ,,,, [:SENSe]:ACP:OFFSet[n]:LIST[n]:RPSDensity? Sets the amplitude levels to test against for any custom offsets.
Language Reference SENSe Subsystem Mode Variant Offset A Offset B Offset C Offset D Offset E 0 dB 0 dB 0 dB 0 dB 0 dB BTS −44.2 dBc −49.2 dBc −49.2 dBc −49.2 dBc −44.2 dBc MS −32.2 dBc −42.2 dBc −42.2 dBc −42.2 dBc −42.2 dBc 0 dB 0 dB 0 dB 0 dB 0 dB cdma2000 W-CDMA (3GPP) W-CDMA (Trial & Arib) −150.0 dB to 50.0 dB for cdmaOne, Basic, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib) Range: −200.0 dB to 50.
Language Reference SENSe Subsystem Adjacent Channel Power—Control Offset Frequency List Basic mode, cdmaOne [:SENSe]:ACP:OFFSet:LIST:STATe OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1 [:SENSe]:ACP:OFFSet:LIST:STATe? cdma2000, W-CDMA (3GPP) mode [:SENSe]:ACP:OFFSet[n]:LIST:STATe OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1 [:SENSe]:ACP:OFFSet[n]:LIST:STATe? cdmaOne, W-CDMA (Trial & Arib) mode [:SENSe]:ACP:OFFSet[n]:LIST[n]:STATe OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF
Language Reference SENSe Subsystem Mode Variant Offset A Offset B Offset C Offset D Offset E W-CDMA (3GPP) On On Off Off Off W-CDMA (Trial & Arib) On On Off Off Off Remarks: You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem Adjacent Channel Power—Automatic Sweep Time [:SENSe]:ACP:OFFSet:LIST:SWEep:TIME:AUTO OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1, OFF|ON|0|1 [:SENSe]:ACP:OFFSet:LIST:SWEep:TIME:AUTO? Sets the sweep time to be automatically coupled for the fastest measurement time. You can turn off (not use) specific offsets with the SENS:ACP:OFFSet:LIST:STATe command.
Language Reference SENSe Subsystem Defines the type of testing to be done at any custom offset frequencies. The measured powers are tested against the absolute values defined with [:SENSe]:ACP:OFFSet[n]:LIST[n]:ABSolute, or the relative values defined with [:SENSe]:ACP:OFFSet[n]:LIST[n]:RPSDensity and [:SENSe]:ACP:OFFSet[n]:LIST[n]:RCARrier. You can turn off (not use) specific offsets with the [:SENS]:ACP:OFFSet[n]:LIST[n]:STATe command. Offset[n] n=1 is base station and 2 is mobiles.
Language Reference SENSe Subsystem Mode Variant Offset A Offset B Offset C Offset D Offset E W-CDMA (3GPP) REL REL REL REL REL W-CDMA (Trial & Arib) REL REL REL REL REL Remarks: You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or iDEN mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem Remarks: You must be in Basic, cdmaOne mode to use this command. Use INSTrument:SELect to set the mode. Adjacent Channel Power—Spectrum Trace Control [:SENSe]:ACP:SPECtrum:ENABle OFF|ON|0|1 [:SENSe]:ACP:SPECtrum:ENABle? Turns on/off the measurement of the spectrum trace data when the spectrum view is selected. (Select the view with DISPlay:ACP:VIEW.
Language Reference SENSe Subsystem Adjacent Channel Power—Sweep Mode Resolution BW Control [:SENSe]:ACP:SWEep:BANDwidth|BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:ACP:SWEep:BANDwidth|BWIDth[:RESolution]:AUTO? Sets the resolution bandwidth to automatic, when using the spectrum analyzer type sweep mode. See [:SENSe]:ACP:SWEep:TYPE. Factory Preset and *RST: ON Remarks: You must be in the cdmaOne cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use this command.
Language Reference SENSe Subsystem Selecting a specific sweep time may result in a long measurement time since the resulting number of data points my not be the optimum 2n. Use [:SENSe]:ACP:OFFSet:LIST:SWEep:TIME to set the number of points used for measuring the offset channels for Basic and cdmaOne. For cdma2000 and W-CDMA, this command sets the sweep time when using the sweep mode. See [:SENSe]:ACP:SWEep:TYPE. Factory Preset and *RST: 625 µs (1 slot) for W-CDMA (3GPP), W-CDMA (Trial & Arib) 1.
Language Reference SENSe Subsystem cdma2000, W-CDMA (Trial & ARIB) mode [:SENSe]:ACP:SWEep:TYPE FFT|SWEep [:SENSe]:ACP:SWEep:TYPE? Selects the type of sweeping. Fast (W-CDMA (3GPP) mode only) - the data acquisition is made with the wide channel integration bandwidth and the time-domain data is divided into the narrow data to apply FFT. This mode is faster than the FFT mode but less accurate in power levels.
Language Reference SENSe Subsystem RFBurst for MS Remarks: You must be in Basic, cdmaOne, iDEN, NADC, or PDC mode to use this command. Use INSTrument:SELect to set the mode. In Basic mode, for offset frequencies >12.5 MHz, the external triggers will be a more reliable trigger source than RF burst. Also, you can use the Waveform measurement to set up trigger delay. Adjacent Channel Power—Power Reference [:SENSe]:ACP:TYPE PSDRef|TPRef [:SENSe]:ACP:TYPE? Selects the measurement type.
Language Reference SENSe Subsystem For 600 Ohms: 2.2, −3.8. −9.8, or −15.8 dBm 60.0, 54.0, 48.0, or 41.9 dBmV 0.0017, 0.00042, 0.0001, or 0.000026 W For 1 M Ohm: Values for 1 M Ohm vary according to selected reference impedance. Default Units: DBM Remarks: You must be in the Basic, W-CDMA, cdma2000 mode to use this command. Use INSTrument:SELect to set the mode. History: Added revision A.05.
Language Reference SENSe Subsystem 512 to 885 for DCS1800 512 to 810 for PCS1900 259 to 293 for GSM450 306 to 340 for GSM480 438 to 511 for GSM700 128 to 251 for GSM850 Remarks: You must be in the EDGE(w/GSM), GSM mode to use this command. Use INSTrument:SELect to set the mode. Global to the current mode. History: Version A.03.
Language Reference SENSe Subsystem Select the Middle ARFCN [:SENSe]:CHANnel:ARFCn|RFCHannel:MIDDle Set the analyzer to the frequency of the middle ARFCN (Absolute RF Channel Number) of the selected radio band. Factory Preset and *RST: 38 for E-GSM 63 for P-GSM 28 for R-GSM 699 for DCS1800 661 for PCS1900 276 for GSM450 323 for GSM480 474 for GSM 700 189 for GSM850 Remarks: You must be in the EDGE(w/GSM), GSM mode to use this command. Use INSTrument:SELect to set the mode. Global to the current mode.
Language Reference SENSe Subsystem 511 for GSM700 251 for GSM850 Remarks: You must be in the EDGE(w/GSM), GSM mode to use this command. Use INSTrument:SELect to set the mode. Global to the current mode. History: Version A.03.00 or later Front Panel Access: FREQUENCY Channel, BMT Freq Burst Type [:SENSe]:CHANnel:BURSt TCH|CCH [:SENSe]:CHANnel:BURSt? Set the burst type for mobile station testing.
Language Reference SENSe Subsystem Front Panel Access: FREQUENCY Channel, Burst Type Digital Demod PN Offset [:SENSe]:CHANnel:PNOFfset [:SENSe]:CHANnel:PNOFfset? Set the PN offset number for the base station being tested. Factory Preset and *RST: 0 Range: 0 to 511 Default Unit: None Remarks: Global to the current mode. You must be in the cdmaOne mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem Front Panel Access: Mode Setup, Radio, Frequency Hopping Repetition Factor Time Slot Auto [:SENSe]:CHANnel:SLOT:AUTO OFF|ON|0|1 [:SENSe]:CHANnel:SLOT:AUTO? Select auto or manual control for slot searching. The feature is only supported in external and frame trigger source modes.
Language Reference SENSe Subsystem History: Version A.03.00 or later Front Panel Access: FREQUENCY Channel, TSC (Std) Training Sequence Code (TSC) Auto [:SENSe]:CHANnel:TSCode:AUTO OFF|ON|0|1 [:SENSe]:CHANnel:TSCode:AUTO? Select auto or manual control for training sequence code (TSC) search. With auto on, the measurement is made on the first burst found to have one of the valid TSCs in the range 0 to 7 (i.e. normal bursts only).
Language Reference SENSe Subsystem Factory Preset and *RST: 20 200, for W-CDMA, W-CDMA (Trial & Arib) Range: 1 to 10,000 Remarks: You must be in the cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or Basic mode to use this command. Use INSTrument:SELect to set the mode. Channel Power—Averaging State [:SENSe]:CHPower:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CHPower:AVERage[:STATe]? Turn averaging on or off.
Language Reference SENSe Subsystem Channel Power—Integration BW [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration? Set the Integration BW (IBW) that will be used. Factory Preset and *RST: 1.23 MHz for Basic, cdmaOne, cdma2000 5.0 MHz for W-CDMA (3GPP), W-CDMA (Trial & Arib) Range: 1 kHz to 10 MHz Default Unit: Hz Remarks: You must be in the cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or Basic mode to use this command.
Language Reference SENSe Subsystem Channel Power—Data Points [:SENSe]:CHPower:POINts [:SENSe]:CHPower:POINts? Set the number of data points that will be used. Changing this will change the time record length and resolution BW that are used. Factory Preset and *RST: 512 Range: 64 to 32768, in a 2n sequence Remarks: You must be in the cdmaOne, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), or Basic mode to use this command. Use INSTrument:SELect to set the mode.
Language Reference SENSe Subsystem Range: 1 µs to 50 ms Default Unit: seconds Remarks: You must be in Basic, cdmaOne, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use this command. Use INSTrument:SELect to set the mode. History: Version A.03.00 and later Channel Power—Sweep Time [:SENSe]:CHPower:SWEep:TIME:AUTO OFF|ON|0|1 [:SENSe]:CHPower:SWEep:TIME:AUTO? Selects the automatic sweep time, optimizing the measurement.
Language Reference SENSe Subsystem Signal Corrections Commands Correction for RF Port External Attenuation [:SENSe]:CORRection[:RF]:LOSS [:SENSe]:CORRection[:RF]:LOSS? Set the correction equal to the external attenuation used when measuring the device under test. Factory Preset and *RST: 0 dB Range: -50 to +50 dB Default Unit: dB Remarks: You must be in the Basic mode to use this command. Use INSTrument:SELect to set the mode. Value is global to Basic mode.
Language Reference SENSe Subsystem Factory Preset and *RST: RF Front Panel Access: Input, Input Port History: VSA modified in A.05.00 version Frequency Commands Center Frequency [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer? Set the center frequency. Factory Preset and *RST: 1.0 GHz 942.6 MHz for GSM, EDGE 806.0 MHz for iDEN Range: 1.0 kHz to 4.
Language Reference SENSe Subsystem History: Version A.03.00 or later Front Panel Access: FREQUENCY/Channel, CF Stepl RF Power Commands RF Port Input Attenuation [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation? Set the RF input attenuator. This value is set at its auto value if input attenuation is set to auto.
Language Reference SENSe Subsystem RF Port Power Range Auto [:SENSe]:POWer[:RF]:RANGe:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:RANGe:AUTO? Select the RF port power range to be set either automatically or manually. ON - power range is automatically set as determined by the actual measured power level at the start of a measurement.
Language Reference SENSe Subsystem Front Panel Access: Input, Max Total Pwr (at UUT) Power Statistics CCDF Measurement Commands for querying the statistical power measurement of the complimentary cumulative distribution function (CCDF) measurement results and for setting to the default values are found in the “MEASure Group of Commands” on page 255.
Language Reference SENSe Subsystem Remarks: You must be in the Basic, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use this command. Use INSTrument:SELect to set the mode. Power Statistics CCDF—Sweep Time [:SENSe]:PSTatistic:SWEep:TIME
Language Reference SENSe Subsystem Remarks: You must be in the Basic, cdma2000, W-CDMA (3GPP), or W-CDMA (Trial & Arib) mode to use this command. Use INSTrument:SELect to set the mode. Power vs. Time Measurement Commands for querying the power versus time measurement results and for setting to the default values are found in the “MEASure Group of Commands” on page 255.
Language Reference SENSe Subsystem Power vs. Time—Averaging Mode [:SENSe]:PVTime:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:PVTime:AVERage:TCONtrol? Select the type of termination control used for the averaging function. This specifies the averaging action after the specified number of bursts (average count) is reached. EXPonential - Each successive data acquisition after the average count is reached is exponentially weighted and combined with the existing average.
Language Reference SENSe Subsystem Power vs. Time—Resolution BW [:SENSe]:PVTime:BANDwidth|BWIDth[:RESolution] [:SENSe]:PVTime:BANDwidth|BWIDth[:RESolution]? Set the resolution BW. This is an advanced control that normally does not need to be changed. Setting this to a value other than the factory default, may cause invalid measurement results. Factory Preset and *RST: 500 kHz Range: 1 kHz to 5 MHz Default Unit: Hz Remarks: You must be in the EDGE(w/GSM), GSM or Service mode to use this command.
Language Reference SENSe Subsystem burst edges. Factory Preset and *RST: 1 Range: 1 to 50 (for resolution BW = 500 kHz) Remarks: You must be in the EDGE(w/GSM), GSM or Service mode to use this command. Use INSTrument:SELect to set the mode. Power vs. Time—Trigger Source [:SENSe]:PVTime:TRIGger:SOURce EXTernal[1]|EXTernal2 |FRAMe|IF|IMMediate|RFBurst [:SENSe]:PVTime:TRIGger:SOURce? Select the trigger source used to control the data acquisitions.
Language Reference SENSe Subsystem Radio Standards Commands Radio Carrier Hopping [:SENSe]:RADio:CARRier:HOP OFF|ON|0|1 [:SENSe]:RADio:CARRier:HOP? Turns the carrier hopping mode on and off. Factory Preset and *RST: OFF Remarks: Global to the current mode. You must be in the EDGE(w/GSM), GSM mode to use this command. Use INSTrument:SELect to set the mode. History: Version A.03.
Language Reference SENSe Subsystem this command. Use INSTrument:SELect to set the mode. Global to the current mode. History: Version A.03.00 or later Front Panel Access: Mode Setup, Radio, Carrier Radio Device Under Test [:SENSe]:RADio:DEVice BS|MS [:SENSe]:RADio:DEVice? Select the type of radio device to be tested. BS – Base station transmitter test. MS – Mobile station transmitter test. Factory Preset and *RST: BS Remarks: You must be in the NADC, or PDC mode to use this command.
Language Reference SENSe Subsystem Front Panel Access: Mode Setup, Radio, Device Radio Device Under Test [:SENSe]:RADio:DEVice INBound|OUTBound [:SENSe]:RADio:DEVice? Select the type of radio device to be tested. If you are testing a base station, it must be put into the test mode to transmit known bit patterns. OUTBound – Base station transmitter test INBound – Mobile station transmitter test Factory Preset and *RST: Inbound Remarks: You must be in the iDEN mode to use this command.
Language Reference SENSe Subsystem Frequency Offset of MS to BTS [:SENSe]:RADio:FOFFset [:SENSe]:RADio:FOFFset? Set the amount of frequency offset (MS freq − BTS freq). Factory Preset and *RST: 190.0 MHz Range: −500.0 MHz to 500.0 MHz Remarks: Global to the current mode. You must be in the W-CDMA (Trial & Arib) mode to use this command. Use INSTrument:SELect to set the mode. History: Version A.03.
Language Reference SENSe Subsystem Radio Format (Standard) [:SENSe]:RADio:FORMat M16QAM|M64QAM|DJSMR [:SENSe]:RADio:FORMat? Select the format that testing will be compliant with when measurements are made. M16QAM - is a standard iDEN format defined by Motorola M64QAM - is a standard iDEN format defined by Motorola DJSMR - is Japanese standard format that is based on the ARIB RCR-32A standard Factory Preset and *RST: M16QAM Remarks: You must be in the iDEN mode to use this command.
Language Reference SENSe Subsystem Front Panel Access: Mode Setup, Radio, Band Radio Standard Band [:SENSe]:RADio:STANdard:BAND PGSM900|EGSM900|RGSM900|DCS1800|PCS1900|GSM450| GSM480|GSM850 [:SENSe]:RADio:STANdard:BAND? Select the standard variant that applies to the radio to be tested.
Language Reference SENSe Subsystem Remarks: You must be in the NADC or PDC mode to use this command. Use INSTrument:SELect to set the mode. Reference Oscillator Commands Reference Oscillator External Frequency [:SENSe]:ROSCillator:EXTernal:FREQuency [:SENSe]:ROSCillator:EXTernal:FREQuency? Specify to the frequency of the external reference being supplied to the instrument. Switch to the external reference with ROSC:SOUR.
Language Reference SENSe Subsystem Reference Oscillator Source [:SENSe]:ROSCillator:SOURce INTernal|EXTernal [:SENSe]:ROSCillator:SOURce? Select the reference oscillator (time base) source. Use ROSC:EXT:FREQ to tell the instrument the frequency of the external reference. INTernal - uses internally generated 10 MHz reference signal EXTernal - uses the signal at the rear panel external reference input port. Preset and *RST: Persistent State with factory default of Internal Remarks: Global to system.
Language Reference SENSe Subsystem Spectrum—ADC Dither [:SENSe]:SPECtrum:ADC:DITHer[:STATe] AUTO|ON|OFF|2|1|0 [:SENSe]:SPECtrum:ADC:DITHer[:STATe]? Turn the ADC dither on or off. This is an advanced control that normally does not need to be changed. Factory Preset and *RST: AUTO Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect.
Language Reference SENSe Subsystem For “bursty” signals, auto-peak lock ranging should not be used. The measurement will fail to operate, since the wrong (locked) ADC range will be chosen often and overloads will occur in the ADC. • M6 - manually selects an ADC range that subtracts 6 dB of fixed gain across the range. Manual ranging is best for CW signals. • P0 to 24 - manually selects ADC ranges that add 0 to 24 dB of fixed gain across the range. Manual ranging is best for CW signals.
Language Reference SENSe Subsystem Factory Preset and *RST: ON Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Spectrum—Averaging Mode [:SENSe]:SPECtrum:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:SPECtrum:AVERage:TCONtrol? Select the type of termination control used for the averaging function. This determines the averaging action after the specified number of ‘sweeps’ (average count) is reached.
Language Reference SENSe Subsystem Spectrum— Select Pre-FFT Bandwidth [:SENSe]:SPECtrum:BANDwidth|BWIDth:IF:AUTO OFF|ON|0|1 [:SENSe]:SPECtrum:BANDwidth|BWIDth:IF:AUTO? Select auto or manual control of the pre-FFT BW. Factory Preset and *RST: AUTO, 1.55 MHz Front Panel Access: Measure, Spectrum, Meas Setup, More, Advanced, Pre-FFT BW.
Language Reference SENSe Subsystem combinations of these settings that are not valid. Factory Preset and *RST: 1.55 MHz 1.25 MHz for cdmaOne 155.0 kHz, for iDEN mode Range: 1 Hz to 10.0 MHz Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Spectrum—Pre-FFT BW Filter Type [:SENSe]:SPECtrum:BANDwidth|BWIDth:PFFT:TYPE FLAT|GAUSsian [:SENSe]:SPECtrum:BANDwidth|BWIDth:PFFT:TYPE? Select the type of pre-FFT filter that is used.
Language Reference SENSe Subsystem Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Spectrum—Resolution BW Auto [:SENSe]:SPECtrum:BANDwidth|BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:SPECtrum:BANDwidth|BWIDth[:RESolution]:AUTO? Select auto or manual control of the resolution BW. The automatic mode couples the resolution bandwidth setting to the frequency span.
Language Reference SENSe Subsystem Spectrum—FFT Length [:SENSe]:SPECtrum:FFT:LENGth [:SENSe]:SPECtrum:FFT:LENGth? Set the FFT length. This value is only used if length control is set to manual. The value must be greater than or equal to the window length value. Any amount greater than the window length is implemented by zero-padding. This is an advanced control that normally does not need to be changed.
Language Reference SENSe Subsystem Spectrum—FFT Minimum Points in Resolution BW [:SENSe]:SPECtrum:FFT:RBWPoints [:SENSe]:SPECtrum:FFT:RBWPoints? Set the minimum number of data points that will be used inside the resolution bandwidth. The value is ignored if length control is set to manual. This is an advanced control that normally does not need to be changed. Factory Preset and *RST: 1.30 Range: 0.
Language Reference SENSe Subsystem Range: 8 to 1,048,576 Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. History: Short form changed from LENgth to LENGth, A.03.00 Spectrum—FFT Window [:SENSe]:SPECtrum:FFT:WINDow[:TYPE]BH4Tap|BLACkman| FLATtop|GAUSsian|HAMMing|HANNing|KB70|KB90|KB110|UNIForm [:SENSe]:SPECtrum:FFT:WINDow[:TYPE]? Select the FFT window type.
Language Reference SENSe Subsystem Range: 10 Hz to 10.0 MHz (15 MHz when Service mode is selected) Default Unit: Hz Remarks: The actual measured span will generally be slightly wider due to the finite resolution of the FFT. To use this command, the appropriate mode should be selected with INSTrument:SELect. Spectrum—Sweep (Acquisition) Time [:SENSe]:SPECtrum:SWEep:TIME[:VALue]
Language Reference SENSe Subsystem Factory Preset and *RST: AUTO Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Spectrum—Trigger Source [:SENSe]:SPECtrum:TRIGger:SOURce EXTernal[1]|EXTernal2|FRAMe|IF|LINE|IMMediate|RFBurst [:SENSe]:SPECtrum:TRIGger:SOURce? Select the trigger source used to control the data acquisitions.
Language Reference SENSe Subsystem This is an advanced control that normally does not need to be changed. Factory Preset and *RST: AUTO Remarks: You must be in the Service mode to use this command. Use INSTrument:SELect to set the mode. Waveform—ADC Dither State [:SENSe]:WAVeform:ADC:DITHer[:STATe] |OFF|ON|0|1 [:SENSe]:WAVeform:ADC:DITHer[:STATe]? This is an Advanced control that normally does not need to be changed.
Language Reference SENSe Subsystem M6 - subtracts 6 dB of fixed gain across the range P0 to 24 - adds 0 to 24 dB of fixed gain across the range Factory Preset and *RST: AUTO Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Waveform - Query Aperture Setting [:SENSe]:WAVeform:APERture? Returns the waveform sample period (aperture) based on current resolution bandwidth, filter type, and decimation factor. Sample rate is the reciprocal of period.
Language Reference SENSe Subsystem selected with INSTrument:SELect. Waveform—Averaging Mode [:SENSe]:WAVeform:AVERage:TCONtrol EXPonential|REPeat [:SENSe]:WAVeform:AVERage:TCONtrol? Select the type of termination control used for the averaging function. This determines the averaging action after the specified number of ‘sweeps’ (average count) is reached. EXPonential - Each successive data acquisition after the average count is reached, is exponentially weighted and combined with the existing average.
Language Reference SENSe Subsystem Set the resolution bandwidth. This value is ignored if the function is auto-coupled. Factory Preset and *RST: 100.0 kHz for NADC, PDC, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & Arib), basic, service 500.0 kHz for GSM 2.0 MHz for cdmaOne Range: 1.0 kHz to 5.0 MHz Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect.
Language Reference SENSe Subsystem Waveform—Decimation of Waveform Display [:SENSe]:WAVeform:DECimate[:FACTor] [:SENSe]:WAVeform:DECimate[:FACTor]? Set the amount of data decimation done on the IQ data stream. For example, if 4 is selected, three out of every four data points will be thrown away. So every 4th data point will be kept. Factory Preset and *RST: 1 Range: 1 to 4 Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect.
Language Reference SENSe Subsystem Remarks: To use this command, the appropriate mode should be selected with INSTrument:SELect. Waveform—Trigger Source [:SENSe]:WAVeform:TRIGger:SOURce EXTernal[1]| EXTernal2|FRAMe|IF|IMMediate|LINE|RFBurst [:SENSe]:WAVeform:TRIGger:SOURce? Select the trigger source used to control the data acquisitions.
Language Reference SERVice Subsystem SERVice Subsystem Provides SCPI access for the calibration manager. Numeric values for bit patterns can be entered using decimal or hexidecimal representations. (i.e. 0 to 32767 is equivalent to #H0 to #H7FFF) See the SCPI Basics information about using bit patterns for variable parameters. Prepare Calibration Files for Access :SERVice[:PRODuction]:CALibrate:BEGin Locks all of the calibration files for memory accesses. Remarks: No query.
Language Reference STATus Subsystem STATus Subsystem The STATus subsystem controls the SCPI-defined instrument-status reporting structures. Each status register has a set of five commands used for querying or masking that particular register. Numeric values for bit patterns can be entered using decimal or hexidecimal representations. (i.e. 0 to 32767 is equivalent to #H0 to #H7FFF) See the SCPI Basics information about using bit patterns for variable parameters.
Language Reference STATus Subsystem Operation Event Query :STATus:OPERation[:EVENt]? This query returns the decimal value of the sum of the bits in the Operation Event register. NOTE The register requires that the associated PTR or NTR filters be set before a condition register bit can set a bit in the event register. The data in this register is latched until it is queried. Once queried, the register is cleared. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem Preset the Status Byte :STATus:PRESet Sets bits in most of the enable and transition registers to their default state. It presets all the Transition Filters, Enable Registers, and the Error/Event Queue Enable. It has no effect on Event Registers, Error/Event QUEue, IEEE 488.2 ESE, and SRE Registers as described in IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and Common Commands for Use with ANSI/IEEE Std 488.1-1987. New York, NY, 1992.
Language Reference STATus Subsystem Factory Preset and *RST: 0 Range: 0 to 32767 Questionable Event Query :STATus:QUEStionable[:EVENt]? This query returns the decimal value of the sum of the bits in the Questionable Event register. NOTE The register requires that the associated PTR or NTR filters be set before a condition register bit can set a bit in the event register. The data in this register is latched until it is queried. Once queried, the register is cleared.
Language Reference STATus Subsystem Key Type: There is no equivalent front panel key. Factory Preset and *RST: 32767 (all 1’s) Range: 0 to 32767 Questionable Calibration Register Questionable Calibration Condition :STATus:QUEStionable:CALibration:CONDition? This query returns the decimal value of the sum of the bits in the Questionable Calibration Condition register. NOTE The data in this register is continuously updated and reflects the current conditions.
Language Reference STATus Subsystem NOTE The register requires that the associated PTR or NTR filters be set before a condition register bit can set a bit in the event register. The data in this register is latched until it is queried. Once queried, the register is cleared. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem Questionable Frequency Register Questionable Frequency Condition :STATus:QUEStionable:FREQuency:CONDition? This query returns the decimal value of the sum of the bits in the Questionable Frequency Condition register. NOTE The data in this register is continuously updated and reflects the current conditions. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem Questionable Frequency Negative Transition :STATus:QUEStionable:FREQuency:NTRansition :STATus:QUEStionable:FREQuency:NTRansition? This command determines what bits in the Questionable Frequency Condition register will set the corresponding bit in the Questionable Frequency Event register when the condition register bit has a negative transition (1 to 0). The variable is the sum of the decimal values of the bits that you want to enable.
Language Reference STATus Subsystem Questionable Integrity Enable :STATus:QUEStionable:INTegrity:ENABle :STATus:QUEStionable:INTegrity:ENABle? This command determines what bits in the Questionable Integrity Condition Register will set bits in the Questionable Integrity Event register, which also sets the Integrity Summary bit (bit 9) in the Questionable Register. The variable is the sum of the decimal values of the bits you want to enable.
Language Reference STATus Subsystem Questionable Integrity Positive Transition :STATus:QUEStionable:INTegrity:PTRansition :STATus:QUEStionable:INTegrity:PTRansition? This command determines what bits in the Questionable Integrity Condition register will set the corresponding bit in the Questionable Integrity Event register when the condition register bit has a positive transition (0 to 1). The variable is the sum of the decimal values of the bits that you want to enable.
Language Reference STATus Subsystem Questionable Integrity Signal Event Query :STATus:QUEStionable:INTegrity:SIGNal[:EVENt]? This query returns the decimal value of the sum of the bits in the Questionable Integrity Signal Event register. NOTE The register requires that the associated PTR or NTR filters be set before a condition register bit can set a bit in the event register. The data in this register is latched until it is queried. Once queried, the register is cleared.
Language Reference STATus Subsystem Factory Preset and *RST: 32767 (all 1’s) Range: 0 to 32767 Questionable Integrity Uncalibrated Register Questionable Integrity Uncalibrated Condition :STATus:QUEStionable:INTegrity:UNCalibrated:CONDition? This query returns the decimal value of the sum of the bits in the Questionable Integrity Uncalibrated Condition register. NOTE The data in this register is continuously updated and reflects the current conditions. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem NOTE The register requires that the associated PTR or NTR filters be set before a condition register bit can set a bit in the event register. The data in this register is latched until it is queried. Once queried, the register is cleared. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem Questionable Power Register Questionable Power Condition :STATus:QUEStionable:POWer:CONDition? This query returns the decimal value of the sum of the bits in the Questionable Power Condition register. NOTE The data in this register is continuously updated and reflects the current conditions. Key Type: There is no equivalent front panel key.
Language Reference STATus Subsystem Questionable Power Negative Transition :STATus:QUEStionable:POWer:NTRansition :STATus:QUEStionable:POWer:NTRansition? This command determines what bits in the Questionable Power Condition register will set the corresponding bit in the Questionable Power Event register when the condition register bit has a negative transition (1 to 0). The variable is the sum of the decimal values of the bits that you want to enable.
Language Reference STATus Subsystem Questionable Temperature Enable :STATus:QUEStionable:TEMPerature:ENABle :STATus:QUEStionable:TEMPerature:ENABle? This command determines what bits in the Questionable Temperature Condition Register will set bits in the Questionable Temperature Event register, which also sets the Temperature Summary bit (bit 4) in the Questionable Register. The variable is the sum of the decimal values of the bits you want to enable.
Language Reference STATus Subsystem Questionable Temperature Positive Transition :STATus:QUEStionable:TEMPerature:PTRansition :STATus:QUEStionable:TEMPerature:PTRansition? This command determines what bits in the Questionable Temperature Condition register will set the corresponding bit in the Questionable Temperature Event register when the condition register bit has a positive transition (0 to 1). The variable is the sum of the decimal values of the bits that you want to enable.
Language Reference SYSTem Subsystem SYSTem Subsystem This subsystem is used to set the controls and parameters associated with the overall system communication. These are functions that are not related to instrument performance. Examples include functions for performing general housekeeping and functions related to setting global configurations. GPIB Address :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess :SYSTem:COMMunicate:GPIB[:SELF]:ADDRess? Sets and queries the GPIB address.
Language Reference SYSTem Subsystem Options Configuration Query :SYSTem:CONFigure? The query returns the the current options configuration information. It will return the following type of information: #3764Model Number: E4406ASerial Number: US38330068 Host Id: E566DD69 Firmware Revision: A.05.07 Firmware Date: 20010327 STD SERVICE BAH GSM A.05.07 A.05.07 Standard ok Installed 9C8B6AABF2BE ok Installed BAC CDMA A.05.07 7FA587C8ECC1 ok Installed BAE NADC A.05.
Language Reference SYSTem Subsystem System Configuration Query :SYSTem:CONFigure[:SYSTem]? Returns a block of data listing the current option configuration information as on the Show System screen. For more information about how to use block data see the FORMat:DATA command or the Programming Fundamentals: SCPI Language Basics discussion on arbitrary length block data.
Language Reference SYSTem Subsystem Day - is an integer from 1 to 31 (depending on the month) Example: SYST:DAT 2001,4,15 Front Panel Access: System, Time/Date, Set Date Error Information Query :SYSTem:ERRor[:NEXT]? This command queries the earliest entry in the error queue and then deletes that entry. It can be used to continuously monitor the error queue for the occurrence of an error. *CLS clears the entire error queue.
Language Reference SYSTem Subsystem Factory Preset and *RST: Off. This parameter is persistent, which means that it retains the setting previously selected, even through a power cycle. Remarks: The verbose SCPI error debugging state is global to all the SCPI interfaces. History: Added version A.04.00 Front Panel Access: System, Show Errors, Verbose Exit Main Firmware for Upgrade :SYSTem:EXIT Exit the main firmware to allow the firmware to be upgraded.
Language Reference SYSTem Subsystem History: Added revision A.05.00 License Key for Installing New Applications :SYSTem:LKEY <‘option’>,<‘license key’> :SYSTem:LKEY? <‘option’> Enter the license key required for installing the specified new application (mode) or option. The query returns a string that contains the license key for a specified application or option that is already installed in the instrument.
Language Reference SYSTem Subsystem Remote Message :SYSTem:MESSage Enables remote user to send message that will appear in the Status Bar at bottom of the instrument display. New message will overwrite any previous message. Message will remain until removed by use of :SYSTem:MESSage:OFF.. The SYSTem:KLOCk command will lock out the front panel keys.
Language Reference SYSTem Subsystem Front Panel Access: Preset Preset Type Preset and *RST: Factory - This parameter is persistent, which means that it retains the setting previously selected, even through a power cycle. Remarks: :SYST:PRES:USER:SAVE defines the user preset. Example: SYST:PRES:TYPE FACT Front Panel Access: System, Pwr On/Preset, Preset Factory User Set Time :SYSTem:TIME ,, :SYSTem:TIME? Sets the time of the real-time clock of the instrument.
Language Reference SYSTem Subsystem SCPI Version Query :SYSTem:VERSion? Returns the SCPI version number with which the instrument complies.
Language Reference TRIGger Subsystem TRIGger Subsystem The Trigger Subsystem is used to set the controls and parameters associated with triggering the data acquisitions. Other trigger-related commands are found in the INITiate and ABORt subsystems. The trigger parameters are global within the selected Mode. The commands in the TRIGger subsystem set up the way the triggers function, but selection of the trigger source is made from each measurement.
Language Reference TRIGger Subsystem 0.0 to 1000.0 s for cdma2000, W-CDMA (3GPP), W-CDMA (Trial & ARIB) Default Unit: seconds External Trigger Delay :TRIGger[:SEQuence]:EXTernal[1]|2:DELay
Language Reference TRIGger Subsystem External Trigger Slope :TRIGger[:SEQuence]:EXTernal[1]|2:SLOPe NEGative|POSitive :TRIGger[:SEQuence]:EXTernal[1]|2:SLOPe? Sets the trigger slope when using an external trigger input.
Language Reference TRIGger Subsystem (Trial & ARIB) 90.0 ms for iDEN 20.0 ms with rate=full for NADC, PDC 40.0 ms with rate=half for NADC, PDC Range: 0.0 ms to 559.0 ms for Basic, cdmaOne, GSM, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & ARIB) 1.0 ms to 559.
Language Reference TRIGger Subsystem Remarks: You must be in the Basic, cdmaOne, EDGE (w/GSM), GSM, iDEN, NADC, PDC, Service mode to use this command. Use INSTrument:SELect to set the mode. History: Revision A.03.27 or later Front Panel Access: Mode Setup, Trigger, Frame Timer, Offset Trigger Holdoff :TRIGger[:SEQuence]:HOLDoff
Language Reference TRIGger Subsystem Video (IF) Trigger Level :TRIGger[:SEQuence]:IF:LEVel :TRIGger[:SEQuence]:IF:LEVel? Set the trigger level when using the IF (video) trigger. Factory Preset and *RST: −6.0 dBm for cdmaOne, GSM, Basic, Service, cdma2000, W-CDMA (3GPP), W-CDMA (Trial & ARIB) −20.0 dBm for iDEN −30.0 dBm for NADC, PDC Range: −200.0 to 50.
Language Reference TRIGger Subsystem Front Panel Access: Mode Setup, Trigger, RF Burst, Delay RF Burst Trigger Level :TRIGger[:SEQuence]:RFBurst:LEVel :TRIGger[:SEQuence]:RFBurst:LEVel? Set the trigger level when using the RF Burst (wideband) Trigger. The value is relative to the peak of the signal. RF Burst is also known as RF Envelope. Factory Preset −6.0 dB and *RST: Range: −25.0 to 0.0 dB −200.0 to 0.
Language Reference TRIGger Subsystem 398 Chapter 5
Index Symbols *CLS, 77 *ESE, 87, 88 *ESR?, 87 *SRE, 84 *STB?, 84 Numerics 10 MHz reference adjustment, 217 321.
Index compiling and linking, 114 creating, 113 example, 116 opening session, 117 sessions, 118 using VISA library, 113 using VISA transition library, 114, 117 C programing socket LAN, 104 C programming socket LAN, 148, 168 cable LAN, 111 cables RS-232, 48 calibrate immediately align now, 187 calibrate, IEEE command, 187 calibration, 214 abort, 213 ADC, 213, 214, 218, 220 ADC RAM, 214 all, 214 amount displayed, 216 attenuator, 214 automatic, 215 corrections on/off, 215 defaults, 220 IF flatness, 217 image f
Index window tile, 230 zoom, 230 display ACP data, 228 display commands, 228 display file types, 182 displays different views, 182 saving/recalling, 184 storing, 283, 284 displays, no.
Index iDEN offset frequencies, 294, 295, 297, 310 iDEN trigger source, 316 identity, IEEE command options, query model number, query, 188 IEEE common commands *commands, IEEE, 187 IF flatness adjustment, 217 IF trigger delay, 395 IF trigger level, 396 IF trigger slope, 396 image filter calibration, 216 increasing measurement speed, 67 initiate measurement, 192, 247, 248 input attenuation, 331 INPut commands, 249 input configuration, 249 input port selection, 329 input power maximum, 332 range, 332 input/ou
Index CCDF, 269 channel power, 268 CONF/FETC/MEAS/READ commands, 255 control of, 247 getting results, 255 power stat, 269 power vs.
Index product information on the web, 36 program creating, 46 program example C, 148, 168 Java, 171 socket LAN, 148, 168, 171 programming command syntax, 59 commands for desired functions, 182 creating a simple program, 38 example using C language, 116 making a measurement, 46 parameters, 62 SCPI basics, 59 using C language, 113 valid commands, 60 via LAN, 94 with C, 104 with Java, 104 with VEE, 103 programming commands, 185 programming errors, debug information, 385 programming example ACPR measurement, 1
Index ADC range, 347 data decimation, 352 FFT length, 353 FFT resolution BW, 354 FFT window, 354, 355 FFT window delay, 354 frequency span, 355 sweep time, 356 trigger source, 357 spectrum (frequency domain) measurement, 275, 346 See also SPECtrum spectrum measurement display, 230, 231, 235, 236 spectrum measurement, IF flatness, 217 speeding up your measurements, 67 spread rate setting, 342, 343 SRE command, 78 SRQ, 76, 191 SRQ command, 80 standard deviation of trace data, 196, 200 standard event status,
Index updating firmware, 43 URL for product information, 36 users, lock-out, 386 using GPIB, 56 LAN, 55, 89 using CONFigure command, 256 using FETCh? command, 257 using MEASure? command, 255 using READ? command, 257 V value, changing by steps, 62 VEE, 103 VEE programing socket LAN, 103 406 view ACP data, 228 view commands, 228 VISA library, 114, 117 voltage units, 63 W wait, IEEE command, 192 WAVeform acquisition packing, 357 ADC dithering, 358 ADC filter, 358 ADC range, 358 data decima
