RFmxInstr Properties
- Updated2024-04-10
- 8 minute(s) read
RFmxInstr Properties
Use the RFmxInstr properties to access options for configuring and fetching measurements.
| Property | Description |
|---|---|
| Selector String |
Specifies the selector string used to access all subsequent selector string-based properties in this instance of the property node. Details |
| Frequency Reference:Source |
Specifies the frequency reference source. Details |
| Frequency Reference:Frequency (Hz) |
Specifies the Reference Clock rate, when the Frequency Reference Source property is set to ClkIn or RefIn. This value is expressed in Hz. Details |
| Frequency Reference:Exported Terminal |
Specifies a comma-separated list of the terminals at which to export the frequency reference. Details |
| RF Attenuation:Auto |
Specifies whether the RFmx driver computes the RF attenuation. Details |
| RF Attenuation:Value (dB) |
Specifies the nominal attenuation setting for all attenuators before the first mixer in the RF signal chain. This value is expressed in dB. Details |
| Mechanical Attenuation:Auto |
Specifies whether the RFmx driver chooses an attenuation setting based on the hardware settings. Details |
| Mechanical Attenuation:Value (dB) |
Specifies the level of mechanical attenuation for the RF path. This value is expressed in dB. Details |
| LO:LO Leakage Avoidance Enabled |
Specifies whether to reduce the effects of the instrument leakage by placing the LO outside the band of acquisition. Details |
| LO:LO Source |
Specifies the local oscillator (LO) signal source used to downconvert the RF input signal. Details |
| LO:LO Frequency (Hz) |
Specifies the LO signal frequency for the configured center frequency. This value is expressed in Hz. Details |
| LO:LO Export Enabled |
Specifies whether to enable the LO OUT terminals on the installed devices. Details |
| LO:LO2 Export Enabled |
Specifies whether to enable the LO2 OUT terminals in the installed devices. Details |
| LO:LO In Power (dBm) |
Specifies the power level expected at the LO IN terminal when the LO Source property is set to LO_In. This value is expressed in dBm. Details |
| LO:LO Out Power (dBm) |
Specifies the power level of the signal at the LO OUT terminal when the LO Export Enabled property is set to TRUE. This value is expressed in dBm. Details |
| LO:Tuning Speed |
Makes tradeoffs between tuning speed and phase noise. Details |
| LO:Downconverter Frequency Offset (Hz) |
Specifies an offset from the center frequency value for the downconverter. Use this property to offset the measurement away from the LO leakage or DC Offset of analyzers that use a direct conversion architecture. You must set this property to half the bandwidth or span of the measurement + guardband. The guardband is needed to ensure that the LO leakage is not inside the analog or digital filter rolloffs. This value is expressed in Hz. Details |
| LO:Downconverter Center Frequency |
Enables in-band retuning and specifies the current frequency of the RF downconverter. This value is expressed in Hz. Details |
| LO:LO Injection Side |
Specifies the LO injection side. Details |
| LO:LO Frequency Step Size (Hz) |
Specifies the step size for tuning the LO phase-locked loop (PLL). Details |
| LO:VCO Frequency Step Size (Hz) |
Specifies the step size for tuning the internal voltage-controlled oscillator (VCO) used to generate the LO signal. The valid values for LO1 include 1 Hz to 50 MHz and for LO2 include 1 Hz to 100 MHz. Details |
| LO:LO PLL Fractional Mode |
Specifies whether to use fractional mode for the LO phase-locked loop (PLL). Details |
| Trigger:Export Output Terminal |
Specifies the destination terminal for the exported Reference Trigger. You can also choose not to export any signal. Details |
| Trigger:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Trigger:Start:Type |
Specifies whether the start trigger is a digital edge or a software trigger. Details |
| Trigger:Start:Digital Edge:Source |
Specifies the source terminal for the start trigger. This property is used only when you set the Start Trigger Type property to Digital Edge. Details |
| Trigger:Start:Digital Edge:Edge |
Specifies the active edge for the start trigger. This property is used only when you set the Start Trigger Type property to Digital Edge. Details |
| Trigger:Start:Export Output Terminal |
Specifies the destination terminal for the exported start trigger. Details |
| Trigger:Start:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Trigger:Advance:Type |
Specifies whether the advance trigger is a digital edge or a software trigger. Details |
| Trigger:Advance:Digital Edge:Source |
Specifies the source terminal for the advance trigger. Details |
| Trigger:Advance:Export Output Terminal |
Specifies the destination terminal for the exported advance trigger. Details |
| Trigger:Advance:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Event:Ready For Start:Output Terminal |
Specifies the destination terminal for the Ready for Start event. Details |
| Event:Ready For Start:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Event:Ready For Advance:Output Terminal |
Specifies the destination terminal for the Ready for Advance event. Details |
| Event:Ready For Advance:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Event:Ready For Reference:Output Terminal |
Specifies the destination terminal for the Ready for Reference event. Details |
| Event:Ready For Reference:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Event:End Of Record:Output Terminal |
Specifies the destination terminal for the End of Record event. Details |
| Event:End Of Record:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Event:Done:Output Terminal |
Specifies the destination terminal for the Done event. Details |
| Event:Done:Terminal Name |
Returns the fully qualified signal name as a string. Details |
| Device Information:Device Temperature (deg C) |
Returns the current temperature of the module. This value is expressed in degrees Celsius. Details |
| Device Information:Digitizer Temperature (deg C) |
Returns the current temperature of the digitizer module. This value is expressed in degrees Celsius. Details |
| Device Information:LO Temperature (deg C) |
Returns the current temperature of the LO module associated with the device. This value is expressed in degrees Celsius. Details |
| Device Information:Serial Number |
Returns the serial number of the RF downconverter module. Details |
| Device Information:Instrument Model |
Returns a string that contains the model number or name of the RF device that you are currently using. Details |
| Device Information:Module Revision |
Returns the revision of the RF downconverter module. Details |
| Device Information:Instrument Firmware Revision |
Returns a string containing the firmware revision information of the RF downconverter for the composite device you are currently using. Details |
| Device Information:Preselector Present |
Indicates whether a preselector is available on the RF downconverter module. Details |
| Device Information:RF Preamp Present |
Indicates whether an RF preamplifier is available on the RF downconverter module. Details |
| Advanced:Preamp Enabled |
Specifies whether the RF preamplifier is enabled in the system. Details |
| Advanced:Channel Coupling |
Specifies whether the RF IN connector is AC- or DC-coupled on the downconverter. Details |
| Advanced:Downconverter Preselector Enabled |
Specifies whether the tunable preselector is enabled on the downconverter. Details |
| Advanced:Mixer Level (dBm) |
Specifies the mixer level. This value is expressed in dBm. Details |
| Advanced:Mixer Level Offset (dB) |
Specifies the number of dB by which to adjust the device mixer level. Details |
| Advanced:RF Attenuation Step Size (dB) |
Specifies the step size for the RF attenuation level. This value is expressed in dB. The actual RF attenuation is coerced up to the next highest multiple of the specified step size. If the mechanical attenuators are not available to implement the coerced RF attenuation, the solid state attenuators are used. Details |
| Advanced:OSP Delay Enabled |
Specifies whether to enable the digitizer OSP block to delay Reference Triggers, along with the data samples, moving through the OSP block. Details |
| Advanced:Phase Offset |
Specifies the offset to apply to the initial I and Q phases. Details |
| Advanced:FFT Width |
Specifies the FFT width of the device. The FFT width is the effective bandwidth of the signal path during each signal acquisition. Details |
| Advanced:Cleaner Spectrum |
Specifies how to obtain the lowest noise floor or faster measurement speed. Details |
| Advanced:IF Output Power Level Offset |
Specifies the power offset by which to adjust the default IF output power level. This value is expressed in dB. Details |
| Advanced:Digitizer Dither Enabled |
Specifies whether dithering is enabled on the digitizer. Details |
| Advanced:IF Filter Bandwidth (Hz) |
Specifies the IF filter path bandwidth for your device configuration. Details |
| Advanced:Frequency Settling Units |
Specifies the delay duration units and interpretation for LO settling. Details |
| Advanced:Frequency Settling |
Specifies the value used for LO frequency settling. Details |
| Advanced:RF Highpass Filter Frequency (Hz) |
Specifies the maximum corner frequency of the high pass filter in the RF signal path. The device uses the highest frequency high-pass filter option below or equal to the value you specify and returns a coerced value. Specifying a value of 0 disables high pass filtering silly. For multispan acquisitions, the device uses the appropriate filter for each subspan during acquisition, depending on the details of your application and the value you specify. In multispan acquisition spectrum applications, this property returns the value you specified rather than a coerced value if multiple high-pass filters are used during the acquisition. Details |
| Advanced:Subspan Overlap |
Specifies the amount of overlap between consecutive subspans in a multispan spectrum acquisition. Overlapping subspans can reduce the power level of spurs in the acquired data. The value you specify determines the amount of shift as a percentage of subspan width. Details |
| Advanced:Downconverter Gain (dB) |
Returns the net signal gain for the device at the current RFmx settings and temperature. RFmx scales the acquired I/Q and spectrum data from the digitizer using the value of this property. Details |
| Advanced:Amplitude Settling |
Specifies the amplitude settling accuracy value. This value is expressed in decibels. RFmx waits until the RF power attains the specified accuracy level after calling the RFmx Initiate VI. Details |
| Advanced:Overflow Error Reporting |
Configures error reporting for ADC and overflows occurred during onboard signal processing. Overflows lead to clipping of the waveform. Details |
| Advanced:Common Mode Level (V) |
Specifies the common-mode level presented at each differential input terminal. The common-mode level shifts both positive and negative terminals in the same direction. This must match the common-mode level of the device under test (DUT). This value is expressed in Volts. Details |
| Advanced:SMU Resource Name |
Specifies the resource name assigned by Measurement and Automation Explorer (MAX) for NI Source Measure Units (SMU) which is used as the noise source power supply for Noise Figure (NF) measurement, for example, PXI1Slot3, where PXI1Slot3 is an instrument resource name. SMU Resource Name can also be a logical IVI name. Details |
| Advanced:SMU Channel |
Specifies the output channel to be used for noise figure (NF) measurement in RFmx. Details |
| Advanced:Optimize Path For Signal Bandwidth |
Optimizes RF path for the signal bandwidth that is centered on the IQ carrier frequency. Details |
| Advanced:Input Isolation Enabled |
Specifies whether input isolation is enabled. Details |
| Advanced:Thermal Correction Headroom Range (deg C) |
Specifies the expected thermal operating range of the instrument from the self-calibration temperature returned from the Device Temperature property. This value is expressed in degree Celsius. Details |
| Advanced:Temperature Read Interval (s) |
Specifies the minimum time difference between temperature sensor readings. This value is expressed in seconds. Details |
| Advanced:Thermal Correction Temperature Resolution (deg C) |
Specifies the temperature change required before RFmx recalculates the thermal correction settings when entering the running state. This value is expressed in degree Celsius. Details |
| Advanced:Number of Raw IQ Records |
Returns the number of raw IQ records to acquire to complete measurement averaging. Details |
| Advanced:Self Calibration:Self Cal Validity Check |
Specifies whether the RFmx driver validates the self-calibration data. Details |
| Advanced:Self Calibration:Self Cal Validity Check Time Interval (s) |
Specifies the minimum time between two self calibration validity checks. This value is expressed in seconds. Details |
| MIMO:LO Sharing Mode |
Specifies the RFmx session with the respective LO sharing mode. Details |
| MIMO:Number of LO Sharing Groups |
Specifies the RFmx session with the number of LO sharing groups. Details |
| Load Configurations: Load Options |
Specifies the configurations to skip while loading from a file using the RFmxInstr Load Configurations VI . Details |
| Recommended Settings:Acquisition Type |
Returns the recommended acquisition type for the last committed measurement configuration. Details |
| Recommended Settings:Center Frequency (Hz) |
Returns the recommended center frequency of the RF signal. This value is expressed in Hz. Details |
| Recommended Settings:Number of Records |
Returns the recommended number of records to acquire to complete measurement averaging. Details |
| Recommended Settings:Trigger Min Quiet Time (s) |
Returns the recommended minimum quiet time during which the signal level must be below the trigger value for triggering to occur. This value is expressed in seconds. Details |
| Recommended Settings:IQ:Acquisition Time (s) |
Returns the recommended acquisition time for I/Q acquisition. This value is expressed in seconds. Details |
| Recommended Settings:IQ:Minimum Sample Rate (Hz) |
Returns the recommended minimum sample rate for I/Q acquisition. This value is expressed in Hz. Details |
| Recommended Settings:IQ:Pre Trigger Time (s) |
Returns the recommended pretrigger time for I/Q acquisition. This value is expressed in seconds. Details |
| Recommended Settings:Spectral:Acquisition Span (Hz) |
Returns the recommended acquisition span for spectral acquisition. This value is expressed in Hz. Details |
| Recommended Settings:Spectral:FFT Window |
Returns the recommended FFT window type for spectral acquisition. Details |
| Recommended Settings:Spectral:Resolution Bandwidth (Hz) |
Returns the recommended FFT bin width for spectral acquisition. This value is expressed in Hz. Details |