Digital mobile radio transmitter tester (338 pages)
Summary of Contents for Anritsu LMR Master S412E
Page 1
Test Tool for Greater Flexibility and Technician Productivity SCPI programming commands may not be available for all instrument operating Note modes and functions. Anritsu Company Part Number: 10580-00319 490 Jarvis Drive Revision: N Morgan Hill, CA 95037-2809 Published: August 2016 Copyright 2016 Anritsu Company http://www.anritsu.com...
LMR Master. These commands are organized by instrument mode starting in Chapter This manual is intended to be used in conjunction with the LMR Master S412E User Guide. Refer to that manual for general information about the LMR Master, including equipment setup and operating instructions.
The following paragraphs provide information about the interface connections, cable requirements, and setup for remote operation. If a password has been set for the instrument, to control access via the Anritsu Note Web Remote Tools, for example, remote operation using SCPI commands is not possible.
Page 13
General Information 1-4 Remote Programming Setup and Interface other. A single LAN that is not connected to other LANs requires a default gateway setting of 0.0.0.0. If you have a gateway, then the default gateway would be set to the appropriate value of your gateway •...
Page 14
1-4 Remote Programming Setup and Interface General Information LMR Master LAN Connections The RJ45 connector is used to connect the LMR Master to a local area network. Integrated into this connector are two LEDs. The amber LED indicates the presence of LAN voltages (a live LAN connection) while the green LED flashes to show that LAN traffic is present.
Page 15
General Information 1-4 Remote Programming Setup and Interface 1. Turn On power to the S412E and controller PC and wait for the systems to power up completely. 2. Connect the USB cable mini-B connector to the S412E. 3. Connect the USB cable A connector to the controller PC USB host port. The controller PC should indicate “New Hardware Found”...
Page 16
1-4 Remote Programming Setup and Interface General Information 5. After the software is installed, close the Wizard by clicking Finish. Figure 1-3. USB Found New Hardware Wizard USB Interface, Type Mini-B The USB 2.0 Mini-B device connector can be used to connect the S412E directly to a PC. The first time that the S412E is connected to a PC, the normal USB device detection is performed by the computer operating system.
General Information 1-5 Sending SCPI Commands Sending SCPI Commands SCPI commands can be sent to the LMR Master though any Virtual Instrument Software Architecture (VISA) controller. VISA is a commonly-used API in the Test and Measurement industry for communicating with instruments from a PC. The physical connection between the PC and the LMR Master can be Ethernet or USB.
Page 18
3. Select the viRead tab and click the Execute button. If the PC is connected to the LMR Master, then the command returns the following information from the Buffer: manufacturer name (“Anritsu”), model number/options, serial number, and firmware package number.
Greek letter mu (µ). Some commands, for example, return the units of time in Caution microseconds (µs). In this Anritsu programming manual, the Greek letter mu is represented by the English letter “u” to avoid typographic problems during publication.
Title: Identification Query Description: This command returns the following information in <string> format separated by commas: manufacturer name (“Anritsu”), model number/options, serial number, firmware package number. The model number and options are separated by a “/” and each option is separated by a “/”.
Programming with SCPI 2-4 SCPI Required Commands SCPI Required Commands The required SCPI commands that are supported by the S412E are listed in the Table 2-1. These commands work in all measurement modes and are described in Chapter Table 2-1. SCPI Required Commands :STATus :SYSTem...
2-6 Subsystem Commands Programming with SCPI Subsystem Commands Subsystem commands control all instrument functions and some general purpose functions. All subsystem commands are identified by the colon that is used between keywords, as in :INITiate:CONTinuous. The following information is provided for each subsystem command that is described in the following chapters: •...
Programming with SCPI 2-6 Subsystem Commands Long Format versus Short Format Each keyword has a long format and a short format. The start frequency can be specified by :SENSe:FREQuency:STARt or :SENS:FREQ:STAR. The capital letters in the command specification indicate the short form of the command. A mixture of the entire short form elements with entire long form elements of each command is acceptable.
2-6 Subsystem Commands Programming with SCPI All S412E SCPI commands, except the :ABORt command, have one or more subcommands (keywords) associated with them to further define the instrument function to be controlled. The subcommand keywords may also have one or more associated subcommands (keywords). Each subcommand level adds another layer to the command tree.
Programming with SCPI 2-6 Subsystem Commands Identifiers Some or all of the following identifiers have been used throughout the optional command definitions. Descriptions are provided here. In most cases, units are specified with the individual command. Table 2-3. Description of Command Indentifiers Identifier Description Amplitude value.
2-6 Subsystem Commands Programming with SCPI Data Parameters Data parameters, referred to simply as “parameters,” are the quantitative values that are used as arguments for the command keywords. The parameter type that is associated with a particular SCPI command is determined by the type of information that is required to control the particular instrument function.
Programming with SCPI 2-6 Subsystem Commands Data Parameter Notations The following syntax conventions are used for data parameter descriptions in this manual: Table 2-4. Parameter Notations ::=a generic command argument consisting of one or more of the other data types <arg>...
2-7 Notational Conventions Programming with SCPI Notational Conventions The SCPI interface standardizes command syntax and style to simplify the task of programming across a wide range of instrumentation. As with any programming language, the exact command keywords and command syntax must be used. Unrecognized commands or improper syntax will not function.
Programming with SCPI 2-8 Notational Examples Notational Examples Table 2-6. Creating Valid Commands Command Specification Valid Forms The following all produce the same result: [:SENSe]:FREQuency:STARt <freq> :SENSe:FREQuency:STARt 1 MHZ :SENS:FREQ:STAR 1 MHZ :sense:frequency:start 1000000 :FREQ:STAR 1000 KHZ The first 2 commands set the location of :CALCulate:MARKer{1|2|3|4|5|6}:X marker 1.
2-9 Formatting Conventions Programming with SCPI Formatting Conventions This manual uses the following conventions in describing SCPI commands. Table 2-7. Formatting Conventions Commands are formatted to differentiate them :COMMands:LOOK:LIKE:THIS from their description. The query form of the command is followed by :COMMand:QUERies:LOOK:LIKE:THIS? a “?”...
All Mode Commands 3-1 Introduction Chapter 3 — All Mode Commands Introduction The commands that are listed in this chapter are functional in all modes of operation. :FETCh GPS Subsystem Use this command to get GPS information. :FETCh:GPS? Title: Fetch GPS Information Description: Returns the GPS fix status, UTC timing information, and the GPS location.
Switching modes can take longer than 80 seconds, depending on the application. Add a delay of at least 90 seconds between mode switch commands. Anritsu Note Company advises you to set the remote PC time-out to 120 seconds in order to avoid unexpected time-out errors.
All Mode Commands 3-4 :MMEMory Subsystem :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument setup and data storage. :MMEMory:DATA? <file name> Title: Transfer Data Description: Transfers the data stored in the given file from the instrument to the controlling program.
Page 36
3-4 :MMEMory Subsystem All Mode Commands “.lte” for LTE Analyzer measurements “.p25” for P25 Analyzer measurements “.p252” for P25p2 Analyzer measurements “.nxdn” for NXDN Analyzer measurements “.dpmr” for dPMR Analyzer measurements “.dmr2” for DMR 2 Analyzer measurements “.ptc” for PTC Analyzer measurements “.nbfm”...
Page 37
All Mode Commands 3-4 :MMEMory Subsystem :MMEMory:MSIS:COPY Title: Copy from Current Save Location to Destination Description: Copies all files and folders from the current save location to the destination. File hierarchy is maintained. In remote operation, files can only be copied from internal memory to the USB device or from USB to internal memory.
Page 38
3-4 :MMEMory Subsystem All Mode Commands :MMEMory:STORe:JPEG <file name> Title: Save Screen as JPEG Description: Saves the current screen measurement as a JPEG file, which is specified by <file name> with the extension *.jpg to the current save location. <file name> should be enclosed in either single quotes (‘ ’) or double quotes (“...
All Mode Commands 3-5 :STATus Subsystem :STATus Subsystem The commands in this subsystem relate to the current operating state of the instrument. :STATus:OPERation? Title: Query Operation Status Description: 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 are implemented for each application.
The USB query returns a 1 when a USB device is plugged into the USB port. It returns 0 if no USB drive is present. Internal memory in the LMR Master S412E should always be available and the INT query should always return a 1.
All Mode Commands 3-7 [:SENSe]:GPS Subsystem [:SENSe]:GPS Subsystem This subsystem contains commands that relate to the optional GPS (Global Positioning System) on the instrument. [:SENSe]:GPS ON|OFF|1|0 [:SENSe]:GPS? Title: GPS State Required Option: 31 Description: Toggles GPS ON or OFF. The query form of this command returns a 0 or 1 when GPS state is OFF or ON, respectively.
Page 42
3-7 [:SENSe]:GPS Subsystem All Mode Commands 3-12 PN: 10580-00319 Rev. N S412E PM...
Chapter 4 — Spectrum Analyzer Commands :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Title: Abort Description: Restarts the current sweep and/or measurement. Resets the trigger system. If :INITiate:CONTinuous is OFF (i.e., the instrument is in single sweep mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. :CALCulate:LIMit:ALARm OFF|ON|0|1 :CALCulate:LIMit:ALARm? Title: Limit Alarm Description: Enables/disables the currently active limit line alarm. Setting the value to ON or 1 will turn on the limit alarm.
Page 45
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit:ENVelope:OFFSet <amplitude> :CALCulate:LIMit:ENVelope:OFFSet? Title: Limit Envelope Offset Description: Sets limit envelope offset. This defines how far away from the measured signal the active limit envelope is placed. Use :CALCulate:LIMit:TYPe to set the currently active limit line. Parameter: <amplitude>...
Page 46
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:LIMit:ENVelope:SHAPe SQUare|SLOPe :CALCulate:LIMit:ENVelope:SHAPe? Title: Limit Envelope Shape Description: Sets the currently active limit envelope shape. Parameter: SQUare|SLOPe Parameter Type: <char> Example: To set the limit envelope to a square: :CALCulate:LIMit:ENVelope:SHAPe SQUare Front Panel Access: Shift-6 (Limit), Limit Envelope, Upper Shape (If Limit is toggled to Upper) Shift-6 (Limit), Limit Envelope, Lower Shape (If Limit is toggled to Lower)
Page 47
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit:LOWer:ALARm OFF|ON|0|1 :CALCulate:LIMit:LOWer:ALARm? Title: Lower Limit Alarm Description: Enables/disables the lower limit alarm. It is a combination of the commands :CALCulate:LIMit:TYPe 1 and :CALCulate:LIMit:ALARm ON|OFF. Setting the value to ON or 1 will turn on the lower limit alarm.
Page 48
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:LIMit:LOWer[:STATe] OFF|ON|0|1 :CALCulate:LIMit:LOWer[:STATe]? Title: Lower Limit State Description: Turns the lower limit line ON or OFF. It is a combination of the commands :CALCulate:LIMit:TYPe 1 and :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.
Page 49
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit:MIRRor Title: Limit Mirror Description: Creates a limit mirror. Use :CALCulate:LIMit:TYPe to set the currently active limit line. Related Command: :CALCulate:LIMit:TYPe :CALCulate:LIMit:POINt:ADD Title: Add Limit Point Description: Adds a new limit point to the currently active limit line. Use :CALCulate:LIMit:TYPe to set the currently active limit line.
Page 50
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:LIMit:POINt:X <x-parameter> :CALCulate:LIMit:POINt:X? Title: Limit Point X Value Description: Sets the location of the active limit point on the x-axis at the specified location. <x-parameter> is defined in the current x-axis. Note that this will change the Move Limit on the front panel to Point if it is currently set to Limit.
Page 51
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit:TYPe 0|1 :CALCulate:LIMit:TYPe? Title: Set Limit Line Upper or Lower Description: Sets the currently active limit line to either upper or lower. Subsequent limit line operations will be performed on the selected limit line. Parameter: 0|1 (0 = upper limit line, 1 = lower limit line) Parameter Type: number Default Value: 0 (upper)
Page 52
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:LIMit:UPPer:POINt? Title: Number of Upper Limit Points Description: Returns the number of points currently in the upper limit line. Default Value: 2 Related Command: :CALCulate:LIMit:POINt? :CALCulate:LIMit:UPPer[:STATe] OFF|ON|0|1 :CALCulate:LIMit:UPPer[:STATe]? Title: Upper Limit State Description: Turns the upper limit line ON or OFF. It is a combination of the commands :CALCulate:LIMit:TYPe 0 and :CALCulate:LIMit:STATe ON|OFF.
Page 53
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit:VALue <value> Title: Move Limit Description: Sets the currently active limit line value. This command moves an entire single or multi-segment limit line up or down by the given <value>. This command is equivalent to the command :CALCulate:LIMit:Y.
Page 54
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:LIMit:Y <y-parameter> Title: Limit Line Y Value Description: Sets the location of the active limit line on the y-axis at the specified location. This moves the entire limit and moves the current active limit point by the given value.
Page 55
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:LIMit[:STATe] OFF|ON|0|1 :CALCulate:LIMit[:STATe]? Title: Limit State Description: Turns the currently selected limit line (upper or lower) ON or OFF. If the value is set to ON or 1, the currently selected limit line is ON. If the value is set to OFF or 0, the currently selected limit line is OFF.
Page 56
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:MARKer:TABLe[:STATe] OFF|ON|0|1 :CALCulate:MARKer:TABLe[:STATe]? Title: Marker Table State Description: Turns the Marker Table on or off. Setting the value to ON or 1 will turn on the marker table. Setting the value to OFF or 0 will turn off the marker table.
Page 57
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X <x-parameter> :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X? Title: Delta Marker X Value Description: Sets the location of the delta marker on the x-axis at the specified location <x-parameter> + the reference marker x-axis. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the delta marker on the x-axis.
Page 58
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:STATe] OFF|ON|0|1 :CALCulate:MARKer{1|2|3|4|5|6}:DELTa[:STATe]? Title: Delta Marker State Description: Sets the specified delta marker on or off. Parameter: OFF|ON|0|1 Parameter Type: <boolean> Default Value: OFF Example: To turn on delta marker #3: :CAL1Culate:MARKer3:DELTa ON :CALCulate:MARKer3:DELTa 1 :CALCulate:MARKer3:DELTa:STATe ON :CALCulate:MARKer3:DELTa:STATe 1 To turn off delta marker #6...
Page 59
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:FIXed[:STATe] OFF|ON|0|1 :CALCulate:MARKer{1|2|3|4|5|6}:FIXed[:STATe]? Title: Marker Fixed State Description: Sets the specified reference marker fixed state on or off. If Fixed is set to on, then the selected reference markers stay at the amplitude they were at when the marker is set to Fixed.
Page 60
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum:NEXT Title: Marker (Maximum) Next Description: Moves the specified marker to the next highest peak anywhere in the trace that is lower than the current marker. If the specified marker is not on, the command turns the marker on and sets it to the second highest peak in the trace.
Page 61
Spectrum Analyzer Commands 4-2 :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:X <x-parameter> :CALCulate:MARKer{1|2|3|4|5|6}:X? Title: Marker X Value Description: Sets the location of the marker on the x-axis at the specified location. <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. Note that the marker is snapped to the data point closest to the specified value.
Page 62
4-2 :CALCulate Subsystem Spectrum Analyzer Commands :CALCulate:MARKer{1|2|3|4|5|6}[:SET]:RLEVel Title: Marker to Reference Level Description: 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 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe] OFF|ON|0|1 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe]? Title: Marker State...
Spectrum Analyzer Commands 4-3 :CONFigure Subsystem :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It will not initiate the taking of a measurement.
Page 64
4-3 :CONFigure Subsystem Spectrum Analyzer Commands :CONFigure:FSTRength Title: Configure Field Strength Description: Configures the default field strength measurement. Disables any other active one-button measurements, including channel power, adjacent channel power, occupied bandwidth, AM/FM demodulation and C/I. Sets the antenna to the first antenna in the instrument’s antenna list. Sets the instrument to single sweep mode (:INITiate:CONTinuous OFF).
Spectrum Analyzer Commands 4-4 :DISPlay Subsystem :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Title: Scale Description: Sets the scale (dB/division) for the y-axis.
Page 66
4-4 :DISPlay Subsystem Spectrum Analyzer Commands :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:RLEVel:OFFSet? Title: Reference Level Offset Description: Sets the reference level offset value for the y-axis. Parameter: <rel ampl> Default Value: 0 dB Default Unit: dB Range: -99.9 dB to 99.9 dB Front Panel Access: Amplitude, RL Offset 4-24 PN: 10580-00319 Rev.
Spectrum Analyzer Commands 4-5 :FETCh Subsystem :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
Page 68
4-5 :FETCh Subsystem Spectrum Analyzer Commands :FETCh:CHPower? Title: Fetch Channel Power/Density Description: This command returns the most recent channel power measurement results: 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.
Spectrum Analyzer Commands 4-6 :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 is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,[<length>] :FORMat[:READings][:DATA]? Title: Numeric Data Format...
4-7 :INITiate Subsystem Spectrum Analyzer Commands :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Title: Continuous/Single Sweep Description: Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, another sweep/measurement is triggered as soon as the current one completes.
Spectrum Analyzer Commands 4-8 :MEASure Subsystem :MEASure Subsystem These commands 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.
Page 72
4-8 :MEASure Subsystem Spectrum Analyzer Commands :MEASure:CHPower:CHPower? Title: Measure Channel Power Description: Sets the active measurement to channel power, sets the default measurement parameters, triggers a new measurement and returns the channel power result. To measure both channel power and channel power density use :MEASure:CHPower? It is a combination of the commands :CONFigure:CHPower and :READ:CHPower:CHPower? For a description of the default channel power measurement parameters,...
Page 73
Spectrum Analyzer Commands 4-8 :MEASure Subsystem :MEASure:CHPower? Title: Measure Channel Power/Density Description: 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 and :READ:CHPower? For a description of the default channel power measurement parameters, see :CONFigure:CHPower.
4-9 :MMEMory Subsystem Spectrum Analyzer Commands :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:LIMit <file name> Title: Recall Limit Description: Recalls a previously stored limit from the current save location. The saved limit setting to be loaded is specified by <file name>.
Page 75
Spectrum Analyzer Commands 4-9 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<file name> This command requires front panel access to select the trace and to complete the Note command. Title: Recall Measurement Description: The instrument must be in the mode of the saved trace in order to recall that trace.
Page 76
4-9 :MMEMory Subsystem Spectrum Analyzer Commands :MMEMory:STORe:LIMit <file name> Title: Save Limit Description: Stores the current limit 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.
Spectrum Analyzer Commands 4-10 :READ Subsystem 4-10 :READ Subsystem 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 78
4-10 :READ Subsystem Spectrum Analyzer Commands :READ:CHPower? Title: Read Channel Power/Density Description: Triggers a new channel power measurement and returns the results: channel power and channel power density. It is a combination of the commands :ABORT; :INITiate; :FETCh:CHPower? The channel power measurement must be the active measurement (specified by the command :CONFigure:CHPower).
Spectrum Analyzer Commands 4-11 :TRACe Subsystem 4-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:COPY TRACE1,TRACE2|TRACE3 Title: Trace Copy Description: Copies Trace A to either Trace B or Trace C. Copying Trace A to Trace B is equivalent to pressing the Shift-5 (Trace), Trace B Operations, A->B on the front panel.
4-11 :TRACe Subsystem Spectrum Analyzer Commands :TRACe:PREamble? {1|2|3} Title: Trace Header Transfer Description: 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.
Page 81
Spectrum Analyzer Commands 4-11 :TRACe Subsystem Table 4-1. Available Parameters in Spectrum Analyzer Mode (Sheet 2 of 5) Parameter Name Description Video bandwidth VBW_TYPE VBW coupling auto/manual RBW_VBW_RATIO RBW/VBW ratio SPAN_RBW_RATIO Span/RBW ratio INPUT_ATTEN Input attenuation ATTEN_TYPE Attenuation coupling auto/manual REFERENCE_LEVEL Reference level SCALE...
Page 82
4-11 :TRACe Subsystem Spectrum Analyzer Commands Table 4-1. Available Parameters in Spectrum Analyzer Mode (Sheet 3 of 5) Parameter Name Description IMPEDANCE Input impedance REFERENCE_FREQUENCY Reference freq SET_SWEEP_TIME Minimum sweep time setting TRIGGER_TYPE Trigger type VIDEO_TRIGGER_LEVEL Video trigger level TRIGGER_POSITION Trigger position as a percent of the display PEAK_THRESHOLD Marker peak search threshold...
Page 83
Spectrum Analyzer Commands 4-11 :TRACe Subsystem Table 4-1. Available Parameters in Spectrum Analyzer Mode (Sheet 4 of 5) Parameter Name Description ACPR_UPPER_CH_ Mask off 16 bits at a time to get the display point LINE_MARKER_INFO location of the 2 ACPR upper channel display indicators AM_FM_DEMOD_VOL AM/FM demod volume...
Page 84
4-11 :TRACe Subsystem Spectrum Analyzer Commands Table 4-1. Available Parameters in Spectrum Analyzer Mode (Sheet 5 of 5) Parameter Name Description MKR_SPA_FLAGSx Reference marker x flags: SPA_MKR_FLAG_ON_OFF: 0x00000001 SPA_MKR_FLAG_DELTA_MKR: 0x00000002 SPA_MKR_FLAG_SELECTED: 0x00000004 SPA_MKR_FLAG_DATA_INVALID: 0x00000008 SPA_MKR_FLAG_DATA_STALE: 0x00000010 SPA_MKR_FLAG_FIXED: 0x00000020 SPA_MKR_FLAG_MASK: 0x000000FF SPA_MKR_FLAG_DISPL_AMPL_HZ: 0x00000100 SPA_MKR_FLAG_DISPL_AMPL_PER_HZ: 0x00000200...
Page 85
Spectrum Analyzer Commands 4-11 :TRACe Subsystem :TRACe[:DATA] {1|2|3},(<header><block>) :TRACe[:DATA]? {1|2|3} Title: Trace Data Transfer Description: 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 to the instrument enclosed in parentheses as (<header><block>) and from the instrument as <header><block>.
Page 86
4-11 :TRACe Subsystem Spectrum Analyzer Commands :TRACe{1|2|3}:DISPlay[:STATe] OFF|ON|0|1 :TRACe{1|2|3}:DISPlay[:STATe]? Title: Trace View State Description: Specifies whether the specified trace should be displayable (visible) or hidden. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the value to ON or 1 will set the specified trace visible.
Page 87
Spectrum Analyzer Commands 4-11 :TRACe Subsystem :TRACe{1|2|3}:LOAD:DISPlay[:STATe] OFF|ON|0|1 :TRACe{1|2|3}:LOAD:DISPlay[:STATe]? Title: Trace View State Description: Specifies whether the specified recall trace should be displayable (visible) or hidden. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the value to ON or 1 will set the specified trace visible.
Page 88
4-11 :TRACe Subsystem Spectrum Analyzer Commands :TRACe{1|2|3}:WRITe[:STATe] OFF|ON|0|1 :TRACe{1|2|3}:WRITe[:STATe]? Title: Trace Write State Description: Specifies whether the specified trace state should be set to write or hold. TRACe1 corresponds to Trace A, TRACe2 corresponds to Trace B, and TRACe3 corresponds to Trace C. Setting the state to ON or 1 will set the specified trace to write.
Page 89
Spectrum Analyzer Commands 4-11 :TRACe Subsystem :TRACe1:OPERation NORMal|MAXHold|MINHold|AVERage :TRACe1:OPERation? Title: Trace A Operation Description: This command specifies how successive traces are combined to produce the resulting display values. Setting the operation to NORMal is equivalent to pressing the Shift-5 (Trace), Trace A Operations, Normal->A on the front panel. This displays a trace based on the detection method selected.
Page 90
4-11 :TRACe Subsystem Spectrum Analyzer Commands :TRACe3:OPERation MAXHold|MINHold|A-B|B-A :TRACe3:OPERation? Title: Trace C Operation Description: This command specifies how successive traces are combined to produce the resulting display values. Setting the operation to MAXHold is equivalent to pressing the Shift-5 (Trace), Trace C Operations, Max Hold->C on the front panel. This displays the largest signal for each display point over multiple sweeps.
Spectrum Analyzer Commands 4-12 :TRIGger Subsystem 4-12 :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[:SEQuence]:SOURce IMMediate|EXTernal|VIDeo :TRIGger[:SEQuence]:SOURce? Title: Trigger Source Description: This command defines the trigger source.
Page 92
4-12 :TRIGger Subsystem Spectrum Analyzer Commands :TRIGger[:SEQuence]:VIDeo:DELay <percentage> or <time> :TRIGger[:SEQuence]:VIDeo:DELay? Title: Video Trigger Position (Time) Description: This command sets the video triggering delay as either a percentage of the display or in time units. If setting the delay by time is desired, then time units must be specified when sending the command.
Spectrum Analyzer Commands 4-13 :UNIT Subsystem 4-13 :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. :UNIT:POWer DBM|DBV|DBMV|DBUV|V|W :UNIT:POWer? Title: Measurement Units Description: Sets the default amplitude units for input, output and display. Available units: dBm, dBV, dBmV, dBuV, V, W.
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent <freq> [:SENSe]:ACPower:BANDwidth|BWIDth:ADJacent? Title: ACPR Adjacent Channel Bandwidth Description: Sets the adjacent channel bandwidth for the ACPR measurement. Parameter: <freq> Default Value: 10.35 MHz Default Unit: Hz Front Panel Access: Shift-4 (Measure), ACPR, Adj Ch BW...
Page 95
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:ACPower:STATe OFF|ON|0|1 [:SENSe]:ACPower:STATe? Title: ACPR Measurement State Description: Sets the state of the adjacent channel power ratio measurement, ON or OFF. When using :CONFigure:ACPower, the state is automatically set to ON. Parameter: OFF|ON|0|1 Parameter Type: <boolean> Default Value: OFF [:SENSe]:AVERage:COUNt <integer>...
Page 96
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands [:SENSe]:AVERage:TYPE NONE|SCALar|MAXimum|MINimum [:SENSe]:AVERage:TYPE? Title: Trace Mode (Normal/Average/Max Hold/Min Hold) Description: 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 “Normal->A” on the front panel. The displayed value for a point is the current measured value for that point.
Page 97
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO OFF|ON|0|1 [:SENSe]:BANDwidth|BWIDth:VIDeo:AUTO? Title: Video Bandwidth Coupling Description: Sets the state of the coupling of the video bandwidth to the resolution bandwidth. Setting the value to ON or 1 will result in the video bandwidth being coupled to the resolution bandwidth.
Page 98
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands [:SENSe]:BANDwidth|BWIDth[:RESolution] <freq> [:SENSe]:BANDwidth|BWIDth[:RESolution]? Title: Resolution Bandwidth Description: Sets the resolution bandwidth. Note that using this command turns the automatic resolution bandwidth setting OFF. Parameter: <freq> Default Value: 3 MHz Default Unit: Hz Range: 10 Hz to 3 MHz in a 1:3 sequence except for the MS2711E 100 Hz to 3 MHz in a 1:3 sequence for the MS2711E Related Command: :BANDwidth|BWIDth[:RESolution]:AUTO Front Panel Access: BW, RBW...
Page 99
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio <number> [:SENSe]:BANDwidth|BWIDth[:RESolution]:RATio? Title: Resolution Bandwidth to Span Ratio Description: Sets the ratio of the resolution bandwidth to the span for use when the resolution bandwidth to span coupling is enabled. Note that the front panel interface sets the inverse ratio: the span to the resolution bandwidth.
Page 100
(dBm vs. dBV vs. Volts, etc.). If the value of <integer> is 50 no correction is performed. If the value of <integer> is 75 correction is done based on Anritsu adapter 12N50-75B. Parameter: <integer> Parameter Type: <integer>...
Page 101
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:DETector[:FUNCtion] POSitive|RMS|NEGative|SAMPle [:SENSe]:DETector[:FUNCtion]? Title: Detection Type Description: Sets the detection method for calculating each display point. Each display point represents several measurements. The detection type determines how the display point is derived from its associated measurements.
Page 102
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink then the value of the <string>...
Page 103
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:FREQuency:STARt <freq> [:SENSe]:FREQuency:STARt? Title: Start Frequency Description: Sets the start frequency. Note that in the spectrum analyzer, changing the value of the start frequency will change the value of the coupled parameters, Center Frequency and Span. Parameter: <freq>...
Page 104
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands [:SENSe]:FSTRength:ANTenna <antenna> [:SENSe]:FSTRength:ANTenna? Title: Field Strength Antenna Description: Selects an antenna from the antenna list to use for field strength measurement result calculations. The <antenna> argument is a 1-based index of the position of the desired antenna in the instrument’s current antenna list.
Page 105
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:OBWidth:METHod XDB|PERCent [:SENSe]:OBWidth:METHod? Title: Occupied Bandwidth Measurement Method Description: Sets the method for calculating occupied bandwidth. XDB calculates the occupied bandwidth based on points a specified number of dB below the carrier. Issue command [:SENSe]:OBWidth:XDB to set the number of dB to be used.
Page 106
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands [:SENSe]:OBWidth:XDB <rel ampl> [:SENSe]:OBWidth:XDB? Title: Occupied Bandwidth dB Down Description: This command sets the number of dB below the carrier used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to XDB.
Page 107
Spectrum Analyzer Commands 4-14 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:ATTenuation:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:ATTenuation:AUTO? Title: Input Attenuation Coupling Description: Sets the input attenuation coupling. Setting the value to ON or 1 will result in the input attenuation being coupled to the reference level. Setting the value to OFF or 0 will result in the input attenuation being un-coupled from the reference level.
Page 108
4-14 [:SENSe] Subsystem Spectrum Analyzer Commands [:SENSe]:SWEep:STATus? Description: This command queries the sweep complete status. Returns 1 when the sweep is complete. Returns 0 when the sweep is in progress. Cmd Parameter: NA Query Response: 0 | 1 Related Command: :STATus:OPERation? Front Panel Access: NA [:SENSe]:SWEep:TIME[:LLIMit] [:SENSe]:SWEep:TIME[:LLIMit]?
Chapter 5 — VNA Commands Introduction This chapter describes commands for LMR Master mode. Only the commands that are listed in this chapter and in Chapter 3, “All Mode Commands” can be used in LMR Master mode. Using commands from other modes may produce unexpected results. Front Panel Access in VNA mode via the function hard keys may be listed as Note Freq/Dist or as Freq.
Page 110
5-2 :CALCulate Subsystem VNA Commands Table 5-1. Graph Type and Returned Units (Sheet 2 of 2) Graph Type Returned Units Real Impedance Imaginary Impedance SDATa: Complex measurement data. The returned numbers (which are independent of the Graph Type that is associated with the trace) are the complex measurement data (Real and Imaginary) for each point of the trace.
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:FORMat Subsystem Commands in this subsystem define the display format for a measurement. :CALCulate<Tr>:FORMat <Graph Type> :CALCulate<Tr>:FORMat? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
5-2 :CALCulate Subsystem VNA Commands :CALCulate:LIMit Subsystem This subsystem defines the limit lines and controls the limit check. :CALCulate:LIMit:ALARm OFF|ON|0|1 :CALCulate:LIMit:ALARm? Description: Enables/disables the active trace currently selected limit line alarm. Setting the value to ON or 1 turns on the active trace limit alarm. Setting the value to OFF or 0 turns off the active trace limit alarm.
Page 113
VNA Commands 5-2 :CALCulate Subsystem :CALCulate<Tr>:LIMit:LOWer:POINt:ADD Description: Adds a new limit point to the lower limit line of the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Cmd Parameter: NA Query Response: NA (no query) Example: To add a point to the lower limit line on trace 2:...
Page 114
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:LOWer:POINt:RIGHt Description: Sets the limit point to the right of the lower limit active point of the given trace <Tr> as the new active point. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Page 115
VNA Commands 5-2 :CALCulate Subsystem :CALCulate<Tr>:LIMit:LOWer:POINt:X <x-parameter> :CALCulate<Tr>:LIMit:LOWer:POINt:X? Description: Sets the location of the lower limit point of the given trace <Tr> on the x-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Page 116
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:LOWer:POINt:Y <y-parameter> :CALCulate<Tr>:LIMit:LOWer:POINt:Y? Description: Sets the location of the lower limit point of the given trace <Tr> on the y-axis at the specified location. <Tr> is the trace number in the range 1 to 4. If no trace number is specified then default is trace number 1. Sending the set command changes the Move Limit on the front panel to Point if it is currently set to Limit, and sets the given trace as the active trace.
Page 117
VNA Commands 5-2 :CALCulate Subsystem :CALCulate<Tr>:LIMit:LOWer:X <x-parameter> :CALCulate<Tr>:LIMit:LOWer:X? Description: Moves the lower limit of the given trace <Tr> on the x-axis to the given value. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 118
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:LOWer:Y <y-parameter> :CALCulate<Tr>:LIMit:LOWer:Y? Description: Sets the location of the lower limit line of the given trace <Tr> on the y-axis at the given value. This moves the entire lower limit and moves the current active limit point by the given value. <Tr> is the trace number in the range 1 to 4.
Page 119
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:LIMit:POINt:DELete Description: Deletes the active trace active limit point. After deletion, the point that is immediately to the left of the point that was deleted becomes the active point. Note that deletion is valid only if 2 or more limit points exist.
Page 120
5-2 :CALCulate Subsystem VNA Commands :CALCulate:LIMit:POINt:X <x-parameter> :CALCulate:LIMit:POINt:X? Description: Sets the location of the active limit point on the x-axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <x-parameter> must correspond to the current active trace domain type.
Page 121
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:LIMit:POINt:Y <y-parameter> :CALCulate:LIMit:POINt:Y? Description: Sets the location of the active limit point on the y-axis at the specified location. Sending this command changes the Move Limit on the front panel to Point if it is currently set to Limit. The <y-parameter> is defined in the current y-axis.
Page 122
5-2 :CALCulate Subsystem VNA Commands :CALCulate:LIMit:TYPE 0|1 :CALCulate:LIMit:TYPE? Description: Sets the limit line segment type (upper or lower) to be edited. Set the value to 1 for Lower limit segment and to 0 for Upper limit line segment. The query version of the command returns a 1 if the lower limit line is currently active for editing and returns a 0 if the upper limit line is currently active for editing.
Page 123
VNA Commands 5-2 :CALCulate Subsystem :CALCulate<Tr>:LIMit:UPPer:POINt:DELete Description: Deletes the upper limit point of the given trace <Tr>. After deletion, the point that is immediately to the left of the point that was deleted becomes the active point. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 124
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:UPPer:POINt:RIGHt Description: Sets the limit point to the right of the upper limit active point of the given trace <Tr> as the new active point. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1.
Page 125
VNA Commands 5-2 :CALCulate Subsystem To set the trace 1 upper limit point to 5 Feet (trace 1 in distance domain with current distance unit in meter): :CALCulate:LIMit:UPPer:POINt:X 5 FT OR to 4 Meter :CALCulate1:LIMit:UPPer:POINt:X 4 M :CALCulate:LIMit:UPPer:POINt:X 4 Related Command: :CALCulate:LIMit:TYPe :CALCulate<Tr>:LIMit:UPPer:POINt:Y Front Panel Access: Shift 6 (Limit), Limit Edit, Limit X :CALCulate<Tr>:LIMit:UPPer:POINt:Y <y-parameter>...
Page 126
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:UPPer[:STATe] OFF|ON|0|1 :CALCulate<Tr>:LIMit:UPPer[:STATe]? Description: Turns the upper limit line of the given trace <Tr> ON or OFF. <Tr> is the trace number in the range 1 to 4. If no trace number is specified than defaults to trace number 1. The query version of the command returns a 1 if the upper limit line of the given trace is ON and returns a 0 if the given trace is OFF.
Page 127
VNA Commands 5-2 :CALCulate Subsystem :CALCulate<Tr>:LIMit:UPPer:X <x-parameter> :CALCulate<Tr>:LIMit:UPPer:X? Description: Moves the upper limit of the given trace <Tr> on the x-axis to the given value. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
Page 128
5-2 :CALCulate Subsystem VNA Commands :CALCulate<Tr>:LIMit:UPPer:Y <y-parameter> :CALCulate<Tr>:LIMit:UPPer:Y? Description: Sets the location of the upper limit line of the given trace <Tr> on the y-axis at the given value. This moves the entire upper limit and moves the current active limit point by the given value. <Tr> is the trace number in the range 1 to 4.
Page 129
VNA Commands 5-2 :CALCulate Subsystem OR to 500 MHz: :CALCulate:LIMit:X 500MHz To move the active limit to 5 Feet (active trace in distance domain with current distance unit in feet): :CALCulate:LIMit:X 5FT OR to 4 Meter :CALCulate:LIMit:X 4M :CALCulate:LIMit:X 4 Related Command: :CALCulate:LIMit:TYPe :CALCulate:LIMit:Y Front Panel Access: Shift 6 (Limit), Limit Edit, Limit X...
5-2 :CALCulate Subsystem VNA Commands :CALCulate:MARKer Subsystem This subsystem contains commands to manipulate data markers. :CALCulate:MARKer:AOFF Turns off all markers. This command will turn off all the markers and set Marker Type to off. :CALCulate:MARKer:DATA? Description: Reports the marker information. Each marker data is separated by a comma and data are returned similar to that when Readout Format is set to Table.
Page 131
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:STATe] OFF|ON|0|1 :CALCulate:MARKer[1]|2|3|4|5|6|7|8:DELTa[:STATe]? Description: Sets the specified marker as the active marker and turn it on or off. If the value is set to ON or 1, then the specified marker is turn on and set as a delta marker.
Page 132
5-2 :CALCulate Subsystem VNA Commands :CALCulate:MARKer<Mk>:DOMain? Description: Query the specified marker <Mk> domain type. <Mk> is the marker number in the range of 1 to 8. If no marker number is specified, then the marker number (the <Mk> value) defaults to 1. This command returns “FREQ”...
Page 133
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MAXimum Description: Puts the specified marker at the maximum value in the trace. Note that this turns on the selected marker (if it is not already on) and sets the selected marker as the active marker. Cmd Parameter: NA Query Response: NA (no query) Related Command: :CALCulate:MARKer[1]|2|3|4|5|6|7|8:MINimum...
Page 134
5-2 :CALCulate Subsystem VNA Commands To turn off marker #6: :CALCulate:MARKer6:REFerence OFF :CALCulate:MARKer6:REFerence:STATe OFF :CALCulate:MARKer6:REFerence:STATe 0 Front Panel Access: Marker, Marker Type :CALCulate:MARKer<Mk>:SOURce <Tr> :CALCulate:MARKer<Mk>:SOURce? Description: Sets the specified marker <Mk> to the given trace <Tr>. <Mk> is the marker number in the range of 1 to 8. If no marker number is specified, then the marker number (the <Mk>...
Page 135
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X <x-parameter> :CALCulate:MARKer[1]|2|3|4|5|6|7|8:X? Description: 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 set command will set the specified marker as the active marker. The <x-parameter> given unit must correspond to the specified marker domain type.
Page 136
5-2 :CALCulate Subsystem VNA Commands :CALCulate:MARKer[1]|2|3|4|5|6|7|8:Y? Description: Reads the current Y value for the specified marker. The units are in the y-axis unit. The command returns the marker readout style followed by the Y value and unit. If an error occurs, such as marker not ON, the command returns an error code of –400.
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:MATH Subsystem This subsystem contains functions for controlling math operations on the currently selected measurement and memory.Trace Math Function :CALCulate:MATH:FUNCtion NORMal|ADD|SUBTract|MULTiply|DIVide :CALCulate:MATH:FUNCtion? Description: Sets the math operations on the currently active trace and the trace stored in memory.
5-2 :CALCulate Subsystem VNA Commands :CALCulate:SMOothing Subsystem This subsystem contains functions for trace smoothing. :CALCulate<Tr>:SMOothing:APERture <integer> :CALCulate<Tr>:SMOothing:APERture? Description: Sets the smoothing percentage for the given trace <Tr>. The query form of the command returns the current smoothing percentage. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:TRANsform Subsystem Front panel soft keys that are related to distance measurements, such as the Additional Dist Setup soft key, appear in menus only when the Setup Domain is set up for distance. :CALCulate:TRANsform:DISTance:MAXimum? Description: This command returns the maximum distance in millimeters if the current distance unit is set to meter, and otherwise returns the maximum distance in feet.
Page 140
5-2 :CALCulate Subsystem VNA Commands :CALCulate:TRANsform:DISTance:STARt :CALCulate:TRANsform:DISTance:STARt? Description: Sets the start distance for DTF measurements. The query version of this command returns the start distance in millimeters if the current distance unit is set to meter, and otherwise returns the start distance in feet.
Page 141
VNA Commands 5-2 :CALCulate Subsystem :CALCulate:TRANsform:DISTance:UNIT METers|FEET :CALCulate:TRANsform:DISTance:UNIT? Description: Sets the units to be used for DTF measurements. The query version of this command returns the string “METER” if the current distance unit is set to meter, and otherwise returns the string “FEET”. Syntax: :CALCulate:TRANsform:DISTance:UNIT METers|FEET :CALCulate:TRANsform:DISTance:UNIT? Cmd Parameter: <char>...
5-3 :Display Subsystem VNA Commands :Display Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe TRACe|MEMory|BOTH :DISPlay[:WINDow]:TRACe? Description: Sets the display type for the current active trace. Setting the display type to TRAC will display the trace only.
Page 143
VNA Commands 5-3 :Display Subsystem :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture <integer> :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture? Description: Sets the Group Delay aperture value (which is common to all traces). The query version of this command produces the Group Delay aperture as its output. Syntax: :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture <integer> :DISPlay:WINDow:TRACe:Y[:SCALe]:GDAPerture? Cmd Parameter: <NR1> <integer> Query Response: <NR1>...
Page 144
5-3 :Display Subsystem VNA Commands :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:PDIVision <value> :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:PDIVision? Description: Sets the scale per division for the y-axis. For Group Delay, sets the scale (time/division) for the y-axis. For Phase, sets the scale (degree/division) for the y-axis. For Log Magnitude and Log Mag/2, sets the scale (dB/division) for the y-axis.
Page 145
VNA Commands 5-3 :Display Subsystem :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RLEVel <value> :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Cmd Parameter: <NR3>...
Page 146
5-3 :Display Subsystem VNA Commands :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RPOSition <integer> :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:RPOSition? Description: Sets the reference line scale value for the y-axis. Cmd Parameter: <NR1> <integer> Query Response: <NR1> <integer> Default Value: Log Magnitude: 9 SWR: 1 Phase: 5 Group Delay: 5 Real: 5 Imag: 5 Log Mag/2: 9 Smith Chart: 10...
Page 147
VNA Commands 5-3 :Display Subsystem :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:SMCHart 0|10|20|30|-3 :DISPlay:WINDow:TRACe<Tr>:Y[:SCALe]:SMCHart? Description: Sets the Smith chart display scale type of the given trace number specified by <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1.
5-4 :Format Subsystem VNA Commands :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. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
VNA Commands 5-4 :Format Subsystem Interpreting Returned Data Pair The following section provides two conversion examples on interpreting returned data pairs. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values • For a 551 point trace, the instrument returns 4415 bytes. •...
Page 150
5-4 :Format Subsystem VNA Commands Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 00 31 2a 47 [real], 00 e8 6a c6 [imag] 1. Convert from little endian to big endian: 47 2a 31 00 [real], c6 6a e8 00 [imag] 2.
VNA Commands 5-5 :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Description: Sets the sweep to continuous. If the instrument is currently on hold, and if sweep type is set to continuous, then setting to ON restarts the sweep.
Page 152
5-5 :INITiate Subsystem VNA Commands :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
VNA Commands 5-6 :INPut Subsystem :INPut Subsystem This subsystem controls characteristics of the input port. :INPut<port_no>:BIAS:CURRent <current> :INPut<port_no>:BIAS:CURRent? [0|1] Description: Sets the internal bias tee current limit for the specified port. When this limit is exceeded, the Bias Tee trips (turns OFF). <port_no> is the specified internal bias tee port number 2.
Page 154
5-6 :INPut Subsystem VNA Commands :INPut:BIAS:STATe OFF|INTernal :INPut:BIAS:STATe? Description: Enables or disables the bias tee. Query returns OFF|INT. For OFF state, query returns OFF (not 0). Parameter: OFF|INTernal Cmd Parameter: <char> OFF|INTernal Query Response: <char> OFF|INT Default Value: OFF Front Panel Access: Shift-3 (Sweep), Configure Ports, Bias Tee Setup, Bias Tee :INPut<port_no>:BIAS:VOLTage <voltage>...
VNA Commands 5-7 :MMEMory Subsystem :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument setup and data storage. :MMEMory:LOAD:STATe <integer>, <file name> Description: Recalls a previously stored setup from the current save location. The saved setup that is to be loaded is specified by <file name>. <file name>...
Page 156
5-7 :MMEMory Subsystem VNA Commands :MMEMory:LOAD:TRACe <integer>,<file name> Description: Recalls a previously stored measurement trace from the current save location. The saved measurement trace that is to be loaded is specified by <file name>. <file name> must be enclosed in either single quotes (‘...
Page 157
VNA Commands 5-7 :MMEMory Subsystem :MMEMory:STORe:STATe <integer>, <file name> Description: Stores the current setup into the file that is specified by <file name>. <file name> must be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and must not contain a file extension. The <integer>...
VNA Commands 5-9 :SYSTem Subsystem :SYSTem Subsystem This subsystem contains commands that affect instrument functionality. This functionality does not directly relate to data collection, display, or transfer. :SYSTem:MBTemperature? TitleDescription: This command returns the current mother board temperature in degrees Celsius. Cmd Parameter: NA (query only) Query Response: <NR3>...
5-10 :Trace Subsystem VNA Commands 5-10 :Trace Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe[:DATA]? [1]|2|3|4 Description: Transfers the trace data of the given trace from the instrument to the controller.
Page 161
VNA Commands 5-10 :Trace Subsystem Example Response Format: #AX is #40078, where A = 4 (the number of digits in number X), and X = 0078 (the response has 78 characters). #40078SN=6897458,TYPE=DATA,DATE=2009-03-18-03-13-20-00,INT_BIAS_TEE_ CURRENT=0.000000 Parameters are returned in comma-delimited ASCII format. Each parameter is returned as “NAME=VALUE[UNITS]”.
Page 162
5-10 :Trace Subsystem VNA Commands Table 5-3. Trace Header Parameters (Sheet 1 of 8) Parameter Name Description Instrument serial # UNIT_NAME Instrument name TYPE The data type (Setup or Data) DATE Trace date/time APP_NAME Application name APP_VER Application firmware (FW) version SUB_MODE Sub Mode type, where: 0 is for Vector Network Analyzer,...
Page 163
VNA Commands 5-10 :Trace Subsystem Table 5-3. Trace Header Parameters (Sheet 2 of 8) Parameter Name Description DOMAIN Active Trace domain type, where: 0 is frequency domain, 2 is for distance domain TRACE_DOMAIN_TYPES Domain types for all 4 traces. This uses a bit mask shift, where the bit shift mask is defined as: DOMAIN_TYPE_BIT_SHIFT 4 DOMAIN_TYPE_BIT_MASK 0xF...
Page 164
5-10 :Trace Subsystem VNA Commands Table 5-3. Trace Header Parameters (Sheet 3 of 8) Parameter Name Description ACTIVE_TRACE Current active trace. Where: 0 is for trace 1, 1 for trace 2, 2 for trace 3, and 3 for trace 4 TOTAL_TRACE Total number of traces AVERAGING_COUNT...
Page 165
VNA Commands 5-10 :Trace Subsystem Table 5-3. Trace Header Parameters (Sheet 4 of 8) Parameter Name Description IFBW The index of the selected IFBW list, where 0 is the first in the list. DUT_LINE_TYPE DUT Line Type, where Coax = 0. CUTOFF_FREQ Currently not used.
Page 166
5-10 :Trace Subsystem VNA Commands Table 5-3. Trace Header Parameters (Sheet 5 of 8) Parameter Name Description TRACE_SMOOTHING_PERCENT Trace smoothing percent. This uses a bit mask shift, where the bit shift mask is defined as: PERC_SMOOTHING_BIT_SHIFT 8 PERC_SMOOTHING_BIT_MASK 0xFF SMOOTHING_PERCENT Current active trace smoothing percent.
Page 167
VNA Commands 5-10 :Trace Subsystem Table 5-3. Trace Header Parameters (Sheet 6 of 8) Parameter Name Description TRACE_x_IMAG_Z_RESOLUTION Imaginary Impedance resolution, where x is the trace number. Returned value is 1000 times the resolution value. TRACE_x_IMAG_Z_REFERENCE Imaginary Impedance Reference value, where x is the trace number.
Page 168
5-10 :Trace Subsystem VNA Commands Table 5-3. Trace Header Parameters (Sheet 7 of 8) Parameter Name Description TRACE_x_SWR_RESOLUTION SWR Resolution, where x is the trace number. Returned value is 1000 times the SWR Resolution. TRACE_x_SWR_REFERENCE SWR Reference value, where x is the trace number.
Page 169
VNA Commands 5-10 :Trace Subsystem Table 5-3. Trace Header Parameters (Sheet 8 of 8) Parameter Name Description TRACE_x_1PCL_RESOLUTION Log Mag/2 resolution, where x is the trace number. Returned value is in dB. TRACE_x_1PCL_REFERENCE Log Mag/2 Reference value, where x is the trace number.
Page 170
5-10 :Trace Subsystem VNA Commands Table 5-4. Trace Header Marker Parameters Markers Parameter Name Description MKR_MWVNA_Xx Marker x X value (where x is the marker number 1 to 8) MKR_MWVNA_POINTx Marker x display point MKR_MWVNA_REALx Marker x Real value MKR_MWVNA_IMAGx Marker x Imaginary value MKR_MWVNA_READOUTx Marker x readout style.
5-11 [:SENSe] Subsystem VNA Commands 5-11 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not to signal-oriented parameters. [:SENSe]:RFON[:STATe] ON|OFF|1|0 Description: Sets the state of the RF output signal at the VNA ports to be either ON or OFF when the sweep is set to Hold.
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:APPLication Subsystem This subsystem contains application specific commands. [:SENSe]:APPLication:TST? NORMal|PWRon Description: Executes an application self test and reports whether any errors were detected. A return value of “0” indicates that the test was completed without detecting any error. Two self test types can be specified.
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:AVERage Subsystem This subsystem contains commands that are related to the combination of the data from consecutive sweeps. Use commands in this subsystem to control sweep-to-sweep averaging and max hold functionality. [:SENSe]:AVERage:CLEar Description: No query. Clears and restarts averaging of the measurement data. Note that sweep averaging count must be set to greater than 1 for averaging to restart.
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:CORRection Subsystem This subsystem provides commands for losses or gains external to the instrument. [:SENSe]:CORRection:DATA? <error terms parameters> Description: Transfers the system error correction data from the instrument to the controller. <error term parameter> are string parameters that describe the different error terms.
Page 176
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]:SMCHart 50|75 [:SENSe]:CORRection:IMPedance[:INPut][:MAGNitude]:SMCHart? Description: Sets the Smith Chart reference impedance. Sets 50 for 50 ohm. Sets 75 for 75 ohm. The query form of the command returns the current Smith Chart reference impedance in ohms. Cmd Parameter: <char>...
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:CORRection:CKIT Subsystem This subsystem provides commands that modify and configure the device under test (DUT). [:SENSe]:CORRection:CKIT:INFormation? <connector> Description: Returns a string of information of the given calibration connector. <connector> defines the connector family. Valid connectors for calibration line type COAX are as follows: NMALe|NFEMale|KMALe|KFEMale|716Male|716Female|TNCMale| TNCFemale|SMAMale|SMAFemale|USR1|USR2|USR3|USR4...
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:CORRection:CKIT:USER Subsystem This subsystem contains commands to configure the user device under test (DUT). [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT: C[0]|1|2|3 <capacitance> [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT: C[0]|1|2|3? Description: Sets the DUT capacitance value for the specified user. Cmd Parameter: <NRf> <capacitance> (e-15, e-27, e-36, e-45) Query Response: <NR3>...
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT: SHORt <length> [:SENSe]:CORRection:CKIT:USER[1]|2|3|4:COAX:SOLT:SHORt? Description: Sets the DUT capacitance value for the specified user. Cmd Parameter: <NRf> <length> (millimeters) Query Response: <NR3> <length> (millimeters) Example: To set the DUT short offset for User 1 with line type coax to 3 mm: :SENSe:CORRection:CKIT:USER:COAX:SOLT:SHORt 3 Front Panel Access: NA [:SENSe]:CORRection:COLLect Subsystem...
Page 180
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:CORRection:COLLect[:ACQUire] <cal steps>, <port_no> [:SENSe]:CORRection:COLLect[:ACQUire]? Description: Performs a measurement of the given steps. <cal steps> is the calibration step to be performed and must be one of the following values: OPEN|SHORT|LOAD| THRU|ISOLation <port_no> is the port number, 1. For calibration step OPEN, SHORT, and LOAD, valid port number is 1.
Page 181
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:CORRection:COLLect:ACQUire:STATus? [<cal steps>, <port_no>] Description: This command requests information about the current calibration step or the specified calibration step. If no calibration step is specified, then it returns a 1 if the current calibration step has completed, otherwise it returns a 0.
Page 182
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:CORRection:COLLect:METHod SOLT [:SENSe]:CORRection:COLLect:METHod? Description: Sets the calibration method. Parameter: SOLT Cmd Parameter: <char> SOLT Query Response: <char> SOLT Default Value: SOLT Front Panel Access: Shift-2 (Calibrate) [:SENSe]:CORRection:COLLect:SAVe Description: Calculates the calibration data according to the calibration method that is selected and the steps that are performed and then stores the result.
Page 183
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:CORRection:COLLect:STATus:ACCuracy? Description: This command requests information about the calibration accuracy status. The command returns: 0 when no calibration is available (CAL off) 1 when the calibration accuracy is high (OK: Accuracy High) 2 when the accuracy is moderate due to a change in power level (?P: Accuracy Moderate) 3 when the accuracy is moderate due to a change in temperature level by more than 5 deg C (?T: Accuracy Moderate)
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:FREQuency Subsystem Commands in this subsystem pertain to the frequency settings of the instrument. [:SENSe]:FREQuency:CENTer <freq> [:SENSe]:FREQuency:CENTer? Description: Sets the center frequency. Note that changing the value of the center frequency will change the value of the coupled parameters: Start Frequency and Stop Frequency.
Page 185
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:FREQuency:DSPAn? Description: This command returns the suggested frequency span based on the start and stop distance. Syntax: :FREQuency:DSPAn? Cmd Parameter: NA (query only) Query Response: <NR3> <freq> (hertz) Default Value: For 1.6 GHz Model: At preset, DSpan is 799750000 Hz For 6 GHz Model: At preset, DSan is 2999750000 Hz Default Units: Hz Range: For 1.6 GHz Model: 0 Hz to 799750000 Hz...
Page 186
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:FREQuency:STOP Description: Sets the stop frequency. Note that changing the value of the stop frequency will change the value of coupled parameters: Center Frequency and Span. Syntax: :FREQuency:STOP <freq> :FREQuency:STOP? Cmd Parameter: <NRf> <freq> (hertz) Query Response: <NR3>...
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:SWEep Subsystem This subsystem includes commands that affect the sweep parameters of the instrument. [:SENSe]:SWEep:IFBW <freq value> [:SENSe]:SWEep:IFBW? Description: Sets the IF Bandwidth. The <freq value> in Hz must be one of the following 13 values: 100000|50000|20000|10000|5000|2000|1000|500|200| 100|50|20|10 The query form of this command returns the frequency in Hz.
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:SWEep:TYPE SINGle|CONTinuous [:SENSe]:SWEep:TYPE? Description: Sets the sweep type. The query version of this command returns “SING” if current sweep is set to single sweep, and returns “CONT” if set to continuous sweep. Note that setting the sweep type to SINGle sets the sweep to hold.
Page 189
VNA Commands 5-11 [:SENSe] Subsystem [:SENSe]:TRACe<Tr>:SELect Description: Selects the given trace, <Tr>, as the active trace. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Note that this may also change the total number of traces.
Page 190
5-11 [:SENSe] Subsystem VNA Commands [:SENSe]:TRACe:TOTal <integer> [:SENSe]:TRACe:TOTal? Description: Sets the number of traces to display. Cmd Parameter: <char> [1|2|3|4] Query Response: <char> [1|2|3|4] Default Value: 2 Range: 1 to 4 Example: To set number of traces to 3: :SENSe:TRACe:TOTal 3 Front Panel Access: Measure, Number of Traces [:SENSe]:TRACe:SELect? Description: This command returns the current active trace number in the format...
Chapter 6 — Vector Voltmeter Commands Introduction This chapter describes commands for Vector Voltmeter mode. Only the commands that are listed in this chapter and in Chapter 3, “All Mode Commands” can be used in Vector Voltmeter mode. Using commands from other modes may produce unexpected results. Refer to Chapter 5 for additional information on the following commands.
Page 192
6-2 :FETCh Subsystem Vector Voltmeter Commands :FETCh:VVM:DATA? Description: Query only. Returns the most recent VVM measurement results. Data is returned as 2 or 4 comma-separated values depending upon the measurement type, measurement format, measurement mode, port, and the reference setting. A “–” is returned for any data that is not valid at that instance.
Vector Voltmeter Commands 6-3 :MMEMory Subsystem Example: To fetch the VVM data: :FETCh:VVM:DATA? Front Panel Access: NA :FETCh:VVM:REFerence:DATA? Description: Returns the reference data depending upon the measurement type, the measurement format, and the current port. Syntax: :FETCh:VVM:REFerence:DATA? Cmd Parameter: NA (query only) Query Response: NA (comma separated values) Example: To fetch the VVM reference data: :FETCh:VVM:REFerence:DATA?
Page 194
6-3 :MMEMory Subsystem Vector Voltmeter Commands :MMEMory:LOAD:TRACe <integer>,<file name> Description: Recalls a previously stored measurement trace from the current save location. The saved measurement trace that is to be loaded is specified by <file name>. <file name> must be enclosed in either single quotes (‘...
Page 195
Vector Voltmeter Commands 6-3 :MMEMory Subsystem :MMEMory:STORe:STATe <integer>, <file name> Description: Stores the current setup into the file that is specified by <file name>. <file name> must be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and must not contain a file extension. The <integer>...
6-4 :TRACe Subsystem Vector Voltmeter Commands :TRACe Subsystem This subsystem contains commands pertaining to the Vector Voltmeter mode. :TRACe:PREamble? Description: Query only. Returns trace header information. The response begins with an ASCII header. The header specifies the number of following bytes.
Page 197
Vector Voltmeter Commands 6-4 :TRACe Subsystem Trace Header Parameters Table 6-2 describes parameters that can be returned by the :TRACe:PREamble? command. Table 6-2. Trace Header Parameters Parameter Name Description Instrument Serial # UNIT_NAME Instrument name DATE Trace date/time APP_NAME Application name APP_VER Application firmware (FW) version VVM_MODE...
6-5 [:SENSe] Subsystem Vector Voltmeter Commands [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not to signal-oriented parameters. [:SENSe]:VVM:CABLe:SELect 1|2|3|4|5|6|7|8|9|10|11|12 [:SENSe]:VVM:CABLe:SELect? Description: Selects the VVM cable. The query format of the command returns the current VVM cable number. Cmd Parameter: <char>...
Page 199
Vector Voltmeter Commands 6-5 [:SENSe] Subsystem [:SENSe]:VVM:MODE CW|TABLe [:SENSe]:VVM:MODE? Description: Sets the VVM measurement mode. The query format of the command returns the VVM measurement mode. Cmd Parameter: <char> CW|TABLe Query Response: <char> CW|TABL Default Value: CW Example: To set the mode to Table: :SENSe:VVM:MODE TABLe Front Panel Access: CW: Hard Key 1 TABLe: Hard Key 2...
Page 200
6-5 [:SENSe] Subsystem Vector Voltmeter Commands [:SENSe]:VVM:TYPE RETurn|INSertion [:SENSe]:VVM:TYPE? Description: Sets the VVM measurement type. The query format of the command returns the VVM measurement type. Parameter: RETurn|INSertion Cmd Parameter: <char> RETurn|INSertion Query Response: <char> RET|INS Default Value: RET Example: To set the type to Insertion: :SENSe:VVM:TYPE INSertion Front Panel Access: CW/Table, Measurement Type 6-10...
Chapter 7 — Fixed WiMAX Commands :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Title: Abort Description: Restarts the current sweep and/or measurement. Resets the trigger system. If :INITiate:CONTinuous is OFF (i.e., the instrument is in single sweep mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
7-2 :CONFigure Subsystem Fixed WiMAX Commands :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It will not initiate the taking of a measurement.
Page 203
Fixed WiMAX Commands 7-2 :CONFigure Subsystem When the SUMMARY option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then Demodulator, then Modulation Summary from the front panel. When the CONStln option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then Demodulator, then Constellation from the front panel.
Page 204
7-2 :CONFigure Subsystem Fixed WiMAX Commands When the SUMMary option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then RF, then RF Summary from the front panel. When the SPECtrum option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then RF, then Spectrum from the front panel.
Fixed WiMAX Commands 7-3 :DISPlay Subsystem :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:MAXHold OFF|ON|0|1 :DISPlay:WINDow:TRACe:MAXHold? Title: Max Hold State Description: Specifies whether the Max Hold is ON or OFF.
Page 206
7-3 :DISPlay Subsystem Fixed WiMAX Commands :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <value> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Title: Scale Resolution Per Division Description: Sets the scale per division for the y-axis. The units change from dB/div to % when EVM is the y-axis value. The resolution per division value is maintained separately for each measurement.
Fixed WiMAX Commands 7-4 :FETCh Subsystem :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
Page 208
7-4 :FETCh Subsystem Fixed WiMAX Commands :FETCh:PFail? Title: Fetch PASS/FAIL Description: Returns the most recent PASS/FAIL measurement results. Measurement results are returned in a block of ASCII text in the format of <header><block>. The ASCII header specifies the number of data bytes.
Page 209
Fixed WiMAX Commands 7-4 :FETCh Subsystem :FETCh:RF:PVTime? Title: Fetch Power vs. Time Description: Returns the most recent WiMAX 802.16-2004 OFDM signal over approximately one frame time domain measurement results. Data is returned as 4 comma-delimited values: The Channel Power in dBm, Preamble power in dBm, burst power of data bursts in dBm, and the Crest Factor in dB.
7-5 :FORMat Subsystem Fixed WiMAX Commands :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 is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Title: Numeric Data Format...
Page 211
Fixed WiMAX Commands 7-6 :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Title: Continuous/Single Sweep Description: Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, another sweep/measurement is triggered as soon as the current one completes.
7-7 :MEASure Subsystem Fixed WiMAX Commands :MEASure Subsystem These commands 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.
Page 213
Fixed WiMAX Commands 7-7 :MEASure Subsystem :CONFigure:DEMod EVSCarrier Commands to set the desired settings :READ:DEMod:EVSCarrier? Data is returned as 8 comma-delimited values: EVM (rms) in %, EVM (pk) in %, RCE (rms) in dB, RCE (pk) in dB, Carrier Frequency in MHz, Freq Error in MHz, Freq Error in ppm, and the Base Station ID.
Page 214
7-7 :MEASure Subsystem Fixed WiMAX Commands :MEASure:PFail? Title: Measure PASS/FAIL Description: Sets the active measurement to PASS/FAIL, sets the default measurement parameters, triggers a new measurement and returns the PASS/FAIL results. It is a combination of the commands :CONFigure PFail and :READ:PFail? To make a PASS/FAIL measurement with settings other than the default values, send: :CONFigure PFail Commands to set desired settings...
Page 215
Fixed WiMAX Commands 7-7 :MEASure Subsystem :MEASure:RF:PVTime? Title: Measure Power vs. Time Description: Sets the active measurement to Power vs. Time, sets the default measurement parameters, triggers a new measurement and returns the Channel Power, Preamble power, burst power of data bursts, and the Crest Factor.
7-8 :MMEMory Subsystem Fixed WiMAX Commands :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<file name> Title: Recall Setup Description: Recalls a previously stored instrument setup in the current save location.
Page 217
Fixed WiMAX Commands 7-8 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<file name> Title: Recall Measurement Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 218
7-8 :MMEMory Subsystem Fixed WiMAX Commands :MMEMory:STORe:STATe <integer>,<file name> Title: Save Setup Description: 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. Use the command MMEMory:MSIS to set the current save location.
Fixed WiMAX Commands 7-9 :READ Subsystem :READ Subsystem 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 220
7-9 :READ Subsystem Fixed WiMAX Commands :READ:DEMod:EVSYmbol? Title: Read EVM vs. Symbol Description: Triggers a new EVM vs. Symbol measurement and returns the results: EVM (rms), EVM (pk), RCE (rms), RCE (pk), Carrier Frequency, Freq Error, Freq Error, and the Base Station ID The EVM vs. Symbol measurement must be the active measurement (specified by :CONFigure:DEMod EVSYmbol).
Page 221
Fixed WiMAX Commands 7-9 :READ Subsystem Data is returned as 11 comma-delimited values: The Channel Power in dBm, relative adjacent channel 1 power level, absolute adjacent channel 1 power level, relative adjacent channel 2 power level, absolute adjacent channel 2 power level, relative adjacent channel 3 power level, absolute adjacent channel 3 power level, relative adjacent channel 4 power level, absolute adjacent channel 4 power level, relative adjacent channel 5 power level, absolute adjacent channel 5 power level.
7-10 :TRACe Subsystem Fixed WiMAX Commands 7-10 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? <trace type> Title: Returns trace header information for the specified trace. The <trace type> must be one of the following: SPECtrum|PVTime|ACPR|CONStln|SFLatness|EVSCarrier|EVSY mbol Data can be transferred to and from the 7 available display trace types.
Page 223
Fixed WiMAX Commands 7-10 :TRACe Subsystem Table 7-1. Available Parameters in WiMAX and Mobile WiMAX Mode (Sheet 2 of 3) Parameter Name Description CHANNEL Current channel POWER_OFFSET Applied power offset REFERENCE_FREQUENCY Selected external reference frequency UNITS Amplitude units CURRENT_VIEW Current view CURRENT_MEASURMENTS Current measurements DYNAMIC_ATTENUATION...
Page 224
7-10 :TRACe Subsystem Fixed WiMAX Commands Table 7-1. Available Parameters in WiMAX and Mobile WiMAX Mode (Sheet 3 of 3) Parameter Name Description EVM_SYM_STOP EVM vs. Symbol stop 7-24 PN: 10580-00319 Rev. N S412E PM...
Page 225
Fixed WiMAX Commands 7-10 :TRACe Subsystem :TRACe[:DATA]? <trace type> Title: Trace Data Transfer Description: This command transfers trace data from the instrument to the controller. The <trace type> must be one of the following: SPECtrum|PVTime|CONStln|SFLatness|EVSCarrier|EVSYmbol. The format of the block data in the query form is specified by :FORMat:DATA.
7-11 [:SENSe] Subsystem Fixed WiMAX Commands 7-11 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:BANDwidth|BWIDth[:RESolution] <index> [:SENSe]:BANDwidth|BWIDth[:RESolution]? Title: Resolution Bandwidth Description: Sets the resolution bandwidth. The <index> argument is a 1-based index of the position of the desired bandwidth in the instrument’s current bandwidth list.
Page 227
Fixed WiMAX Commands 7-11 [:SENSe] Subsystem [:SENSe]:DEMod:CONStln:REFPoints[:STATe] OFF|ON|0|1 [:SENSe]:DEMod:CONStln:REFPoints[:STATe]? Title: Constellation Reference Points Required Option: 47 Description: Sets the display of the reference points for the various constellations on/off. The query will return 1 for ON and 0 for OFF. Parameter: OFF|ON|0|1 Parameter Type: <boolean>...
Page 228
7-11 [:SENSe] Subsystem Fixed WiMAX Commands [:SENSe]:DEMod:SFLatness:STOP:X? Title: Spectral Flatness Stop Value Description: Queries the Spectral Flatness stop value. Related Command: :DEMod:SFLatness:STARt:X? [:SENSe]:DLFLength 2.5|5|10 [:SENSe]:DLFLength? Title: Down Link Frame Length Description: Sets the Down Link Frame Length, in milliseconds. The query form of this command will return the Down Link Frame Length in seconds (not milliseconds).
Page 229
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink, the value of the <string> argument would be “P-GSM 900 - Uplink”.
Page 230
7-11 [:SENSe] Subsystem Fixed WiMAX Commands [:SENSe]:POWer[:RF]:RANGe:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:RANGe:AUTO? Title: Automatic Amplitude Range Description: Sets the automatic amplitude range. Setting the value to ON or 1 will result in the amplitude range being coupled to the detected input signal level. Setting the value to OFF or 0 will result in the input attenuation being un-coupled from the input signal level.
Page 231
Fixed WiMAX Commands 7-11 [:SENSe] Subsystem [:SENSe]:RF:PVTime:FRAMe:STOP? Title: Power vs. Time Frame Stop Time Description: Queries the Power vs. Time frame stop time. Default Unit: seconds Related Command: :RF:PVTime:FRAMe:STARt? :DLFLength? [:SENSe]:RF:SPECtrum:SPAN 5|10|20|30 [:SENSe]:RF:SPECtrum:SPAN? Title: Spectrum View Span Description: Sets the span for the Spectrum view. Setting the value to 5 will set the span for the Spectrum view to 5 MHz.
Page 233
Chapter 8 — Mobile WiMAX Commands :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Title: Abort Description: Restarts the current sweep and/or measurement. Resets the trigger system. If :INITiate:CONTinuous is OFF (i.e., the instrument is in single sweep mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
Page 234
8-2 :CONFigure Subsystem Mobile WiMAX Commands :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It will not initiate the taking of a measurement.
Page 235
Mobile WiMAX Commands 8-2 :CONFigure Subsystem :CONFigure:DEMod <char> Title: Configure Demodulation Measurement Required Option: 47 Description: Valid <char> parameters are: SUMMary|CONStln|SFLatness|EVSCarrier|EVSYmbol. This command configures the selected demodulation 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).
Page 236
8-2 :CONFigure Subsystem Mobile WiMAX Commands When the SUMMary option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then RF, then RF Summary from the front panel. When the SPECtrum option is selected, the measurement results are equivalent to the results that are displayed by choosing Measurements, then RF, then Spectrum from the front panel.
Page 237
Mobile WiMAX Commands 8-3 :DISPlay Subsystem :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:MAXHold OFF|ON|0|1 :DISPlay:WINDow:TRACe:MAXHold? Title: Max Hold State Description: Specifies whether the Max Hold is ON or OFF.
Page 238
8-3 :DISPlay Subsystem Mobile WiMAX Commands :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <value> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Title: Scale Resolution Per Division Description: Sets the scale per division for the y-axis. The units change from dB/div to % when EVM is the y-axis value. The resolution per division value is maintained separately for each measurement.
Page 239
Mobile WiMAX Commands 8-4 :FETCh Subsystem :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
Page 240
8-4 :FETCh Subsystem Mobile WiMAX Commands :FETCh:PFail? Title: Fetch PASS/FAIL Description: Returns the most recent PASS/FAIL measurement results. Measurement results are returned in a block of ASCII text in the format of <header><block>. The ASCII header specifies the number of data bytes.
Page 241
Mobile WiMAX Commands 8-4 :FETCh Subsystem :FETCh:RF:PVTime? Title: Fetch Power vs. Time Description: Returns the most recent WiMAX 802.16-2004 OFDM signal over approximately one frame time domain measurement results. Data is returned as 4 comma-delimited values: The Channel Power in dBm, Preamble power in dBm, downlink burst power of data bursts in dBm, and uplink burst power of data bursts in dBm.
Page 242
8-5 :FORMat Subsystem Mobile WiMAX Commands :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 is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Title: Numeric Data Format...
Page 243
Mobile WiMAX Commands 8-6 :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Title: Continuous/Single Sweep Description: Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, another sweep/measurement is triggered as soon as the current one completes.
Page 244
8-7 :MEASure Subsystem Mobile WiMAX Commands :MEASure Subsystem These commands 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.
Page 245
Mobile WiMAX Commands 8-7 :MEASure Subsystem Data is returned as 8 comma-delimited values: EVM (rms) in %, EVM (pk) in %, RCE (rms) in dB, RCE (pk) in dB, Carrier Frequency in MHz, Freq Error in MHz, Freq Error in ppm, and the Base Station ID. Related Command: :READ:DEMod:EVSCarrier? :CONFigure:DEMod EVSCarrier :MEASure:DEMod:EVSYmbol?
Page 246
8-7 :MEASure Subsystem Mobile WiMAX Commands :MEASure:PFail? Title: Measure PASS/FAIL Description: Sets the active measurement to PASS/FAIL, sets the default measurement parameters, triggers a new measurement and returns the PASS/FAIL results. It is a combination of the commands :CONFigure PFail and :READ:PFail? To make a PASS/FAIL measurement with settings other than the default values, send: :CONFigure PFail Commands to set desired settings...
Page 247
Mobile WiMAX Commands 8-7 :MEASure Subsystem :MEASure:RF:PVTime? Title: Measure Power vs. Time Description: Sets the active measurement to Power vs. Time, sets the default measurement parameters, triggers a new measurement and returns the Channel Power, Preamble power, burst power of data bursts, and the Crest Factor.
Page 248
8-8 :MMEMory Subsystem Mobile WiMAX Commands :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<file name> Title: Recall Setup Description: Recalls a previously stored instrument setup in the current save location.
Page 249
Mobile WiMAX Commands 8-8 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<file name> Title: Recall Measurement Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 250
8-8 :MMEMory Subsystem Mobile WiMAX Commands :MMEMory:STORe:STATe <integer>,<file name> Title: Save Setup Description: 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. Use the command MMEMory:MSIS to set the current save location.
Page 251
Mobile WiMAX Commands 8-9 :READ Subsystem :READ Subsystem 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 252
8-9 :READ Subsystem Mobile WiMAX Commands Data is returned as 8 comma-delimited values: EVM (rms) in %, EVM (pk) in %, RCE (rms) in dB, RCE (pk) in dB, Carrier Frequency in MHz, Freq Error in MHz, Freq Error in ppm, and the Base Station ID. Related Command: :FETCh:DEMod:EVSYmbol? :CONFigure:DEMod EVSYmbol :READ:DEMod:SFLatness?
Page 253
Mobile WiMAX Commands 8-9 :READ Subsystem Data is returned as 11 comma-delimited values: The Channel Power in dBm, relative adjacent channel 1 power level, absolute adjacent channel 1 power level, relative adjacent channel 2 power level, absolute adjacent channel 2 power level, relative adjacent channel 3 power level, absolute adjacent channel 3 power level, relative adjacent channel 4 power level, absolute adjacent channel 4 power level, relative adjacent channel 5 power level, absolute adjacent channel 5 power level.
Page 254
8-10 :TRACe Subsystem Mobile WiMAX Commands 8-10 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? <trace type> Title: Trace Header Transfer Description: Returns trace header information for the specified trace. The <trace type>...
Page 255
Mobile WiMAX Commands 8-10 :TRACe Subsystem Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory. Except for CONStln there is only one value per data point. If max hold is set to ON for SPECtrum and EVM vs.
Page 256
8-11 [:SENSe] Subsystem Mobile WiMAX Commands 8-11 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:BANDwidth|BWIDth[:RESolution] <index> [:SENSe]:BANDwidth|BWIDth[:RESolution]? Title: Resolution Bandwidth Description: Sets the resolution bandwidth. The <index> argument is a 1-based index of the position of the desired bandwidth in the instrument’s current bandwidth list.
Page 257
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink then the value of the <string>...
Page 258
“Measurement” menu, press the “Pass/Fail Mode” key, and then press the “Select Pass/Fail Test” submenu. Alternatively, the list can be retrieved remotely and viewed using the Anritsu Master Software Tools. The <test set> argument is a 1-based index of the position of the desired Pass/Fail test set in the instrument’s current Pass/Fail test set...
Page 259
Mobile WiMAX Commands 8-11 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Title: Amplitude Range Description: Re-calculates amplitude range. Note that issuing this command will set the automatic dynamic range OFF. Related Command: :POWer[:RF]:RANGe:AUTO Front Panel Access: Amplitude, Adjust Range [:SENSe]:RF:SPECtrum:SPAN 5|10|20|30 [:SENSe]:RF:SPECtrum:SPAN? Title: Spectrum View Span Description: Sets the span for the Spectrum view.
Page 260
8-11 [:SENSe] Subsystem Mobile WiMAX Commands 8-28 PN: 10580-00319 Rev. N S412E PM...
Chapter 9 — LTE Commands :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Title: Abort Description: Restarts the current sweep and/or measurement. If INITiate:CONTinuous is OFF (i.e. the instrument is in single sweep mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
9-2 :CALCulate Subsystem LTE Commands :CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. :CALCulate:MARKer:AOFF Title: Turn All Markers Off Description: Turns off all markers in Channel Spectrum. Front Panel Access: Marker, Markers Off :CALCulate:MARKer1:DELTa:X <x1 parameter>...
Page 263
LTE Commands 9-2 :CALCulate Subsystem :CALCulate:MARKer1:STATe OFF|ON|DELta :CALCulate:MARKer1:STATe? Set Marker 1 State Title: Description: Sets marker 1 on/off or delta. Parameter: OFF|ON|DELta Parameter Type: <char> Default Value: OFF Front Panel Access: Marker, Marker Select (M1), Marker State :CALCulate:MARKer1:X <x-parameter> :CALCulate:MARKer1:X? Title: Set Marker 1 Value Description: Sets/Queries the location of marker 1 on the x-axis at the specified location.
Page 264
9-2 :CALCulate Subsystem LTE Commands :CALCulate:MARKer2:DELTa:Y? Title: Delta Marker 2 Read Y Value Description: Reads the current absolute Y value for delta marker 2. Default Unit: dBm :CALCulate:MARKer2:MAXimum Title: Set Marker 2 to Peak Description: Moves marker 2 to peak position on data trace. Parameter: NA Front Panel Access: Marker, Marker Select (M2), Peak Search :CALCulate:MARKer2:STATe OFF|ON|DELta...
LTE Commands 9-3 :CONFigure Subsystem :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. It sets the instrument to single sweep mode, waiting for an :INITiate command. It will not initiate the taking of a measurement.
Page 266
9-3 :CONFigure Subsystem LTE Commands :CONFigure:DEMod SUMMary|CONStln|CCPGraph|CCPTable|TIMEalign Title: Select the Modulation Measurement Description: Sets measurement to one of the Modulation screens. This can be one of: SUMMary: Modulation Summary view CONStln: Modulation Constellation diagram CCPGraph: Control Channel Power - Bar-graph view CCPTable: Control Channel Power - Table view TIMEalign: Tx Time Alignment It disables any other active measurements.
Page 267
LTE Commands 9-3 :CONFigure Subsystem :CONFigure:RF SUMMary|SPECtrum|ACLR|SEM Title: Select RF Measurements Description: This command configures RF measurements. 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] commands before initiating a measurement.
9-4 :DISPlay Subsystem LTE Commands :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:Y[:SCALe]:OFFSet <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:OFFSet? Title: Power Offset Description: Sets the power offset value for the y-axis.
LTE Commands 9-5 :FETCh Subsystem :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To make a new measurement, use the INITiate command. To get new measurement data, use the READ or MEASure query commands.
Page 270
9-5 :FETCh Subsystem LTE Commands :FETCh:OTA:C4AGGregation? Title: Fetch OTA Carrier Aggregation (4x4 MIMO configuration) Description: Returns the result of the most recent Carrier Aggregation measurement numeric results. This command may not be supported if your instrument is loaded with older firmware, in which case you may upgrade to the current firmware version or use the :FETCh:OTA:CAGGregation? command, instead.
Page 271
LTE Commands 9-5 :FETCh Subsystem :FETCh:RF:SPECtrum? Title: Fetch RF Spectrum Description: Returns the most recent RF Spectrum measurement results. Data is returned as 2 comma-delimited values: Channel Power in dBm and Occupied bandwidth measurement in MHz. “--” is returned for each data that is not valid at that instance.
9-6 :FORMat Subsystem LTE Commands :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 is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Title: Numeric Data Format...
LTE Commands 9-7 :INITiate Subsystem :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate:CONTinuous OFF|ON|0|1 :INITiate:CONTinuous? Title: Continuous/Single Sweep Description: Specifies whether the sweep/measurement is triggered continuously. If the value is set to ON or 1, another sweep/measurement is triggered as soon as the current one completes.
9-8 :MEASure Subsystem LTE Commands :MEASure Subsystem These commands 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.
Page 275
LTE Commands 9-8 :MEASure Subsystem :MEASure:DEMod:CONStln? Title: Measure Constellation Description: Triggers a new Constellation measurement and returns the results. The Constellation measurement must be the active measurement (specified by :CONFigure:DEMod CONStln). The current measurement can be queried using the command :CONFigure? Data is returned as 8 comma-delimited values: EVM (rms) in %, EVM (pk) in %, Ref Signal (RS) Power in dBm, Sync Signal (SS) Power in dBm, Carrier Frequency in MHz, Freq Error in Hz, Freq Error in ppm,...
Page 276
9-8 :MEASure Subsystem LTE Commands :MEASure:RF:ACLR? Title: Measure Adjacent Channel Leakage Ratio Description: Sets the active measurement to adjacent channel power ratio, sets the default measurement parameters, triggers a new measurement and returns the main channel(s) power, and adjacent channel(s) power. It is a combination of the commands :CONFigure:RF ACLR and :READ:RF:ACLR? Refer to “:READ:RF:ACLR?”...
LTE Commands 9-9 :READ Subsystem :READ Subsystem 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 278
9-9 :READ Subsystem LTE Commands :READ:OTA:C4AGGregation? Title: Read OTA Carrier Aggregation (4x4 MIMO configuration) Description: Triggers a new Carrier Aggregation measurement and returns the results. OTA Carrier Aggregation must be the active measurement. This command may not be supported if your instrument is loaded with older firmware, in which case you may upgrade to the current firmware version or use the :READ:OTA:CAGGregation? command, instead.
Page 279
LTE Commands 9-9 :READ Subsystem :READ:RF:ACLR? Title: Read Adjacent Channel Leakage Ratio Description: Triggers a new Adjacent Channel Leakage Ratio measurement and returns the results: Power levels for each channel (both absolute and relative). If the instrument is sweeping, it will not return until the sweep is complete.
9-10 :UNIT Subsystem LTE Commands 9-10 :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. :UNIT:POWer DBM|W :UNIT:POWer? Title: Measurement Units Description: Sets/Returns the current display mode for power values as either dBm or in watts.
LTE Commands 9-11 [:SENSe] Subsystem 9-11 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:4TAE:ACTive OFF|ON [:SENSe]:4TAE:ACTive? Title: Time Alignment Error (4x4 MIMO configuration) Description: Sets the state of the TAE measurement for OTA carrier aggregation. In 2x2 MIMO, use the command [:SENSe]:TAE:ACTive.
Page 282
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink, then the value of the <string>...
Page 283
LTE Commands 9-11 [:SENSe] Subsystem [:SENSe]:CELLID <char> [:SENSe]:CELLID? Title: Cell ID Description: Sets the Cell ID value used when Sync Type is set to ‘RS’. Parameter: (the known Cell ID) Parameter Type: <char> Front Panel Access: Setup, Sync (RS), Cell ID [:SENSe]:EMF:STATe OFF|ON|0|1 [:SENSe]:EMF:STATe? Title: EMF State...
Page 284
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is P-GSM 900 - Uplink, then the value of the <string>...
Page 285
LTE Commands 9-11 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Title: Amplitude Range Description: Re-calculates amplitude range. Note that issuing this command will set the automatic dynamic range OFF. Related Command: [:SENSe]:POWer[:RF]:RANGe:AUTO Front Panel Access: Amplitude, Adjust Range [:SENSe]:POWer[:RF]:RANGe:AUTO <Boolean (default=1 [ON])> [:SENSe]:POWer[:RF]:RANGe:AUTO? Title: Automatic Amplitude Range Description: Sets the automatic amplitude range.
Page 286
9-11 [:SENSe] Subsystem LTE Commands [:SENSe]:SYNC:TYPe SS|RS [:SENSe]:SYNC:TYPe? Title: Set Sync Type Description: Sets the sync type setting. Parameter: SS|RS Parameter Type: <char> Default Value: SS Front Panel Access: Setup, Sync, Sync Type [:SENSe]:TAE:ACTive OFF|ON [:SENSe]:TAE:ACTive? Title: Time Alignment Error Description: Sets the state of the TAE measurement for OTA carrier aggregation.
Page 287
Chapter 10 — P25 Phase 1 Commands 10-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
10-2 :CONFigure Subsystem P25 Phase 1 Commands 10-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 289
P25 Phase 1 Commands 10-2 :CONFigure Subsystem :CONFigure:BITCap Description: This command configures the P25 Bit Capture measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
Page 290
10-2 :CONFigure Subsystem P25 Phase 1 Commands :CONFigure:COVerage Description: This command configures the P25 Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
P25 Phase 1 Commands 10-3 :DISPlay Subsystem 10-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 292
10-3 :DISPlay Subsystem P25 Phase 1 Commands :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the P25 Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 293
P25 Phase 1 Commands 10-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
10-4 :FETCh Subsystem P25 Phase 1 Commands 10-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 295
P25 Phase 1 Commands 10-4 :FETCh Subsystem :FETCh:SIGAnalyzer? Description: Returns the most recent P25 Analyzer numerical measurement results. Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
10-5 :FORMat Subsystem P25 Phase 1 Commands 10-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description.
P25 Phase 1 Commands 10-5 :FORMat Subsystem Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram”...
Page 298
10-5 :FORMat Subsystem P25 Phase 1 Commands Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
P25 Phase 1 Commands 10-6 :INITiate Subsystem 10-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
10-7 :MEASure Subsystem P25 Phase 1 Commands 10-7 :MEASure Subsystem These commands 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.
Page 301
P25 Phase 1 Commands 10-7 :MEASure Subsystem :MEASure:SIGAnalyzer? Description: Sets the active measurement to P25 Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
10-8 :MMEMory Subsystem P25 Phase 1 Commands 10-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>.
Page 303
P25 Phase 1 Commands 10-8 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 304
10-8 :MMEMory Subsystem P25 Phase 1 Commands Control Channel, Bit Capture and IQ Data measurements can not be recalled on Note the instrument. :MMEMory:STORe:STATe <integer>,<filename> Description: Stores the current setup into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
P25 Phase 1 Commands 10-9 :READ Subsystem 10-9 :READ Subsystem 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).
Page 306
10-9 :READ Subsystem P25 Phase 1 Commands :READ:SIGAnalyzer? Description: Triggers a new P25 Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? P25 Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as...
P25 Phase 1 Commands 10-10 :SOURce Subsystem 10-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the P25 signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 308
10-10 :SOURce Subsystem P25 Phase 1 Commands :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 309
P25 Phase 1 Commands 10-10 :SOURce Subsystem :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value> :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Description: Sets the output power level for the P25 signal generator. Please note that changing the Tx power offset will also cause the display of this to adjust to the new offset. For example, if the output level is set to 0 dBm and the Tx level offset is then set to 10 dB external gain, the max limit and value of the Tx output level will be adjusted to 10 dBm.
10-11 :TRACe Subsystem P25 Phase 1 Commands 10-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 311
P25 Phase 1 Commands 10-11 :TRACe Subsystem Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 312
10-11 :TRACe Subsystem P25 Phase 1 Commands Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer.
Page 313
P25 Phase 1 Commands 10-11 :TRACe Subsystem Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 314
10-11 :TRACe Subsystem P25 Phase 1 Commands Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 315
P25 Phase 1 Commands 10-11 :TRACe Subsystem Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 316
10-11 :TRACe Subsystem P25 Phase 1 Commands Table 10-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 318
10-11 :TRACe Subsystem P25 Phase 1 Commands :TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen.
Page 319
P25 Phase 1 Commands 10-11 :TRACe Subsystem Please note that this command only works in the P25 Analyzer measurement. Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA S412E PM PN: 10580-00319 Rev.
10-12 :UNIT Subsystem P25 Phase 1 Commands 10-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the P25 Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
P25 Phase 1 Commands 10-13 [:SENSe] Subsystem 10-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 322
10-13 [:SENSe] Subsystem P25 Phase 1 Commands [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 323
P25 Phase 1 Commands 10-13 [:SENSe] Subsystem [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the P25 Analyzer Summary window are averaged. Please note that NAC is not averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA...
Page 324
10-13 [:SENSe] Subsystem P25 Phase 1 Commands [:SENSe]:DM:SQUelch <value> [:SENSe]:DM:SQUelch? Description: Sets the squelch power level. The squelch is only applied to the P25 Analyzer Summary window on the front panel and will blank out (--) all summary measurements except for Received Pwr when the received power level is lower than the squelch power setting.
Page 325
P25 Phase 1 Commands 10-13 [:SENSe] Subsystem [:SENSe]:DM:PATTern 1011hz|O.153|VOICe|CTRLchan [:SENSe]:DM:PATTern? Description: Sets the receiver pattern type. Please note that setting the Rx Pattern will restart the sweep. Cmd Parameters: 1011hz|O.153|VOICe|CTRLchan Query Parameters: NA Range: 1011hz|O.153|VOICe|CTRLchan Default Value: 1011hz Default Unit: NA Example: To set the modulation type to voice: :DM:PATTern VOICe Front Panel Access: Setup, Rx Pattern...
Page 326
10-13 [:SENSe] Subsystem P25 Phase 1 Commands [:SENSe]:FREQuency:COUPling OFF|ON|0|1 [:SENSe]:FREQuency:COUPling? Description: Turns on frequency coupling. When frequency coupling is on, the Tx frequency cannot be set directly. The Rx Frequency and coupling offset must be used to set the desired Tx frequency. The Tx frequency will automatically trail the Rx frequency by the frequency coupling offset every time the Rx frequency is set.
Page 327
P25 Phase 1 Commands 10-13 [:SENSe] Subsystem [:SENSe]:FREQuency:SPAN 25|50|100|500|1000|5000 [:SENSe]:FREQuency:SPAN? Description: Sets the span of the Spectrum display in P25 Analyzer measurement mode. Note: Span value is set and returned in kHz. Cmd Parameters: 25|50|100|500|1000|5000 Query Parameters: NA Range: 25|50|100|500|1000|5000 Default Value: 25 Default Unit: kHz Example: To set the span to 1 MHz:...
Page 328
10-13 [:SENSe] Subsystem P25 Phase 1 Commands [:SENSe]:POWer[:RF]:RANGe:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:RANGe:AUTO? Description: Turns auto range for the receiver on or off. When auto range is on, the reference level is automatically adjusted to the proper value to show the trace on the screen. If the auto ranging is turned off, the reference level will not adjust according to where the trace is.
Page 329
Chapter 11 — P25 Phase 2 Commands 11-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
11-2 :CONFigure Subsystem P25 Phase 2 Commands 11-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 331
P25 Phase 2 Commands 11-2 :CONFigure Subsystem :CONFigure:BITCap Description: This command configures the P25p2 Bit Capture measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
Page 332
11-2 :CONFigure Subsystem P25 Phase 2 Commands :CONFigure:COVerage Description: This command configures the P25p2 Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
P25 Phase 2 Commands 11-3 :DISPlay Subsystem 11-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 334
11-3 :DISPlay Subsystem P25 Phase 2 Commands :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the P25p2 Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 335
P25 Phase 2 Commands 11-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr>...
Page 336
11-3 :DISPlay Subsystem P25 Phase 2 Commands :DISPlay[:WINDow]:TRACe<Tr>:SELect Description: Selects the given trace, <Tr>, as the active trace. <Tr> is the trace number in the range 1 to 4 for P25p2 Analyzer. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Cmd Parameters: NA Query Parameters: NA Range: NA...
P25 Phase 2 Commands 11-4 :FETCh Subsystem 11-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 338
11-4 :FETCh Subsystem P25 Phase 2 Commands :FETCh:SIGAnalyzer? Description: Returns the most recent P25p2 Analyzer numerical measurement results. Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
P25 Phase 2 Commands 11-5 :FORMat Subsystem 11-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description.
11-5 :FORMat Subsystem P25 Phase 2 Commands Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram|PROFile”...
Page 341
P25 Phase 2 Commands 11-5 :FORMat Subsystem Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
11-6 :INITiate Subsystem P25 Phase 2 Commands 11-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
P25 Phase 2 Commands 11-7 :MEASure Subsystem 11-7 :MEASure Subsystem These commands 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.
Page 344
11-7 :MEASure Subsystem P25 Phase 2 Commands :MEASure:SIGAnalyzer? Description: Sets the active measurement to P25p2 Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
P25 Phase 2 Commands 11-8 :MMEMory Subsystem 11-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>.
Page 346
11-8 :MMEMory Subsystem P25 Phase 2 Commands :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 347
P25 Phase 2 Commands 11-8 :MMEMory Subsystem “.lte” for LTE measurements “.p25” for P25 measurements “.p252” for P25p2 measurements “.nxdn” for NXDN measurements “.dpmr” for dPMR measurements “.dmr2” for DMR 2 measurements “.ptc” for PTC measurements “.tetra” for TETRA measurements “.nbfm”...
Page 348
11-8 :MMEMory Subsystem P25 Phase 2 Commands :MMEMory:STORe:TRACe <integer>,<filename> Description: Stores the trace into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes (" ") and should not contain a file extension. Use the command MMEMory:MSIS to set the current save location.
P25 Phase 2 Commands 11-9 :READ Subsystem 11-9 :READ Subsystem 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).
Page 350
11-9 :READ Subsystem P25 Phase 2 Commands :READ:SIGAnalyzer? Description: Triggers a new P25p2 Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? P25p2 Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as...
P25 Phase 2 Commands 11-10 :SOURce Subsystem 11-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the P25p2 signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 352
11-10 :SOURce Subsystem P25 Phase 2 Commands :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 353
P25 Phase 2 Commands 11-10 :SOURce Subsystem :SOURce:FREQuency:CENTer <value> :SOURce:FREQuency:CENTer? Description: Sets the signal generator center frequency. Please note that setting the center frequency will restart the sweep. The query returns the current signal generator frequency in Hz. Cmd Parameters: <value> Query Parameters: NA Range: 500000 Hz to 1600000000 Hz Default Value: 800000000 Hz...
Page 354
11-10 :SOURce Subsystem P25 Phase 2 Commands :SOURce:STATe OFF|ON|0|1 :SOURce:STATe? Description: Turns the signal generator ON or OFF. Please note that the Generator ON/OFF button will toggle depending on the state. When the signal generator is on, the button will show Turn Sig-Gen OFF. When the signal generator is off, the button will show Turn Sig-Gen ON.
P25 Phase 2 Commands 11-11 :TRACe Subsystem 11-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 356
11-11 :TRACe Subsystem P25 Phase 2 Commands Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 357
P25 Phase 2 Commands 11-11 :TRACe Subsystem Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer.
Page 358
11-11 :TRACe Subsystem P25 Phase 2 Commands Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 359
P25 Phase 2 Commands 11-11 :TRACe Subsystem Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 360
11-11 :TRACe Subsystem P25 Phase 2 Commands Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 361
P25 Phase 2 Commands 11-11 :TRACe Subsystem Table 11-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 363
P25 Phase 2 Commands 11-11 :TRACe Subsystem :TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram|PROFile Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen.
Page 364
11-11 :TRACe Subsystem P25 Phase 2 Commands Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram|PROFile Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram|PROFile Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA 11-36 PN: 10580-00319 Rev. N S412E PM...
P25 Phase 2 Commands 11-12 :UNIT Subsystem 11-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the P25p2 Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
11-13 [:SENSe] Subsystem P25 Phase 2 Commands 11-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 367
P25 Phase 2 Commands 11-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 368
11-13 [:SENSe] Subsystem P25 Phase 2 Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the P25p2 Analyzer Summary window are averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15: :AVERage:COUNt 15...
Page 369
P25 Phase 2 Commands 11-13 [:SENSe] Subsystem [:SENSe]:DM:FORMat BS|MS [:SENSe]:DM:FORMat? Description: Sets the modulation type to Base Station (BS) or Mobile Station (MS). Please note that setting the modulation type will restart the sweep. Cmd Parameters: BS|MS Query Parameters: NA Range: BS|MS Default Value: BS Default Unit: NA...
Page 370
11-13 [:SENSe] Subsystem P25 Phase 2 Commands The set command is sent using the units selected with the Rx Units button on the front panel or with the command: UNIT:POWer:RX. If the Rx Units has been set to dBm, the squelch setting must be set in dBm. If the unit is set to watts, the squelch setting must be set in fW.
Page 371
P25 Phase 2 Commands 11-13 [:SENSe] Subsystem [:SENSe]:FREQuency:COUPling OFF|ON|0|1 [:SENSe]:FREQuency:COUPling? Description: Turns on frequency coupling. When frequency coupling is on, the Tx frequency cannot be set directly. The Rx Frequency and coupling offset must be used to set the desired Tx frequency. The Tx frequency will automatically trail the Rx frequency by the frequency coupling offset every time the Rx frequency is set.
Page 372
11-13 [:SENSe] Subsystem P25 Phase 2 Commands [:SENSe]:FREQuency:SPAN 25|50|100|500|1000|5000 [:SENSe]:FREQuency:SPAN? Description: Sets the span of the Spectrum display in P25p2 Analyzer measurement mode. Note: Span value is set and returned in kHz. Cmd Parameters: 25|50|100|500|1000|5000 Query Parameters: NA Range: 25|50|100|500|1000|5000 Default Value: 25 Default Unit: kHz Example: To set the span to 1 MHz:...
Page 373
P25 Phase 2 Commands 11-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe:AUTO OFF|ON|0|1 [:SENSe]:POWer[:RF]:RANGe:AUTO? Description: Turns auto range for the receiver on or off. When auto range is on, the reference level is automatically adjusted to the proper value to show the trace on the screen. If the auto ranging is turned off, the reference level will not adjust according to where the trace is.
Chapter 12 — NXDN Commands 12-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
12-2 :CONFigure Subsystem NXDN Commands 12-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 377
NXDN Commands 12-2 :CONFigure Subsystem :CONFigure:BITCap Description: This command configures the NXDN Bit Capture measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
Page 378
12-2 :CONFigure Subsystem NXDN Commands :CONFigure:COVerage Description: This command configures the NXDN Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
NXDN Commands 12-3 :DISPlay Subsystem 12-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 380
12-3 :DISPlay Subsystem NXDN Commands :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the NXDN Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 381
NXDN Commands 12-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: CONStellation|SPECtrum|HISTogram|SUMMary|EYEDiagram|...
12-4 :FETCh Subsystem NXDN Commands 12-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 383
NXDN Commands 12-4 :FETCh Subsystem :FETCh:SIGAnalyzer? Description: Returns the most recent NXDN Analyzer numerical measurement results. Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
12-5 :FORMat Subsystem NXDN Commands 12-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
NXDN Commands 12-5 :FORMat Subsystem Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram”...
Page 386
12-5 :FORMat Subsystem NXDN Commands Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
NXDN Commands 12-6 :INITiate Subsystem 12-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
12-7 :MEASure Subsystem NXDN Commands 12-7 :MEASure Subsystem These commands 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.
Page 389
NXDN Commands 12-7 :MEASure Subsystem :MEASure:SIGAnalyzer? Description: Sets the active measurement to NXDN Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
12-8 :MMEMory Subsystem NXDN Commands 12-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
Page 391
NXDN Commands 12-8 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 392
12-8 :MMEMory Subsystem NXDN Commands Control Channel, Bit Capture and IQ Data measurements can not be recalled on Note the instrument. :MMEMory:STORe:STATe <integer>,<filename> Description: Stores the current setup into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
NXDN Commands 12-9 :READ Subsystem 12-9 :READ Subsystem 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 394
12-9 :READ Subsystem NXDN Commands :READ:SIGAnalyzer? Description: Triggers a new NXDN Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? NXDN Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 7 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as...
NXDN Commands 12-10 :SOURce Subsystem 12-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the NXDN signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 396
12-10 :SOURce Subsystem NXDN Commands :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 397
NXDN Commands 12-10 :SOURce Subsystem :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value> :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Description: Sets the output power level for the NXDN signal generator. Please note that changing the Tx power offset will also cause the display of this to adjust to the new offset. For example, if the output level is set to 0 dBm and the Tx level offset is then set to 10 dB external gain, the max limit and value of the Tx output level will be adjusted to 10 dBm.
12-11 :TRACe Subsystem NXDN Commands 12-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 399
NXDN Commands 12-11 :TRACe Subsystem Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 400
12-11 :TRACe Subsystem NXDN Commands Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer. Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style).
Page 401
NXDN Commands 12-11 :TRACe Subsystem Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 402
12-11 :TRACe Subsystem NXDN Commands Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 403
NXDN Commands 12-11 :TRACe Subsystem Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 404
12-11 :TRACe Subsystem NXDN Commands Table 12-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 405
NXDN Commands 12-11 :TRACe Subsystem :TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen. The ASCII header specifies the number of data bytes.
Page 406
12-11 :TRACe Subsystem NXDN Commands Please note that this command only works in the NXDN Analyzer measurement. Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA 12-32 PN: 10580-00319 Rev.
NXDN Commands 12-12 :UNIT Subsystem 12-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the NXDN Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
12-13 [:SENSe] Subsystem NXDN Commands 12-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 409
NXDN Commands 12-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 410
12-13 [:SENSe] Subsystem NXDN Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the NXDN Analyzer Summary window are averaged. Please note that RAN is not averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15:...
Page 411
NXDN Commands 12-13 [:SENSe] Subsystem [:SENSe]:DM:BWIDth 12.5|6.25 [:SENSe]:DM:BWIDth? Description: Sets the modulation bandwidth. Please note that setting the modulation bandwidth will restart the sweep. Note: Modulation bandwidth value is set and returned in kHz. Cmd Parameters: 12.5|6.25 Query Parameters: NA Range: 12.5|6.25 Default Value: 12.5 Default Unit: kHz...
Page 412
12-13 [:SENSe] Subsystem NXDN Commands [:SENSe]:DM:SQUelch <value> [:SENSe]:DM:SQUelch? Description: Sets the squelch power level. The squelch is only applied to the NXDN Analyzer Summary window on the front panel and will blank out (--) all summary measurements except for Received Pwr when the received power level is lower than the squelch power setting.
Page 413
NXDN Commands 12-13 [:SENSe] Subsystem [:SENSe]:FREQuency:CENTer <value> [:SENSe]:FREQuency:CENTer? Description: Sets the receiver center frequency. Please note that setting the center frequency will restart the sweep Cmd Parameters: <value> Query Parameters: NA Range: For 1.6 GHz Model: 100000 Hz to 1600000000 Hz For 6 GHz Model: 100000 Hz to 6000000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 414
12-13 [:SENSe] Subsystem NXDN Commands [:SENSe]:FREQuency:COUPling:OFFSet <value> [:SENSe]:FREQuency:COUPling:OFFSet? Description: Sets the frequency coupling offset. If frequency coupling is on, the Tx frequency will automatically trail the Rx frequency by this amount. Please note that the instrument will prevent any coupling offset setting that will make the Tx frequency go beyond the min/max values.
Page 415
NXDN Commands 12-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In NXDN Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To adjust range:...
Page 416
12-13 [:SENSe] Subsystem NXDN Commands [:SENSe]:SYMBolspan <value> [:SENSe]:SYMBolspan? Description: Sets the symbol span. Please note that this setting only affects the Eye Diagram in the NXDN Analyzer measurement. Please note that setting the symbol span will restart the sweep. Cmd Parameters: <value> Query Parameters: NA Range: 2 to 5 Default Value: 2...
Chapter 13 — dPMR Commands 13-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORtfile Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
13-2 :CONFigure Subsystem dPMR Commands 13-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 419
dPMR Commands 13-2 :CONFigure Subsystem :CONFigure:COVerage Description: This command configures the dPMR Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
13-3 :DISPlay Subsystem dPMR Commands 13-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 421
dPMR Commands 13-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the dPMR Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 422
13-3 :DISPlay Subsystem dPMR Commands :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: CONStellation|SPECtrum|HISTogram|SUMMary|EYEDiagram|...
dPMR Commands 13-4 :FETCh Subsystem 13-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 424
13-4 :FETCh Subsystem dPMR Commands :FETCh:SIGAnalyzer? Description: Returns the most recent dPMR Analyzer numerical measurement results. Data is returned as 5 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
dPMR Commands 13-5 :FORMat Subsystem 13-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
13-5 :FORMat Subsystem dPMR Commands Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram”...
Page 427
dPMR Commands 13-5 :FORMat Subsystem Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
13-6 :INITiate Subsystem dPMR Commands 13-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
dPMR Commands 13-7 :MEASure Subsystem 13-7 :MEASure Subsystem These commands 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.
Page 430
13-7 :MEASure Subsystem dPMR Commands :MEASure:SIGAnalyzer? Description: Sets the active measurement to dPMR Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 5 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
dPMR Commands 13-8 :MMEMory Subsystem 13-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
Page 432
13-8 :MMEMory Subsystem dPMR Commands :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 433
dPMR Commands 13-8 :MMEMory Subsystem Note IQ Data measurements can not be recalled on the instrument. :MMEMory:STORe:STATe <integer>,<filename> Description: Stores the current setup into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
13-9 :READ Subsystem dPMR Commands 13-9 :READ Subsystem 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 435
dPMR Commands 13-9 :READ Subsystem :READ:SIGAnalyzer? Description: Triggers a new dPMR Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? dPMR Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 5 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as...
13-10 :SOURce Subsystem dPMR Commands 13-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the dPMR signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 437
dPMR Commands 13-10 :SOURce Subsystem :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 438
13-10 :SOURce Subsystem dPMR Commands The query will be returned in the unit that is selected through the Tx Units button on the front panel or with the command: UNIT:POWer:TX. The set command must be sent using the units selected. If the receiver unit has been set to dBm, the generator output level is returned in dBm and must be set in dBm.
Page 439
dPMR Commands 13-11 :TRACe Subsystem 13-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 440
13-11 :TRACe Subsystem dPMR Commands Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 441
dPMR Commands 13-11 :TRACe Subsystem Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer. Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style).
Page 442
13-11 :TRACe Subsystem dPMR Commands Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 443
dPMR Commands 13-11 :TRACe Subsystem Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 444
13-11 :TRACe Subsystem dPMR Commands Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 445
dPMR Commands 13-11 :TRACe Subsystem Table 13-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 446
13-11 :TRACe Subsystem dPMR Commands :TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen. The ASCII header specifies the number of data bytes.
Page 447
dPMR Commands 13-11 :TRACe Subsystem Please note that this command only works in the dPMR Analyzer measurement. Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA S412E PM PN: 10580-00319 Rev.
13-12 :UNIT Subsystem dPMR Commands 13-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the dPMR Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
dPMR Commands 13-13 [:SENSe] Subsystem 13-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 450
13-13 [:SENSe] Subsystem dPMR Commands [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 451
dPMR Commands 13-13 [:SENSe] Subsystem [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the dPMR Analyzer Summary window are averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15: :AVERage:COUNt 15 [:SENSe]:CORRection:OFFSet[:MAGNitude] <value>...
Page 452
13-13 [:SENSe] Subsystem dPMR Commands [:SENSe]:DM:BWIDth? Description: Queries the modulation bandwidth. Please note that setting the modulation bandwidth will restart the sweep. Note: Modulation bandwidth value is set to 6.25 kHz. Query Parameters: NA Range: 6.25 Default Unit: kHz Example: To query the modulation bandwidth: :DM:BWIDth? Front Panel Access: Setup, Mod Bandwidth [:SENSe]:DM:SQUelch <value>...
Page 453
dPMR Commands 13-13 [:SENSe] Subsystem [:SENSe]:FREQuency:CENTer <value> [:SENSe]:FREQuency:CENTer? Description: Sets the receiver center frequency. Please note that setting the center frequency will restart the sweep Cmd Parameters: <value> Query Parameters: NA Range: For 1.6 GHz Model: 100000 Hz to 1600000000 Hz For 6 GHz Model: 100000 Hz to 6000000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 454
13-13 [:SENSe] Subsystem dPMR Commands [:SENSe]:FREQuency:COUPling:OFFSet <value> [:SENSe]:FREQuency:COUPling:OFFSet? Description: Sets the frequency coupling offset. If frequency coupling is on, the Tx frequency will automatically trail the Rx frequency by this amount. Please note that the instrument will prevent any coupling offset setting that will make the Tx frequency go beyond the min/max values.
Page 455
dPMR Commands 13-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In dPMR Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To adjust range:...
Page 456
13-13 [:SENSe] Subsystem dPMR Commands [:SENSe]:SYMBolspan <value> [:SENSe]:SYMBolspan? Description: Sets the symbol span. Please note that this setting only affects the Eye Diagram in the dPMR Analyzer measurement. Please note that setting the symbol span will restart the sweep. Cmd Parameters: <value> Query Parameters: NA Range: 2 to 5 Default Value: 2...
Chapter 14 — DMR 2 Commands 14-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
14-2 :CONFigure Subsystem DMR 2 Commands 14-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 459
DMR 2 Commands 14-2 :CONFigure Subsystem :CONFigure:BITCap Description: This command configures the DMR 2 Bit Capture measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
Page 460
14-2 :CONFigure Subsystem DMR 2 Commands :CONFigure:SIGAnalyzer Description: This command configures the DMR 2 Analyzer measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
DMR 2 Commands 14-3 :DISPlay Subsystem 14-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 462
14-3 :DISPlay Subsystem DMR 2 Commands :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the DMR 2 Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 463
DMR 2 Commands 14-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: CONStellation|SPECtrum|HISTogram|SUMMary|DMR2summary|...
Page 464
14-3 :DISPlay Subsystem DMR 2 Commands :DISPlay[:WINDow]:TRACe<Tr>:SELect Description: Selects the given trace, <Tr>, as the active trace. <Tr> is the trace number in the range 1 to 4 for DMR 2 Analyzer. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. Cmd Parameters: NA Query Parameters: NA Range: NA...
DMR 2 Commands 14-4 :FETCh Subsystem 14-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 466
14-4 :FETCh Subsystem DMR 2 Commands :FETCh:SIGAnalyzer? Description: Returns the most recent DMR 2 Analyzer numerical measurement results. For firmware v1.13 and prior, data is returned as 14 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
Page 467
DMR 2 Commands 14-4 :FETCh Subsystem The received power will be returned in the unit that is selected through the Rx Units button on the front panel or with the command: UNIT:POWer:RX. If the receiver unit has been set to dBm, the received power is returned in dBm.
14-5 :FORMat Subsystem DMR 2 Commands 14-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description.
DMR 2 Commands 14-5 :FORMat Subsystem Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|PROFile|SPECtrum|EYEDiagram”...
Page 470
14-5 :FORMat Subsystem DMR 2 Commands Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
DMR 2 Commands 14-6 :INITiate Subsystem 14-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
14-7 :MEASure Subsystem DMR 2 Commands 14-7 :MEASure Subsystem These commands 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.
Page 473
DMR 2 Commands 14-7 :MEASure Subsystem :MEASure:SIGAnalyzer? Description: Sets the active measurement to DMR 2 Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? For firmware v1.13 and prior, data is returned as 14 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
Page 474
14-7 :MEASure Subsystem DMR 2 Commands Note: The squelch setting [:SENSe]:DM:SQUelch will blank out (--) all summary measurements on the instrument display except for Received Pwr when the received power level is lower than the squelch power setting. The received power level is also affected by the Rx Power Offset setting.
DMR 2 Commands 14-8 :MMEMory Subsystem 14-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
Page 476
14-8 :MMEMory Subsystem DMR 2 Commands :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 477
DMR 2 Commands 14-8 :MMEMory Subsystem “.lte” for LTE measurements “.p25” for P25 measurements “.p252” for P25p2 measurements “.nxdn” for NXDN measurements “.dpmr” for dPMR measurements “.dmr2” for DMR 2 measurements “.ptc” for PTC measurements “.tetra” for TETRA measurements “.nbfm” for NBFM measurements Cmd Parameters: <integer>,<filename>...
Page 478
14-8 :MMEMory Subsystem DMR 2 Commands :MMEMory:STORe:TRACe <integer>,<filename> Description: Stores the trace into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes (" ") and should not contain a file extension. Use the command MMEMory:MSIS to set the current save location.
DMR 2 Commands 14-9 :READ Subsystem 14-9 :READ Subsystem 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 480
14-9 :READ Subsystem DMR 2 Commands :READ:SIGAnalyzer? Description: Triggers a new DMR 2 Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? DMR 2 Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer).
Page 481
DMR 2 Commands 14-9 :READ Subsystem The received power will be returned in the unit that is selected through the Rx Units button on the front panel or with the command: UNIT:POWer:RX. If the receiver unit has been set to dBm, the received power is returned in dBm.
14-10 :SOURce Subsystem DMR 2 Commands 14-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the DMR 2 signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 483
DMR 2 Commands 14-10 :SOURce Subsystem :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 484
14-10 :SOURce Subsystem DMR 2 Commands :SOURce:FREQuency:CENTer <value> :SOURce:FREQuency:CENTer? Description: Sets the signal generator center frequency. Please note that setting the center frequency will restart the sweep. The query returns the current signal generator frequency in Hz. Cmd Parameters: <value> Query Parameters: NA Range: 500000 Hz to 1600000000 Hz Default Value: 800000000 Hz...
Page 485
DMR 2 Commands 14-10 :SOURce Subsystem :SOURce:STATe OFF|ON|0|1 :SOURce:STATe? Description: Turns the signal generator ON or OFF. Please note that the Generator ON/OFF button will toggle depending on the state. When the signal generator is on, the button will show Turn Sig-Gen OFF. When the signal generator is off, the button will show Turn Sig-Gen ON.
Page 486
14-11 :TRACe Subsystem DMR 2 Commands 14-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 487
DMR 2 Commands 14-11 :TRACe Subsystem Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 488
14-11 :TRACe Subsystem DMR 2 Commands Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer. Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style).
Page 489
DMR 2 Commands 14-11 :TRACe Subsystem Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 490
14-11 :TRACe Subsystem DMR 2 Commands Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 491
DMR 2 Commands 14-11 :TRACe Subsystem Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 492
14-11 :TRACe Subsystem DMR 2 Commands Table 14-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 493
DMR 2 Commands 14-11 :TRACe Subsystem :TRACe[:DATA]? ALL|CONStellation|HISTogram|PROFile|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen.
Page 494
14-11 :TRACe Subsystem DMR 2 Commands Please note that this command only works in the DMR 2 Analyzer measurement. Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA 14-38 PN: 10580-00319 Rev.
DMR 2 Commands 14-12 :UNIT Subsystem 14-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the DMR 2 Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
14-13 [:SENSe] Subsystem DMR 2 Commands 14-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 497
DMR 2 Commands 14-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 498
14-13 [:SENSe] Subsystem DMR 2 Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the DMR 2 Analyzer Summary window are averaged. Please note that CC is not averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA...
Page 499
DMR 2 Commands 14-13 [:SENSe] Subsystem [:SENSe]:DM:SQUelch <value> [:SENSe]:DM:SQUelch? Description: Sets the squelch power level. The squelch is only applied to the DMR 2 Analyzer Summary window on the front panel and will blank out (--) all summary measurements except for Received Pwr when the received power level is lower than the squelch power setting.
Page 500
14-13 [:SENSe] Subsystem DMR 2 Commands [:SENSe]:DM:FORMat BS|MS [:SENSe]:DM:FORMat? Description: Sets the modulation type. The query will return BS (for Base Station) and MS (for Mobile Station). Please note that setting the modulation type will restart the sweep. Cmd Parameters: BS|MS Query Parameters: NA Range: BS|MS Default Value: BS...
Page 501
DMR 2 Commands 14-13 [:SENSe] Subsystem [:SENSe]:FREQuency:CENTer <value> [:SENSe]:FREQuency:CENTer? Description: Sets the receiver center frequency. Please note that setting the center frequency will restart the sweep Cmd Parameters: <value> Query Parameters: NA Range: For 1.6 GHz Model: 100000 Hz to 1600000000 Hz For 6 GHz Model: 100000 Hz to 6000000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 502
14-13 [:SENSe] Subsystem DMR 2 Commands [:SENSe]:FREQuency:COUPling:OFFSet <value> [:SENSe]:FREQuency:COUPling:OFFSet? Description: Sets the frequency coupling offset. If frequency coupling is on, the Tx frequency will automatically trail the Rx frequency by this amount. Please note that the instrument will prevent any coupling offset setting that will make the Tx frequency go beyond the min/max values.
Page 503
DMR 2 Commands 14-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In DMR 2 Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA...
Page 504
14-13 [:SENSe] Subsystem DMR 2 Commands [:SENSe]:SYMBolspan <value> [:SENSe]:SYMBolspan? Description: Sets the symbol span. Please note that this setting only affects the Eye Diagram in the DMR 2 Analyzer measurement. Please note that setting the symbol span will restart the sweep. Cmd Parameters: <value>...
Chapter 15 — PTC Commands 15-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
15-2 :CONFigure Subsystem PTC Commands 15-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 507
PTC Commands 15-2 :CONFigure Subsystem :CONFigure:COVerage Description: This command configures the PTC Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
15-3 :DISPlay Subsystem PTC Commands 15-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 509
PTC Commands 15-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the PTC Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 510
15-3 :DISPlay Subsystem PTC Commands :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: CONStellation|SPECtrum|HISTogram|SUMMary|EYEDiagram|...
PTC Commands 15-4 :FETCh Subsystem 15-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 512
15-4 :FETCh Subsystem PTC Commands :FETCh:SIGAnalyzer? Description: Data is returned as 8 comma-separated values in the following order and format. When the modulation type is set to 4FSK ([:SENSe]:DM:FORMat 4FSK): Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) Mod Fid (% as float)
PTC Commands 15-5 :FORMat Subsystem 15-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
15-5 :FORMat Subsystem PTC Commands Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram”...
Page 515
PTC Commands 15-5 :FORMat Subsystem Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
15-6 :INITiate Subsystem PTC Commands 15-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
PTC Commands 15-7 :MEASure Subsystem 15-7 :MEASure Subsystem These commands 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.
Page 518
15-7 :MEASure Subsystem PTC Commands :MEASure:SIGAnalyzer? Description: Sets the active measurement to PTC Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 8 comma-separated values in the following order and format.
Page 519
PTC Commands 15-7 :MEASure Subsystem Note: The squelch setting [:SENSe]:DM:SQUelch will blank out (--) all summary measurements on the instrument display except for Received Pwr when the received power level is lower than the squelch power setting. The received power level is also affected by the Rx Power Offset setting.
15-8 :MMEMory Subsystem PTC Commands 15-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (‘...
Page 521
PTC Commands 15-8 :MMEMory Subsystem :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 522
15-8 :MMEMory Subsystem PTC Commands “.lte” for LTE measurements “.p25” for P25 measurements “.p252” for P25p2 measurements “.nxdn” for NXDN measurements “.dpmr” for dPMR measurements “.dmr2” for DMR 2 measurements “.ptc” for PTC measurements “.tetra” for TETRA measurements “.nbfm” for NBFM measurements Cmd Parameters: <integer>,<filename>...
Page 523
PTC Commands 15-8 :MMEMory Subsystem :MMEMory:STORe:TRACe <integer>,<filename> Description: Stores the trace into the file specified by <filename>. <filename> should be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and should not contain a file extension. Use the command MMEMory:MSIS to set the current save location.
15-9 :READ Subsystem PTC Commands 15-9 :READ Subsystem 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 525
PTC Commands 15-9 :READ Subsystem :READ:SIGAnalyzer? Description: Triggers a new PTC Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? PTC Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 8 comma-separated values in the following order and format.
Page 526
15-9 :READ Subsystem PTC Commands Note: This command is not affected by the squelch level set using the front panel. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To read PTC Analyzer numerical data: :READ:SIGAnalyzer? Related Command: :CONFigure:SIGAnalyzer Front Panel Access: NA...
PTC Commands 15-10 :SOURce Subsystem 15-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the PTC signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 528
15-10 :SOURce Subsystem PTC Commands :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 530
15-10 :SOURce Subsystem PTC Commands :SOURce:FREQuency:CENTer <value> :SOURce:FREQuency:CENTer? Description: Sets the signal generator center frequency. Please note that setting the center frequency will restart the sweep. The query returns the current signal generator frequency in Hz. Cmd Parameters: <value> Query Parameters: NA Range: 500000 Hz to 1600000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 531
PTC Commands 15-10 :SOURce Subsystem :SOURce:STATe OFF|ON|0|1 :SOURce:STATe? Description: Turns the signal generator ON or OFF. Please note that the Generator ON/OFF button will toggle depending on the state. When the signal generator is on, the button will show Turn Sig-Gen OFF. When the signal generator is off, the button will show Turn Sig-Gen ON.
Page 532
15-11 :TRACe Subsystem PTC Commands 15-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 533
PTC Commands 15-11 :TRACe Subsystem Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 534
15-11 :TRACe Subsystem PTC Commands Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer. Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style).
Page 535
PTC Commands 15-11 :TRACe Subsystem Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 536
15-11 :TRACe Subsystem PTC Commands Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 537
PTC Commands 15-11 :TRACe Subsystem Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 538
15-11 :TRACe Subsystem PTC Commands Table 15-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 539
PTC Commands 15-11 :TRACe Subsystem :TRACe[:DATA]? ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen. The ASCII header specifies the number of data bytes.
Page 540
15-11 :TRACe Subsystem PTC Commands Please note that this command only works in the PTC Analyzer measurement. Cmd Parameters: NA Query Parameters: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Range: ALL|CONStellation|HISTogram|SPECtrum|EYEDiagram Default Value: NA Default Unit: NA Example: To transfer spectrum data: :TRACe? SPECtrum Front Panel Access: NA 15-36 PN: 10580-00319 Rev.
PTC Commands 15-12 :UNIT Subsystem 15-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the PTC Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.If the unit is set to Watts, the...
15-13 [:SENSe] Subsystem PTC Commands 15-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 543
PTC Commands 15-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 544
15-13 [:SENSe] Subsystem PTC Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the PTC Analyzer Summary window are averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15: :AVERage:COUNt 15 Front Panel Access: Setup, Averaging...
Page 545
PTC Commands 15-13 [:SENSe] Subsystem [:SENSe]:DM:FORMat 4FSK|DQPSK [:SENSe]:DM:FORMat? Description: Sets the modulation type. The query will return 4FSK for 4FSK and DQPS for DSPSK. Please note that setting the modulation type will restart the sweep. Cmd Parameters: 4FSK|DQPSK Query Parameters: NA Range: 4FSK|DQPSK Default Value: 4FSK Default Unit: NA...
Page 546
15-13 [:SENSe] Subsystem PTC Commands The set command is sent using the units selected with the Rx Units button on the front panel or with the command: UNIT:POWer:RX. If the Rx Units has been set to dBm, the squelch setting must be set in dBm. If the unit is set to watts, the squelch setting must be set in fW.
Page 547
PTC Commands 15-13 [:SENSe] Subsystem [:SENSe]:FREQuency:CENTer <value> [:SENSe]:FREQuency:CENTer? Description: Sets the receiver center frequency. Please note that setting the center frequency will restart the sweep Cmd Parameters: <value> Query Parameters: NA Range: For 1.6 GHz Model: 100000 Hz to 1600000000 Hz For 6 GHz Model: 100000 Hz to 6000000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 548
15-13 [:SENSe] Subsystem PTC Commands [:SENSe]:FREQuency:COUPling:OFFSet <value> [:SENSe]:FREQuency:COUPling:OFFSet? Description: Sets the frequency coupling offset. If frequency coupling is on, the Tx frequency will automatically trail the Rx frequency by this amount. Please note that the instrument will prevent any coupling offset setting that will make the Tx frequency go beyond the min/max values.
Page 549
PTC Commands 15-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In PTC Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To adjust range:...
Page 550
15-13 [:SENSe] Subsystem PTC Commands [:SENSe]:SYMBolspan <value> [:SENSe]:SYMBolspan? Description: Sets the symbol span. Please note that this setting only affects the Eye Diagram in the PTC Analyzer measurement. Please note that setting the symbol span will restart the sweep. Cmd Parameters: <value> Query Parameters: NA Range: 2 to 5 Default Value: 2...
Chapter 16 — NBFM Commands 16-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
16-2 :CONFigure Subsystem NBFM Commands 16-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 553
NBFM Commands 16-2 :CONFigure Subsystem :CONFigure:COVerage Description: This command configures the NBFM Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
Page 554
16-2 :CONFigure Subsystem NBFM Commands :CONFigure:SIGAnalyzer Description: This command configures the NBFM Analyzer measurement. Certain settings from the previous measurement (Ref Lvl, Scale, Graph Types, Maximize) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
NBFM Commands 16-3 :DISPlay Subsystem 16-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:FORMat:COVerage <mapping type> :DISPlay[:WINDow]:TRACe:FORMat:COVerage? Description: Defines the mapping type. <mapping type> is the type of data that is being mapped.
Page 556
16-3 :DISPlay Subsystem NBFM Commands :DISPlay[:WINDow]:TRACe:Y[:SCALe]:IFPercent <Percentage> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:IFPercent? Description: Sets the IF bandwidth percent. This setting adjusts the Y-Axis scale for the Audio Spectrum and Audio Waveform graphs in the NBFM Analyzer measurement mode. Cmd Parameters: <Percentage> Query Parameters: NA Range: 1% to 100% Default Value: 50.00 Default Unit: NA...
Page 557
NBFM Commands 16-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the NBFM Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 558
16-3 :DISPlay Subsystem NBFM Commands :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: SPECtrum|ASPEctrum|AWAVeform|SUMMary...
NBFM Commands 16-4 :FETCh Subsystem 16-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement mode. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 560
16-4 :FETCh Subsystem NBFM Commands :FETCh:QUIeting? Description: Returns the most recent NBFM Quieting numerical measurement results. Data is returned as 2 comma-separated values in the following order and format: Measured Voltage (float), Reference Voltage (float). If there is no valid measurement data, the instrument will return “--,--”. Please note that this command only works when the current measurement is set to NBFM Quieting.
Page 561
NBFM Commands 16-4 :FETCh Subsystem :FETCh:SIGAnalyzer? Description: Returns the most recent NBFM Analyzer numerical measurement results. Data is returned as 10 comma-separated values in the following order and format: Carrier Power (dBm as float or Watts as long long int or Volts as long long int) Carrier Frequency (Hz as float) Deviation (Hz as float)
Page 562
16-4 :FETCh Subsystem NBFM Commands :FETCh:SNDRatio? Description: Returns the most recent NBFM SINAD numerical measurement results. Data is returned as 1 value in the following order and format: Measured SINAD (dB as float). If there is no valid measurement data, the instrument will return “--” Cmd Parameters: NA Query Parameters: NA Range: NA...
NBFM Commands 16-5 :FORMat Subsystem 16-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
16-5 :FORMat Subsystem NBFM Commands Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|SPECtrum|ASPEctrum|AWAVeform”...
Page 565
NBFM Commands 16-5 :FORMat Subsystem Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
16-6 :INITiate Subsystem NBFM Commands 16-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
NBFM Commands 16-7 :MEASure Subsystem 16-7 :MEASure Subsystem These commands 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.
Page 568
16-7 :MEASure Subsystem NBFM Commands :MEASure:QUIeting? Description: Sets the active measurement to NBFM Quieting, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:QUIeting and :READ:QUIeting? Data is returned as 2 comma-separated values in the following order and format: Measured Voltage (float), Reference Voltage (float).
Page 569
NBFM Commands 16-7 :MEASure Subsystem :MEASure:SIGAnalyzer? Description: Sets the active measurement to NBFM Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 10 comma-separated values in the following order and format: Carrier Power (dBm as float or Watts as long long int or Volts as long long int)
Page 570
16-7 :MEASure Subsystem NBFM Commands :MEASure:SNDRatio? Description: Sets the active measurement to NBFM SINAD, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SNDRatio and :READ:SNDRatio? Data is returned as 1 value in the following order and format: Measured SINAD (dB as float).
NBFM Commands 16-8 :MMEMory Subsystem 16-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (‘...
Page 572
16-8 :MMEMory Subsystem NBFM Commands :MMEMory:LOAD:TRACe <integer>,<filename> Description: The instrument must be in the mode of the saved trace in order to recall that trace. Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 573
NBFM Commands 16-8 :MMEMory Subsystem :MMEMory:STORe:STATe <integer>,<filename> Description: Stores the current setup into the file specified by <filename>. <filename> should be enclosed in either single quotes (‘ ’) or double quotes (“ ”) and should not contain a file extension. Use the command MMEMory:MSIS to set the current save location.
16-9 :READ Subsystem NBFM Commands 16-9 :READ Subsystem 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 575
NBFM Commands 16-9 :READ Subsystem :READ:QUIeting? Description: Triggers a new NBFM Quieting measurement and returns the numerical results. It is a combination of the commands :ABORT, :INITiate, and :FETCh:QUIeting? NBFM Quieting must be the active measurement (specified by :CONFigure:QUIeting). The current measurement can be queried using :CONFigure? Data is returned as 2 comma-separated values in the following order and format:...
Page 576
16-9 :READ Subsystem NBFM Commands :READ:SIGAnalyzer? Description: Triggers a new NBFM Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? NBFM Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 10 comma-separated values in the following order and format:...
Page 577
NBFM Commands 16-9 :READ Subsystem :READ:SNDRatio? Description: Triggers a new NBFM SINAD measurement and returns the numerical results. It is a combination of the commands :ABORT, :INITiate, and :FETCh:SNDRatio? NBFM SINAD must be the active measurement (specified by :CONFigure:SNDRatio). The current measurement can be queried using :CONFigure? Data is returned as 1 value in the following order and format: Measured SINAD (dB as float).
16-10 :SOURce Subsystem NBFM Commands 16-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the NBFM signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 579
NBFM Commands 16-10 :SOURce Subsystem :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 580
16-10 :SOURce Subsystem NBFM Commands :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value> :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Description: Sets the output power level for the NBFM signal generator. Please note that changing the Tx power offset will also cause the display of this to adjust to the new offset. For example, if the output level is set to 0 dBm and the Tx level offset is then set to 10 dB external gain, the max limit and value of the Tx output level will be adjusted to 10 dBm.
NBFM Commands 16-11 :TRACe Subsystem 16-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 582
16-11 :TRACe Subsystem NBFM Commands Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current longitude shown in degrees, minutes, GPS_FIX_LONGITUDE seconds. Even if a file has been recalled, the current longitude will be returned. Current latitude shown in degrees, minutes, seconds.
Page 583
NBFM Commands 16-11 :TRACe Subsystem Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup trace graph type for Coverage (Not in use with TRACE_GRAPH_TYPES_TOC new mapping style). ACTIVE_GRAPH Selected graph. ACTIVE_GRAPH_TX Backup active graph for Analyzer. Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style).
Page 584
16-11 :TRACe Subsystem NBFM Commands Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Number of symbols shown in the horizontal axis of the SYMBOL Analyzer Eye Diagram. RECEIVER_UNITS Receiver unit type. 0 is dBm, 1 is Watts, 2 is Volts. GENERATOR_UNITS Generator unit type.
Page 585
NBFM Commands 16-11 :TRACe Subsystem Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the RSSI mapping value is RSSI_MAPPING_GOOD deemed good (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC). Threshold at which the RSSI mapping value is RSSI_MAPPING_FAIR deemed fair (Only used in P25, P25p2, NXDN, dPMR,...
Page 586
16-11 :TRACe Subsystem NBFM Commands Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR, and DEMOD_TYPE PTC).
Page 587
NBFM Commands 16-11 :TRACe Subsystem Table 16-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_EXCELLENT excellent (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM).
Page 588
16-11 :TRACe Subsystem NBFM Commands :TRACe[:DATA]? ALL|SPECtrum|ASPEctrum|AWAVeform Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen. The ASCII header specifies the number of data bytes.
NBFM Commands 16-12 :UNIT Subsystem 16-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the NBFM Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.If the unit is set to Watts, the...
16-13 [:SENSe] Subsystem NBFM Commands 16-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 591
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 592
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the deviation value in the NBFM Analyzer Summary window is averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15: :AVERage:COUNt 15 Front Panel Access: Setup, Averaging...
Page 593
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:CORRection:OFFSet[:MAGNitude] <value> [:SENSe]:CORRection:OFFSet[:MAGNitude]? Description: Sets the receiver power offset. Please note that when Auto Rx Range is set to On, changing the offset value will cause the Ref Level to change. For example, if the reference level is at 7.0 dBm and the Rx power offset is then set to 10 dB external gain, the value of the refererence level will be automatically adjusted down to -3.0 dBm.
Page 594
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:DM:SQUelch <value> [:SENSe]:DM:SQUelch? Description: Sets the squelch power level. The squelch is applied to the NBFM Analyzer Summary Window, the NBFM Analyzer Audio Spectrum, and the NBFM Audio Waveform on the front panel. If the Carrier power is lower than the squelch level, the Audio Spectrum trace will drop to the bottom of the graph, the Audio Waveform trace will stay in the middle of the graph, and the all of the summary numerical values except for...
Page 595
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:DEV:MODE PEAK|RMS|AVERage [:SENSe]:DEV:MODE? Description: Sets the deviation mode that is displayed in the NBFM Analyzer summary table, 3rd row down. The query will return PEAK for peak, RMS for RMS, and AVER for average. Cmd Parameters: PEAK|RMS|AVERage Query Parameters: NA Range: PEAK|RMS|AVER Default Value: PEAK...
Page 596
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:FILTer:FREQuency 0.3|3|15|NONE [:SENSe]:FILTer:FREQuency? Description: Sets the low pass filter frequency. Note: Low pass filter frequency value is set and returned in kHz (except for NONE). Cmd Parameters: 0.3|3|15|NONE Query Parameters: NA Range: 0.3|3|15|NONE Default Value: 3 Default Unit: kHz Example: To set the low pass filter frequency to 15 kHz: :FILTer:FREQuency 15...
Page 597
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:FM:SENSitivity:REFerence:SET Description: Sets the reference voltage for NBFM Quieting. Setting the reference will automatically adjust the voltage scale such that the voltage displayed in middle of the meter is 10 % (-20 dB) of the reference voltage.
Page 598
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:FREQuency:CENTer:AUTO OFF|ON|0|1 [:SENSe]:FREQuency:CENTer:AUTO? Description: Sets auto scan on or off. When auto scan is turned on, the receiver frequency will automatically be set to the frequency with the highest power reading. Use [:SENSe]:FREQuency:CENTer? to retrieve the current receiver frequency.
Page 599
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:FREQuency:COUPling:OFFSet <value> [:SENSe]:FREQuency:COUPling:OFFSet? Description: Sets the frequency coupling offset. If frequency coupling is on, the Tx frequency will automatically trail the Rx frequency by this amount. Please note that the instrument will prevent any coupling offset setting that will make the Tx frequency go beyond the min/max values.
Page 600
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:FREQuency:SPAN:AUDio 0.3|2|5|10|20|30 [:SENSe]:FREQuency:SPAN:AUDio? Description: Sets the audio span. The setting only applies to the NBFM Analyzer Audio Spectrum graph. Note: Audio span frequency value is set and returned in kHz. Cmd Parameters: 0.3|2|5|10|20|30 Query Parameters: NA Range: 0.3|2|5|10|20|30 Default Value: 30 Default Unit: kHz...
Page 601
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe]:OBWidth:PERCent <percentage> [:SENSe]:OBWidth:PERCent? Description: This command sets the percentage of carrier power that is used to measure the occupied bandwidth. This value is used in the measurement if :SENSe:OBWidth:METHod is set to PERCent. Cmd Parameters: <percentage> Query Parameters: NA Range: 0% to 100% Default Value: 99%...
Page 602
16-13 [:SENSe] Subsystem NBFM Commands [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In NBFM Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To adjust range:...
Page 603
NBFM Commands 16-13 [:SENSe] Subsystem [:SENSe:]SWEep:TIME:AUDio <time> [:SENSe:]SWEep:TIME:AUDio? Description: Sets the audio sweep time. The setting only applies to the NBFM Analyzer Audio Waveform graph. Cmd Parameters: <time> Query Parameters: NA Range: 50 us to 150 ms Default Value: 100 ms Default Unit: us Example: To set the audio sweep time to 75 ms: :SWEep:TIME:AUDio 75000...
Chapter 17 — TETRA Commands 17-1 :ABORt Subsystem The abort subsystem includes commands that allow the user to stop current measurement activities on the instrument. :ABORt Description: Restarts the current sweep and/or measurement. If :INITiate:CONTinuous is OFF (i.e., the instrument is in hold mode), send the command :INITiate[:IMMediate] to trigger the next sweep.
17-2 :CONFigure Subsystem TETRA Commands 17-2 :CONFigure Subsystem This set of commands prepares the instrument for the selected measurement. It disables any currently-enabled measurements and activates the specified measurement. Current instrument settings may be changed to default values. These changes are identified with their respective measurement commands.
Page 607
TETRA Commands 17-2 :CONFigure Subsystem :CONFigure:COVerage Description: This command configures the TETRA Coverage measurement. Certain settings from the previous measurement (Mapping Type) will be backed up when exiting this measurement and restored when entering this measurement. All other settings carry over from one measurement to the other.
17-3 :DISPlay Subsystem TETRA Commands 17-3 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay[:WINDow]:TRACe:SELect? Description: This command returns the current active trace number in the format TRAC#.
Page 609
TETRA Commands 17-3 :DISPlay Subsystem :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel <value> :DISPlay[:WINDow]:TRACe:Y[:SCALe]:RLEVel? Description: Sets the reference level scale value for the y-axis. In the TETRA Analyzer measurement, this value corresponds to the reference level on the spectrum graph type. Turning auto range on will automatically adjust the reference level. If auto range is on and this command is sent, the reference level will be set to the value until the Note next sweep.
Page 610
17-3 :DISPlay Subsystem TETRA Commands :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer <graph type> :DISPlay[:WINDow]:TRACe<Tr>:FORMat:SIGAnalyzer? Description: Defines the graph type for the given trace <Tr>. <Tr> is the trace number in the range 1 to 4. If no trace number is specified, then the <Tr> parameter defaults to trace number 1. <Graph Type> is the graph type to which the specified trace is set, and it must be one of the following values: CONStellation|SPECtrum|SUMMary|EYEDiagram|TETRasummary...
TETRA Commands 17-4 :FETCh Subsystem 17-4 :FETCh Subsystem This set of commands returns the most recent measurement data of the active measurement. They will not switch to another measurement. To prepare for a new measurement, use the CONFigure command. To make a new measurement, use the INITiate command.
Page 612
17-4 :FETCh Subsystem TETRA Commands :FETCh:SIGAnalyzer? Description: Returns the most recent TETRA Analyzer numerical measurement results. Data is returned as 14 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int) Frequency Error (Hz as float) EVM (% as float)
TETRA Commands 17-5 :FORMat Subsystem 17-5 :FORMat Subsystem This subsystem contains commands that determine the formatting of numeric data when it is transferred. The format setting affects data in specific commands only. If a command is affected, it is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,32 :FORMat[:READings][:DATA]? Description: This command specifies the format in which data is returned in certain...
17-5 :FORMat Subsystem TETRA Commands Interpreting Returned Data The following section provides two conversion examples on interpreting returned data. Examples are provided for both integer and real number formats. Converting INTeger,32 and REAL,32 Values The number of bytes the instrument returns is dependent on the parameter specified with the “:TRACe[:DATA]? ALL|CONStellation|SPECtrum|EYEDiagram”...
Page 615
TETRA Commands 17-5 :FORMat Subsystem Converting REAL,32 Example: The instrument returns the following values in REAL,32 format: 25 06 14 c3 1. Convert from little endian to big endian: c3 14 06 25 2. The binary representation of the real portion, C3 14 06 25 is: 11000011000101000000011000100101 3.
17-6 :INITiate Subsystem TETRA Commands 17-6 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Description: Initiates a sweep/measurement. Use this command in combination with :STATus:OPERation? to synchronize the capture of one complete set of data. When this command is sent, the “sweep complete” bit of :STATus:OPERation? is set to 0, indicating that the measurement is not completed.
TETRA Commands 17-7 :MEASure Subsystem 17-7 :MEASure Subsystem These commands 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.
Page 618
17-7 :MEASure Subsystem TETRA Commands :MEASure:SIGAnalyzer? Description: Sets the active measurement to TETRA Analyzer, triggers a new measurement and returns the numerical results. It is a combination of the commands :CONFigure:SIGAnalyzer and :READ:SIGAnalyzer? Data is returned as 14 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as long long int)
TETRA Commands 17-8 :MMEMory Subsystem 17-8 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:LOAD:STATe <integer>,<filename> Description: Recalls a previously stored instrument setup in the current save location. The setup file to be loaded is specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes ("...
Page 620
17-8 :MMEMory Subsystem TETRA Commands File name extensions: “.spa” for SPA measurement “.mna” for VNA and VVM measurements “.hipm” for HiPM measurements “.pm” for PM measurements “.cwsg” for CWSG measurements “.afp” for AM/FM/PM measurements “.ia” for Interference Analysis measurements “.cs” for Channel Scanner measurements “.wmxd”...
Page 621
TETRA Commands 17-8 :MMEMory Subsystem :MMEMory:STORe:STATe <integer>,<filename> Description: Stores the current setup into the file specified by <filename>. <filename> should be enclosed in either single quotes (' ') or double quotes (" ") and should not contain a file extension. Use the command MMEMory:MSIS to set the current save location.
17-9 :READ Subsystem TETRA Commands 17-9 :READ Subsystem 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 623
TETRA Commands 17-9 :READ Subsystem :READ:SIGAnalyzer? Description: Triggers a new TETRA Analyzer measurement and returns the numerical results. It is a combination of the commands :ABORT; :INITiate; :FETCh:SIGAnalyzer? TETRA Analyzer must be the active measurement (specified by :CONFigure:SIGAnalyzer). The current measurement can be queried using :CONFigure? Data is returned as 14 comma-separated values in the following order and format: Received Power (dBm as float or Watts as long long int or Volts as...
17-10 :SOURce Subsystem TETRA Commands 17-10 :SOURce Subsystem The commands in this subsystem control the internal signal source. :SOURce:CORRection:OFFSet[:MAGNitude] <value> :SOURce:CORRection:OFFSet[:MAGNitude]? Description: Sets the power level offset for the TETRA signal generator. Please note that changing this value will also cause the display of the Tx output level to adjust to the new offset.
Page 625
TETRA Commands 17-10 :SOURce Subsystem :SOURce:DM:PATTern:LIST? Description: Retrieves a list of signal generator pattern names and the index number that is used to set the pattern. The pattern names match the names of the pattern list that pops up when the Tx Pattern button is pushed and the index number is the position of the pattern on that list.
Page 626
17-10 :SOURce Subsystem TETRA Commands :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude] <value> :SOURce:POWer[:LEVel][:IMMediate][:AMPLitude]? Description: Sets the output power level for the TETRA signal generator. Please note that changing the Tx power offset will also cause the display of this to adjust to the new offset. For example, if the output level is set to 0 dBm and the Tx level offset is then set to 10 dB external gain, the max limit and value of the Tx output level will be adjusted to 10 dBm.
TETRA Commands 17-11 :TRACe Subsystem 17-11 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe:PREamble? Description: Returns trace header information. Use the commands in the MMEMory subsystem to store and recall traces from the instrument memory.
Page 628
17-11 :TRACe Subsystem TETRA Commands Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 2 of 7) Parameter Name Description Current latitude shown in degrees, minutes, seconds. GPS_FIX_LATITUDE Even if a file has been recalled, the current latitude will be returned. Current UTC time shown as seconds elapsed since GPS_FIX_VALUE_TIME 0:00 January 1st, 1970.
Page 629
TETRA Commands 17-11 :TRACe Subsystem Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 3 of 7) Parameter Name Description Backup active graph for Coverage (Not in use with ACTIVE_GRAPH_TOC new mapping style). Determines whether active graph is maximized or MAXIMIZE_GRAPH minimized.
Page 630
17-11 :TRACe Subsystem TETRA Commands Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 4 of 7) Parameter Name Description Pattern that the signal generator is outputting. The value corresponds to the index (starting from 0) of the GENERATOR_PATTERN list returned from issuing a :SOURce:DM:PATTern:LIST? command.
Page 631
TETRA Commands 17-11 :TRACe Subsystem Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 5 of 7) Parameter Name Description Threshold at which the BER mapping value is deemed BER_MAPPING_EXCELLENT excellent (Only used in P25, P25p2, NXDN, dPMR, DMR2, PTC, TETRA). Threshold at which the BER mapping value is deemed BER_MAPPING_VERY_GOOD very good (Only used in P25, P25p2, NXDN, dPMR,...
Page 632
17-11 :TRACe Subsystem TETRA Commands Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 6 of 7) Parameter Name Description Determines what values are displayed in the Analyzer NUMERIC_DISPLAY summary window. Modulation type (used with P25, P25p2, DMR 2, and DEMOD_TYPE PTC).
Page 633
TETRA Commands 17-11 :TRACe Subsystem Table 17-1. Returned Parameter Values in Trace Preamble (Sheet 7 of 7) Parameter Name Description Threshold at which the THD mapping value is deemed THD_MAPPING_VERY_GOOD very good (Only used in NBFM). Threshold at which the THD mapping value is deemed THD_MAPPING_GOOD good (Only used in NBFM).
Page 634
17-11 :TRACe Subsystem TETRA Commands :TRACe[:DATA]? ALL|CONStellation|SPECtrum|EYEDiagram Description: Transfers trace data from the instrument to the controller. Before executing this command the instrument must be set to the desired measurements. The command will only retrieve the data for graph types currently displaying on the screen. The ASCII header specifies the number of data bytes.
TETRA Commands 17-12 :UNIT Subsystem 17-12 :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. :UNIT:POWer:RX DBM|WATT|VOLTs :UNIT:POWer:RX? Description: Sets the receiver unit to dBm or Watts or Volts. If the unit is set to dBm, the TETRA Analyzer received power (from FETCh:SIGAnalyzer? or READ:SIGAnalyzer? or MEASURE:SIGAnalyzer?) and the squelch setting will be set and queried in dBm.
17-13 [:SENSe] Subsystem TETRA Commands 17-13 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:APPLication:TST? Description: Triggers an application self-test. This command returns a 1 if all the tests passed and a 0 if one or more of the tests failed. Use [:SENSe]:APPLication:TST:RESult? to retrieve the detailed results of the test.
Page 637
TETRA Commands 17-13 [:SENSe] Subsystem [:SENSe]:APPLication:TST:RESult? Description: Retrieves the detailed results from the application self-test. [:SENSe]:APPLication:TST? must be called before this command to get correct results. The response begins with an ASCII header. The header specifies the number of following bytes. It appears in the format #AX, where A is the number of digits in X, and X is the number of bytes that follow the header.
Page 638
17-13 [:SENSe] Subsystem TETRA Commands [:SENSe]:AVERage:COUNt <integer> [:SENSe]:AVERage:COUNt? Description: Sets the number of times the numerical values in the TETRA Analyzer Summary window are averaged. Cmd Parameters: <integer> Query Parameters: NA Range: 1 to 25 Default Value: 1 Default Unit: NA Example: To set averaging to 15: :AVERage:COUNt 15 Front Panel Access: Setup, More, Averaging...
Page 639
TETRA Commands 17-13 [:SENSe] Subsystem [:SENSe]:DM:FORMat BS|MS [:SENSe]:DM:FORMat? Description: Sets the modulation type to Base Station (BS) or Mobile Station (MS). Please note that setting the modulation type will restart the sweep. Cmd Parameters: BS|MS Query Parameters: NA Range: BS|MS Default Value: BS Default Unit: NA Example: To set the modulation type to MS:...
Page 640
17-13 [:SENSe] Subsystem TETRA Commands [:SENSe]:FREQuency:CENTer <value> [:SENSe]:FREQuency:CENTer? Description: Sets the receiver center frequency. Please note that setting the center frequency will restart the sweep Cmd Parameters: <value> Query Parameters: NA Range: For 1.6 GHz Model: 100000 Hz to 1600000000 Hz For 6 GHz Model: 100000 Hz to 6000000000 Hz Default Value: 800000000 Hz Default Unit: Hz...
Page 641
TETRA Commands 17-13 [:SENSe] Subsystem [:SENSe]:POWer[:RF]:RANGe[:IMMediate] Description: Turns off auto ranging and adjusts the receiver reference level once. In TETRA Analyzer measurement, this command adjusts the receiver reference level of the spectrum graph. Cmd Parameters: NA Query Parameters: NA Range: NA Default Value: NA Default Unit: NA Example: To adjust range:...
Page 642
17-13 [:SENSe] Subsystem TETRA Commands [:SENSe]:SYMBolspan <value> [:SENSe]:SYMBolspan? Description: Sets the symbol span. Please note that this setting only affects the Eye Diagram in the TETRA Analyzer measurement. Please note that setting the symbol span will restart the sweep. Cmd Parameters: <value> Query Parameters: NA Range: 2 to 5 Default Value: 2...
Chapter 18 — AM/FM/PM Commands 18-1 :CALCulate Subsystem The commands in this subsystem process data that has been collected via the SENSe subsystem. :CALCulate:MARKer{1|2|3|4|5|6}[:STATe] OFF|ON|0|1 :CALCulate:MARKer{1|2|3|4|5|6}[:STATe]? Title: Marker State Description: Sets the specified marker on/off. Parameter: OFF|ON|0|1 Parameter Type: <boolean> Default Value: OFF Example: To turn off reference marker #1: :CALCulate:MARKer1:STATe OFF...
Page 644
18-1 :CALCulate Subsystem AM/FM/PM Commands :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X <x-parameter> :CALCulate:MARKer{1|2|3|4|5|6}:DELTa:X? Title: Delta Marker X Value Description: Sets the location of the delta marker on the x-axis at the specified location <x-parameter> plus the reference marker x-axis. <x-parameter> is defined in the current x-axis units. The query version of the command returns the location of the delta marker on the x-axis.
Page 645
AM/FM/PM Commands 18-1 :CALCulate Subsystem :CALCulate:MARKer{1|2|3|4|5|6}:MAXimum Title: Marker (Maximum) Peak Search Description: Puts the specified marker at the maximum amplitude in the trace. Front Panel Access: Marker, Marker [1/2/3/4/5/6], Peak Search Marker, Marker [1/2/3/4/5/6], More Peak Options, Peak Search :CALCulate:MARKer{1|2|3|4|5|6}[:SET]:RLEVel Title: Marker to Reference Level Description: Sets the reference level equal to the measured amplitude of the specified marker.
Page 646
18-1 :CALCulate Subsystem AM/FM/PM Commands :CALCulate:MARKer:AOFF Title: Turn All Markers Off Description: Turns off all markers. Front Panel Access: Marker, More, All Markers Off :CALCulate:MARKer:TABLe[:STATe] OFF|ON|0|1 :CALCulate:MARKer:TABLe[:STATe]? Title: Marker Table State Description: Turns the Marker Table on or off. Setting the value to ON or 1 will turn on the marker table.
AM/FM/PM Commands 18-2 :DISPlay Subsystem 18-2 :DISPlay Subsystem This subsystem provides commands that modify the display of data for the user. They do not modify the way in which data are returned to the controller. :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision <rel ampl> :DISPlay:WINDow:TRACe:Y[:SCALe]:PDIVision? Title: Scale Description: Sets the scale (dB/division) for the y-axis in RF Spectrum view.
18-3 :FORMat Subsystem AM/FM/PM Commands 18-3 :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 is noted in the command description. :FORMat[:READings][:DATA] ASCii|INTeger,32|REAL,[<length>] :FORMat[:READings][:DATA]? Title: Numeric Data Format...
Page 649
AM/FM/PM Commands 18-3 :FORMat Subsystem Both INTeger and REAL formats return a definite block length. Each transfer begins with an ASCII header such as #42204 for INTeger,32 and REAL,32 and #44408 for REAL,64. The first digit represents the number of following digits in the header (in this example, 4). The remainder of the header indicates the number of bytes that follow the header (in this example, 2204 for INT,32 and REAL,32 and 4408 for REAL,64).
18-4 :INITiate Subsystem AM/FM/PM Commands 18-4 :INITiate Subsystem This subsystem controls the triggering of measurements. :INITiate[:IMMediate] Title: Trigger Sweep/Measurement Description: Initiates a sweep/measurement. If :INITiate: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.
AM/FM/PM Commands 18-5 :MMEMory Subsystem 18-5 :MMEMory Subsystem The Mass Memory subsystem contains functions that provide access to the instrument’s setup and data storage. :MMEMory:DELete <file name> Title: Delete Setup/Measurement Description: Removes the measurement or setup file specified by <file name> from the current mass storage device.
Page 652
18-5 :MMEMory Subsystem AM/FM/PM Commands :MMEMory:LOAD:TRACe <integer>,<file name> Title: Recall Measurement Description: The instrument must be in the mode of the saved trace in order to recall that trace.Use :INSTrument:SELect or :INSTrument:NSELect to set the mode. Recalls a previously stored measurement trace from the current save location.
Page 653
AM/FM/PM Commands 18-5 :MMEMory Subsystem :MMEMory:STORe:STATe <integer>,<file name> Title: Save Setup Description: 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. Use the command MMEMory:MSIS to set the current save location.
18-6 :TRACe Subsystem AM/FM/PM Commands 18-6 :TRACe Subsystem This subsystem contains commands related to the transfer of trace data to and from the instrument. :TRACe[:DATA]? Title: Trace Data Transfer Description: This command transfers data from the controlling program to the instrument.
AM/FM/PM Commands 18-7 [:SENSe] Subsystem 18-7 [:SENSe] Subsystem The commands in this subsystem relate to device-specific parameters, not signal-oriented parameters. [:SENSe]:AFPanalyzer:AVERage:COUNt <avg count> [:SENSe]:AFPanalyzer:AVERage:COUNt? Title: Measurement Average Description: Sets the average count for the measurement data in the summary mode. The query format of this command returns the value only in the summary mode.
Page 656
18-7 [:SENSe] Subsystem AM/FM/PM Commands [:SENSe]:AFPanalyzer:DEMod:TYPE AM|FM|PM [:SENSe]:AFPanalyzer:DEMod:TYPE? Title: Demodulation Type Description: This command sets the demodulation type. Parameter: AM|FM|PM Default Value: AM Example: To set the demodulation type to FM: SENSe:AFPanalyzer:DEMod:TYPE FM Front Panel Access: Setup, Demod Type [:SENSe]:AFPanalyzer:FM:SCALe <percentage> [:SENSe]:AFPanalyzer:FM:SCALe? Title: FM Y-axis reference level percentage Description: This command sets the Y-axis reference level as the percentage of the IF...
Page 657
AM/FM/PM Commands 18-7 [:SENSe] Subsystem [:SENSe]:AFPanalyzer:IFBW:AUTO 0|1 [:SENSe]:AFPanalyzer:IFBW:AUTO? Title: IF bandwidth coupling Description: Sets the state of the coupling of the IF bandwidth to the span. Setting the value to 1 will result in the IF bandwidth being coupled to the span. That is, when the span changes, the IF bandwidth changes.
Page 658
18-7 [:SENSe] Subsystem AM/FM/PM Commands [:SENSe]:AFPanalyzer:SWEep:TIME <time> [:SENSe]:AFPanalyzer:SWEep:TIME? Title: Audio Waveform sweep time Description: Sets the audio waveform sweep time in the audio waveform view. Parameter: <time> Default Unit: Secs Range: 50 µs to 50 ms. Front Panel Access: Shift-4 (Measure), Audio Waveform, Sweep Time [:SENSe]:AFPanalyzer:SUMMary:DATA? Title: Summary data Description: This query returns the measurment values in the Summary view.
Page 659
Signal Standard submenu button in the Freq menu. The list can also be downloaded remotely and viewed using Anritsu Master Software Tools. For example, if the desired Signal Standard is: P-GSM 900 - Uplink then the value of the <string> would be “P-GSM 900 - Uplink”.
Page 660
18-7 [:SENSe] Subsystem AM/FM/PM Commands [:SENSe]:FREQuency:SPAN:PREVious Title: Frequency Span – Last Description: Sets the frequency span to the previous span value. Note that changing the value of the frequency span may change the Center Frequency. Default Unit: Hz Front Panel Access: Freq, Span, Last Span [:SENSe]:FREQuency:STEP[:INCRement] <freq>...
Page 661
AM/FM/PM Commands 18-7 [:SENSe] Subsystem [:SENSe]:OBWidth:PERCent <percentage> [:SENSe]:OBWidth:PERCent? Title: Occupied Bandwidth Percent of Power Description: 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. Parameter: <percentage>...
Appendix A — Example 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 664
A-1 C/C++ Example if (status < VI_SUCCESS) /* Error Initializing VISA...exiting*/ printf(”Can't initialize VISA\n”); return –1; /* 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);...
Example A-2 Visual Basic 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 666
A-2 Visual Basic Example PN: 10580-00319 Rev. N S412E PM...
Appendix B — Commands by Mode This appendix lists all of the SCPI commands by measurement mode then alphabetic order. Note that these commands are hypertext links to the command lines within the individual chapters. Chapter 1—General Information Chapter 2—Programming with SCPI Chapter 3—All Mode Commands :FETCh:GPS? ..........................3-1 :INSTrument:CATalog:FULL? ....................3-2...
Page 702
Commands by Mode B-36 PN: 10580-00319 Rev. N S412E PM...
Page 704
Anritsu Company 490 Jarvis Drive Anritsu utilizes recycled paper and environmentally conscious inks and toner. Morgan Hill, CA 95037-2809 http://www.anritsu.com...