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. This parameter must be set to OFF before the test set uses the manual setting for the reference level.

The command to manually set the reference level is SETup:SMONitor:AMPLitude:RLEVel:MANual .

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 monitor's 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.

The test set does not apply the manual setting until the command SETup:SMONitor:AMPLitude:RLEVel:AUTO is set to OFF.

Setting

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

Resolution: 0.1 dB

Query

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

*RST Setting

+37 dB

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. This command returns the resolution bandwidth regardless of whether the bandwidth was set manually or automatically.

The command that configures the test set to automatically determine the resolution bandwidth based on the Frequency Span setting is SETup:SMONitor:BANDwidth|BWIDth:AUTO . When the resolution bandwidth is not set to Auto, you can manually configure the resolution bandwidth with the command SETup:SMONitor:BANDwidth|BWIDth:MANual .

Query

Range: 300 Hz to 5 MHz

*RST Setting 30000 Hz

Programming Example

 
OUTPUT 714;"SETup:SMONitor: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 Frequency Span, Resolution Bandwidth and Dynamic Range 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 .

Setting

Range: 1|ON|0|OFF

Query

Range: 1|0

*RST Setting 1

Requirements

Test Application Revision: A.07 and above

Lab Application Revision: C.02 and above

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 Frequency Span, Resolution Bandwidth and Dynamic Range 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.

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

Requirements

Test Application Revision: A.07 and above

Lab Application Revision: C.02 and above

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 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.
To change the spectrum monitor to zero span mode, us the command SETup:SMONitor:FREQuency:SPAN , to set the frequency span to 0 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.
Setting

Range: PEAK|SAMPle|RMS

Query

Range: PEAK|SAMP|RMS

*RST Setting PEAK

Requirements

Test Application Revision: A.07 and above

Lab Application Revision: C.02 and above

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. If the Spectrum Monitor Resolution Bandwidth Coupling State is ON (see SETup:SMONitor:AMPLitude:RLEVel:AUTO ) the Frequency Span setting will automatically determine the resolution bandwidth. The couplings between the frequency span and the resolution bandwidth are shown in Frequency Span, Resolution Bandwidth and Dynamic Range .

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

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

Setting

Range: A value in the range 125 kHz to 100 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.

  • 0 Hz, 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
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: 1 to 999.9 seconds

Resolution: 0.1 second

Query

Range: 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: 1 to 999.9 seconds

Resolution: 0.1 seconds

Query

Range: 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.