Skip to content

NI RFSA Vertical Attributes

Jump to bottom
Greg Stoll edited this page Nov 11, 2021 · 1 revision

Vertical Attributes

NIRFSA_ATTR_REFERENCE_LEVEL

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W niRFSA_ConfigureReferenceLevel

Description

Specifies the reference level, in dBm. The reference level represents the maximum expected power of an RF input signal.

Note Note  For the PXIe-5645, this attribute is ignored if you are using the I/Q ports.
Refer to the NIRFSA_ATTR_EXTERNAL_GAIN attribute for more information about how configuring an external gain and a reference level affect attenuation.

Default Value: 0

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694, PXIe-5830/5831/5832/5840/5841

Related Topics

Improving Your Measurements

Programming Attenuation-Related Properties and Attributes Using NI-RFSA

NIRFSA_ATTR_MIXER_LEVEL

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the mixer level, in dBm. The mixer level represents the attenuation value to apply to the input RF signal as it reaches the first mixer in the signal chain. If you do not set this attribute, NI-RFSA automatically selects an optimal mixer level value based on the reference level. The valid values for this attribute depend on your device configuration.

If you set the NIRFSA_ATTR_MIXER_LEVEL and NIRFSA_ATTR_MIXER_LEVEL_OFFSET attributes at the same time, NI-RFSA returns an error.

PXIe-5601/5663/5663E—This attribute is read-only.

PXIe-5667—This attribute is read-only when the NIRFSA_ATTR_LOW_FREQUENCY_BYPASS_ENABLED attribute is set to NIRFSA_VAL_DISABLED.

Units: dBm

Default Values:

PXI-5600/5661: –30

PXIe-5603/5605/5665/5667/5668: –10

All other devices: N/A

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXI-5661, PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_MIXER_LEVEL_OFFSET

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the number of dB by which to adjust the device mixer level. The default value is 0, which specifies device settings that are the best compromise between distortion and noise. Specifying a positive value for this attribute configures the device for moderate distortion and low noise, and specifying a negative value results in low distortion and higher noise.

You cannot set the NIRFSA_ATTR_MIXER_LEVEL and NIRFSA_ATTR_MIXER_LEVEL_OFFSET attributes at the same time.

PXIe-5667—This attribute is read-only when the NIRFSA_ATTR_LOW_FREQUENCY_BYPASS_ENABLED attribute is set to NIRFSA_VAL_DISABLED.

Units: dB

Default Value: 0

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXI-5661, PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the level of the IF signal leaving the system, in dBm. Use this attribute to increase or decrease the nominal IF signal output level to achieve better measurement results.

If you set the NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL and NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL_OFFSET attributes at the same time, NI-RFSA returns an error.

Note Note  If you set the NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL attribute to a value less than –10 dBm, the IF output power level may be higher than the value you request. Read the value of this attribute to determine the configured IF output power level.
Note Note  The value of this attribute is limited by the amount of IF attenuation that the downconverter can apply, the NIRFSA_ATTR_REFERENCE_LEVEL attribute, the NIRFSA_ATTR_DOWNCONVERTER_CENTER_FREQUENCY attribute, and the NIRFSA_ATTR_SPECTRUM_CENTER_FREQUENCY attribute or NIRFSA_ATTR_IQ_CARRIER_FREQUENCY attribute, depending on your acquisition type.
Units: dBm

Default Value:

PXIe-5667: -2 dBm

PXIe-5668: -1 dBm

All other devices: –6 dBm

Supported Devices: PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694

NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL_OFFSET

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the number of dB by which to adjust the default IF output power level. This attribute does not depend on absolute IF output power levels, so you can use it to adjust the IF output power level on all NI-RFSA devices without knowing the exact default value. Use this attribute to increase or decrease the nominal output level to achieve better measurement results. The default value for the offset is 0 dB.

If you set the NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL and NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL_OFFSET attributes at the same time, NI-RFSA returns an error.

Units: dB

Default Value: 0

Supported Devices: PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_DOWNCONVERTER_GAIN

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 RO None

Description

Returns the net signal gain for the NI-RFSA device at the current NI-RFSA settings and temperature. NI-RFSA scales the acquired I/Q and spectrum data from the digitizer using the value of this attribute.

