Home

Programming Manual, PIM Master Passive Intermodulation Analyzer

image

Contents

1. 5 21 MMEMory LOAD STATe lt integer gt lt filename gt 5 21 MMEMory LOAD TRACe lt integer gt lt filename gt 5 22 MMEMory STORe STATe lt integer gt lt filename gt 5 22 MMEMory STORe TRACe lt integer gt lt filename gt 5 23 TRAGe PREaimble 1 nue eaten Et E AG Boe Fe Sa RO aan 5 24 LTRAGeE DATA liza A DIE Ee A Ib sede pmi 5 24 SENSe AVERage CLEar 00 a o a aa eaa teens 5 25 SENSe AVERage COUNt integer SENSe AVERage COUNt 5 25 SENSe AVERage STATe OFF ON O 1 SENSeJ AVERage STATe enoa a E AAA WA 5 25 I SENSej CORRection COLLect ABORt 5 26 I SENSej CORRection COLLect INITialize 5 26 SENSe CORRection COLLect LOAD 5 26 SENSe CORRection COLLect OPEN 5 27 I SENSej CORRection COLLect SHORt 5 27 SENSe CORRection COLLect STATus INITializel OPENISHOREILOAD 5 28 SENSe CORRection TYPe STANDARD FLEX MW82119B PM PN 10580 00403 Rev C C 5 Appendix C List of Commands by Mode SENSe CORRection TYPe
2. 4 11 CALCulate MARKer 1 2 3 4 5 6 PEAK 5 6 CALCulate MARKer 1 2 3 4 5 63 TRACe 0 1 CALCulate MARKer 1 23 4 5 6 I TRACe 4 14 CALCulate MARKer 1 23 4 5 6 VALLey 5 6 CALCulate MARKer 1 2 3 4 5 6 X lt x parameter gt CAL Culate MARKeri 1231456 Xu oa Yoke ea an a 4 15 CALCulate MARKer 1 2 3 4 5 6 X lt x parameter gt CAL Eulate MARKen 1231456 87 1o Bie rd 5 6 CALCulate MARKer 1 2 3 4 5 6 Y 2 ccc eee 4 16 CAECulite MARKert12345 60 V7 cuca re eM ex RA RAS 5 6 CALCulate MARKer 1 2 3 4 5 63 STA Te OFFJONJO 1 CAL Culate MARKer 121345 ESTATE 5 7 CALCulate MARKer 1 2 3 4 5 63 STATe OFFJONJO 1 CALCulate MARKer 1 234 5 J60 ESTATe 4 14 CALCulate MATH FUNCtion NORMal ADD SUBTract CAL Culate MA THSPUNGCTIOfI u eaae Sb oe asa naw QE ad 5 7 CALColate MATH MEMOTZe 5 7 CALCulate MATH OVERlay ONJOFF 5 8 CALCulate SCALe UNIT DBM DBC CAL Cullate SCARS WNIT C xen RA a I ECT DLE 4 16 CALCulate SMOothing integer CAT Culate SS MOON orre A Rhone vee wah Pa 5 8 CAL Culate TRANsform CLAVerage 5 8 CALCulate TRANsform DISTance CABLoss CALCulate TRANsform DISTance CABLoss 5 8 CALCulate TRA
3. 4 25 SENSe PlManalyzer AUTorange OFFJONJO 1 SENSej PiManalyzer AUTorange 4 25 SENSe PIManalyzer DTPMeas LRDTf STATe I SENSel PIManalyzer DTPMeas LRDTfI STATej 4 26 SENSe PlManalyzer DTPMeas LRDTf STARt 4 26 SENSel PIManalyzer DTPMeas LRDTf STOP 4 26 SENSe PlManalyzer FREQuency F1 2 SENSel PIManalyzer FREGuency F1 2 4 27 SENSe PlManalyzer FREQuency STEP SENSel PIManalyzer FREGuency STEP 4 27 SENSe PIManalyzer IMD ORDer SENSel PiManalyzer iIMD ORDEer 4 28 SENSe PIManalyzer IMFReq BAND LOWIHIGH SENSel PiManalyzer iIMFReg BAND 4 28 SENSe PlManalyzer MEASure STATUS 4 29 SENSe PlManalyzer MEASure VALue 4 29 SENSe PlManalyzer MODe PIM PIMSwp DTP SPECTRUM_VIEW SENSej PiManalyzer MODe 4 29 SENSe PIManalyzer OUTPut POWer SENSej PiManalyzer OUTPUt POWer 4 30 SENSe PlManalyzer RF OUTput ONJOFF SENSej PiManalyzer RF OUTput 4 30 SENSel PIManalyzer SPECtrum CURRent MEASure VALue
4. 5 13 CONFigure MEASure SWRDHtf 5 13 CONFigure MEASure 5 12 DISPlay WINDow TRACe Y SCALej AUToscale 5 14 DISPlay WINDow TRACe Y SCALe BOTTom lt value gt 5 14 DISPlay WINDow Trace Y SCALe PDI Vision DISPlay WINDow Trace Y SCALe PDIVision 4 18 DISPlay WINDow Trace Y SCALe RLEVel DISPlay WINDow Trace Y SCALel RLEVel 4 18 DISPlay WINDow TRACe Y SCALe SMCHart 0 10 20 30 3 DISPlay WINDow TRACe Y SCALe SMCHart 5 15 DISPlay WINDow TRACe Y SCALe TOP lt value gt 5 14 SEETCIUGPSS s td E a o PN DEN M ea AN 3 2 FORMat READings DATA ASCii INTeger 32 REAL 32 FORMat READings DATA 5 16 INITiate CONTinuous OFF ONJ0 1 INDIA CONTINUOUS ur iso ara Sa Wed oed Ven ta 5 19 INITiate HOLD OFFJONJO 1 STINE Tate HOED a ee a E il rs 5 19 INTTiate PIManalyzer MEASure OFFJONJO 1 4 19 INITiate PIManalyzer PVT ALLPower CAL 4 19 INITiate PIManalyzer RESidual CAL 4 19 INITiatef IMMediate 5 20 INSTrument CA Talog PULE Y Aussee EP HERR 3 3 INS Trument NSELect integer INS Tr rient NSELEESU rodar Q
5. 5 28 SENSe FREQuency CABle lt indek gt 5 28 SENSe FREQuency LINK UPLINK DOWNLINK UPANDDWNLINK ISENSe FREGuency LINK 5 29 SENSe FREQuency SIGStandard NAMe lt string gt SENSe FREQuency SIGStandard NAMe 5 29 SENSe FREQuency STARt freq SENSej FREOGuency STARt 5 30 SENSe FREQuency STOP freq ESENSe EFREQ ency STOP 2 0 a Bar IA ae na Hd 5 30 SENSe SWEep RESolution 137 275 551 1102 2204 SENSej SWEep RESolution 5 31 SENSe SWEep RFIMmunity 0 1 SENSe SWEep RFIMmunity 5 31 C 6 PN 10580 00403 Rev C MW82119B PM Appendix D List of Commands Alphabetical Appendix D List of Commands Alphabetical All SCPI Commands in Alphabetic List CALCulate DTPMeas CABLoss CALCulate DTPMeas CABLoss 4 2 CALCulate DTPMeas DISPlay RESOlution CAL Culate DTPMeas DISPlay RESOlution 4 2 CALCulate DTPMeas DMAK 4 3 CALCulate DTPMeas FRESolution 4 3 CALCulate DTPMeas PVELocity ATL Culate DTPMeas PVELocity 4 4 CALCulate DTPMeas REFerence AMPLi
6. A 18 PN 10580 00403 Rev C MW82119B PM Appendix B PIM Carrier Bands B 1 Introduction PIM tests are conducted by transmitting two test signals F1 and F2 into the system under test and then measuring intermodulation products created by those test signals that fall within the receive band of the system The PIM Master transmit signals are user adjustable within the range shown in Table B 1 MW82119B PM PN 10580 00403 Rev C B 1 B 2 PIM Master Carrier Bands B 2 Table B 1 PIM Master Carrier Bands Appendix B PIM Carrier Bands PIM Master Carrier Bands and Frequencies Frequency Range Option Rx Frequency Carrier Band F1 F2 Number Range MHz 734 MHz 752 MHz nr to to MW82119B 0700 698 to 717 734 5 MHz 768 MHz 734 MHz 746 MHz ds ki to to MW82119B 0700 777 to 806 pp 734 5 MHz 766 MHz 734 MHz 752 MHz re to to MW82119B 0701 698 to 717 734 5 MHz 768 MHz 734 MHz 746 MHz pn es to to MW82119B 0701 777 to 806 pp 734 5 MHz 766 MHz 791 MHz 811 5 MHz LTE 800 MHz to to MW82119B 0800 832 to 862 795 MHz 821 MHz 869 MHz 881 5 MHz Cellular 850 MHz to to MW82119B 0850 824 to 849 871 MHz 894 MHz 925 MHz 951 5 MHz E GSM 900 MHz to to MW82119B 0900 880 to 915 937 5 MHz 960 MHz 1805 MHz 1857 5 MHz DCS 1800 MHz to to MW82119B 0180 1710 to 1785 1837 MHz 1880 MHz 1930 MHz 1955 MHz PCS 1900 MHz to to MW82119B 0194 1850 to 1910 1945 MHz 1995 MHz 1930 MHz 2110 MHz
7. MW82119B PM PN 10580 00403 Rev C 1 5 1 4 Sending SCPI Commands Chapter 1 General Information 1 4 Sending SCPI Commands SCPI commands can be sent to the instrument through any Virtual Instrument Software Architecture VISA controller VISA is a commonly used API in the Test and Measurement industry for communicating with instruments from a PC The physical connection between the PC and the instrument is USB or Ethernet NI VISA is the National Instruments implementation of the VISA I O standard Information and downloads are available at http www ni com visa The following examples describe the verification that a VISA controller can interact with the instrument The images shown and the instructions for your instrument and software may differ from the examples Before remote operation confirm that the instrument is not in the Menu screen Note Sending commands while the Menu screen is displayed is an invalid operation See your User Guide regarding the Menu screen VISA Interactive Control 1 On the PC run VISA Interactive Control and double click on the instrument VISA Interactive Control Nnstromenrse Copyright 1995 2006 VISA 1 0 Soft Front Paneis NI 170 i View By Type View By Connection E My Computer 4 Serial Instrument Resources LY ASRL1 INSTR Y ASRL3 INSTR JY ASRL10 INSTR amp USB Instrument Resources AU SB0 0x0B5B 0xF FF9 8311335_192_29 INS Y Un
8. FREQuency LINK UPLINK DOWNLINK UPANDDWNLINK SENSe FREQuency LINK Title Description Parameter Parameter Type Front Panel Access Signal Standard Link Set Link signal standard parameter UPLINK DOWNLINK UPANDDWNLINK lt char gt Freq Dist Signal Standard UpLink DownLink UpLink plus DownLink SENSe FREQuency SIGStandard NAMe lt string gt SENSe FREQuency SIGStandard NAMe Title Description Parameter Front Panel Access Signal Standard Selects the desired signal standard from the list The lt string gt argument is the name of the desired signal standard as displayed in the instrument s current signal standard list The list can be seen on the instrument by choosing the Signal Standard submenu button in the Freq menu and then pressing the Select Standard submenu button in the Signal Standard menu The list can also be downloaded remotely and viewed using Anritsu Master Software Tools For example if the desired Signal Standard is E GSM 900 A then the value of the lt string gt argument would be P GSM 900 A To select Uplink Downlink Uplink plus Downlink use the command SENSe FREQuency LINK The query form of this command will return the name of the currently selected signal Standard on the list To query the link status use the command SENSe FREQuency LINK lt string gt Freq Dist Signal Standard Select Standard MW82119B PM PN 10580
9. Chapter 4 PIM Analyzer Programming Commands 4 6 MMEMory Subsystem MMEMory STORe TRACe lt integer gt lt file name gt Title Description Parameter Example Related Command Front Panel Access Save Measurement Stores the trace into the file specified by lt file name gt file name should be enclosed in either single quotes or double quotes and should not contain a file extension Use the command MMEMory MSIS to set the current storage location The integer parameter is not currently used but it must be sent Send a 0 integer file name gt To save the trace into the file name trace MMEMory STORe TRACe O trace MMEMory LOAD TRACe MMEMory MSIS INTernal USB Shift File 7 Save Measurement MMEMory LOAD STATe lt integer gt lt file name gt Title Description Parameter Example Related Command Front Panel Access Recall Setup Recalls a previously stored instrument setup in the current storage location The setup file to be loaded is specified by file name file name should be enclosed in either single quotes or double quotes and should contain a file extension stp Use the command MMEMory MSIS to set the current storage location The integer parameter is not currently used but it must be sent Send a 1 integer file name gt To recall a previously stored instrument setup MMEMory LOAD STATe 1 setup s
10. SENSe Subsystem 4 8 TRACe Subsystem Chapter 5 Cable 8 Antenna Commands 5 1 CALCulate Subsystem 5 2 CAlLibrationSubsystem 5 3 CONFigure Subsystem 5 4 DISPlaySubsystem 5 5 FORMat Subsystem Interpreting Returned Data Pair 5 6 lt INiTfiateSubsystem 5 7 MMEMory Subsystem 5 8 TRACe Subsystem IIIA KA e nn 5 9 SENSe Subsystem III IA ee beens Appendix A Examples Bei SCI CEPA LAA Re Ne HEWA A 2 Misual Basie o4 24 2 Ar aan Mus b ded s A3 MISUal Basic IA en e E EE e EAEE ENE A A Visual Basie euo cec a Ren neu uu deed d A 5 LabVIEW M sete ea tat aa LIV ea gae NET Tes Appendix B PIM Carrier Bands Bz1 Introduction ee ee E ae n Ed Cae ett ett b ens B 2 PIM Master Carrier Bands se Rh Contents 2 PN 10580 00403 Rev C MW82119B PM Appendix C List of Commands by Mode Appendix D List of Commands Alphabetical MW82119B PM PN 10580 00403 Rev C Contents 3 Contents 4 PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 1 About this Manual This SCPI Programming Manual provides informa
11. Title Description Parameter Parameter Type Default Value Example Front Panel Access DTP Reference Line Amplitude Sets and queries the amplitude of the reference line in DTP mode in the current units dBm by default 0 to 260 float None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the reference line to 100 dBm CALCulate DTPMeas REFerence AMPLitude 100 To query the reference line amplitude CALC DTPM REF AMPL Shift Limit 6 Amplitude PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCulate Subsystem CALCulate DTPMeas REFerence STATe OFF ON 0 1 CALCulate DTPMeas REFerence STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access DTP Reference Line State Turns the reference line ON or OFF If the value is set to ON or to 1 then the reference line is ON If the value is set to OFF or to 0 then the reference line is OFF The query version of the command returns a 1 if the reference line is ON and returns a 0 if it is OFF oFF oN o 1 boolean None To turn On the reference line CALCulate DTPMeas REFerence ON CALCulate DTPMeas REFerence STATe ON CALCulate DTPMeas REFerence STATe 1 To turn Off the reference line CALCulate DTPMeas REFerence OFF CALCulate DTPMeas REFerence STAT
12. 3 RX Receive data gt 3 volts White Green 4 Not used common mode termination Blue 5 Not used common mode termination White Blue 6 RX Receive data 3 volts Green 7 Not used common mode termination White Brown 8 Not used common mode termination Brown Connectivity TCP IP connectivity requires setting up the parameters that are described at the beginning of this section The following is a brief overview of how to set up a general LAN connection on the PIM Master You may need to consult your network documentation or network administrator for Note ae assistance in configuring your network setup PIM Master LAN Connections The RJ 45 connector is used to connect the PIM Master to a local area network LAN Integrated into this connector are two LEDs The amber LED Light Emitting Diode indicates the speed of the LAN connection ON for 100 Mb s and OFF for 10 Mb s and the green LED flashes to show that LAN traffic is present The instrument IP address is set automatically by using Dynamic Host Configuration Protocol DHCP DHCP is an Internet protocol that automates the process of setting IP addresses for devices that use TCP IP and is the most common method of configuring a device for network use After the Ethernet cable is connected to the instrument go to System then Status key sequence Shift gt System 9 gt Status to view the IP address that the instrument has been assigned
13. 4 28 SENSe PIManalyzer IMFReq BAND LOW HIGH SENSel PIManalyzer IMFReg BAND 4 28 SENSel PIManalyzer MEASure STATus 4 29 SENSe PIManalyzer MEASure VALue 4 29 SENSe PIManalyzer MODe PIM PIMSwp DTP SPECTRUM VIEW SENSe PIManalyzer MODe 4 29 SENSe PIManalyzer OUTPut POWer SENSel PIManalyzer OUTPut POWer 4 30 SENSe PIManalyzer RF OUTput ONJOFF SENSe PIManalvzer RP OUTDuUt 4 30 SENSel PIManalyzer SPECtrum CURRent FREOuency 4 31 SENSe PIManalyzer SPECtrum CURRent MEASure VALue 4 31 SENSel PIManalyzer SPECtrum MAK FREOuency 4 32 SENSel PIManalyzer SPECtrum MAK MEASure VALue 4 31 SENSe PIManalyzer SWEEp FREQuency F1 STARt SENSe PIManalyzer SWEEp FREQuency F1 STARt 4 32 SENSe PIManalyzer SWEEp FREQuency F1 STOP SENSel PIManalyzer SWEEp FREOuency FI STOP 4 33 SENSel PIManalyzer SWEEp FREOuency FI 2 4 32 SENSe PIManalyzer SWEEp FREQuency F2 STARt SENSe PIManalyzer SWEEp FREQuency F2 STARt 4 33 SENSe PIManalyzer S WEEp FREQuency F2 STOP SENSel PIManalyzer SWEEp FREOuency F2 STOP 4 34 SENSe PIManalyzer SW
14. C 2 13 2 7 Parameter Names Chapter 2 Programming with SCPI Table 2 8 Available Parameters in Cable amp Antenna Mode 4 of 4 Parameter Name Description LIM PFLAGS UPx Upper limit x flags where x is the limit point number starting with O LIM FREQNC UPx Upper limit point x freq where x is the limit point number starting with O LIM MAGNTD UPx Upper limit point x parameter where x is the limit point number starting with O 2 14 PN 10580 00403 Rev C MW82119B PM Chapter 3 All Modes Programming Commands The Anritsu PIM Master is capable of producing 80 Watts of RF power in the cellular communications bands Users must take precautions to minimize exposure to these RF fields Always terminate the PIM output port of the test equipment into a load a loaded line or a line that will radiate or absorb the energy before beginning a PIM test Warning Confirm that the PIM Master RF power is off after a PIM test Always confirm that the PIM RF power is off before disconnecting a coaxial connection otherwise RF burns may result Immediate burns to fingers or eyes can result from exposure to live connectors Ensure all antenna s under test are placed so that no personnel are exposed to RF levels that exceed the maximum allowable exposure The commands in this chapter are functional in all PIM Master modes of operation MW82119B PM PN 10580 00403 Rev C 3 1 3 1 FETCh GPS Subsyste
15. DESCR Trace name DATE Trace date time BASE_VER Base FW version APP_NAME Application name APP_VER Application FW version APP_MODE Application Mode CHECKSUM Checksum DIST_UNITS Distance units AMPL_UNITS y axis value units MEASUREMENT Measurement 1PORT_DOMAIN 1 Port Domain FREQ_START Start Frequency FREQ_STOP Stop Frequency DIST_START Start distance DIST_STOP Stop distance CAL_STATUS Calibrate Status On Off SWEEP TIME Sweep time SWEEP TYPE Sweep type Single Continuous MARKER SELECTED The selected marker MARKER TABLE Marker table status On Off TRACE_VIEW Trace View View Blank TRACE_STATE Trace State Write Hold WINDOWING Windowing Type Rectangular Nominal Side Lobe Low Side Lobe Minimum Side Lobe CABLE Cable index from the cable list PROP_VEL Propagation velocity CABLE_LOSS Cable Loss CW_STATUS RF Immunity On Off MW82119B PM PN 10580 00403 Rev C 2 11 2 7 Parameter Names Table 2 8 Chapter 2 Programming with SCPI Available Parameters in Cable amp Antenna Mode 2 of 4 Parameter Name OUTPUT_POWER_LEVEL Description Power Level High Low CURRENT_SIGNAL_STD Current signal standard RESOLUTION Sweep Resolution 137 275 551 SCALE Y axis scale RF SOURCE POWER LEVEL Source Power Level CAL TEMP WINDOW Cal Temp window CAL COEFFICIENT PTR Calibrate coefficient SMITH CHART TYPE Smith chart type DISPLAY CHANNE
16. Example Front Panel Access PIM Master Low Resolution DTF Sweep Stop Frequency Queries the DTF Sweep Stop Frequency in Hz Frequency in Hz To get the DTF Sweep Stop Frequency PIM DTPM LRDT STOP NA PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 SENSe Subsystem SENSe PIManalyzer FREQuency F1 2 SENSe PIManalyzer FREQuency F1 2 Title Description Parameter Default Unit Ranges Example Front Panel Access PIM Master Frequency Setup Sets the PIM vs Time carrier frequencies calculates the IMx Order frequency and sets the instrument to display the corresponding IMx frequency Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To set the PIM vs Time frequency F2 for 1990 MHz SENSe PIManalyzer FREQuency F2 1990000000 To get the PIM vs Time frequency F1 PIM FREQ F1 Freq Carrier F1 Carrier F2 SENSe PIManalyzer FREQuency STEP SENSe PIManalyzer FREQuency STEP Title Description Parameter Ranges Example Front Panel Access PIM Master Frequency Sweep Step Size Sets Frequency Step Size for Swept PIM and Spectrum View measurement modes The instrument may take up to 5 seconds to update this parameter and all dependent configurations Frequency in Hz 100 kHz to 1000 kHz in 100 kHz increments To set the s
17. SENS FREQ STAR 1 MHZ sense frequency start 1000000 FREQ STAR 1000 KHZ CALCulate MARKer X The first 2 commands set the location of lt value gt Hz kHz MHz GHz m cm mm ft marker 1 The third command sets the location of marker 2 CALC MARK X 1 GHZ CALC MARK1 X 1 GHZ CALC MARK2 X 2 GHZ INITiate CONTinuous OFF ON 0 1 The following commands are identical INITiate CONTinuous OFF init cont 0 Command statements read from left to right and from top to bottom In the command statement above the FREQuency keyword immediately follows the SENSe keyword with no separating space A space sp is used between the command string and its argument Note that the first keyword in the command string does not require a leading colon however it is good practice to always use a leading colon for all keywords Note also that the SENSe keyword is optional This is a SCPI convention for all voltage or signal source type instruments that allows shorter command statements to be used The following is an example of a multiple command statement that uses two separate commands in a single statement FREQuency STARt 10E6 FREQuency STOP 20E9 A semicolon is used to join tne commands and a leading colon used immediately Note after the semicolon to start the second command Command Terminators The new line character ASCII 10 in the last data byte of a command string is used as a command terminator Use of a
18. SWEEp FREQuency F1 2 Title Description Parameter Default Unit Range Example Front Panel Access PIM Master Swept PIM F2 Stop Frequency Setup Queries the Swept PIM Fixed F1 or F2 frequency Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To get the Swept PIM Fixed F2 frequency PIM SWEE FREQ F2 NA Note that fixed F1 and F2 frequencies are displayed in the lower measurement box in Swept Pim mode SENSe PIManalyzer SWEEp FREQuency F1 STARt SENSe PIManalyzer SWEEp FREQuency F1 STARt Title Description Parameter Default Unit Range Example PIM Master Swept PIM F1 Start Frequency Setup Sets the Swept PIM F1 start frequency for the Fixed F2 sweep then calculates the IMx sweep frequencies and sets the instrument to display the corresponding IMx sweep frequencies Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To set the F1 start frequency to 1990 MHz SENSe PIManalyzer SWEEp FREQuency F1 STARt 1990000000 PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands Front Panel Access 4 7 SENSe Subsystem To get the Swept PIM F1 start frequency PIM SWEE FREQ F1 STAR Freq Swept PIM Aid F1 Start SENSe PIManalyzer SWEEp FREQ
19. sInputString Len sInputString retCount Do Sleep 200 wait short measurement to complete and returns 1 sInputString SENS CORR COLL ACQU STAT SHORT 1 stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX CNT retCount Loop Until Val Buffer 1 measure load MsgBox Connect load at port 1 sInputString SENS CORR COLL ACQU LOAD 1 stat viWrite sesn sInputString Len sInputString retCount MW82119B PM PN 10580 00403 Rev C A 9 A 3 Visual Basic Appendix A Examples Do Sleep 200 wait load measurement to complete and returns 1 sInputString SENS CORR COLL ACQU STAT LOAD 1 Stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX CNT retCount Loop Until Val Buffer 1 measure forward isolation sInputString SENS CORR COLL ACQU ISOL 1 stat viWrite sesn sInputString Len sInputString retCount Do Sleep 200 wait forward isolation measurement to complete and returns 1 sInputString SENS CORR COLL ACQU STAT ISOL 1 stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX_CNT retCount Loop Until Val Buffer 1 measure thru MsgBox Connect thru between port 1 amp 2 sInputString SENS CORR COLL ACQU THRU 1 stat viWrite sesn sInputString Len sInputString retCount Do Sleep 200 wait thru measurement to complete and
20. 00403 Rev C 5 29 5 9 SENSe Subsystem Chapter 5 Cable amp Antenna Commands SENSe FREQuency STARt freq SENSe FREQuency STARt Title Description Parameter Default Value Default Unit Range Related Command Front Panel Access Start Frequency Sets the start frequency Note that in the spectrum analyzer changing the value of the start frequency will change the value of the coupled parameters Center Frequency and Span Note that in Cable amp Antenna mode changing the value of the start frequency may affect the DTF distance range freq 2 MHz Hz based on model refer to the instrument s User Guide SENSe FREQuency STOP Freq Dist Start Freq SENSe FREQuency STOP freq SENSe FREQuency STOP Title Description Parameter Default Value Default Unit Range Stop Frequency Sets the stop frequency Note that in the spectrum analyzer changing the value of the stop frequency will change the value of the coupled parameters Center Frequency and Span Note that in Cable amp Antenna mode changing the value of the start frequency may affect the DTF distance range Note that the set command is available only if the instrument is in Cable amp Antenna mode freq based on model refer to the instrument s User Guide Hz based on model refer to the instrument s User Guide PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp
21. 4 31 SENSel PIManalyzer SPECtrum CURRent FREGuency 4 31 I SENSel PIManalyzer SPECtrum MAK MEASure VALue 4 31 SENSel PIManalyzer SPECtrum MAK FREGuency 4 32 SENSe PlManalyzer SWEEp FREQuency F1 2 4 32 SENSe PIManalyzer SWEEp FREQuency F1 STARt SENSel PIManalyzer SWEEp FREGuency F1 STARt 4 32 SENSe PlManalyzer SWEEp FREQuency F1 STOP SENSe PlManalyzer SWEEp FREQuency F1 STOP 4 33 SENSe PIManalyzer SWEEp FREQuency F2 STARt I SENSel PIManalyzer SWEEp FREOGuency F2 STARt 4 33 SENSe PIManalyzer SWEEp FREQuency F2 STOP SENSe PlManalyzer SWEEp FREQuency F2 STOP 4 34 SENSe PIManalyzer SWEEp IMD ORDer I SENSel PIManalyzer SWEEp IMD ORDer 4 34 SENSe PIManalyzer TESt DURation I SENSel PIManalyzer TESt DURation 4 35 URA DATA Ra ki a en ce a es 4 36 Chapter 5 Cable amp Antenna Commands CALCulate LIMit ALARm OFF ON O 1 GAEGulate l IMIEALEARm ii een era en essen 5 1 MW82119B PM PN 10580 00403 Rev C C 3 Appendix C List of Commands by Mode CAL Gulate IMIEGLEEGSE 1 dorar a rt ost sot rs ee sag 5 1 CALCUulate LIMICPOINEADD i re dah oaa ea RR RR RR Ras 5 1 CALCulate LIMit POINt FREQuency freq CALC
22. 4 bytes are the imaginary component The returned value is in little endian format the little end comes first Negative numbers are represented in two s compliment format The data is scaled by a factor of 1e6 Converting INTeger 32 Example The instrument returns the following 8 1 RL data point in INT 32 format 4d 15 fc ff real ef a2 f8 ff imag M Convert from little endian to big endian ff fc 15 4d real ff f8 a2 ef imag 2 Since the MSb in both components is 1 they are negative numbers 3 The binary representation is 11111111111111000001010101001101 real 11111111111110001010001011101111 imag 4 Convert from two s complement not the bits and add 1 111110101010110011 real 1110101110100010001 imag Convert the binary values to decimal 256691 real 482577 imag Take out the 1e6 scale factor 0 256691 real 0 482577 imag Finally convert the values to dB 10 log 0 256691 2 0 482577 2 5 25 dB OU gt 1 MW82119B PM PN 10580 00403 Rev C 5 17 5 5 FORMat Subsystem Chapter 5 Cable amp Antenna Commands Converting REAL 32 Example The instrument returns the following values in REAL 32 format 00 31 2a 47 real 00 e8 6a c6 imag 1 Convert from little endian to big endian 47 2a 31 00 real c6 6a e8 00 imag 2 The binary representation of the real portion 47 2a 31 00 is 01000111 00101010 01110001 00000000 3 Binary is in IEEE format e 1st bit is s
23. Access Trace To Memory Copies the current measurement trace into memory Shift 5 Trace Copy Trace To Display Memory MW82119B PM PN 10580 00403 Rev C 5 1 CALCulate Subsystem Chapter 5 Cable amp Antenna Commands CALCulate MATH OVERlay ON OFF Title Description Front Panel Access Trace Overlay On Off Turns trace stored in memory on or off Shift 5 Trace Trace Overlay CALCulate SMOothing lt integer gt CALCulate SMOothing Title Description Parameter Parameter Type Default Value Default Unit Range Front Panel Access Smoothing Sets the smoothing percentage The query form of the command returns the current smoothing percentage lt integer gt lt integer gt 0 O to 10 Shift 3 Sweep Averaging Smoothing Smoothing Yo CALCulate TRANsform CLAVerage Title Cable Loss Average Description Reports the cable loss average Default Value 0 dB Default Unit dB CALCulate TRANsform DISTance CABLoss CALCulate TRANsform DISTance CABLoss Title Description Default Value Range Front Panel Access Cable Loss Sets the cable loss for DTF measurements 0 0 0 to 5 Measurements Cable Loss PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 1 CALCulate Subsystem CALCulate TRANsform DISTance DMAX Title Description Default Value Default Unit Range Distance Maximum Reports the
24. Commands Chapter 1 General Information 3 Select the Configuration I O settings tab and verify that the Termination Methods are set as shown in the example below 13 TCPIPO 172 26 202 100 9001 50OCKET Configuration Input Output ES Advanced loja suma NIVO Trace Help INSTRUMENTS TCP IP Settings I O Settings View Attributes Return Data Standard Settings Termination Methods SET Suppress End OnReadsto 4 VI FALSE No Error Timeout ms 2000 Send End On Writes Suppress End On Reads Enable Termination Character I O Protocol 9 Normal 488 2 Strings Refresh Apply Changes Figure 1 13 NI VISA Interactive Control LAN resource I O Termination Method Settings 4 Select the Input Output Basic I O tab and execute the default IDN Query If the PC is connected to the instrument then the command returns the following information from PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 4 Sending SCPI Commands the Buffer manufacturer name Anritsu model number options serial number and firmware package number as shown in the example below 3 TCPIPO 172 26 202 145 9001 SOCKET u lo xs A NATIONAL Configuration E Input Output Advanced Nil OTrace Help INSTRUMENTS Basic 1 0 Return Data Read Operation Select or E
25. Front Panel Access Recall Measurement The instrument must be in the mode of the saved trace in order to recall that trace Use INSTrument SELect or INSTrument NSELect to set the mode Recalls a previously stored measurement trace from the current storage location The saved measurement trace to be loaded is specified by file name gt file name gt should be enclosed in either single quotes or double quotes and should contain a file extension Note that the trace specified by file name should be available at the current mass storage location Use the command MMEMory MSIS to set the current mass storage location The integer parameter is not currently used but it must be sent Send a 1 File name extensions dat for C amp AA measurements vna for C amp AA measurements lt integer gt lt file name gt To recall trace with file name trace MMEMory LOAD TRACe 1 trace spa MMEMory STORe TRACe MMEMory STORe TRACe MMEMory MSIS INTernal USB Shift 7 File Recall Measurement MMEMory STORe STATe lt integer gt lt file name Title Description Parameter Related Command Front Panel Access Save Setup Stores the current setup into the file specified by file name gt file name gt should be enclosed in either single quotes or double quotes and should not contain a file extension Use the command MMEMory MSIS to set the current st
26. LIMit ALARm ON OFF O 1 CALCulate LIMit ALARm Title Description Parameter Parameter Type Default Value Example Front Panel Access Upper Limit Alarm On Off Sets and queries limit alarm for PIM vs Time and Swept PIM measurement types This alarm is associated only to the upper limit Lower limit does not have an associated alarm Limit Alarm ON OFF 0 1 0 On 1 Off boolean Off To set the limit alarm CALCulate LIMit ALARm 0 To query the limit alarm CALC LIM ALAR Shift Limit 6 Limit Alarm CALCulate LIMit AMPLitude CALCulate LIMit AMPLitude Title Description Parameter Resolution Default Value Example Front Panel Access Set Limit Amplitude Sets and queries limit amplitude for PIM vs Time and Swept PIM measurement types The amplitude will be associated with the currently selected limit upper lower The amplitude reference level range is 50 dBm to 140 dBm The upper and lower limits can be set far beyond the reference level range but such settings are of no practical value Magnitude dBm 0 1 dB None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the limit amplitude to 2120 dBm CALCulate LIMit AMPLitude 120 To query the limit amplitude CALC LIM AMPL Shift Limit 6 Limit Move Amplitude PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analy
27. Marker X Value Description Sets the location of the marker on the x axis at the specified location lt x parameter gt is defined in the current x axis units The query version of the command returns the location of the marker on the x axis Note that the marker is snapped to the data point closest to the specified value If the specified marker is not On then it is set to On In Swept PIM Marker 1 is always On but remains at trace peak and cannot be moved The query command reports the x axis position for Swept PIM Parameter lt x parameter gt Default Unit seconds in PIM versus Time measurement type meters or feet in DTP measurement type hertz in Swept PIM measurement type query only Example In PIM vs Time DTP or Swept PIM To query the X value of reference marker 3 CALC MARK3 X In PIM vs Time To set reference marker 3 to 1 5 seconds on the X axis CALCulate MARKer3 X 1 5 CALCulate MARKer3 X 1 5s In PIM vs Time To set reference marker 1 to 25 us CALCulate MARKer X 25 CALCulate MARKer1 X 25us In DTP To set reference marker 1 to 15 ft on the x axis CALCulate MARKer X 15 CALCulate MARKer1 X 15ft To query the location of the marker on the x axis CALC MARK X Front Panel Access Marker Marker 1 2 3 4 5 6 MW82119B PM PN 10580 00403 Rev C 4 15 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate MARKer 1 2 3 4 5 6 Y Title
28. a to to MW82119B 0194 1710 to 1755 1945 MHz 2155 MHz 2110 MHz 2130 MHz 1920 to 1980 IM7 UMTS 2100 MHz to to MW82119B 0210 2112 5 MHz 2170 MHz 2050 to 2090 IM3 2620 MHz 2650 MHz LTE 2600 MHz to to MW82119B 0260 2500 to 2570 2630 MHz 2690 MHz B 2 PN 10580 00403 Rev C MW82119B PM Appendix C List of Commands by Mode Appendix C List of Commands by Mode Chapter 1 General Information Chapter 2 Programming with SCPI Chapter 3 All Modes Programming Commands FECC Lucio ne 3 2 INSTrument CATalog FULL 0 2 IA Awa 3 3 INSTrument NSELect integer INSTrumentNSELect 0 00200 ann nenn 3 3 INSTrument SELect lt string gt INSTrumenti SELect j 3 4 MMEMory DATA file name 3 5 MMEMory MSIS INTernal USB MMEMOTny MSIS thu duret eet putt Dore a to D pate db aspe S pos 3 5 MMEMory MSIS COPY ooo 3 6 MMEMory MSIS DESTination INTernal USB MMEMory MSIS DESTIination 3 7 MMEMory STORe JPEG lt filename gt 3 7 SENSe GPS SENS GPS ni tes u ari BA OM eg Blk Ma VAS A M te e 3 8 SENSe GPS RESSE cuicos 2222 Ne EN Lee Eee ee ede d RO a 3 8 SENSE GPS GU RRENT coto aparta aa pace RR Rene Rule ate aer u Pane ea 3 9 SENSe GPS VOLTage 0 1 SENSe GPS VOLTage os Sea de ee aoe aia Ne
29. a valid IP address e Subnet Mask The subnet mask distinguishes the portion of the IP address that is the network ID from the portion that is the station ID The subnet mask 255 255 0 0 when applied to the IP address given above would identify the network ID as 128 111 and the station ID as 122 42 All stations in the same local area network should have the same network ID but different station IDs Default Gateway A TCP IP network can have a gateway to communicate beyond the LAN that 1s identified by the network ID A gateway is a computer or electronic device that is connected to two different networks and can move TCP IP data from one network to the other A single LAN that is not connected to other LANs requires a default gateway setting of 0 0 0 0 If you have a gateway then the default gateway would be set to the appropriate value of your gateway Ethernet Address An Ethernet address also known as a MAC address is a unique 48 bit value that identifies a network interface card to the rest of the network Every network card has a unique ethernet address permanently stored into its memory 1 4 PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 3 Remote Operation Setup and Interface Table 1 1 8 pin Ethernet RJ45 Connector Pinout Diagram 87654321 Pin Name Description Wire Color 1 TX Transmit data gt 3 volts White Orange 2 TX Transmit data 3 volts Orange
30. and 7 are the only acceptable values To set the measurement receiver center frequency to the 5th order IMD SENSe PIManalyzer SWEEp IMD ORDer 5 Freq Intermod Order PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 SENSe Subsystem SENSe PIManalyzer TESt DURation SENSe PIManalyzer TESt DURation Title Description Parameter Default Value Default Unit Range Example Front Panel Access PIM Test Measurement Test Duration Sets the amount of time in seconds the PIM Master will be on for intermodulation distortion measurements lt time gt 20 Seconds 1 0 to 1200 0 seconds To set the test duration time to 5 seconds SENSe PIManalyzer TESt DURation 5 0 Setup Test Duration MW82119B PM PN 10580 00403 Rev C 4 35 4 8 TRACe Subsystem Chapter 4 PIM Analyzer Programming Commands 4 8 TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument TRACe DATA X Title Description Parameter Parameter Type Example Front Panel Access Trace Data Transfer This command transfers trace data from the instrument to the controller Before executing this command the instrument must be set to the desired measurement For Distance to PIM measurements the parameter X 1s 1 2 or 3 1 Active Trace 2 DTP Overlay Trace 3 DTF Overlay Trace For Swept PIM
31. are used for data parameter descriptions in this manual Unit Suffikes 2 7 2 4 Notational Conventions 2 8 2 5 Notational Ekamples 2 9 Command Terminators 2 9 2 6 Formatting Conventions 2 10 2 7 ParameterNamsess 2 11 Chapter 3 All Modes Programming Commands 3 1 FETCh GPS Subsystem 3 2 Fetch GPS Fix Data UA AAA AAA 3 2 3 2 INSTrument Subsystem 3 3 3 3 MMEMory Subsystem EA eae 3 5 MW82119B PM PN 10580 00403 Rev C Contents 1 Table of Contents Continued 3 4 SENSe GPS Subsystem GPS On Off IA AA vei a tse mg YAA GPS Reset eco pei e Tee ege GPS Antenna Current se denetara t edre ee GPS AntennaVoltage 3 5 SYSTem Subsystem Chapter 4 PIM Analyzer Programming Commands 4 1 SCPI Commands Introduction 4 2 CALCulate Subsystem 4 3 CALibrationSubsystem 4 4 DISPlay Subsystem AAA AA AAA AAA 4 5 INITiate Subsystem IAA IA eae 4 6 MMEMory Subsystem 4 7
32. close the wizard Figure 1 3 USB Found New Hardware Wizard MW82119B PM PN 10580 00403 Rev C 1 3 1 3 Remote Operation Setup and Interface Chapter 1 General Information Ethernet Interface Connection and Setup The PIM Master MW82119B fully supports the IEEE 802 3 standard Most PIM Master functions except power On Off can be controlled via an Ethernet connection to a PC that is connected directly with an Ethernet cross over cable or through a network Ethernet networking uses a bus or star topology in which all of the interfacing devices are connected to a central cable called the bus or are connected to a hub Ethernet uses the CSMA CD access method to handle simultaneous transmissions over the bus CSMA CD stands for Carrier Sense Multiple Access Collision Detection This standard enables network devices to detect simultaneous data channel usage called a collision and provides for a contention protocol When a network device detects a collision the CSMA CD standard dictates that the data is retransmitted after waiting a random amount of time If a second collision is detected then the data are again retransmitted after waiting twice as long This is known as exponential back off The TCP IP setup requires the following P Address Every computer electronic device in a TCP IP network requires an IP address An IP address has four numbers each between 0 and 255 separated by periods For example 128 111 122 42 1s
33. of the command However SENS FREQuen STA is not an acceptable form of the command because FREQuen is not the entire short or long form of the command element Hierarchical Command Structure All SCPI commands except the common commands are organized in a hierarchical structure similar to the inverted tree file structure used in most computers The SCPI standard refers to this structure as the Command Tree The command keywords that correspond to the major instrument control functions are located at the top of the command tree The root command keywords for the SCPI command set are shown in Figure 2 1 root UNIT ABORt FETCh MEASure STATus CALCulate FORMat MMEMory SYSTem SENSe CALibration INITiate READ TRACe CONFigure INPut SENSe TRIGger DISPlay INSTrument Figure 2 1 SCPI Command Tree SOURce All instrument SCPI commands except the ABORt command have one or more subcommands keywords associated with them to further define the instrument function to be controlled The subcommand keywords may also have one or more associated subcommands keywords Each subcommand level adds another layer to the command tree The command keyword and its associated subcommand keywords form a portion of the command tree called a command subsystem The CONFigure command subsystem is shown in Figure 2 2 2 4 PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming wi
34. sInputString SYSTEM PRESET amp vbLf Stat viWrite sesn sInputString Len sInputString retCount Wait for previous operation to be completed sInputString OPC amp vbLf stat viWrite sesn sInputString Len sInputString retCount Buffer stat viRead sesn Buffer MAX CNT retCount Set start frequency sInputString SENSe FREQuency STARt 1 GHz amp vbLf MW82119B PM PN 10580 00403 Rev C A 13 A 4 End Visual Basic Appendix A Examples stat viWrite sesn sInputString Len sInputString read back the strat frequency sInputString SENSe FREQuency STARt amp vbLf stat viWrite sesn sInputString Len sInputString Buffer stat viRead sesn Buffer MAX CNT retCount Set stop frequency sInputString SENSe FREQuency STOP 7 GHz amp vbLf stat viWrite sesn sInputString Len sInputString read back the stop frequency sInputString SENSe FREQuency STOP amp vbLf stat viWrite sesn sInputString Len sInputString Buffer stat viRead sesn Buffer MAX_CNT retCount Rem Close down the system stat viClose sesn stat viClose dfltRM Sub retCount retCount retCount retCount A 14 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 5 LabVIEW A 5 LabVIEW This example shows how to read the trace data from the instrument in 32 bit integer format The output is an array of data poin
35. set Also note that the command will always succeed even if the external memory device is not present INTernal USB char MMEMory MSIS DESTination MW82119B PM PN 10580 00403 Rev C 3 5 MMEMory MSIS COPY Title Copy From Current Location To Destination Copies all measurements setups and JPEG files that are stored in the Description current storage location to the copy to destination location Related Command MMEMory MSIS MMEMory MSIS DESTination Front Panel Access Shift File 7 Copy MW82119B PM 3 6 PN 10580 00403 Rev C Chapter 3 All Modes Programming Commands 3 3 MMEMory Subsystem MMEMory MSIS MMEMory MSIS Title Description Parameter Related Command Front Panel Access DESTination INTernal USB DESTination Copy to Destination Sets the destination to which measurements and setups in the current storage location are copied Setting the location to INTernal copies the files that are stored at the current storage location into the internal memory when the command MEMMory MSIS COPY is sent Setting the location to USB copies the files that are stored at the current storage location into the USB Flash drive when the command MMEM MSIS COPY is sent Note that the storage location can be set independently and can be different for remote operation and front panel operation Changing the save location remotely does not change the location that is set and
36. the lower measurement box as PIM SENSe PIManalyzer MODe PIM PIMSwp DTP SPECTRUM VIEW SENSe PIManalyzer MODe Title Description Parameter Query Response Default Value Example PIM Analyzer Mode Set or Request Puts the system into PIM vs Time PIM Swept PIM PIMSwp Distance to PIM DTP or Spectrum View SPECTRUM VIEW measurement mode The query reports the current system mode Changing to Swept PIM mode can take as long as 20 seconds PIM PIMSwp DTP SPECTRUM VIEW PIM PIM vs Time PIMSwp Swept PIM DTP Distance to PIM SPECTRUM VIEW Spectrum View None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the PIM Analyzer mode to measure Distance to PIM SENSe PIManalyzer MODe DTP MW82119B PM PN 10580 00403 Rev C 4 29 4 7 Front Panel Access SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands To query the state of the PIM Analyzer system SENS PIM MOD Measurements PIM Distance to PIM Swept PIM Noise Floor Measurements Spectrum View SENSe PIManalyzer OUTPut POWer SENSe PIManalyzer OUTPut POWer Title Description Parameter Default Value Range Example Front Panel Access SENSe PIManalyzer RF OUTput PIM Analyzer Output Power Sets the deliverable output in dBm from the PIM Analyzer to the system under test dBm input wi
37. 1 this command will return X data points At 275 data points the values returned are paired and at 137 data points the values are in fours 1 FORMat READings DATA TRACe DATA PREamble PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 9 SENSe Subsystem 5 9 SENSe Subsystem The commands in this subsystem relate to device specific parameters not signal oriented parameters SENSe AVERage CLEar Title Description Related Command Front Panel Access Title Description Parameter Parameter Type Default Value Range Front Panel Access Restart Averaging Clears and restarts averaging of the measurement data Note that averaging state must be ON for averaging to restart SENSe AVERage STATe Shift 3 Sweep Averaging Smoothing Restart SENSe AVERage COUNt lt integer gt SENSe AVERage COUNt Number of Traces to Average Sets the number of traces to average lt integer gt lt integer gt 10 2 to 65535 Shift 3 Sweep Averaging Smoothing Averaging Factor SENSe AVERage STATe OFF ON 0 1 Title Description Parameter Parameter Type Default Value Front Panel Access SENSel AVERage STATe Averaging State Turns trace averaging ON or OFF Setting the value to ON or 1 will result in turning trace averaging ON OFF ON JO 1 lt boolean gt OFF Shift 3 Sweep Averaging Smoothing Averag
38. 1 for CAL ON OFF ON 0 1 lt boolean gt None To start full calibration CALibration PIManalyzer FULL ON To query the calibration state CAL PIM FULL Shift Cal 2 Start Calibration Shift Cal 2 Reset Calibration MW82119B PM PN 10580 00403 Rev C 4 17 4 4 DISPlay Subsystem Chapter 4 PIM Analyzer Programming Commands 4 4 The commands in this subsystem control parameters in the measurement display the sweep window DISPlay Subsystem DISPlay WINDow Trace Y SCALe PDIVision DISPlay WINDow Trace Y SCALe PDIVision Title PIM vs Time and Swept PIM Scale Not for DTP Description Sets and queries Scale Parameter Amplitude in dB div Default Value 10 dB div Range 1 dB div to 15 dB div Example To set PIM vs Time or Swept PIM scale to 5 dB div DISPlay WINDow TRACe Y SCALe PDIVision 5 Front Panel Access Amplitude Scale DISPlay WINDow Trace Y SCALe RLEVel DISPlay WINDow Trace Y SCALe RLEVel Title PIM vs Time and Swept PIM Reference Level Not for DTP Description Sets and queries Reference Level Parameter Amplitude in dBm Default Value 70 dBm Range 160 dBm to 50 dBm in 0 1 dB increments Example To set PIM vs Time or Swept PIM reference level to 60 dBm DISPlay WINDow TRACe Y SCALe RLEVel 60 Front Panel Access Amplitude Reference Level PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 5 INITi
39. 11 CONFigure MEASUrIG oc Pee dia den mete gx rbd EUER a otal Gee ea NE 5 12 CONFigure MEASure ACTiveChan 0 1 CONFigure MEASure ACTiveChan 5 12 CONFigure MEASure DUALdisplay DUAL SINGLE CONFigure MEASure DUALdisplay 5 12 CONFigure MEASure RLDTf ii AA IA WA 5 12 CONFigure MEASure RLFReqg 5 13 iCONFigure MEASure 1PHase anunanann 5 13 iCONFigure MEASure SMChart annananzaanananann 5 13 iCONFigure MEASure SWRDftf 5 13 DISPlay WINDow TRACe Y SCALe AUToscale 5 14 DISPlay WINDow TRACe Y SCALe BOTTom lt value gt 5 14 DISPlay WINDow TRACe Y SCALe TOP value 5 14 DISPlay WINDow TRACe Y SCALe SMCHart 0 10 20 30 3 DISPlay WINDow TRACe Y SCALej SMCHart 5 15 FORMat READings DATA ASCIi INTeger 32 REAL 32 FORMati READIngsi DATAJ 5 16 INITiate CONTinuous OFFJONIO 1 INiliate CONTInuous nananan 5 19 INITiate HOLD OFFIONJO 1 INETIate HOLD cai ER en Sexe Oe eec a E e E a 5 19 INETIate IMMediate 2 IA IIIA Pad ee tere dacht EST ERR 5 20 MMEMory DELete lt filename gt
40. 4 2 CALCulate Subsystem 4 2 Chapter 4 PIM Analyzer Programming Commands CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem CALCulate DTPMeas CABLoss CALCulate DTPMeas CABLoss Title Description Parameter Default Value Example Front Panel Access DTP cable loss Sets and queries DTP cable loss in dB current distance unit Cable loss in units of dB distance Parameter range is 0 dB ft to 5 dB ft 0 dB m to 16 404 dB m None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the cable loss to 0 1 dB ft CALCulate DTPMeas CABLoss 0 1 To query the cable loss CALC DTPM CABL Distance More Cable Loss CALCulate DTPMeas DISPlay RESOlution CALCulate DTPMeas DISPlay RESOlution Title Description Parameter Default Value Example Front Panel Access DTP data points Sets and queries DTP data points 128 255 None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the data point to 128 CALCulate DTPMeas DISPlay RESOlution 128 To query the data point setting CALC DTPM DISP RESO Distance DTP Aid Data Points PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCulate Subsystem CALCulate DTPMe
41. 4 8 CAL Culate LIMIGFAIL ooo a wee a en eee 4 9 CALCulate LIMit STATe OFFJON O 1 CALCulate LIMit STATe 00 a 4 9 CALCulate LIMit TYPe GALCulate LiMit TYPe deed an ea a es 4 10 CALCulate LIMit VAlLue 4 10 CALCulate MARKer AOFF nnn 4 10 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFFJON O 1 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe 4 11 CALCulate MARKer 1 2 3 4 5 6 DELTa TRACe 0 1 CALCulate MARKer 1 2 3 4 5 6 DELTa TRACe 0 ee 4 12 CALCulate MARKer 1 2 3 4 5 6 DELTa X lt x parameter gt CALCulate MARKer 1 2 3 4 5 6 DELTa X 0 ee 4 12 CALCulate MARKer 1 2 3 4 5 6 DELTa Y 2 2 eee 4 13 CAL Culate MARKer 1 2 3 4 5 6 STATe OFFJONJO 1 CALCulate MARKer 1 2 3 415 6 STATe 4 14 CALCulate MARKer 1 2 3 4 5 6 TRACe 0 1 CALCulate MARKer 1 2 3 4 516 TRACe 4 14 CALCulate MARKer 1 2 3 415 6 X lt x parameter gt CALCulate MARKer 1 2 3 4 5165 4 4 15 CALCulate MARKer 1 2 3 4 516 Y 4 16 CALCulate SCALe UNIT DBM DBC CALCulate SCALe UNIT AA IAA E A 4 16 CALibration PIManalyzer FULL CAlLibration PlManalyzer FULL 4 17 DISPlay WINDow Trace Y SCALe PDIVision DISPlay WIN
42. 5 REAL 32 values are 32 bit floating point numbers conforming to the IEEE 754 standard in little endian byte order This format returns the data in 4 byte binary format The units are the current instrument units Both INTeger 32 and REAL 32 formats return a definite block length Each transfer begins with an ASCII header such as 42204 The first digit represents the number of following digits in the header in this example 4 The remainder of the header indicates the number of bytes that follow the header in this example 2204 You then divide the number of following bytes by the number of bytes in the data format you ve chosen 4 for both INTeger 32 and REAL 32 to get the number of data points in this example 551 ASCii INTeger 32 REAL 32 lt char gt ASCii TRACe DATA PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 5 FORMat Subsystem Interpreting Returned Data Pair The following section provides two conversion examples on interpreting returned data pairs Examples are provided for both integer and real number formats Converting INTeger 32 and REAL 32 Values Fora 551 point trace the instrument returns 4415 bytes The first 7 bytes make up the header information in ASCI format The next 4408 bytes make up the actual data 8 bytes x 551 datapoints 4408 total bytes Each datapoint consists of 8 bytes The first 4 bytes are the real component The next
43. 580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI 2 1 Introduction This chapter provides an introduction to Standard Commands for Programming Instruments SCPD programming that includes descriptions of the command types hierarchical command structure command subsystems data parameters and notational conventions 2 2 Introduction to SCPI Programming Anritsu instruments can be operated with the use of SCPI commands SCPI is intended to give the user a consistent environment for program development It does so by defining controller messages instrument responses and message formats for all SCPI compatible instruments SCPI commands are messages to the instrument to perform specific tasks The command set includes e SCPI Common Commands on page 2 2 e SCPI Required Commands on page 2 2 e SCPI Optional Commands on page 2 2 The PIM Master follows the SCPI standard but is not fully compliant with that standard The main reason that the PIM Master is not fully compliant is because it does not support all of the required SCPI commands and because it uses some exceptions in the use of short form and long form command syntax Note MW82119B PM PN 10580 00403 Rev C 2 1 2 2 Introduction to SCPI Programming Chapter 2 Programming with SCPI SCPI Common Commands Some common commands are defined in the IEEE 488 2 standard and must be implemented by all SCPI compatible instruments These com
44. 9B PM Chapter 1 General Information 1 4 Sending SCPI Commands the Buffer manufacturer name Anritsu model number options serial number and firmware package number as shown in the example below T3 USB0 0x0B5B 0xFF60 32049925 76227 3 102 INSTR Configuration Input Output Advanced NIVO Trace Help Basic I O Line Control USB Control Return Data Read Operation Select or Enter Command Bytes to Read No Error IDN mv 1024 MW Write Query Read Read Status Byte Clear View mixed ASCII hexadecimal 1 Write Operation IDN Return Count 5 bytes 2 Read Operation Return Count 41 bytes Anritsu 5820E 440 714 32049925 D0 01 0164 Figure 1 9 NI VISA Interactive Control USB Basic I O Tab MW82119B PM PN 10580 00403 Rev C 1 9 1 4 Sending SCPI Commands Chapter 1 General Information Ethernet Connectivity 1 On the PC run NI Measurement amp Automation Explorer or VISA Interactive Control and create a new LAN Resource under Network Devices Add the TCP IP resource using a Manual Entry of Raw Socket as shown in the example below Create New E DG Choose the type of LAN resource you want to add Choose the type of TCP IP resource you wish to add Auto detect of LAN Instrument Use this option to select from a list of gt lt l 11 LAN LXI instruments detected on your local subnet Manual Entry o
45. Antenna Commands 5 9 SENSe Subsystem SENSe SWEep RESolution 137 275 551 1102 2204 SENSe SWEep RESolution Title Sweep Resolution Description This command sets the sweep resolution in other words the number of sweep data points Valid resolution settings are 137 275 551 1102 2204 Note Lower sweep resolutions yield faster sweep times Parameter 137 275 551 1102 2204 Parameter Type char Default Value 275 Front Panel Access Shift 3 Sweep Data Points SENSe SWEep RFIMmunity 0 1 SENSe SWEep RFIMmunity Title Description Parameter Parameter Type Default Value Front Panel Access RF Immunity Sets RF Immunity Set value to 1 for Low RF Immunity and 0 for High RF Immunity Note that a sweep with RF immunity enabled with be shghtly slower than a sweep with RF immunity disabled oll lt boolean gt High Shift 3 Sweep RF Immunity MW82119B PM PN 10580 00403 Rev C 5 31 5 9 SENSe Subsystem Chapter 5 Cable amp Antenna Commands 5 32 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 1 C C This example is run on the command line It sends the IDN query to the instrument and prints the response to the console MW82119B PM PN 10580 00403 Rev C A 1 A 1 C C Appendix A Examples 2 IT ER Es ER i i i i IdnExample cpp Microsoft Visual Studio Generated Example Based on Example 2 1 in the NI
46. Antenna Mode 3 of 4 Parameter Name RL_MAG_BOTTOM Description Return Loss Bottom Value SWR_MAG_TOP VSWR Top Value SWR_MAG_BOTTOM VSWR Bottom Value CL MAG TOP Cable Loss Top Value CL MAG BOTTOM Cable Loss Bottom Value S11 PHASE TOP 1 Port Phase Top Value S11 PHASE BOTTOM 1 Port Phase Bottom Value MKR REF FREQNx Reference marker x frequency where x is the marker number 0 5 MKR REF FLAGSx Reference marker x flags MKR FLAG ON OFF 0x00000001 MKR FLAG DELTA MKR 0x00000020 MKR FLAG DATA INVALID 0x00000040 MKR FLAG DATA STALE 0x00000080 MKR FLAG SELECTED 0x00000100 MKR FLAG DELT DISPL PER HZ 0x00000800 MKR FLAG TRACE A 0x00001000 MKR FLAG TRACE B 0x00002000 MKR FLAG TRACE MASK 0x00007000 MKR DLT FREQNx Delta marker x frequency where x is the marker number 0 5 MKR DLT FLAGSx Delta marker x flags LIM LFLAGS UP 1 Upper limit flags LIMIT FLAG UPPER 0x00000001 LIMIT FLAG ON 0x00000004 LIMIT FLAG ALARM ON 0x00000002 LIMIT FLAG SEGMENTED 0x00000020 LIMIT FLAG ALARM EVENT 0x00000040 LIMIT FLAG LEFT OF START FREQ 0x00000080 LIMIT FLAG RIGHT OF STOP FREQ 0x00000100 LIMIT FLAG MASK 0x000007FF LIM NUMPTS UP 1 Number of upper limit points LIM_CURFRQ_UP 1 Upper limit current frequency LIM CURMAG UP 1 Upper limit current magnitude MW82119B PM PN 10580 00403 Rev
47. CALC MARK6 DELT Y NA MW82119B PM PN 10580 00403 Rev C 4 13 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate MARKer 1 2 3 4 5 6 STATe OFF ON 0 1 CALCulate MARKer 1 2 3 4 5 6 STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access Marker State Sets the specified marker on or off OFF ON 0 1 lt boolean gt OFF To turn off reference marker 1 CALCulate MARKer1 STATe OFF To query the state of marker 6 CALC MARK6 STAT Marker Marker M On Off CALCulate MARKer 1 2 3 4 5 6 TRACe 0 1 CALCulate MARKer 1 2 3 4 5 6 TRACe Title Description Parameter Default Value Example Front Panel Access Marker Trace Sets the specified marker to a desired trace Valid only for Swept PIM mode 0 1 None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set marker 1 onto the fixed F2 sweep Sweep 2 CALCulate MARKer1 TRACe 1 To set marker 2 onto the fixed F1 sweep Sweep 1 CALC MARK2 TRAC 0 To query which trace marker 6 is on CALC MARK6 TRAC Marker Marker M Swap Marker Trace PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCulate Subsystem CALCulate MARKer 1 2 3 4 5 6 X lt x parameter gt CALCulate MARKer 1 2 3 4 5 6 x Title
48. D SUBTract CALCUulate MATH FUNCtion 22 22 2222 onen 5 7 CALCulate MATH MEMorize 5 7 CALCulate MATH OVERIay ONJOFF 5 8 CALCulate SMOothing integer iCALCulate SMOothing 5 8 CALCulate TRANsform CLAVerage 5 8 CALCulate TRANsform DISTance CABLoss CALCulate TRANsform DISTance CABLoss 5 8 CALCulate TRANsform DISTance DMAX 5 9 CALCulate TRANsform DISTance FRESolution 5 9 CALCulate TRANsform DISTance PVELocity CALCulate TRANsform DISTance PVELocity 5 9 CALCulate TRANsform DISTance START CAL Culate TRANsform DISTance START 5 9 CALCulate TRANsform DISTance STOP CALCulate I TRANsform DISTance STOP 5 10 CALCulate TRANsform DISTance UNIT METers FEET CALCulate TRANsform DISTance UNIT 5 10 CALCulate TRANsform DISTance WINDow RECTangular MSLobe NSLobe LSLobe C 4 PN 10580 00403 Rev C MW82119B PM Appendix C List of Commands by Mode CALCulate TRANsform DISTance WINDOow 5 10 GALibration STATE i A RON ee a ue te Mess e quake CERT ata 5
49. Description Default Unit Example Front Panel Access Marker Read Y Value Reads the current Y value for the specified marker The units are the units of the y axis Current y axis unit To query the Y value of reference marker 4 CALC MARK4 Y NA CALCulate SCALe UNIT DBM DBC CALCulate SCALe UNIT Title Description Parameter Default Value Example Front Panel Access Scale Unit Sets and queries the scale unit for PIM vs Time Distance to PIM and Swept PIM DBM DBC None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the unit to dBm CALCulate SCALe UNIT DBM CALC SCAL UNIT DBM To query the scale unit CALC SCAL UNIT Amplitude Units PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 3 CALibration Subsystem 4 3 CALibration Subsystem The commands in this subsystem control the system calibration CALibration PIManalyzer FULL CALibration PIManalyzer FULL Title Description Parameter Parameter Type Default Value Example Front Panel Access Full Calibration Sets or resets the calibration for the instrument This calibration is done for all 3 measurement types at their current configuration in other words output power frequency PVT only and IMD order for PVT and Swept PIM The query returns 0 for CAL OFF or
50. Dow Trace Y SCALe PDIVision 4 18 DISPlay WINDow Trace Y SCALe RLEVel DISPlay WINDow Trace Y SCALe RLEVel 4 18 INITiate PIManalyzer MEASure OFFI ONJO 1 4 19 INITiate PlManalyzer PVT ALLPower CAL 4 19 INITiate PIManalyzer RESidual CAL 4 19 MMEMory CABLelistRESet liliis 4 20 MMEMory LOAD TRACe lt integer gt lt filename gt 4 20 MMEMory STORe TRACe lt integer gt lt filename gt 4 21 MMEMory LOAD STATe lt integer gt lt file name 4 21 MMEMory STORe STATe lt integer gt lt filename gt 4 22 SENSe DTPMeas AVERage TYPE SENSej DTPMeas AVERage TYPE 4 23 SENSe DTPMeas DISPlay BOTTom SENSej DTPMeas DISPlay BOTTOMm 4 23 C 2 PN 10580 00403 Rev C MW82119B PM Appendix C List of Commands by Mode SENSe DTPMeas DISPlay TOP SENSe DTPMeas DISPlay TOP 4 24 SENSe DTPMeas ENREsolution ON OFF SENSel DTPMeas ENREsolution 4 24 SENSe PlManalyzer AVERaging FAST LOWNoise SENSej PiManalyzer AVERaging
51. EEp IMD ORDer SENSel PIManalyzer SWEEp IMD ORDer 4 34 SENSe PIManalyzer TESt DURation SENSel PIManalyzer TESt DURation 4 35 SENSe SWEep RESolution 137 275 551 1102 2204 SENSel SWEep RESolution 5 31 SENSe SWEep RFIMmunity 0 1 SENSel SWEep RFIMmunity 5 31 MW82119B PM PN 10580 00403 Rev C D 5 Appendix D List of Commands Alphabetical PN 10580 00403 Rev C MW82119B PM Anritsu Company XY 490 Jarvis Drive BO Anritsu utilizes recycled paper and environmentally conscious inks and toner Morgan Hill CA 95037 2809 U http www anritsu com
52. IM Masters with other instrument options LOW HIGH None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the measurement receiver to High Band SENSe PIManalyzer IMFReg BAND HIGH PIM vs Time and Swept PIM Freq High Low Band Select Distance to PIM Distance High Low Band Select PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 SENSe Subsystem SENSe PIManalyzer MEASure STATus Title Description Range PIM Analyzer Current Measurement Status The query returns the current measurement status of the measurement receiver PIM Analyzer measurement system Because the measurement system can run for the maximum time duration the query serves to indicate if the measurement is still in process This command works with any of the available measurement modes PIM vs Time DTP and Swept PIM 0 Measurement is OFF 1 Measurement is ON SENSe PIManalyzer MEASure VALue Title Description Parameter Default Unit Front Panel Access Measurement Receiver Measured Value From PIM Master Measurement Setup The query returns the last measured value in both dBc and dBm For example if the output power is set to 43 dBm and a PIM value of 80 dBm was read then this command would return 123 0 80 0 amplitudes dBc dBm N A Intermodulation distortion value is displayed in
53. LDT Title Configure DTF Return Loss Description Changes the Cable amp Antenna measurement to DTF Return Loss Front Panel Access Shift 4 Measure DTF Return Loss 5 12 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 3 CONFigure Subsystem CONFigure MEASure RLFReq Title Configure Return Loss Description Changes the current measurement to Return Loss Front Panel Access Shift 4 Measure Return Loss CONFigure MEASure 1PHase Title Configure 1 Port Phase Measurement Description Changes the current measurement to 1 Port Phase Front Panel Access Shift 4 Measure More 1 Port Phase CONFigure MEASure SMCHart Title Configure Smith Chart Description Changes the measurement to Smith Chart Front Panel Access Shift 4 Measure More Smith Chart CONFigure MEASure SWRDtf Title Configure DTF VSWR Description Changes the measurement to DTF VSWR Front Panel Access Shift 4 Measure DTF VSWR MW82119B PM PN 10580 00403 Rev C 5 13 5 4 DISPlay Subsystem Chapter 5 Cable amp Antenna Commands 5 4 DISPlay Subsystem This subsystem provides commands that modify the display of data for the user They do not modify the way in which data are returned to the controller DISPlay WINDow TRACe Y SCALe AUToscale Title Autoscale Description Autoscales the active channel display so that the trace is shown in the middle of the display Front Pa
54. LS Display Channels ACTIVE DISPLAY CHANNEL The current active display channel NUM OF CHANNELS Channel number SEND CAL PROMPTS Send Cal prompts SET SWEEP DATA TYPE Set sweep data type AVERAGING Averaging DISP CHANNELS Display channels ACTIVE DISP CHANNEL Active display channel DMAX Dmax FAULT RESOLUTION Fault Resolution SUGGESTED SPAN Suggested span START FREQ STATUS Start frequency status AVERAGING FACTOR Averaging Factor AVERAGE COUNT Averaging count SCALE RESOLUTION RL DIST S41 Log Magnitude Fault Location scale resolution SCALE RESOLUTION SWR 44 VSWR scale resolution SCALE RESOLUTION SWR DIST S44 VSWR Fault Location scale resolution SCALE RESOLUTION CL Cable loss Scale resolution SCALE RESOLUTION IL IL scale resolution SCALE RESOLUTION IG 24 Log Magnitude scale resolution SCALE RESOLUTION PHASE 11 44 Phase scale resolution REFERENCE VALUE PHASE S11 44 Phase reference value REFERENCE LINE PHASE S11 S44 Phase reference line RL DIST BOTTOM DTF Return Loss Bottom Value SWR DIST TOP DTF VSWR Top Value SWR DIST BOTTOM DTF VSWR Bottom Value RL MAG TOP Return Loss Top Value 2 12 PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI 2 7 Parameter Names Table 2 8 Available Parameters in Cable amp
55. Mit VALue 4 10 CALCulate LIMit STATe OFF ION O 1 CAL Cu late LIME ESTATAL e an 5 3 CALCulate LIMit STATe OFFIONJ0 1 CALCulate LIMit STATe 4 9 CALCulate MARKer AOFF 4 10 CALCulate MARKer AOFF 5 3 MW82119B PM PN 10580 00403 Rev C D 1 Appendix D List of Commands Alphabetical CAL Culate MARKer TABLe DATA 5 4 CALCulate MARKer TABLe STATe OFF ONJ0 1 CAL Culate MARKer TABLef STATejJ 5 4 CALCulate MARKer 1 2 3 4 5 6 DELTa TRACe 0 1 CAL Culate MARKer 1 2 3 4 5 6 DELTa TRACe 4 12 CALCulate MARKer 1 2 3 4 5 6 DELTa X lt x parameter gt CAL Culate MARKer 1 2 3 4 5 6 DELTa K 4 12 CALCulate MARKer 1 2 3 4 5 6 DELTa X lt x parameter gt CAL Culate MARKer 1 2 314 5 6 DELTa K 5 5 CAL Culate MARKer 1 2 3 4 5 6 DELTa Y 4 13 CAL Culate MARKer 1 2 314 5 6 DELTa Y 5 5 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFF ON 0 1 CAL Culate MARKer 1 2 314 5 6 DELTaf STATej 5 5 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFF ON J0 1 CALCulate MARKer 1 2 3 415 6 DELTa STATe
56. NSe GPS VOLTage boolean 0 1 bNR1 0 1 Shift 8 System GPS GPS Voltage Shift 8 System GPS GPS Info MW82119B PM PN 10580 00403 Rev C 3 9 3 5 SYSTem Subsystem Chapter 3 All Modes Programming Commands 3 5 SYSTem Subsystem This subsystem contains commands that affect instrument functionality that does not directly relate to data collection display or transfer SYSTem OPTions Title Query Installed Options Description Returns a string of the installed options Options are separated by a P The string will return NONE if no options are installed Related Command IDN Front Panel Access NA SYSTem PRESet Title Preset Description This command restores all application parameters to their factory preset values This does not modify system parameters such as language volume or brightness Front Panel Access Shift Preset 1 Preset 3 10 PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands The Anritsu PIM Master is capable of producing 80 Watts of RF power in the cellular communications bands Users must take precautions to minimize exposure to these RF fields Always terminate the PIM output port of the test equipment into a load a loaded line or a line that will radiate or absorb the energy before beginning a PIM test Confirm that the PIM Master RF power is off after a PIM test Always confirm that the PIM RF power is off bef
57. Nsform DISTance DMAK 5 9 CAL Culate TRANsform DISTance FRESolution 5 9 CALCulate TRANsform DISTance PVELocity CALCulate TRANsform DISTance PVELocity 5 9 CALCulate TRANsform DISTance START CALCulate TRANsform DISTance START 5 9 CALCulate TRANsform DISTance STOP CALCulate TRANsform DISTance STOP 5 10 CALCulate TRANsform DISTance UNIT METers FEET CALCulate TRANsform DISTance UNIT 5 10 D 2 PN 10580 00403 Rev C MW82119B PM Appendix D List of Commands Alphabetical CALCulate TRANsform DISTance WINDow RECTangular MSLobe NSLobe LSLobe CAL Culate TRANsform DISTance WINDow 5 10 CALibration PIManalyzer FULL CALibration PIManalyzer FULL 4 17 CALIDA STATE s ns as OVE Di a 5 11 CONFigure MEASure IPHase 5 13 CONFigure MEASure ACTiveChan 0J1 CONFigure MEASure ACTiveChan 5 12 CONFigure MEASure DUALdisplay DUAL SINGLE CONFigure MEASure DUALdisplay 5 12 CONFigure MEASure RLDTTf 5 12 CONFigure MEASure RLFReg 5 13 CONFigure MEASure SMChHart
58. ONTinuous The following information is provided for each subsystem command described in the following chapters The command name refer to Command Names on page 2 3 The path from the subsystem root command refer to Hierarchical Command Structure on page 2 4 The query form of the command if applicable refer to Query Commands on page 2 5 A description of the purpose of the command The data parameters that are used as arguments for the command refer to Data Parameters on page 2 6 This may include the parameter type and the available parameter choices Command Names Typical SCPI commands consist of one or more keywords parameters and punctuation SCPI command keywords can be a mixture of upper and lower case characters Except for common commands each keyword has a long and a short form In this manual the long form is presented with the short form in upper case and the remainder in lower case For example the long form of the command keyword to control the instrument display is DISPlay The short form keyword is usually the first four characters of the long form example DISP for DISPlay The exception to this is when the long form is longer than four characters and the fourth character is a vowel In such cases the vowel is dropped and the short form becomes the first three characters of the long form Example the short form of the keyword POWer 1s POW Some command keywords may have a n
59. PM PN 10580 00403 Rev C 4 9 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate LIMit TYPe CALCulate LIMit TYPe Title Description Parameter Default Value Example Front Panel Access Limit Type Selection Sets and queries limits for PIM vs Time and Swept PIM measurement types Selections are Upper Lower Limit value 0 Upper 1 Lower None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the upper limit CALCulate LIMit TYPe 0 To query the limit type CALC LIM TYP Shift Limit 6 Limit CALCulate LIMit VALue Title Description Parameter Resolution Default Value Example Related Command Front Panel Access Limit Value Magnitude Change Adds a magnitude change to the existing limit magnitude for PIM vs Time and Swept PIM measurement types Magnitude dB 0 1 dB None To decrease the currently selected limit magnitude by 5 dB CALCulate LIMit VALue 5 To query the limit amplitude CALC LIM AMPL Shift Limit 6 Limit Move Move Limit U D CALCulate MARKer AOFF Title Description Example Front Panel Access Turn All Markers Off Turns off all markers To turn Off all markers CALC MARK AOFF Marker All Markers Off PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCula
60. Programming Manual PIM Master Passive Intermodulation Analyzer with Site Master Cable amp Antenna Analyzer Option MW82119B Anritsu E aam 490 Jarvis Driv Revision aC Morgan n Hill CA 95037 2809 Published July 2015 Copyright 2012 2015 Anritsu Company http www anritsu com TRADEMARK ACKNOWLEDGMENTS PIM Master Distance to PIM and Site Master are registered trademarks of Anritsu Company Acrobat and Reader are registered trademarks of Adobe Corporation Windows is a registered trademark of Microsoft Corporation NOTICE Anritsu Company has prepared this manual for use by Anritsu Company personnel and customers as a guide for the proper installation operation and maintenance of Anritsu Company equipment and computer programs The drawings specifications and information contained herein are the property of Anritsu Company and any unauthorized use or disclosure of these drawings specifications and information is prohibited they shall not be reproduced copied or used in whole or in part as the basis for manufacture or sale of the equipment or software programs without the prior written consent of Anritsu Company UPDATES Updates if any can be downloaded from the Anritsu Website at http www anritsu com For the latest service and sales contact information in your area please visit http www anritsu com contact asp Safety Symbols To prevent the risk of personal injury or loss related to equ
61. SIGStandard NA Me lt string gt SENSe FREOuency SIGStandard NAMe 5 29 SENSe FREQuency STARt lt freg gt ESEN Set EB EQuencvis DAR de a ERES ARES quM NEEW I qq Ud 5 30 SENSe FREQuency STOP freq SENSePREOUSBCVIS TUB S Litres a as 5 30 SEINSe GPS CURR Git Ma ety en sere ne wari bu sepa A Ea E NA Na 3 9 ESENSEEGPSSRESE 12043 4 ee Een en na Pid 3 8 SENSe GPS VOL Tage 0 1 SEN Se GPS VOL Tage ia ead ad toe ad Sie ete her eee dn 3 9 SENSe GPS ESENSEEGPS rn ue qu ROTE S tee E ai ones CH Ro 3 8 SENSe PIManalyzer AUTorange OFF ON 0 1 D 4 PN 10580 00403 Rev C MW82119B PM Appendix D List of Commands Alphabetical KESENSEFPIManalyzer AU Torante 4 25 SENSe PIManalyzer AVERaging FAST LOWNoise SENSel PIManalyzer AVERaging 4 25 SENSe PIManalyzer DTPMeas LRDTf STARt 4 26 SENSel PIManalyzer DTPMeas LRDTf STOP 4 26 SENSe PIManalyzer DTPMeas LRDTf STATe SENSe PIManalyzer DTPMeas LRDTf STATe 4 26 SENSe PIManalyzer FREQuency F1 2 SENSe PIManalyzer FREQuency F1 2 4 27 SENSe PIManalyzer FREQuency STEP SENSel PIManalyzer FREOuency STEP 4 27 SENSe PIManalyzer IMD ORDer SENSel PIManalyzer IMD ORDer
62. SIZE Rem Include visa32 dll as a reference in your project Rem Begin by initializing the system stat viOpenDefaultRM dfltRM If stat VI SUCCESS Then Rem Error initializing VISA exiting MsgBox Can t initialize VISA Exit Sub End If Rem Open communication with Device Rem NOTE For simplicity we will not show error checking Rem TODO Add error handling stat viOpen dfltRM address VI NULL VI NULL sesn Rem Set the timeout for message based communication Rem TODO Add error handling stat viSetAttribute sesn VI ATTR TMO VALUE 120000 Rem Ask the device for identification Rem TODO Add error handling MW82119B PM PN 10580 00403 Rev C A 5 A 2 Visual Basic Appendix A Examples stat viWrite sesn IDN 5 retCount stat viRead sesn buffer BUFFER SIZE retCount Rem TODO Add code to process the data byteCount retCount returnBytes Left buffer retCount Rem Close down the system Rem TODO Add error handling Stat viClose sesn stat viClose dfltRM End Sub A 6 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 3 Visual Basic A 3 Visual Basic This function can be called in a Visual Basic program It performs an RF Calibration in Cable amp Antenna Analyzer mode Communication with the instrument uses USB protocol Public Sub OnePathTwoPortCalibrationInCAAMode Const MAX_CNT 200 Dim stat As Variant Dim dfltRM As Variant Dim s
63. Safety 2 PN 10580 00403 Rev C MW82119B PM Table of Contents Chapter 1 General Information 1 1 Aboutithis Manual sr He et ra Brad 1 1 1 27 Introd cti nz zen ern Kae lee eos 1 1 1 3 Remote Operation Setup and Interface 1 1 USB Interface Connection and Setup 1 1 Ethernet Interface Connection and Setup 1 4 GConnectlvity sts erteilen a au 1 5 PIM Master LAN Connections 1 5 1 4 Sending SCPI Commands 1 6 VISA Interactive Control 1 6 USB Connectivity llle 1 8 Ethernet Connectivity 2 2 desede een 1 10 Chapter 2 Programming with SCPI 2 1 Introduell n ze 2 23 lad u weed een aa aaa ala ne 2 1 2 2 Introduction to SCPI Programming 2 1 SCPI Common Commands 2 2 SCPI Required Commands 2 2 SCPI Optional Commands 2 2 2 3 SubsystemCommands 2 3 Command Names IA tonkia ae nn 2 3 Hierarchical Command Structure 2 4 Query Commands ooo 2 5 Identifiers 22 22 KI WA nern re 2 6 Data Parameters 22 xs eee ain a gue Pra este an Ta 2 6 Data Parameter Notations 2 7 The following syntax conventions
64. VISA User Manual Usage IdnExample USB0 0x0B58 0xFFF9 XXXXXXXX XXX XX INSTR where XXXXXXXX XXX XX is the USB Device ID of the instrument Output The string identity string returned from the instrument VISA Header visa h must be included VISA Library visa32 lib must be linked with nclude stdafx h nclude stdio h nclude string h nclude visa h define BUFFER SIZE 255 int main int argc char argv l ViStatus status For checking errors ViSession defaultRM instr Communication channels ViUInt32 retCount Return count from string I O ViChar buffer BUFFER SIZE Buffer for string 1 0 char tempDisplay BUFFER_SIZE Display buffer for example char pAddress Make sure we got our address if argc lt 2 printf Usage IdnExample USB0 0x0B58 0xFFF9 XXXXXXXX XXX XX INSTR printf Xt where xxxxxxxx xxx xx is the USB Device ID of your instrument Mn return 1 A 2 PN 10580 00403 Rev C MW82119B PM 1 C C Appendix A Examples A Store the address pAddress argv 1 Begin by initializing the system status viOpenDefaultRM amp defaultRM if status lt VI_SUCCESS Error Initializing VISA exiting printf Can t initialize VISA n return 1 USB0 0x0B58 0xFFF9 XXXXXXXX XXX XX INSTR NOTE For simplicity we will not show error checking TODO Add error han
65. ands Chapter 1 General Information USB Connectivity 1 On the PC run NI Measurement amp Automation Explorer or VISA Interactive Control and double click on the TMC Class instrument n File Edit View Tools Help 4 Y My System A Add Network Device 4 amp Devices and Interfaces amp amp 9 TMC Class USB0 0x0B5B 0xFF60 32049925 76227 3 102 INSTR Product b a Network Devices By TCPIPO 172 26 202 100 9001 SOCKET b Jy Serial amp Parallel El Software 9 Remote Systems Name Hostname TCPIP0 172 26 202 100 9001 SOCKET 172 26 202 100 Figure 1 7 Figure 1 4 NI Measurement amp Automation Explorer 2 Verify that the USB Settings list the correct Manufacturer Model and Serial Number as shown in the example below 13 USB0 0x0B5B 0xFF60 32049925_76227 3_102 INSTR 90 Configuration Input Output CE Advanced NI I O Trace Help USB Settings 1 0 Settings View Attributes Return Data USB Information No Error Manufacturer Anritsu 0x0B5B Model TMC Class OxFF60 SerialNumber 32049925 76227 3 102 Refresh JI Apply Changes Figure 1 8 NI VISA Interactive Control USB Configurations Settings Tab 3 Select the Input Output Basic I O tab and execute the default IDN Query If the PC is connected to the instrument then the command returns the following information from PN 10580 00403 Rev C MW8211
66. are Found if the combination of USB VID PID Serial Number has never been connected to this controller PC Found New Hardware Wizard Welcome to the Found New Hardware Wizard Windows will search for current and updated software by looking on your computer on the hardware installation CD or on the Windows Update Web site with your permission Read our privacy policy Can Windows connectto Windows Update to search for software ly O Yes now and every time connect a device ONO notthis time Click Next to continue Next gt Cancel Figure 1 1 USB Found New Hardware Wizard 1 2 PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 3 Remote Operation Setup and Interface 4 Select to allow the Wizard to search for and install the USB software automatically Found New Hardware Wizard This wizard helps you install software for USB Test and Measurement Device 9 If your hardware came with an installation CD or floppy disk insert it now What do you wantthe wizard to do O Install from a list or specific location Advanced Click Nextto continue Back Next Cancel Figure 1 2 USB Found New Hardware Wizard 5 After the software installs close the Wizard by clicking Finish Found New Hardware Wizard Completing the Found New Hardware Wizard The wizard has finished installing the software for e USB Test and Measurement Device Click Finish to
67. as DMAX Title Description Parameter Default Value Example Related Command Front Panel Access DTP maximum measurable distance Queries DTP maximum measurable distance in current distance unit None None To query the DTP maximum measurable distance CALC DTPM DMAX CALCulate DTPMeas STARt STOP CALC DTPM STAR STOP Distance DTP Aid Stop Distance Dmax CALCulate DTPMeas FRESolution Title Description Parameter Default Value Example Front Panel Access DTP fault resolution Queries DTP fault resolution in current distance unit None None To query the DTP fault resolution CALC DTPM FRES NA MW82119B PM PN 10580 00403 Rev C 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate DTPMeas PVELocity CALCulate DTPMeas PVELocity Title Description Parameter Default Value Example Front Panel Access DTP cable propagation velocity index Sets and queries DTP cable propagation velocity index 0 1 to 1 0 None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the cable propagation velocity index to 0 75 CALCulate DTPMeas PVELocity 0 75 To query the cable propagation velocity index CALC DTPM PVEL Distance DTP Aid Propagation Velocity CALCulate DTPMeas REFerence AMPLitude CALCulate DTPMeas REFerence AMPLitude
68. ass storage device lt file name gt should be enclosed in either single quotes or double quotes 7 It should contain one of the following file extensions stp for setup dat for C amp AA measurements pim for PIM measurement vna for C amp AA measurements Use the command MMEMory MSIS to set the current mass storage location lt file name gt MMEMory STORE STATe MMEMory STORe TRACe MMEMory MSIS INTernal USB Shift 7 File Delete Delete Selected File MMEMory LOAD STATe lt integer gt lt file name gt Title Description Parameter Related Command Front Panel Access Recall Setup Recalls a previously stored instrument setup in the current storage location The setup file to be loaded is specified by lt file name gt file name gt should be enclosed in either single quotes or double quotes and should contain a file extension stp Use the command MMEMory MSIS to set the current storage location The integer parameter is not currently used but it must be sent Send a 1 integer file name gt MMEMory STORe STATe MMEMory MSIS INTernal USB Shift 7 File Recall MW82119B PM PN 10580 00403 Rev C 5 21 5 7 MMEMory Subsystem Chapter 5 Cable amp Antenna Commands MMEMory LOAD TRACe lt integer gt lt file name gt Title Description Parameter Example Related Command
69. ate MARKer 1 2 3 4 5 6 STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access Marker State Sets the specified marker on off If no marker is specified in 11213141516 then marker defaults to 1 OFF ON 0 1 lt boolean gt OFF To turn off reference marker 1 CALCulate MARKer1 STATe OFF Marker On Off CALCulate MATH FUNCtion NORMal ADD SUBTract CALCulate MATH FUNCtion Title Description Parameter Parameter Type Default Value Range Related Command Front Panel Access Trace Math Function Sets math operations on the currently selected measurement and the trace stored in memory Note that there MUST be a trace stored in Memory Setting the FUNCtion to NORMal is equivalent of setting the Trace Math to No Trace Math on the front panel Setting the FUNCtion to ADD is equivalent of setting the Trace Math to Trace Plus Memory on the front panel Setting the FUNCtion to SUBTract is equivalent to setting the Trace Math to Trace Minus Memory on the front panel The query version of the command returns the string NORM for no trace math returns the string ADD for trace plus memory and returns the string SUBT for trace minus memory NORMal ADD SUBTract lt char gt NORMal NORMal ADD SUBTract CALCulate MATH MEMorize Shift 5 Trace CALCulate MATH MEMorize Title Description Front Panel
70. ate Subsystem 4 5 INITiate Subsystem The commands in this subsystem control the triggering of measurements INITiate PIManalyzer MEASure OFF ON 0 1 Title Trigger PIM Analyzer Measurement Description This command triggers the start of the PIM Master measurement to measure intermodulation distortion generated between the PIM Analyzer and the system under test It works with any of the available measurement types PIM vs Time DTP Swept PIM The measurement will continue until the defined test duration time has elapsed Sending this command with the OFF parameter or the 0 parameter cancels the measurement Parameter OFF ON 0 1 Parameter Type boolean Front Panel Access Measurements Test Measure underlined INITiate PIManalyzer PVT ALLPower CAL Title PvT All Power Levels Calibration Description This command triggers the start ofthe PIM vs Time calibration for all power levels Front Panel Access Shift Cal 2 Custom Calibrations Start Cal fullname Start Cal PIM vs Time Only All Power Levels INITiate PIManalyzer RESidual CAL Title PIM Calibration Current Mode Only Description This command triggers the start of the calibration for current measurement mode only Front Panel Access None MW82119B PM PN 10580 00403 Rev C 4 19 4 6 MMEMory Subsystem Chapter 4 PIM Analyzer Programming Commands 4 6 MMEMory Subsystem The commands in the Mass MEMory subsystem contain functions that
71. ce hold None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set DTP trace mode to normal SENSe DTPMeas AVERage TYPE NORMal Setup Normal gt A Max Hold gt A SENSe DTPMeas DISPlay BOTTom SENSe DTPMeas DISPlay BOTTom Title Description Parameter Range Default Value Example Related Command Front Panel Access DTP Display Bottom Sets and queries DTP display magnitude in the current units dBm by default Bottom magnitude Bottom 260 top 0 None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the DTP display bottom to 100 dBm SENSe DTPMeas DISPlay BOTTom 100 0 SENSe DTPMeas DISPlay TOP 15 0 SENS DTPM DISP TOP Amplitude Bottom MW82119B PM PN 10580 00403 Rev C 4 23 4 7 SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands SENSe DTPMeas DISPlay TOP SENSe DTPMeas DISPlay TOP Title Description Parameter Range Default Value Example Related Command Front Panel Access DTP Display Top Sets and queries DTP display magnitude in the current units dBm by default Top magnitude Top 0 bottom 260 None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the DTP di
72. command terminator resets the command path to the root of the tree MW82119B PM PN 10580 00403 Rev C 2 9 2 6 Formatting Conventions Chapter 2 Programming with SCPI 2 6 Formatting Conventions This manual uses the conventions listed below in describing SCPI commands The abbreviations Cmd and Param are used to represent Command and Parameter Table 2 7 Formatting Conventions COMMands LOOK LIKE THIS Commands are formatted to differentiate them from their description COMMand QUERies LOOK LIKE THIS The query form of the command is followed by a nr lt identifier gt Identifiers are enclosed in lt gt They indicate that some type of data must be provided The indicates that a choice must be made optional input Optional input is enclosed in The are not part of the command 2 10 PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI 2 7 Parameter Names 2 7 Parameter Names The following tables list the parameter options for the TRACe PREamble command in each supported measurement mode Cable amp Antenna Parameter Names Table 2 8 Available Parameters in Cable amp Antenna Mode 1 of 4 Parameter Name Description SN Instrument serial UNIT_NAME Instrument name TYPE The data type Setup or Data
73. d Identifiers Identifier Description lt amplitude gt Amplitude value Units specified with the command freq Frequency Units specified with the command integer Integer value no units Range specified with the command number Numeric value integer or real percentage Percentage value from 0 to 00 Units are always Yo rel ampl Relative amplitude Units are always dB lt x parameter gt Parameter value in the units of the x axis Units are specified with the command lt string gt The string should be enclosed in either single quotes or double quotes de lt file name gt The name should be enclosed in either single quotes or double quotes The need for an extension is documented with applicable commands lt voltage gt Voltage Units specified with the command lt current gt Current Units specified with the command Data Parameters Data parameters referred to simply as parameters are the quantitative values that are used as arguments for the command keywords The parameter type that is associated with a particular SCPI command is determined by the type of information required to control the particular instrument function For example Boolean ON OFF type parameters are used with commands that control switch functions Some command descriptions specify the type of data parameter to be used with each command The most commonly
74. displayed on the front panel Similarly changing the save location via the front panel does not affect the location that is used by the remote operation commands Also note that the command will always succeed even if the external memory device is not present INTernal USB MMEMory MSIS MMEMory MSIS COPY Shift File 7 Save or Save Measurement Change Save Location MMEMory STORe JPEG lt file name gt Title Description Parameter Example Related Command Front Panel Access Save Screen as JPEG Saves the current screen measurement as aJPEG file This will save the screen as a JPEG file specified by lt file name gt with the extension jpg tothe current storage location lt file name gt should be enclosed in either single quotes or double quotes and should not contain a file extension Use the command MMEMory MSIS to set the current storage location lt file name gt To save the screen into the file name trace MMEMory STORe JPEG trace MMEMory DATA MMEMory MSIS INTernal USB Shift File 7 Save MW82119B PM PN 10580 00403 Rev C 3 7 3 4 SENSe GPS Subsystem Chapter 3 All Modes Programming Commands 3 4 SENSe GPS Subsystem This subsystem contains commands that relate to the optional GPS Global Positioning System on the instrument GPS On Off SENSe GPS SENSe GPS Description Enables disables optional GPS capability The query vers
75. dling status viOpen defaultRM pAddress VI NULL VI NULL amp instr Set the timeout for message based communication TODO Add error handling status viSetAttribute instr VI ATTR TMO VALUE 120000 Ask the device for identification sprintf buffer IDN WMn status viWrite instr unsigned char amp buffer 0 6 amp retCount status viRead instr unsigned char buffer BUFFER_SIZE amp retCount TODO Add code to process data strncpy tempDisplay buffer retCount tempDisplay retCount 0 Null terminate display string printf IDN Returned d bytes s n retCount tempDisplay Close down the system MW82119B PM PN 10580 00403 Rev C A 3 A 1 C C Appendix A Examples TODO Add error handling status viClose instr status viClose defaultRM return 0 A 4 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 2 Visual Basic A 2 Visual Basic This function can be called in a Visual Basic program It sends the IDN query to the instrument and returns the byte count and ASCII response string Rem This example is based on Example 2 1 from the NI VISA User Manual Public Sub IdnMain ByVal address As String ByRef byteCount As String ByRef returnBytes As String Const BUFFER_SIZE 200 Dim stat As ViStatus Dim dfltRM As ViSession Dim sesn As ViSession Dim retCount As Long Dim buffer As String BUFFER_
76. e 0 CALCulate DTPMeas REFerence 0 To query the reference line state CALC DTPM REF CALC DTPM REF STAT Shift Limit 6 On Off CALCulate DTPMeas STARt CALCulate DTPMeas STARt Title Description Parameter Default Value Example DTP Distance Start Setup Sets and queries DTP distance start Parameters are m for meters and t for feet m ft Values in meters To set the DTP start distance to 10 feet CALCulate DTPMeas STARt 10 ft MW82119B PM PN 10580 00403 Rev C 4 5 Related Command Front Panel Access To query the DTP start distance CALC DTPM STAR CALCulate DTPMeas STOP 100 ft CALC DTPM STOP CALCulate DTPMeas DMAX CALC DTPM DMAX Distance DTP Aid Start Distance CALCulate DTPMeas STOP CALCulate DTPMeas STOP Title Description Parameter Default Value Example Related Command Front Panel Access DTP Distance Stop Setup Sets and queries DTP distance stop Parameters are m for meters and ft for feet m ft Values in meters To set the DTP stop distance to 100 feet CALCulate DTPMeas STARt 100 ft To query the DTP stop distance CALC DTPM STOP CALCulate DTPMeas STARt 10 ft CALC DTPM STAR CALCulate DTPMeas DMAX CALC DTPM DMAX Distance DTP Aid Stop Distance 4 6 PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCulat
77. e Subsystem CALCulate DTPMeas UNIT METers FEET CALCulate DTPMeas UNIT Title Description Parameter Default Value Example Front Panel Access DTP distance unit Sets and queries DTP distance unit Parameters are m for meters and ft for feet METers FEET None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the unit to meter CALCulate DTPMeas UNIT METers CALC DTPM UNIT MET To query the distance unit CALC DTPM UNIT Distance Units CALCulate DTPMeas WINDow CALCulate DTPMeas WINDow Title Description Parameter Default Value Example Front Panel Access DTP Windowing Sets and queries the type of windowing in order of increasing side lobe reduction Windowing settings are rectangular nominal side lobe low side lobe and minimum side lobe RECTangular Rectangular Windowing NSLobe Nominal Side Lobe Windowing LSLobe Low Side Lobe Windowing MSLobe Minimum Side Lobe Windowing None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set the Nominal Side Lobe Windowing CALCulate DTPMeas WINDow NSLobe To query the type of Windowing CALC DTPM WIND Distance More Window MW82119B PM PN 10580 00403 Rev C 4 7 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate
78. e header Parameters are returned in comma delimited ASCII format Each parameter is returned as NAME VALUE UNITS Parameter Name Description MKR REFx Reference marker state MKR DLTx Delta marker state MKR REF FREQNx Reference marker x frequency MKR DLT FREQNx Delta marker x frequency MKR REF AMPLy Reference marker y axis MKR DLT AMPL Delta marker y magnitude x marker 1 to 6 Front Panel Access Marker Marker Table On CALCulate MARKer TABLe STATe OFF ON 0 1 CALCulate MARKer TABLe STATe Title Marker Table State Description Turns the Marker Table on or off Setting the value to ON or 1 will turn on the marker table Setting the value to OFF or 0 will turn off the marker table Parameter OFF ON O 1 Parameter Type lt boolean gt Default Value OFF Example To turn on marker table CALCulate MARKer TABLe ON CALCulate MARKer TABLe 1 Front Panel Access Marker Marker Table 5 4 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 1 CALCulate Subsystem CALCulate MARKer 1 2 3 4 5 6 DELTa X lt x parameter gt CALCulate MARKer 1 2 3 4 5 6 DELTa X Title Description Parameter Default Unit Example Related Command Front Panel Access Delta Marker X Value Sets the location of the delta marker on the x axis at the specified location lt x parameter gt the reference marker x axis lt x parameter gt is defined in the current x axis un
79. e in the trace Front Panel Access Marker Marker 1 2 3 4 5 6 Marker to Peak CALCulate MARKer 1 2 3 4 5 6 VALLey Title Marker Valley Search Description Puts the specified marker at the minimum value in the trace Front Panel Access Marker Marker 1 2 3 4 5 6 Marker to Valley CALCulate MARKer 1 2 3 4 5 6 X lt x parameter gt CALCulate MARKer 1 2 3 4 5 6 x Title Marker X Value Description Sets the location of the marker on the x axis at the specified location lt x parameter gt is defined in the current x axis units The query version of the command returns the location of the marker on the x axis Note that the marker is snapped to the data point closest to the specified value If the specified marker is not on it is set to on Parameter lt x parameter gt Default Unit Current x axis unit Example To set reference marker 2 to 1GHz on the x axis CALCulate MARKer2 X 1GHz To set reference marker 1 to 1 5 GHz on the x axis CALCulate MARKer X 1 5GHz CALCulate MARKer1 X 1 5GHz Front Panel Access Marker Marker 1 2 3 4 5 6 CALCulate MARKer 1 2 3 4 5 6 Y Title Marker Read Y Value Description Reads the current Y value for the specified marker The units are the units of the y axis Default Unit Current y axis unit 5 6 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 1 CALCulate Subsystem CALCulate MARKer 1 2 3 4 5 6 STATe OFF ON 0 1 CALCul
80. e ne ede ead 3 9 SYS Tem OP TIONS ee ox ee meet N epe ede 3 10 Sem PRESO dina ar gr ree m YA M e od ee RR Re a a KATA 3 10 Chapter 4 PIM Analyzer Programming Commands CALCulate DTPMeas CABLoss CALCulate DTPMeas CABLOSS SI a a ha anne an 4 2 CALCulate DTPMeas DISPlay RESOlution CALCulate DTPMeas DISPlay RESOlution 4 2 CALCulate DTPMeas DMAX 4 3 CALCulate DTPMeas FRESolution 4 3 CALCulate DTPMeas PVELocity CALCulate DTPMeas PVELocity 2 llle een 4 4 CALCulate DTPMeas REFerence AMPLitude CALCulate DTPMeas REFerence AMPLitude 4 4 CALCulate DTPMeas REFerence STATe OFF ON 0 1 CALCulate DTPMeas REFerence STATej 4 5 CALCulate DTPMeas STARt GALGulate DTPMeas STARt is coreanas dal dod add d PR aan 4 5 CALCulate DTPMeas STOP MW82119B PM PN 10580 00403 Rev C C 1 Appendix C List of Commands by Mode CALCulate DTPMeas STOP iah aa aa kaaa WI eee eee 4 6 CALCulate DTPMeas UNIT METers FEET CALCulate DTPMeas UNIT ui anara a e m s 4 7 CALCulate DTPMeas WINDow CALCulate DTPMeas WINDOW sssssseleeee RR RR m 4 7 CALCulate LIMit ALARm ON OFF 0 1 CALCulate LIMIttALARM 4 8 CALCulate LIMit AMPLitude CALCulate LIMit AMPLitude 2 0 eee
81. e prohibited operation is indicated symbolically in or near the barred circle This indicates a compulsory safety precaution The required operation is indicated symbolically in or near the circle This indicates a warning or caution The contents are indicated symbolically in or near the triangle This indicates a note The contents are described in the box I gt O vya HA These indicate that the marked part should be recycled MW82119B PM PN 10580 00403 Rev C Safety 1 For Safety gt Li Warning Always refer to the operation manual when working near locations at which the alert mark shown on the left is attached If the operation etc is performed without heeding the advice in the operation manual there is a risk of personal injury In addition the equipment performance may be reduced Moreover this alert mark is sometimes used with other marks and descriptions indicating other dangers Warning When supplying power to this equipment connect the accessory 3 pin power cord to a 3 pin grounded power outlet If power is supplied without grounding the equipment there is a risk of receiving a severe or fatal electric shock Warning WARNING This equipment can not be repaired by the operator Do not attempt to remove the equipment covers or to disassemble internal components Only qualified service technicians with a knowledge of electrical fire and shock hazards should service this equ
82. ea en 5 24 TRACER DATAT TUT ee es east 5 24 TRACEEDATA IA ao es Decr er aa 4 36 SENSe AVERage CLEar ao a a a BRA uas CUI IR 5 25 SENSe AVERage COUNt lt integer gt SENSe AVERage COUNt 4 odi Ua A A ds 5 25 SENSe AVERage STATe OFF ON 0 1 SENSel AVERagefl STATej 5 25 SENSe CORRection COLLect ABORT 5 26 SENSe CORRection COLLect INITialize 5 26 I SENSel CORRection COLLect LOAD 5 26 SENSe CORRection COLLect OPEN 5 27 I SENSel CORRection COLLect SHORt 5 27 SENSe CORRection COLLect STATus INITialize OPEN SHORt LOAD 5 28 SENSe CORRection TYPe STANDARD FLEX I SENSel CORRection TYPe 5 28 SENSe DTPMeas AVERage TYPE SENSe DTPMeas AVERage TYPE s uses eR eh Ra HE SER 4 23 SENSe DTPMeas DISPlay BOTTom SENSe DTPMeas DISPlay BOTTom 4 23 SENSe DTPMeas DISPlay TOP SENSe DTPMeas DISPlay TOP 4 24 SENSe DTPMeas ENREsolution ON OFF SENSe DTPMeas ENREsolution 4 24 SENSe FREQuency CABle index 5 28 SENSe FREQuency LINK UPLINK DOWNLINK UPANDDWNLINK SENSe FREQuen cy LINK 77 442222 a 5 29 SENSe FREQuency
83. eep Run Hold MW82119B PM PN 10580 00403 Rev C 5 19 5 6 INITiate Subsystem Chapter 5 Cable amp Antenna Commands INITiate IMMediate Title Description Related Command Front Panel Access Trigger Sweep Measurement Initiates a sweep measurement If INITiate CONTinuous is set to ON this command 1s ignored Use this command in combination with STATus OPERation to synchronize the capture of one complete set of data When this command is sent the sweep complete bit of STATus OPERation is set to 0 indicating that the measurement has not completed The data collection is then triggered The controlling program can poll STATus OPERation to determine the status When the sweep complete bit is set to 1 data is ready to be retrieved INITiate CONTinuous STATus OPERation Shift 3 Sweep Run Hold Run Note When the unit is in Hold Mode sending this command will initiate a sweep from the point at which is left off PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 7 MMEMory Subsystem 5 7 MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument s setup and data storage MMEMory DELete lt file name gt Title Description Parameter Related Command Front Panel Access Delete Setup Measurement Removes the measurement or setup file specified by lt file name gt from the current m
84. el Access Transfer Data Transfers the data stored in the given file from the instrument to the controlling program This is a query only Data is transferred in the form of lt header gt lt block gt The ASCII lt header gt specifies the number of data byes It looks like AX where A is the number of digits in X and X is the number of bytes in block file name should be enclosed in either single quotes or double quotes and should contain a file extension for example stp jpg and the file must not be larger than 262136 bytes Use the command MMEMory MSIS to set the current storage location lt file name gt NA MMEMory MSIS INTernal USB MMEMory MSIS Title Description Parameter Parameter Type Related Command Storage Location Sets the storage location Setting the storage location to INTernal will set the current storage location to be the internal memory Setting the storage location to USB will set the current storage location to be the USB Flash drive Note that the storage location can be set independently and can be different for remote operation and front panel operation Changing the copy location remotely does not change the location that is set and displayed on the front panel Similarly changing the copy location via the front panel does not affect the location that is used by the remote operation commands Note that the storage location must be available in order for it to be
85. er 2 onto the fixed F1 sweep Sweep 1 CALC MARK2 DELT TRAC 0 To query which trace delta marker 6 is on CALC MARK6 DELT TRAC Marker Marker M Delta Swap Marker Trace CALCulate MARKer 1 2 3 4 5 6 DELTa X lt x parameter gt CALCulate MARKer 1 2 3 4 5 6 DELTa X Title Description Parameter Default Unit Example Related Command Front Panel Access Delta Marker X Value Sets the location of the delta marker on the x axis at the specified location lt x parameter gt thereference marker x axis lt x parameter gt is defined in the current x axis units The query version of the command returns the location of the delta marker on the x axis lt x parameter gt Current x axis unit If both the reference and delta marker 1 are currently at 1 GHz on the x axis then send the command below to set the delta marker 1 to 2 GHz on the x axis CALCulate MARKer1 DELTa X 1GHz CALCulate MARKer 1 2 3 4 5 6 X Marker Marker 1 2 3 4 5 6 Delta On Arrow buttons PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 2 CALCulate Subsystem CALCulate MARKer 1 2 3 4 5 6 DELTa Y Title Description Default Unit Example Front Panel Access Delta Marker Read Y Value Reads the current Y value for the specified delta marker The units are the units of the y axis Current y axis unit To query the Y value of delta marker 6
86. esn As Variant Dim retCount As Long Dim Buffer As String MAX CNT Dim Response As String VI FIND BUFLEN Dim sInputString As String Rem Begin by initializing the system Stat viOpenDefaultRM dfltRM If stat VI SUCCESS Then Rem Error initializing VISA exiting Exit Sub End If Rem Open communication with USB Protocol Rem NOTE For simplicity we will not show error checking Rem 0x0B5B 0xFF60 32850021 76227 3 102 Vendor id Product id dut usb id Stat viOpen dfltRM USBO 0x0B5B 0xFF60 32850021 76227 3 102 INSTR VI NULL VI NULL sesn Rem Set some visa attributes stat viSetAttribute sesn VI ATTR TMO VALUE 90000 stat viSetAttribute sesn VI ATTR SEND END EN VI TRUE stat viSetAttribute sesn VI ATTR SUPPRESS END EN VI FALSE Stat viClear sesn Switch to Cable Antenna Analyzer Mode MW82119B PM PN 10580 00403 Rev C A 7 A 3 Visual Basic Appendix A Examples sInputString INST NSEL 2 stat viWrite sesn sInputString Len sInputString retCount Do Sleep 200 sInputString INST NSEL stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX_CNT retCount Loop Until Val Buffer 2 System preset sInputString SYSTEM PRESET stat viWrite sesn sInputString Len sInputString retCount Wait for previous operation to be completed sInputString OPC stat viWrite sesn sInputString Len sInputStrin
87. ess SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands To get the Swept PIM F2 start frequency PIM SWEE FREQ F2 STAR Freq Swept PIM Aid F2 Start SENSe PIManalyzer SWEEp FREQuency F2 STOP SENSe PIManalyzer SWEEp FREQuency F2 STOP Title Description Parameter Default Unit Range Example Front Panel Access PIM Master Swept PIM F2 Stop Frequency Setup Sets the Swept PIM F2 stop frequency for the Fixed F1 sweep then calculates the IMx sweep frequencies and sets the instrument to display the corresponding IMx sweep frequencies Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To set the F2 stop frequency to 768 MHz SENSe PIManalyzer SWEEp FREQuency F2 STOP 768000000 To get the Swept PIM F2 stop frequency PIM SWEE FREQ F2 STOP Freq Swept PIM Aid F2 Stop SENSe PIManalyzer SWEEp IMD ORDer SENSe PIManalyzer SWEEp IMD ORDer Title Description Default Value Range Example Front Panel Access PIM Analyzer Swept PIM Intermodulation Distortion IMD Order Setup Sets the measurement receiver center frequency to receive one of the following IMDs from the PIM Analyzer measurement system 3 5 7 The query command returns the possible strings 3rd Sth and 7th depending on the current selection of IMD Order 3 3 5
88. f LAN Instrument Use this option if your lt I 117 L amp N LXI instrument is on another network Manual Entry of Raw Socket Use this option to communicate with an Ethemet device over a specific port number Figure 1 10 NI VISA Interactive Control LAN resource addition using Raw Socket 1 10 PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 4 Sending SCPI Commands 2 Enter the IP address that the instrument has acquired go to System 9 Status Enter the port number as 9001 as shown in the example below e Create New 9 NATIONAL Enter the LAN resource details INSTRUMENTS Enter the TCP IP address of your VISA network resource in the form of xxx xs xxx x9 the hostname of the device or a computer some domain Hostname or IP address 172 26 202 100 Port Number File Edit View Tools Help 4 C My System X Add Network Device v 4 WB Devices and Interfaces a amp TMC Class USBO 0x0B5B 0 Product Name Hostname IP Address Serial Number 4 4 Network Devices SA TCPIPO 172 26 202 100 9001 SOCKET TCPIPO 172 26 202 100 9001 SOCKET 172 26 202 100 172 26 202 100 AA TCPIPO 172 26 202 100 gt YY Serial amp Parallel gt El Software b amp Remote Systems Figure 1 12 NI VISA Interactive Control LAN resource validated MW82119B PM PN 10580 00403 Rev C 1 4 Sending SCPI
89. g retCount Buffer stat viRead sesn Buffer MAX CNT retCount Set start frequency sInputString SENSe FREQuency STARt 2 MHz Stat viWrite sesn sInputString Len sInputString retCount Set stop frequency sInputString SENSe FREQuency STOP 7 GHz stat viWrite sesn sInputString Len sInputString retCount Set IFBW in Hz sInputString SWEep IFBW 1000 Stat viWrite sesn sInputString Len sInputString retCount Initiate One path Two port Calibration sInputString SENSe CORRection COLLect TYPE 2PFP stat viWrite sesn sInputString Len sInputString retCount Wait for previous operation to be completed A 8 PN 10580 00403 Rev C MW82119B PM Appendix A Examples sInputString OPC stat viWrite sesn sInputString Len sInputString Buffer stat viRead sesn Buffer MAX CNT retCount measure open MsgBox Connect open at port 1 sInputString SENS CORR COLL ACQU OPEN 1 stat viWrite sesn sInputString Len sInputString Do Sleep 200 wait open measurement to complete and returns 1 sInputString SENS CORR COLL ACQU STAT OPEN A 3 Visual Basic retCount retCount 1 stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX CNT retCount Loop Until Val Buffer 1 measure short MsgBox Connect short at port 1 sInputString SENS CORR COLL ACQU SHORT 1 stat viWrite sesn
90. ign bit next 8 bits are exponent next 23 bits are normalized value 4 Convert binary to decimal 0 the MSb is the sign bit 10001110 exponent The actual exponent value is this value minus 127 So it is 142 127 15 0101010 01110001 00000000 as normalized value and adding 1 and multiplying by 2 exponent results in 1 0 2 1 4 0 8 1 16 0 32 1 64 2415 43520 approx 5 Repeat Step 2 through Step 4 for the imaginary portion c6 6a e8 00 in binary is 11000110 01101010 11101000 00000000 The MSb is the sign bit The next 8 bits are the exponent which is 10001100 The actual value is 140 127 13 Converting the remaining bits and multiplying by exponent and accounting for sign results in 1 1 2 1 4 0 8 1 16 0 32 1 64 2213 14976 approx 6 Take out the 1e6 scale factor from both parts 043520 real 014976 imag 7 Finally convert the values to dB 10 log 043520 42 014976 2 26 7401848 dB 5 18 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 6 INITiate Subsystem 5 6 INITiate Subsystem This subsystem controls the triggering of measurements INITiate CONTinuous OFF ON 0 1 INITiate CONTinuous Title Description Parameter Parameter Type Default Value Related Command Front Panel Access Continuous Single Sweep Specifies whether the sweep measurement is triggered continuously If the value is set to ON or 1 then anothe
91. ing MW82119B PM PN 10580 00403 Rev C 5 25 5 9 SENSe Subsystem Chapter 5 Cable amp Antenna Commands SENSe CORRection COLLect ABORt Title Calibration Abort Description Aborts the calibration measurement and restarts the current sweep and or measurement Related Command SENSe CORRection COLLect INITialize SENSe CORRection COLLect OPEN SENSe CORRection COLLect SHOR SENSe CORRection COLLect LOAD SENSe CORRection COLLect INITialize Title Calibration Initialize Shift 2 Calibrate Configure DUT User Short Initiates the calibration process This command must be issue before sending Open Short or Load commands Use the query command SENSe CORRection COLLect STATus to check if initialization has completed and that the next calibrate step can be proceeded Notes Description 1 Once the calibration sequence has been initialized remotely calibration steps must be completed remotely To exit the calibration sequence before it is completed use the ABORt command 2 During calibration Data Points is set to 551 Set to desired Data Points value after calibration is completed Related Command SENSe SENSe CORRection COLLect s SENSe rs 5 CORRection COLLect CORRection COLLect CORRection COLLect CORRection COLLect STATus OPEN SHORt LOAD ABORt SENSe SENSe SENSe CORRection COLLect LOAD Title Calibration Load De
92. ing As String Dim ipAddress As String Dim Port As String Rem Begin by initializing the system Stat viOpenDefaultRM dfltRM If stat VI SUCCESS Then Rem Error initializing VISA exiting Exit Sub End If Rem Open communication with Ethernet Socket Protocol Rem before open an new Ethernet session make sure session was closed Rem NOTE For simplicity we will not show error checking address and port this sample address ipAddress 172 26 202 117 For MW82119B port will be 9001 Port 9001 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 4 Visual Basic stat viOpen dfltRM TCPIPO ipAddress amp Port SOCKET VI NULL VI NULL sesn Rem Set some visa attributes Rem recommendation timeout gt 90 sec stat viSetAttribute sesn VI ATTR TMO VALUE 90000 stat viSetAttribute sesn VI ATTR SEND END EN VI TRUE Rem VI ATTR SUPPRESS END EN has to set to False during Ethernet Socket communication stat viSetAttribute sesn VI ATTR SUPPRESS END EN VI FALSE Stat viClear sesn Rem NOTE Rem All commands SCPI must be send with linefeed Rem during Ethernet Socket communication Rem i e vbLf is in Visual Basic environment constant read back the strat frequency sInputString IDN amp vbLf Stat viWrite sesn sInputString Len sInputString retCount Buffer stat viRead sesn Buffer MAX_CNT retCount System preset
93. ints currently in the selected limit line 5 2 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 1 CALCulate Subsystem CALCulate LIMit STATe OFF ON 0 1 CALCulate LIMit STATe Title Limit State Description Turns the limit line ON or OFF Ifthe value is set to ON or 1 the currently selected limit line is ON If the value is set to OFF or 0 the currently selected limit line is OFF The query version of the command returns a 1 if the currently selected limit line is ON and returns a 0 if OFF Parameter OFF ON 0 1 Parameter Type boolean Default Value OFF Example To turn on the limit line CALCulate LIMit ON CALCulate LIMit STATe ON CALCulate LIMit STATe 1 To turn off the limit line CALCulate LIMit OFF CALCulate LIMit STATe 0 CALCulate LIMit 0 Front Panel Access Shift 6 Limit Limit On Off CALCulate MARKer AOFF Title Turn All Markers Off Description Turns off all markers Front Panel Access Marker All Markers Off MW82119B PM PN 10580 00403 Rev C 5 3 5 1 CALCulate Subsystem Chapter 5 Cable amp Antenna Commands CALCulate MARKer TABLe DATA Title Marker Table Data Description Reports marker information similar to the Marker table The response begins with an ASCII header The header specifies the number of following bytes It looks like AX where A is the number of digitsin X and X is the number of bytes that follow th
94. ion returns 0 when the GPS is Off and returns 1 when the GPS is On Requires Option 31 Syntax SENSe GPS OFF ON 0 1 SENSe GPS Cmd Parameters boolean OFF ON 0 1 Query Responses bNR1 0 1 Default Value Off Front Panel Access Shift 8 System GPS GPS On Off GPS Reset SENSe GPS RESet Description Resets optional GPS receiver Requires Option 31 Syntax SENSe GPS RESet Cmd Parameters NA Query Responses NA no query Front Panel Access Shift 8 System GPS Reset 3 8 PN 10580 00403 Rev C MW82119B PM Chapter 3 All Modes Programming Commands 3 4 SENSe GPS Subsystem GPS Antenna Current SENSe GPS CURRent Description Syntax Cmd Parameters Query Responses Front Panel Access Query only Reads the current draw of the GPS antenna in mA Requires Option 31 SENSe GPS CURRent NA query only lt integer gt Shift 8 System GPS GPS Info GPS Antenna Voltage SENSe GPS VOLTage 0 1 SENSe GPS VOLTage Description Syntax Cmd Parameters Query Responses Front Panel Access Sets and Reads the voltage setting for the GPS antenna To set the voltage to 3 3 V send the 0 parameter after the command To set the voltage to 5 V send the 1 parameter after the command The query version returns 0 for an antenna voltage of 3 3 V and returns 1 foran antenna voltage of 5 V Requires Option 31 SENSe GPS VOLTage 0 1 SE
95. ipment There are high voltage parts in this equipment presenting a risk of severe injury or fatal electric shock to untrained personnel In addition there is a risk of damage to precision components Caution Electrostatic Discharge ESD can damage the highly sensitive circuits in the instrument ESD is most likely to occur as test devices are being connected to or disconnected from the instrument s front and rear panel ports and connectors You can protect the instrument and test devices by wearing a static discharge wristband Alternatively you can ground yourself to discharge any static charge by touching the outer chassis of the grounded instrument before touching the instrument s front and rear panel ports and connectors Avoid touching the test port center conductors unless you are properly grounded and have eliminated the possibility of static discharge Repair of damage that is found to be caused by electrostatic discharge is not covered under warranty Warning This product is supplied with a rechargeable battery that could potentially leak hazardous compounds into the environment These hazardous compounds present a risk of injury or loss due to exposure Anritsu Company recommends removing the battery for long term storage of the instrument and storing the battery in a leak proof plastic container Follow the environmental storage requirements specified in the product technical data sheet
96. ipment malfunction Anritsu Company uses the following symbols to indicate safety related information For your own safety please read the information carefully before operating the equipment Symbols Used in Manuals Danger This indicates a risk from a very dangerous condition or procedure that could result in serious injury or death and possible loss related to equipment malfunction Follow all precautions and procedures to minimize this risk Warning This indicates a risk from a hazardous condition or procedure that could result in light to severe injury or loss related to equipment malfunction WARNING A Follow all precautions and procedures to minimize this risk Caution This indicates a risk from a hazardous procedure that could result in loss related to equipment malfunction Follow all precautions and procedures to minimize this risk Safety Symbols Used on Equipment and in Manuals The following safety symbols are used inside or on the equipment near operation locations to provide information about safety items and operation precautions Ensure that you clearly understand the meanings of the symbols and take the necessary precautions before operating the equipment Some or all of the following five symbols may or may not be used on all Anritsu equipment In addition there may be other labels attached to products that are not shown in the diagrams in this manual This indicates a prohibited operation Th
97. ith and exponent e g floating point number lt NRf gt lt NR1 gt lt NR2 gt lt NR3 gt inis SCPI numeric value lt NRf gt MINimum MAXimum UP DOWN DEFault NAN Not A Number INFinity NINFinity Negative Infinity or other types char zZ CHARACTER PROGRAM DATA Examples CW FIXed UP and DOWN string ol RING PROGRAM DATA gt ASCII characters enclosed by double quotes For example OFF lt block gt IEEE 488 2 block data format lt NA gt Not Applicable Unit suffixes are not required for data parameters provided the values are scaled for the global default units The instrument SCPI default units are Hz Hertz for frequency related parameters s seconds for time related parameters and m meters for distance related parameters MW82119B PM PN 10580 00403 Rev C 2 4 Notational Conventions Chapter 2 Programming with SCPI 2 4 Notational Conventions The SCPI interface standardizes command syntax and style that simplifies the task of programming across a wide range of instrumentation As with any programming language the exact command keywords and command syntax must be used Unrecognized commands or improper syntax will not function Table 2 5 Notational Conventions A colon links command keywords together to form commands The colon is not an actual part of the keyword but is a signal to the SCPI interface parser A colon must precede a root keyword immediately following a
98. itle Measured Noise Floor Frequency from PIM Master Description The query returns the latest measured frequency of Spectrum View in Hz Related Command SENSe PIManalyzer SPECtrum CURRent MEASure VALue SENSe PIManalyzer SPECtrum MAX FREQuency Front Panel Access N A Signal frequency is displayed in the lower measurement box after the Signal Amplitude in dBm SENSe PIManalyzer SPECtrum MAX MEASure VALue Title Maximum Measured Noise Floor Value from PIM Master Description The query returns the maximum measured value of Spectrum View in dBm Related Command SENSe PIManalyzer SPECtrum MAX FREQuency SENSe PIManalyzer SPECtrum CURRent MEASure VALue Front Panel Access N A Maximum signal value is displayed in the lower measurement box as Max Amplitude MW82119B PM PN 10580 00403 Rev C 4 31 4 7 SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands SENSe PIManalyzer SPECtrum MAX FREQuency Title Description Related Command Front Panel Access Frequency at Maximum Measured Noise Floor Value from PIM Master The query returns the frequency of the maximum signal measured in Spectrum View in Hz SENSe PIManalyzer SPECtrum MAX MEASure VALue SENSe PIManalyzer SPECtrum CURRent FREQuency N A Maximum signal frequency is displayed in the lower measurement box after the Max Amplitude dBm value SENSe PIManalyzer
99. its The query version of the command returns the location of the delta marker on the x axis lt x parameter gt Current x axis unit If both the reference and delta marker 1 is currently at 1 GHz on the x axis send the command below to set the delta marker 1 to 2 GHz on the x axis CALCulate MARKer1 DELTa X 1GHz CALCulate MARKer 1 2 3 4 5 6 X Marker Delta CALCulate MARKer 1 2 3 4 5 6 DELTa Y Title Description Default Unit Delta Marker Read Y Value Reads the current Y value for the specified delta marker The units are the units of the y axis Current y axis unit CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFF ON 0 1 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access Delta Marker State Sets the specified delta marker on or off OFF ON 0 1 lt boolean gt OFF To turn on delta marker 3 CAL1Culate MARKer3 DELTa ON CALCulate MARKer3 DELTa 1 CALCulate MARKer3 DELTa STATe ON CALCulate MARKer3 DELTa STATe 1 To turn off delta marker 6 CALCulate MARKer6 DELTa OFF CALCulate MARKer6 DELTa STATe OFF CALCulate MARKer6 DELTa STATe 0 Marker Delta MW82119B PM PN 10580 00403 Rev C 5 1 CALCulate Subsystem Chapter 5 Cable amp Antenna Commands CALCulate MARKer 1 2 3 4 5 6 PEAK Title Marker Peak Search Description Puts the specified marker at the maximum valu
100. known L Y ASRL4 INSTR Y ASRLB INSTR Resources to Find INSTR vi Resource to pen USBO 0x0B5B 0xFFF9 8311335_192_29 INSTR Figure 1 4 VISA Interactive Control 1 6 PN 10580 00403 Rev C MW82119B PM Chapter 1 General Information 1 4 Sending SCPI Commands 2 Select the viWrite tab and execute the default IDN write by clicking the Execute button USBO 0x0B5B 0xFFF9 8311335 192 29 INSTR Session OxOOE4F070 T Show All VISA Operations viSetAttibute viwite viRead viClear H IDN Nn Retum Count F 0 Hetur Status kx U Write data to a message based bus or device Execute Figure 1 5 VISA Interactive Control viWrite Tab 3 Select the viRead tab and click the Execute button If the PC is connected to the instrument the command returns the following information from the Buffer manufacturer name Anritsu model number options serial number and firmware package number USB0 0x0B5B 0xFFF9 914130 256 21 INSTR Session Ox00E4F7E0 X viSet ttribute viwrite viRead viClear T Show All VISA Operations Buffer View mixed ASCII hexadecimal Anritsu S332E 29 25 27 31 10 28 19 21 9 2 14130 T0 49 El Return Count faz Return Status E 0 Read data from a message based bus or device Execute Figure 1 6 VISA Interactive Control viRead Tab MW82119B PM PN 10580 00403 Rev C 1 7 1 4 Sending SCPI Comm
101. larm CALCulate LIMit ALARm OFF CALCulate LIMit ALARm 0 To turn on limit alarm CALCulate LIMit ALARm ON CALCulate LIMit ALARm 1 Front Panel Access Shift 6 Limit Limit Alarm CALCulate LIMit CLEar Title Clear Selected Limit Description Deletes all limit points for the currently active limit line Front Panel Access Shift 6 Limit Clear Limit CALCulate LIMit POINt ADD Title Add Limit Point Description Adds a new limit point to the currently active limit line Front Panel Access Shift 6 Limit Multi Segment Edit Add Point MW82119B PM PN 10580 00403 Rev C 5 1 5 1 CALCulate Subsystem Chapter 5 Cable amp Antenna Commands CALCulate LIMit POINt FREQuency freq CALCulate LIMit POINt FREQuency Title Limit Point Frequency Description Sets the limit point frequency of the current selected limit Parameter freq Default Unit Hz Front Panel Access Shift 6 Limit Multi Segment Edit Point Freq CALCulate LIMit POINt VALue value CALCulate LIMit POINt VALue Title Limit Point Value Description Sets the limit point value of the current selected limit The value parameter is the limit point value in dB or time units for group delay Parameter value Default Unit Current active value unit Front Panel Access Shift 6 Limit Multi Segment Edit Point Value CALCulate LIMit POINt Title Number of Limit Points Description Returns the number of po
102. lized is specified then the command returns a 1 if the Initialize step has completed and returns a 0 if it has not been completed If OPEN is specified then the command returns a 1 if the Open step has completed and returns a 0 if it has not been completed If SHORt is specified then the command returns a 1 if the Short step has completed and returns a 0 if it has not been completed If LOAD is specified then the command returns a 1 if the Load step has completed and returns a 0 if it has not been completed INITialize OPEN SHORt LOAD lt char gt INITialize OPEN SHORt LOAD mama c3 c3 SENSe CORRection SENSe CORRection SENSe CORRection SENSe CORRection COLLect COLLect COLLect COLLect INITialize OPEN SHORt LOAD SENSe CORRection TYPe STANDARD FLEX SENSe CORRection TYPe Title Description Parameter Parameter Type Front Panel Access Calibration Type Set Calibration type Standard or Flex STANDARD FLEX char Shift 2 Calibrate Cal Type SENSe FREQuency CABle index Title Description Parameter Front Panel Access Cable Selection Sets the cable selection to the index in the cable list for the DTF measurement index Freq Dist More Cable Note For DTF measurements only PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 9 SENSe Subsystem SENSe
103. m Chapter 3 All Modes Programming Commands 3 1 FETCh GPS Subsystem The commands in this subsystem return the most recent measured GPS data Fetch GPS Fix Data FETCh GPS Description Syntax Cmd Parameters Query Responses Default Unit Front Panel Access Returns the most recent GPS fix information from the optional GPS receiver The results are returned as a set of comma delimited values in the following format fix status date time latitude longitude The fix status fieldis either GOOD FIX or NO FIX depending on whether the GPS receiver is currently calculating position data If NO FIX isthe value ofthe fix status field then no data follows The date and time lt date time gt field are returned in the following format Www Mmm dd hh mm ss yyyy Where Www is the weekday in letters Mmm is the month in letters dd is the day of the month hh mm ss is the time 24 hour time and yyyy isthe year Both latitude and longitude fields are expressed in radians A negative latitude value corresponds to a south reading A negative longitude value corresponds to a west reading Requires Option 31 FETCh GPS NA query only lt string gt lt arg gt lt NR2 gt lt NR2 gt for parameter data of lt fix status gt lt date time gt lt latitude gt lt longitude gt Radians NA 3 2 PN 10580 00403 Rev C MW82119B PM Cha
104. mand Trace Header Transfer Returns trace header information for the trace Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory The response begins with an ASCII header The header specifies the number of following bytes It looks like AX where A is the number of digits in X and X is the number of bytes that follow the header Parameters are returned in comma delimited ASCII format Each parameter is returned as NAME VALUE UNITS Note that currently only Trace A header is retrieved Valid parameters are shown in Parameter Names on page 2 11 1 TRACe DATA TRACe DATA 1 Title Description Parameter Related Command Trace Data Query Transfers the current active trace data from the instrument to the controller The format of the block data that is returned can be specified by the command FORMat DATA The block data in the command form is always sent in ASCII format The response begins with an ASCII header that specifies the number of data bytes It looks like AX where A is the number of digits in X and X is the number of bytes that follow the header Each data point is separated by a comma delimiter Except for the group delay each data point consists of real and imaginary pair scaled by 10 6 Thus for a 551 point trace there is a total of 1102 points Trace setup information can be acquired using TRACe DATA PREamble For sweep resolutions 255
105. mands are identified by the asterisk at the beginning of the command keyword These commands are defined to control instrument status registers status reporting synchronization and other common functions For example IDN is acommon command supported by the PIM Master SCPI Required Commands The required SCPI commands supported by the instrument are listed in the Table 2 1 Table 2 1 SCPI Required Commands STATus SYSTem SCPI Optional Commands Table 2 2 lists the optional SCPI commands that comprise the majority of the command set described in this document These commands control most of the programmable functions of the instrument Table 2 2 SCPI Optional Commands ABORt FETCh MEASure TRACe CALCulate FORMat MMEMory TRIGger CALibration INITiate READ UNIT CONFigure INPut SENSe SENSe DISPlay INSTrument SOURce The SCPI optional commands are sorted by measurement modes and commands may be repeated in more than one mode Chapter 3 All Modes Programming Commands Chapter 4 PIM Analyzer Programming Commands Chapter 5 Cable amp Antenna Commands 2 2 PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI 2 3 Subsystem Commands 2 3 Subsystem Commands Subsystem commands control all instrument functions and some general purpose functions All subsystem commands are identified by the colon used between keywords as in INITiate C
106. maximum horizontal distance that can be analyzed in DTF Note that the unit return 1s based on the current distance units Dependent on instrument model number and frequency range Meters m 0 0 m to 1500 m CALCulate TRANsform DISTance FRESolution Title Description Default Value Default Unit Range Fault Resolution Reports the system s ability to separate two closely spaced discontinuities in DTF measurements Note that the return value is based on the current distance units Dependent on instrument model number and frequency range Meters m 0 0 m to 1500 m CALCulate TRANsform DISTance PVELocity CALCulate TRANsform DISTance PVELocity Title Description Default Value Range Front Panel Access Propagation Velocity Sets the propagation velocity ofthe cable for DTF measurements 0 8 0 001 to 1 0 Freq Dist More Prop Velocity Note For DTF measurements only CALCulate TRANsform DISTance START CALCulate TRANsform DISTance START Title Description Default Value Default Unit Range Front Panel Access Start Distance Sets the start distance for DTF measurements 0 0 m Meters m 0 0 m to 1000 0 m Freq Dist Start Dist MW82119B PM PN 10580 00403 Rev C 5 1 CALCulate Subsystem Chapter 5 Cable amp Antenna Commands CALCulate TRANsform DISTance STOP CALCulate TRANsform DISTance STOP Title Description Default Unit Range Front Panel Acces
107. measurements the parameter X is either 1 or 2 Fixed F1 trace data 1 2 Fixed F2 trace data For PIM vs Time measurements X should not be specified NULL 1 2 3 lt char gt To query the data points of a PIM vs Time trace TRAC DATA TRAC To query the data points of a Swept PIM Fixed F1 trace TRAC DATA 1 TRAC 1 To query the data points of a DTP active trace TRAC DATA 1 TRAC 1 To query the data points of a DTF overlay trace TRAC DATA 3 TRAC 3 NA 4 36 PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 8 TRACe Subsystem MW82119B PM PN 10580 00403 Rev C 4 37 4 8 TRACe Subsystem Chapter 4 PIM Analyzer Programming Commands 4 38 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 1 CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem CALCulate LIMit ALARm OFF ON 0 1 CALCulate LIMit ALARm Title Limit Alarm Description Enables disables the currently active limit line alarm Setting the value to ON or 1 will turn on the limit alarm Setting the value to OFF or 0 will turn off the limit alarm The query version of the command returns a 1if the currently selected limit line alarm is set to ON and returns 0 if OFF Parameter OFF ON O 1 Parameter Type boolean Default Value OFF Example To turn off limit a
108. n COLL OPEN SENSe CORRection COLL SHORt MW82119B PM PN 10580 00403 Rev C 5 11 5 3 CONFigure Subsystem Chapter 5 Cable amp Antenna Commands 5 3 CONFigure Subsystem This set of commands prepares the instrument for the selected measurement It disables any currently enabled measurements and activates the specified measurement It sets the instrument to single sweep mode waiting for an INITiate command It will not initiate the taking of a measurement Current instrument settings may be changed to default values These changes are identified with their respective measurement commands In dual display mode the top and bottom channels CANNOT be the same Note measurement type CONFigure MEASure Title Current Active Measurement Mode Description Reports the current active measurement mode Front Panel Access Measurements Active measurement is indicated by the red radial button CONFigure MEASure ACTiveChan 0 1 CONFigure MEASure ACTiveChan Title Active Channel 0 1 Description Toggles between channel 0 top and 1 bottom Only functional in Dual Display Mode Front Panel Access Measurements Active measurement is indicated by the red radial button CONFigure MEASure DUALdisplay DUAL SINGLE CONFigure MEASure DUALdisplay Title Dual Display On Off Description Turns dual display on or off Front Panel Access Measurements Display Format CONFigure MEASure R
109. nce networking standard that is considered plug and play compatible The USB driver software is automatically detected and configured by the operating system of the devices that are connected to the bus The instrument conforms to the USB 2 0 standard and is a USB Hi speed device that supports data rates of up to 480 Mbps with the following restrictions One USB network can support up to 127 devices The maximum length of USB cables between active devices is 5 meters for USB 2 0 and 3 meters for USB 1 0 You must have NI VISA 2 5 or later installed on the controller PC and must select the VISA library visa32 dll as a reference in a Visual Basic project For remote USB control the controlling PC needs to have a version of VISA installed that supports USBTMC USB Test and Measurement Class devices MW82119B PM PN 10580 00403 Rev C 1 1 1 3 Remote Operation Setup and Interface Chapter 1 General Information USB Interface Type Mini B The USB 2 0 Mini B device connector is used to connect the instrument directly to a PC The first time the instrument is connected to a PC the normal USB device detection by the computer operating system takes place 1 Power on the instrument and controller PC and wait for the systems to power up completely 2 Connect the USB cable Mini B connector to the instrument 3 Connect the USB cable A connector to the controller PC USB host port The controller PC should indicate New Hardw
110. nel Access Amplitude Autoscale DISPlay WINDow TRACe Y SCALe BOTTOom value Title Scale Bottom level Description Sets the Bottom value for the current graph This command is invalid for Smith charts Default Unit Current active amplitude unit Range Log Magnitude 0 dB to 60 dB Phase 180 degree to 90 degree VSWR 1 to 65 DTF RL 0 dB to 60 dB DTF VSWR 1 to 65 Front Panel Access Amplitude Bottom DISPlay WINDow TRACe Y SCALe TOP value Title Scale Top level Description Sets the Top value for the current graph This command is invalid for Smith charts Default Unit Current active amplitude unit Range Log Magnitude 0 dB to 60 dB Phase 180 degree to 90 degree VSWR 1 to 65 DTF RL 0 dB to 60 dB DTF VSWR 1 to 65 Front Panel Access Amplitude Top 5 14 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 4 DISPlay Subsystem DISPlay WINDow TRACe Y SCALe SMCHart 0 10 20 30 3 DISPlay WINDow TRACe Y SCALe SMCHart Title Description Parameter Default Value Default Unit Range Front Panel Access Smith Chart Scalable Type Sets the Smith chart display scale type Setting the value to 0 is equivalent of setting the Smith Chart scale to Normal on the front panel Setting the value to 10 is equivalent of setting the Smith Chart scale to Expand 10dB on the front panel Setting the value to 20 is equivalent of setting the Smi
111. nter Command Bytes to Read No Error IDN n v 1024 write Query Read ReadStatusByte Gea View mixed ASCII hexadecimal 1 Write Operation IDN n Return Count 6 bytes 2 Read Operation Return Count 38 bytes Anritsu S820E 730 30650007 D0 01 0225 n Clear Buffer Figure 1 14 NI VISA Interactive Control USB Basic I O Tab Note When sending SCPI commands over Ethernet you are required to send a newline termination character at the end of each command In the example above a newline character n in this case but could be different depending on your programming environment was used to terminate the IDN command When sending query commands over raw socket the entire buffer must be read before the next query command is sent Each query result is terminated by a newline to help identify the end of the query response Query read operations could be broken into multiple reads if necessary When using raw socket connections you must close a session before opening a new one or before switching to a new protocol such as USB If you try to open a new session or switch protocols without first closing the previously opened session then you may lose communications with the instrument and may not be able to reconnect until you reboot the instrument MW82119B PM PN 10580 00403 Rev C 1 13 1 4 Sending SCPI Commands Chapter 1 General Information 1 14 PN 10
112. orage location The integer parameter is not currently used but it must be sent Send a value of 0 integer file name gt MMEMory LOAD STATe MMEMory MSIS INTernal USB Shift 7 File 5 22 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 7 MMEMory Subsystem MMEMory STORe TRACe lt integer gt lt file name gt Title Description Parameter Example Related Command Front Panel Access Save Measurement Stores the trace into the file specified by lt file name gt lt file name gt should be enclosed in either single quotes or double quotes and should not contain a file extension Use the command MMEMory MSIS to set the current storage location The lt integer gt parameter is not currently used but it must be sent Send a 0 This command saves vna only The vna extension is automatically appended to the end of the filename entered in this command integer file name gt To save the trace into the file name trace MMEMory STORe TRACe 0 trace MMEMory LOAD TRACe MMEMory MSIS INTernal USB Shift 7 File Save MW82119B PM PN 10580 00403 Rev C 5 23 5 8 TRACe Subsystem Chapter 5 Cable amp Antenna Commands 5 8 TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument TRACe PREamble 1 Title Description Parameter Related Com
113. ore disconnecting a coaxial connection otherwise RF burns may result Immediate burns to fingers or eyes can result from exposure to live connectors Warning Ensure all antenna s under test are placed so that no personnel are exposed to RF levels that exceed the maximum allowable exposure 4 1 SCPI Commands Introduction The set of commands in this chapter are used to prepare the PIM Master hardware for the selected measurements These commands activate a specified measurement and set the instrument to a wait for sweep mode waiting for an INITiate command to begin a measurement Ensure that your PIM Master is in the desired testing Mode before sending SCPI commands Example A typical command set for the PIM Master would include SENSe PIManalyzer MODe PIM PIMSwp DTP Sets mode to PIM vs Time Swept PIM or DTP SENSe PIManalyzer MODe Responds with PIM PIMSwp DTP mode type PIM vs Time Swept PIM or DTP SENSe PIManalyzer FREQuency F1 1930000000 Sets F1 to 1930 MHz SENSe PIManalyzer FREQuency F2 1990000000 Sets F2 to 1990 MHz SENSe PIManalyzer AUTorange 1 Sets Amplitude to Auto Range SENSe PIManalyzer IMD ORDer 3 Sets center frequency of Rx to IM3 SENSe PIManalyzer OUTPut POWer 20 Sets power to 20 Watts SENSe PIManalyzer TEST DURation 10 Sets the POWER ON time INITiate PIManalyzer MEASure ON Starts PIM measurement MW82119B PM PN 10580 00403 Rev C 4 1
114. provide access to the setup and data storage of the instrument MMEMory CABLelist RESet Title Reset Cable List to Default Description Clears the Cable List favorites and restores the factory default cable list information Front Panel Access Distance More Cable Clear all Favorites MMEMory LOAD TRACe integer file name gt Title Recall Measurement Description The instrument must be in the mode of the saved trace in order to recall that trace Use INSTrument SELect or INSTrument NSELect to set the mode Recalls a previously stored measurement trace from the current storage location The saved measurement trace to be loaded is specified by file name file name gt should be enclosed in either single quotes or double quotes and should contain a file extension Note that the trace specified by lt file name should be available at the current mass storage location Use the command MMEMory MSIS to set the current mass storage location The integer parameter is not currently used but it must be sent Send a d 1 File name extensions pim for PIM Analyzer Note Extensions not available for T1 and HI PM Parameter integer file name Example To recall trace with file name trace MMEMory LOAD TRACe 1 trace pim Related Command MMEMory STORe TRACe MMEMory MSIS INTernal USB Front Panel Access Shift File 7 Recall Measurement 4 20 PN 10580 00403 Rev C MW82119B PM
115. pter 3 All Modes Programming Commands 3 2 INSTrument Subsystem 3 2 INSTrument Subsystem One instrument may contain many logical instrument modes This subsystem controls the selection of the current instrument mode INSTrument CATalog FULL Title Description Front Panel Access Query Available Modes Returns a comma separated list of available modes Mode names are enclosed in double quotes Immediately following the string name is the application number For example an instrument with the High Accuracy Power Meter Option 19 would return the string HI_PM 10 MINIPIM 46 And an instrument with the Site Master Option 331 and the High Accuracy Power Meter Option 19 would return the string VNA 2 HI_PM 10 MINIPIM 46 Shift Mode 9 or Menu INSTrument NSELect integer INSTrument NSELect Title Description Parameter Parameter Type Related Command Front Panel Access Select Mode by Number Sets the instrument mode based on the value of lt integer gt The query version returns the number associated with the current mode Use INSTrument CATalog FULL to get a list of available mode names and their integer representations lt integer gt lt integer gt INSTrument CATalog FULL INITiate CONTinuous INSTrument SELect STATus OPERat ion Shift Mode 9 or Menu Switching modes can take longer than 80 seconds depending on
116. r sweep measurement is triggered as soon as the current one completes If continuous is set to OFF or 0 then the instrument enters the idle state and waits for the INITiate IMMediate command or for INITiate CONTinuous ON The default value is ON That is sending INIT CONT is equivalent to sending INIT CONT ON The query version ofthe command returns a l if the instrument is continuously sweeping measuring and returns a 0 if the instrument is in single sweep measurement mode Note that rapid toggling between ON and OFF is not allowed The instrument must be allowed to make a full sweep before toggling can be done Note that the set command is available only ifthe instrument is in Cable amp Antenna mode OFF ON JO 1 lt boolean gt 1 INITiate IMMediate INITiate HOLD Shift 3 Sweep Sweep Type INITiate HOLD OFF ON 0 1 INITiate HOLD Title Hold Sweep Description Stops a sweep at its current measurement point If the instrument is Parameter Parameter Type Default Value Front Panel Access currently sweeping setting a value of ON or 1 will pause the sweep If the instrument is currently not sweeping setting a value of OFF or 0 will resume sweeping The query version of the command returns a 1 if the hold command is set and returns a 0 if a Run is set instead Note that the set command is available only if the instrument is in Cable amp Antenna mode OFF ON JO 1 lt boolean gt 0 Shift 3 Sw
117. returns 1 sInputString SENS CORR COLL ACQU STAT THRU 1 stat viWrite sesn sInputString Len sInputString retCount stat viRead sesn Buffer MAX_CNT retCount Loop Until Val Buffer 1 Save and apply calibration sInputString SENS CORR COLL SAV stat viWrite sesn sInputString Len sInputString retCount A 10 PN 10580 00403 Rev C MW82119B PM Appendix A Examples A 3 Visual Basic Wait for previous operation to be completed sInputString OPC stat viWrite sesn sInputString Len sInputString retCount Buffer stat viRead sesn Buffer MAX_CNT retCount read back the cal type i e Buffer 5 One path Two port calibration sInputString SENS CAL STAT stat viWrite sesn sInputString Len sInputString retCount Buffer stat viRead sesn Buffer MAX_CNT retCount Rem Close down the system stat viClose sesn stat ll viClose dfltRM End Sub MW82119B PM PN 10580 00403 Rev C A 11 A 4 Visual Basic Appendix A Examples A 4 Visual Basic This function can be called in a Visual Basic program It demonstrates connection and setting parameters in the instrument while using Ethernet Socket protocol Public Sub CommunicationWithTCPIPSocket Const MAX_CNT 200 Dim stat As Variant Dim dfltRM As Variant Dim sesn As Variant Dim retCount As Long Dim Buffer As String MAX_CNT Dim Response As String VI_FIND_BUFLEN Dim sInputStr
118. s CALCulate TRANsform DISTance UNIT METers Stop Distance Sets the stop distance for DTF measurements Meters m 0 0 m to 1000 0 m Freq Dist Stop Dist FEET CALCulate TRANsform DISTance UNIT Title Description Parameter Parameter Type Default Value Range Front Panel Access Distance Units Sets the units to be used for DTF measurements METers FEET lt char gt Meters METers FEET Freq Dist Units CALCulate TRANsform DISTance WINDow RECTangular MSLobe NSLobe LSLobe CALCulate TRANsform DISTance WINDow Title Description Parameter Parameter Type Default Value Range Front Panel Access Windowing Sets the windowing for DTF measurements Available types are Rectangular Nominal Side Lobe Low Side Lobe and Minimum Side Lobe RECTangular MSLobe NSLobe LSLobe lt char gt Rectangular RECTangular MSLobe NSLobe LSLobe Freq Dist More Window PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 2 CALibration Subsystem 5 2 CALibration Subsystem This subsystem controls the system calibration CALibration STATe Title Calibration State Description Reports the calibrated state This command returns a 1 if the instrument has been calibrated with discrete Open Short and Load components and returns 0 if the instrument has not been calibrated Related Command SENSe CORRection COLL LOAD SENSe CORRect io
119. scription Starts the Load calibration measurement This is the last calibration steps for 1 Port OSL and the third calibration steps for 2 Port OSLT Note that the Calibration Short process must be completed before calling this command You must also connect the Load to the RF Out port or to the end of the test port extension cable prior to issuing this command Use the query command SENSe CORRection COLLect STATus to check if the Load calibration measurement has completed and that the next calibrate step can be proceeded Related Command SENSe SENSe SENSe SENSe CORRection COLLect CORRection COLLect CORRection COLLect CORRection COLLect STATUS INITialize OPEN SHORt 5 26 PN 10580 00403 Rev C MW82119B PM Chapter 5 Cable amp Antenna Commands 5 9 SENSe Subsystem SENSe CORRection COLLect OPEN Title Description Related Command Calibration Open Starts the Open calibration measurement This is the first calibration step for both the 1 Port Open Short Load and 2 Port Open Short Load calibration Note that the initialize step SENS CORR COLL INIT must be completed before calling this command Note that you must connect the Open to the RF Out port or to the end of the test port extension cable before issuing this command Use the query command SENSe CORRection COLLect S TATus to check if the Open calibration measurement has completed and that
120. semicolon see Notational Examples on page 2 9 A semicolon separates commands if multiple commands are placed on a single program line Square brackets enclose one or more optional keywords Braces enclose one or more keyword or command parameters that may be included zero or more times A vertical bar indicates or and is used to separate alternative parameter options Example ON OFF is the same as ON or OFF lt gt Angle brackets enclose parameter descriptions Means is defined as For example lt a gt lt b gt lt c gt indicates that lt b gt lt c gt can replace a sp Space referred to as white space must be used to separate keywords from their associated data parameters It must not be used between keywords or inside keywords xxx Indicates a root command name Indicates an integer value selection from a range of values For further information about SCPI command syntax and style refer to the Standard Commands for Programmable Instruments SCPI 1999 0 document PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI 2 5 Notational Examples 2 5 Notational Examples Table 2 6 provides examples of valid command syntax Table 2 6 Creating Valid Commands Command Specification Valid Forms SENSe FREQuency STARt The following all produce the same result requency Hz kHz MHz GHz SENSe FREQuency STARt 1 MHZ
121. splay top to 10 dBm SENSe DTPMeas DISPlay TOP 10 0 SENSe DTPMeas DISPlay BOTTom 90 0 SENS DTPM DISP BOTT Amplitude Top SENSe DTPMeas ENREsolution ON OFF SENSe DTPMeas ENREsolution Title Description Parameter Example Front Panel Access PIM Master Enhanced Resolution This feature estimates the location of PIM sources on the measurement trace and displays up to 4 vertical impulse bars from bottom of measurement grid to point on measurement trace that indicates a predicted PIM source location This is useful for resolving PIM sources that are physically close together ON OFF To set Enhanced Resolution to On SENSe DTPMeas ENREsolution ON Setup Enhanced Resolution PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 SENSe Subsystem SENSe PIManalyzer AVERaging FAST LOWNoise SENSe PIManalyzer AVERaging Title Description Parameter Range Example Front Panel Access PIM vs Time Trace Mode Low Noise provides improvement in measurement range Fast provides faster measurement updates measurements per second The query returns FAST or LOWN LOWNoise FAST LOWNoise FAST Averaging is minimum LOWNoise Averaging is maximum To set the PIM Master measurement for maximum averaging SENSe PIManalyzer AVERaging LOWNoise Setup Trace Mode SENSe PIManalyzer AUTorange OFF ON 0 1 SENSe PIManal
122. t magnitudes Figure 1 shows the data capture and conversion to 32 bit integers in the format used by LabVIEW Figure 2 shows the details of the conversion Your instrument must first be defined to the VISA resource manager using Note NI MAX The VISA resource for your instrument serves as the VISA resource input to the vi MW82119B PM PN 10580 00403 Rev C A 15 Appendix A Examples A 5 LabVIEW ano 40443 kan ru 53utog BIE Jo ang peau Ren i y Aewe e3ep aabayu 14 4aquinpy 03 BUS aweu a4nosa1 YSIA dnp Aene e3ep Jabaqul 49 ZE 03 YSAUO Cc 666 ayas A A JO anje ayy 386 pue Buys ayy wo sajAq x peay A ur seq jo eu SIX x Jo snjea ayy 396 pue xar pesi 95414 SEIEP MPOT AAAAKH EWO Duropo aya ur pauanga sr e3eq uoge Le sil Io el T 48quiny 82641 Cat 33849 T 03 3neJep JOU JI pue uaam3a si AJaqunu 33847 at jeu ens aer VYA YUL eIep 3384 ayy 35anba oF Duns ayy 03 eoe eu PPY oge ho rsia 40418 OU ul 40443 ZE d3531NI V1vQ SoNIQv 3 LYWYOS 4eD91ut 3Iq Z 03 3euuoj PIP ay 135 BWEU 334M0534 YSIA Data Capture Figure A 1 MW82119B PM PN 10580 00403 Rev C A 16 Appendix A Examples A 5 LabVIEW String To Number vi Figure A 2 Data Conversion MW82119B PM PN 10580 00403 Rev C A 17 A 5 LabVIEW Appendix A Examples
123. te Subsystem CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFF ON 0 1 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access Delta Marker State Sets the specified delta marker on or off The query returns the state of the specified delta marker 0 1 OFF ON 0 1 lt boolean gt OFF To turn on the delta marker 3 CALCulate MARKer3 DELTa ON CALCulate MARKer3 DELTa 1 CALCulate MARKer3 DELTa STATe ON CALCulate MARKer3 DELTa STATe 1 To turn off delta marker 6 CALCulate MARKer6 DELTa OFF CALCulate MARKer6 DELTa STATe OFF CALCulate MARKer6 DELTa STATe 0 To query the state of delta marker 2 CALC MARK2 DELT CALC MARK2 DELT STAT Marker Delta On Off MW82119B PM PN 10580 00403 Rev C 4 11 4 2 CALCulate Subsystem Chapter 4 PIM Analyzer Programming Commands CALCulate MARKer 1 2 3 4 5 6 DELTa TRACe 0 1 CALCulate MARKer 1 2 3 4 5 6 DELTa TRACe Title Description Parameter Default Value Example Front Panel Access Delta Marker Trace Sets the specified delta marker to a desired trace Valid only for Swept PIM mode ol None If no value is sent then no action occurs To verify that a value has been received follow the command with a query To set delta marker 1 onto the fixed F2 sweep Sweep 2 CALCulate MARKer1 DELTa TRACe 1 To set delta mark
124. tep size to 100 kHz SENSe PIManalyzer FREQuency STEP 100000 To get the frequency step size PIM FREQ STEP Freq Step Size MW82119B PM PN 10580 00403 Rev C 4 27 4 7 SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands SENSe PIManalyzer IMD ORDer SENSe PIManalyzer IMD ORDer Title Description Default Value Range Example Front Panel Access Measurement Receiver PIM Master Intermodulation Distortion IMD Order Setup Sets the measurement receiver center frequency to receive one of the following IMDs from the PIM Master measurement system 3 5 7 The query command returns the possible strings 3rd 5th and 7th depending on the current selection of IMD Order 3 3 5 and 7 are the only acceptable values To set the measurement receiver for the 5th order IMD SENSe PIManalyzer IMD ORDer 5 Sets the measurement receiver center frequency to the 5th order IMD Freq Intermod Order SENSe PIManalyzer IMFReq BAND LOW HIGH SENSe PIManalyzer IMFReq BAND Title Description Parameter Default Value Example Front Panel Access Optional High Low IMD frequency band selection Sets the receive IMD measurement frequency band only for the LTE based 700 MHz options This command works for all options that have band switching functionality such as Option 210 Option 702 and Option 194 The command and the query are ignored by MW82119B P
125. th 0 1 dBm resolution None If no value is sent then no action occurs To verify that a value has been received follow the command with a query 20 dBm to 46 dBm To set the PIM Analyzer output power to 43 5 dBm SENSe PIManalyzer OUTPut POWer 43 5 PIM vs Time and Swept PIM Setup PIM Aid Output Power PIM vs Time and Swept PIM Freq PIM Aid Output Power DTP Distance DTP Aid Output Power DTP Setup DTP Aid Output Power ON OFF SENSe PIManalyzer RF OUTput Title Description Parameter Default Value Range Example Front Panel Access PIM vs Time Set RF Out On Off This controls whether the RF is ON during a measurement which corresponds to Normal and Noise Floor PVT measurements ON OFF ON OFF 20 dBm to 46 dBm To turn on RF SENSe PIManalyzer OUTPut POWer 43 5 Measurements PIM vs Time Test PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 SENSe Subsystem SENSe PIManalyzer SPECtrum CURRent MEASure VALue Title Measured Noise Floor Value from PIM Master Description The query returns the latest measured value of Spectrum View in dBm Related Command SENSe PIManalyzer SPECtrum CURRent FREQuency SENSe PIManalyzer SPECtrum MAX MEASure VALue Front Panel Access N A Signal value is displayed in the lower measurement box as Signal Amplitude SENSe PIManalyzer SPECtrum CURRent FREQuency T
126. th Chart scale to Expand 20dB on the front panel Setting the value to 30 is equivalent of setting the Smith Chart scale to Expand 30dB on the front panel Setting the value to 3 is equivalent of setting the Smith Chart scale to Compress 3dB on the front panel 01101201301 3 Normal Current active amplitude unit 01101201301 3 Amplitude In Smith Chart measurement view MW82119B PM PN 10580 00403 Rev C 5 15 5 5 FORMat Subsystem Chapter 5 Cable amp Antenna Commands 5 5 FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred The format setting affects data in specific commands only If a command is affected then it is noted in the command description FORMat READings DATA ASCii INTeger 32 REAL 32 FORMat READings DATA Title Description Parameter Parameter Type Default Value Related Command Numeric Data Format This command specifies the format in which data is returned in certain commands ASCii format returns the data in comma separated ASCII format The units are the current instrument units This format requires many more bytes so it is the slowest format INTeger 32 values are signed 32 bit integers in little endian byte order This format returns the data in 4 byte blocks The units are always mdBm For example if the measured result were 12 345 dBm that value would be sent as 1234
127. th SCPI 2 3 Subsystem Commands CONFigure ACPower OBWidth CHPower OTA DEMOD Pfail FSTRength PM MEASure PVTFrame Bi PVTSlot S11 RF 1PHASEe SPECTRUM SMCHart bee VSWR SINGle SUMMARY VNA Figure 2 2 SCPI CONFigure Subsystem A colon separates each subsystem For example the command SENSe FREQuency STARt freq sets the start frequency The start frequency is part of the FREQuency subsystem which is part of the SENSe subsystem Stop frequency is also part of the SENSe FREQuency subsystem It is specified by SENSe FREQuency STOP Query Commands All commands unless specifically noted in the commands syntax descriptions have a query form As defined in IEEE 488 2 a query is a command with a question mark symbol appended examples IDN and OPTions When a query form of a command is received the current setting associated with the command is placed in the output buffer Query commands always return the short form of the parameter unless otherwise specified Boolean values are returned as 1 or 0 even when they can be set as on or off MW82119B PM PN 10580 00403 Rev C 2 5 2 3 Subsystem Commands Identifiers Chapter 2 Programming with SCPI The following identifiers have been used throughout the optional command definitions Descriptions are provided here In most cases units are specified with the individual command Table 2 3 Description of Comman
128. the next calibrate step can be proceeded SENSe CORRection COLLect STATus SENSe CORRection COLLect INITialize SENSe CORRection COLLect SHORt Title Description Related Command Calibration Short Starts the Short calibration measurement This is the second calibration step for both the 1 Port Open Short Load and 2 Port Open Short Load calibration Note that the Calibration Open process must be completed before calling this command You must also connect the Short to the RF Out port or to the end of the test port extension cable before issuing this command Use the query command SENSe CORRection COLLect S TA Tus to check if the Short calibration measurement has completed and that the next calibrate step can be proceeded SENSe CORRection COLLect STATus SENSe CORRection COLLect INITialize SENSe CORRection COLLect OPEN 5 SENSe CORRection COLLect LOAD MW82119B PM PN 10580 00403 Rev C 5 27 5 9 SENSe Subsystem Chapter 5 Cable amp Antenna Commands SENSe CORRection COLLect STATus INITialize OPEN SHORt LOAD Title Description Parameter Parameter Type Range Related Command Calibration Status This command requests information about the current calibration step or the specified calibration step If no calibration step is specified then it returns a 1 ifthe current calibration step has completed otherwise it returns a 0 If INITia
129. the application Note Add a delay of at least 90 seconds between mode switch commands Anritsu Company advises you to set the remote PC time out to 120 seconds in order to avoid unexpected time out errors MW82119B PM PN 10580 00403 Rev C 3 3 3 2 INSTrument Subsystem Chapter 3 All Modes Programming Commands INSTrument SELect string INSTrument SELect Title Select Mode by Name Description Sets the instrument mode based on the mode name specified by lt string gt Enclose the lt string gt argument in single or double quotes The query version returns the name of the current mode Use INSTrument CATalog FULL to get a list of available modes Parameter lt string gt Related Command INSTrument CATalog FULL INSTrument NSELect Front Panel Access Shift Mode 9 or Menu Switching modes can take longer than 80 seconds depending on the application Note Add a delay of at least 90 seconds between mode switch commands Anritsu Company advises you to set the remote PC time out to 120 seconds in order to avoid unexpected time out errors PN 10580 00403 Rev C MW82119B PM Chapter 3 All Modes Programming Commands 3 3 MMEMory Subsystem 3 3 MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument s setup and data storage MMEMory DATA lt file name gt Title Description Parameter Front Pan
130. tion for remote operation of the PIM Master MW82119B Passive Intermodulation PIM Analyzer using commands sent from an external controller through the USB or Ethernet connection This Programming Manual includes the following An overview of the USB and Ethernet connections to the instrument An overview of Standard Commands for Programmable Instruments SCPI command structure and conventions The IEEE common commands that are supported by the instruments Acomplete listing and description of all the SCPI commands that can be used to remotely control functions of the instrument The commands are organized by measurement mode starting in Chapter 3 All Modes Programming Commands This manual is intended to be used in conjunction with the PIM Master MW82119B User Guide Refer to the instrument user guide for general information about the instrument including equipment setup and operating instructions 1 2 Introduction This chapter provides a general description of remote programming setup and interface using USB or Ethernet and sending SCPI commands to the instrument 1 3 Remote Operation Setup and Interface Remote operation of the instrument is accomplished via the USB or Ethernet interface The following paragraphs provide information about the interface connections cable requirements and setting up remote operation USB Interface Connection and Setup The Universal Serial Bus USB architecture is a high performa
131. tp MMEMory STORe STATe MMEMory MSIS INTernal USB Shift File 7 Recall select Setup from list MW82119B PM PN 10580 00403 Rev C 4 21 4 6 MMEMory Subsystem Chapter 4 PIM Analyzer Programming Commands MMEMory STORe STATe lt integer gt lt file name gt Title Description Parameter Example Related Command Front Panel Access Save Setup Stores the current setup into the file specified by lt file name gt file name should be enclosed in either single quotes or double quotes and should not contain a file extension stp Use the command MMEMory MSIS to set the current storage location The integer parameter is not currently used but it must be sent Send a 0 lt integer gt lt file name gt To save the current instrument setup MMEMory STORe STATe 0 setup MMEMory LOAD STATe MMEMory MSIS INTernal USB Shift File 7 Save Change Type select Setup from list 4 22 PN 10580 00403 Rev C MW82119B PM Chapter 4 PIM Analyzer Programming Commands 4 7 4 7 SENSe Subsystem SENSe Subsystem The commands in this subsystem relate to device specific parameters not signal oriented parameters SENSe DTPMeas AVERage TYPE SENSe DTPMeas AVERage TYPE Title Description Parameter Default Value Example Front Panel Access DTP Trace Mode Sets and queries DTP trace mode NORMal normal MAXHold max tra
132. tude CALCulate DTPMeas REFerence AMPLitude 4 4 CALCulate DTPMeas REFerence STATe OFF ONIO I CALCulat amp DEPMeas REFerence STATE 4 5 CALCulate DTPMeas STARt CALCulate DTPMeas STARt 4 5 CALCulate DTPMeas STOP CALCulate DTPMeas STOP serua irea a a a a aae a a aaa aa 4 6 CALCulate DTPMeas UNIT METers FEET CALCulate DTPMeas UNIT 4 7 CALCulate DTPMeas WINDow CALCulate DTPMeas WINDOow 4 7 CALCulate LIMit ALARm OFF ONJ0 1 CALCulate LIMit ALARM 5 CALCulate LIMitALARm ONJOFFJO 1 CALCulate LIMit ALARM 4 8 CALCulate LIMit AMPLitude CALCulate LIMit AMPLitude 4 8 CALCulate LIMICCLEE2E ii UA re en rn Sa rar uc 5 1 CALCulate LIMit FAIL 22220000 eee RR RR es 4 9 CALCulate LIMit POINt ADD 5 1 CALCulate LIMit POINt FREQuency lt freq gt CAL Culate LIMit POINt FREOuency 5 2 CALCulate LIMit POINt V ALue lt value gt CALCulate LIMit POINt VALue 5 2 CALCulate LIMit POINt ii IA RR eh s 5 2 CALCulate LIMit TYPe CAT Culate EM It T YP 6 sed oS ee Sd ea a de eh eng 4 10 CALCulate LI
133. ua EUR a Irish 3 3 INSTrument SELect lt string gt INS Trument SELect 2 2222 AS er dh 3 4 MMEMory CABLelist RESet 4 20 MMEMory DATA lt filename gt 3 5 MMEMory DELete lt filename gt 5 21 MMEMory LOAD STATe lt integer gt lt filename gt 4 21 MMEMory LOAD STATe lt integer gt lt filename gt 5 21 MMEMory LOAD TRACe lt integer gt lt filename gt 4 20 MMEMory LOAD TRACe lt integer gt lt filename gt 5 22 MMEMory MSIS INTernal USB SMMEMOT MSIS ee ota a ARE is SR 3 5 MW82119B PM PN 10580 00403 Rev C D 3 Appendix D List of Commands Alphabetical MMEMoty MSIS COPY zus an en cee se a 3 6 MMEMory MSIS DESTination INTernal USB MMEMory MSIS DESTination 3 7 MMEMory STORe JPEG lt filename gt 3 7 MMEMory STORe STATe lt integer gt lt file name gt 4 22 MMEMory STORe STATe lt integer gt lt file name gt 5 22 MMEMory STORe TRACe lt integer gt lt filename gt 4 21 MMEMory STORe TRACe lt integer gt lt filename gt 5 23 SYSTEM OP ONS er ee ee Be an ee 3 10 SYSTEM PRESO 05324 a ae re v aces 3 10 TRACEPREamble li
134. uency F1 STOP SENSe PIManalyzer SWEEp FREQuency F1 STOP Title Description Parameter Default Unit Range Example Front Panel Access PIM Master Swept PIM F1 Stop Frequency Setup Sets the Swept PIM F1 stop frequency for the Fixed F2 sweep then calculates the IMx sweep frequencies and sets the instrument to display the corresponding IMx sweep frequencies Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To set the F1 stop frequency to 2110 MHz SENSe PIManalyzer SWEEp FREQuency F1 STOP 2110000000 To get the Swept PIM F1 stop frequency PIM SWEE FREQ F1 STOP Freq Swept PIM Aid F1 Stop SENSe PIManalyzer SWEEp FREQuency F2 STARt SENSe PIManalyzer SWEEp FREQuency F2 STARt Title Description Parameter Default Unit Range Example PIM Master Swept PIM F2 Start Frequency Setup Sets the Swept PIM F2 start frequency for the Fixed F1 sweep then calculates the IMx sweep frequencies and sets the instrument to display the corresponding IMx sweep frequencies Frequency in Hz Hz PIM Master option dependent for a list of ranges refer to Table B 1 PIM Master Carrier Bands and Frequencies on page B 2 To set the F2 start frequency to 758 MHz SENSe PIManalyzer SWEEp FREQuency F2 STARt 758000000 MW82119B PM PN 10580 00403 Rev C 4 33 4 7 Front Panel Acc
135. ulate LIMItEPOINCFREQuency nsanannnn 5 2 CALCulate LIMit POINt VALue value CALCulate LIMIt POINt VALue 5 2 GALGulate lIMIEPOJINE ise ee ee nen SI 5 2 CALCulate LIMit STATe OFF ONJO 1 CALCulate LIMIt STATej 5 3 CALGulate MARKeEAQOEFF iii A td 5 3 CALCulate MARKer TABLe DATA aa 5 4 CALCulate MARKer TABLe STATe OFFJONJO 1 CALCulate MARKer TABLef STATejJ 5 4 CALCulate MARKer 1 2 3 4 5 G DELTa X lt x parameter gt CALCulate MARKer 1 2 3 4 516 DELTa K 5 5 CALCulate MARKer 1 2 3 4 516 DELTa Y 5 5 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe OFF ON O 1 CALCulate MARKer 1 2 3 4 5 6 DELTa STATe 5 5 CALCulate MARKer 1 2 3 4 5 6 PEAK 5 6 CALCulate MARKer 1 2 3 4 5 6 VALLey 5 6 CALCulate MARKer 1 2 3 4 5 6 X lt x parameter gt CALCulate MARKer 112 3 4 5 61 K 5 6 CALCulate MARKer 1 2 3 4 5 61 Y 5 6 CALCulate MARKer 1 2 3 4 5 6 STATe OFF ON O 1 CALCulate MARKer 1 2 3 4 5 6 STATe 5 7 CALCulate MATH FUNCtion NORMal AD
136. umeric suffix to differentiate between multiple instrument features such as multiple trace options For example CALCulate DATA FDATa SDATa FMEM SMEM can result in two different commands one for trace 1 CALC1 DATA FDATa and another for trace 2 CALC2 DATA FMEM If a numeric suffix is not included in a command the first option is implied Curly brackets designate optional keyword or command parameters Square brackets Note designate optional command keywords For example the command TRACe DATA 1 2 can be sentas TRACe or TRACe 1 0r as TRAC Or TRAC 1 to obtain data from trace 1 As with any programming language the exact command keywords and command syntax must be used The syntax of the individual commands is described in detail in the programming command chapters Unrecognized versions of long form or short form commands or improper syntax will generate an error MW82119B PM PN 10580 00403 Rev C 2 3 2 3 Subsystem Commands Chapter 2 Programming with SCPI Long Format vs Short Format Each keyword has a long format and a short format The start frequency can be specified by SENSe FREQuency STARt or SENS FREQ STAR The capital letters in the command specification indicate the short form of the command A mixture of the entire short form elements with entire long form elements of each command is acceptable For example SENS FREQuency STAR is an acceptable form
137. used parameter types are numeric extended numeric discrete and Boolean Numeric Numeric parameters comprise integer numbers or any number in decimal or scientific notation and may include polarity signs Discrete Discrete parameters such as INTernal and EXTernal are used to control program settings to a predetermined finite value or condition 2 6 PN 10580 00403 Rev C MW82119B PM Chapter 2 Programming with SCPI Boolean 2 3 Subsystem Commands Boolean parameters represent binary conditions and may be expressed as ON OFF or 1 0 Boolean parameters are always returned by query commands as 1 or 0 in numeric value format Data Parameter Notations The following syntax conventions are used for data parameter descriptions in this manual Unit Suffixes Table 2 4 Parameter Notations lt arg gt a generic command argument consisting of one or more of the other data types lt bNR1 gt boolean values in lt NR1 gt format numeric 1 or 0 0ON OFF Can also be represented as 1 or 0 where 1 means ON and 0 means sbegleahz SER parameters are always returned as 1 or 0 in lt NR1 gt format by query commands integer an unsigned integer without a decimal point implied radix point lt NR1 gt a signed integer without a decimal point implied radix point NR2 a signed number with an explicit radix point NR3 za scaled explicit decimal point numeric value w
138. yzer AUTorange Title Description Parameter Range Example Front Panel Access PIM vs Time Auto Range Sets and queries the Auto Range condition for PIM vs Time measurement None 0 OFF Auto Ranging is OFF 1 ON Auto Ranging is ON To set the PIM Master for Auto Range SENSe PIManalyzer AUTorange 1 Amplitude Auto Range MW82119B PM PN 10580 00403 Rev C 4 25 4 7 SENSe Subsystem Chapter 4 PIM Analyzer Programming Commands SENSe PIManalyzer DTPMeas LRDTf STATe SENSe PIManalyzer DTPMeas LRDTf STATe Title Description Parameter Example Front Panel Access PIM Master Low Resolution DTF Sweep State Sets and queries whether a Low Resolution DTF sweep is performed during a Distance To PIM measurement ON OFF To enable the Low Resolution DTF sweep SENSe PIManalyzer DTPMeas LRDTf ON To query whether the Low Resolution DTF sweep is enabled PIM DTPM LRDT Setup Low Resolution DTF SENSe PIManalyzer DTPMeas LRDTf STARt Title Description Parameter Example Related Command Front Panel Access PIM Master Low Resolution DTF Sweep Start Frequency Queries the DTF Sweep Start Frequency in Hz Frequency in Hz To get the DTF Sweep Start Frequency PIM DTPM LRDT STAR SENSe PIManalyzer DTPMeas LRDTf STOP PIM DTPM LRDT STOP NA SENSe PIManalyzer DTPMeas LRDT STOP Title Description Parameter
139. zer Programming Commands 4 2 CALCulate Subsystem CALCulate LIMit FAIL Title Description Parameter Default Value Example Front Panel Access Upper Limit Fail Check Checks if current trace data is failing Upper Limit dBm setting If one or more trace points fail then the condition would indicate fail for a response 0 1 for Pass Fail None To query if the current trace data is failing Upper Limit dBm setting CALC LIM FAIL NA no direct access Adjusting Limit Amplitude shows a number display change to red when the limit line falls below the highest trace data point CALCulate LIMit STATe OFF ON 0 1 CALCulate LIMit STATe Title Description Parameter Parameter Type Default Value Example Front Panel Access Limit State Turns the limit line ON or OFF If the value is set to ON or to 1 then the currently selected limit line is ON If the value is set to OFF or to 0 then the currently selected limit line is OFF The query version of the command returns a 1 if the currently selected limit line is ON and returns a 0 if it is OFF OFF ON 0 1 lt boolean gt OFF To turn on the limit line CALCulate LIMit ON CALCulate LIMit STATe ON CALCulate LIMit STATe 1 To turn off the limit line CALCulate LIMit OFF CALCulate LIMit STATe 0 CALCulate LIMit 0 To query the limit line state CALCul LIM CALC LIM STAT Shift Limit 6 Limit On Off MW82119B

Download Pdf Manuals

image

Related Search

Related Contents

Fortinet 400 Network Card User Manual  Un Débat exemplaire - Recherches  BAR H - Electrocomponents  Le téléphone portable, gadget de destruction massive  

Copyright © All rights reserved.
Failed to retrieve file