LMR Master™ S412E Programming Manual : PTC ITRC 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:
: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 numerical values in the PTC-ITCR 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
[: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 only applied to the PTC-ITCR 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. FETCh:SIGAnalyzer?, READ:SIGAnalyzer?, and MEASure:SIGAnalyzer? will always return all numerical values.
The query will be returned in the units (dBm, Watts, 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]:DM:SYMBol:RATE 6000|8000|12000|16000|18000
[:SENSe]:DM:SYMBol:RATE?
Description
Sets the symbol rate of the signal generator.
Cmd Parameters:
6000|8000|12000|16000|18000
Query Parameters:
NA
Range
6000|8000|12000|16000|18000
Default Value
6000
Default Unit
NA
Example
To set the symbol rate to 16000:
:DM:SYMBol 16000
Front Panel Access
Setup, Symbol Rate
[: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: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:
:SENSe: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:
:SENSe:FREQuency:COUPling:OFFSet 200000000
Front Panel Access
Frequency, Coupling Offset
[:SENSe]:FREQuency:SIGStandard:CHANnel <number>
[:SENSe]:FREQuency:SIGStandard:CHANnel?
Title
Channel Selection
Description
Sets the AAR (Association of American Railroads) channel number for the selected signal standard. The channel is fixed and cannot be changed if the current signal standard selected with the :FREQuency:SIGStandard:NAMe command is a single channel and not a range.
Parameter
<number>
Front Panel Access
Freq, Channel
[:SENSe]:FREQuency:SIGStandard:NAMe <string>
[:SENSe]:FREQuency:SIGStandard:NAMe?
Title
Signal Standard
Description
Selects the desired signal standard from the list of available AAR channels and ranges. The <string> argument is the name of the desired signal standard as displayed in the instrument’s current signal standard list. The list can be displayed on the instrument by choosing the 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 AAR 001, the value of the <string> argument would be “AAR 001”.
For signal standards that are associated with a channel range, such as AAR 005-097, use the :FREQuency:SIGStandard:CHANnel command to select the AAR channel number.
The query form of this command will return the name of the currently selected Signal Standard on the list.
Parameter
<string>
Front Panel Access
Freq, Signal Standard
[:SENSe]:FREQuency:SPAN 25|50|100|500|1000|5000
[:SENSe]:FREQuency:SPAN?
Description
Sets the span of the Spectrum display in PTC-ITCR 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:
:SENSe:FREQuency:SPAN 1000
Front Panel Access
Frequency, Span
[:SENSe]:POWer[:RF]:RANGe[:IMMediate]
Description
Turns off auto ranging and adjusts the receiver reference level once. In PTC-ITCR 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 PTC-ITCR 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]:SYMBolspan <value>
[:SENSe]:SYMBolspan?
Description
Sets the symbol span. Please note that this setting only affects the Eye Diagram in the PTC-ITCR 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
Default Unit
NA
Example
To set the symbol span to 4:
:SYMBolspan 4
Front Panel Access
Measurement, PTC-ITCR Analyzer, Symbol Span