For a vector signal analyzer (VSA), the system is defined as the RF downconverter and all interfaces between the RF IN connector on the RF downconverter front panel and the IF IN connector on the digitizer front panel. For a spectrum monitoring receiver, the system is defined as the RF preselector, RF downconverter, and IF conditioning modules including all interfaces between the RF IN connector on the RF preselector module front panel and the IF IN connector on the digitizer front panel.

Default Value: N/A

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694/5698, PXIe-5830/5831/5832/5840/5841

NIRFSA_ATTR_DIGITIZER_VERTICAL_RANGE

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the vertical range of the digitizer. The vertical range is defined as the absolute value of the input range for a channel. The default vertical range works for all device configurations, but you can use this attribute to optimize performance if you know that the signal level at the digitizer input terminal is low.

Note Note  For most applications, NI-RFSA selects an appropriate value for this attribute.
This value is expressed in volts. For example, to acquire a sine wave that spans between –0.5 V and +0.5 V, set this attribute to 1.0.

PXIe-5840/5841—This attribute is read-only.

Default Value: 1.0

Supported Devices: PXI-5661, PXIe-5663/5663E/5665/5667, PXIe-5840/5841

Advanced

NIRFSA_ATTR_REFERENCE_LEVEL_HEADROOM

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the margin NI-RFSA adds to the NIRFSA_ATTR_REFERENCE_LEVEL attribute. The margin helps to avoid clipping and overflow warnings if the input signal exceeds the configured reference level.

NI-RFSA configures the input gain to avoid clipping and associated overflow warnings as long as the instantaneous power of the input signal remains within the reference level plus the reference level headroom. If you know the input power of the signal precisely or have already included margin in the reference level, you may be able to improve the signal-to-noise ratio by reducing the reference level headroom.

Units: dB

Default Value:

PXIe-5830/5831/5832/5841: 1 dB

PXIe-5840: 0 dB

Supported Devices: PXIe-5830/5831/5832/5840/5841

NIRFSA_ATTR_EXTERNAL_GAIN

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the gain, in dB, of a switch (or cable) connected before the RF IN connector of an NI-RFSA system. When you set this attribute, NI-RFSA calculates appropriate attenuator settings based on the value of this attribute and the value of the NIRFSA_ATTR_REFERENCE_LEVEL attribute. In this case, NI-RFSA interprets the reference level as the maximum expected power level of the signal at the input of the external gain device. For more information about attenuation, refer to the Attenuation and Signal Levels topic for your device in the NI RF Vector Signal Analyzers Help.

Note Note  For the PXIe-5820, this attribute specifies the gain, in dB, of a switch (or cable) connected before the IQ IN connector.
Note Note  For the PXIe-5645, this attribute is ignored if you are using the I/Q ports.
With this attribute set, NI-RFSA reads the NIRFSA_ATTR_IQ_POWER_EDGE_REF_TRIGGER_LEVEL attribute value as the power level at the input of the external gain device at which the NI-RFSA device should trigger.

Negative values indicate attenuation.

Valid Values: –INF to +INF

Units: dB

Default Value: 0

Supported Devices: PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXIe-5663/5663E/5665/5667/5668, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_ATTENUATION

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the nominal attenuation setting, in dB, for all attenuators before the first mixer in the RF signal chain. If you do not set this attribute, NI-RFSA automatically chooses an attenuation setting based on the reference level you configure. The valid values for this attribute depend on the device configuration.

PXI-5600/5661—You can change the attenuation value to modify the amount of noise and distortion. Higher attenuation levels increase the noise level while decreasing distortion; lower attenuation levels decrease the noise level while increasing distortion.

PXIe-5601/5663/5663E—You can change the attenuation value and the value of the NIRFSA_ATTR_IF_ATTENUATION attribute to modify the amount of noise and distortion. Higher attenuation levels increase the noise level while decreasing distortion; lower attenuation levels decrease the noise level while increasing distortion.

PXIe-5603/5605/5606/5665/5668—You can set multiple attributes to modify the attenuation values for the device. Refer to PXIe-5665 RF Attenuation and Signal Levels for more information about configuring attenuation.

PXIe-5667—This attribute specifies the nominal attenuation setting for all attenuators before the first RF mixer in the input signal path. This attribute is read-only when the NIRFSA_ATTR_LOW_FREQUENCY_BYPASS_ENABLED attribute is set to NIRFSA_VAL_DISABLED.

PXIe-5693—This attribute is read-only and returns the nominal RF attenuation of the PXIe-5693.

Units: dB

Default Value: N/A

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693

