ni5690 Get Actual Gain

NI RF Signal Conditioning Devices Help (NI-5690 14.5)

Edition Date: March 2015

Part Number: 371326D-01

»View Product Info
Download Help (Windows Only)

Returns the actual gain (in dB) applied to the input signal for the channel and frequency you specify. If you want to retain the previous state of the device, do not call the ni5690 Get Actual Gain VI before you call the ni5690 Configure Path VI or the ni5690 Configure Gain VI.

For the NI 5695, when you call the ni5690 Get Actual Gain VI before the ni5690 Configure Path VI for CH 0, CH 0 reinitializes to a default state (Main Path). When you call the ni5690 Get Actual Gain VI before the ni5690 Configure Gain VI for CH 1, CH 1 reinitializes to its default state (maximum attenuation).

For the NI 5690 and NI 5691, when you call the ni5690 Get Actual Gain VI before the ni5690 Configure Path VI or the ni5690 Configure Gain VI for CH 1, CH 1 reinitializes to its default state (maximum gain and Main Path). Additionally, if you call the ni5690 Configure Path VI before you call the ni5690 Configure Gain VI, CH 1 reinitializes to the default state for the path (Main Path).

instrument handle identifies your instrument session. instrument handle was obtained from the ni5690 Initialize VI and identifies a particular instrument session.
channel name specifies the channel in which the actual gain is applied. Default value is 0.
frequency specifies the frequency of the RF signal in Hz. Default value is 100 MHz.
/images/reference/en-XX/help/371326D-01/cerrcodeclst.gif error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
instrument handle out passes a reference to your instrument session to the next VI. instrument handle is obtained from the ni5690 Initialize VI and identifies a particular instrument session.
actual gain returns the gain applied in the specified channel name at the specified frequency at normal ambient temperature, in dB. For spectral measurements, subtract this gain from your calculated spectrum to remove the effect of the NI RF signal conditioning device on the measurements. For I/Q measurements, convert the gain to linear units and then apply the correction to the I/Q data. Negative values indicate attenuation.
/images/reference/en-XX/help/371326D-01/ierrcodeclst.gif error out contains error information. This output provides standard error out functionality.

WAS THIS ARTICLE HELPFUL?

Not Helpful