Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide
Notices © Agilent Technologies, Inc. 2012 Warranty Technology Licenses No part of this manual may be reproduced in any form or by any means (including electronic storage and retrieval or translation into a foreign language) without prior agreement and written consent from Agilent Technologies, Inc. as governed by United States and international copyright laws. The material contained in this document is provided “as is,” and is subject to being changed, without notice, in future editions.
In This Guide… This guide contains programming information for the N9342C/43C/44C Handheld Spectrum Analyzer. 1 Getting Started Prepare for the remote control. 2 Programming Fundamentals A quick overview of the SCPI programming. 3 Status Registers Introduction of the status registers. 4 Programming Example How to accomplish the basic applications in programming. 5 Command Reference Describe every programming command ant the related softkeys’ functions in detail.
Programmer’s Guide
Contents 1 Getting Started 1 Remotely Operating the Analyzer 2 Computer Requirement for Remote Operation 2 Connecting the Analyzer via the USB Port 3 Connecting the Analyzer via the LAN Port 6 2 Programming Fundamentals Overview 9 10 Command Categories Command Syntax 12 13 Creating Valid Commands 15 Program and Response Messages Parameters in Commands 3 Status Registers Overview 17 19 20 How to use the Status Registers 4 Status Register System 25 Programming Example 31 Overview 16 2
Contents 5 Command Reference 49 IEEE Common Commands System Subsystem 50 54 Memory Subsystem 66 Instrument Subsystem 70 Sense Subsystem 72 Frequency Subsection 72 Amplitude Subsection 76 Bandwidth Subsection 81 Trace Subsection 83 Detector Subsection 85 Average Subsection 86 Sweep Subsection 87 Display Subsection 90 Calculate Subsystem 91 Limit Line Subsection 91 Marker Subsection 95 Initiate Subsystem 102 Trigger Subsystem 104 Power Measurement Subsystem ACPR Subsection 108 CHP Subsection 11
Contents AM Demodulation Subsection FM Demodulation Subsection ASK Demodulation Subsection FSK Demodulation Subsection Power Meter Option Subsystem 168 175 182 191 201 Tracking Generator Option Subsystem Programmer’s Guide 214
Contents Programmer’s Guide
Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide 1 Getting Started The purpose of this chapter is to serve as a reminder of SCPI (Standard Commands for Programmable Instruments) fundamentals to those who have previous experience in programming SCPI. This chapter is not intended to teach you everything about the SCPI programming language. If you are using an optional programming compatibility modes, you should refer to the manual that came with the option.
1 Getting Started Remotely Operating the Analyzer The analyzer provides both the USB and LAN connection which allows you to set up a remote operation environment with a controller computer. A controller computer could be a personal computer (PC), a minicomputer. Some intelligent instruments also function as controllers.
Getting Started 1 Connecting the Analyzer via the USB Port No extra driver is required to connect the analyzer via the USB port to a PC. All you need is the Agilent IO libraries suite and you can find this IO libraries suite in the documentation CD in the shipment along with your analyzer. Or download the IO libraries suite from Agilent website: http://www.agilent.
1 4 Getting Started 4 After a while, the PC finds your analyzer as a new hardware and prompts a message saying “Found new hardware...”. A Found New Hardware Wizard is initiated immediately. 5 Select Display a list...
Getting Started 7 1 PC will detect the instrument automatically. The item “USB Test and Measurement Device” displays in the pop-up window. Select it and press Next. The wizard will guide you through the rest of installation till the driver is installed. Run Agilent IO libraries suite, the analyzer will be detected automatically.
1 Getting Started Connecting the Analyzer via the LAN Port No extra driver is required to connect the analyzer via the LAN port to a PC. All you need is the Agilent IO libraries suite in the Product CD Help Kit. Or refer to the link below to download the IO libraries suite: http://www.agilent.com/find/iolib Please refer to the following steps to finish the connection: 6 1 Switch on the analyzer. 2 Connect the spectrum analyzer to a PC with a LAN cable.
Getting Started Programmer’s Guide 6 Press “Test Connection” to check the LAN connection. The figure below indicates that the connection is ready. 7 Check “*IDN query” and press “Identify Instrument”. The instrument information shows the firmware revision and product number. The analyzer is ready for your further programming.
1 8 Getting Started Programmer’s Guide
Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide 2 Programming Fundamentals Overview 10 Command Categories Command Syntax 12 13 Creating Valid Commands 15 Program and Response Messages Parameters in Commands 16 17 The purpose of this chapter is to serve as a reminder of SCPI (Standard Commands for Programmable Instruments) fundamentals to those who have previous experience in programming SCPI.
2 Programming Fundamentals Overview This section is not intended to teach you everything about the SCPI (Standard Commands for Programmable Instruments) programming language. The SCPI Consortium or IEEE provides that level of detailed information. Programming with SCPI requires knowledge of: • Computer programming languages, such as C, C++, and MicrosoftVisual Basic. • The language of your instrument. The analyzer employs SCPI as its programming language.
Programming Fundamentals 2 Common Terms used in this Book Terms Description Controller Any computer used to communicate with an instrument. A controller can be a personal computer (PC), a minicomputer, or a plug-in card in a card cage. Some intelligent instruments can also function as controllers. Instrument Any device that implements SCPI. Most instruments are electronic measurement or stimulus devices, but this is not a requirement.
2 Programming Fundamentals Command Categories The SCPI command falls into two categories: • Subsystem commands that simulate front panel keystrokes • Common commands that are unique and have no front panel equivalent Use a computer to control the instrument (but operate the power/standby switch manually). Computer programming procedures for the instrument involve selecting a programming statement and then adding the specified programming codes to that statement to achieve the desired operating conditions.
Programming Fundamentals 2 Command Syntax A command consists of mnemonics (keywords), parameters and punctuation. Before you start to program your signal generator, familiarize yourself with the standard notation of each of them. Command Mnemonics (keywords) Many commands have both a long and a short form: use either one. (a combination of the two is not allowed).
2 Programming Fundamentals Command Statement Rules Overview Besides the standard notation of SCPI described above, please remember the following rules in programming: • command statements read from left to right • use either long form or short form of keywords, but do not use both • no separating space between the keywords, only use a colon to separate keywords of different levels • always separating a keyword from a variable with a space • always separating a variable from its unit with a space (
Programming Fundamentals 2 Creating Valid Commands Commands are not case sensitive and there are often many different ways of writing a particular command. These are examples of valid commands for a given command syntax: Command Syntax Sample Valid Commands [:SENSe]:BANDwidth[:RESolution] The following sample commands are all identical. They will all cause the same result. :Sense:Band:Res 1700 :BANDWIDTH:RESOLUTION 1.7e3 :sens:band 1.7KHZ :SENS:band 1.7E3Hz :band 1.7kHz :bandwidth:RES 1.
2 Programming Fundamentals Program and Response Messages To understand how your instrument and controller communicate using SCPI, you must understand the concepts of program and response messages. Program Messages Program messages are the formatted data sent from the controller to the instrument. Conversely, response messages are formatted data sent from the instrument to the controller. Program messages contain one or more commands, and response messages contain one or more responses.
Programming Fundamentals 2 Parameters in Commands There are four basic types of parameters: boolean, key words, variables and arbitrary block program data. Boolean The expression OFF|ON|0|1 is a two state boolean-type parameter. The numeric value 0 is equivalent to OFF. Any numeric value other than 0 is equivalent to ON. The numeric values of 0 or 1 are commonly used in the command instead of OFF or ON, and queries of the parameter always return a numeric value of 0 or 1.
2 Programming Fundamentals Variable Parameters , The (amplitude) parameter and the (relative amplitude) parameter consist of a rational number followed by optional units. Acceptable units for include: V, mV, V, dBm, dBmV, dBuV, Watts, W. units are given in dB. A file name parameter is the name of your file, is not used in the SCPI command string. There are no units associated with an integer parameter.
Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide 3 Status Registers Overview 20 How to use the Status Registers Status Register System 23 25 This chapter contains a comprehensive description of status registers explaining what status registers are and how to use them so you can use a program to monitor the instrument. Information about all of the bits of the status registers is also provided.
3 Status Registers Overview When you are programming the instrument you may need to monitor instrument status to check for error conditions or monitor changes. You need to determine the state of certain instrument events/conditions by programming the status register system. IEEE common commands (those beginning with *) access the higher-level summary registers. To access the information from specific registers you would use the STATus commands.
Status Registers Event Register Event Enable Register 3 It latches any signal state changes, in the way specified by the filter registers. Bits in the event register are never cleared by signal state changes. Event registers are cleared when read. They are also cleared by *CLS and by presetting the instrument. It controls which of the bits, being set in the event register, will be summarized as a single output for the register set. Summary bits are then used by the next higher register.
3 Status Registers What are Status Register SCPI Commands Most monitoring of the instrument conditions is done at the highest level using the IEEE common commands indicated below. Complete command descriptions are available in the IEEE commands section at the beginning of the language reference. Individual status registers can be set and queried using the commands in the STATus subsystem of the language reference.
Status Registers 3 How to use the Status Registers A program often needs to detect and manage error conditions or changes in instrument status. The polling method for you to programmatically access the information in status registers. In the polling method, the instrument has a passive role. It only tells the controller that conditions have changed when the controller asks the right question. In the SRQ method, the instrument takes a more active role.
3 Status Registers — The transition registers are preset to register if the condition goes from 0 to 1 (false to true, or a positive transition). — This can be changed so the selected condition is detected if the bit goes from 1 to 0 (true to false, or a negative transition). — It can also be set for both types of transitions occurring. — Or it can be set for neither transition.
Status Registers 3 Status Register System The hardware status registers are combined to form the instrument status system. Specific status bits are assigned to monitor various aspects of the instrument operation and status. See the following diagram of the status system for information about the bit assignments and status register interconnections. Figure 1 Agilent N9342C/43C/44C Status Register System Status Byte Register (*STB?) Unused Unused Query Error Dev. Dep.
3 Status Registers The Status Byte Register Status Byte Register 0 1 2 3 4 5 6 7 Unused Unused Error/Event Queue Summary Bit Unused Message Available (MAV) Standard Event Summary Bit Unused Operation Status Summary Bit & & & + & & & & 0 1 2 3 4 5 6 7 Service Request Enable Register The RQS bit is read and reset by a serial poll. The same bit position (MSS) is read, non-destructively by the *STB? command. If you serial poll bit 6 it is read as RQS, but if you send *STB it reads bit 6 as MSS.
Status Registers 3 The status byte register contains the following bits: Bit Description 0,1 Unused: These bits are always set to 0. 2 Error/Event Queue Summary Bit: A 1 in this bit position indicates that the SCPI error queue is not empty. The SCPI error queue contains at least one error message. 3 Questionable Status Summary Bit: A 1 in this bit position indicates that the questionable status summary bit has been set.
3 Status Registers Standard Event Status Register The standard event status register is used to determine the specific event that sets bit 5 in the status byte register. The standard event status register does not have negative and positive transition registers, nor a condition register. Use the IEEE common commands at the beginning of “Command Reference” on page 49 to access the register. To query the standard event status register, send the *ESR command.
Status Registers 3 The standard event status register contains following bits: Bit Description 0 Unused 1 Request Bus Control: This bit is always set to 0. (The analyzer does not request control.) 2 Query Error: A 1 in this bit position indicates that a query error has occurred. Query errors have SCPI error numbers from 499 to 400. 3 Device Dependent Error: A 1 in this bit position indicates that a device dependent error has occurred.
3 Status Registers command *ESE 192 (128 + 64). The command *ESE? returns the decimal value of the sum of the bits previously enabled with the *ESE command. The standard event status enable register presets to zeros (0).
Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide 4b Programming Example Overview 32 Programming in C using the VTL Checking USB Connection 33 39 Using C with Marker Peak Search and Peak Excursion Using Marker Delta Mode and Marker Minimum Search Measuring Phase Noise 40 44 48 This chapter provides some programming conventions and examples for your further reference.
4 Programming Example Overview The programming examples in this section keep to the following 3 conventions: • The programming examples were written for use on an compatible PC. • The programming examples use USB interface. • The programming examples are written in C programming language and SCPI programming commands, using Agilent VISA transition library (Agilent VTL). The Agilent VTL is installed when you installed the Agilent IO libraries suite.
Programming Example 4 Programming in C using the VTL This section includes some basic information about programming in the C language using Agilent VISA transition library (VTL). Note that some of this information may not be relevant to your particular application. For example, if you are not using VXI instruments, the VXI references will not be relevant. Typical Example Program Contents The following table summaries the VTL function calls used in the example programs. visa.
4 Programming Example viRead This function synchronously reads raw data from the session specified by the vi parameter and stores the result in location where buf is pointing. Only one synchronous read operation can occur at any one time. viRead(vi, buf, count, &retCount) viClose This function must be used to close each session. When you close a device session, all data structures that had been allocated for the session will be set free.
Programming Example 4 viScanf(viN9342C, "%t", &buf); /*Print results */ printf("Instrument identification string: %s\n", buf); /* Close the sessions */ viClose(viN9342C); viClose(defaultRM); } Including the VISA Declarations File For C and C++ programs, you must include the visa.h header file at the beginning of every file that contains VTL function calls: #include “visa.h” This header file contains the VISA function prototypes and the definitions for all VISA constants and error codes. The visa.
4 Programming Example • A device session is used to communicate with a device on an interface. A device session must be opened for each device you will be using. When you use a device session you can communicate without worrying about the type of interface to which it is connected. This insulation makes applications more robust and portable across interfaces. Typically a device is an instrument, but could be a computer, a plotter, or a printer.
Programming Example 4 Your program may have several sessions open at the same time by creating multiple session identifiers by calling the viOpen function multiple times. The following summarizes the parameters in the previous function calls: sesn This is a session returned from the viOpenDefaultRM function that identifies the resource manager session. rsrcName This is a unique symbolic name of the device (device address). accessMode This parameter is not used for VTL. Use VI_NULL.
4 Programming Example Addressing a Session As seen in the previous section, the rsrcName parameter in the viOpen function is used to identify a specific device. This parameter is made up of the VTL interface name and the device address. The interface name is determined when you run the VTL Configuration Utility. This name is usually the interface type followed by a number.
Programming Example 4 Checking the USB Connection Usually, using “*IDN?” verifies the data transferring between the controller PC and the instrument. **************************************************** #include "visa.h" #include #define BufferSize 128 static static static static static ViStatus status; ViSession defaultRM; ViSession inst_N9342C; ViUInt32 rcount; unsigned char buffer[BufferSize]; int main(void) { /* Connect N9342C and read its "IDN".
4 Programming Example Using C with Marker Peak Search and Peak Excursion /************************************************************/ /* Using Marker Peak Search and Peak Excursion */ /* */ /* This example is for the N9342C Handheld Spectrum Analyzer. */ /* */ /* This C programming example does the following. */ /* The SCPI instrument commands used are given as reference.
Programming Example #include #include #include #include #include #include 4 "visa.h" ViSession defaultRM, viN9342C; ViStatus errStatus; ViChar cIdBuff[256]= {0}; char cEnter = 0; int iResult = 0; /*Set the input port to 50MHz amplitude reference*/ void Route50MHzSignal() { viQueryf(viN9342C, "*IDN?\n", "%t", &cIdBuff); /* prompt the user*/ /* to connect the amplitude reference output to the input*/ printf ("Connect CAL OUT to the RF IN \n"); printf ("..
4 Programming Example /*Open a USB session.
Programming Example 4 /*Set the peak excursion*/ viPrintf(viN9342C,"CALC:MARK:PEAK:EXC %1fDB \n",fPeakExcursion); /*Set the peak thresold */ viPrintf(viN9342C,"CALC:MARK:PEAK:THR -90 \n"); /*Trigger a sweep and wait for completion*/ viPrintf(viN9342C,"INIT:IMM \n"); /*Set the marker to the maximum peak*/ viPrintf(viN9342C,"CALC:MARK:MAX \n"); /*Query and read the marker frequency*/ viQueryf(viN9342C,"CALC:MARK:X? \n","%lf",&dMarkerFreq); printf("\n\t RESULT: Marker Frequency is: %lf MHZ \n\ n",dMarkerFreq
4 Programming Example Using Marker Delta Mode and Marker Minimum Search /************************************************************/ /* Using Marker Delta Mode and Marker Minimum Search */ /* */ /* This example is for the N9342C Spectrum Analyzers */ /* */ /* This C programming example does the following. */ /* The SCPI instrument commands used are given as reference.
Programming Example #include #include #include #include #include #include 4 "visa.
4 Programming Example { /* Open an USB session*/ viStatus=viOpenDefaultRM(&defaultRM); viStatus=viOpen(defaultRM,"USB0::2391::8472::9876543210::0::INSTR",VI_NULL,V I_NULL,&viN9342C); if(viStatus) printf("Could not open a session to USB device!\n"); exit(0); } /*Clear the instrument*/ viClear(viN9342C); /*Reset the instrument*/ viPrintf(viN9342C,"*RST\n"); /*Display the program heading */ printf("\n\t\t Marker Delta Program \n\n" ); /*Check for the instrument model number and route the 50MHz signal accordi
Programming Example 4 /*Set the analyzer to the values given by the user*/ //viPrintf(viN9342C,"SENS:FREQ:STAR %lf //MHZ;:SENS:FREQ:STOP %lf MHZ\n",dStartFreq,dStopFreq); viPrintf(viN9342C,":SENS:FREQ:STAR %lf MHz\n",dStartFreq); viPrintf(viN9342C,":SENS:FREQ:STOP %lf MHZ\n",dStopFreq); /*Trigger a sweep, delay for completion*/ viPrintf(viN9342C,"INIT:IMM\n"); //delay(1); /*Set the marker to the maximum peak*/ viPrintf(viN9342C,"CALC:MARK:MAX\n"); /*Set the analyzer to activate delta marker mode*/ viPrint
4 48 Programming Example Programmer’s Guide
Agilent N9342C/43C/44C Handheld Spectrum Analyzer Programmer’s Guide 5 Command Reference IEEE Common Commands System Subsystem 54 Memory Subsystem 66 Instrument Subsystem Sense Subsystem Calculate Subsystem 50 70 72 91 Initiate Subsystem 102 Trigger Subsystem 104 Power Measurement Subsystem 108 Spectrum Monitor Option Subsystem 127 Cable and Antenna Test Option Subsystem Channel Scanner Option Subsystem Demodulation Option Subsystem Power Meter Option Subsystem 134 148 165 201 Tracking
5 Command Reference IEEE Common Commands The first few pages of this chapter contain common commands specified in IEEE Standard 488.2-1992, IEEE Standard Codes, Formats, Protocols and Common Commands for Use with ANSI/IEEE Std. 488.1-1987. New York, NY, 1992. Following these commands, the Agilent N9342C/43C/44C handheld spectrum analyzers SCPI commands are listed. Clear Status *CLS Clears the status byte register.
Command Reference 5 Standard Event Status Register Query *ESR? Queries and clears the standard event status event register. (This is a destructive read.) The value returned reflects the current state (0/1) of all the bits in the register. Range: Example: Integer, 0 to 255 *ESR? returns a 1 if there is either a query or command error, otherwise it returns a zero. Identification Query *IDN? Returns an instrument identification information string.
5 Command Reference Reset *RST This command presets the instrument to a factory defined condition that is appropriate for remote programming operation. *RST is equivalent to performing the two commands :SYSTem:PRESet and *CLS. This command always performs a factory preset. NOTE The preset performed by *RST is always a factory preset.
Command Reference 5 Self Test Query *TST? This query is used by some instruments for a self test. Range: Integer, 0 to 255 Wait-to-Continue *WAI This command causes the instrument to wait until all pending commands are completed before executing any additional commands. There is no query form to the command.
5 Command Reference System Subsystem This subsystem is used to set the controls and parameters associated with the overall system communication. These functions are not related to instrument performance. Screen Brightness Setting :SYSTem:SCReen:BRIGhtness :SYSTem:SCReen:BRIGhtness? This command sets the screen brightness of the instrument.
Command Reference 5 Set System Date :SYSTem:DATE <“yyyymmdd”> :SYSTem:DATE? Sets the system date of the real-time clock of the instrument. Year is a 4-digit integer. Month is an integer 1 to 12. Day is an integer 1 to 31 (depending on the month) Example: Key access: :SYSTem:DATE “20120912” Shift > System > Time/Date > Date System Time Zone Offset :SYSTem:TIME:ZONE :SYSTem:TIME:ZONE? Sets the time zone offset. The offset is set according to the Greenwich Mean Time.
5 Command Reference Enable Option :SYSTem:LKEY <"option">,<"license key"> Use this command to enable the specified option with the license key. Example: Key access: :SYSTem:LKEY "PA3","ABCDEFGH" Shift > System > More > Service > Add Option Disable Option :SYSTem:LKEY:DISable <"license key"> Use this command to disable the installed options.
Command Reference 5 Calibrate Time Base by GPS :SYSTem:CALibration:TBASe:GPS Use this command to calibrate the time base by GPS signal. This command is only available with option GPS installed. Key access: Shift > System > More > Service > Calibration > Time Base By GPS Query Time Base Calibration Result :SYSTem:CALibration:TBASe:FREQuency? Use this command to query the time base calibration result.
5 Command Reference Probe Power :SYSTem:PORT:PROBe OFF|ON|0|1 :SYSTem:PORT:PROBe? This command turns on/off the probe power port on the top panel. Key access: Shift > System > More > Port Setting > Probe Power IP Config Host Name :SYSTem:PORT:IP:HNAMe <"string"> :SYSTem:PORT:IP:HNAMe? Sets a host name for the analyzer in network. Key access: Shift > System > More > Port Setting > IP Admin > Sys Name IP Address :SYSTem:PORT:IP:ADDRess <“xxx.xxx.xxx.
Command Reference 5 Gateway Setting :SYSTem:PORT:IP:GWAY <“xxx.xxx.xxx.xxx”> :SYSTem:PORT:IP:GWAY? Sets the gateway for the analyzer in the network. The gateway will be fetched automatically if the IP assignment is set to DHCP. Example: Key access: :SYSTem:PORT:IP:GWAY "192.168.0.1" Shift > System > More > Port Setting > IP Admin > Gateway Subnet Mask :SYSTem:PORT:IP:SMASk <“xxx.xxx.xxx.xxx”> :SYSTem:PORT:IP:SMASk? Sets the subnet mask according to the PC network settings.
5 Command Reference System Preset :SYSTem:PRESet Use this command to preset the instrument. The preset type is based on the setting of Preset Type: DFT, User or Last. Key access: Preset Factory Default :SYSTem:FDEFault Set both the measure and setting parameters to factory preset parameters. Key access: Shift > System > More > Factory Default GPS State :SYSTem:CONGigure:GPS OFF|ON|0|1 :SYSTem:CONFigure:GPS? Use this command to turn on/off the built-in GPS in the analyzer.
Command Reference 5 GPS Information :SYSTem:GPSinfo? This query returns the GPS information. This command is only available with the option GPS installed. Key access: Shift > System > More > GPS > GPS Info On/Off Timed Power On :SYSTem:TIMed:PON:STATe OFF|ON|0|1 :SYSTem:TIMed:PON:STATe? Use this command turn on/off the timed power-on function. The analyzer will be turned on in a user-defined time.
5 Command Reference Time Power On Date :SYSTem:TIMed:PON:DATE <“YYYMMDD”> :SYSTem:TIMed:PON:DATE? Sets the power on date. This commmand is only available when the repeat mode is set to once. Example: Key access: :SYSTem:TIMed:PON:DATE “20120922” Shift > System > Pwr On/Off Preset > Time Pwr On > Date Timed Power Off State :SYSTem:TIMed:POFF:STATE OFF|ON|0|1 :SYSTem:TIMed:POFF:STATE? This command turns on/off timed power off status of instrument.
Command Reference 5 Time Power Off Date :SYSTem:TIMed:POFF:DATE <“YYYMMDD”> :SYSTem:TIMed:POFF:DATE? Sets the power off date. It’s available when repeat mode is set to once. Example: Key access: :SYSTem:TIMed:POFF:DATE “20120922” Shift > System > Pwr On/Off Preset > Time Pwr Off > Date Power On Type :SYSTem:PON:TYPE DFT|USER|LAST :SYSTem:PON:TYPE? Uses this command to preset the analyzer to default, user, or last state.
5 Command Reference DC Power In Type :SYSTem:CONFigure:DCPI STANDBY|PWRON :SYSTem:CONFigure:DCPI? This command toggles the DC power in type between standby and power on. When it is set to standby, the analyzer will be in standby mode after the power is plugged in. When it is set to power on, the analyzer will be in power on mode once the power is plugged in.
Command Reference 5 Speaker Volume Flag :SYSTem:SPEaker:STATe OFF|ON|0|1 :SYSTem:SPEaker:STATe? Use this command to turn on the speaker in the instrument. Example: :SYSTem:SPEaker:STATe? Hardware Message :SYSTem:CONFigure:HARDware? Use this command to query the hardware message of the instrument. Software Message :SYSTem:CONFigure:SOFTware? Use this command to query the software message of the instrument.
5 Command Reference Memory Subsystem The Memory subsystem provides access to mass storage devices such as internal or external disk drives. It is corresponding to the front panel file submenu. NOTE The catalog C:\ indicates the root directory of the internal memory of analyzer. The catalog E:\ indicates the root directory of the USB memory stick. Catalog the Selected Memory Location :MMEMory:CATalog? <“dir_path”> Lists all files in the specified path.
Command Reference 5 Move Data to File :MMEMory:DATA , :MMEMory:DATA? Loads into the memory location . The query returns the contents of the in the format of a definite length block. This command can be used for copying files out of the analyzer over the remote bus. Example: If want to load string “abcd” into file C:\ source.txt, use below command. :MMEM:DATA "C:\source.
5 Command Reference Store Peak Table to CSV File :MMEMory:STORe:PEAK To store the current peak table as a CSV file. The suffix of the file name must be *.csv. Example: Key access: :MMEMory:STORe:PEAK “C:\ABC.CSV” Shift > Peak > More > Peak Table > Export Table to CSV Create A New Directory :MMEMory:MDIRectory <“dir_path”> Use this command to create a new directory to the HSA internal memory or external USB memory.
Command Reference 5 Load Correction File :MMEMory:LOAD:CORRection ANTenna|CABLe|OTHer|USER, "oldname.cor" This command loads correction file saved on the instrument. Example: Key access: Programmer’s Guide :MMEMory:LOAD:CORRection ANTenn,"oldname.
5 Command Reference Instrument Subsystem The instrument subsystem includes commands selecting the instrument modes or power measurement mode. Instrument Mode Switch :INSTrument[:SELect] SA|TGENerator|MA|POWmeter|CAT :INSTrument[:SELect]? This command selects the instrument mode of HSA. All the instrument modes are under Mode list of HSA unit. SA - Spectrum Analyzer mode. TGENerator - Tracking Generator mode. MA - Modulation Analysis mode. POWmeter - Power Meter mode.
Command Reference 5 SEM - Spectrum Emission Mask CHScanner - Channel Scanner Example: Key access: Programmer’s Guide :INSTrument:MEASure CHPower MEAS 71
5 Command Reference Sense Subsystem The Sense Subsystem provides you the SCPI command reference for normal spectrum analyzer function. It is used to set the spectrum analyzer parameters such as frequency, span, attenuation and detector. Frequency Subsection Center Frequency [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer UP|DOWN [:SENSe]:FREQuency:CENTer? Set the center frequency of the spectrum analyzer. *RST: Example: Key access: 3.
Command Reference 5 Stop Frequency [:SENSe]:FREQuency:STOP [:SENSe]:FREQuency:STOP? Set the stop frequency of the spectrum analyzer. *RST: Default Unit: Example: Key access: 7.0 GHz Hz :FREQuency:STOP 3 GHZ Freq > Stop Freq Center Frequency Step [:SENSe]:FREQuency:CENTer:STEP[:INCRement] [:SENSe]:FREQuency:CENTer:STEP[:INCRement]? Specifies the center frequency step size.
5 Command Reference Frequency Offset [:SENSe]:FREQuency:OFFSet [:SENSe]:FREQuency:OFFSet? Sets the frequency offset. *RST: Example: Key access: 0.0 Hz :FREQuency:OFFSet 1 GHZ Freq > More > Freq Offset Center Frequency Step Size Automatic [:SENSe]:FREQuency:CENTer:STEP:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:STEP:AUTO? Specifies whether the step size is set automatically based on the span.
Command Reference 5 Full Frequency Span [:SENSe]:FREQuency:SPAN:FULL Set the frequency span to full scale. *RST: Example: Key access: 3.0 GHz :FREQuency:SPAN:FULL Span > Full Span Zero Span [:SENSe]:FREQuency:SPAN:ZERO Set the frequency span to zero span. Key access: Span > Zero Span Last Frequency Span [:SENSe]:FREQuency:SPAN:PREVious Set the frequency span to the previous span setting.
5 Command Reference Amplitude Subsection Reference level :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel: :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel? This command sets the reference level for the Y-axis. *RST: Range: Example: Key access: 0 dB –140.00 to +20.00 dBm :DISPlay:WINDow:TRACe:Y:RLEVel 10dBm Amptd > Ref Level Attenuation [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation? Set the input attenuator of the spectrum analyzer.
Command Reference 5 Input Port Preamplifer [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Turns the internal preamp on/off. *RST: Off Remarks: This command is only available when PA7 option is installed.
5 Command Reference Power Units of Measure ( Y Axis Unit ) :UNIT:POWer DBM|DBMV|DBMVEMF|DBUV|DBUVEMF|V|W|VEMF :UNIT:POWer? Specifies amplitude units for the input, output and display. *RST: Example: Key access: dBm in log amplitude scale Volts in linear amplitude scale :UNIT:POWer DBMV Amptd > Y Axis Unit Hi-Sensitive [:SENSe]:POWer[:RF]:HSENsitive[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:HSENsitive [:STATe]? Toggles the Hi-sensitive function between on and off.
Command Reference 5 Correction Apply State [:SENSe]:CORRection:CSET:ALL[:STATe] OFF|ON|0|1 [:SENSe]:CORRection:CSET:ALL[:STATe]? Turns On or Off the amplitude corrections. When turned On, only the correction sets that were turned on are enabled. When turned Off, all of the correction sets are disabled.
5 Command Reference Current Correction Select [:SENSe]:CORRection:SELect COR1|COR2|COR3|COR4 [:SENSe]:CORRection:SELect? Set current correction for load COR file onto proper CorrectionX. Example: :CORRection:SELect? Input Impedance selection [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude] OHM50|OHM75 [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]? Toggles the input impedance correction between 50 Ω and 75 Ω. in spectrum analyzer.
Command Reference 5 Bandwidth Subsection Resolution Bandwidth [:SENSe]:BANDwidth|BWIDth[:RESolution] [:SENSe]:BANDwidth|BWIDth[:RESolution]? Specifies the resolution bandwidth. For numeric entries, all RBW types choose the nearest (arithmetically, on a linear scale, rounding up) available RBW to the value entered.
5 Command Reference Auto Video Bandwidth State [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO? This command turns on/off auto video bandwidth state. *RST: Key access: On BW > VBW Auto/Man Video to Resolution Bandwidth Ratio [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio [:SENSe]:BANDwidth|BWIDth:VIDeo:RATio? Specifies the ratio of the video bandwidth to the resolution bandwidth. *RST: Range: Example: Key access: 1.0 0.00001 to 3.
Command Reference 5 Trace Subsection Select Trace Display Mode :TRACe1|2|3|4:MODE WRITe|MAXHold|MINHold|VIEW|BLANk :TRACe1|2|3|4:MODE? Selects the display mode for the selected trace. WRITe puts the trace in the normal mode, updating the data. MAXHold displays the highest measured trace value for all the data that has been measured since the function was turned on. MINHold displays the lowest measured trace value for all the data that has been measured since the function was turned on.
5 Command Reference Subtract Trace :TRACe:MATH:SUBTract ,, This command subtract the selected trace from the activated trace. Example: :TRAC:MATH:SUBT TRACE2,TRACE1,TRACE3 Query Trace Data :TRACe[:DATA]? TRACe1|TRACe2|TRACe3|TRACe4| This query command returns the current displayed data. Example: :TRACe:DATA? TRACE1 Trace Math By :TRACe:MATH:TYPE LOGPwr|POWer :TRACe:MATH:TYPE? This command toggles the trace math by log power and power.
Command Reference 5 Detector Subsection Type of Detection [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]NEGative|POSitive|SAMPle|AVERage|NORMAL [:SENSe]:DETector:TRACe[1]|2|3|4[:FUNCtion]? Specifies the detection mode. For each trace interval (bucket), average detection displays the average of all the samples within the interval. • Negative peak detection displays the lowest sample taken during the interval being displayed.
5 Command Reference Average Subsection Average Type [:SENSe]:AVERage:TYPE LOGPower|POWer|VOLTage [:SENSe]:AVERage:TYPE? Toggle the average type between Log power, power and voltage. Example: Key access: :AVERage:TYPE POW BW > Average Type Average Number On/Off [:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt [:SENSe]:AVERage:TRACe[1]|2|3|4:COUNt? Specifies the number of measurements that are combined.
Command Reference 5 Average Restart [:SENSe]:AVERage:TRACe[1]|2|3|4:CLEar Restarts the trace average. This command is only available when average is on. Example: Key access: :AVERage:TRACe1:CLEar Trace > More > Average Restart Sweep Subsection Sweep Time [:SENSe]:SWEep:TIME
5 Command Reference Sweep Mode [:SENSe]:SWEep:MODE AUTO|FFT|SWEep [:SENSe]:SWEep:MODE? Sets the sweep mode manually. *RST: Key access: AUTO Shift > Sweep > Sweep Setup > Sweep Type Gated Sweep State [:SENSe]:SWEep:EGATe[:STATe] OFF|ON|0|1 [:SENSe]:SWEep:EGATe[:STATe]? Use this command to turn on/off gated sweep mode.
Command Reference 5 Gate Delay [:SENSe]:SWEep:EGATe:DELay
5 Command Reference Display Subsection Graticule State :DISPlay:WINDow:TRACe:GRATicule:GRID[:STATe] OFF|ON|0|1 :DISPlay:WINDow:TRACe:GRATicule:GRID[:STATe]? This command toggles the graticule between on and off. Example: Key access: :DISPlay:WINDow:TRACe:GRATicule:GRID OFF Shift > Disp > Graticule On/Off Y Scale State :DISPlay:WINDow:TRACe:YSCale[:STATe] OFF|ON|0|1 :DISPlay:WINDow:TRACe:YSCale[:STATe]? This command toggles the Y Scale between on and off.
Command Reference 5 Calculate Subsystem This subsystem is used to perform post-acquisition data processing. In effect, the collection of new data triggers the CALCulate subsystem. In this instrument, the primary functions in this subsystem are markers and limits. Limit Line Subsection Limit lines can be defined for your measurement. You can then have the instrument compare the data to your defined limits and indicate a pass/fail condition.
5 Command Reference Limit Line Y-axis Value :CALCulate:LLINe[1]:Y :CALCulate:LLINe[1]:Y? Sets the Y-axis value of a limit line. Limit line Y-axis value is set independently and is not affected by the X-axis units. *RST: Example: Key access: 0 dBm :CALCulate:LLINe:Y -20dBm Shift > Limit> Limit 1 > Limit Line Limit Line X-axis Value :CALCulate:LLINe:CONTrol:DOMain FREQuency|TIME :CALCulate:LLINe:CONTrol:DOMain? Toggles the limit line X-axis value between frequency and time.
Command Reference 5 Limit Beep State :CALCulate:LLINe:CONTrol:BEEP OFF|ON|0|1 :CALCulate:LLINe:CONTrol:BEEP? Use this command to turn on/off the limit beep status. Example: Key access: :CALCulate:LLINe:CONTrol:BEEP ON Shift > Limit > X Axis Units Define Limits Values :CALCulate:LLINe[1]|2:DATA ,,{,,,} :CALCulate:LLINe[1]|2:DATA? Use this command to define the limits values.
5 Command Reference Set the limits Margin Value :CALCulate:LLINe[1]|2:MARGin :CALCulate:LLINe[1]|2:MARGin? Use this command to define the limits margin values. Example: :CALCulate:LLINe1:MARGin 20 Key access: Shift > Limit > Limit 1 > More > Margin Set Limits Margin State :CALCulate:LLINe[1]|2:MARGin:STATe OFF|ON|0|1 :CALCulate:LLINe[1]|2:MARGin:STATe? Use this command to turn on/off limit margin.
Command Reference 5 Marker Subsection Markers All Off on All Traces :CALCulate:MARKer:AOFF Turns off all markers on all the traces. Key access: Marker > All Off Continuous Peaking Marker :CALCulate:MARKer[1]|2|3|4|5|6:CPEak[:STATe] OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6:CPEak[:STATe]? Toggles the continuous peak search function between on and off.
5 Command Reference Marker Function :CALCulate:MARKer[1]|2|3|4|5|6:FUNCtion FCOunt|NOISe|OFF :CALCulate:MARKer[1]|2|3|4|5|6:FUNCtion? This command selects the marker function for the designated marker. COunt refers to the frequency counter function. NOISe refers to the noise measurement function. OFF refers to the normal function.
Command Reference 5 Marker Peak Left/Right Search :CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:LEFT :CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:RIGHt Places the selected marker on the next highest signal peak to the left/right of the current marked peak. Example: Key access: :CALCulate:MARKer1:MAXimum:LEFT Shift >Peak > Next Left\Right Peak Marker Mode :CALCulate:MARKer[1]|2|3|4|5|6:MODE POSition|DELTa|OFF :CALCulate:MARKer[1]|2|3|4|5|6:MODE? Selects the type of markers that you want to activate.
5 Command Reference Peak Search Type :CALCulate:MARKer:PEAK:SEARch:MODE MAXimum|MINimum :CALCulate:MARKer:PEAK:SEARch:MODE? Specifies the peak search type. When it is set to maximum, the places the selected marker on the highest point on the assigned trace. When it is set to minimum, the places the selected marker on the lowest point on the assigned trace.
Command Reference 5 Marker to Center :CALCulate:MARKer[1]|2|3|4|5|6[:SET]:CENTer This command sets the center frequency equal to the specified marker frequency, which moves the marker to the center of the screen. In delta marker mode, the center frequency is set to the marker delta value. This command is not available in zero span. This command is just available in Spectrum Analyzer and Tracking Generator mode.
5 Command Reference Marker On/Off :CALCulate:MARKer[1]|2|3|4|5|6:STATe OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6:STATe? This command toggles the selected marker status between on and off. Example: Key access: :CALCulate:MARKer1:STATe 0 Marker > Mode > Normal/Off Marker to Trace :CALCulate:MARKer[1]|2|3|4|5|6:TRACe :CALCulate:MARKer[1]|2|3|4|5|6:TRACe? This command assigns the specified marker to the designated trace 1, 2, 3 or 4.
Command Reference 5 Query Marker Readout: Y Value :CALCulate:MARKer[1]|2|3|4|5|6:Y? This command reads the current Y value for the designated marker or delta on its assigned trace. The value is in the Y-axis units for the current trace. This command can be used to read the results of marker functions such as and noise that are displayed in the marker value field on the analyzer.
5 Command Reference Initiate Subsystem The INITiate subsystem is used to control the initiation of the spectrum analyzer sweep operation. Continuous or Single Sweep :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Selects whether the sweep operation is continuously initiated or not. This command affects sweep if not in a measurement, and affects trigger when in a measurement.
Command Reference *RST: Key access: 5 Continuous Sweep > Sweep Single/Cont Initiate a Single Sweep :INITiate[:IMMediate] This command initiates a sweep if not in a measurement. If in a measurement, it triggers the measurement. Remarks: See also the *TRG command Use the :TRIGer[:SEQuence]:SOURce EXTernal command to select the external trigger. The analyzer must be in the single measurement mode. If :INITiate:CONTinuous is ON, the command is ignored.
5 Command Reference Trigger Subsystem The TRIGger subsystem is used to set the controls and parameters associated with triggering the data acquisitions. This subsystem is only valid when the analyzer is in zero span. Trigger Source :TRIGger[:SEQuence]:SOURce IMMediate|VIDeo|EXTernal|RFBurst :TRIGger[:SEQuence]:SOURce? Specifies the source (or type) of triggering used to start a measurement.
Command Reference 5 Video Trigger Level Amplitude :TRIGger[:SEQuence]:VIDeo:LEVel :TRIGger[:SEQuence]:VIDeo:LEVel? Specifies the level at which a video trigger will occur. Video is adjusted using this command, but must also be selected using the command :TRIGger[:SEQuence]:SOURce VIDeo.
5 Command Reference RF Burst Trigger Slope :TRIGger[:SEQuence]:RFBurst:SLOPe POSitive|NEGative :TRIGger[:SEQuence]:RFBurst:SLOPe? This command activates the trigger condition that allows the next sweep to start when the external RF signal (connected to RF IN connector) passes RF burst trigger level. Before you set the trigger slope, The external trigger source must be selected using the command :TRIGger[:SEQuence]:SOURce RF Burst.
Command Reference 5 Synchronization Source :TRIGger[:SEQuence]:FRAMe:SYNC OFF|EXTernal |RFBurst :TRIGger[:SEQuence]:FRAMe:SYNC? Specifies the source of period timer under gate sweep mode.
5 Command Reference Power Measurement Subsystem The Power Measurement Subsystem provides you the SCPI commands reference for the HSA built in one button power measurement function, such as Adjacent Channel Power Ratio ( ACPR ) , Channel Power ( CHP ) , Occupied Bandwidth ( OBW ) and Spectrum Emission Mask ( SEM ). Use the command :INSTrument:MEASure OFF|CHPower|ACPR|OBW|SPECtrogram|SEM|CHScanner to access different power measurement mode.
Command Reference 5 Adjacent Channel State [:SENSe]:ACPRatio:OFFSet:LIST:STATe OFF|ON|0|1,OFF|ON|0|1,OFF|ON|0|1,OFF|ON|0|1,OFF| ON|0|1,OFF|ON|0|1 [:SENSe]:ACPRatio:OFFSet:LIST:STATe? Specifies the range of integration used in calculating the power in the adjacent channel.
5 Command Reference Channel Space [:SENSe]:ACPRatio:OFFSet:LIST[FREQuency] ,,,, [:SENSe]:ACPRatio:OFFSet:LIST[FREQuency]? Sets the space value between the center frequency of main channel power and that of the adjacent channel power.
Command Reference 5 Query Upper Adjacent Channel Power Ratio :MEASure:ACPRatio:UPPer? Return the upper adjacent channel power to main channel power ratio. ACPR RRC Filter State [:SENSe]:ACPRatio:RRC[:STATe] OFF|ON|0|1 [:SENSe]:ACPRatio:RRC[:STATe]? Use this command to turn on/off the RRC filter. Example: Key access: :ACPRatio:RRC 1 Meas > RRC filter > On/Off ACPR RRC Filter Alpha Value [:SENSe]:ACPRatio:RRC:ALPHa [:SENSe]:ACPRatio:RRC:ALPHa? Use this command to set the alpha value of RRC filter.
5 Command Reference Integration BW [:SENSe]:CHPower:BWIDth|BANDwidth:INTegration [:SENSe]:CHPower:BWIDth|BANDwidth:INTegration? Specifies the integration bandwidth to calculate the power. Example: Key access: :CHPower:BWIDth:INTegration 40 MHz Meas > Integrated BW Channel Span [:SENSe]:CHPower:FREQuency:SPAN [:SENSe]:CHPower:FREQuency:SPAN? Sets the analyzer span for the channel power measurement. Be sure the span is set between 1 and 10 times the integration bandwidth.
Command Reference 5 Channel Power Auto Range [:SENSe]:CHPower:METer:RANGe:AUTO OFF|ON|0|1 [:SENSe]:CHPower:METer:RANGe:AUTO? Toggles the channel power auto range between on and off. It’s only available when the display mode is set to Meter. *RST: Example: Key access: ON :CHPower:METer:RANGe:AUTO 0 Meas > Disp Range > Auto Range Channel Power Range Top [:SENSe]:CHPower:METer:RANGe:TOP [:SENSe]:CHPower:METer:RANGe:TOP? Set the top amplitude range of the channel power measurement.
5 Command Reference Query Channel Power and Density Result :MEASure:CHPower? This command returns scalar results of main channel power, and power density. :MEASure:CHPower:CHPower? This command returns the value of the channel power in amplitude units. :MEASure:CHPower:DENSity? This command returns the value of the channel power density in amplitude units/Hz.
Command Reference 5 Channel Power RRC Filter Bandwidth [:SENSe]:CHPower:RRC:BW [:SENSe]:CHPower:RRC:BW? Use this command to set the bandwidth of RRC filter in channel power test. Example: Key access: :CHPower:RRC:BW 2 MHZ Meas > More > Filter BW OBW Subsection Select the measurement method of OBW [:SENSe]:OBW:METHod PERCent|DBC [:SENSe]:OBW:METHod? This command toggles the method of OBW measurement between percent and dBc.
5 Command Reference Set dBc method of OBW [:SENSe]:OBWidth:XDB [:SENSe]:OBWidth:XDB? specify the power level used to determine the emission bandwidth as the number of dB down from the highest signal point, within the occupied bandwidth span. *RST: Range: Example: Key access: 26 0.10 to 100 :OBWidth:XDB 4 Meas > Occupied BW > dBc OBW Span [:SENSe]:OBWidth:FREQuency:SPAN [:SENSe]:OBWidth:FREQuency:SPAN? Use this command to set the span in OBW test.
Command Reference 5 Query OBW Result :MEASure:OBW:OBW? :FETCh:OBW:OBW? Use this command to query the occupied bandwidth according to the method you set. Query Centroid Result :MEASure:OBW:CENTroid? :FETCh:OBW:CENTroid? Use this command to query the occupied bandwidth according to the method you set. SEM Subsection SEM Average Number [:SENSe]:SEMask:AVERage:COUNt [:SENSe]:SEMask:AVERage:COUNt? Specifies average number in SEM measurement.
5 Command Reference SEM Channel Integrate Bandwidth [:SENSe]:SEMask:BANDwidth|BWIDth:INTegration [:SENSe]:SEMask:BANDwidth|BWIDth:INTegration? Use this command to specify reference channel integrate bandwidth in SEM measurement.
Command Reference 5 SEM Channel Span [:SENSe]:SEMask:FREQuency:SPAN [:SENSe]:SEMask:FREQuency:SPAN? Use this command to specify reference channel span in SEM measurement. Example: :SEMask:FREQuency:SPAN 20MHz Key access: Meas > SEM > Ref Channel > Chan Span SEM Center Frequency [:SENSe]:SEMask:FREQuency:CENTer [:SENSe]:SEMask:FREQuency:CENTer? Use this command to set center frequency in SEM measurement.
5 Command Reference Query SEM Marker Y Value [:SENSe]:SEMask:MARKer[1]|2|3|4|5|6:Y? Use this command to query the marker readout of Y axis in SEM measurement. Example: :SEMask:MARKer1:Y? SEM Marker All Off [:SENSe]:SEMask:MARKer:AOFF Use this command to turn off all the marker in SEM measurement.
Command Reference 5 SEM Offset Measurement Bandwidth [:SENSe]:SEMask:OFFSet:LIST:BANDwidth|BWIDth:MEASure , , , , [:SENSe]:SEMask:OFFSet:LIST:BANDwidth|BWIDth:MEASure? Use this command to set the measurement bandwidth of offset channel in SEM measurement.
5 Command Reference SEM Offset Sweep Time [:SENSe]:SEMask:OFFSet:LIST:SWEeptime
Command Reference 5 SEM Offset Rel StartAmpt [:SENSe]:SEMask:OFFSet:LIST:STARt:RCARrier ,,,, [:SENSe]:SEMask:OFFSet:LIST:STARt:RCARrier? Use this command to specify the start frequency amplitude of offset channel relative limit mask in SEM measurement. Before use this command, the fail mask type should be set to “Relative” or “Abs AND Rel” or “Abs OR Rel”.
5 Command Reference SEM Offset Fail Mask [:SENSe]:SEMask:OFFSet:LIST:TEST ABSolute|RELative|AND|OR,ABSolute|RELative|AND|OR,ABSolute|RELative|AND|OR,ABSolute|RELative|AND|OR,AB Solute|RELative|AND|OR [:SENSe]:SEMask:OFFSet:LIST:TEST? Use this command to choose the mask type in SEM measurement.
Command Reference 5 Query SEM Lower Offset Peak Frequency [:SENSe]:SEMask:OFFSet:LIST:LOWer:PEAK:FREQuency? Use this command to query the peak power frequency of each lower offset channel in SEM measurement. Example: :SEMask:OFFSet:LIST:LOWer:PEAK:FREQuency? Query SEM Upper Offset Fail Flag [:SENSe]:SEMask:OFFSet:LIST:Upper:FAIL? Use this command to query fail flag of each upper offset channel in SEM measurement.
5 Command Reference SEM Fail Setting Hold [:SENSe]:SEMask:FAIL:LOG OFF|ON|0|1 [:SENSe]:SEMask:FAIL:LOG? Use this command to switch the Fail log status of SEM measurement. Example: Key access: :SEMask:FAIL:LOG ON Meas > SEM > Fail Setting > Log SEM Fail Setting Hold [:SENSe]:SEMask:FAIL:HOLD OFF|ON|0|1 [:SENSe]:SEMask:FAIL:HOLD? Use this command to switch the Fail hold status of SEM measurement.
Command Reference 5 Spectrum Monitor Option Subsystem The spectrum monitor subsystem provides you the SCPI commands reference for the spectrum monitor function. Use the command :INSTrument SA, and:INSTrument:MEASure SPECtrogram to access this subsystem. Option SIM is required to enable this function. Spectrogram State [:SENSe]:SPECtrogram:STATe RUN|PAUSe [:SENSe]:SPECtrogram:STATe? Use this command to run or pause spectrogram measurement.
5 Command Reference Spectrogram Palette [:SENSe]:SPECtrogram:PALette FCOLor|GRAY [:SENSe]:SPECtrogram:PALette? This command switches the display palette between Color and Gray. Example: Key access: :SPECtrogram:PALette GRAY Meas > Palette > Color /Gray Spectrogram Display Mode [:SENSe]:SPECtrogram:DMODe SPCTrg|TRACe|BOTH [:SENSe]:SPECtrogram:DMODe? Use this command to switch the spectrogram display mode between Spectrogram, Trace and both display.
Command Reference 5 Spectrogram Marker Time [:SENSe]:SPECtrogram:MARKer[1]|2:TIME [:SENSe]:SPECtrogram:MARKer[1]|2:TIME? Use this command to locate the marker to specific time point in spectrogram measurement. Example: Key access: :SPECtrogram:MARKer1:TIME 1 ks Marker > Time Spectrogram Marker Peak Search [:SENSe]:SPECtrogram:MARKer[1]|2:PEAK Use this command to perform Marker peak search once.
5 Command Reference Spectrogram Marker Band Power State [:SENSe]:SPECtrogram:MARKer:BPOWer:STATe OFF|ON|0|1 [:SENSe]:SPECtrogram:MARKer:BPOWer:STATe? Use this command to turn on/off the band power test of the two Markers in spectrogram measurement. Example: Key access: :SPECtrogram:MARKer:BPOWer:STATe ON Marker > More 1 of 2 > Band Power Spectrogram Marker Band Power Value [:SENSe]:SPECtrogram:MARKer:BPOWer? Use this command to query the Marker band power measurement result.
Command Reference 5 Spectrogram Marker Audio Alert Limit [:SENSe]:SPECtrogram:MARKer:ALERt:LIMit [:SENSe]:SPECtrogram:MARKer:ALERt:LIMit? Use this command to set the Marker audio alert limit line value. Example: Key access: :SPECtrogram:MARKer:ALERt:LIMit -50 dBm Marker > More 1 of 2 > Audio Alert Spectrogram Start Save [:SENSe]:SPECtrogram:SAVE:STARt [:SENSe]:SPECtrogram:SAVE[:STATe]? Use this command to start to save the spectrogram measurement result.
5 Command Reference Spectrogram Save Start Date [:SENSe]:SPECtrogram:SAVE:TIMed:STARt:DATE <“str”> [:SENSe]:SPECtrogram:SAVE:TIMed:STARt:DATE? Use this command to set the start date of timed save operation. Example: Key access: :SPECtrogram:SAVE:TIMed:STARt:DATE "20121016" Meas > File Logging > Time Setting > Start Date Spectrogram Save Start Time [:SENSe]:SPECtrogram:SAVE:TIMed:STARt:TIME <“str”> [:SENSe]:SPECtrogram:SAVE:TIMed:STARt:TIME? Use this command to set the start time of timed save operation.
Command Reference 5 Spectrogram Save File Type [:SENSe]:SPECtrogram:SAVE:FTYPe TRC|CSV [:SENSe]:SPECtrogram:SAVE:FTYPe? Use this command to switch the spectrogram test result type between TRC and CSV. Example: Key access: :SPECtrogram:SAVE:FTYPe TRC Meas > File Logging > File Type Spectrogram Save File Size [:SENSe]:SPECtrogram:SAVE:FSIZe [:SENSe]:SPECtrogram:SAVE:FSIZe? Use this command to set the maximum number of trace (frame) saved in one spectrogram test result file.
5 Command Reference Cable and Antenna Test Option Subsystem The Cable and Antenna Test Option Subsystem provides you the SCPI command reference for the cable and antenna test function. Use the command :INSTrument CAT to access this subsystem. Option CA7 or CAU is required to enable this function. Below use the shorthand of CAT as Cable and Antenna Test.
Command Reference 5 CAT IIM State [:SENSe]:CAT:IIM[:STATe] OFF|ON|0|1 [:SENSe]:CAT:IIM[:STATe]? Use this command to turn on/off IIM state for cable and antenna measurement. Example: Key access: :CAT:IIM ON Meas > IIM CAT Display Type [:SENSe]:CAT:DISPlay:TYPE RL|VSWR|LIN [:SENSe]:CAT:DISPlay:TYPE? Toggles the cable and antenna display mode between RL, VSWR and LIN. The RL stands for Return Loss, and LIN stands for Reflection Coefficient.
5 Command Reference CAT Select A Cable [:SENSe]:CAT:CABLe:LOAD Use this command to select a cable from built-in cable list. Example: Key access: :CAT:CABLe:LOAD "5088" Meas > More 1 of 2 > Cable Specification > Select Cable CAT Cable Attenuation [:SENSe]:CAT:CABLe:ATTenuation [:SENSe]:CAT:CABLe:ATTenuation? This command defines the attenuation value for a custom cable. Range: Example: Key access: 0 to 5 dB/m, or 0 to 1.524 dB/ft :CAT:CABLe:ATTenuation 1.
Command Reference 5 CAT Windows Select [:SENSe]:CAT:WINDow NONE|RECTangular|HAMMing|S3BLackman|S4BLackman [:SENSe]:CAT:WINDow? This command toggles the measurement window between Rectangular Window, Hamming Window, 3-Sample Blackman Window and 4-Sample Blackman Window.
5 Command Reference CAT Center Frequency [:SENSe]:CAT:FREQuency:CENTer [:SENSe]:CAT:FREQuency:CENTer? This command defines center frequency of cable and antenna measurement. Range: Example: Key access: 5 MHz to 7 GHz :CAT:FREQuency:CENTer 200 MHz Freq > Center Freq CAT Frequency Span [:SENSe]:CAT:FREQuency:SPAN [:SENSe]:CAT:FREQuency:SPAN? This command defines the frequency span of current measurement.
Command Reference 5 CAT Distance Unit [:SENSe]:CAT:DISTance:UNIT METers|FEET [:SENSe]:CAT:DISTance:UNIT? Use this command to toggle the distance unit between meter and feet. Example: Key access: :CAT:DISTance:UNIT FEET Meas > Unit > Meter/Feet CAT DTF Frequency Domain State [:SENSe]:CAT:DTF:FVIew OFF|ON|0|1 [:SENSe]:CAT:DTF:FVIew? Use this command to turn on/off frequency domain display in distance to fault measurement mode.
5 Command Reference CAT Amplitude Scale Per Division [:SENSe]:CAT:SCALe:DIV [:SENSe]:CAT:SCALe:DIV? This command defines the amplitude display scale per division. Range: Example: Key access: 0.1 to 10 :CAT:SCALe:DIV 5 Meas > Start Distance CAT Save Trace Data to Memory [:SENSe]:CAT:TRACe:SAVE Use this command to save the current trace data to memory.
Command Reference 5 CAT Trace Math Type [:SENSe]:CAT:TRACe:MATH OFF|ADD|SUB|DIV [:SENSe]:CAT:TRACe:MATH? This command toggles the trace math type of cable and antenna measurement. CAT option support three trace type, measurement trace data plus memory saved trace data, immurement trace data minus memory saved trace data, and memory saved data minus measurement trace data.
5 Command Reference CAT Trace Data Query :TRACe[:DATA]? DATA|MEM Use this command to query the current trace data. Example: :TRACe? DATA CAT Sweep Continuos State :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Use this command to turn on/off continuos sweep state of CAT test. Example: Key access: :INITiate:CONTinuous 1 Shift > Sweep> Sweep > Single / Cont CAT Single Sweep :INITiate[:IMMediate] Use this command to perform single sweep once.
Command Reference 5 CAT Marker Continuous Peak State :CALCulate:MARKer[1]|2|3|4|5|6:CPEak OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6:CPEak? This command turns on/off marker continuous peak state in cable and antenna measurement mode.
5 Command Reference CAT Query Reference Marker X axis Value :CALCulate:MARKer[1]|2|3|4|5|6:RX? This command query current reference marker X axis value. Example: :CALCulate:MARKer1:RX? CAT Query Reference Marker Y axis Value :CALCulate:MARKer[1]|2|3|4|5|6:RY? This command query current reference marker Y axis value. Example: :CALCulate:MARKer1:RY? CAT Marker Peak Search :CALCulate:MARKer[1]|2|3|4|5|6:PEAK Use this command to perform marker peak search once.
Command Reference 5 CAT Limit Type :CALCulate:LLINe[1]|2:TYPE UPPer|LOWer :CALCulate:LLINe[1]|2:TYPE? This command toggles the limit type between upper limit and lower limit. Example: Key access: :CALCulate:LLINe:TYPE UPPer Shift > Limit > Limit1 > Type CAT Limit Line State :CALCulate:LLINe[1]|2:STATe OFF|ON|0|1 :CALCulate:LLINe[1]|2:STATe? This command turns on/off the limit line in CAT test.
5 Command Reference CAT Get Limits Result :CALCulate:LLINe[1]|2:FAIL? This command query the result of limit line or limit in cable and antenna measurement mode. Example: :CALCulate:LLINe1:FAIL? CAT Define Limit Value :CALCulate:LLINe[1]|2:DATA ,,{,,,} :CALCulate:LLINe[1]|2:DATA? This command defines the limit value in cable and antenna measurement mode.
Command Reference 5 CAT Define Limit Value :CALCulate:LLINe[1]|2:DATA ,,{,,,} :CALCulate:LLINe[1]|2:DATA? This command defines the limit value in cable and antenna measurement mode.
5 Command Reference Channel Scanner Option Subsystem The Channel Scanner Option Subsystem provides you the SCPI command reference for the channel scanner function. Use the command :INSTrument SA, and command :INSTrument:MEASure CHScanner to access this subsystem. Option SCN is required to enable the channel scanner function.
Command Reference 5 Bottom N Number :CHSCanner:SWEep:BOTTom :CHSCanner:SWEep:BOTTom? This command specify the scanner channel number of Bottom N mode. Need to switch to Bottom N sweep mode before using this command. Range: Example: Key access: 1 to 20 :CHSCanner:SWEep:BOTTom 10 Meas > Channel Scanner > Scan Mode > Bottom N Max Hold State :CHSCanner:SWEep:MAXHold[:STATe] OFF|ON|0|1 :CHSCanner:SWEep:MAXHold[:STATe]? Use this command to turn on/off the trace max hold state.
5 Command Reference Min Hold Dwell Time :CHSCanner:SWEep:MINHold:DWELltime :CHSCanner:SWEep:MINHold:DWELltime? Use this command to define the min hold dwell time of channel scanner measurement mode. Example: Key access: :CHSCanner:SWEep:MINHold:DWELltime 10s Trace > Min Hold Average State :CHSCanner:SWEep:AVERage[:STATe] OFF|ON|0|1 :CHSCanner:SWEep:AVERage[:STATe]? Use this command to turn on/off average state in channel scanner mode. It’s only available for List sweep mode.
Command Reference 5 Measurement Interval State :CHSCanner:SWEep:INTerval[:STATe] OFF|ON|0|1 :CHSCanner:SWEep:INTerval [:STATe]? Use this command to turn on/off measurement interval state. Example: Key access: :CHSCanner:SWEep:INTerval ON Meas > Setup > Meas Interval Measurement Interval Type :CHSCanner:SWEep:INTerval:TYPE TIME|DISTance :CHSCanner:SWEep:INTerval:TYPE? This command toggles the interval type between time and distance. The distance interval type is only available when the GPS is on.
5 Command Reference Top N/Bottom N Measurement Rule :CHSCanner:SWEep:TOPBottom:RULE:MEASure SPEed|ACCUracy :CHSCanner:SWEep:TOPBottom:RULE:MEASure? Use this command to toggle the top/bottom N measurement rule between speed and accuracy.
Command Reference 5 Bottom Cycle :CHSCanner:SWEep:BOTTom:CYCLe[:STATe] OFF|ON|0|1 :CHSCanner:SWEep:BOTTom:CYCLe[:STATe]? Use this command to turn on/off Bottom Cycle state. It’s only available for Bottom N sweep mode. :CHSCanner:SWEep:BOTTom:CYCLe:VALue :CHSCanner:SWEep:BOTTom:CYCLe:VALue? Use this command to define the Bottom Cycle value. It’s only available for Bottom N sweep mode.
5 Command Reference Channel Scanner Edit Subsection Set Channel Edit Method for List Sweep :CHSCanner:EDIT:LIST:METHod ,<0|1>{,,< 0|1>} :CHSCanner:EDIT:LIST:METHod? This command specify the channel edit method for list sweep. In list sweep mode, there are two method to insert or edit a scan channel, custom method and signal standard method.
Command Reference 5 Modify Channel By Custom For List Sweep :CHSCanner:EDIT:LIST:MODify:CUSTom ,,{,,,} This command edit the sweep channel by custom, and it requires to input the channel index, new center frequency and new bandwidth.
5 Command Reference Query Channel Information For List Sweep :CHSCanner:EDIT:LIST? This command query the scan channel information for list sweep. Example: :CHSCanner:EDIT:LIST? Query Custom Channel For List Sweep :CHSCanner:EDIT:LIST:CUSTom? This command query the custom channel information for list sweep. Example: :CHSCanner:EDIT:LIST:CUSTom? Query Signal Standard Channel for List Sweep :CHSCanner:EDIT:LIST:STD? This command query the signal standard channel for list sweep.
Command Reference 5 Set Scan Channel Range For Top N Sweep By Signal Standard :CHSCanner:EDIT:TOP:STD:RANGe , :CHSCanner:EDIT:TOP:STD:RANGe? This command specify scan channel range number for Top N sweep mode. The signal standard should defined before this operation.
5 Command Reference Set Frequency Step for Customer Scan Channel For Top N Sweep :CHSCanner:EDIT:TOP:CUSTom:STEP :CHSCanner:EDIT:TOP:CUSTom:STEP? This command specify the frequency step size of custom scan channels for Top N sweep mode.
Command Reference 5 Set Scan Channel For Bottom N Sweep By Signal Standard :CHSCanner:EDIT:BOTTom:STD :CHSCanner:EDIT:BOTTom:STD? Use this command to specify the signal standard for Bottom N sweep method. Example: Key access: :CHSCanner:EDIT:BOTTom:STD "d:/CDMA-AWS_DL.STD" Meas > Range Edit > Edit Method Std > Signal Std.
5 Command Reference Set Start Frequency For Custom Scan Channel For Bottom N Sweep :CHSCanner:EDIT:BOTTom:CUSTom:STARt :CHSCanner:EDIT:BOTTom:CUSTom:STARt? This command specify the start frequency of custom scan channels for Bottom N sweep mode.
Command Reference 5 Set Custom Scan Channel Quantity For Bottom N Sweep :CHSCanner:EDIT:BOTTom:CUSTom:CHNumber :CHSCanner:EDIT:BOTTom:CUSTom:CHNumber? This command defines custom scan channel quantity for Bottom N sweep mode.
5 Command Reference Display Threshold State :CHSCanner:DISPlay:THReshold [:STATe] OFF|ON|0|1 :CHSCanner:DISPlay:THReshold [:STATe]? This command toggles display threshold state. Then the display threshold is turned on, only the channels with higher channel power than the threshold value will be displayed on the screen. Remark: Example: Key access: This parameter is only available for Table (Bar) display mode.
Command Reference 5 Limit Type :CHSCanner:DISPlay:LIMit:TYPE UPPer|LOWer :CHSCanner:DISPlay:LIMit:TYPE? This command toggles limit type between upper and lower. Example: Key access: :CHSCanner:DISPlay:LIMit:TYPE LOWer Shift > Limit > Limit Type Display Sort Type :CHSCanner:DISPlay:SORT ID|POWer :CHSCanner:DISPlay:SORT? This command toggles display sort type between by ID and by power.
5 Command Reference Logging File Type :CHSCanner:LOG:TYPE CSV|KML :CHSCanner:LOG:TYPE? This command switch the logging file type between CSV and KML. Example: Key access: :CHSCanner:LOG:TYPE KML Meas > Logging Start Channel Scanner Measure Subsection Query Result :CHSCanner:MEASure? Use this command to query the channel scanner measurement result.
Command Reference 5 Demodulation Option Subsystem The Demodulation Option Subsystem provides you the SCPI command reference for the demodulation function. Use the command :INSTrument MA to access this subsystem.
5 Command Reference Carrier Frequency Step [:SENSe]:FREQuency:CARRier:STEP [:SENSe]:FREQuency:CARRier:STEP? This command sets the carrier frequency step of the demodulation analysis. Example: Key access: :FREQuency:CARRier:STEP 50MHz Freq > CarrFreq Step Auto Carrier Frequency State [:SENSe]:FREQuency:CARRier:AUTO OFF|ON|1|0 [:SENSe]:FREQuency:CARRier:AUTO? Use this command to turn on/off auto carrier frequency detection.
Command Reference 5 Preamp [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Use this command to turn on/off preamplifier in demodulation mode. Example: Key access: :POWer:GAIN ON Amptd > Preamp Single Sweep :INITiate[:IMMediate] Use this command to perform a single sweep (measurement).
5 Command Reference Restart Meas [:SENSe]:MEASure:RESTart Use this command to restart measurement of current demodulation analysis. Example: Key access: :MEASure:RESTart Meas > Restart Meas Read Measurement Data :CALCulate:DATA? Use this command to query the measurement result of current demodulation analysis. Example: :CALCulate:DATA? AM Demodulation Subsection Switch To AM :INSTrument:MEASure AM Use this command to switch to AM demodulation analysis.
Command Reference 5 Read Current AM Modulation Rate :CALCulate:AMA:MRATe? Use this command to query the AM Modulation rate result. Example: :CALCulate:AMA:MRATe? AM Average Count [:SENSe]:AMA:AVERage:COUNt [:SENSe]:AMA:AVERage:COUNt? Use this command to set average count number in AM or FM demodulation analysis. Example: :AMA:AVERage:COUNt 50 [:SENSe]:AMA:AVERage OFF|ON|1|0 [:SENSe]:AMA:AVERage? Use this command to turn on/off average state in AM or FM demodulation analysis.
5 Command Reference AM Detector PeakHold [:SENSe]:AMA:DEMod:DETector[:FUNCtion]:PEAKhold OFF|ON|0|1 [:SENSe]:AMA:DEMod:DETector[:FUNCtion]:PEAKhold? Use this command to turn on/off Peak hold state of AM detector. Example: Key access: :AMA:DEMod:DETector:PEAKhold ON Meas > Detector > PeakHold AM IF Bandwidth [:SENSe]:AMA:IFBWidth 1.2MHz|960kHz|600kHz|480kHz|300kHz|240kHz|120kHz |96kHz|60kHz [:SENSe]:AMA:IFBWidth? This command sets the IF bandwidth of AM demodulation analysis.
Command Reference 5 AM Equal Low Pass Filter [:SENSe]:AMA:EQLPfilter AUTO|OFF|IFBW6|IFBW20|IFBW60|IFBW200|IFBW600|IFB W2000 [:SENSe]:AMA:EQLPfilter? Use this command to set the equal low pass filter in AM demodulation analysis. Range: Example: Key access: AUTO, OFF, IFBW6, IFBW20, IFBW60, IFBW200, IFBW600, IFBW2000 :AMA:EQLPfilter IFBW6 Meas > Equal LPF AM Limit State :CALCulate:AMA:LIMit OFF|ON|0|1 :CALCulate:AMA:LIMit? Use this command to turn on/off the limit in AM demodulation analysis.
5 Command Reference AM Depth Upper Limit :CALCulate:AM:LIMit:MDEPth:UPPer :CALCulate:AM:LIMit:MDEPth:UPPer? Use this command to set the upper limit of AM depth. Range: Example: Key access: 0.1% to 100% :CALCulate:AM:LIMit:MDEPth:UPPer 50 Shift > Limit> AMod Depth Up AM Depth Lower Limit :CALCulate:AM:LIMit:MDEPth:LOWer :CALCulate:AM:LIMit:MDEPth:LOWer? Use this command to set the lower limit of AM depth. Range: Example: Key access: 0.
Command Reference 5 AM X Scale/DIV :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision < value > :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision? Use this command to set the Scale per division of X axis. The unit of this parameter is second. This command is only available when the scale coupling state is set to off.
5 Command Reference AM X Scale Coupling State :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:COUPle 0|1|OFF|ON :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:COUPle? Use this command to turn on/off scale coupling state. Example: Key access: :DISPlay:AMA:VIEW:WINDow:TRACe:X:COUPle ON Shift > Disp >X Scale > Scale Coupling AM Y Reference Value :DISPlay:AM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue < value> :DISPlay:AM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue? Use this command to set reference value of Y axis.
Command Reference 5 AM Y Ref Position :DISPlay:AMA:VIEW:WINDow:TRACe:Y[:SCALe]:RPOSition TOP|CENTer|BOTTom :DISPlay:AMA:VIEW:WINDow:TRACe:Y[:SCALe]:RPOSition? Use this command to set the reference position of Y axis.
5 Command Reference Query FM Modulation Rate :CALCulate:AMA:MRATe? Use this command to query FM modulation rate measurement result in FM demodulation analysis. Example: :CALCulate:AMA:MRATe? Query FM Frequency Deviation :CALCulate:FM:FDEViation? Use this command to query FM frequency deviation test result. Example: :CALCulate:FM:FDEViation? FM Average Count [:SENSe]:AMA:AVERage:COUNt [:SENSe]:AMA:AVERage:COUNt? This command sets average count number in FM demodulation analysis.
Command Reference 5 FM Detector [:SENSe]:AMA:DEMod:DETector[:FUNCtion] PPK|NPK|PNPK|RMS [:SENSe]:AMA:DEMod:DETector[:FUNCtion]? Use this command to specify the detector in FM demodulation analysis. Example: Key access: :AMA:DEMod:DETector PPK Meas > Detector FM Detector PeakHold [:SENSe]:AMA:DEMod:DETector[:FUNCtion]:PEAKhold OFF|ON|0|1 [:SENSe]:AMA:DEMod:DETector[:FUNCtion]:PEAKhold? Use this command to turn on/off peak hold state of detector.
5 Command Reference FM Equal Low Pass Filter [:SENSe]:AMA:EQLPfilter AUTO|OFF|IFBW6|IFBW20|IFBW60|IFBW200|IFBW600|IFB W2000 [:SENSe]:AMA:EQLPfilter? This command specifies the equal low pass filter type. Range: Example: Key access: AUTO, OFF, IFBW6, IFBW20, IFBW60, IFBW200, IFBW600, IFBW2000 :AMA:EQLPfilter IFBW6 Meas > Equal LPF FM Limit State :CALCulate:AMA:LIMit OFF|ON|0|1 :CALCulate:AMA:LIMit? Use this command to turn on/off limit state of FM demodulation analysis.
Command Reference 5 FM Frequency Deviation Upper Limit :CALCulate:FM:LIMit:FDUL:UPPer :CALCulate:FM:LIMit:FDUL:UPPer? Use this command to specify frequency deviation upper limit of FM demodulation analysis.
5 Command Reference FM X Scale/DIV :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision? This command specifies scale per division of X axis.
Command Reference 5 FM X Scale Coupling State :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:COUPle 0|1|OFF|ON :DISPlay:AMA:VIEW:WINDow:TRACe:X[:SCALe]:COUPle? Use this command to turn on/off scale coupling state of X axis. Example: Key access: :DISPlay:AMA:VIEW:WINDow:TRACe:X:COUPle ON Shift > X Scale > Scale Coupling FM Y Reference Value :DISPlay:FM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue :DISPlay:FM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue? Use this command to specify reference value of Y axis.
5 Command Reference FM Y Reference Position :DISPlay:AMA:VIEW:WINDow:TRACe:Y[:SCALe]:RPOSition TOP|CENTer|BOTTom :DISPlay:AMA:VIEW:WINDow:TRACe:Y[:SCALe]:RPOSition? Use this command to specify reference position of Y axis.
Command Reference 5 ASK Average Count [:SENSe]:DMA:AVERage:COUNt [:SENSe]:DMA:AVERage:COUNt? Use this command to specify average count number in ASK demodulation analysis. Example: Key access: :DMA:AVERage:COUNt 20 Meas > Average Number ASK Symbol Rate [:SENSe]:DMA:RADio:STANdard:SRATe [:SENSe]:DMA:RADio:STANdard:SRATe? Use this command to specify symbol rate for ASK demodulation analysis.
5 Command Reference ASK Reference Filter [:SENSe]:DMA:RADio:STANdard:FILTer:REFerence RNYQuist|NYQuist|GAUSsian|NONE [:SENSe]:DMA:RADio:STANdard:FILTer:REFerence? Use this command to specify reference filter in ASK demodulation analysis.
Command Reference 5 ASK Measurement Length [:SENSe]:DMA:MEASurement:LENGth [:SENSe]:DMA:MEASurement:LENGth? Use this command to specify measurement length of ASK demodulation analysis. Range: Example: Key access: 20 to 1100 :DMA:MEASurement:LENGth 200 Meas > Meas Length ASK Trigger Type :TRIGger:DMA[:SEQuence]:SOURce IMMediate|EXTernal|RFTRigger :TRIGger:DMA[:SEQuence]:SOURce? Use this command to specify the trigger type used in current ASK demodulation analysis.
5 Command Reference ASK External Trigger Type :TRIGger:DMA[:SEQuence]:EXTernal:SLOPe POSitive|NEGative :TRIGger:DMA[:SEQuence]:EXTernal:SLOPe? This command switch external trigger type between rise slope and fall slope. It’s only available for external trigger.
Command Reference 5 ASK Carrier Power Upper Limit :CALCulate:DMA:LIMit:POWer:UPPer :CALCulate:DMA:LIMit:POWer:UPPer? Use this command to specify the carrier power upper limit value of ASK demodulation analysis.
5 Command Reference ASK Carrier Frequency Offset Upper Limit :CALCulate:DMA:LIMit:FOFFset:UPPer :CALCulate:DMA:LIMit:FOFFset:UPPer? Use this command to specify carrier frequency offset upper limit of ASK demodulation analysis.
Command Reference 5 ASK X Reference Value DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:RVALue :DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:RVALue? Use this command to specify the reference value of X axis.
5 Command Reference ASK Y Reference Value :DISPlay:ASK:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue :DISPlay:ASK:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue? Use this command to specify reference value of Y axis. Range: Example: Key access: –150% to 150% :DISPlay:ASK:VIEW:WINDow:TRACe:Y:RVALue –1 Shift > Disp > Y Scale > Ref Value ASK Y Scale/DIV DISPlay:ASK:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision DISPlay:ASK:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision? Use this command to specify scale per division of Y axis.
Command Reference 5 ASK Y Scale Coupling State :TRACe[:DATA]? Use this command to query measurement trace data. Example: Key access: :DISPlay:DMA:VIEW:WINDow:TRACe:Y:COUPle 1 Shift > Disp > Y Scale > Scale Coupling Read ASK Trace Data :DISPlay:FM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue :DISPlay:FM:VIEW:WINDow:TRACe:Y[:SCALe]:RVALue? Use this command to specify reference value of Y axis.
5 Command Reference FSK Symbol Rate [:SENSe]:DMA:RADio:STANdard:SRATe [:SENSe]:DMA:RADio:STANdard:SRATe? Use this command to specify symbol rate of ASK demodulation analysis. Range: Example: Key access: 100 sps to 100 ksps :DMA:RADio:STANdard:SRATe 2ksps Meas > Symbol Rate FSK Measurement Filter [:SENSe]:DMA:RADio:STANdard:FILTer:MEASurement NONE|RNYQuist|NYQuist|GAUSsian [:SENSe]:DMA:RADio:STANdard:FILTer:MEASurement? Use this command to set the measurement filter of FSK demodulation analysis.
Command Reference 5 FSK Filter Symbols [:SENSe]:DMA:RADio:STANdard:FILTer:SYMBol < integer > [:SENSe]:DMA:RADio:STANdard:FILTer:SYMBol? Use this command to specify FSK filter symbols. Range: Example: Key access: 2 to 25 :DMA:RADio:STANdard:FILTer:SYMBol 4 Meas > Filter Setup > FilterSymbols FSK Alpha/BbT [:SENSe]:DMA:RADio:STANdard:ALPHa [:SENSe]:DMA:RADio:STANdard:ALPHa? Use this command to specify the filter Alpha/Bbt value. Range: Example: Key access: 0.2 to 1 :DMA:RADio:STANdard:ALPHa 0.
5 Command Reference FSK Trigger Type :TRIGger:DMA[:SEQuence]:SOURce IMMediate|EXTernal|RFTRigger :TRIGger:DMA[:SEQuence]:SOURce? Use this command to specify the trigger type used in current FSK demodulation analysis. Example: Key access: :TRIGger:DMA:SOURce EXTernal Meas > Trigger FSK RF Trigger Level :TRIGger:DMA[:SEQuence]:LEVel:ABSolute :TRIGger:DMA[:SEQuence]:LEVel:ABSolute? Use this command to turn on/off scale coupling state of X axis.
Command Reference 5 FSK Trigger Delay Time Range: Example: :TRIGger:DMA[:SEQuence]:DELay
5 Command Reference FSK Frequency Deviation Upper Limit :CALCulate:FSK:LIMit:FDEViation:UPPer :CALCulate:FSK:LIMit:FDEViation:UPPer? Use this command to specify the FSK frequency deviation upper limit value.
Command Reference 5 FSK View Type :DISPlay:DMA:VIEW WAVeform|SYMBol|EYE|ERRor :DISPlay:DMA:VIEW? Use this command to toggle the different view type of ASK demodulation analyses. Range: SYMBol, WAVeform, EYE, ERRor Example: :DISPlay:DMA:VIEW SYMBol Key access: Shift > Disp > Display FSK X Scale/DIV DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:PDIVision? Use this command to specify the scale per division of X axis in FSK demodulation analysis.
5 Command Reference FSK X Reference Position :DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:RPOSition LEFT|CENTer|RIGHt :DISPlay:DMA:VIEW:WINDow:TRACe:X[:SCALe]:RPOSition? Use this command to specify the reference position of X axis in FSK demodulation analysis.
Command Reference 5 FSK Y Scale/DIV DISPlay:FSK:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision DISPlay:FSK:VIEW:WINDow:TRACe:Y[:SCALe]:PDIVision? Use this command to specify the scale per division of Y axis.
5 Command Reference Read FSK Trace Data :TRACe[:DATA]? Use this command to query FSK measurement trace data.
Command Reference 5 Power Meter Option Subsystem The Power Meter Option Subsystem provides you the SCPI command reference for the Power Meter function. Use the command :INSTrument POWmeter to access this subsystem. Option PWM or PWP is required to enable this function. Option PWM supports Agilent U2000 series USB average power sensor, and Option PWP supports Agilent U2020 X series peak power sensor. Power Sensor Zeroing :CALibration[1]:ZERO:ONCE This command perform power sensor zeroing operation.
5 Command Reference Switch Power Range [:SENSe]:POWer:AC:RANGe UPPer|LOWer [:SENSe]:POWer:AC:RANGe? This command toggles the measure power range between upper and lower. It’s only available for U2000 series average power sensor. Example: Key access: :POWer:AC:RANGe UPPer Meas > General Setup > Power Range > Range > Upper / Lower Set Power Auto Range State [:SENSe]:POWer:AC:RANGe:AUTO OFF|ON|0|1 [:SENSe]:POWer:AC:RANGe:AUTO? This command turns on/off power auto range state.
Command Reference 5 Set Power Meter Reference Power Value [:SENSe]:CORRection:CSET1[:INPut][:MAGNitude] [:SENSe]:CORRection:CSET1[:INPut][:MAGNitude]? This command defines the reference power value.
5 Command Reference Set Power Meter Average Count Number [:SENSe]:AVERage:COUNt [:SENSe]:AVERage:COUNt? This command defines the power meter average count number. Range: Example: Key access: 1 to 1024 :AVERage:COUNt 10 Meas > General Setup > Average > Average > Avg Count Set Power Meter Average Count Auto State [:SENSe]:AVERage:COUNt:AUTO OFF|ON|0|1 [:SENSe]:AVERage:COUNt:AUTO? This command toggles the power meter average count auto state.
Command Reference 5 Set Power Meter Video Bandwidth Type [:SENSe]:BANDwidth|BWIDth HIGH|MEDium|LOW|OFF [:SENSe]:BANDwidth|BWIDth? Use this command to toggle the video bandwidth type between high, middle, low and off. It’s only available for U2020 X series peak power sensor.
5 Command Reference Set Trace X Scale Time :SENSe:TRACe:TIME :SENSe:TRACe:TIME? This command defines the trace X scale time of peak power sensor. Range: Example: Key access: 20 ns to 100 ms :SENSe:TRACe:TIME 0.001 Meas > Peak Setup > Trace Setup > X Scale Set Trace Y Max Value :SENSe:TRACe:YMAX:TIME :SENSe:TRACe:YMAX:TIME? This command defines the trace Y max value of peak power sensor.
Command Reference 5 Set Gate Length Time [:SENSe]:SWEep[1]:TIME [:SENSe]:SWEep[1]:TIME? This command defines the gate length time of peak power meter measurement. Range: Example: Key access: 0 to 1 s :SENSe:SWEep1:TIME 1 Meas > Peak Setup > Gate Setup > Length Set Display Resolution :DISPlay[:WINDow]:NUMeric:RESolution T1|T2|T3|T4 :DISPlay[:WINDow]:NUMeric:RESolution? This command toggles the readout display resolution between T1 to T4. The display resolution T4 can achieve the best resolution.
5 Command Reference Set Bottom Value of Display Range :DISPlay[:WINDow]:DISPrange:BOTTom :DISPlay[:WINDow]:DISPrange:BOTTom? This command defines the bottom value of display range Range: Example: Key access: –200 to +199.99 dBm :DISPlay:WINDow:DISPrange:BOTTom –20dBm Meas > Meas Disp > Disp Range > Bottom Display Mode :DISPlay[:WINDow]:MODE METer|CHARt|TRACe :DISPlay[:WINDow]:MODE? This command to toggle display mode between meter, chart and trace.
Command Reference 5 Set Chart View to Previous :DISPlay[:WINDow]:CHARt:PREVious This command set the chart view page to previous page. Example: Key access: :DISPlay:CHARt:PREVious Meas > Meas Disp > Chart View > Prev Set Chart View to Next :DISPlay[:WINDow]:CHARt:NEXT This command set the chart view page to next page.
5 Command Reference Set Limit Lower Value :CALCulate1:LIMit:LOWer[:DATA] :CALCulate1:LIMit:LOWer[:DATA]? This command defines the lower limit value. Range: Example: Key access: –200 to +199.99 dBm :CALCulate1:LIMit:LOWer:DATA -10 Shift > Limit > Lower Limit Set Limit Beep :DISPlay[:WINDow]:DISPrange:BOTTom :DISPlay[:WINDow]:DISPrange:BOTTom? Use this command to turn on/off beep warning for limit.
Command Reference 5 Set Gate Measurement Type :CALCulate1:FEED1 PEAK|PTAV|AVER|MIN :CALCulate1:FEED1? This command to toggle gate measurement type between Average, Peak, Peak to Average, and Minimum. It’s only available when the display mode is set to Meter.
5 Command Reference Set Trigger Level :TRIGger[:SEQuence]:LEVel :TRIGger[:SEQuence]:LEVel? This command defines the trigger level of power sensor. It’s only available for continuous trigger or single trigger. The trigger source must be internal, and auto trigger level state must be off (set to normal mode).
Command Reference 5 Power Meter Trigger Holdoff Time TRIGger[:SEQuence]:HOLDoff TRIGger[:SEQuence]:HOLDoff? This command defines the trigger hold off time of power meter. Range: Example: Key access: 1 us to 400 ms :TRIGger:SEQuence:HOLDoff 0.1 Meas > Peak Setup > Trig/Acq > More 1 of 2 > Holdoff Power Meter Trigger Hysteresis Value :TRIGger[:SEQuence]:HYSTeresis :TRIGger[:SEQuence]:HYSTeresis? This command defines the trigger hysteresis value of power meter.
5 Command Reference Tracking Generator Option Subsystem The Tracking Generator Option Subsystem provides you the SCPI command reference for the Tracking Generator funciton.Use the command :INSTrument TGENerator to access this subsystem. Option TG7 is required to enable this function.
Command Reference 5 Tracking Generator Amplitude Step :SOURce:POWer:STEP[:INCRement] :SOURce:POWer:STEP[:INCRement]? This command sets the amplitude step size of the tracking generator output. This command is valid after tracking generator is enabled. Range: Example: Key access: 0 to –10 dBm :SOURce:POWer:STEP 1 dB Meas > Amptd Step Tracking Generator Storing as Reference :CALCulate:NTData:STORe This command stores the current trace to Trace 4 as a reference.
5 Command Reference Normalization Reference Position :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition :DISPlay:WINDow:TRACe:Y[:SCALe]:NRPosition? Use this command to set the normalization reference position.