NIRFSA_ATTR_MECHANICAL_ATTENUATION

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the level of mechanical attenuation for the RF path, in dB.

PXIe-5667—This attribute is read-only when the NIRFSA_ATTR_LOW_FREQUENCY_BYPASS_ENABLED attribute is set to NIRFSA_VAL_DISABLED.

PXIe-5668with PXIe-5698—This attribute is read-only when the NIRFSA_ATTR_RF_PREAMP_ENABLED attribute is set to NIRFSA_VAL_RF_PREAMP_ENABLED.

Units: dB

Valid Values:

**PXIe-5601/5663/5663E—**0, 16

**PXIe-5603/5665 (3.6 GHz)—**0, 10, 20, 30

**PXIe-5605/5665 (14 GHz), PXIe-5606/5668—**0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector low frequency bypass path—0, 10, 20, 30

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector filter path—0

PXIe-5667 (7 GHz) using the PXIe-5693 RF preselector low frequency bypass path—0, 5, 10, 15, 20, 25, 30, 35, 40, 45, 50, 55, 60, 65, 70, 75

PXIe-5667 (7 GHz) using the PXIe-5693 RF preselector filter path—0

PXIe-5668with PXIe-5698 with the NIRFSA_ATTR_RF_PREAMP_ENABLED attribute set to NIRFSA_VAL_RF_PREAMP_ENABLED—5

Default Value: N/A

Supported Devices: PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_DEVICE_CONFIGURATION_TEMPERATURE

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the temperature, in degrees Celsius, that NI-RFSA uses to calculate the device configuration settings.

Note Note  For most applications, you can choose not to set this attribute, so NI-RFSA uses the device temperature to calculate best attenuation settings. Set this attribute only if you want NI-RFSA to maintain the same device configuration settings from acquisition to acquisition, independent of device temperature changes.
PXIe-5820/5830/5831/5832/5840/5841—This attribute is read-only.

Units: degrees Celsius

Default Value: N/A

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5694, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_RF_ATTENUATION_STEP_SIZE

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the step size for the RF attenuation level. The actual RF attenuation is coerced up to the next highest multiple of this step size. You can also set this value to change the step size for the device within the supported device precision and configuration.

PXI-5600—The device configuration supports only the following attenuation step size values: 10, 20, 30, 40, and 50.

PXIe-5601—The attenuation is calculated based on the actual calibrated value closest to the desired value, so the step size varies as the actual gain values vary between consecutive attenuation settings.

PXIe-5603—The device configuration supports attenuation changes in 1 dB steps.

PXIe-5605—The available attenuation step size depends on the specified center frequency. In the high band signal path (input frequencies greater than 3.6 GHz), the only available attenuation is the step attenuator that you can change in 5 dB steps. In the low band signal path (input frequencies less than or equal to 3.6 GHz), an additional 31 dB of solid-state attenuation is available in 1 dB steps. The 5 dB default value indicates that, even when in the low band signal path, NI-RFSA changes the attenuation in 5 dB steps using only the mechanical attenuator. You can use this attribute to affect when the device changes the attenuation settings. To use the solid-state attenuation in the low band signal path, change the step size to a value other than a multiple of 5 (for example, a step size of 1 dB). If you use a value other than a multiple of 5 while in the high band of the PXIe-5605, NI-RFSA returns an error.

Units: dB

Valid Values:

PXI-5600/5661—10, 20, 30, 40, and 50

PXIe-5601/5663/5663E—0.0 to 93.0, continuous

PXIe-5603/5665 (3.6 GHz)—1.0 to 74.0, in 1 dB steps

PXIe-5605/5665 (14 GHz) (low band), PXIe-5606/5668 (low band)—1.0 to 106.0, in 1 dB steps

PXIe-5605/5665 (14 GHz) (high band), PXIe-5606/5668 (high band)—5.0 to 75.0, in 5 dB steps

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector low frequency bypass path—1.0 to 74.0, in 1 dB steps

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector filter path— 1.0

PXIe-5667 (7 GHz) using the PXIe-5693 preselector low frequency bypass path— 1.0 to 106.0 in 1 dB steps

PXIe-5667 7 GHz) using the PXIe-5693 RF preselector filter path— 1.0

Default Value:

PXI-5600/5661—10.0

PXIe-5601/5663/5663E—0.0

PXIe-5603/5665 (3.6 GHz)—1.0

