Enums
Enums used in NI-RFSA
AcquisitionType
Action
AdvanceTriggerDigitalEdgeEdge
AdvanceTriggerType
- class nirfsa.AdvanceTriggerType
- NONE
No Advance Trigger is configured.
- DIGITAL_EDGE
The Advance Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the
nirfsa.Session.digital_edge_advance_trigger_sourceproperty.
- SOFTWARE_EDGE
The Advance Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the
nirfsa.Session.send_software_edge_trigger()method and selectingNIRFSA_VAL_ADVANCE_TRIGGERas the trigger parameter.
AllowOutOfSpecificationUserSettings
ArmReferenceTriggerType
- class nirfsa.ArmReferenceTriggerType
- NONE
No Arm Reference Trigger is configured.
- DIGITAL_EDGE
The Arm Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the
nirfsa.Session.digital_edge_arm_ref_trigger_sourceproperty.
- SOFTWARE_EDGE
The Arm Reference Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the
nirfsa.Session.send_software_edge_trigger()method and selectingARM_REFas the trigger parameter.
CalToneMode
- class nirfsa.CalToneMode
- DISABLED
Disables the calibration tone for the associated signal path.
- CAL_TONE_LOWBAND_RF
Injects the calibration tone into the low band RF signal path.
- CAL_TONE_HIGHBAND_RF
Injects the calibration tone into the high band RF signal path.
- CAL_TONE_HIGHBAND_IF
Injects the calibration tone into the high band IF signal path.
- CAL_TONE_LOWBAND_RF_WITHOUT_ALC
Injects the calibration tone into the low band RF signal path, bypassing the ALC.
- CAL_TONE_COMB_GENERATOR
Injects the calibration tone into the high band RF signal path through the Comb Generator.
CalibrateStep
- class nirfsa.CalibrateStep
- IF_ATTENUATION
Initializes the IF Attenuation Calibration step. This step is not supported for the PXIe-5693.
- IF_RESPONSE
Initializes the IF Response Calibration step. This step is not supported for the PXIe-5603/5605 or PXIe-5693/5698.
- IF_REF_LEVEL
Initializes the Ref Level Calibration step. This step is not supported on the PXIe-5694.
- LO_EXPORT
Initializes the LO Export Calibration step. This step calibrates the output power of each LO to be within specification. This step is not supported on the PXIe-5601 or the PXIe-5693/5694/5698.
- GAIN_REFERENCE
Initializes the Gain Reference Calibration step. This step calibrates the calibration tone amplitude across supported calibration tone frequencies. This step is not supported on the PXIe-5601/5603/5605 or PXIe-5694.
ChannelCoupling
- class nirfsa.ChannelCoupling
- AC
Specifies that the RF input channel is AC-coupled. For low frequencies (<10 MHz), accuracy decreases because NI-RFSA does not calibrate the configuration.
- DC
Specifies that the RF input channel is DC-coupled. NI-RFSA enforces a minimum RF attenuation for device protection.
ConditioningCalToneMode
DeembeddingType
- class nirfsa.DeembeddingType
- NONE
De-embedding is not applied to the measurement.
- SCALAR
De-embeds the measurement using only the gain term.
- VECTOR
De-embeds the measurement using the gain term and the reflection term.
- AMPLITUDE_FLATNESS
De-embeds the measurement using wideband amplitude flatness correction.
DeviceResponseType
- class nirfsa.DeviceResponseType
- DOWNCONVERTER_IF
Returns the IF response of the downconverter.
- DOWNCONVERTER_RF
Returns the RF response of the downconverter. This value is supported only for the PXIe-5603/5605/5665/5667/5693..
- DOWNCONVERTER_COMBINED
Returns the combined RF and IF response of the downconverter. The combined response is in terms of IF frequency. This value is supported only for the PXIe-5603/5605/5665/5667.
- VSA_IF
Returns the IF response of the entire NI-RFSA device. This value is supported only for the PXIe-5665/5667.
- VSA_COMBINED
Returns the combined IF and RF response of the entire NI-RFSA device. The combined response is in terms of IF frequency. This value is supported only for the PXIe-5665/5667.
DigitizerDitherEnabled
DigitizerSampleClockExportedTerminal
- class nirfsa.DigitizerSampleClockExportedTerminal
- NONE
The Reference Clock is not exported. This value is not valid for the PXIe-5644/5645/5646.
- CLK_OUT
Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.
DigitizerSampleClockTimebaseSource
- class nirfsa.DigitizerSampleClockTimebaseSource
- ONBOARD_CLOCK
The digitizer uses its onboard clock as the Sample Clock timebase.
- CLK_IN
The digitizer uses the signal present on the CLK IN connector as the Sample Clock timebase.
- LO_REF_CLK
The digitizer uses the signal generated on the 100 MHz REF OUT terminal on the PXIe-5653 as the Sample Clock timebase. This value is supported only for the PXIe-5665.
- PXI_STAR
The digitizer uses the signal present at the PXI star trigger line as the Sample Clock timebase. This value is not supported for the PXIe-5668.
- DOWNCONVERTER_LO2_OUT
The digitizer uses the signal present on the LO2 OUT connector on the downconverter as the Sample Clock timebase. This value is supported only for the PXIe-5668.
DownconverterFrequencyOffsetMode
- class nirfsa.DownconverterFrequencyOffsetMode
- AUTOMATIC
NI-RFSA places the downconverter center frequency outside of the signal bandwidth if the
nirfsa.Session.signal_bandwidthproperty has been set and can be avoided.
- ENABLED
NI-RFSA places the downconverter center frequency outside of the signal bandwidth if the
nirfsa.Session.signal_bandwidthproperty has been set and can be avoided. NI-RFSA returns an error if thenirfsa.Session.signal_bandwidthproperty has not been set, or if the signal bandwidth is too large.
- USER_DEFINED
NI-RFSA uses the offset that you specified with the
nirfsa.Session.downconverter_frequency_offsetornirfsa.Session.downconverter_center_frequencyproperties.
DownconverterLoopBandwidth
DownconverterPreselectorEnabled
- class nirfsa.DownconverterPreselectorEnabled
- DISABLED
Disables the preselector.
- ENABLED_WHEN_IN_SIGNAL_PATH
The preselector is automatically enabled when it is in the signal path and is automatically disabled when it is not in the signal path. Use the
nirfsa.Session.preselector_presentproperty to determine if the downconverter has an preselector.
- ENABLED
Enables the preselector. If the preselector is not in the signal path or if the preselector is not supported on the device, NI-RFSA returns an error. Select the
ENABLED_WHEN_IN_SIGNAL_PATHwhenever possible avoid an error.
EnableAttrVals
EnableRfPreamp
- class nirfsa.EnableRfPreamp
- DISABLED
Disables the RF preamplifier.
- ENABLED_WHEN_IN_SIGNAL_PATH
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.Session.rf_preamp_presentproperty to determine whether the downconverter has a preamplifier.
- ENABLED
Enables the RF preamplifier. If the RF preamplifier is not in a signal path, NI-RFSA returns an error. Select the
ENABLED_WHEN_IN_SIGNAL_PATHvalue whenever possible to avoid an error.
- AUTOMATIC
Automatically enables the RF preamplifier based on the value of the
nirfsa.Session.reference_levelproperty. This value is valid only for the PXIe-5644/5645/5646, PXIe-5667, and PXIe-5830/5831/5832/5840/5841.
ExportOutputTerminal
- class nirfsa.ExportOutputTerminal
- DO_NOT_EXPORT
The signal is not exported.
- CLK_OUT
Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.
- REF_OUT
Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.
- REF_OUT2
Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.
- PFI0
The trigger is received on PFI 0. For the PXIe-5841 with PXIe-5655, the trigger is received on the PXIe-5841 PFI 0.
- PFI1
The trigger is received on PFI 1.
- PXI_TRIG0
The trigger is received on PXI trigger line 0.
- PXI_TRIG1
The trigger is received on PXI trigger line 1.
- PXI_TRIG2
The trigger is received on PXI trigger line 2.
- PXI_TRIG3
The trigger is received on PXI trigger line 3.
- PXI_TRIG4
The trigger is received on PXI trigger line 4.
- PXI_TRIG5
The trigger is received on PXI trigger line 5.
- PXI_TRIG6
The trigger is received on PXI trigger line 6.
- PXI_TRIG7
The trigger is received on PXI trigger line 7.
- PXI_STAR
The trigger is received on the PXI star trigger line. This value is not valid for the PXIe-5644/5645/5646.
- PXIE_DSTARC
The trigger is received on the PXIe DStar C trigger line. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841.
- DIO_PFI0
The trigger is received on PFI0 from the front panel DIO terminal.
- DIO_PFI1
The trigger is received on PFI1 from the front panel DIO terminal.
- DIO_PFI2
The trigger is received on PFI2 from the front panel DIO terminal.
- DIO_PFI3
The trigger is received on PFI3 from the front panel DIO terminal.
- DIO_PFI4
The trigger is received on PFI4 from the front panel DIO terminal.
- DIO_PFI5
The trigger is received on PFI5 from the front panel DIO terminal.
- DIO_PFI6
The trigger is received on PFI6 from the front panel DIO terminal.
- DIO_PFI7
The trigger is received on PFI7 from the front panel DIO terminal.
FetchRelativeTo
- class nirfsa.FetchRelativeTo
- MOST_RECENT_SAMPLE
Fetching occurs relative to the most recently acquired data. The value of the
nirfsa.Session.fetch_offsetproperty must be negative.
- FIRST_SAMPLE
Fetching occurs at the first sample acquired by the device. If the device wraps its buffer, the first sample is no longer available. In this case, NI-RFSA returns an error if the fetch offset is in the overwritten data.
- REFERENCE_TRIGGER
Fetching occurs relative to the Reference Trigger. This value behaves like
FIRST_SAMPLEif no Reference Trigger is configured.
- FIRST_PRETRIGGER_SAMPLE
Fetching occurs relative to the first pretrigger sample acquired.
- CURRENT_READ_POSITION
Fetching occurs after the last fetched sample.
FrequencySettlingUnits
IFattenTableSel
- class nirfsa.IFattenTableSel
- STANDARD
Specifies that the standard IF attenuation table is used for the external calibration.
- ACPR
Specifies that the adjacent channel power ratio (ACPR) IF attenuation table is used for the external calibration. You can only select this value if you set the
nirfsa.Session.CAL_IF_FILTER_SELECTIONproperty toEXT_CAL_IF_FILTER_PATH_1orEXT_CAL_IF_FILTER_PATH_2.
IFfilter
IFfilterSelection
- class nirfsa.IFfilterSelection
- EXT_CAL_IF_FILTER_PATH_1
Specifies that the 5 MHz filter path is used during calibration.
- EXT_CAL_IF_FILTER_PATH_2
Specifies that the 300 kHz filter path is used during calibration. Not supported for the PXIe-5694.
- EXT_CAL_IF_FILTER_PATH_3
None of the IF filter paths are used during calibration.
- EXT_CAL_IF_FILTER_PATH_4
Specifies that the 20 MHz filter path is used during calibration.
- EXT_CAL_IF_FILTER_PATH_5
Specifies that the 1.4 MHz filter path is used during calibration.
- EXT_CAL_IF_FILTER_PATH_6
Specifies that the 400 kHz filter path is used during calibration.
- EXT_CAL_IF_FILTER_PATH_7
Specifies that the 110 kHz filter path is used during calibration.
- EXT_CAL_IF_FILTER_PATH_8
Specifies that the 30 kHz filter path is used during calibration.
IfConditioningDownConversionEnabled
InputIsolationEnabled
InputPort
IqInPortTerminalConfiguration
LinearInterpolationFormat
- class nirfsa.LinearInterpolationFormat
- MAGNITUDE_AND_PHASE
Results in a linear interpolation of the real portion of the complex number and a separate linear interpolation of the complex portion.
- MAGNITUDE_DB_AND_PHASE
Results in a linear interpolation of the magnitude and a separate linear interpolation of the phase.
- REAL_AND_IMAGINARY
Results in a linear interpolation of the magnitude, in decibels, and a separate linear interpolation of the phase.
Lo2ExportEnabled
LoInjection
- class nirfsa.LoInjection
- HIGH
Configures the LO signal that the NI-RFSA device generates at a frequency higher than the RF frequency. This LO frequency is given by the formula f<sub>LO</sub> = f<sub>RF</sub> + f<sub>IF</sub>.
- LOW
Configures the LO signal that the NI-RFSA device generates at a frequency lower than the RF frequency. This LO frequency is given by the formula f<sub>LO</sub> = f<sub>RF</sub> - f<sub>IF</sub>.
LoNumber
LoOutExportConfigureFromRfsg
LoPathSel
- class nirfsa.LoPathSel
- EXT_CAL_LO_PATH_1
Specifies that the LO path 1 is used.
- EXT_CAL_LO_PATH_2
Specifies that the LO path 2 is used.
- EXT_CAL_LO_PATH_3
Specifies that the LO path 3 is used.
- EXT_CAL_LO_PATH_4
Specifies that the LO path 4 is used.
- EXT_CAL_LO_PATH_5
Specifies that the LO path 5 is used.
LoPllFractionalModeEnabled
LoSource
- class nirfsa.LoSource
- NONE
Specifies that no LO source is required to downconvert the RF input signal.
- ONBOARD
Specifies that the onboard synthesizer is used to generate the LO signal that downconverts the RF input signal.**PXIe-5831/5832** This configuration uses the onboard LO of the PXIe-3622, using the LO2 stage.**PXIe-5831/5832 with PXIe-5653** This configuration uses the onboard LO of the PXIe-5653 when associated with the PXIe-3622.**PXIe-5841 with PXIe-5655** This configuration uses the onboard LO of the PXIe-5655.
- LO_IN
Specifies that the LO source used to downconvert the RF input signal is connected to the LO IN connector on the front panel.
- LO_SOURCE_SECONDARY
Uses the PXIe-5831/5840 internal LO as the LO source. This value is valid on only the PXIe-5831 with PXIe-5653 (LO1 stage only) or PXIe-5832 with PCIe-5653 (LO1 stage only).
- LO_SOURCE_SG_SA_SHARED
Uses the same internal LO during NI-RFSA and NI-RFSG sessions. NI-RFSA selects an internal synthesizer and the synthesizer signal is switched to both the RF Out and RF In mixers. This value is valid on only the PXIe-5830/5831/5832/5841 with PXIe-5655.
LoYigMainCoilDrive
LoadConfigurationResetOptions
NoiseSourcePowerEnabled
NotchFilterEnabled
- class nirfsa.NotchFilterEnabled
- DISABLED
Disables the notch filter.
- ENABLED_WHEN_IN_SIGNAL_PATH
The notch filter is automatically enabled when it is in the signal path and automatically disabled when it is not in the signal path.
- ENABLED
Enables the notch filter. If the notch filter is not in the signal path or if the notch filter is not supported on the device, NI-RFSA returns an error. Select
ENABLED_WHEN_IN_SIGNAL_PATHwhenever possible to avoid an error.
OutputTerm
- class nirfsa.OutputTerm
- DO_NOT_EXPORT
The signal is not exported.
- CLK_OUT
Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.
- REF_OUT
Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.
- REF_OUT2
Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.
- PFI0
The trigger is received on PFI 0. For the PXIe-5841 with PXIe-5655, the trigger is received on the PXIe-5841 PFI 0.
- PFI1
The trigger is received on PFI 1.
- PXI_TRIG0
The trigger is received on PXI trigger line 0.
- PXI_TRIG1
The trigger is received on PXI trigger line 1.
- PXI_TRIG2
The trigger is received on PXI trigger line 2.
- PXI_TRIG3
The trigger is received on PXI trigger line 3.
- PXI_TRIG4
The trigger is received on PXI trigger line 4.
- PXI_TRIG5
The trigger is received on PXI trigger line 5.
- PXI_TRIG6
The trigger is received on PXI trigger line 6.
- PXI_TRIG7
The trigger is received on PXI trigger line 7.
- PXI_STAR
The trigger is received on the PXI star trigger line. This value is not valid for the PXIe-5644/5645/5646.
- PXIE_DSTARB
The trigger is received on the PXIe DStar B trigger line. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841.
- DIO_PFI0
The trigger is received on PFI0 from the front panel DIO terminal.
- DIO_PFI1
The trigger is received on PFI1 from the front panel DIO terminal.
- DIO_PFI2
The trigger is received on PFI2 from the front panel DIO terminal.
- DIO_PFI3
The trigger is received on PFI3 from the front panel DIO terminal.
- DIO_PFI4
The trigger is received on PFI4 from the front panel DIO terminal.
- DIO_PFI5
The trigger is received on PFI5 from the front panel DIO terminal.
- DIO_PFI6
The trigger is received on PFI6 from the front panel DIO terminal.
- DIO_PFI7
The trigger is received on PFI7 from the front panel DIO terminal.
- TIMER_EVENT
The trigger is received from the Timer Event. This value is valid on only the PXIe-5820/5830/5831/5832/5840/5841, and for digital edge Advance Triggers on the PXIe-5663E/5665.
OverflowErrorReporting
PowerSpectrumUnits
PxiChassisClk10Source
- class nirfsa.PxiChassisClk10Source
- NONE
The device does not drive the PXI 10 MHz backplane Reference Clock.
- ONBOARD_CLOCK
The device drives the PXI 10 MHz backplane Reference Clock with the PXI-5600 onboard clock. You must connect the 10 MHz OUT connector to the PXI 10 MHz I/O connector on the PXI-5600 front panel to use this option.
- REF_IN
The device drives the PXI 10 MHz backplane Reference Clock with the reference source attached to the PXI-5600 FREQ REF IN connector. You must connect the 10 MHz OUT connector to the PXI 10 MHz I/O connector on the PXI-5600 front panel to use this option.
ReferenceClockExportedRate
ReferenceClockExportedTerminal
- class nirfsa.ReferenceClockExportedTerminal
- NONE
The Reference Clock is not exported. This value is not valid for the PXIe-5644/5645/5646.
- REF_OUT
Export the clock on the REF IN/OUT terminal on the PXI/PXIe-5652, the REF OUT terminals on the PXIe-5653, or the REF OUT terminal on the PXIe-5644/5645/5646, PXIe-5694, or PXIe-5820/5830/5831/5832/5840/5841.
- REF_OUT2
Export the clock on the REF OUT2 terminal on the PXIe-5652. This value is valid only for the PXIe-5663E.
- CLK_OUT
Export the clock on the CLK OUT terminal on the IF digitizer. This value is not valid for the PXIe-5644/5645/5646 or PXIe-5820/5830/5831/5832/5840/5841.
- IF_COND_REF_OUT
Export the clock on the REF OUT terminal on the PXIe-5694. This value is valid only for the PXIe-5667.
ReferenceClockSource
- class nirfsa.ReferenceClockSource
- NONE
No Reference Clock is required for the current device configuration. This value is valid only for the PXIe-5694 or the PXIe-5668.
- ONBOARD_CLOCK
**PXI-5661 **NI-RFSA locks the NI-RFSA device to the PXI-5600 RF downconverter onboard clock.**PXIe-5663/5663E **NI-RFSA locks the PXIe-5663/5663E to the PXI/PXIe-5652 LO source onboard clock. Connect the REF OUT2 connector (if it exists) on the PXI/PXIe-5652 to the CLK IN terminal on the PXIe-5622. On versions of the PXIe-5663/5663E that lack a REF OUT2 connector on the PXI/PXIe-5652, connect the REF IN/OUT connector on the PXI/PXIe-5652 to the CLK IN terminal on the PXI5622.**PXIe-5665 **NI-RFSA locks the PXIe-5665 to the PXIe-5653 LO source onboard clock. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622.**PXIe-5667 **NI-RFSA locks the PXIe-5667 to the PXIe-5653 LO source onboard clock. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622, and connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694.**PXIe-5668 **Lock the PXIe-5668 to the PXIe-5653 LO SOURCE onboard clock. Connect the LO2 OUT connector on the PXIe-5606 to the CLK IN connector on the PXIe-5624.**PXIe-5830/5831 **For the PXIe-5830, connect the PXIe-5820 REF IN connector to the PXIe-3621 REF OUT connector. For the PXIe-5831/5832, connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector.**PXIe-5831/5832 with PXIe-5653 **Connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXIe-3622 REF IN connector.**PXIe-5644/5645/5646, PXIe-5820/5840/5841 **Lock the NI-RFSA device to its onboard clock.**PXIe-5841 with PXIe-5655 **Lock to the PXIe-5655 onboard clock. Connect the REF OUT connector on the PXIe-5655 to the PXIe-5841 REF IN connector.**PXIe-5842 **Lock to the PXIe-5655 onboard clock. Cables between modules are required as shown in the User Manual for the instrument.**PXIe-5860 **Lock to the PXIe-5860 onboard clock.
- REF_IN
PXI-5661 **NI-RFSA locks the NI-RFSA device to the signal at the external FREQ REF IN connector on the PXI-5600**PXIe-5663/5663E **Connect the external signal to the PXI/PXIe-5652 REF IN/OUT connector. Connect the REF OUT2 connector (if it exists) on the PXI/PXIe-5652 to the CLK IN terminal on the PXIe-5622. On versions of the PXIe-5663/5663E that lack a REF OUT2 connector on the PXI/PXIe-5652, this configuration can only be used in external digitizer mode.**PXIe-5665 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622. If your external clock signal frequency is set to a frequency other than 10 MHz, set the :py:attr:`nirfsa.Session.ref_clock_rate` property according to the frequency of your external clock signal.**PXIe-5667 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the 100 MHz REF OUT terminal on the PXIe-5653 to the CLK IN terminal on the PXIe-5622, and connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694. If your external clock signal frequency is set to a frequency other than 10 MHz, set the :py:attr:`nirfsa.Session.ref_clock_rate` property according to the frequency of your external clock signal.**PXIe-5668 **Connect the external signal to the PXIe-5653 REF IN connector. Connect the LO2 OUT on the PXIe-5606 to the CLK IN connector on the PXIe-5622. If your external clock signal frequency is set to a frequency other than 10 MHz, set the **clock rate parameter according to the frequency of your external clock signal.**PXIe-5694 **Connect the Reference Clock signal to the REF/LO IN connector on the PXIe-5694 front panel.**PXIe-5644/5645/5646, PXIe-5820/5840/5841 **Lock the NI-RFSA device to the signal at the external REF IN connector.**PXIe-5830/5831 **For the PXIe-5830, connect the PXIe-5820 REF IN connector to the PXIe-3621 REF OUT connector. For the PXIe-5831, connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. For the PXIe-5830, lock the external signal to the PXIe-3621 REF IN connector. For the PXIe-5831/5832, lock the external signal to the PXIe-3622 REF IN connector.**PXIe-5831/5832 with PXIe-5653 **Connect the PXIe-5820 REF IN connector to the PXIe-3622 REF OUT connector. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXIe-3622 REF IN connector. Lock the external signal to the PXIe-5653 REF IN connector.**PXIe-5841 with PXIe-5655 **Lock to the signal at the REF IN connector on the associated PXIe-5655. Connect the REF OUT connector on the PXIe-5655 to the PXIe-5841 REF IN connector. **PXIe-5842 **Lock to the signal at the REF IN connector on the associated PXIe-5655. Cables between modules are required as shown in the User Manual for the instrument. PXIe-5860 Lock to the signal at the REF IN connector on the PXIe-5860.
- PXI_CLK
**PXI-5661 **NI-RFSA locks the NI-RFSA device to the PXI backplane clock using the PXI-5600. You must connect the PXI 10 MHz connector to the REF IN connector on the PXI-5600 front panel to use this option. **PXIe-5668 **Lock the PXIe-5653 to the PXI backplane clock. Connect the PXIe-5606 LO2 OUT to the LO2 IN connector on the PXIe-5624.**PXIe-5644/5645/5646, PXIe-5663/5663E/5665/5667, PXIe-5694, PXIe-5820/5830/5831/5831/5832 with PXIe-5653/5840/5840 with PXIe-5653/5841/5841 with PXIe-5655/5842/5860 **Lock the device to the PXI backplane clock.
- CLK_IN
PXI-5661 **This configuration does not apply to the PXI-5661.**PXIe-5663/5663E **NI-RFSA locks the PXIe-5663/5663E to an external 10 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the FREQ REF IN connector on the PXI/PXIe-5652.**PXIe-5665 **NI-RFSA locks the PXIe-5665 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the REF IN connector on the PXIe-5653. Set the :py:attr:`nirfsa.Session.ref_clock_rate` property to 100 MHz.**PXIe-5667 **NI-RFSA locks the PXIe-5667 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5622, and connect the PXIe-5622 CLK OUT connector to the REF IN connector on the PXIe-5653. Connect the 10 MHZ REF OUT terminal on the PXIe-5653 to the REF/LO IN connector on the PXIe-5694. Set the :py:attr:`nirfsa.Session.ref_clock_rate` property to 100 MHz.**PXIe-5668 **Lock the PXIe-5668 to an external 100 MHz signal. Connect the external signal to the CLK IN connector on the PXIe-5624, and connect the PXIe-5624 CLK OUT connector to the REF IN connector on the PXIe-5653. Set the **clock rate parameter to 100 MHz.**PXIe-5644/5645/5646, PXIe-5820/5830/5831/5831/5832 with PXIe-5653/5840/5840 with PXIe-5653/5841/5841 with PXIe-5655/5842/5860 **This configuration does not apply.
- PXI_CLK_MASTER
**PXIe-5831/5832 with PXIe-5653 **NI-RFSA configures the PXIe-5653 to export the Reference clock and configures the PXIe-5820 and PXIe-3622 to use PXI_Clk as the Reference Clock source. Connect the PXIe-5653 REF OUT (10 MHz) connector to the PXI chassis REF IN connector.**PXI-5661, PXIe-5663/5663E/5665/5667/5668, PXIe-5644/5645/5646, PXIe-5820/5840/5841/5841 with PXIe-5655 /5842/5860**This configuration does not apply.
ReferenceLevelDataType
ReferenceTriggerDigitalEdgeEdge
ReferenceTriggerIqPowerEdgeSlope
ReferenceTriggerOspDelayEnabled
ReferenceTriggerType
- class nirfsa.ReferenceTriggerType
- NONE
No Reference Trigger is configured.
- DIGITAL_EDGE
The Reference Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the
nirfsa.Session.digital_edge_ref_trigger_sourceproperty.
- IQ_POWER_EDGE
The Reference Trigger is asserted when the signal is changing past the level specified with the slope (rising or falling) configured with the
nirfsa.Session.iq_power_edge_ref_trigger_slopeproperty.
- SOFTWARE_EDGE
The Reference Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the
nirfsa.Session.send_software_edge_trigger()method and selectingNIRFSA_VAL_REF_TRIGGERas the trigger parameter.
- IQ_ANALOG_EDGE
The Reference Trigger is asserted when the I or Q signal is changed past the level specified with the slope configured with the
nirfsa.Session.IQ_ANALOG_EDGE_REF_TRIGGER_SLOPEproperty. This value is valid only for PXIe-5644/5645 devices.
ResetWithOptionsStepsToOmit
- class nirfsa.ResetWithOptionsStepsToOmit
- DEEMBEDDING_TABLES
Omits deleting de-embedding tables. This step is valid only for the PXIe-5830/5831/5832/5840.
- NONE
No step is omitted during reset.
- ROUTES
Omits the routing reset step. Routing is preserved after a reset. However, routing related properties are reset to default, and routing is released if the default properties are committed after a reset.
RfLbSigCondPathSel
RfOutLoExport
RfPathSelection
- class nirfsa.RfPathSelection
- EXT_CAL_RF_BAND_1
The data is the default configuration data.
- EXT_CAL_RF_BAND_2
The data is the configuration data when the mechanical relay is disabled. Use this option to save uncalibrated measurements for more advanced operations.
- EXT_CAL_RF_BAND_3
The data is the default configuration data.
- EXT_CAL_RF_BAND_4
The data is the default configuration data.
SelfCalSteps
- class nirfsa.SelfCalSteps
- DIGITIZER_SELF_CAL
Omits the Image Suppression step. If you omit this step, the Residual Sideband Image performance is not adjusted.
- PRESELECTOR_ALIGNMENT
Omits the LO Self Cal step. If you omit this step, the power level of the LO is not adjusted.
- OMIT_NONE
No calibration steps are omitted.
- GAIN_REFERENCE
Omits the Power Level Accuracy step. If you omit this step, the power level accuracy of the device is not adjusted.
- IF_FLATNESS
Omits the Residual LO Power step. If you omit this step, the Residual LO Power performance is not adjusted.
- LO_SELF_CAL
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- AMPLITUDE_ACCURACY
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- RESIDUAL_LO_POWER
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- IMAGE_SUPPRESSION
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- SYNTHESIZER_ALIGNMENT
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- DC_OFFSET
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
SelfCalibrateRangeStepsToOmit
- class nirfsa.SelfCalibrateRangeStepsToOmit
- DIGITIZER_SELF_CAL
Omits the Image Suppression step. If you omit this step, the Residual Sideband Image performance is not adjusted.
- PRESELECTOR_ALIGNMENT
Omits the LO Self Cal step. If you omit this step, the power level of the LO is not adjusted.
- OMIT_NONE
No calibration steps are omitted.
- GAIN_REFERENCE
Omits the Power Level Accuracy step. If you omit this step, the power level accuracy of the device is not adjusted.
- IF_FLATNESS
Omits the Residual LO Power step. If you omit this step, the Residual LO Power performance is not adjusted.
- LO_SELF_CAL
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- AMPLITUDE_ACCURACY
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- RESIDUAL_LO_POWER
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- IMAGE_SUPPRESSION
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- SYNTHESIZER_ALIGNMENT
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
- DC_OFFSET
Omits the Voltage Controlled Oscillator (VCO) Alignment step. If you omit this step, the LO PLL is not adjusted.
SelfCalibrationStep
- class nirfsa.SelfCalibrationStep
- PRESELECTOR_ALIGNMENT
Calls for preselector alignment.
- GAIN_REFERENCE
Measures the changes in gain since the last external calibration was run.
- IF_FLATNESS
Measures the IF response of the entire system for each of the supported IF filters
- DIGITIZER_SELF_CAL
Calls for digitizer self-calibration, if the digitizer is associated with the RF downconverter.
- LO_SELF_CAL
Calls for LO self-calibration, if the LO source module is associated with the RF downconverter.
- AMPLITUDE_ACCURACY
Selects the Amplitude Accuracy self-calibration step.
- RESIDUAL_LO_POWER
Selects the Residual LO Power self-calibration step.
- IMAGE_SUPPRESSION
Selects the Image Suppression self-calibration step.
- SYNTHESIZER_ALIGNMENT
Selects the Synthesizer Alignment self-calibration step.
- DC_OFFSET
Selects the DC Offset self-calibration step.
Signal
- class nirfsa.Signal
- START_TRIGGER
NI-RFSA routes a Start Trigger.
- REF_TRIGGER
NI-RFSA routes a Reference
- ADVANCE_TRIGGER
NI-RFSA routes an Advance
- READY_FOR_START_EVENT
NI-RFSA routes a Ready for Start Event.
- READY_FOR_REF_EVENT
NI-RFSA routes a Ready for Reference Event..
- END_OF_RECORD_EVENT
NI-RFSA routes a End of Record Event.
- DONE_EVENT
NI-RFSA routes a Done Event.
- REF_CLOCK
NI-RFSA routes a Reference Clock.
- USER
NI-RFSA routes a User Defined Signal.
SignalConditioningEnabled
SmoothSpectrumEnabled
SoftwareTriggerType
SparameterOrientation
SpectrumAveragingMode
- class nirfsa.SpectrumAveragingMode
- NO
Configures NI-RFSA to perform no averaging on acquisitions.
- RMS
Configures NI-RFSA for root-mean-square (RMS) averaging. RMS averaging reduces signal fluctuations but not the noise floor. RMS averaging averages the energy, or power, of the signal. This averaging prevents noise floor reduction and gives averaged RMS quantities of single-channel measurements zero phase. RMS averaging for dual-channel measurements preserves important phase information.
- VECTOR
Configures NI-RFSA for vector averaging. Vector averaging reduces noise from synchronous signals. Vector averaging computes the average of complex quantities directly, which means that it allows separate averaging for real and imaginary parts. Complex averaging such as vector averaging reduces noise and usually requires a trigger to improve block-to-block phase coherence.
- PEAK_HOLD
Configures NI-RFSA for peak-hold averaging. Peak-hold averaging retains the RMS peak levels of the averaged quantities. The peak-hold averaging process performs peak-hold at each frequency bin separately to retain peak RMS levels from one FFT record to the next.
- MIN_HOLD
Configures NI-RFSA to perform no averaging on acquisitions.
- SCALAR
Configures NI-RFSA to perform no averaging on acquisitions.
- LOG
Configures NI-RFSA to perform no averaging on acquisitions.
SpectrumFftWindowType
- class nirfsa.SpectrumFftWindowType
- UNIFORM
No window is applied.
- HANNING
The Hanning window is useful for analyzing transients longer than the time duration of the window, and also for general-purpose applications.
- HAMMING
A Hamming window is applied to the waveform using the following equation: y[i] = x[i] * (0.54 - 0.46cos(w)) where w = (2)i/n and n = the waveform size. Note: Hanning and Hamming windows are somewhat similar. However, in the time domain, the Hamming window does not get as close to zero near the edges as does the Hanning window.
- BLACKMAN_HARRIS
A Blackman-Harris window is applied to the waveform using the following equation: y[i] = x[i] * (0.42323 - 0.49755*cos(w) + 0.07922*cos(2w))
- EXACT_BLACKMAN
An Exact Blackman window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w))
- BLACKMAN
A Blackman window is useful for analyzing transient signals, and provides similar windowing to Hanning and Hamming windows but adds one additional cosine term to reduce ripple. A Blackman window is applied to the waveform using the following equation: y[i] = x[i] * (0.42 - 0.50*cos(w) + 0.08*cos(2w))
- FLAT_TOP
The fifth-order Flat Top window has the best amplitude accuracy of all the window methods. The increased amplitude accuracy (0.02 dB for signals exactly between integral cycles) is at the expense of frequency selectivity. The Flat Top window is most useful in accurately measuring the amplitude of single frequency components with little nearby spectral energy in the signal. A fifth-order Flat Top window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w) + a4*cos(4w))
- _4_TERM_BLACKMAN_HARRIS
A 4-term Blackman-Harris window is a general purpose window; it has side-lobe rejection in the upper 90 dB, with moderately wide side lobe. A 4-term Blackman Harris window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w))
- _7_TERM_BLACKMAN_HARRIS
A 7-term Blackman-Harris window has the highest dynamic range; it is ideal for signal-to-noise ratio applications. A 7-term Blackman Harris window is applied to the waveform using the following equation: y[i] = x[i] * (a0 - a1*cos(w) + a2*cos(2w) - a3*cos(3w) + a4*cos(4w) - a5*cos(5w) + a6*cos(6w))
- LOW_SIDE_LOBE
The Low Side Lobe window further reduces the size of the main lobe. The following equation defines the Low Side Lobe window. where N is the length of window
- GAUSSIAN
A Gaussian window is applied to the waveform using the following equation: y[i] = x[i] * exp(-0.5*(i - (N-1)/2)^2 / ((N-1)/2)^2) where N is the length of the window
- KAISER_BESSEL
A Kaiser-Bessel window is applied to the waveform using the following equation: y[i] = x[i] * I0(β*sqrt(1 - (2i/(N-1) - 1)^2))/I0(β) where i is between 0 and N-1, N is the length of the window, β determines the shape of the window, and I0 is the zeroth order Modified Bessel method of the first kind
SpectrumResolutionBandwidthType
- class nirfsa.SpectrumResolutionBandwidthType
- THREE_DECIBELS
Defines the resolution bandwidth (RBW) in terms of the 3 dB bandwidth of the window specified by the
nirfsa.Session.fft_window_typeproperty.
- SIX_DECIBELS
Defines the RBW in terms of the 6 dB bandwidth of the window specified by the
nirfsa.Session.fft_window_typeproperty.
- BIN_WIDTH
Defines the RBW in terms of the display resolution, which is the ratio of the sampling frequency to the number of samples that you acquire.
- EQUIVALENT_NOISE_BANDWIDTH
Defines the RBW in terms of the equivalent noise bandwidth (ENBW) of the window specified by the
nirfsa.Session.fft_window_typeproperty.
StartTriggerDigitalEdgeEdge
StartTriggerType
- class nirfsa.StartTriggerType
- NONE
No Start Trigger is configured.
- DIGITAL_EDGE
The Start Trigger is not asserted until a digital edge is detected. The source of the digital edge is specified with the
nirfsa.Session.digital_edge_start_trigger_sourceproperty.
- SOFTWARE_EDGE
The Start Trigger is not asserted until a software trigger occurs. You can assert the software trigger by calling the
nirfsa.Session.send_software_edge_trigger()method and selectingNIRFSA_VAL_START_TRIGGERas the value of the trigger parameter.
StepsToOmit
- class nirfsa.StepsToOmit
- DEEMBEDDING_TABLES
Omits deleting de-embedding tables. This step is valid only for the PXIe-5830/5831/5832/5840.
- NONE
No step is omitted during reset.
- ROUTES
Omits the routing reset step. Routing is preserved after a reset. However, routing related properties are reset to default, and routing is released if the default properties are committed after a reset.