NIRfsgPlayback Class
- Updated2023-02-21
- 16 minute(s) read
Provides methods to generate the waveforms saved in a TDMS file using the NI-RFSG driver.
Inheritance Hierarchy
Namespace: NationalInstruments.ModularInstruments.NIRfsgPlayback
Assembly: NationalInstruments.ModularInstruments.NIRfsgPlayback.Fx40 (in NationalInstruments.ModularInstruments.NIRfsgPlayback.Fx40.dll) Version: 23.0.0.49313 (23.0.0.49313)
Syntax
public static class NIRfsgPlayback
Public NotInheritable Class NIRfsgPlayback
The NIRfsgPlayback type exposes the following members.
Methods
| Name | Description | |||||||
|---|---|---|---|---|---|---|---|---|
  | ClearAllWaveforms |
Deletes the waveforms from the NI-RFSG device memory and removes all the waveform properties from the NI-RFSG waveform properties database for the specified device.
| ||||||
| ClearWaveform |
Deletes the waveform from the NI-RFSG device memory and removes the waveform properties from the NI-RFSG waveform properties database for the specified device.
| ||||||
| DownloadUserWaveform(IntPtr, String, ComplexWaveformComplexDouble, Boolean) |
Normalizes the input waveform and writes it into the NI RF vector signal generator. This VI computes the peak to average power ratio (PAPR) using the bursts in the waveform, stores the PAPR, sample rate, waveform size, and runtime scaling value of -1.5 dB in the NI-RFSG waveform database. | ||||||
| DownloadUserWaveform(IntPtr, String, ComplexWaveformComplexSingle, Boolean) |
Normalizes the input waveform and writes it into the NI RF vector signal generator. This VI computes the peak to average power ratio (PAPR) using the bursts in the waveform, stores the PAPR, sample rate, waveform size, and runtime scaling value of -1.5 dB in the NI-RFSG waveform database. | ||||||
| ReadAndDownloadWaveformFromFile |
Reads a waveform from a TDMS file, and downloads it to the NI RF vector signal generator.
This method reads the following information from the TDMS file and writes it into the NI-RFSG waveform database:
If RF blanking marker locations are present in the file, but burst locations are not present, burst locations are calculated from RF blanking marker locations and stored in the NI-RFSG waveform database. This method internally sets the RfsgRF.PowerLevelType property value to PeakPower before writing the waveform to NI-RFSG device memory. This method completes this tasks for each NI-RFSG session. This method returns an error, if the TDMS file has more than one waveform. | ||||||
| ReadAndDownloadWaveformsFromFile | Reads the waveforms from a TDMS file, and downloads one waveform into each of the NI RF vector signal generators. The first waveform in the TDMS file is downloaded to the first NI RF vector signal generator and so on, until all the waveforms are downloaded. This method reads the following information from the TDMS file and writes it into the NI-RFSG waveform database:
If RF blanking marker locations are present in the file, but burst locations are not present, burst locations are calculated from RF blanking marker locations and stored in the NI-RFSG waveform database. This method internally sets the RfsgRF.PowerLevelType property value to PeakPower before writing the waveform to NI-RFSG device memory. This method completes this tasks for each NI-RFSG session. This method returns an error, if the number of waveforms in the TDMS file does not match the number of RFSG sessions. | ||||||
| ReadBurstStartLocationsFromFile |
Returns the RF burst start locations stored in the file. This method uses the waveformIndex
as the key to read the waveform property.
| ||||||
| ReadBurstStopLocationsFromFile |
Returns the RF burst stop locations stored in the file. This method uses the waveformIndex
as the key to read the waveform property.
| ||||||
| ReadPaprFromFile |
Returns the peak to average power ratio (PAPR) stored in the file. This method uses the waveformIndex as the key to read the waveform property.
| ||||||
| ReadPeakPowerAdjustmentFromFile | Obsolete.
Returns the value of the peak power adjustment stored in the file. This method uses the waveformIndex
as the key to read the waveform properties.
| ||||||
| ReadRFBlankingEnabledFromFile |
Returns the RF blanking enabled value stored in the file. This method uses the waveformIndex
as the key to read the waveform properties.
| ||||||
| ReadRFBlankingMarkerLocationsFromFile | Obsolete.
Returns the RF blanking marker locations stored in the file. This method uses the waveformIndex as the key to read the waveform property.
| ||||||
| ReadRFBlankingMarkerSourceFromFile |
Returns the RF blanking marker source stored in the file. This method uses the waveformIndex as the key to read the waveform property.
| ||||||
| ReadRuntimeScalingFromFile |
Returns the runtime scaling value stored in the file. This method uses the waveformIndex
as the key to read the waveform property.
| ||||||
| ReadSampleRateFromFile |
Returns the sample rate stored in the file. This method uses the waveformIndex
as the key to read the waveform property.
| ||||||
| ReadSignalBandwidthFromFile |
Returns the signal bandwidth stored in the file. This method uses the waveformIndex parameter as the key to retrieve the waveform property.
| ||||||
| ReadWaveformFileVersionFromFile |
Returns the waveform file version of the waveform stored in the file.
| ||||||
| ReadWaveformFromFileByIndexComplex(String, Int32, ComplexWaveformComplexDouble) |
Reads the waveform from file and returns the waveform in an output parameter.
| ||||||
| ReadWaveformFromFileByIndexComplex(String, Int32, ComplexWaveformComplexSingle) |
Reads the waveform from file and returns the waveform in an output parameter.
| ||||||
| ReadWaveformFromFileComplex(String, ComplexWaveformComplexDouble) |
Reads the waveform from file and returns the waveform in an output parameter.
| ||||||
| ReadWaveformFromFileComplex(String, ComplexWaveformComplexSingle) |
Reads the waveform from file and returns the waveform in an output parameter.
| ||||||
| ReadWaveformsFromFileComplex(String, Int32, ComplexWaveformComplexDouble) |
Reads the waveforms from file, and returns the waveforms in an output parameter.
| ||||||
| ReadWaveformsFromFileComplex(String, Int32, ComplexWaveformComplexSingle) |
Reads the waveforms from file, and returns the waveforms in an output parameter.
| ||||||
| ReadWaveformSizeFromFile |
Returns the size of the waveform stored in the file. This method uses the waveformIndex parameter as the key to read the waveform property.
| ||||||
| RetrieveAutomaticSGSASharedLO |
Returns the value of automatic SG SA shared LO parameter.
| ||||||
| RetrieveDownloadedWaveformNames |
Returns the names of the waveforms that are stored in the NI-RFSG waveform database.
| ||||||
| RetrieveWaveformBurstStartLocations |
Returns the RF burst start positions property stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformBurstStopLocations |
Returns the RF burst stop positions property stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformFileVersion |
Returns the waveform file version stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformLOOffsetMode |
Returns the LO offset mode value stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformPapr |
Returns the peak to average power ratio (PAPR) stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformPeakPowerAdjustment | Obsolete.
Returns the value of the Peak Power Adjustment property stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformRFBlankingEnabled |
Returns the RF blanking enabled value stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform properties.
| ||||||
| RetrieveWaveformRFBlankingMarkerLocations | Obsolete.
Returns the RF blanking marker positions property stored in the NI-RFSG waveform database. This method uses the waveformName as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformRFBlankingMarkerSource |
Returns the RF blanking marker source stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformRuntimeScaling |
Returns the runtime scaling value stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformSampleRate |
Returns the sample rate stored in the NI-RFSG waveform database. This method uses the waveformName parameter
as the key to retrieve the waveform properties.
| ||||||
| RetrieveWaveformSignalBandwidth |
Returns the signal bandwidth stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| RetrieveWaveformSize |
Returns the size of the waveform stored in the NI-RFSG waveform database. This method uses the waveformName parameter as the key to retrieve the waveform property.
| ||||||
| SetScriptToGenerateMultipleRfsg |
Sets the NI-RFSG driver to generate the waveforms specified in the script at the average power you configure on the NI-RFSG Power Level method.
If you have enabled RF Blanking for the waveform, NI-RFSG is configured to correctly blank the output during the idle times of the waveform.
The NI-RFSG IQ Rate method is set to the sample rate of the waveforms in the script. If the version of the waveform file is 2.0 or later, the method,
If the version of the waveform file is lesser than 2.0, the method,
For the waveforms that have the RF blanking Enabled method set to True, this VI also does the following:
For PXIe-5840/5841/5842 and PXIe-5830/5831/5832 devices,
| ||||||
| SetScriptToGenerateSingleRfsg |
Sets the NI-RFSG driver to generate the waveforms specified in the script at the average power you configure on the NI-RFSG Power Level method.
If you have enabled RF Blanking for the waveform, NI-RFSG is configured to correctly blank the output during the idle times of the waveform.
The NI-RFSG IQ Rate method is set to the sample rate of the waveform in the script. If the version of the waveform file is 2.0 or later, the method,
If the version of the waveform file is lesser than 2.0, the method,
For the waveforms that have the RF blanking Enabled method set to True, this method also does the following:
For PXIe-5840/5841/5842 and PXIe-5830/5831/5832 devices,
| ||||||
| StoreAutomaticSGSASharedLO |
Stores whether the signal generator’s LO signal can be shared on request by the RFmx driver. It is recommended to use Automatic sharing of local oscillator (LO) in test setups that use a vector signal transceiver (VST) with the NI-RFSG to generate a signal at the DUT's input and the RFmx driver to measure the signal at the DUT's output.
When using instruments that do not have LO with excellent phase noise, to minimize the contribution of the instrument's phase noise affecting your measurement, it is recommended to share the LO between the signal generator (SG) and signal analyzer (SA). To enable sharing signal generator’s LO with signal analyzer automatically, setup the device specific physical connections as mentioned in the following table and follow the steps in the mentioned order.
| ||||||
| StoreWaveformBurstStartLocations |
Stores the RF burst start locations, which you specify in the burstStartLocations parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformBurstStopLocations |
Stores the RF burst stop positions, which you specify in the burstStopLocations parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformLOOffsetMode |
Stores the LO offset mode value, which you specify in the value parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformPapr |
Stores the peak to average power ratio (PAPR), which you specify in the PAPR parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformPeakPowerAdjustment | Obsolete.
Stores the peak power adjustment, which you specify in the peakPowerAdjustment parameter, in the RFSG waveform database.
| ||||||
| StoreWaveformRFBlankingEnabled |
Stores the RF blanking enabled value, which you specify in the rfBlankingEnabled parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformRFBlankingMarkerLocations | Obsolete.
Stores the RF blanking marker positions, which you specify in the markerLocations parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformRFBlankingMarkerSource |
Stores the RF blanking marker source, which you specify in the markerSource parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformRuntimeScaling |
Stores the runtime scaling value, which you specify in the runtimeScaling parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformSampleRate |
Stores the sample rate, which you specify in the sampleRate parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformSignalBandwidth |
Stores the signal bandwidth, which you specify in the signalBandwidth parameter, in the NI-RFSG waveform database.
| ||||||
| StoreWaveformSize |
Stores the size of the waveform, which you specify in the waveformSize parameter, in the NI-RFSG waveform database.
|
Note