LMR Master™ S412E Programming Manual : NBFM Commands : :SENSe Subsystem
 
: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.
Cmd Parameters:
NA
Query Parameters:
NA
Range
NA
Default Value
NA
Default Unit
NA
Example
To trigger a self-test:
:SENSe:APPLication:TST?
Front Panel Access
Shift 8 (System), Application Self Test
[: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. There will be a total of 18 fields in the return string and will have the following format:
PASSED/FAILED, PASSED/FAILED, Int, Int, Int, Int¸ Int, Int, Int, Int, Int, Int, Int, PASSED/FAILED, Float, Float, Float, String.
The first PASSED/FAILED field represents the overall test result. The second field represents whether the signal generator is functioning properly. Fields 3 through 13 show the PLL status at the following frequencies:
500000 Hz, 160500000 Hz, 320500000 Hz, 480500000 Hz, 640500000 Hz, 800500000 Hz, 960500000 Hz, 1120500000 Hz, 1280500000 Hz, 1440500000 Hz, 1600000000 Hz
Field 14 shows the Level Cal version.
There are four PLLs that are tested on the signal generator and an integer from 0 to 15 is shown in each field. Each PLL represents one of the four bits in the integer number. Below is a description of the PLLs and the bits that they correspond to:
Bit 0: Sys PLL
Bit 1: IQ PLL
Bit 2: LO PLL
Bit 3: VR PLL
A 1 in the bit means that the PLL is functioning properly and a
0 means there is something wrong with the PLL. For example,
a value of 13 (1101) means that the IQ PLL has failed. Field fourteen describes whether the internal SINAD hardware test has passed or failed. The 3 floats following the PASSED/FAILED field are the SINAD level, SINAD frequency, and the SINAD peak to peak value.
Cmd Parameters:
NA
Query Parameters:
NA
Range
NA
Default Value
NA
Default Unit
NA
Example
To display the detailed test results:
:APPLication:TST?;:APPLication:TST:RESult?
Front Panel Access
Shift 8 (System), Application Self Test
[: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
[:SENSe]:BANDwidth[:RESolution] 5|6.25|10|12.5|30|50
[:SENSe]:BANDwidth[:RESolution]?
[:SENSe]:BWIDth[:RESolution] 5|6.25|10|12.5|30|50
[:SENSe]:BWIDth[:RESolution]?
Description
Sets the IF bandwidth.
Note: IF bandwidth value is set and returned in kHz.
Cmd Parameters
5|6.25|10|12.5|30|50
Query Parameters
NA
Range
5|6.25|10|12.5|30|50
Default Value
10
Default Unit
kHz
Example
To change the IF Bandwidth to 50 kHz:
:BANDwidth 50
:BWIDth 50
Front Panel Access
Setup, Filters, IFBW
[: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.
If Auto Rx Range is Off, any adjustments to the offset will be reflected in the vertical position of the spectrum trace. The reference level will not be adjusted.
The Received Pwr value in the Summary Table is also affected by changing this value.
The query returns a value from -100 to 100. A negative sign means external gain and no sign means external loss.
Cmd Parameters:
<value>
Query Parameters:
NA
Range
100 dB Ext Loss to 100 dB Ext Gain
Default Value
0 dB
Default Unit
dB
Example
To set the external attenuation to 30 dB:
:CORRection:OFFSet 30
Front Panel Access
Amplitude, Rx Power Offset
[: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 Carrier Power will be dashed out. FETCh:SIGAnalyzer?, READ:SIGAnalyzer?, and MEASure:SIGAnalyzer? will always return all numerical values.
The query will be returned in the units (dBm, Watt, or Volts) selected through the Rx Units button using the front panel or with the command: UNIT:POWer:RX. If the Rx Units has been set to dBm, the squelch setting is returned in dBm. If the unit is set to Watts, the squelch setting is returned in fW. If the unit is set to Volts, the squelch setting is returned in fV.
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. If the unit is set to Volts, the squelch setting must be set in fV.
Cmd Parameters
<value>
Query Parameters
NA
Range
0 dBm to -120 dBm or 1 fW to 1000000000000 fW
or 223.6 mV to 223.61 nV
Default Value
-100 dBm or 100 fW or 2.24 μV
Default Unit
dBm or fW or fV
Example
To set the squelch to -10 dBm:
:DM:SQUelch -10
Front Panel Access
Setup, Squelch Lvl
[: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
Default Unit
NA
Example
 To set the deviation mode to average:
:DM:PATTern AVER
Front Panel Access
Setup, Deviation Mode
[:SENSe]:DM:PATTern CTCSs|DCS|DTMF
[:SENSe]:DM:PATTern?
Description
Sets the tone type. Setting the tone type will change the 8th numeric value in the summary window to readout the chosen tone type. The query will return CTCSS for CTCSS, DCS for DCS, and DTMF for DTMF. Please note that setting the tone type will restart the sweep.
Cmd Parameters:
CTCSs|DCS|DTMF
Query Parameters:
NA
Range
CTCSs|DCS|DTMF
Default Value
CTCSs
Default Unit
NA
Example
 To set the modulation type to DTMF
:DM:PATTern DTMF
Front Panel Access
Setup, Tone Type
[:SENSe]:FILTer:DEMPhasis[:STATe] OFF|ON|0|1
[:SENSe]:FILTer:DEMPhasis[:STATe]?
Description
Sets the de-emphasis filter on or off.
Cmd Parameters:
OFF|ON|0|1
Query Parameters:
NA
Range
OFF|ON|0|1
Default Value
OFF
Default Unit
NA
Example
To turn the de-emphasis filter on:
:FILTer:DEMPhasis ON
Front Panel Access
Setup, Filter, De-emphasis Filter
[: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
Front Panel Access
Setup, Filter, Low Pass Filter
[:SENSe]:FILTer:HPASs:FREQuency 0.3|3|NONE
[:SENSe]:FILTer:HPASs:FREQuency?
Description
Sets the high pass filter frequency.
Note: High pass filter frequency value is set and returned in kHz (except for NONE).
Cmd Parameters:
0.3|3|NONE
Query Parameters:
NA
Range
0.3|3|NONE
Default Value
None
Default Unit
kHz
Example
To set the high pass filter frequency to 300 Hz:
:FILTer:HPASs:FREQuency 0.3
Front Panel Access
Setup, Filter, High Pass Filter
[: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.
Cmd Parameters:
NA
Query Parameters:
NA
Range
NA
Default Value
NA
Default Unit
NA
Example
To set NBFM Quieting reference:
:FM:SENSitivity:REFerence:SET
Front Panel Access
Measurement, NBFM Quieting, Set Reference
[: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
Example
To set the center frequency to 145 MHz:
:FREQuency:CENTer 145000000
Front Panel Access
Frequency, Rx Freq
[: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.
Changing the Rx frequency using the front panel or [:SENSe]:FREQuency:CENTer <value> will turn Auto Scan off.
Cmd Parameters:
OFF|ON|0|1
Query Parameters:
NA
Range
OFF|ON|0|1
Default Value
OFF
Default Unit
NA
Example
To turn auto testing on:
:FREQuency:CENTer:AUTO ON
Front Panel Access
Setup, Auto Scan
[: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. Please note that turning on frequency coupling will automatically move the Tx frequency to the Rx frequency plus any frequency coupling offset. If the Rx frequency and frequency coupling offset is at a setting where the Tx frequency will be beyond the min/max limits, the instrument will not allow coupling to be turned on. The query command returns the state of the frequency coupling setting. A return value of 1 is ON, and a return value of 0 is OFF.
Cmd Parameters:
OFF|ON|0|1
Query Parameters:
NA
Range
OFF|ON|0|1
Default Value
OFF
Default Unit
NA
Example
To turn Rx/Tx frequency coupling on:
:FREQuency:COUPling ON
Front Panel Access
Frequency, Rx/Tx Coupling
[: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. The query returns the current coupling offset in Hz.
Cmd Parameters:
<Value>
Query Parameters:
NA
Range
-1000000000 Hz to 1000000000 Hz
Default Value
0 Hz
Default Unit
Hz
Example
To set coupling offset to 200 MHz:
:FREQuency:COUPling:OFFSet 200000000
Front Panel Access
Frequency, Coupling Offset
[:SENSe]:FREQuency:SPAN 12.5|25|50
[:SENSe]:FREQuency:SPAN?
Description
Sets the span of the Spectrum display in NBFM Analyzer measurement mode.
Note: Span value is set and returned in kHz.
Cmd Parameters
12.5|25|50
Query Parameters
NA
Range
12.5|25|50
Default Value
25
Default Unit
kHz
Example
To set the span to 50 kHz:
:FREQuency:SPAN 50
Front Panel Access
Frequency, Span
[: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
Example
To set the audio spectrum span to 5 kHz:
:FREQuency:SPAN:AUDio 5
Front Panel Access
Measurement, NBFM Analyzer, Audio Span
[:SENSe]:OBWidth:METHod PERCent|XDB
[:SENSe]:OBWidth:METHod?
Description
Sets the method for calculating occupied bandwidth. XDB calculates the occupied bandwidth based on points that are a specified number of dB below the carrier. Issue command [:SENSe]:OBWidth:XDB to set the number of dB to be used. PERCent calculates the occupied bandwidth based on points a specified percentage of the carrier power below the carrier. Issue command [:SENSe]:OBWidth:PERCent to set the percentage to be used.
Cmd Parameters:
PERCent|XDB
Query Parameters:
NA
Range
PERCent|XDB
Default Value
PERCent
Default Unit
NA
Example
To set occupied bandwidth using percentage of power:
:OBWidth:METHod PERCent
Front Panel Access
Measurement, NBFM Analyzer, Occ BW Setup, Occ BW Method
[: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%
Default Unit
%
Example
To change the occ bw percent to 70%:
:OBWidth:PERCent 70.00
Front Panel Access
Measurement, NBFM Analyzer, Occ BW Setup, % Int Pwr
[:SENSe]:OBWidth:XDB <rel ampl>
[:SENSe]:OBWidth:XDB?
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.
Cmd Parameters:
<rel ampl>
Query Parameters:
NA
Range
0 dBc to 100 dBc
Default Value
3 dBc
Default Unit
dBc
Example
To change the occ bw XDB to 10:
:OBWidth:XDB 10
Front Panel Access
Measurement, NBFM Analyzer, Occ BW Setup, > dBc
[: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:
:POWer:RANGe
Front Panel Access
Amplitude, Adjust Rx Range
[: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. In NBFM Analyzer measurement, this command adjusts the reference level of the spectrum graph.
Cmd Parameters:
OFF|ON|0|1
Query Parameters:
NA
Range
OFF|ON|0|1
Default Value
OFF or 0
Default Unit
NA
Example
To turn auto ranging off:
:POWer:RANGe:AUTO OFF
Front Panel Access
Amplitude, Auto Rx Range
[: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
Front Panel Access
Measurement, NBFM Analyzer, Audio Sweep Time