Anritsu Spectrum Master MS2721B Programming Manual
  1. Manuals
  2. Brands
  3. Anritsu Manuals
  4. Measuring Instruments
  5. Spectrum Master MS2721B
  6. Programming manual

Anritsu Spectrum Master MS2721B Programming Manual

A high performance handheld spectrum analyzer and base station analyzer
Hide thumbs Also See for Spectrum Master MS2721B:
Table of Contents

Advertisement

Quick Links

Spectrum Master
™
MS2721B, MS2723B, and MS2724B
A High Performance Handheld Spectrum Analyzer and Base Station Analyzer
Programming Manual

Advertisement

Table of Contents
loading
Need help?

Need help?

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

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for Anritsu Spectrum Master MS2721B

Summary of Contents for Anritsu Spectrum Master MS2721B

  • Page 1 Spectrum Master ™ MS2721B, MS2723B, and MS2724B A High Performance Handheld Spectrum Analyzer and Base Station Analyzer Programming Manual...

  • Page 2: Table Of Contents

    Table of Contents Table of Contents........................ 1 1 Introduction........................9 Scope of this Manual ....................9 References........................9 Trademark Acknowledgments ..................9 Firmware Revisions ....................9 2 Programming Overview....................10 Controller Interface....................10 Command Structure ....................10 Format ........................10 Command Tree......................
  • Page 3 Limit Point Y Value....................18 Limit State......................19 Limit Type ......................19 Upper Limit Alarm ....................19 Number of Upper Limit Points ................20 Upper Limit State....................20 Move Limit ......................20 :CALCulate:MARKer Subsystem ................20 Turn All Markers Off.................... 21 Delta Marker State ....................
  • Page 4 Resolution Bandwidth................... 30 Resolution Bandwidth Coupling................30 Resolution Bandwidth to Span Ratio..............31 Video Bandwidth ....................31 Video Bandwidth Coupling .................. 31 Video Bandwidth to Resolution Bandwidth Ratio..........32 CORRection Subsystem.................... 32 Input Impedance....................32 “Other” Input Impedance Loss ................33 [:SENSe]:DETector Subsystem ................
  • Page 5 Marker X Value ....................47 Marker Read Y Value ................... 47 Display Subsystem....................47 Power Offset ......................47 Scale........................48 Format Subsystem..................... 48 Numeric Data Format ................... 48 INITiate Subsystem ....................49 Continuous/Single Sweep ..................49 Trigger Sweep/Measurement ................49 INSTrument Subsystem ....................
  • Page 6 Fetch Adjacent Channel Power Ratio ..............62 Fetch Channel Power/Density................62 Fetch Channel Power .................... 62 Fetch Channel Power Density................62 Fetch Occupied Bandwidth................... 63 Fetch Tracking Generator Absolute Statistics ............63 Fetch Tracking Generator Relative Statistics ............63 MEASure Commands ....................64 Measure Adjacent Channel Power Ratio ..............
  • Page 7 Tracking Generator Reference Level Offset............76 4.3 WCDMA......................... 76 CONFigure Commands .................... 76 Configure Demodulation Measurement..............77 Configure Over-The-Air Measurement ..............77 Configure PASS/FAIL Measurement ..............78 Configure RF Measurement.................. 78 Configure Summary Measurement ............... 79 FETCh Commands....................79 Fetch Adjacent Channel Leakage Ratio..............79 Fetch Channel Power ....................
  • Page 8 READ Commands ....................93 Read Adjacent Channel Leakage Ratio (ACLR) ..........93 Read Channel Power..................... 94 Read Active Code Domain Channel Count ............94 Read Code Domain Power..................94 Read Carrier Feed Through .................. 95 Read Error Vector Magnitude (EVM) ..............95 Read Frequency Error ...................
  • Page 9 Visual Basic ........................ 109 LabVIEW™ ........................ 110 10580-00176...

  • Page 10: Introduction

    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 11: Programming Overview

    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 12: Subsystems

    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 13: Creating Valid Commands

    Creating Valid Commands Command Specification Valid Forms The following all produce equivalent [:SENSe]:FREQuency:STARt results: <freq> :SENSe:FREQuency:STARt 1 :SENS:FREQ:STAR 1 MHZ :sense:frequency:start 1000000 :FREQ:STAR 1000 KHZ The first 2 commands set the location :CALCulate:MARKer[1]|2|3| of marker 1. The third command sets 4|5|6:X <x-parameter>...

  • Page 14: Conventions

    Conventions The following conventions have been used throughout the document. Notational Conventions This document uses several notational conventions. They are listed below. Commands will be formatted to :COMMands:WILL:LOOK:LIKE:THIS differentiate them from text descriptions. :COMMand:QUERies:LOOK:LIKE:THIS? The query form of the command will be followed by a “?”...

  • Page 15: Identifiers

    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 value. Units specified with the command. <amplitude> Frequency. Units specified with the command. <freq>...

  • Page 16: Remote Commands

    *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 17: Gps On/Off

    GPS On/Off [:SENSe]:GPS OFF|ON|0|1 [:SENSe]:GPS? Enables/disables optional GPS capability. Factory Preset / *RST: Front Panel Access: Shift-8(System), GPS, GPS On/Off Required Options: Option 31 GPS Reset [:SENSe]:GPS:RESet Resets optional GPS reciever. Front Panel Access: Shift-8(System), GPS, Reset Required Options: Option 31 3.3 Spectrum Analyzer Abort Subsystem The abort subsystem includes commands that allow the user to stop current measurement...

  • Page 18: Limit Alarm

    Limit Alarm :CALCulate:LIMit:ALARm OFF|ON|0|1 :CALCulate:LIMit:ALARm? Enables/disables the currently active limit line alarm. Setting the value to ON or 1 will turn on the limit alarm. Setting the value to OFF or 0 will turn off the limit alarm. The query version of the command returns a 1 if the currently selected limit line alarm is set to ON and returns 0 if OFF.

  • Page 19: Number Of Limit Points

    It is a combination of the commands :CALCulate:LIMit:TYPe 1; :CALCulate:LIMit:STATe ON|OFF. The query version of the command returns a 1 if the lower limit line is ON and returns a 0 if OFF. Factory Preset / *RST: Front Panel Access: Shift-6 (Limit), On/Off See Also: :CALCulate:LIMit[:STATe]...

  • Page 20: Limit State

    The query version of the command returns the location of the active limit point on the y- axis. Use :CALCulate:LIMit:TYPe to set the currently active limit line. Front Panel Access: Shift-6 (Limit), Limit Edit, Amplitude Default Unit: Current y-axis unit. See Also: :CALCulate:LIMit:TYPe Limit State...

  • Page 21: Number Of Upper Limit Points

    The query version of the command returns a 1 if the upper limit line alarm is ON and returns 0 if OFF. Factory Preset / *RST: Front Panel Access: Shift-6 (Limit), Limit Alarm See Also: :CALCulate:LIMit:ALARm Number of Upper Limit Points :CALCulate:LIMit:UPPer:POINt? Returns the number of points currently in the upper limit line.

  • Page 22: Turn All Markers Off

    Turn All Markers Off :CALCulate:MARKer:AOFF Turns off all markers. Front Panel Access: VNA: Marker, All Markers Off SPA: Marker, More, All Markers Off WCDMA: Marker, All Markers Off Delta Marker State :CALCulate:MARKer[1]|2|3|4|5|6:DELTa[:STATe] OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6:DELTa[:STATe]? Sets the specified delta marker on/off. Factory Preset / *RST: Front Panel Access: Marker, Delta...

  • Page 23: Marker (Maximum) Peak Search Left

    Marker (Maximum) Peak Search Left :CALCulate:MARKer[1]|2|3|4|5|6:MAXimum:LEFT Puts the specified marker on the next highest peak to the left of the current peak. The next highest peak must be above the peak threshold. If no point meets that criterion, the marker is set to the first point on the trace. Note that this command is valid only if the specified marker is on.

  • Page 24: Marker To Reference Level

    Front Panel Access: Marker, Marker Freq to Center Marker to Reference Level :CALCulate:MARKer[1]|2|3|4|5|6[:SET]:RLEVel Sets the reference level equal to the measured amplitude of the specified marker. Note that this may result in a change to the input attenuation. Front Panel Access: Marker, Marker to Ref Lvl Marker State :CALCulate:MARKer[1]|2|3|4|5|6[:STATe] OFF|ON|0|1...

  • Page 25: Reference Level

    Factory Preset / 10 dB/div *RST: Range: 1 dB to 15 dB Default Unit: Front Panel Access: Amplitude, Scale Reference Level :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel <amplitude> :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel? Sets the reference level amplitude value for the y-axis. Note that this may cause a change in attenuation if the automatic input attenuation coupling is enabled.

  • Page 26: Initiate Subsystem

    :FORMat[:READings][:DATA]? This command specifies the format in which data is returned in certain commands. ASCii format returns the data in comma-separated ASCII format. The units are the current instrument units. This format requires many more bytes so it will be the slowest format.

  • Page 27: Trigger Sweep/Measurement

    SPA/WCDMA: Shift-3 (Sweep), Sweep (Single/Continuous) Front Panel Access: VNA: Shift-3 (Sweep), Sweep Type See Also: :INITiate[:IMMediate] Trigger Sweep/Measurement :INITiate[:IMMediate] Initiates a sweep/measurement. If :INITitate:CONTinuous is set to ON, this command is ignored. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data.

  • Page 28: Query Available Modes

    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,“WCDMA”5,”VNA”2 Front Panel Access: Shift-9 (Mode) Select Mode by Number :INSTrument:NSELect <integer>...

  • Page 29: Mmemory Subsystem

    Front Panel Access: Shift-9 (Mode) See Also: :INSTrument:CATalog:FULL? :INSTrument:NSELect MMEMory Subsystem The Mass MEMory subsystem contains functions that provide access to the instrument’s setup and data storage. Delete Setup/Measurement :MMEMory:DELete <file name> Deletes the measurement or setup file specified by <file name>. <file name>...

  • Page 30: Save Setup

    File Extensions: “.spa” Front Panel Access: Shift-7 (File), Recall, Recall Measurement See Also: :MMEMory:STORe:TRACe Save Setup :MMEMory:STORe:STATe <integer>,<file name> Stores the current setup 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.

  • Page 31: Trace Mode (Normal/Average/Max Hold/Min Hold)

    Trace Mode (Normal/Average/Max Hold/Min Hold) [:SENSe]:AVERage:TYPE NONE|SCALar|MAXimum|MINimum [:SENSe]:AVERage:TYPE? Specifies how successive traces are combined to produce the resulting display value. Setting the TYPE to NONE is the equivalent of setting the Trace Mode to “Norm” on the front panel. The displayed value for a point will be the current measured value for that point.

  • Page 32: Resolution Bandwidth To Span Ratio

    Sets the state of the coupling of the resolution bandwidth to the frequency span. Setting the value to ON or 1 will result in the resolution bandwidth being coupled to the span. That is, when the span changes, the resolution bandwidth changes. Setting the value to OFF or 0 will result in the resolution bandwidth being un-coupled from the span.

  • Page 33: Video Bandwidth To Resolution Bandwidth Ratio

    Sets the input impedance that will be used for amplitude correction and conversion between units (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. 10580-00176...

  • Page 34: Other" Input Impedance Loss

    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. Unit conversion will be done as if the impedance is 75Ω. If a value other than 50 or 75 is set, it will be returned as 2 by the query form of this command.

  • Page 35: [:Sense]:Frequency Subsystem

    SAMPle detection displays the “middle” point of those measurements associated with a display point. For example, if there are 3 measurement frequencies associated with a given display point, sample detection will display the value at the frequency of the second measurement point. (Positive) Peak Factory Preset / *RST: Front Panel Access:...

  • Page 36: Frequency Span - Last

    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. 7.1 GHz Factory Preset / *RST: Front Panel Access: Span, Full Span Frequency Span - Last [:SENSe]:FREQuency:SPAN:PREVious Sets the frequency span to the previous span value.

  • Page 37: [:Sense]:Power Subsystem

    SPA: 7.1 GHz Factory Preset / *RST: VNA, MS2012A: 2.5 GHz VNA, MS2024A: 4.0 GHz VNA, MS2026A: 6.0 GHz Range: SPA: 10 Hz – 7.1 GHz VNA, MS2012A: 2 MHz – 2.5 GHz VNA, MS2024A: 2 MHz – 4.0 GHz VNA, MS2026A, 2 MHz –...

  • Page 38: Preamp State

    Preamp State [:SENSe]:POWer[:RF]:GAIN[:STATe] OFF|ON|0|1 [:SENSe]:POWer[:RF]:GAIN[:STATe]? Sets the state of the preamp. Note that this may cause a change in the reference level and/or attenuation. Factory Preset / *RST: Front Panel Access: Amplitude, Pre Amp [:SENSe]:SWEep Subsystem This subsystem includes commands that affect the sweep generator of the instrument. Minimum Sweep Time [:SENSe]:SWEep:TIME [:SENSe]:SWEep:TIME?

  • Page 39: System Subsystem

    Not implemented Not implemented Not implemented Not implemented Not implemented Sweep Complete – This bit will be set to 0 when the command :INITiate[:IMMediate] is sent to trigger a sweep. It will have a value of 1 when the sweep has completed.

  • Page 40: Trace Subsystem

    :TGENerator:OUTput:POWer? Sets the output power for the Tracking Generator. Factory Preset / -40 dBm *RST: Range: 0 dBm to -40 dBm Default Unit: Current active amplitude unit Front Panel Access: SPA: Shift-4 (Measurements), Tracking Generator, Output Power See Also: :INITiate[:TGENerator] Trace Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument.

  • Page 41: Trace Header Transfer

    Trace Header Transfer :TRACe:PREamble? [1]|2|3 Returns trace header information for the specified trace. Data can be transferred to and from the 3 available display traces. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. The response begins with an ASCII header.
  • Page 42 REFERENCE_LEVEL Reference level SCALE Y-axis scale PREAMP_SET Preamp state REF_LEVEL_OFFSET Reference level offset DETECTION Detection type TRACE_AVERAGE Number of traces to average SWEEP_TYPE Single/continuous CURRENT_SIGNAL Current signal index 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...
  • Page 43 ACTIVE_ Current measurement MEASUREMENT ANTENNA Antenna index OCC_BW_METHOD Occupied bandwidth method OCC_BW_PERCENT Occupied bandwidth % of power setting OCC_BW_DBC Occupied bandwidth dBc setting OCC_BW_MEASURED_ Occupied bandwidth measured dBc value OCC_BW_MEASURED_ Occupied bandwidth measured % value 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...
  • Page 44 AM_FM_DEMOD_TYPE AM/FM demod type AM_FM_DEMOD_TIME AM/FM demod time AM_FM_LINE_ Display point location of the demodulation frequency MARKER BEAT_FREQUENCY_ BFO oscillator freq OSC_FREQUENCY CI_C_TYPE C/I measurement carrier type CI_C_VALUE C/I measurement measured carrier power CI_I_BB_VALUE C/I measurement measured broadband interference power CI_I_NB_VALUE C/I measurement measured narrowband interference power CI_I_WB_VALUE...
  • Page 45 MKR_DLT_POINTx Delta marker x display point MKR_DLT_MAGNTx Delta marker x magnitude MKR_DLT_PRCNTx Delta marker x display percentage MKR_DLT_FLAGSx Delta marker x flags: Parameter Name Description LIM_LFLAGS_UP-1 Upper limit flags: LIMIT_FLAG_UPPER 0x00000001 LIMIT_FLAG_ON 0x00000004 LIMIT_FLAG_ALARM_ON 0x00000002 LIMIT_FLAG_SEGMENTED 0x00000020 LIMIT_FLAG_ALARM_EVENT 0x00000040 LIMIT_FLAG_LEFT_OF_START_FREQ 0x00000080 LIMIT_FLAG_RIGHT_OF_STOP_FREQ 0x00000100 LIMIT_FLAG_MASK 0x000007FF...

  • Page 46: Trigger Subsystem

    Tracking Generator Option Only: Parameter Name Description TG_SET_ON_OFF Set tracking generator power; On/Off TG_SET_OUTPUT_POWER Set tracking generator output power; 0dBm to -40dBm TG_REFERENCE_LEVEL Tracking generator S21 normalized reference level; On/Off TG_SCALE Tracking generator specific scale for S21 normalized display only; +100 to -120 dBm TG_UNITS Tracking generator log / linear scale...

  • Page 47: Video Trigger Level

    EXTernal triggering is triggered when a TTL signal is applied to the External Trigger input connector. EXTernal triggering is always done on the rising edge of the signal. It is available only in zero span mode. VIDeo triggering is triggered based on the measured signal level. It is available only in zero span mode.

  • Page 48: 3.4 Wcdma

    :UNIT:POWer? Sets the default amplitude units for input, output and display. Factory Preset / *RST: Front Panel Access: Amplitude, Units, dBm|dBV|dBmV|dBuV|Volt|Watt 3.4 WCDMA Abort Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. Abort :ABORt Restarts the current sweep and/or measurement.

  • Page 49: Marker X Value

    Marker X Value :CALCulate:MARKer[1]|2|3|4|5|6:X <x-parameter> :CALCulate:MARKer[1]|2|3|4|5|6:X? Sets the location of the marker on the x-axis at the specified location. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the marker on the x-axis. Default Unit: Current x-axis unit Front Panel Access:...

  • Page 50: Format Subsystem

    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 51: Trigger Sweep/Measurement

    If continuous is set to OFF or 0, the instrument enters the “idle” state and waits for the :INITiate[:IMMediate] command or for :INITiate:CONTinuous ON. The default value is ON. That is, sending :INIT:CONT is equivalent to sending :INIT:CONT ON The query version of the command returns a 1 if the instrument is continuously sweeping/measuring and returns a 0 if the instrument is in single sweep/measurement mode.

  • Page 52: Select Mode By Number

    Select Mode by Number :INSTrument:NSELect <integer> :INSTrument:NSELect? Sets the instrument mode based on the value of <integer>. The query version returns the number associated with the current mode. Use :INSTrument:CATalog:FULL? to get a list of available mode names and their integer representations.

  • Page 53: Delete Setup/Measurement

    Delete Setup/Measurement :MMEMory:DELete <file name> Deletes the measurement or setup file specified by <file name>. <file name> should be enclosed in either single quotes (‘’) or double quotes (“”) and should contain a file extension “.stp” for setup and “.wcd” for measurement. Front Panel Access: Shift-7 (File), Delete, Delete Selected File See Also:...

  • Page 54: Save Measurement

    The <integer> parameter is not currently used, but it must be sent. Send a 0. Shift-7 (File), Save, Save Setup Front Panel Access: See Also: :MMEMory:LOAD:STATe Save Measurement :MMEMory:STORe:TRACe <integer>,<file name> Stores the trace in trace A into the file specified by <file name>. <file name>...

  • Page 55: Amplitude Range

    Setting the value to OFF or 0 will result in the input attenuation being un-coupled from the input signal level. That is, changing the input signal level will not change the amplitude range. When this command is issued, the amplitude range itself will not change.

  • Page 56: System Subsystem

    has completed. Not implemented 1024 Not implemented 2048 Not implemented 4096 Not implemented 8192 Not implemented 16384 Not implemented Will always be 0 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.

  • Page 57: Trace Header Transfer

    of bytes used to transfer each data point. Also note that the second argument must be enclosed in parentheses. The format of the block data in the query form is specified by :FORMat:DATA. The block data in the command form is always sent in ASCII format. Trace setup information can be acquired using :TRACe[:DATA]:PREamble?.
  • Page 58 Parameter Name Description Instrument serial # UNIT_NAME Instrument name TYPE The data type (Setup or Data) DESCR Trace name DATE Trace date/time BASE_VER Base FW version APP_NAME Application name APP_VER Application FW version APP_MODE Application Mode Parameter Name Description CENTER_FREQ Center frequency AUTO_SCRAMBLING_CODE Auto scrambling code detection on/off...
  • Page 59 ACLR_DISPLAY_GRAPH Display ACLR trace on/off MARKER_TABLE Marker table on/off OTA_AUTO_SC OTA auto scrambling code on/off OTA_CODE_LOCK OTA code lock on/off OTA_DISPLAY_VALUE Selected OTA display value OTA_SORT_PARAM Selected OTA sort parameter OTA_MANUAL_SC_1 Selected manual scrambling code 1 OTA_MANUAL_SC_2 Selected manual scrambling code 2 OTA_MANUAL_SC_3 Selected manual scrambling code 3 OTA_MANUAL_SC_4...
  • Page 60 RF_MKR_STATE_[1]|2|3|4|5|6 RF marker on/off Parameter Name Description DEMOD_MKR_POINT_[1]|2|3|4|5|6 Code domain marker point number DEMOD_MKR_STATE_[1]|2|3|4|5|6 Code domain marker on/off Parameter Name Description CODOGRAM_MKR_POINT_1 Codogram marker point number CODOGRAM_MKR_STATE_1 Codogram marker on/off CODOGRAM_MKR_TIME_1 Codogram marker time offset See Also: :TRACe:DATA 10580-00176...

  • Page 61: Measurement Commands

    4 Measurement Commands 4.1 System FETCh Commands This set of commands returns the most recent measured data. Fetch GPS Fix Data :FETCh:GPS? Returns the most recent GPS fix information from the optional GPS receiver. The results are returned as a set of comma-delimited values in this format: <fix status>,<date/time>,<latitude>,<longitude>.

  • Page 62: Configure Channel Power

    Sets the detection method to RMS. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF). Measurement settings can be modified by using the [:SENSe]:ACPower commands before initiating a sweep. See Also: [:SENSe]:ACPower:STATe [:SENSe]:ACPower:BANDwidth|BWIDth:MAIN [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent [:SENSe]:ACPower:BANDwidth|BWIDth:SPACing Configure Channel Power :CONFigure:CHPower Configures the default channel power measurement. Disables any other active one-button measurements, including ACPR, occupied bandwidth, AM/FM demodulation and C/I.

  • Page 63: Configure Tracking Generator 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). Measurement settings can be modified by using the [:SENSe]:OBWidth commands before initiating a sweep.

  • Page 64: Fetch Adjacent Channel Power Ratio

    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. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230.

  • Page 65: Fetch Occupied Bandwidth

    Returns the most recent channel power density measurement result. It returns only the channel power density, not the channel power. Use :FETCh:CHPower? to get both channel power and channel power density. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230.

  • Page 66: Measure Commands

    Data is returned as 3 comma-separated values: Insertion Loss Relative Max Power, Insertion Loss Relative Min Power, and Insertion Loss Relative Average Power. “---“ is returned for each data that is not valid at that instance. Default Units: Current amplitude units Required Options: MEASure Commands These command take the instrument from its current state, enable the specified...
  • Page 67 Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power and channel power density results. It is a combination of the commands :CONFigure:CHPower;:READ:CHPower? For a description of the default channel power measurement parameters see :CONFigure:CHPower.

  • Page 68: Measure Tracking Generator Absolute Statistics

    It is a combination of the commands :CONFigure:CHPower;:READ:CHPower:DENSity? For a description of the default channel power measurement parameters see :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send • :CONFigure:CHPower • Commands to set desired settings •...

  • Page 69: Read Commands

    For a description of the default tracking generator absolute statistics measurement parameters see :CONFigure:TGENerator ABSStats. To make an tracking generator absolute statistics measurement with settings other than the default values send • :CONFigure:TGENerator ABSStats • Commands to set desired settings •...

  • Page 70: Read Channel Power Density

    The channel power measurement must be the active measurement (specified by :CONFigure:CHPower). The current measurement can be queried using :CONFigure? Data is returned as 2 comma-separated values: channel power, channel power density. See Also: :READ:CHPower:CHPower? :READ:CHPower:DENSity? :CONFigure Read Channel Power :READ:CHPower:CHPower? Triggers a new channel power measurement and returns the channel power result.

  • Page 71: Read Occupied Bandwidth

    Read Occupied Bandwidth :READ:OBWidth? Triggers a new occupied bandwidth measurement and returns the results: occupied bandwidth, percent of power and dB down. It is a combination of the commands :ABORT;:INITiate;:FETCh:OBWidth? The occupied bandwidth measurement must be the active measurement (specified by :CONFigure:OBWidth).

  • Page 72: Sense (Measurement Command) Subsystem

    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 73: Sense]:Chpower Subsystem

    When using :CONFigure:ACPower, the state is automatically set to ON. Factory Preset / *RST: Front Panel Access: Shift-4 (Measure), ACPR, On/Off 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>...

  • Page 74: Field Strength Measurement State

    The <antenna> argument is a 1-based index of the position of the desired antenna in the instrument’s current antenna list. The list can be seen on the instrument by choosing the “Antenna” soft-key button in the “F Strength” menu. For example, if the desired antenna were the 3 item on the antenna listing then the value of the <antenna>...

  • Page 75: Occupied Bandwidth Percent Of Power

    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. This value is used in the measurement if :SENSe:OBWidth:METHod is set to PERCent. 99.00% Factory Preset / *RST: Range: 0% to 100% Default Unit:...

  • Page 76: Tracking Generator Absolute Statistic State

    Tracking Generator Absolute Statistic State [:SENSe]:TGENerator:ABSStats[:STATe] OFF|ON|0|1 [:SENSe]:TGENerator:ABSStats[:STATe]? Specifies whether the tracking generator absolute statistic is ON or OFF. If the value is set to ON or 1, the tracking generator absolute statistic is turned on. If the value is set to OFF or 0, the tracking generator absolute statistic is turned off. The query version of the command returns a 1 if the tracking generator absolute statistic is on and returns a 0 if the tracking generator is off.

  • Page 77: Tracking Generator Scale

    Factory Preset / *RST: Front Panel Access: Shift-4 (Measure), Tracking Generator, S21 Insertion Loss, S21 Max,Min,Avg (On/Off) Required Option: See Also: INITiate:TGENerator [:SENSe]:TGENerator:S21:NORMalize[:STATe] Tracking Generator Scale [:SENSe]:TGENerator:S21[:SCALe]:PDIVision <rel ampl> [:SENSe]:TGENerator:S21[:SCALe]:PDIVision? Sets the tracking generator scale (dB/division). Factory Preset / 10 dB/div *RST: Range: 1 dB to 15 dB...

  • Page 78: Wcdma

    Factory Preset / 0 dB *RST: Range: -100 dB to 100 dB Default Unit: Front Panel Access: Shift-4(Measure),Tracking Generator, S21 Insertion Loss, S21 RL Offset Required Options: See Also: INITiate:TGENerator [:SENSe]:TGENerator:S21[:SCALe]:RLEVel <amplitude> 4.3 WCDMA CONFigure Commands This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement.

  • Page 79: Configure Over-The-Air Measurement

    When the HSDPa option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then Demod, then Hsdpa from the front panel. See Also: [:SENSe]:DEMod:SCODe [:SENSe]:DEMod:SFACtor [:SENSe]:DEMod:THRShold [:SENSe]:DEMod:PICH [:SENSe]:DEMod:SCCPch Configure Over-The-Air Measurement :CONFigure:OTA This command configures the over-the-air measurement. It disables any other active measurements.

  • Page 80: Configure Rf Measurement

    Configure RF Measurement :CONFigure:RF SUMMary|SPECtrum|ACLR|EMISsion|BANDspectrum This command configures the selected RF measurement. It disables any other active measurements. None of the instrument parameters are changed by the execution of this command. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF). Measurement settings can be modified by using the [:SENSe]:RF commands before initiating a measurement.

  • Page 81: Fetch Commands

    PFail mode, the results are equivalent to those that are displayed by choosing Measurements, then Pass Fail Mode from the front panel. 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.

  • Page 82: Fetch Demodulated Channel Power

    Default Units: No units Fetch Demodulated Channel Power :FETCh:DEMod:CDPower? Returns the most recent absolute power measurement results for the requested logical channel. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

  • Page 83: Fetch Code Domain Noise Floor

    If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

  • Page 84: Fetch Transmitter Frequency

    Fetch Transmitter Frequency :FETCh:DEMod:TXFRequency? Returns the most recent transmitter frequency measurement results. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230. This could occur if there was a *RST immediately before the :FETCh? or if a measurement parameter was changed without an :INITiate.

  • Page 85: Fetch Spectral Emission Mask Template

    Default Units: No units Fetch Spectral Emission Mask Template :FETCh:EMISsion:TEMPlate? Returns the spectral emission mask template used for the most recent spectral emission mask measurement. Any violation of the spectral emission mask template will cause a FAIL result. If the instrument is sweeping, it will not return until the sweep is complete. If the instrument is not sweeping and the current data is not valid it will return error -230.

  • Page 86: Fetch Pass/Fail

    If valid results are not available in the requested position (1-6), the returned string will contain a series of 3 dashes “---“ instead of the numeric results. Default Units: Scrambling Code: No units CPICH power: dBm Chip Energy: dBm EC/I0: dB Pilot dominance: No units Fetch PASS/FAIL :FETCh:PFail?

  • Page 87: Measure Commands

    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 88: Measure Active Code Domain Channels

    For a description of the default channel power measurement parameters see :CONFigure:CHPower. To make a channel power measurement with settings other than the default values send • :CONFigure:CHPower • Commands to set desired settings • :READ:CHPower? Default Units: See Also: :CONFigure:CHPower Measure Active Code Domain Channels :MEASure:DEMod:ACTChannels?

  • Page 89: Measure Carrier Feed Through

    Results are returned as 4 comma-delimited values: CPICH power, PCCPCH power, PICH power, SCCPCH power. Default Units: See Also: :CONFigure:DEMod CDP Measure Carrier Feed Through :MEASure:DEMod:CFTHrough? Sets the active measurement to code domain power, sets the default measurement parameters, triggers a new measurement and returns the carrier feed through results. It is a combination of the commands :CONFigure:DEMod:CDP;:READ:DEMod:CFTHrough? For a description of the default code domain power measurement parameters see...

  • Page 90: Measure Frequency Error

    Measure Frequency Error :MEASure:DEMod:FERRor? Sets the active measurement to code domain power, sets the default measurement parameters, triggers a new measurement and returns the frequency error results. It is a combination of the commands:CONFigure:DEMod:CDP;:READ:DEMod:FERRor? For a description of the default code domain power measurement parameters see :CONFigure:DEMod:CDP.

  • Page 91: Measure Synch Channel Power

    To make an channel count measurement with settings other than the default values send • :CONFigure:DEMod CDP • Commands to set desired settings • :READ:DEMod:NUMChannels? Default Units: See Also: :CONFigure:DEMod CDP Measure Synch Channel Power :MEASure:DEMod:SPOWer? Sets the active measurement to code domain power, sets the default measurement parameters, triggers a new measurement and returns the synch channel power results.

  • Page 92: Measure Spectral Emission Mask

    Default Units: Hertz See Also: :CONFigure:DEMod CDP Measure Spectral Emission Mask :MEASure:EMISsion? Sets the active measurement to spectral emission mask, sets the default measurement parameters, triggers a new measurement and returns the spectral emission mask measurement results. It is a combination of the commands:CONFigure:RF EMISsion;:READ:EMISsion? For a description of the default spectral emission mask measurement parameters see :CONFigure:RF EMISsion.

  • Page 93: Measure Spectral Emission Mask Template

    Measure Spectral Emission Mask Template :MEASure:EMISsion:TEMPlate? Sets the active measurement to spectral emission mask, sets the default measurement parameters, triggers a new measurement and returns the spectral emission mask template results. It is a combination of the commands:CONFigure:RF EMISsion;:READ:EMISsion:TEMPlate? For a description of the default spectral emission mask measurement parameters see :CONFigure:RF EMISsion.

  • Page 94: Measure Pass/Fail

    For a description of the default occupied bandwidth measurement parameters see :CONFigure:RF SPECTRUM. To make an OTA measurement with settings other than the default values send • :CONFigure:OTA • Commands to set desired settings • :READ:OTA? The measurement results are returned as 5 comma delimited values: scrambling code, CPICH power, chip energy, Ec/I0 ratio, pilot dominance.

  • Page 95: Read Commands

    Default Units See Also: :CONFigure:RF SPECTRUM 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 96: Read Code Domain Power

    A demodulation measurement must be active. The current measurement can be queried using :CONFigure? Default Units See Also: :CONFigure:DEMod Read Code Domain Power :READ:DEMod:CDPower? Triggers a new code domain power measurement and returns the results. It is a combination of the commands :ABORT;:INITiate;:FETCh:DEMod:CDPower? The code domain power measurement must be active.

  • Page 97: Read Noise Floor

    Triggers a new measurement and returns the frequency error results. It is a combination of the commands :ABORT;:INITiate;:FETCh:DEMod:FERRor? The frequency error measurement must be active. The current measurement can be queried using :CONFigure? Default Units Hertz See Also: :CONFigure:DEMod Read Noise Floor :READ:DEMod:NFLoor? Triggers a new measurement and returns the noise floor results.

  • Page 98: Read Transmitter Frequency

    Read Transmitter Frequency :READ:DEMod:TXFRequency? Triggers a new measurement and returns transmitter frequency results. It is a combination of the commands :ABORT;:INITiate;:FETCh:DEMod:TXFRequency? The carrier frequency measurement must be active. The current measurement can be queried using :CONFigure? Default Units Hertz See Also: :CONFigure:DEMod Read Spectral Emission Mask :READ:EMISsion?

  • Page 99: Read Occupied Bandwidth

    Default Units No units See Also: :CONFigure:RF EMISsion Read Occupied Bandwidth :READ:OBWidth? Triggers a new occupied bandwidth measurement and returns the result. It is a combination of the commands :ABORT;:INITiate;:FETCh:OBWidth? The occupied bandwidth measurement must be active. The current measurement can be queried using :CONFigure? Default Units: See Also:...

  • Page 100: Sense (Measurement Command) Subsystem

    Triggers a new measurement and returns the peak to average power ratio result. It is a combination of the commands :ABORT;:INITiate;:FETCh:PTAPower? The peak to average power measurement must be active. The current measurement can be queried using :CONFigure? Default Units: See Also: :CONFigure:RF SENSe (Measurement Command) Subsystem...

  • Page 101: Hsdpa Iq Persistence

    RELative Factory Preset / *RST: Front Panel Access: Shift-4(Measure),Demodulator, HSDPA,Control Channels; Shift-4(Measure),Demodulator,CDP, Control Channels HSDPA IQ Persistence [:SENSe]:DEMod:HSDPa:IQPersistence <integer> [:SENSe]:DEMod:HSDPa:IQPersistence? Sets the number of samples before displaying the screen. Factory Preset / *RST: Range: 1-48 Front Panel Access: Measurements, Demodulator, HSDPA, IQ Persistence HSDPA Measurement Time [:SENSe]:DEMod:HSDPa:TIME <seconds>...

  • Page 102: S-Ccpch Spreading Factor

    This command refers to the channelization code number of the S-CCPCH channel for W- CDMA code domain demodulation measurements. MT8220A: 3 Factory Preset / *RST: MS2717A: 3 Range: MT8220A: 0 – 255 MS2717A: 0 – 255 Front Panel Access: Setup, S-CCPCH Code S-CCPCH Spreading Factor [:SENSe]:DEMod:SCCPch:SFACtor 4|8|16|32|64|128|256 [:SENSe]:DEMod:SCCPch:SFACtor?

  • Page 103: Maximum Spreading Factor

    MT8220A: ON Factory Preset / *RST: MS2717A: ON Front Panel Access: Setup, Scrambling Code See Also: [:SENSE]:DEMod:SCODe Maximum Spreading Factor [:SENSe]:DEMod:SFACtor 256|512 [:SENSe]:DEMod:SFACtor? This command refers to the maximum spreading factor used when demodulating a UMTS/W-CDMA signal. MT8220A: 512 Factory Preset / *RST: MS2717A: 512 Front Panel Access: Setup, Max Spreading...

  • Page 104: Sense]:Ota Subsystem

    [:SENSe]:OTA Subsystem This subsystem includes commands used to set up parameters associated with Over the Air measurements. OTA Reset [:SENSe]:OTA:RESet This command forces the instrument to reset the over-the-air measurement and start fresh without any history. When the auto scrambling code feature is ON the RESet command will clear the list of scrambling codes and attempt to detect new codes.

  • Page 105: Ota Scrambling Code Lock

    <test set> value must correspond to a test set that is defined in the test set list. For more information on loading test sets to the instrument, refer to the Anritsu Master Software Tools documentation. NOTE: The first test set in the list would be test set 0, the next test set would be 1, etc.

  • Page 106: Sense]:Rf Subsystem

    [:SENSe]:RF Subsystem This subsystem includes commands used to set up parameters associated with RF measurements. [:SENSe]:ACLR Subsystem This subsystem includes commands related to configuring the ACLR measurement. ACLR ADJC Channel Count [:SENSe]:RF:ACLR:ADJCchannelcount <num of Adjacent channels> [:SENSe]:RF:ACLR:ADJCchannelcount? This command refers to the number of Adjacent channels in the ACLR view. MT8220A: 2 Adjacent Channel Factory Preset / *RST: MS2717A: 2 Adjacent Channel...

  • Page 107: A Examples

    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 108 /* 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 109 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 110 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. Figure 1 shows the data capture and conversion to 32-bit integers in the format used by LabVIEW. Figure 2 shows the details of the conversion.
  • Page 111 Figure 1: Data Capture...
  • Page 112 Figure 2: Data Conversion...
  • Page 113 Master Programming Manual Revision History Manual Section Name /Command Name Date Change Description 1/19/07 Manual Revision A (10580-00167A.pdf) Released Initial release...

This manual is also suitable for:

Spectrum master ms2724bSpectrum master ms2723b

Table of Contents