Download
Share
Print this page
Anritsu Spectrum Master MS2721A Programming Manual
  1. Manuals
  2. Brands
  3. Anritsu Manuals
  4. Measuring Instruments
  5. Spectrum Master MS2721A
  6. Programming manual
Anritsu Spectrum Master MS2721A Programming Manual

Anritsu Spectrum Master MS2721A Programming Manual

Handheld spectrum analyzer
Hide thumbs Also See for Spectrum Master MS2721A:

Advertisement

Quick Links

Download this manual
Spectrum Master
™
MS2721A
Benchtop Performance in a Handheld Spectrum Analyzer
S331D
Site Master
SiteMaster
MS2711D
Spectrum Master
MT8212A
Cell Master
CellMaster
MS2712
SpectrumMaster
MS2712
MS2712
Programming Manual
SiteMaster
SpectrumMaster
CellMaster
www.valuetronics.com

Advertisement

loading
Need help?

Need help?

Do you have a question about the Spectrum Master MS2721A and is the answer not in the manual?

Questions and answers

Related Manuals for Anritsu Spectrum Master MS2721A

Summary of Contents for Anritsu Spectrum Master MS2721A

  • Page 1 Spectrum Master ™ MS2721A Benchtop Performance in a Handheld Spectrum Analyzer S331D Site Master SiteMaster MS2711D Spectrum Master MT8212A Cell Master CellMaster MS2712 SpectrumMaster MS2712 MS2712 Programming Manual SiteMaster SpectrumMaster CellMaster www.valuetronics.com...
  • Page 2 Marker to Reference Level ................... 14 Marker X Value ....................14 Marker Read Y Value ................... 14 DISPlay Subsystem....................15 Scale........................15 Reference Level ....................15 Reference Level Offset ..................15 10580-00104 Revision B April 2005 Copyright 2005 Anritsu Company www.valuetronics.com...
  • Page 3 FORMat Subsystem ....................16 Numeric Data Format.................... 16 INITiate Subsystem....................17 Continuous/Single Sweep ..................17 Trigger Sweep ....................... 17 INSTrument Subsystem .................... 18 Query Available Modes ..................18 Select Mode by Number..................18 Select Mode by Name ................... 18 MMEMory Subsystem ....................19 Recall Setup......................
  • Page 4 Query Installed Options ..................30 Preset ........................30 TRACe Subsystem ....................31 Trace Data Transfer....................31 Trace Header Transfer................... 31 TRIGger Subsystem ....................37 Trigger Source....................... 37 Video Trigger Level ....................37 Video Trigger Position ..................37 UNIT Subsystem ....................... 39 Measurement Units ....................
  • Page 5 ACPR Measurement State..................50 :SENSe:CHPower Subsystem ................... 51 Channel Power Integration Bandwidth ..............51 Channel Power Measurement State............... 51 :SENSe:OBWidth Subsystem ................... 51 Occupied Bandwidth Measurement Method............51 Occupied Bandwidth Percent of Power ..............52 Occupied Bandwidth Measurement State ............. 52 Occupied Bandwidth dB Down................
  • Page 6 1 Introduction Scope of this Manual This manual contains descriptions of the remote commands available for Anritsu’s line of Master™ products. While it does reference the equivalent front-panel interface for each command, it does not provide a complete front panel reference. Please see the appropriate product’s User’s Guide for that information.
  • Page 7 2 Programming Overview Controller Interface The physical interface is the RJ-45 connection on the instrument for 10BASE-T. Data transfer takes place over Ethernet using TCP/IP and the VXI-11 protocol. In order to communicate with the instrument the PC must have a VXI-11 client implementation either as part of the controller program or using a third party software package on the controlling PC.
  • Page 8 Subsystems A colon (‘:’) separates each subsystem. For example, the command :SENSe:FREQuency:STARt <freq> sets the start frequency. The start frequency is part of the :FREQuency subsystem which is part of the :SENSe subsystem. Stop frequency is also part of the :SENSe:FREQuency subsystem. It is specified by :SENSe:FREQuency:STOP.
  • Page 9 Creating Valid Commands Command Specification Valid Forms [:SENSe]:FREQuency:STARt The following all produce equivalent <freq> results: :SENSe:FREQuency:STARt 1 :SENS:FREQ:STAR 1 MHZ :sense:frequency:start 1000000 :FREQ:STAR 1000 KHZ :CALCulate:MARKer[1]|2|3| The first 2 commands set the location 4|5|6:X <x-parameter> of marker 1. The third command sets the location of marker 2.
  • Page 10 Conventions The following conventions have been used throughout the document. Notational Conventions This document uses several notational conventions. They are listed below. :COMMands:WILL:LOOK:LIKE:THIS Commands will be formatted to differentiate them from text descriptions. :COMMand:QUERies:LOOK:LIKE:THIS? The query form of the command will be followed by a “?”...
  • Page 11 Identifiers The following identifiers have been used throughout the remote command definitions. Descriptions are provided here. In most cases, units will be specified with the individual command. Identifier Description <amplitude> Amplitude value. Units specified with the command. <freq> Frequency. Units specified with the command. <integer>...
  • Page 12 *IDN? This command returns the following information in <string> format separated by commas: manufacturer name (“Anritsu”), model number/options, serial number, firmware package number. Note that the model number and options will be separated by a “/” and each option will be separated by a “/”.
  • Page 13 3.2 Spectrum Analyzer ABORt Subsystem This subsystem relates to instrument triggering. It contains only the single command :ABORT. Related commands can be found in the INITiate and TRIGger subsystems. Abort :ABORt Restarts the current sweep and/or measurement. Resets the trigger system. If :INITiate:CONTinuous is OFF (i.e.
  • Page 14 CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. :CALCulate:MARKer Subsystem This subsystem contains commands related to the function and display of trace markers. Marker (Maximum) Peak Search :CALCulate:MARKer[1]|2|3|4|5|6:MAXimum Puts the specified marker at the maximum amplitude in the trace. Marker, [Marker 1/2/3/4/5/6/,] Peak Search Front Panel Access: Marker, More Peak Options, Peak Search...
  • Page 15 Marker Frequency to Center :CALCulate:MARKer[1]|2|3|4|5|6[:SET]:CENTer Sets the center frequency equal to the frequency of the specified marker. Note that this will result in a change to the start and stop frequencies and may also result in a change to the span. Marker, Marker Freq to Center Front Panel Access: Marker to Reference Level...
  • Page 16 DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data is returned to the controller. Scale :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Sets the scale (dB/division) for the y-axis. Factory Preset / MS2721A: 10 dB/div *RST:...
  • Page 17 FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it will be noted in the command description. Numeric Data Format :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? This command specifies the format in which data is returned in certain commands.
  • Page 18 INITiate Subsystem This subsystem works with the ABORt and TRIGger subsystems to control the triggering of a sweep. Continuous/Single Sweep :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Specifies whether the sweep is triggered continuously. If the value is set to ON or 1, another sweep is triggered as soon as the current sweep completes.
  • Page 19 INSTrument Subsystem One instrument may contain many logical instruments (“modes”). This subsystem controls the selection of the current instrument mode. Query Available Modes :INSTrument:CATalog:FULL? Returns a comma-separated list of available modes. Mode names are enclosed in double quotes (“ ”). Immediately following the string name is the application number. For example: “SPA”1,“MODE2”2 Front Panel Access: Shift-9 (Mode)
  • Page 20 MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument’s setup and data storage. Recall Setup :MMEMory:LOAD:STATe <integer>,<file name> Loads the current setup from the file specified by <file name>. The instrument must be in the mode of the saved setup in order to recall that setup. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode.
  • Page 21 Stores the trace in trace A into the file specified by <file name>. <file name> should be enclosed in either single quotes (‘’) or double quotes (“”) and should not contain a file extension. The <integer> parameter is not currently used, but it must be sent. Send a 0. Shift-7 (File), Save Recall, Save Measurement Front Panel Access: :MMEMory:LOAD:TRACe...
  • Page 22 SENSe Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. :SENSe:AVERage Subsystem This subsystem contains commands related to the combination of the data from consecutive sweeps. Use commands in this subsystem to control sweep-to-sweep averaging, min hold and max hold functionality. Number of Traces to Average [:SENSe]:AVERage:COUNt <integer>...
  • Page 23 Resolution Bandwidth [:SENSe]:BANDwidth|BWIDth[:RESolution] <freq> [:SENSe]:BANDwidth|BWIDth[:RESolution]? Sets the resolution bandwidth. Note that using this command turns the automatic resolution bandwidth setting OFF. Factory Preset / *RST: MS2721A: 3 MHz Range: MS2721A: 10 Hz to 3 MHz in a 1:3 sequence Default Unit: BW, RBW Front Panel Access: [:SENSe]:BANDwidth|BWIDth[:RESolution]:AUTO...
  • Page 24 [:SENSe]:BANDwidth|BWIDth:VIDeo? Sets the video bandwidth. Note that using this command turns the automatic video bandwidth setting OFF. Factory Preset / *RST: MS2721A: 1 MHz Range: MS2721A: 1 Hz to 3 MHz in a 1:3 sequence Default Unit: BW, VBW Front Panel Access: [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO See Also: Video Bandwidth Coupling...
  • Page 25 (dBm vs. dBV vs. Volts, etc.). If the value of <integer> is 50 no correction will be performed. If the value of <integer> is 75 correction will be done based on Anritsu adapter 12N50-75B. If the value of <integer> is anything else it will look to the value set by [:SENSe]:CORRection:IMPedance[:INPut]:OFFSet for the amplitude correction value.
  • Page 26 Each display point represents several measurements. The detection type determines how the display point is derived from its associated measurements. POSitive Peak detection displays the maximum value of the associated measurements. RMS detection displays the average power of the associated measurements. NEGative Peak detection displays the minimum value of the associated measurements.
  • Page 27 Frequency Span - Full [:SENSe]:FREQuency:SPAN:FULL Sets the frequency span to full span. Note that changing the value of the frequency span will change the value of the coupled parameters, Start Frequency and Stop Frequency and may change the Center Frequency. MS2721A: 7.1 GHz Factory Preset / *RST: Span, Full Span...
  • Page 28 :SENSe:POWer Subsystem This system relates to the power amplitude parameters of the instrument. Input Attenuation [:SENSe]:POWer[:RF]:ATTenuation <rel ampl> [:SENSe]:POWer[:RF]:ATTenuation? Sets the input attenuation. Note that issuing this command will set the automatic input attenuation OFF. MS2721A: 30 dB Factory Preset / *RST: Range: MS2721A: 0 dB to 65 dB Default Unit:...
  • Page 29 :SENSe:SWEep Subsystem This subsystem controls the timebase of the instrument. Minimum Sweep Time [:SENSe]:SWEep:TIME [:SENSe]:SWEep:TIME? Sets the value of the minimum sweep time parameter. The sweep will complete in the shortest time possible greater than the specified time. To sweep as fast as possible, enter the minimum value allowed for the sweep time. MS2721A: 50 µs Factory Preset / *RST: Range:...
  • Page 30 STATus Subsystem This subsystem controls the SCPI status reporting structure. Query Operation Status :STATus:OPERation? This command requests information about the current status of the instrument. Each bit of the return value represents some operation. Only a subset of the bits will be implemented for each application.
  • Page 31 SYSTem Subsystem This subsystem contains commands that affect instrument functionality that does not directly relate to data collection, display or transfer. Query Installed Options :SYSTem:OPTions? Returns a string of the installed options. Options will be separated by a “/”. The string will be empty if no options are installed. *IDN? See Also: Preset...
  • Page 32 TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. Trace Data Transfer :TRACe[:DATA] [1]|2|3,<header><block> :TRACe[:DATA]? [1]|2|3 This command transfers data from the controlling program to the instrument. The query form transfers trace data from the instrument to the controller. Data is transferred in both directions as <header><block>.
  • Page 33 Valid parameter names are: Parameter Name Description Instrument serial # UNIT_NAME Instrument name DESCR Trace name DATE Trace date/time BASE_VER Base FW version APP_NAME Application name APP_VER Application FW version Parameter Name Description UNITS Amplitude units CENTER_FREQ Center freq SPAN Frequency span FREQ_STEP Frequency step size...
  • Page 34 CURRENT_CHANNEL Current signal channel TRACE_MODE Normal/Avg/Max TRACE_STATUS TRACE_A_VIEW_NOT_BLANK 0x0000000000000001 TRACE_A_WRITE_NOT_HOLD 0x0000000000000002 TRACE_A_DATA_VALID 0x0000000000000004 TRACE_B_VIEW_NOT_BLANK 0x0000000000010000 TRACE_B_WRITE_NOT_HOLD 0x0000000000020000 TRACE_B_DATA_VALID 0x0000000000040000 TRACE_C_VIEW_NOT_BLANK 0x0000000100000000 TRACE_C_WRITE_NOT_HOLD 0x0000000200000000 TRACE_C_DATA_VALID 0x0000000400000000 TRACE_C_IS_B_MINUS_A_ON 0x0000001000000000 TRACE_C_IS_A_MINUS_B_ON 0x0000002000000000 TRACE_COUNT Number of traces averaged UI_DATA_POINTS Number of display points IMPEDANCE Input impedance REFERENCE_ Reference freq...
  • Page 35 PERCENT OCC_BW_VALUE Measured occupied bandwidth OCC_BW_LINE_ Mask off 16 bits at a time to get the display point location of MARKER_INFO the 3 OBW display indicators CH_PWR_WIDTH Channel power integration bandwidth CH_PWR_VALUE Measured channel power CH_PWR_DENSITY Measured channel power density CH_PWR_LINE_ Mask off 16 bits at a time to get the display point location of MARKER_INFO...
  • Page 36 CI_I_NB_VALUE C/I measurement measured narrowband interference power CI_I_WB_VALUE C/I measurement measured wideband interference power CI_BB_VALUE C/I measurement with broadband interference CI_NB_VALUE C/I measurement with narrowband interference CI_WB_VALUE C/I measurement with wideband interference Parameter Name Description MKR_REF_FREQNx Reference marker x frequency (where x is the marker number 0-5) MKR_REF_POINTx Reference marker x display point...
  • Page 37 LIMIT_FLAG_UPPER 0x00000001 LIMIT_FLAG_ON 0x00000004 LIMIT_FLAG_ALARM_ON 0x00000002 LIMIT_FLAG_SEGMENTED 0x00000020 LIMIT_FLAG_ALARM_EVENT 0x00000040 LIMIT_FLAG_LEFT_OF_START_FREQ 0x00000080 LIMIT_FLAG_RIGHT_OF_STOP_FREQ 0x00000100 LIMIT_FLAG_MASK 0x000007FF LIM_NUMPTS_UP-1 Number of upper limit points LIM_FREQNC_UPx Upper limit point x freq (where x is the limit point number starting with 0) LIM_MAGNTD_UPx Upper limit point x amplitude LIM_LFLAGS_LO-1 Lower limit flags: LIMIT_FLAG_UPPER...
  • Page 38 TRIGger Subsystem This subsystem contains commands related to the triggering of instrument functions for the purposes of synchronization. Related commands appear in the ABORt and INITiate subsystems. Trigger Source :TRIGger[:SEQuence]:SOURce IMMediate|EXTernal|VIDeo :TRIGger[:SEQuence]:SOURce? This command defines the trigger source. IMMediate triggering is the equivalent of free-run triggering. EXTernal triggering is triggered when a TTL signal is applied to the External Trigger input connector.
  • Page 39 Front Panel Access: Shift-3 (Sweep), Trigger Type, Change Trigger Position www.valuetronics.com...
  • Page 40 UNIT Subsystem The unit subsystem is used to modify the default units used for related parameters. These changes affect parameters in both commands and responses. Measurement Units :UNIT:POWer DBM|DBV|DBMV|DBUV|V|W :UNIT:POWer? Sets the default amplitude units for input, output and display. MS2721A: dBm Factory Preset / *RST: Front Panel Access:...
  • Page 41 4 Measurement Commands Measurement Command Overview The measurement commands provide a high-level set of commands to access instrument- specific measurements. While the group of measure instructions is defined in the SCPI standard, the implementation of many specific measurements is not. The five measurement instructions are defined below.
  • Page 42 4.1 Spectrum Analyzer CONFigure Commands This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It will not initiate the taking of a measurement.
  • Page 43 See Also: :SENSe:CHPower:STATe :SENSe:CHPower:BANDwidth|BWIDth:INTegration Configure Occupied Bandwidth :CONFigure:OBWidth Configures the default occupied bandwidth measurement. Disables any other active one-button measurements, including channel power, ACPR, AM/FM demodulation and C/I. Sets the method to %. Sets the % of power to 99%. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF).
  • Page 44 FETCh Commands This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To get new measurement data, use the READ command. Fetch Adjacent Channel Power Ratio :FETCh:ACPower? Returns the most recent adjacent channel power ratio measurement results. Data is returned as 3 comma-separated values: main channel power, lower adjacent channel power, upper adjacent channel power.
  • Page 45 Returns the most recent occupied bandwidth measurement results: occupied bandwidth, percent of power and dB down. One of either percent of power or dB down will be measured and the other will be set. That will be determined by the value set using [:SENSe]:OBWidth:METHod. Data is returned as 3 comma-separated values: occupied bandwidth, percent of power, dB down.
  • Page 46 MEASure Commands These command take the instrument from its current state, enable the specified measurement and put the instrument into single sweep mode. They correct any parameters that are invalid given the new measurement state such that a valid measurement can take place. Other settings may be changed; see the documentation of CONFigure for each measurement.
  • Page 47 To make a channel power measurement with settings other than the default values send • :CONFigure:CHPower • Commands to set desired settings • :READ:CHPower? Data is returned as 2 comma-separated values: channel power, channel power density. Default Units: Current amplitude units See Also: :MEASure:CHPower:CHPower? :MEASure:CHPower:DENSity?
  • Page 48 Default Units: Current amplitude units See Also: :MEASure:CHPower? :MEASure:CHPower:CHPower? :CONFigure:CHPower Measure Occupied Bandwidth :MEASure:OBWidth? Sets the active measurement to occupied bandwidth, sets the default measurement parameters, triggers a new measurement and returns the occupied bandwidth, percent of power and dB down results. It is a combination of the commands :CONFigure:OBWidth;:READ:OBWidth? For a description of the default occupied bandwidth measurement parameters see :CONFigure:OBWidth.
  • Page 49 READ Commands This set of commands combines the ABORt, INITiate and FETCh commands. It aborts any current triggering sequence and sets the trigger state to idle. It then initiates a new active measurement (i.e. begins the collection of new data). When the measurement is complete, it returns the result.
  • Page 50 The channel power measurement must be the active measurement (specified by :CONFigure:CHPower). The current measurement can be queried using :CONFigure? Default Units: Current amplitude units See Also: :READ:CHPower? :READ:CHPower:DENSity? :CONFigure Read Channel Power Density :READ:CHPower:DENSity? Triggers a new channel power measurement and returns the channel power density result. It is a combination of the commands :ABORT;:INITiate;:FETCh:CHPower:DENSity? It returns only the channel power density, not the channel power.
  • Page 51 SENSe (Measurement Command) Subsystem This subsystem contains commands related to preparing the instrument to make a particular measurement. These measurements are not defined in the SCPI standard so they are maintained separately here. :SENSe:ACPower Subsystem This subsystem includes commands related to configuring the adjacent channel power ratio measurement.
  • Page 52 MS2721A: OFF Factory Preset / *RST: Shift-4 (Measure), ACPR, On/Off Front Panel Access: See Also: :CONFigure:ACPower :SENSe:CHPower Subsystem This subsystem includes commands related to configuring the channel power measurement. Channel Power Integration Bandwidth [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration <freq> [:SENSe]:CHPower:BANDwidth|BWIDth:INTegration? Sets the integration bandwidth for the channel power measurement. Integration bandwidth must be less than or equal to the frequency span.
  • Page 53 MS2721A: PERCent Factory Preset / *RST: Shift-4(Measure), OCC BW, % Down|dBc Down Front Panel Access: See Also: [:SENSe]:OBWidth:XDB [:SENSe]:OBWidth:PERCent Occupied Bandwidth Percent of Power [:SENSe]:OBWidth:PERCent <percentage> [:SENSe]:OBWidth:PERCent? This command sets the percentage of carrier power used to measure the occupied bandwidth.
  • Page 54 Appendix A Examples C/C++ This example is run on the command line. It sends the *IDN? query to the instrument and prints the response to the console. // IdnExample.cpp : Microsoft Visual Studio-Generated Example Based on Example 2-1 in the NI-VISA User Manual Usage : IdnExample "TCPIP::xxx.xxx.xxx.xxx:inst0:INSTR"...
  • Page 55 /* Open communication with TCP/IP device at xxx.xxx.xxx.xxx*/ /* NOTE: For simplicity, we will not show error checking*/ /* TODO: Add error handling. */ status = viOpen(defaultRM, pAddress, VI_NULL, VI_NULL, &instr); /* Set the timeout for message-based communication*/ /* TODO: Add error handling. */ status = viSetAttribute(instr, VI_ATTR_TMO_VALUE, 5000);...
  • Page 56 Visual Basic This function can be called in a Visual Basic program. It sends the *IDN? query to the instrument and returns the byte count and ASCII response string. Rem This example is based on Example 2-1 from the NI-VISA User Manual. Public Sub IdnMain(ByVal address As String, ByRef byteCount As String, ByRef returnBytes As String) Const BUFFER_SIZE = 200...
  • Page 57 LabVIEW™ This example shows how to read the trace data from the instrument in 32-bit integer format. The output is an array of data point magnitudes. The first .vi pictured shows the data capture. The second .vi does the conversion. www.valuetronics.com...
  • Page 58 www.valuetronics.com...
  • Page 59 Revision History Manual Section Name Date /Command Name Change Description 1/31/05 Initial release Manual Revision B (10580-00104A.pdf) Released 3/17/05 :TRACe[:DATA] Source/destination trace is now specified :TRACe[:DATA]? only as a number (A=1, B=2, C=3). Data can be sent to the instrument using :TRACe[:DATA] only in ASCII form.