rfsa c api reference

NIRFSA_ATTR_EXTERNAL_GAIN

  • Updated2024-05-08
  • 2 minute(s) read

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

Log in to get a better experience