PXIe-5605/5665 (14 GHz), PXIe-5606/5668—5.0

PXIe-5667—1.0

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXI-5661, PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_OSP_DATA_SCALING_FACTOR

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the scaling factor applied to the time-domain voltage data in the IF digitizer. Use this attribute to maximize the dynamic range of the digitizer by increasing the maximum IF power the digitizer can measure without creating OSP overflows.

Because of the device amplitude response, some wide-band signals normally attenuated by the downconverter go through the IF digitizer without causing an ADC overflow. During IF equalization, these wide-band digitizer input signals may become amplified. These amplified input signal values overflow the available numeric range used in the signal processing algorithm.

You can use this attribute when OSP calculations would generate an overflow while applying digital filters to the data. The OSP module in the digitizer multiplies the time-domain signal amplitude, in volts, by the specified attribute value before further onboard processing. Set this attribute to a value less than 1 to avoid OSP overflow for near full-scale IF signals and to use the maximum dynamic range of the digitizer. NI-RFSA compensates for the specified OSP data scaling factor to ensure that the correct scaled data, in absolute levels, is always returned regardless of the value of this attribute.

Valid Values: 0.25 to 1.0

Default Values:

PXI-5661, PXIe-5663/5663E/5665 (3.6 GHz)/5667 (3.6 GHz)/5668, PXIe-5820/5830/5831/5832/5840/5841—1.0

PXIe-5665 (14 GHz)/5667 (7 GHz)—0.8

Supported Devices: PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_OVERFLOW_ERROR_REPORTING

Specific Attribute

Data
type		 Access High Level Functions
ViInt32 R/W None

Description

Configures error reporting for ADC and onboard signal processing overflows. Overflows lead to clipping of the waveform.

Defined Values:

NIRFSA_VAL_ERROR_REPORTING_WARNING (1301) Configures NI-RFSA to return a warning when an ADC or onboard signal processing (OSP) overflow occurs.
NIRFSA_VAL_ERROR_REPORTING_DISABLED (1302) Configures NI-RFSA to not return an error or a warning when an ADC or OSP overflow occurs.
Default Value: NIRFSA_VAL_ERROR_REPORTING_WARNING

Supported Devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_MINIMUM_ACPR

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the minimum adjacent channel power ratio (ACPR), in dB, relative to the main channel reference level. This attribute configures NI-RFSA to optimize downconverter gain to measure a lower-power adjacent channel, adding gain only after filtering the main channel. The gain NI-RFSA applies is always less than or equal to the ACPR value you specify.

Note Note  For the PXIe-5665 (3.6 GHz), this attribute is supported only if you set the NIRFSA_ATTR_DEVICE_INSTANTANEOUS_BANDWIDTH, NIRFSA_ATTR_SPECTRUM_SPAN, or NIRFSA_ATTR_IF_FILTER_BANDWIDTH attribute to a value less than 300 kHz. For the PXIe-5665 (14 GHz), this attribute is supported for NIRFSA_ATTR_DEVICE_INSTANTANEOUS_BANDWIDTH, NIRFSA_ATTR_SPECTRUM_SPAN, or NIRFSA_ATTR_IF_FILTER_BANDWIDTH attribute values less than 300 kHz by using the 300 kHz IF filter, and it is supported for values between 300 kHz and 5 MHz by using the 5 MHz IF filter.
Note Note  NI-RFSA coerces this attribute to zero for the PXI-5600, PXIe-5601 and the PXIe-5667. For all other devices, read the coerced value of this attribute to determine the actual amount of gain applied.
Note Note  For the PXIe-5668, this attribute alters the NIRFSA_ATTR_IF_OUTPUT_POWER_LEVEL attribute. This attribute will not affect the NIRFSA_ATTR_REFERENCE_LEVEL attribute.
Default Value: 0

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXI-5661, PXIe-5663/5663E/5665/5667/5668

NIRFSA_ATTR_RF_PREAMP_ENABLED

Specific Attribute

Data
type		 Access High Level Functions
ViInt32 R/W None

Description

Specifies whether the RF preamplifier is enabled in the system.

PXIe-5667, PXIe-5644/5645/5646, PXIe-5830/5831/5840/5841—The NIRFSA_VAL_RF_PREAMP_AUTOMATIC value enables the RF preamplifier based on the value of the NIRFSA_ATTR_REFERENCE_LEVEL attribute and the center frequency. Except on the PXIe-5830/5831/5832, NI-RFSA coerces this attribute from NIRFSA_VAL_RF_PREAMP_AUTOMATIC to the selected value.

