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.

Syntax

Namespace: NationalInstruments.ModularInstruments.NIRfsgPlayback

public static int SetScriptToGenerateMultipleRfsg(IntPtr[] rfsgSessions, string scriptText)

Remarks

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,

  • Sets the NI-RFSG Peak Power Adjustment method to the minimum value of the peak to average power ratio (PAPR) of the waveforms in the script.  

  • Sets the NI-RFSG Pre-filter Gain method to the minimum value of the runtime scaling of the waveforms in the script.  

If the version of the waveform file is lesser than 2.0, the method,

  • Sets the NI-RFSG Peak Power Adjustment method to the minimum value of the Headroom of the waveforms in the script.  

  • Resets the NI-RFSG Pre-filter Gain method.  

For the waveforms that have the RF blanking Enabled method set to True, this VI also does the following:

  • If the values of RF blanking marker source of all the waveforms are empty, then the first unused marker in the script is set as the RF Blanking Source.  

  • Modifies the script to add the waveform burst start and stop locations as the RF Blanking marker locations  

For PXIe-5840/5841/5842 and PXIe-5830/5831/5832 devices,

  • Sets the NI-RFSG Signal Bandwidth method to the maximum signal bandwidth of the waveform(s) in the script, if you set the LO Offset Mode to Auto. If no signal bandwidth is found in any waveform of the script, the NI-RFSG Signal Bandwidth method is set to 0.8 times the Sample Rate.  

  • Resets the NI-RFSG Signal Bandwidth, if you set the LO Offset Mode to No Offset.  

Parameters

NameTypeDescription
rfsgSessionsIntPtr[]

Identifies instruments for multiple RFSG sessions. The rfsgSession handle is obtained from the NIRfsg.DangerousGetInstrumentHandle method.

scriptTextstring

Specifies the script that controls the waveform generation.

Returns

Returns the status code of this method. The status code either indicates success or describes a warning condition.