SETup:SMONitor

SETup:SMONitor

Last updated: May 10, 2010

GPIB Command Conventions

SETup:SMONitor:AMPLitude:PDIVision

Function

This command sets the scale of the spectrum monitor's display in dB per division (dB/div).

Setting

Range: 0.1 to 20 dB

Resolution: 0.1

Query

Range: 0.1 to 20 dBResolution: 0.1

*RST Setting

10 dB

Programming Example

 
OUTPUT 714;"SETup:SMONitor:AMPLitude:PDIVision 1DB" 
 
!Sets scale of the spectrum monitor's display to 1 dB per division.

SETup:SMONitor:AMPLitude:RLEVel:AUTO

Function

This command allows you to set whether or not the spectrum monitor's reference level is selected automatically by the test set.

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting

OFF

Programming Example

 
OUTPUT 714;"SETup:SMONitor:AMPLitude:RLEVel:AUTO ON" 
 
!Sets spectrum monitor's reference level to set automatically.

SETup:SMONitor:AMPLitude:RLEVel:MANual

Function

This command allows you to set the spectrum monitors actual reference level in dBm. The range settings are coupled to the amplitude offset value for the current value of the expected frequency (set using SYSTem:CORRection:[:SGAin] ). Changing the amplitude offset value does not change the reference value, unless the new value for the amplitude offset forces the current value of the reference level to exceed the range limits. If this happens the reference level is set to its limit.

Setting

Range: (-50 dBm + Amplitude Offset) to +37 dBm

Resolution: 0.1 dB

Query

Range: (-50 dBm + Amplitude Offset) to +37 dBmResolution: 0.1 dB

*RST Setting

+37 dB + Amplitude Offset

Programming Example

 
OUTPUT 714;"SETup:SMONitor:AMPLitude:RLEVel:MANual -20DBM" 
 
!Sets spectrum monitor's reference level to -20 dBm.

SETup:SMONitor:BANDwidth|BWIDth[:RESolution]?

Function

This command queries the resolution bandwidth being used by the spectrum monitor measurement. It is returned in the unit of Hz.

Query

Range: 1 kHz to 5MHz

*RST Setting 30000 Hz

Programming Example

 
OUTPUT 714;"SETup:SMONitor:BAND?" 
 
!Returns spectrum monitor's resolution bandwidth.

SETup:SMONitor:BANDwidth|BWIDth:AUTO

Function

This command sets/queries the Spectrum Monitor Resolution Bandwidth Coupling State. When the state of this parameter is ON the Resolution Bandwidth is determined by the Frequency Span setting ( SETup:SMONitor:FREQuency:SPAN ). When this parameter is set to OFF the Frequency Span and the Resolution Bandwidth parameters are decoupled and can be set separately to any valid Frequency Span and Resolution Bandwidth. See Resolution Bandwidth and Frequency Span for the complete list of valid settings for Frequency Span and Resolution Bandwidth.

The command to set the Frequency Span is SETup:SMONitor:FREQuency:SPAN

The command to set the resolution bandwidth is SETup:SMONitor:BANDwidth|BWIDth:MANual .

Requirements

Test Application Revision:B.09 and above

Lab Application Revision: A.01 and above

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting 1

Programming Example

 
OUTPUT 714;"SETup:SMONitor:BAND:AUTO 0" 
 
!Turns Spectrum Monitor Resolution Bandwidth Coupling parameter OFF.

SETup:SMONitor:BANDwidth|BWIDth:MANual

Function

This command sets/queries the value of the resolution bandwidth when SETup:SMONitor:BANDwidth|BWIDth:AUTO is set to OFF. When SETup:SMONitor:BANDwidth|BWIDth:AUTO is set to ON, the resolution bandwidth is determined by the Frequency Span setting ( SETup:SMONitor:FREQuency:SPAN ) and can be queried using the SETup:SMONitor:BANDwidth|BWIDth[:RESolution]? command.

When using this command the values in the Frequency Span and Resolution Bandwidth columns of Resolution Bandwidth and Frequency Span are no longer coupled. Therefore, the Frequency Span and the Resolution Bandwidth parameters can be set to any value in the Frequency Span and Resolution Bandwidth columns, respectively.

This command also sets the Spectrum Monitor Reference Level Coupling State to OFF (see SETup:SMONitor:AMPLitude:RLEVel:AUTO ).

The units (HZ|KHZ|MHZ) are optional, if no units are specified then the default is HZ.

Requirements

Test Application Revision: B.09 and above
Lab Application Revision: A.01 and above

Setting