Note Note  For the PXIe-5840/5841, the automatically selected value may not be optimal for all measurements. At some reference levels, NIRFSA_VAL_RF_PREAMP_ENABLED may improve the noise floor while NIRFSA_VAL_RF_PREAMP_DISABLED may improve distortion.
PXIe-5667—The NIRFSA_VAL_RF_PREAMP_AUTOMATIC value is supported only when the NIRFSA_ATTR_LOW_FREQUENCY_BYPASS_ENABLED attribute is set to NIRFSA_VAL_DISABLED. If the reference level is greater than -25 dBm, NI-RFSA disables the preamplifier. If the reference level is less than or equal to -25 dBm, NI-RFSA sets the NIRFSA_ATTR_RF_PREAMP_ENABLED attribute to NIRFSA_VAL_RF_PREAMP_ENABLED_WHEN_IN_SIGNAL_PATH.

PXIe-5668 with PXIe-5698—If you set this attribute to NIRFSA_ATTR_RF_PREAMP_ENABLED, only the preamplifier on the PXIe-5698 is used, and the preamplifier on the PXIe-5668 remains disabled.

Defined Values:

NIRFSA_VAL_RF_PREAMP_DISABLED (2500) Disables the RF preamplifier.
NIRFSA_VAL_RF_PREAMP_ENABLED_WHEN_IN_SIGNAL_PATH (2501) Enables the RF preamplifier when the RF preamplifier is present in the signal path and disables the preamplifier when it is not in the signal path. Only devices with an RF preamplifier on the downconverter and an RF preselector support this option. Use the NIRFSA_ATTR_RF_PREAMP_PRESENT attribute to determine whether the downconverter has a preamplifier.
NIRFSA_VAL_RF_PREAMP_ENABLED (2502) Enables the RF preamplifier. If the RF preamplifier is not in a signal path, NI-RFSA returns an error. Select the NIRFSA_VAL_RF_PREAMP_ENABLED_WHEN_IN_SIGNAL_PATH value whenever possible to avoid an error.
NIRFSA_VAL_RF_PREAMP_AUTOMATIC (2503) Automatically enables the RF preamplifier based on the value of the NIRFSA_ATTR_REFERENCE_LEVEL attribute. This value is valid only for the PXIe-5644/5645/5646, PXIe-5667, and PXIe-5830/5831/5832/5840/5841.
Default Value:

PXIe-5644/5645/5646, PXIe-5830/5831/5832/5840/5841: NIRFSA_VAL_RF_PREAMP_AUTOMATIC

All other devices: NIRFSA_VAL_RF_PREAMP_DISABLED

Supported Devices: PXI-5600, PXIe-5601/5603/5605/5606 (external digitizer mode), PXIe-5644/5645/5646, PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5693/5698, PXIe-5830/5831/5832/5840/5841

NIRFSA_ATTR_AMPLITUDE_SETTLING

Data
type		 Access Coercion High Level Functions
ViReal64 R/W None None

Description

Configures the amplitude settling accuracy in decibels. NI-RFSA waits until the RF power settles within the specified accuracy level after calling the niRFSA_Initiate function.

Any specified amplitude settling value that is above the acceptable minimum value is coerced down to the closest valid value.

Units: dB

Default Value: 0.5

Supported Devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_DIGITAL_GAIN

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the scaling factor applied to the time-domain voltage data in the digitizer. NI-RFSA does not compensate for the specified digital gain.

You can use this attribute to account for external gain changes without changing the analog signal path.

Note Note  The PXIe-5644/5645/5646 applies this gain when the data is scaled. The raw data does not include this scaling on these devices.
Units: dB

Default Value: 0 dB

Supported Devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841

NIRFSA_ATTR_THERMAL_CORRECTION_HEADROOM_RANGE

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the expected thermal operating range of the instrument from the self-calibration temperature, in degrees Celsius, returned from the NIRFSA_ATTR_DEVICE_TEMPERATURE attribute.

For example, if this property is set to 5.0, and the device is self-calibrated at 35 °C, then you can expect to run the device from 30 °C to 40 °C with corrected accuracy and no overflows. Setting this property with a smaller value can result in improved dynamic range, but you must ensure thermal stability while the instrument is running. Operating the instrument outside of the specified range may cause degraded performance and ADC or DSP overflows.

