Agilent N9320A Spectrum Analyzer Programmer’s Guide
Notices © Agilent Technologies, Inc. 2006-2007 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 N9320A 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.
N9320A Programmer’s Guide
Contents 1 Getting Started 1 Remotely Operating Your N9320A 2 Programming Fundamentals Overview 7 8 Command Categories Command Syntax 10 11 Creating Valid Commands 13 Program and Response Messages Parameters in Commands 3 Status Registers Overview 17 18 Status Register System 23 Programming Example 29 Overview 14 15 How to use the Status Registers 4 2 21 30 Programming in C using the VTL Checking USB Connection 31 37 Using C with Marker Peak Search and Peak Excursion Using Mar
Contents CALCulate:MARKer Subsection CALCulate:NTData Subsection CALibration Subsystem 71 CONFigure Subsystem DISPlay Subsystem FETCh Subsystem 73 75 80 INITiate Subsystem 83 MMEMory Subsystem OUTPut Subsystem READ Subsystem 59 70 85 89 90 SENSe Subsystem 94 [:SENSe]:ACPower Subsection 94 [:SENSe]:CHPower Subsection 100 [:SENSe]:CORRection Subsection 102 [:SENSe]:OBWidth Subsection 102 [:SENSe]:TOI Subsection 105 [:SENSe]:SEMask Subsection 108 [:SENSe]:AVERage Subsection 115 [:SENSe]:BANDwidth S
Agilent N9320A Spectrum Analyzer Programmer’s Guide 1 Getting Started Preparing equipment for Remote Operation 2 Connecting the N9320A to a PC via the USB Port About USB Interface 3 6 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.
1 Getting Started Remotely Operating Your N9320A The signal generator provides USB (Universal Serial Bus) connection and allows you to set up a remote operation environment via the USB interface 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 N9320A to a PC via the USB Port No extra driver is required to connect the N9320A 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 N9320A. Or download the IO libraries suite from Agilent website: http://www.agilent.
1 4 Getting Started 4 After a while, the PC finds your N9320A 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 N9320A Programmer’s Guide 1 7 Windows should find USB Test and Measurement Device. Select it and press Next. 8 The wizard will guide you through the rest of installation till the driver is installed. 9 Run Agilent IO libraries suite, your N9320A will be detected automatically. If not, press Refresh All.
1 Getting Started About USB Interface A USB connection is typically easy to setup and very cost effective. The USB specification supports a wide selection of devices that range from lower- speed devices, such as keyboards and mice to higher- speed devices, such as digital camera and intelligent instrument. The USB interface initially offers up to 12 Mb/S. That is about 100 times faster than the RS- 232 style serial interfaces used in earlier generations. A USB 2.
Agilent N9320A Spectrum Analyzer Programmer’s Guide 2 Programming Fundamentals Overview 8 Command Categories Command Syntax 10 11 Creating Valid Commands 13 Program and Response Messages Parameters in Commands 14 15 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.
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 Microsoft®Visual Basic®. • The language of your instrument. The N9320A 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 (if varia
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. A frequency parameter is a positive rational number followed by optional units.
Agilent N9320A Spectrum Analyzer Programmer’s Guide 3 Status Registers Overview 18 How to use the Status Registers Status Register System 21 23 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 3 Negative Transition Register This filter register controls which signals will set a bit in the event register when the signal makes a high to low transition (when the condition bit changes from 1 to 0). Event Register 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.
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 this condition occurred even if the condition no longer exists. The event register can only be cleared by querying it or sending the *CLS command. • Monitor a particular type of change in a condition (bit). — 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).
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 N9320A 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 *ESE command where is the sum of the decimal values of the bits you want to enable. For example, to enable bit 7 and bit 6 so that whenever either of those bits is set to 1, the standard event status summary bit of the status byte register will be set to 1, send the command *ESE 192 (128 + 64). The command *ESE? returns the decimal value of the sum of the bits previously enabled with the *ESE command.
Agilent N9320A Spectrum Analyzer Programmer’s Guide 4 Programming Example Overview 30 Programming in C using the VTL Checking USB Connection 31 37 Using C with Marker Peak Search and Peak Excursion Using Marker Delta Mode and Marker Minimum Search Measuring Noise 38 42 46 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 viPrintf viScanf These are the VTL formatted I/O functions that are patterned after those used in the C programming language. The viPrintf call sends the SCPI commands to the analyzer. The viPrintf call can also be used to query the analyzer. The viScanf call is then used to read the results. viWrite This function synchronously sends the data pointed to by buf to the device specified by vi. Only one synchronous write operation van occur at any one time.
Programming Example 4 viStatus=viOpen(defaultRM,"USB0::2391::8472::000 0000000::0::INSTR",VI_NULL,VI_NULL,&viN9320A); /*Initialize device */ viPrintf(viN9320A,"*RST\n"); /*Send an *IDN? string to the device */ printf(viN9320A, "*IDN?\n"); /*Read results */ viScanf(viN9320A, "%t", &buf); /*Print results */ printf("Instrument identification string: %s\n", buf); /* Close the sessions */ viClose(viN9320A); viClose(defaultRM); } Including the VISA Declarations File For C and C++ programs, you must include the
4 Programming Example Opening a Session A session is a channel of communication. Sessions must first be opened on the default resource manager, and then for each device you will be using. The following is a summary of sessions that can be opened: • A resource manager session is used to initialize the VISA system. It is a parent session that knows about all the opened sessions. A resource manager session must be opened before any other session can be opened.
Programming Example 4 Next, you open a session with a specific device with the viOpen function. This function uses the session returned from viOpenDefaultRM and returns its own session to identify the device session. The following shows the function syntax: viOpenDefaultRM (sesn); viOpen (sesn, rsrcName, accessMode, timeout, vi); The session returned from viOpenDefaultRM must be used in the sesn parameter of the viOpen function.
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 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_N9320A; ViUInt32 rcount; unsigned char buffer[BufferSize]; int main(void) { /* Connect N9320A 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 N9320A 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, viN9320A; ViStatus errStatus; ViChar cIdBuff[256]= {0}; char cEnter = 0; int iResult = 0; /*Set the input port to 50MHz amplitude reference*/ void Route50MHzSignal() { viQueryf(viN9320A, "*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(viN9320A,"CALC:MARK:PEAK:EXC %1fDB \n",fPeakExcursion); /*Set the peak thresold */ viPrintf(viN9320A,"CALC:MARK:PEAK:THR -90 \n"); /*Trigger a sweep and wait for completion*/ viPrintf(viN9320A,"INIT:IMM \n"); /*Set the marker to the maximum peak*/ viPrintf(viN9320A,"CALC:MARK:MAX \n"); /*Query and read the marker frequency*/ viQueryf(viN9320A,"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 N9320A 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,&viN9320A); if(viStatus) printf("Could not open a session to USB device!\n"); exit(0); } /*Clear the instrument*/ viClear(viN9320A); /*Reset the instrument*/ viPrintf(viN9320A,"*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 according
Programming Example 4 /*Set the analyzer to the values given by the user*/ //viPrintf(viN9320A,"SENS:FREQ:STAR %lf //MHZ;:SENS:FREQ:STOP %lf MHZ\n",dStartFreq,dStopFreq); viPrintf(viN9320A,":SENS:FREQ:STAR %lf MHz\n",dStartFreq); viPrintf(viN9320A,":SENS:FREQ:STOP %lf MHZ\n",dStopFreq); /*Trigger a sweep, delay for completion*/ viPrintf(viN9320A,"INIT:IMM\n"); //delay(1); /*Set the marker to the maximum peak*/ viPrintf(viN9320A,"CALC:MARK:MAX\n"); /*Set the analyzer to activate delta marker mode*/ viPrint
4 Programming Example Measuring Phase Noise /************************************************************/ /* Measuring Phase Noise */ /* */ /* This example is for the N9320A Spectrum Analyzers */ /* */ /* This C programming example does the following. */ /* The SCPI instrument commands used are given as reference.
Programming Example 4 ViSession defaultRM, viN9320A; ViStatus errStatus; ViChar cIdBuff[256]= {0}; char cEnter = 0; int iResult = 0; /*Set the input port to 50 MHz amplitude reference*/ void Route50MHzSignal() { viQueryf(viN9320A, "*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 /*Reset the Instrument*/ viPrintf(viN9320A,"*RST\n"); /*Display the program heading */ printf("\n\t\t Noise Program \n\n" ); /* Check for the instrument model number and route the 50 MHz signal accordingly*/ Route50MHzSignal(); /*Set the analyzer center frequency to 50 MHz*/ viPrintf(viN9320A,"SENS:FREQ:CENT 50e6\n"); /*Set the analyzer span to 10 MHz*/ viPrintf(viN9320A,"SENS:FREQ:SPAN 10e6\n"); /*Set the marker to the maximum peak*/ viPrintf(viN9320A,"CALC:MARK1:MAX \n"); /*Activat
Agilent N9320A Spectrum Analyzer Programmer’s Guide 5 Command Reference IEEE Common Commands CALCulate Subsystem 50 53 CALibration Subsystem 71 CONFigure Subsystem DISPlay Subsystem FETCh Subsystem 73 75 80 INITiate Subsystem 83 MMEMory Subsystem OUTPut Subsystem READ Subsystem 85 89 90 SENSe Subsystem 94 SOURce Subsystem 125 SYSTem Subsystem 129 TRACe Subsystem 133 TRIGger Subsystem UNIT Subsystem 134 137 This chapter contains SCPI (Standard Commands for Programmable Instruments) pro
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 N9320A spectrum analyzers SCPI commands are listed. Clear Status *CLS Clears the status byte register. It does this by emptying the error queue and clearing all bits in all of the event registers.
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 Key access: The preset performed by *RST is always a factory preset. That is, the same preset performed by :SYSTem:PRESet when :SYSTem:PRESet:TYPE is set to FACTory.
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. CALCulate subsystem commands used for measurements in the MEAS menus are located in “SENSe Subsystem” on page 94.
5 Command Reference NdBstate :CALCulate:BWIDth|BANDwidth[:STATe] OFF|ON|0|1 :CALCulate:BWIDth|BANDwidth[:STATe]? Controls the bandwidth measurement function. The function measures the bandwidth, at the number of dB down specified in :CALCulate:BWIDth:NDB, of the maximum signal on the display. *RST: Remarks: Key access: Off When this command is turned on, the bandwidth measurement function (N dB Points) is associated with the active marker.
Command Reference 5 CALCulate:LLINe 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. Delete All Limit Lines in Memory :CALCulate:LLINe:ALL:DELete Deletes all limit lines in volatile memory.
5 Command Reference Remarks: If two amplitude values are entered for the same frequency, a single vertical line is the result. In this case, if an upper line is chosen, the amplitude of lesser frequency (amplitude 1) is tested. If a lower line is chosen, the amplitude of greater frequency (amplitude 2) is tested.
Command Reference 5 Display the Limit Line *RST: Key access: :CALCulate:LLINe[1]|2:DISPlay OFF|ON|0|1 :CALCulate:LLINe[1]|2:DISPlay? Controls the display of the current limit line. Off Det/ Display > Limits > Limit 1|2 > Limit On Off Test the Data Against the Limit Line :CALCulate:LLINe[1]|2:FAIL? Queries the status of the limit line testing. Returns a 0 if the data passes, and returns a 1 if there is a failure. This query value is valid only if margin or limit test is On.
5 Command Reference Display the Limit Margin :CALCulate:LLINe[1]|2:MARGin:STATe OFF|ON|0|1 :CALCulate:LLINe[1]|2:MARGin:STATe? Displays a measurement margin that is added to the designated limit line to do secondary testing of the data. *RST: Key access: Off Det/ Display > Limits > Limit 1|2 > Margin On Off Control Limit Line Testing :CALCulate:LLINe[1]|2:STATe OFF|ON|0|1 :CALCulate:LLINe[1]|2:STATe? Turns limit line testing on/off. The limit and margin will only be tested if they are displayed.
Command Reference 5 CALCulate: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 Function :CALCulate:MARKer[n]:CPEak[:STATe] OFF|ON|0|1 :CALCulate:MARKer[n]:CPEak[:STATe]? Turns on or off continuous peaking. It continuously puts the selected marker on the highest displayed signal peak.
5 Command Reference Frequency Counter Marker Automatic Resolution :CALCulate:MARKer:FCOunt:RESolution:AUTO OFF|ON|0|1 :CALCulate:MARKer:FCOunt:RESolution:AUTO? Sets the resolution of the marker frequency counter so it is automatically coupled to the frequency span, generating the fastest accurate count.
Command Reference 5 Marker Peak (Maximum) Search :CALCulate:MARKer[n]:MAXimum Performs a peak search based on the search mode settings of :CALCulate:MARKer:PEAK:SEARch:MODE. Key access: Peak Search > Peak Search Marker Peak (Maximum) Left\Right Search :CALCulate:MARKer[n]:MAXimum:LEFT :CALCulate:MARKer[n]:MAXimum:RIGHt Places the selected marker on the next highest signal peak to the left/right of the current marked peak.
5 Command Reference Marker Mode :CALCulate:MARKer[n]:MODE POSition|DELTa :CALCulate:MARKer[n]:MODE? Selects the type of markers that you want to activate. Position selects a normal marker that can be positioned on a trace and from which trace information will be generated. Delta activates a pair of markers, one of which is fixed at the current marker location. The other marker can then be moved around on the trace. The marker readout shows the difference between the two markers.
Command Reference Remarks: 5 If mode is set to MAXimum, peak search will place the marker at the maximum amplitude in the trace. If mode is set to PARameter, peak search will place the marker at the highest peak that rises and falls by at least the peak excursion above the peak threshold. If no peak meets the excursion and threshold criteria, No Peak Found is issued. Next peak, next peak right, next peak left, and peak table are not affected by this command.
5 Command Reference Peak to Peak Delta Markers :CALCulate:MARKer[1]|2|3|4:PTPeak Positions delta markers on the highest and lowest points on the trace. *RST: Key Access: Off Peak Search > Pk-Pk Search Turn on/off Phase Noise :CALCulate:MARKer[n]:PHNoise:[STATe]ON|OFF|1|0 :CALCulate:MARKer[n]:PHNoise:[STATe]? Turns on/off the phase noise function for the specified marker.
Command Reference 5 Optimize Phase Noise :CALCulate:MARKer:PHNoise:OPTimize ON|OFF|1|0 Turns on/off the phase noise optimization function. This is only available when SPAN is set less than 50 MHz. *RST: Key access: Off Marker > Functions > Optimize Phase Noise Read Phase Noise :CALCulate:MARKer:PHNoise:Y? Read the phase noise value.
5 Command Reference Set Reference Level to the Marker Value :CALCulate:MARKer[n][:SET]:RLEVel Sets the reference level to the specified marker amplitude. In delta marker mode, the reference level is set to the amplitude difference between the markers. Key access: Marker > Mkr –> Ref Lvl Set Start Frequency to the Marker Value :CALCulate:MARKer[n][:SET]:STARt Sets the start frequency to the value of the specified marker frequency.
Command Reference 5 Marker On/Off :CALCulate:MARKer[n]:STATe OFF|ON|0|1 :CALCulate:MARKer[n]:STATe? Turns the selected marker on or off. Key access: Marker > Off Marker Table On/Off :CALCulate:MARKer:TABLe:STATe OFF|ON|0|1 :CALCulate:MARKer:TABLe:STATe? Turns the marker table on or off Key access: Marker > More > Marker Table > On/Off Marker to Trace :CALCulate:MARKer[n]:TRACe :CALCulate:MARKer[n]:TRACe? Assigns the specified marker to the designated trace.
5 Command Reference Turns on or off marker signal tracking. It continuously puts the selected marker on the highest displayed signal peak and moves it to the center frequency. This allows you to keep a signal that is drifting in frequency, on the display. *RST: Remarks: Key access: Off When a measurement under the front panel MEAS key is started, this command is turned off. If this command is turned on when any of the MEAS key measurements are in progress, that measurement will be stopped.
Command Reference 5 Set the Delta Marker :CALCulate:MARKer[n]:X:DELTa :CALCulate:MARKer[n]:X:DELTa? Activates a pair of markers, where each marker can be independently positioned on the trace. The marker readout shows the difference between the two markers. Key access: Marker > Delta > Delta On Off Set the Reference Marker :CALCulate:MARKer[n]:X:REFerence :CALCulate:MARKer[n]:X:REFerence? Specifies a pair of reference markers.
5 Command Reference Marker Read Y Value :CALCulate:MARKer[n]:Y? Read 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 (which is often dBm). Remarks: 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.
Command Reference 5 CALibration Subsystem These commands control the self- alignment processes. Align All Instrument Assemblies :CALibration[:ALL] :CALibration[:ALL]? Performs an alignment of all the assemblies within the instrument, except for the tracking generator. Before executing this command, connect a cable between front panel CAL OUT and RF IN connector. The query performs a full alignment and returns a number indicating the success of the alignment.
5 Command Reference Select the Source State for Calibration :CALibration:SOURce:STATe OFF|ON|0|1 :CALibration:SOURce:STATe? Controls the state of the 50 MHz alignment signal. NOTE *RST: Key access: 72 Connect a cable between front panel CAL OUT and the RF IN connector before performing a calibration.
Command Reference 5 CONFigure Subsystem ACP measurement State :CONFigure:ACPower This command places the analyzer in Adjacent Channel Power measurement state. CONFigure subsystem commands used for measurements in the MEAS menus. Key access: Meas > ACP Channel Power measurement State :CONFigure:CHPower This command places the analyzer in Channel Power measurement state. CONFigure subsystem commands used for measurements in the MEAS menus.
5 Command Reference Specturm Emission Mask measurement State :CONFigure:SEMask This command places the analyzer in Spectrum Emission Mask measurement state. CONFigure subsystem commands used for measurements in the MEAS menus. Key access: Meas > SEM Third Order Intermodulation measurement State :CONFigure:TOI This command places the analyzer in Third Order Intermodulation measurement state. CONFigure subsystem commands used for measurements in the MEAS menus.
Command Reference 5 DISPlay Subsystem The DISPlay subsystem controls the selection and presentation of textual, graphical, and trace information. Within a display, information may be separated into individual windows. Active Function Area :DISPlay:AFUnction:POSition CENTer|TOP|BOTTom :DISPlay:AFUnction:POSition? Changes the position of the active function block.
5 Command Reference Turn the Entire Display On/Off :DISPlay:ENABle OFF|ON|0|1 :DISPlay:ENABle? Turns the display on or off. Having the display turned off may increase repetitive measurement rate. Pressing Preset/ System (local) key will turn display enable back on. Trace X-Axis Scale Offset :DISPlay:WINDow:TRACe:X[:SCALe]:OFFSet :DISPlay:WINDow:TRACe:X[:SCALe]:OFFSet? Specifies the frequency offset for all frequency readouts such as center frequency, except that it does not affect marker count.
Command Reference 5 Display Line On/Off :DISPlay:WINDow:TRACe:Y:DLINe:STATe OFF|ON|0|1 :DISPlay:WINDow:TRACe:Y:DLINe:STATe? Turns the display line on or off. *RST: Key access: Off Det/ Display > Display Line On Off Normalized Reference Level :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel :DISPlay:WINDow:TRACe:Y[:SCALe]:NRLevel? Sets the normalized reference level. See command :CALCulate:NTData[STATe] OFF|ON|0|1 *RST: Range: Default Unit: Key Access: 0 dB –327.6 to 327.
5 Command Reference Trace Y-Axis Amplitude Scaling :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Sets the per- division display scaling for the y- axis when y- axis units are set to amplitude units.
Command Reference Remarks: 5 The sum of (reference level offset + reference level) is clipped to the range –327.6 to 327.6 dB. The maximum limits are determined by the first of these two parameters, within the boundaries of their individual limits when initially set. For example, if the reference level is (first) set to –20 dBm, then the reference level offset can be set to values of –307.6 dB to 327.6 dB. In the case of a 327.
5 Command Reference FETCh Subsystem This command puts selected data from the most recent measurement into the output buffer. Use FETCh if you have already made a good measurement and you want to return scalar data from a single measurement. FETCh saves you the time of re- making the measurement. You can only FETCh results from the measurement that is currently active, it will not change to a different measurement.
Command Reference 5 Channel Power measurement :FETCh:CHPower? This command returns scalar results of main channel power, and power density. :FETCh:CHPower:CHPower? This command returns the value of the channel power in amplitude units. :FETCh:CHPower:DENSity? This command returns the value of the channel power density in amplitude units/Hz. Key Access Meas > Channel Power OBW measurement :FETCh:OBWidth? This returns the bandwidth of the carrier signal.
5 Command Reference for store the lower statistical result for power(or PSD) offset. 2. The emission mask offset of lower frequency. Used for store the lower statistical result for frequency offset. 3. The emission mask offset of upper value displayed. Used for store the upper statistical result for power/PSD offset. 4. The emission mask offset of upper frequency. Used for store the upper statistical result for frequency offset.
Command Reference 5 INITiate Subsystem The INITiate subsystem is used to control the initiation of the trigger. Refer to the TRIGger subsystems for related commands. Continuous or Single Measurements :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Selects whether the trigger system is continuously initiated or not. This command affects sweep if not in a measurement, and affects trigger when in a measurement. A “measurement” refers to any of the functions under the MEAS key.
5 Command Reference • When OFF, the trigger system remains in an “idle” state until CONTinuous is ON or :INITiate[:IMMediate] is received. On receiving the :INITiate[:IMMediate] command, it will go through a single trigger cycle, and then return to the “idle” state. • The query returns 1 or 0 into the output buffer. 1 is returned when in a continuous measurement state. 0 is returned when there is only a single measurement.
Command Reference 5 MMEMory Subsystem The purpose of the MMEMory subsystem is to provide access to internal or external disk drives. Agilent N9320A spectrum analyzers use instrument internal local storage device. The MMEMory command syntax term is a specifier having the form: name.ext, where the “name” is a file name of up to 29 characters, letters (A- Z, a- z) and numbers (0- 9) only (lower case letters are read as uppercase).
5 Command Reference Load a Limit Line from Memory to the Instrument :MMEMory:LOAD:LIMit LLINE1|LLINE2, Loads a limit line, from the specified file in mass storage to the instrument. Loading a time limit line deletes any frequency limit lines. Similarly, loading a frequency limit line deletes any time limit lines. Example: :MMEM:LOAD:LIM LLINE2,mylimit.lim Remarks: There is no SCPI short form for parameters LLINE1|LLINE2.
Command Reference 5 Load a Trace From a File to the Instrument :MMEMory:LOAD:TRACe The contents of the file are loaded into TRACE1. The file name must have a file extension of :trc. The file extension determines whether a trace is loaded, or a trace with its state, are loaded. The :trc extension is for files that include both trace and state data. Example: :MMEM:LOAD:TRAC mytrace.
5 Command Reference Store a Screen Image in a Graphic File :MMEMory:STORe:SCReen Saves the current instrument screen image, as a graphic file, to the specified file in memory. The file must have a jpg file extension. The specified file extension determines which file format the instrument will use to save the image. Example: :MMEM:STOR:SCR myscreen.jpg Remarks: This command will fail if the already exists.
Command Reference 5 OUTPut Subsystem The OUTPut subsystem controls the characteristics of the tracking generator output port. Refer to the“SOURce Subsystem” on page 125, which also contains commands that control the characteristics of the tracking generator. Turn Output On/Off :OUTPut[:STATe] OFF|ON|0|1 :OUTPut[:STATe]? Controls the tracking generator output.
5 Command Reference READ Subsystem Does not preset the measurement to the factory default settings. For example, if you have previously initiated the ACP measurement and you send READ:ACP? it will initiate a new measurement using the same instrument settings. • Initiates the measurement and puts valid data into the output buffer. If a measurement other than the current one is specified, the instrument will switch to that measurement before it initiates the measurement and returns results.
Command Reference 5 Channel Power measurement :READ:CHPower? Returns two values that correspond to the Channel Power and Power Spectral Density. :READ:CHPower:CHPower? Returns a single value that corresponds to the Channel Power. :READ:CHPower:DENSity? Returns a single value that corresponds to the Power Spectral Density. Key Access Meas > Channel Power OBW measurement :READ:OBWidth? Returns two values that correspond to the Occupied BW and Transmit Frequency Error in Hertz.
5 Command Reference SEM measurement :READ:SEMask? Returns 20 scalar results, each five in a array, in the following order: 1. The emission mask offset of lower value displayed. Used for store the lower statistical result for power(or PSD) offset. 2. The emission mask offset of lower frequency. Used for store the lower statistical result for frequency offset. 3. The emission mask offset of upper value displayed. Used for store the upper statistical result for power/PSD offset. 4.
Command Reference 5 16. The upper Output Intercept Power value in dBm. 17. The upper Output Intercept Power value in dBc. 18. The upper Output Intermod Point in Hz. Key Access Meas > TOI Read the TOI (IP 3) :READ:TOIntercept:IP3? Returns the worst case Output Intercept Power value in dBm.
5 Command Reference SENSe Subsystem Sets the instrument state parameters so that you can measure the input signal. SENSe subsystem commands used for measurements in the MEAS menus. These commands may be used only to set parameters of a specific measurement when the measurement is active.
Command Reference 5 • EXP (Exponential Averaging mode) — When you set Avg Mode to Exp, each successive data acquisition after the average count is reached is exponentially weighted and combined with the existing average. Exponential averaging weights new data more than old data, which facilitates tracking of slow- changing signals. The average will be displayed at the end of each sweep.
5 Command Reference When set to manual, the last measured value is captured and held, or may be entered by the user. Relative values are displayed, referenced to the value measured in the main channel.
Command Reference 5 Set the Measurement Method [:SENSe]:ACPower:METHod IBW|RBW [:SENSe]:ACPower:METHod? Enables you to set the measurement method. The resolution bandwidth method is most useful for measuring the signals the bandwidths of which is approximate to the RBW of the Analyzer; the integration bandwidth method is preferred for other signals.
5 Command Reference This command, along with commands [:SENSe]:ACPower:OFFSet:LIST[:FREQuency] and [:SENSe]:ACPower:OFFSet:LIST:STATe are used to set an entire array of values. The Table 1 shows the default array. Example: Sending fewer than six parameters to these commands will leave the values of the unspecified offsets unchanged.
Command Reference 5 command with only four paramenters(ACP:OFFS:LIST:STAT ON,ON,ON,OFF) will result in the fifth and sixth offset remaining the same as the previous setting (OFF). Key access: Meas > ACP > Offset/Limits > Offset Freq Set the Measurement Type [:SENSe]:ACPower:TYPE TPRef|PSDRef [:SENSe]:ACPower:TYPE? Press Meas Type to specify the reference for the measurement, either Total Pwr Ref or PSD Ref.
5 Command Reference [:SENSe]:CHPower Subsection Set the Average [:SENSe]:CHPower:AVERage:COUNt [:SENSe]:CHPower:AVERage:COUNt? [:SENSe]:CHPower:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:CHPower:AVERage[:STATe]? To specify the number of measurement averages used when calculating the measurement result set Avg Number to ON. The average will be displayed at the end of each sweep. Setting Avg Number to OFF disables measurement averaging.
Command Reference *RST: Example: Key access: 5 EXPonential CHP:AVG:TCON EXP Meas > Channel Power > Avg Mode Set the Channel Integration BW [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration? Press Integ BW to specify the range of integration used in calculating the power in the channel, for example. set the main (center) channel bandwidth. Note that the integration bandwidth is displayed on the trace as two markers connected by an arrow.
5 Command Reference [:SENSe]:CORRection Subsection External Amplifier Correction [:SENSe]:CORRection:OFFSet[:MAGNitude] [:SENSe]:CORRection:OFFSet[:MAGNitude]? A single value of amplitude correction can be applied to the displayed trace data to compensate for signal losses or gains that are due to other devices in the measurement setup, rather than the unit under test. *RST: Range: 0 dB –81.9 to 81.
Command Reference 5 Set the Average Mode [:SENSe]:OBWidth:AVERage:TCONrol EXPonential|REPeat [:SENSe]:OBWidth:AVERage:TCONrol? Press Avg Mode to select the type of termination control used for the averaging function to either Exp or Repeat. This determines the averaging action after the specified number of measurements (average count) is reached.
5 Command Reference bandwidth, and the occupied bandwidth results is displayed in the data window. If the power of the adjacent channel is included in the calculation for the 100% power, the OBW result will be too high. The OBW Span should be set narrow enough to encompass the channel of interest and exclude any unwanted adjacent channels.
Command Reference 5 Set the X dB value [:SENSe]:OBWidth:XDB [:SENSe]:OBWidth:XDB? Enables you to specify the power level used to determine the emission bandwidth as the number of dB down from the highest signal point (P1), within the occupied bandwidth span. This function is an independent calculation from the OBW calculation. The x dB Bandwidth result is also called the emissions bandwidth, or EBW. *RST: Range: Example: Key access: –26 dB –100.0 dB through –0.
5 Command Reference Set the Average Mode [:SENSe]:TOI:AVERage:TCONrol EXPonential|REPeat [:SENSe]:TOI:AVERage:TCONrol? Press Avg Mode to select the type of termination control used for the averaging function to either Exp or Repeat. This determines the averaging action after the specified number of measurements (average count) is reached.
Command Reference 5 level. For example, as the reference level changes, the input attenuator changes to ensure that a signal at the reference level does not exceed the Max Mixer Lvl setting. When the TOI measurement is on, this key controls the maximum mixer level, independent of the previous setting of Max Mixer Lvl located under Amplitude. When the TOI measurement is Off, the previous maximum Max Mixer Lvl is restored. Setting Max Mixer Lvl to Auto sets the maximum mixer level to –30 dBm.
5 Command Reference [:SENSe]:SEMask Subsection Set the Average [:SENSe]:SEMask:AVERage:COUNt [:SENSe]:SEMask:AVERage:COUNt? [:SENSe]:SEMask:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:SEMask:AVERage[:STATe]? To specify the number of measurement averages used when calculating the measurement result set Avg Number to ON. The average will be displayed at the end of each sweep.
Command Reference 5 Set the Channel Res BW [:SENSe]:SEMask:BANDwidth|BWIDth[:RESolution]:AUTO OFF|ON|0|1 [:SENSe]:SEMask:BANDwidth|BWIDth[:RESolution]:AUTO? [:SENSe]:SEMask:BANDwidth|BWIDth[:RESolution] [:SENSe]:SEMask:BANDwidth|BWIDth[:RESolution]? Specifies the resolution bandwidth used in measuring and the power in the main channel.
5 Command Reference ,...[] (up to five values) [:SENSe]:SEMask:BANDwidth|BWIDth[:RESolution]? Specifies the resolution bandwidth used in measuring the offset pair. When set to Auto, the Res BW from the default tables in User’s Guide are used. When set to Man, the range of settings is the range of available Res BWs of the analyzer, except the maximum is further limited to not exceed (Stop Freq - Start Freq). *RST: Example: Key access: Dependent upon Offset label selected.
Command Reference 5 Set the Stop Freq [:SENSe]:SEMask:OFFSet:LIST:FREQuency:STOP ,...[] (up to five values) [:SENSe]:SEMask:OFFSet:LIST:FREQuency:STOP? Specifies the inner limit (frequency closest to the carrier) for both segments of the specified offset pair. When Start Freq (Off) is selected, the offset pair is not measured. Offsets that are turned off, for the currently selected offset will return a - 999.0 when queried.
5 Command Reference Set the Abs Start [:SENSe]:SEMask:OFFSet:LIST:STARt:ABSolute ,...[] (up to five values) [:SENSe]:SEMask:OFFSet:LIST:STARt:ABSolute? Enables you to enter an absolute level limit at Start Freq for the currently selected offset ranging from –200.00 to +50.00 dBm with 0.01 dB resolution. *RST: Range: Example: Key access: Dependent upon Offset selected, please refer to the User’s Guide for more details.
Command Reference 5 Set the Abs Stop [:SENSe]:SEMask:OFFSet:LIST:STARt:ABSolute ,...[] (up to five values) [:SENSe]:SEMask:OFFSet:LIST:STARt:ABSolute? [:SENSe]:SEMask:OFFSet:LIST:STOP:ABSolute:COUPle OFF|ON|0|1,...OFF|ON|0|1 (up to five values) [:SENSe]:SEMask:OFFSet:LIST:STOP:ABSolute:COUPle? Enables you to enter an absolute level limit at Stop Freq for the currently offset ranging from –200.00 to +50.00 dBm with 0.01 dB resolution, and to toggle this function between Couple and Man.
5 Command Reference Couple and Man. If set to Couple, this is coupled to Rel Start to make a flat limit line. If set to Man, Abs Start and Rel Stop you can enter different values to make a sloped limit line. *RST: Range: Example: Key access: Dependent upon Offset selected, please refer to the User’s Guide for more details.
Command Reference 5 Set the Sweep Time [:SENSe]:SEMask:SWEeptime [:SENSe]:SEMask:SWEeptime? [:SENSe]:SEMask:SWEeptime:AUTO OFF|ON|0|1 [:SENSe]:SEMask:SWEeptime:AUTO? Specifies the sweep time used in measuring the power in the main channel. *RST: Range: Example: Key access: Auto 8.
5 Command Reference Turn Averaging On/Off [:SENSe]:AVERage[:STATe] OFF|ON|0|1 [:SENSe]:AVERage[:STATe]? This command toggles averaging off and on. Averaging combines the value of successive measurements to average out measurement variations. *RST: Remarks: Key access: Off This command is turned off for video averaging ([:SENSe]:AVERage:TYPE VIDeo) When a measurement under Meas key is started.
Command Reference 5 Type of Averaging for Measurements [:SENSe]:AVERage:TYPE VIDeo|RMS [:SENSe]:AVERage:TYPE? Successive measurements of data can be combined to average out measurement variations. Detector is set to average and Avg type is set to power (RMS) to measure RMS voltage (avg power).
5 Command Reference Video Bandwidth [:SENSe]:BANDwidth|BWIDth:VIDeo [:SENSe]:BANDwidth|BWIDth:VIDeo? Specifies the video bandwidth. *RST: Range: 3 MHz 1 Hz to 3 MHz. This range is dependent upon the setting of [:SENSe]:BANDwidth|BWIDth[:RESolution]. Default Unit: Hz Key access: BW/ Avg > Video BW Auto Man Video Bandwidth Automatic [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO? Couples the video bandwidth to the resolution bandwidth.
Command Reference 5 Selects auto or manual mode for video bandwidth to resolution bandwidth ratio. Refer to User’s Guide for a flowchart that illustrates VBW and RBW Ratio auto rules. *RST: Key access: Auto BW/ Avg > VBW/RBW Auto Man [:SENSe]:DETector Subsection Automatic Detection Type Selected [:SENSe]:DETector:AUTO OFF|ON|0|1 [:SENSe]:DETector:AUTO? Switches automatically to the optimum detection type for typical measurements using the current instrument settings.
5 Command Reference Type of Detection [:SENSe]:DETector[:FUNCtion]NEGative|POSitive|SAMPle|AVERage|RMS|NORMAL [:SENSe]:DETector[:FUNCtion]? Specifies the detection mode. For each trace interval (bucket), average detection displays the average of all the samples within the interval. The averaging can be done using two methods: the power method (RMS) the video method (Y Axis Units) The method is controlled by BW/ Avg > > Avg Type.
Command Reference 5 [:SENSe]:FREQuency Subsection Center Frequency [:SENSe]:FREQuency:CENTer [:SENSe]:FREQuency:CENTer UP|DOWN [:SENSe]:FREQuency:CENTer? Set the center frequency. *RST: Range: Key access: 1.500 GHz –80 MHz through 3.08 GHz Frequency > Center Freq 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.
5 Command Reference *RST: Default Unit: Key access: 3.0 GHz Hz SPAN > Span|Zero Span Full Frequency Span [:SENSe]:FREQuency:SPAN:FULL Set the frequency span to full scale. *RST: Key access: 3.0 GHz SPAN > Full Span Last Frequency Span [:SENSe]:FREQuency:SPAN:PREVious Set the frequency span to the previous span setting. Key access: SPAN > Last Span Start Frequency [:SENSe]:FREQuency:STARt [:SENSe]:FREQuency:STARt? Set the start frequency.
Command Reference 5 [:SENSe]:POWer Subsection Input Attenuation [:SENSe]:POWer[:RF]:ATTenuation [:SENSe]:POWer[:RF]:ATTenuation? Set the input attenuator. This value is set at its auto value if input attenuation is set to auto.
5 Command Reference [:SENSe]:SWEep Subsection Sweep Time [:SENSe]:SWEep:TIME
Command Reference 5 SOURce Subsystem The SOURce subsystem controls the signal characteristics of the tracking generator. Refer also to the “OUTPut Subsystem” on page 89 which contains a command that controls the tracking generator output. Sets the Output Power Offset Correction :SOURce:CORRection:OFFSet :SOURce:CORRection:OFFSet? Specifies an offset for the displayed output power level.
5 Command Reference Automatic Source Attenuation :SOURce:POWer:ATTenuation:AUTO OFF|ON|0|1 :SOURce:POWer:ATTenuation:AUTO? Selects if the source output level attenuator will be set automatically, or manually. *RST: Key Access: On MODE > Tracking Generator > Attenuation Auto Man Sets the Output Power :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Specifies the source output power level.
Command Reference 5 Set the Source Sweep Power Range :SOURce:POWer:SPAN :SOURce:POWer:SPAN? Specifies the range of power levels through which the source output will sweep. Use :SOURce:POWer:STARt to set the power level at the start of the power sweep. This command is equivalent to :SOURce:POWer:SWEep.
5 Command Reference Range: Remarks: Key Access: Integer, 0 to 4095 This command is not needed with the 1.5 GHz tracking generator. MODE > Tracking Generator > More > Man Track Adj Output Power Tracking Peak :SOURce:POWer:TRCKing:PEAK Automatically adjusts the tracking of the source output with the spectrum analyzer sweep so that the power is maximized for the present resolution bandwidth. Remarks: Key Access: 128 This command is not applicable for the 1.5 GHz tracking generator.
Command Reference 5 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. Hardware Configuration Query :SYSTem:CONFigure:HARDware? Returns string of information about the current hardware in the instrument.
5 Command Reference Display Software Information :SYSTem:CONFigure:SOFTware:STATe OFF|ON|0|1 :SYSTem:CONFigure:SOFTware:STATe? Turns on/off the display of the current Software information. *RST: Key access: Off Preset/ System > More > Show software System Configuration Query :SYSTem:CONFigure[:SYSTem]? Returns string of information about the configurations of the instrument.
Command Reference 5 Error Information Query :SYSTem:ERRor[:NEXT]? This command queries the earliest entry to the error queue and then deletes that entry. *CLS clears the entire error queue. Key access: Preset/ System > More > Show Errors Query Instrument Options :SYSTem:OPTions? Returns a list of the options that are installed.
5 Command Reference Persistent State Reset :SYSTem:PRESet:PERSistent Sets the persistent state values to their factory defaults. The term persistent means that the command retains the setting previously selected, even through a power cycle. Examples of persistent functions are: power- on type, and preset type. Preset Type *RST: Remarks: Key access: :SYSTem:PRESet:TYPE FACTory|USER|LAST Selects the preset state to be either factory- defined or user- defined preset conditions.
Command Reference 5 TRACe Subsystem The TRACe subsystem controls access to the internal trace memory of the analyzer. Transfer Trace Data :TRACe[:DATA]? This command transfers trace data from the controller to the instrument. is TRACE1|2|3|4. This command is only available for SCPI programming. Example: :TRAC:DATA TRACE1 Remarks: Commands :MMEM:STOR:TRAC and :MMEM:LOAD:TRAC are used to transfer trace data to, or from, the internal drive.
5 Command Reference TRIGger Subsystem The TRIGger subsystem is used to set the controls and parameters associated with triggering the data acquisitions. Other trigger- related commands are found in the INITiate and ABORt subsystems.
Command Reference 5 display of trace data prior to the trigger event. A positive trigger offset value results in an effective delay in the display of trace data after the trigger event.
5 Command Reference Video Trigger Level Amplitude :TRIGger[:SEQuence]:VIDeo:LEVel :TRIGger[:SEQuence]:VIDeo:LEVel? Specifies the level at which a video trigger will occur. *RST: Range: Default Unit: Remarks: Key access: 2.5 divisions below reference level 10 display divisions below reference level to reference level current amplitude units Video is adjusted using this command, but must also be selected using the command :TRIGger[:SEQuence]:SOURce VIDeo.
Command Reference 5 UNIT Subsystem Select Power Units of Measure :UNIT:POWer DBM|DBMV|DBUV|DBUA|V|W|A :UNIT:POWer? Specifies amplitude units for the input, output and display.
5 138 Command Reference N9320A Programmer’s Guide