Range: A value in the range 300 Hz to 5 MHz can be entered, however the value is rounded to a valid entry. The decision point for rounding up or down is the halfway point between the first valid entry below the setting and the first valid entry above the setting. The valid entries include: 300 Hz, 1 kHz, 3 kHz, 10 kHz, 30 kHz, 100 kHz, 300 kHz, 1 MHz, 5 MHz.

Query

300 Hz, 1 kHz, 3 kHz, 10 kHz, 30 kHz, 100 kHz, 300 kHz, 1 MHz, 5 MHz.

*RST Setting 30 kHz

Programming Example

 
OUTPUT 714;"SETup:SMONitor:BANDwidth:MANual 600 khz" 
 
!Sets the Resolution Bandwidth to 300 kHz because the first valid entry below the setting is 300 kHz !and the first valid entry above the setting is 1 MHz. The middle point between the two valid values is !650 kHz and since 600 kHz is below 650 kHz, the test set rounds 600 kHz to 300 kHz. 

SETup:SMONitor:BANDwidth|BWIDth:ZSPan[:RESolution]

Function

This command sets/queries the resolution bandwidth when the spectrum monitor is operating in zero span mode. To change the spectrum monitor to zero span mode, use the command SETup:SMONitor:FREQuency:SPAN , to set the frequency span to 0 Hz.

To measure the total power of a signal you must select a resolution bandwidth greater than or equal to the signal bandwidth. To resolve two spectral components the resolution bandwidth must be less than the difference between them.

The units (HZ|KHZ|MHZ) are optional, if no units are specified then the default is HZ.

Any setting you enter is rounded to the nearest of the three settings.

Setting

Range: 100 kHz|300 kHz|1 MHz

Query

Range: 100 kHz|300 kHz|1 MHz

*RST Setting 300 kHz

Programming Example

 
OUTPUT 714;"SETup:SMONitor:BAND:ZSPan 100 KHZ" 
 
!Sets spectrum monitor's zero span resolution bandwidth to 100 kHz.

SETup:SMONitor:COUNt[:SNUMber]

Function

This command sets/queries the averaging count and turns on averaging.

Setting

Range: 1 to 999

Query

Range: 1 to 999

*RST Setting

100

Programming Example

 
OUTPUT 714;"SETup:SMONitor:COUNt 200" 
 
!Sets the averaging count to 200 and sets the averaging the state to on.

SETup:SMONitor:COUNt:NUMber

Function

This command sets/queries the averaging count used when the averaging is turned on.

Setting

Range: 1 to 999

Query

Range: 1 to 999

*RST Setting

100

Programming Example

 
OUTPUT 714;"SETup:SMONitor:COUNt:NUMBer 200" !Sets the averaging count to 200.

SETup:SMONitor:COUNt:STATe

Function

This command sets/queries the averaging state.

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting

OFF

Programming Example

 
OUTPUT 714;"SETup:SMONitor:COUNt:STATe 1" !Turns on averaging.

SETup:SMONitor:CONTinous

Function

This command arms triggering for a measurement sweep. Trigger arming can be single (OFF) or continuous (ON). With single triggering, the measurement sweep starts when an INITiate or READ command is received. With continuous triggering, measurement sweeps initiate immediately and continuously.

The *RST (remote full preset) default setting is single triggering. At power-on or after a front-panel preset, the default setting is continuous triggering.

Setting

Range: ON|1|OFF|0

Query

Range: 1|0

*RST Setting OFF

Programming Example

 
OUTPUT 714;"SETup:SMONitor:CONTinuous ON" ! Sets the trigger mode to continuous.

SETup:SMONitor:DETector[:TYPE]

Function

This command sets/queries the Spectrum Monitor Detection Method. There are three detection methods available in the test set's Spectrum Monitor: Peak Detection, Sample Detection, and RMS Detection. See Detection Method for more information.

Requirements

Test Application Revision: B.03 and above
Lab Application Revision: A.01 and above

Setting

Range: PEAK|SAMPle|RMS

Query

Range: PEAK|SAMP|RMS

*RST Setting PEAK

Programming Example

 
OUTPUT 714;"SETup:SMONitor:DETector RMS"
! Sets Detection Method to RMS.

SETup:SMONitor:FREQuency:SPAN

Function

This command sets/queries the spectrum monitor's frequency span.

Setting

Range:

  • A value in the range 125 kHz to 100 MHz can be entered, however the value is rounded to the nearest of: 125 kHz, 500 kHz, 1.25 MHz, 2.5 MHz, 4 MHz, 5 MHz, 10 MHz, 12 MHz, 20 MHz, 40 MHz,
    80 MHz, 100 MHz
  • 0 Hz (indicates the spectrum monitor is operating in zero span mode. To set the resolution bandwidth when the spectrum monitor is operating in zero span mode, use SETup:SMONitor:BANDwidth|BWIDth:ZSPan[:RESolution] )