Units: degrees Celsius (°C)

Default Value:

PXIe-5830/5831/5832: 5

PXIe-5840/5841: 10

Supported Devices: PXIe-5830/5831/5832/5840/5841

NIRFSA_ATTR_THERMAL_CORRECTION_TEMPERATURE_RESOLUTION

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 R/W None

Description

Specifies the temperature change required before NI-RFSA recalculates the thermal correction settings when entering the Running state.

Units: degrees Celsius (°C)

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Default Values:

PXIe-5830/5831/5832: 0.2

PXIe-5840/5841: 1.0

NI 5663

NIRFSA_ATTR_MECHANICAL_ATTENUATOR_ENABLED

Specific Attribute

Data
type		 Access High Level Functions
ViInt32 R/W None

Description

Specifies whether the mechanical attenuator is enabled. Set this attribute to NIRFSA_VAL_ENABLED to allow NI-RFSA to use the mechanical attenuator.

Disabling this attenuator can improve device performance. Refer to PXIe-5663/5663E Programming Attenuation for more information about the attenuators.

Defined Values:

NIRFSA_VAL_DISABLED (1900) Disables the mechanical attenuator.
NIRFSA_VAL_ENABLED (1901) Enables the mechanical attenuator.
Default Value: NIRFSA_VAL_ENABLED

Supported Devices: PXIe-5601 (external digitizer mode), PXIe-5663/5663E

NI 5665

NIRFSA_ATTR_CHANNEL_COUPLING

Specific Attribute

Data
type		 Access High Level Functions
ViInt32 R/W None

Description

Specifies whether the RF IN connector is AC- or DC-coupled on the downconverter.

|!, the PXIe-5605 Front Panel and LEDs, the PXIe-5667 Block Diagram, or the PXIe-5668 Block Diagram topics in this help file. | | :- | :- |

Valid Values:

PXIe-5603/5665 (3.6 GHz)—NIRFSA_VAL_AC, NIRFSA_VAL_DC

PXIe-5605/5665 (14 GHz)—NIRFSA_VAL_AC, NIRFSA_VAL_DC

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector low-frequency bypass path—NIRFSA_VAL_AC, NIRFSA_VAL_DC

PXIe-5667 (3.6 GHz) using the PXIe-5693 RF preselector filter path—NIRFSA_VAL_AC

PXIe-5667 (7 GHz)—NIRFSA_VAL_AC

PXIe-5606/5668—NIRFSA_VAL_AC, NIRFSA_VAL_DC

Defined Values:

NIRFSA_VAL_AC (3001) Specifies that the RF input channel is AC-coupled. For low frequencies (<10 MHz), accuracy decreases because NI-RFSA does not calibrate the configuration.
NIRFSA_VAL_DC (3002) Specifies that the RF input channel is DC-coupled. NI-RFSA enforces a minimum RF attenuation for device protection.
Default Value: NIRFSA_VAL_AC

Supported Devices: PXIe-5603/5605/5606 (external digitizer mode), PXIe-5665/5667/5668

NI 5693

NIRFSA_ATTR_CAL_TONE_POWER_REFERRED_TO_RF_IN

Specific Attribute

Data
type		 Access High Level Functions
ViReal64 RO None

Description

Returns the power of a virtual signal connected to the RF IN connector on the PXIe-5693 front panel when the calibration tone is enabled.

You can enable a calibration tone for the PXIe-5693 by setting the NIRFSA_ATTR_RF_CONDITIONING_CAL_TONE_MODE attribute to NIRFSA_VAL_CAL_TONE_LOWBAND_RF or NIRFSA_VAL_CAL_TONE_HIGHBAND_RF.

Units: dBm

Default Value: N/A

Supported Devices: PXIe-5693

NI 5694

NIRFSA_ATTR_STEP_GAIN_ENABLED

Specific Attribute

Data
type		 Access High Level Functions
ViInt32 RO None

Description

Specifies whether to enable the step gain amplifier.

Defined Values:

NIRFSA_VAL_STEP_GAIN_DISABLED (3200) Disables the step gain amplifier.
NIRFSA_VAL_STEP_GAIN_ENABLED (3201) Enables the step gain amplifier.
Default Value: NIRFSA_VAL_STEP_GAIN_DISABLED

Supported Devices: PXIe-5694

Table of Contents

Home

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally