NIRfsgPlayback.ReadAndDownloadWaveformsFromFile Method
- Updated2023-02-21
- 2 minute(s) read
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:
- Sample Rate
- PAPR and Runtime Scaling, or Peak Power Adjustment
- RF Blanking Marker Locations
- RF Blanking Enabled
- Burst Start Locations
- Burst Stop Locations
- RF Blanking Marker Source
- Signal Bandwidth
- Waveform Size
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.
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 int ReadAndDownloadWaveformsFromFile( IntPtr[] rfsgSessions, string filePath, string rfsgWaveformName )
Public Shared Function ReadAndDownloadWaveformsFromFile ( rfsgSessions As IntPtr(), filePath As String, rfsgWaveformName As String ) As Integer
Parameters
- rfsgSessions
- Type: SystemIntPtr
Identifies instruments for multiple RFSG sessions. The rfsgSession handle is obtained from the NIRfsg.DangerousGetInstrumentHandle method. - filePath
- Type: SystemString
Specifies the absolute path to the TDMS file from which the playback library reads the waveforms. - rfsgWaveformName
- Type: SystemString
Specifies the waveform name used to store the waveform in the NI-RFSG device memory and waveform properties in the NI-RFSG waveform database.
Return Value
Type: Int32Returns the status code of this method. The status code either indicates success or describes a warning condition.