Query

Range: Same as setting range.

*RST Setting 5 MHz

Programming Example

 
OUTPUT 714;"SETup:SMONitor:FREQuency:SPAN 10MHZ" ! Sets the frequency span to 10 MHz.

SETup:SMONitor:TIME:OFFSet

Function

This command sets/queries the time offset. You can specify the time window for viewing the signal using this command and the SETup:SMONitor:TIME:SPAN . The measurement is made for the duration of the time span, beginning at the time defined by the trigger event plus the trigger delay plus the time offset. The units (S|MS|US|NS) are optional, if no units are specified then the default is S.
Setting

Range: 0 us to 10 s

Resolution: 0.1 us

Query

Range: 0 us to 10 s

Resolution: 0.1 us

*RST Setting 0 us

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TIME:OFFSet 25 MS" 
! Sets the spectrum monitor's time offset to 25 millisecond.

SETup:SMONitor:TIME:SPAN

Function

This command sets/queries the span of the time display. The units (S|MS|US) are optional, if no units are specified then the default is S.
Setting

Range: 50 us to 70 ms

Resolution: 0.250 us

Query

Range: 50 us to 70 ms

Resolution: 0.250 us

*RST Setting 10 ms

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TIME:SPAN 30MS" 
! Sets the spectrum monitor's time span to 30 millisecond.

SETup:SMONitor:TIMeout[:STIMe]

Function

This command sets/queries the spectrum monitor's timeout interval and turns on the timeout state. The units (S|MS|US) are optional, if no units are specified then the default is S.

Setting

Range: 0.1 to 999.9 seconds

Resolution: 0.1 second

Query

Range: 0.1 to 999.9 seconds

Resolution: 0.1 second

*RST Setting 10 s

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TIMeout:STIMe 12S" 
! Turns on the timeout timer and sets the timer to expire in 12 seconds.

SETup:SMONitor:TIMeout:STATe

Function

This command sets/queries the state of the spectrum monitor's timeout timer.

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting OFF

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TIMeout:STATe 1" ! Turns on the timeout timer.

SETup:SMONitor:TIMeout:TIME

Function

This command sets/queries the spectrum monitor's timeout interval. The units (S|MS|US) are optional, if no units are specified then the default is S.

Setting

Range: 0.1 to 999.9 seconds

Resolution: 0.1 seconds

Query

Range: 0.1 to 999.9 seconds

Resolution: 0.1 seconds

*RST Setting 10 seconds

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TIMeout:TIME 20S" 
! Generates a timeout error if no results are reported within 20 seconds.

SETup:SMONitor:TRACe:MODE

Function

This command sets/queries the trace update parameter.

  • WRITe (Clear-write) erases any data previously stored in the selected trace.
  • MAXHold (maximum hold) maintains the maximum level for each trace point of the selected trace and updates each trace point if a new maximum level is detected in successive sweeps.
  • MINHold (minimum hold) maintains the minimum level for each trace point of the selected trace and updates each trace point if a new minimum level is detected in successive sweeps.

If you change the center, start, or the frequency span, or the resolution bandwidth, the MAXHold and MINHold traces are restarted. These traces are not restarted if you change only the reference level or the scale.

Setting

Range: WRITe|MAXHold|MINHold

Query

Range: WRIT|MAXH|MINH

*RST Setting WRITe

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TRACe:MODE MAXH" 
! Sets the update method to maximim hold.

SETup:SMONitor:TRiGger:DELay

Function

This command sets/queries the trigger delay. This command allows you to add a time delay following the trigger event before samples are taken. The delay can be positive or negative. The units (S|MS|US) are optional, if no units are specified then the default is S.

Setting

Range: -50 ms to +50 ms

Resolution: 5 significant digits or 100 ns, whichever is greater

Query

Range: -50 ms to +50 ms

Resolution: 5 significant digits or 100 ns, whichever is greater

*RST Setting 350 us

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TRIGger:DELay 1MS" ! Sets the trigger delay to 1 millisecond.

SETup:SMONitor:TRiGger:SOURce

Function

This command sets the trigger source. Immediate triggering happens as soon as the measurement is armed. RF rise triggering is initiated by the rising edge of an RF burst. With protocol triggering, sampling is initiated by a signaling event such as the start of a burst. An external trigger is used when set to external.

Setting

Range: IMMediate|PROTocol|RISE|EXTernal

Query

Range: IMM|PROT|RISE|EXT

*RST Setting IMMediate

Programming Example

 
OUTPUT 714;"SETup:SMONitor:TRIGger:SOURce RISE" 
! Sets the measurement to trigger on the rising edge of an RF burst.