• Advanced
  • NIRFSG_ATTR_COMPENSATE_FOR_FILTER_GROUP_DELAY
  • NIRFSG_ATTR_ARB_DIGITAL_GAIN
  • NIRFSG_ATTR_OVERFLOW_ERROR_REPORTING
• NIRFSG_ATTR_ARB_CARRIER_FREQUENCY
• NIRFSG_ATTR_ARB_POWER
• Data Transfer
  • Advanced
    • NIRFSG_ATTR_HOST_DMA_BUFFER_SIZE
    • NIRFSG_ATTR_DATA_TRANSFER_MAXIMUM_IN_FLIGHT_READS
    • NIRFSG_ATTR_DATA_TRANSFER_PREFERRED_PACKET_SIZE
  • NIRFSG_ATTR_DATA_TRANSFER_BLOCK_SIZE
  • NIRFSG_ATTR_DIRECT_DOWNLOAD
  • NIRFSG_ATTR_DATA_TRANSFER_MAXIMUM_BANDWIDTH
  • Streaming
    • NIRFSG_ATTR_STREAMING_SPACE_AVAILABLE_IN_WAVEFORM
    • NIRFSG_ATTR_STREAMING_ENABLED
    • NIRFSG_ATTR_STREAMING_WAVEFORM_NAME
    • NIRFSG_ATTR_STREAMING_WRITE_TIMEOUT
• NIRFSG_ATTR_DIGITAL_EQUALIZATION_ENABLED
• NIRFSG_ATTR_DIGITAL_PATTERN
• NIRFSG_ATTR_GENERATION_MODE
• NIRFSG_ATTR_IQ_RATE
• NIRFSG_ATTR_IQ_SWAP_ENABLED
• NIRFSG_ATTR_MEMORY_SIZE
• NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED
• NIRFSG_ATTR_ARB_PRE_FILTER_GAIN
• Pulse Shaping
  • NIRFSG_ATTR_ARB_FILTER_TYPE
  • NIRFSG_ATTR_ARB_FILTER_RAISED_COSINE_ALPHA
  • NIRFSG_ATTR_ARB_FILTER_ROOT_RAISED_COSINE_ALPHA
• NIRFSG_ATTR_SELECTED_SCRIPT
• NIRFSG_ATTR_SIGNAL_BANDWIDTH
• NIRFSG_ATTR_DEVICE_INSTANTANEOUS_BANDWIDTH
• NIRFSG_ATTR_ARB_WAVEFORM_SOFTWARE_SCALING_FACTOR
• Waveform Attributes
  • NIRFSG_ATTR_WAVEFORM_IQ_RATE
  • NIRFSG_ATTR_WAVEFORM_PAPR
  • NIRFSG_ATTR_WAVEFORM_RUNTIME_SCALING
  • NIRFSG_ATTR_WAVEFORM_RF_BLANKING
  • NIRFSG_ATTR_WAVEFORM_SIGNAL_BANDWIDTH
• Waveform Capabilities
  • NIRFSG_ATTR_ARB_MAX_NUMBER_WAVEFORMS
  • NIRFSG_ATTR_ARB_WAVEFORM_SIZE_MAX
  • NIRFSG_ATTR_ARB_WAVEFORM_SIZE_MIN
  • NIRFSG_ATTR_ARB_SELECTED_WAVEFORM
  • NIRFSG_ATTR_ARB_WAVEFORM_QUANTUM
• NIRFSG_ATTR_ARB_WAVEFORM_REPEAT_COUNT
• NIRFSG_ATTR_ARB_WAVEFORM_REPEAT_COUNT_IS_FINITE
• Write Waveform Burst Detection
  • NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION
  • NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MINIMUM_BURST_TIME
  • NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MINIMUM_QUIET_TIME
  • NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MODE
  • NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_POWER_THRESHOLD
• NIRFSG_ATTR_WRITE_WAVEFORM_NORMALIZATION

Numeric Value	Data type	Access	Coercion	High Level Functions
1152832	ViBoolean	R/W	None	None

Enables or disables compensation for filter group delay on the AWG module. This attribute also accounts for the upconverter group delay and aligns the RF output with the Started Event, Done Event, and Marker Events.

At a low I/Q rate, the group delay can become so large that some devices may not be able to align the events with the RF output, in which case you must increase the I/Q rate or disable this attribute.

Defined Values:

VI_TRUE	Enables compensation for filter group delay.
VI_FALSE	Disables compensation for filter group delay.
Default Value: VI_FALSE

Supported Devices: PXIe-5672

Numeric Value	Data type	Access	Coercion	High Level Functions
1150204	ViReal64	R/W	None	None

Specifies the digital gain, in decibels. The digital gain is applied to the waveform data after filtering. Use this attribute to adjust the output power of the device while keeping the analog path fixed. This may cause clipping, overflows, or quantization noise if used improperly.

To set this attribute, the NI-RFSG device must be in the Configuration or Generation state.

Default Value: 0 dB

Supported Devices: PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150228	ViInt32	R/W	None	None

Configures error reporting for onboard signal processing (OSP) overflows. Overflows lead to clipping of the waveform.

Defined Values:

NIRFSG_VAL_ERROR_REPORTING_WARNING	NI-RFSG returns a warning when an OSP overflow occurs.
NIRFSG_VAL_ERROR_REPORTING_DISABLED	NI-RFSG does not return an error or a warning when an OSP overflow occurs.
Default Value: NIRFSG_VAL_ERROR_REPORTING_WARNING

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150015	ViReal64	RW	None	None

Indicates the carrier frequency generated by the arbitrary waveform generator (AWG) module. The specified carrier frequency is related to the RF output as shown in the following equations:

Device	Equation
PXI-5610, PXI-5670/5671, PXIe-5672	RF Frequency (MHz) = Upconverter Center Frequency + Arb Carrier Frequency – 25 MHz
PXIe-5644/5645/5646, PXIe- 5673/5673E, PXIe-5830/5831/5832/5840/5841	RF Frequency (MHz) = Upconverter Center Frequency + Arb Carrier Frequency

	Note  The NIRFSG_ATTR_UPCONVERTER_CENTER_FREQUENCY attribute and the NIRFSG_ATTR_ARB_CARRIER_FREQUENCY attribute cannot be set at the same time. The only time the carrier frequency is nonzero on these devices is when in-band retuning is used.

| :- | :- |

	Note   Use this attribute to associate a carrier frequency with a waveform.

	Note   This attribute is read-only on the PXI-5670/5671 and PXIe-5672.
Units: hertz (Hz)

Supported Devices: PXI-5610, PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5830/5831/5832/5840/5841

Related Topics

Assigning Properties or Attributes to a Waveform—Refer to this topic for more information about using this attribute to associate a carrier frequency with a waveform.

Numeric Value	Data type	Access	Coercion	High Level Functions
1150016	ViReal64	RO	None	None

Indicates the average output power from the PXI-5421, PXI-5441, PXIe-5442, and PXIe-5450 AWG module. If an arbitrary waveform is being generated, this attribute specifies either the average power or the peak power of the signal, depending on the NIRFSG_ATTR_POWER_LEVEL_TYPE attribute setting.

Units: dBm

Supported Devices: PXI-5670/5671, PXIe-5672/5673/5673E

Data type	Access	High Level Functions
ViInt64	R/W	None

Specifies the size of the DMA buffer in computer memory, in bytes. To set this attribute, the NI-RFSG device must be in the Configuration state.

A sufficiently large host DMA buffer improves performance by allowing large writes to be transferred more efficiently.

Units: bytes

Default Value: 8 MB

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150088	ViInt32	R/W	Yes	None

Specifies the maximum number of concurrent PCI Express read requests the RF signal generator can issue.

When transferring data from computer memory to device onboard memory across the PCI Express bus, the signal generator can issue multiple memory reads at the same time. In general, the larger the number of read requests, the more efficiently the device uses the bus because the multiple read requests keep the data flowing, even in a PCI Express topology that has high latency due to PCI Express switches in the data path. Most NI devices can issue a large number of read requests (typically 8 or 16). By default, this attribute is set to the highest value the RF signal generator supports.

If other devices in your system cannot tolerate long data latencies, it may be helpful to decrease the number of in-flight read requests the RF signal generator issues. This helps to reduce the amount of data the signal generator reads at one time.

Units: number of packets

Default Value: Device maximum

Supported Devices: PXI-5670/5671, PXIe-5672/5673/5673E

Related Topics

Improving Streaming Performance

Numeric Value	Data type	Access	Coercion	High Level Functions
1150087	ViInt32	R/W	Yes	None

Specifies the preferred size of the data field in a PCI Express read request packet.

In general, the larger the packet size, the more efficiently the device uses the bus. By default, NI RF signal generators use the largest packet size allowed by the system. However, due to different system implementations, some systems may perform better with smaller packet sizes.

Recommended values for this attribute are powers of two between 64 and 512.

	Note  In some cases, the RF signal generator generates packets smaller than the preferred size you set with this attribute.
Units: bytes

Default Value: Device maximum

Supported Devices: PXI-5670/5671, PXIe-5672/5673/5673E

Related Topics

Improving Streaming Performance

Numeric Value	Data type	Access	Coercion	High Level Functions
1150048	ViInt32	R/W	None	None

Indicates the number of samples to transfer at one time from the device to host memory. This attribute is useful when the total data to be transferred to onboard memory is large.

Units: samples (s)

Default Value: 1 Ms

Supported Devices: PXIe-5672/5673/5673E

Numeric Value	Data type	Access	Coercion	High Level Functions
1150042	ViInt32	R/W	None	None

Specifies whether the niRFSG_WriteArbWaveform function immediately writes waveforms to the device or copies the waveform to host memory for later download. NI-RFSG reads and validates this attribute when an arbitrary waveform is first allocated.

For the PXI-5670, direct download is always disabled. For all other devices, direct download is always enabled.

PXI-5671: To increase performance when using large waveforms, enable direct download. To maximize reconfigurability, disable direct download.

Perform the following steps to enable direct download:

\1. Set the I/Q rate to less than or equal to 8.33 MS/s with the NIRFSG_ATTR_IQ_RATE attribute.

\2. Set the NIRFSG_ATTR_POWER_LEVEL_TYPE attribute to NIRFSG_VAL_PEAK_POWER.

\3. Disable the NIRFSG_ATTR_IQ_SWAP_ENABLED attribute.

\4. Disable the NIRFSG_ATTR_DIGITAL_EQUALIZATION_ENABLED attribute.

Defined Values:

NIRFSG_VAL_ENABLE	Direct download is enabled.
NIRFSG_VAL_DISABLE	Direct download is disabled.
Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150086	ViReal64	R/W	Yes	None

Specifies the maximum amount of bus bandwidth to use for data transfers.

Units: bytes per second

Default Value: Device maximum

Supported Devices: PXI-5670/5671, PXIe-5672/5673/5673E

Related Topics

Improving Streaming Performance

Numeric Value	Data type	Access	Coercion	High Level Functions
1150047	ViInt64	RO	None	None

Indicates the space available, in samples, in the streaming waveform for writing new data. For optimal performance, write new data to the waveform in a fixed size that is an integer divisor of the total size of the streaming waveform. This waveform size ensures that writes do not have to wrap around from the end to the beginning of the waveform buffer.

To read this attribute, the NI-RFSG device must be in the Committed state.

Units: samples

Supported Devices: PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Numeric Value	Data type	Access	Coercion	High Level Functions
1150045	ViBoolean	R/W	None	None

Enables and disables continuous streaming of waveform data.

Defined Values:

VI_TRUE	Streaming is enabled.
VI_FALSE	Streaming is disabled.
Default Value: VI_FALSE

Supported Devices: PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Numeric Value	Data type	Access	Coercion	High Level Functions
1150046	ViString	R/W	None	None

Specifies the name of the waveform used to continually stream data during generation.

Default Value: "" (empty string)

Supported Devices: PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Streaming Waveform Data

Numeric Value	Data type	Access	Coercion	High Level Functions
1150140	ViReal64	R/W	None	None

Indicates the maximum amount of time allowed to complete a streaming write operation.

Default Value: 10.0 seconds

Supported Devices: PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Streaming Waveform Data

Numeric Value	Data type	Access	Coercion	High Level Functions
1150012	ViInt32	R/W	None	None

When this attribute is enabled, NI-RFSG equalizes the waveform data to correct for variations in the response of the NI-RFSG device. Enabling digital equalization improves the modulation error rates (MER) and error vector magnitude (EVM) for signals with large bandwidths (> 500 kHz), but it increases tuning times.

On the PXI-5670/5671, equalization is performed in the software, so tuning time is increased. On the PXIe-5672, equalization is performed in the hardware so that there is no compromise in performance.

This attribute applies only when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_SCRIPT. To set this attribute, the NI-RFSG device must be in the Configuration state.

PXIe-5644/5645/5646, PXIe-5820/5830/5831/5832/5840/5841: NIRFSG_VAL_ENABLE is the only supported value for this device.

Defined Values:

NIRFSG_VAL_ENABLE	Filter is applied.
NIRFSG_VAL_DISABLE	Filter is not applied
Default Value:

PXI-5670/5671: NIRFSG_VAL_DISABLE

PXIe-5644/5645/5646, PXIe-5672, PXIe-5820/5830/5831/5832/5840/5841: NIRFSG_VAL_ENABLE

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Response and Software Equalization—Refer to this topic for more information about equalization performed in software.

Frequency Tuning Times

Numeric Value	Data type	Access	Coercion	High Level Functions
1150044	ViBoolean	R/W	None	None

Enables or disables digital pattern on the PXI-5421/5441 AWG module. This attribute must be set to VI_TRUE to enable signal routing to and from the Digital Data & Control connector.

To set this attribute, the NI-RFSG device must be in the Configuration state.

Defined Values:

VI_TRUE	Signal routing enabled.
VI_FALSE	Signal routing disabled.
Default Value: VI_FALSE

Supported Devices: PXI-5670/5671

Numeric Value	Data type	Access	Applies to	Coercion	High Level Functions
1150018	ViInt32	R/W	N/A	None	niRFSG_ConfigureGenerationMode

Specifies whether to generate a continuous wave (CW) signal, the arbitrary waveform specified by the NIRFSG_ATTR_ARB_SELECTED_WAVEFORM attribute, or the script specified by the NIRFSG_ATTR_SELECTED_SCRIPT attribute, upon calling the niRFSG_Initiate function.

To set this attribute, the NI-RFSG device must be in the Configuration state.

Defined Values:

NIRFSG_VAL_CW	Configures the RF signal generator to generate a CW signal.
NIRFSG_VAL_ARB_WAVEFORM	Configures the RF signal generator to generate the arbitrary waveform specified by the NIRFSG_ATTR_ARB_SELECTED_WAVEFORM attribute.
NIRFSG_VAL_SCRIPT	Configures the RF signal generator to generate arbitrary waveforms as directed by the NIRFSG_ATTR_SELECTED_SCRIPT attribute.
Default Value: NIRFSG_VAL_CW

Supported Devices: PXIe-5644/5645/5646, PXI/PXIe-5650/5651/5652, PXIe-5653/5654/5654 with PXIe-5696 (CW support only), PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Assigning Properties or Attributes to a Waveform

Scripting Instructions—Refer to this topic for more information about scripting.

Numeric Value	Data type	Access	Coercion	High Level Functions
1250452	ViReal64	R/W	None	None

This attribute specifies the I/Q rate of the arbitrary waveform. The I/Q rate is coerced to a value the hardware can achieve. Read this value back after setting it to see the actual I/Q rate. NI-RFSG internally uses an FIR filter with flat response up to (0.4 × IQ rate). Given a desired signal with the maximum frequency content f, sample the signal at an I/Q rate greater than or equal to (f/0.4).

This attribute applies only when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_SCRIPT.

	Note  Use this attribute to associate an I/Q rate with a waveform.
To set this attribute, the NI-RFSG device must be in the Configuration state.

Valid Values:

Device	I/Q Rates
PXIe-5644/5645	Up to 120 MS/s.
PXIe-5646	Up to 250 MS/s.
PXI-5670	50 MS/s*
	100 MS/s
PXI-5671	50 MS/s*
	100 MS/s
	*(100 MS/s)/n, where n is divisible by 2 between 12 to 512, and divisible by 4 between 512 to 1,024 (n = 12, 14, 16, ..., 512, 516, 520, ..., 1,024). Setting the I/Q rate to one of these value enables the DUC.
PXIe-5672	Up to 100 MS/s.
PXIe-5673/5673E	Up to 200 MS/s.

	Note  If an PXIe-5450 with module revisions A or B is used as part of your PXIe-5673/5673E, the NI-FGEN NIFGEN_ATTR_COMPENSATE_FOR_FILTER_GROUP_DELAY attribute is disabled if the requested I/Q rate is less than 1.5 MS/s.

| :- | :- | |PXIe-5820/5830/5831/5832/5840/5841|Up to 1.25 GS/s.| |

Setting this attribute to 50 MS/s on the PXI-5670/5671 and PXIe-5672 has the following implications:

- NI-RFSG is forced to place the carrier frequency at 18 MHz ± 1 MHz to avoid aliasing. Forcing the IF carrier frequency to that point implies that NI-RFSG cannot select a carrier frequency that could optimize the waveform size if phase continuity is enabled.

- Output signal bandwidth must be <5 MHz to avoid aliasing.

- Close-in phase noise is higher.

|| Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Assigning Properties or Attributes to a Waveform—Refer to this topic for more information about using this attribute to associate an I/Q rate with a waveform.

Digital Upconverter

Numeric Value	Data type	Access	Coercion	High Level Functions
1250404	ViBoolean	R/W	None	None

Enables or disables the inverse phase rotation of the I/Q signal by swapping the I and Q inputs.

To set this attribute, the NI-RFSG device must be in the Configuration state.

Defined Values:

VI_TRUE	NI-RFSG device applies noninverse phase rotation of the I/Q signal.
VI_FALSE	NI-RFSG device applies inverse phase rotation of the I/Q signal.
Default Value: VI_FALSE

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150061	ViInt32	RO	None	None

The total amount of memory on the signal generator in bytes.

	Note  Not all onboard memory is available for waveform storage. A portion of onboard memory stores scripts that specify how the waveforms are generated. These scripts typically require less than 1 KB of onboard memory.
Units: bytes

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Memory Options

Phase Continuity

Numeric Value	Data type	Access	Coercion	High Level Functions
1150005	ViInt32	R/W	None	None

Specifies whether the driver maintains phase continuity in the arbitrary waveforms. When this attribute is set to NIRFSG_VAL_ENABLE, NI-RFSG may increase the waveform size. When this attribute is set to NIRFSG_VAL_ENABLE, the NIRFSG_ATTR_FREQUENCY_TOLERANCE attribute specifies the maximum allowable frequency error that can be introduced when keeping the signal phase-continuous. To set the NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED attribute, the NI-RFSG device must be in the Configuration state. NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED applies only when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_SCRIPT.

PXI-5671: When using the PXI-5671 with I/Q rates less than or equal to 8.33 MS/s, an input phase-continuous signal is always phase-continuous upon output, and this attribute has no effect.

PXIe-5644/5645/5646, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841: Phase continuity is always enabled on this device.

Defined Values:

NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED Attribute Setting	NIRFSG_ATTR_PHASE_CONTINUITY_ENABLED Attribute Settings with I/Q Rates > 8.33 MS/s.
	NIRFSG_VAL_ARB_WAVEFORM	NIRFSG_VAL_SCRIPT
NIRFSG_VAL_AUTO	The arbitrary waveform may be repeated to ensure phase continuity after upconversion. This setting could cause waveform size to increase.	Warning condition—NI-RFSG cannot guarantee a phase-continuous output signal in Script mode. Phase continuity is automatically disabled in Script mode and the arbitrary waveform plays back without regard to any possible phase discontinuities introduced by upconversion.
NIRFSG_VAL_ENABLE	The arbitrary waveform may be repeated to ensure phase continuity after upconversion. Enabling this attribute could cause waveform size to increase.	Error condition—NI-RFSG cannot guarantee a phase-continuous output signal in Script mode.
NIRFSG_VAL_DISABLED	The arbitrary waveform plays back without regard to any possible phase discontinuities introduced by upconversion. The time duration of the original waveform is maintained.	The arbitrary waveform plays back without regard to any possible phase discontinuities introduced by upconversion. The time duration of the original waveform is maintained.
Default Value: NIRFSG_VAL_AUTO

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Phase Continuity

Arb Waveform Mode Tuning Speed Factors

Numeric Value	Data type	Access	Applies to	Coercion	High Level Functions
1150025	ViReal64	R/W	N/A	None	None

Specifies the AWG prefilter gain. The prefilter gain is applied to the waveform data before any other signal processing. Reduce this value to prevent overflow in the AWG interpolation filters. Other gains on the NI-RFSG device are automatically adjusted to compensate for nonunity AWG prefilter gain. The PXI-5671, PXIe-5672 must be in the Configuration state to use this attribute. However, the PXIe-5644/5645/5646, PXIe-5673/5673E, and PXIe-5820/5830/5831/5832/5840/5841 can be in either the Configuration or the Generation state to use this attribute.

On the PXI-5671, this attribute applies only when the NIRFSG_ATTR_IQ_RATE attribute is set to a value less than or equal to 8.33 MS/s. On the PXIe-5644/5645/5646, PXIe-5672/5673/5673E, and PXIe-5820/5830/5831/5832/5840/5841, this attribute is always applicable.

Units: dB

Default Value: 0 dB

Supported Devices: PXIe-5644/5645/5646, PXI-5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Applies to	Coercion	High Level Functions
1150056	ViInt32	R/W	N/A	None	None

Specifies the pulse-shaping filter type for the FIR filter. You can use this attribute only with signal generators that support onboard signal processing (OSP). NI-RFSG returns an error if you use this attribute with a device that does not support OSP.

Defined Values:

NIRFSG_VAL_ARB_FILTER_TYPE_NONE	No filter type is applied.
NIRFSG_VAL_ARB_FILTER_TYPE_ROOT_RAISED_COSINE	Applies a root-raised cosine filter to the data with the alpha value specified with the NIRFSG_ATTR_ARB_FILTER_ROOT_RAISED_COSINE_ALPHA attribute.
NIRFSG_VAL_ARB_FILTER_TYPE_RAISED_COSINE	Applies a raised cosine filter to the data with the alpha value specified with the NIRFSG_ATTR_ARB_FILTER_RAISED_COSINE_ALPHA attribute.
Default Value: NIRFSG_VAL_ARB_FILTER_TYPE_NONE

Supported Devices: PXI-5670/5671, PXIe-5672/5673/5673E

Numeric Value	Data type	Access	Coercion	High Level Functions
1150060	ViReal64	R/W	None	None

Specifies the alpha value to use when calculating the pulse-shaping filter coefficients. You can use this attribute only when the NIRFSG_ATTR_ARB_FILTER_TYPE attribute is set to NIRFSG_VAL_ARB_RAISED_COSINE and with signal generators that support onboard signal processing (OSP). NI-RFSG returns an error if you use this attribute with a device that does not support OSP.

Supported Devices: PXI-5671, PXIe-5672/5673/5673E

Numeric Value	Data type	Access	Coercion	High Level Functions
1150057	ViReal64	R/W	None	None

Specifies the alpha value to use when calculating the pulse-shaping FIR filter coefficients. You can use this attribute only when the NIRFSG_ATTR_ARB_FILTER_TYPE attribute is set to NIRFSG_VAL_ARB_ROOT_RAISED_COSINE and with signal generators that support onboard signal processing (OSP). NI-RFSG returns an error if you use this attribute with a device that does not support OSP.

Supported Devices: PXI-5671, PXIe-5672/5673/5673E

Numeric Value	Data type	Access	Applies to	Coercion	High Level Functions
1150023	ViString	R/W	N/A	None	None

Specifies the script in onboard memory to generate upon calling the niRFSG_Initiate function when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_SCRIPT.

The NIRFSG_ATTR_SELECTED_SCRIPT attribute is ignored when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_CW. To set the NIRFSG_ATTR_SELECTED_SCRIPT attribute, the NI-RFSG device must be in the Configuration state.

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Assigning Properties or Attributes to a Waveform

Scripting Instructions

Numeric Value	Data type	Access	Coercion	High Level Functions
1150007	ViReal64	R/W	None	None

Specifies the bandwidth of the arbitrary signal. This value must be less than or equal to (0.8 × I/Q rate).

NI-RFSG defines signal bandwidth as twice the maximum baseband signal deviation from 0 Hz. Usually, the baseband signal center frequency is 0 Hz. In such cases, the signal bandwidth is simply the baseband signal's minimum frequency subtracted from its maximum frequency, or fmax - fmin.

This attribute applies only when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM or NIRFSG_VAL_SCRIPT, except for when using the PXIe-5830/5831/5832/5840/5841, which supports setting this attribute in all supported generation modes. To set the NIRFSG_ATTR_SIGNAL_BANDWIDTH attribute, the NI-RFSG device must be in the Configuration state.

PXI-5670/5671, PXIe-5672: Based on your signal bandwidth, NI-RFSG determines whether to configure the upconverter center frequency in increments of 1 MHz or 5 MHz. Failure to configure this attribute may result in the signal being placed outside the upconverter passband.

PXIe-5644/5645/5646, PXIe-5673/5673E: This attribute is used only for error-checking purposes. Otherwise, this attribute is ignored.

PXIe-5820/5830/5831/5832/5840/5841: Based on your signal bandwidth, NI-RFSG decides the equalized bandwidth. If this attribute is not set, NI-RFSG uses the maximum available signal bandwidth. For the PXIe-5840/5841, the maximum allowed signal bandwidth depends on the upconverter center frequency. Refer to the specifications document for your device for more information about signal bandwidth. The device specifications depend on the signal bandwidth.

Units: hertz (Hz)

Supported Devices: PXI-5610, PXIe-5611, PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Phase-Locked Loop Bandwidth

Frequency Tuning Times

PXIe-5830 Frequency and Bandwidth Selection

PXIe-5831/5832 Frequency and Bandwidth Selection

PXIe-5841 Frequency and Bandwidth Selection

Numeric Value	Data type	Access	Coercion	High Level Functions
1150226	ViReal64	R/W	None	None

Specifies the bandwidth of the device. The instantaneous bandwidth is the effective real-time bandwidth of the signal path for your configuration.

The signal bandwidth, centered at the RF frequency must fit within the device instantaneous bandwidth, which is centered at the upconverter center frequency.

Units: Hz

Default Value: N/A

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Related Topics

PXIe-5830 Frequency and Bandwidth Selection

PXIe-5831/5832 Frequency and Bandwidth Selection

PXIe-5841 Frequency and Bandwidth Selection

Numeric Value	Data type	Access	Coercion	High Level Functions
1150052	ViReal64	R/W	None	None

Specifies how much to scale the data before writing it with the niRFSG_WriteArbWaveform function. The resulting waveform must be smaller than 1.0 in complex magnitude. This attribute is supported only if you set the NIRFSG_ATTR_POWER_LEVEL_TYPE attribute to NIRFSG_VAL_PEAK_POWER.

Default Value: 1.0

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Spurious Performance

Numeric Value	Data type	Access	Coercion	High Level Functions
1150263	ViReal64	R/W	None	None

Specifies the I/Q rate of the waveform. To set this attribute, the NI-RFSG device must be in the Configuration state.

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Streaming

Assigning Properties or Attributes to a Waveform—Refer to this topic for more information about using this attribute to associate an I/Q rate with a waveform.

Digital Upconverter

Numeric Value	Data type	Access	Coercion	High Level Functions
1150266	ViReal64	R/W	None	None

Specifies the peak-to-average power ratio (PAPR).

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150265	ViReal64	R/W	None	None

Specifies the waveform runtime scaling. The waveform runtime scaling is applied to the waveform data before any other signal processing.

Units: dB

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841, PXIe-5841 with PXIe-5655

Numeric Value	Data type	Access	Coercion	High Level Functions
1150278	ViInt32	R/W	None	None

Enables or disables RF blanking.

NIRFSG_ATTR_RF_BLANKING_SOURCE	NIRFSG_ATTR_WAVEFORM_RF_BLANKING	Behaviour
"" (empty string)	NIRFSG_VAL_DISABLE	No blanking performed.
"" (empty string)	NIRFSG_VAL_ENABLE	Blanking performed based on burst start and stop values and blanking source set to private marker.
NIRFSG_VAL_MARKER0, NIRFSG_VAL_MARKER1, NIRFSG_VAL_MARKER2, or NIRFSG_VAL_MARKER3	NIRFSG_VAL_DISABLE	Blanking performed based on the marker locations for the marker that the user set in the blanking source.
NIRFSG_VAL_MARKER0, NIRFSG_VAL_MARKER1, NIRFSG_VAL_MARKER2, or NIRFSG_VAL_MARKER3	NIRFSG_VAL_ENABLE	Error is shown.
Defined Values:

NIRFSG_VAL_ENABLE	RF blanking is enabled.
NIRFSG_VAL_DISABLE	RF blanking is disabled.
Default Value: NIRFSG_VAL_DISABLED

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Marker Events

Numeric Value	Data type	Access	Coercion	High Level Functions
1150264	ViReal64	R/W	None	None

Specifies the bandwidth of the arbitrary signal. This value must be less than or equal to (0.8 × I/Q rate).

Units: hertz (Hz)

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1250454	ViInt32	RO	None	niRFSG_QueryArbWaveformCapabilities

Returns the maximum number of waveforms the device can hold in memory.

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1250457	ViInt32	RO	None	niRFSG_QueryArbWaveformCapabilities

Returns the size of the largest waveform that is allowed.

To read this attribute, the NI-RFSG device must be in the Configuration state.

For the PXI-5671 and PXIe-5672, the value of this attribute depends on the I/Q rate. Set the I/Q rate before reading this attribute. For the PXIe-5673/5673E, the maximum waveform size is reduced to account for the amount of device memory currently used.

	Note  Not all onboard memory is available for waveform storage. A portion of onboard memory stores scripts that specify how the waveforms are generated. These scripts typically require less than 1 KB of onboard memory.
Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1250456	ViInt32	RO	None	niRFSG_QueryArbWaveformCapabilities

Returns the smallest allowable waveform size. For the PXI-5671 and PXIe-5672, the value of this attribute depends on the I/Q rate. Set the NIRFSG_ATTR_IQ_RATE attribute before reading this attribute.

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1250451	ViString	R/W	None	niRFSG_SelectArbWaveform

Specifies the waveform in onboard memory to generate upon calling the niRFSG_init function when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_ARB_WAVEFORM. The NIRFSG_ATTR_ARB_SELECTED_WAVEFORM attribute is ignored when the NIRFSG_ATTR_GENERATION_MODE attribute is set to NIRFSG_VAL_SCRIPT or NIRFSG_VAL_CW. To set the NIRFSG_ATTR_ARB_SELECTED_WAVEFORM attribute, the NI-RFSG device must be in the Configuration state.

Default Value: "" (empty string)

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Related Topics

Assigning Properties or Attributes to a Waveform

Numeric Value	Data type	Access	Coercion	High Level Functions
1250455	ViInt32	RO	None	niRFSG_QueryArbWaveformCapabilities

Returns the waveform quantum for the device. The number of samples in a waveform must be an integer multiple of the waveform quantum. The other restrictions on the length of the waveform are the minimum and maximum arbitrary waveform sizes.

PXI-5671, PXIe-5672: The value of this attribute depends on the I/Q rate. Set the NIRFSG_ATTR_IQ_RATE attribute before reading this attribute.

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150158	ViInt32	R/W	None	None

Specifies the repeat count of a waveform when you set the NIRFSG_ATTR_ARB_WAVEFORM_REPEAT_COUNT_IS_FINITE attribute to VI_TRUE. This attribute is valid only when you set the NIRFSG_ATTR_GENERATION_MODE attribute to NIRFSG_VAL_ARB_WAVEFORM. To set this attribute, the NI-RFSG device must be in the Configuration state.

Default Value: 1

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150157	ViBoolean	R/W	None	None

Specifies the repetition mode of a waveform when you set the NIRFSG_ATTR_GENERATION_MODE attribute to NIRFSG_VAL_ARB_WAVEFORM. If you set this attribute to VI_TRUE, the number of repetitions is determined by the NIRFSG_ATTR_ARB_WAVEFORM_REPEAT_COUNT attribute. To set this attribute, the NI-RFSG device must be in the Configuration state.

Defined Values:

VI_TRUE	Repeats the waveform a finite number of times.
VI_FALSE	Repeats the waveform continuously until you abort the generation.
Default Value: VI_FALSE

Supported Devices: PXIe-5644/5645/5646, PXI-5670/5671, PXIe-5672/5673/5673E, PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150273	ViInt32	R/W	None	None

Enables the detection of burst start and burst stop locations in the waveform. You can read the detected burst start and burst stop locations using niRFSG_Get_Waveform_Burst_Start_Locations and niRFSG_Get_Waveform_Burst_Stop_Locations functions respectively.

	Note  When you download a waveform using niRFSG_Read_and_Download_Waveform_From_file_(TDMS) function and if NIRFSG_ATTR_WAVEFORM_RF_BLANKING attribute is enabled, you must set the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION attribute to NIRFSG_VAL_DISABLE.
Defined Values:

NIRFSG_VAL_ENABLE	Burst detection is enabled.
NIRFSG_VAL_DISABLE	Burst detection is disabled.
Default Value: NIRFSG_VAL_DISABLED

**Supported Devices:**PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150277	ViReal64	R/W	None	None

Specifies the minimum duration of the detected bursts. Any detected burst with a duration smaller than the value of this attribute is ignored by NI-RFSG. This attribute is ignored when you disable the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION attribute or when you set the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MODE attribute to NIRFSG_VAL_AUTO.

Units: seconds(s)

Default Value: 0

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150275	ViReal64	R/W	None	None

Specifies a time duration for which the signal must be quiet before a valid burst start location or after a valid burst stop location. This attribute is ignored when you disable the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION attribute or when you set the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MODE attribute to NIRFSG_VAL_AUTO.

The default value of this attribute is 0, which means NI-RFSG does not look for a quiet time before or after detected burst start and stop locations. This attribute is useful for detecting burst locations in signals containing multiple bursts. However, each burst must have large changes in signal power within itself. By configuring the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MINIMUM_QUIET_TIME attribute to a value that is less than or equal to the minimum time between two adjacent bursts in the waveform, you can ensure that the burst start and stop locations are detected at the beginning and end of a burst respectively, rather than at the signal power change within a burst.

Units: seconds(s)

Default Value: 0

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150274	ViInt32	R/W	None	None

Specifies the algorithm that NI-RFSG uses to detect the burst start and burst stop locations in the waveform when burst detection is enabled using the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION attribute. When you set NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MODE to NIRFSG_VAL_AUTO, NI-RFSG automatically detects the burst start and burst stop locations by analyzing the waveform. To fine-tune the burst detection process parameters yourself, you can set this attribute to NIRFSG_VAL_MANUAL and specify the burst detection parameters using the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MINIMUM_QUIET_TIME, NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_POWER_THRESHOLD, NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MINIMUM_BURST_TIME attributes.

Defined Values:

NIRFSG_VAL_AUTO	NI-RFSG automatically detects the burst start and burst stop locations by analyzing the waveform.
NIRFSG_VAL_MANUAL	User sets the burst detection parameters.
Default Value: NIRFSG_VAL_AUTO

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
1150276	ViReal64	R/W	None	None

Specifies the relative power level at which burst start or stop locations are detected. The threshold is relative to the peak power in the waveform. NI-RFSG detects burst start (or burst stop) locations when the signal exceeds (or falls below) the level specified by this attribute. This attribute is ignored when you disable the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION attribute or when you set the NIRFSG_ATTR_WRITE_WAVEFORM_BURST_DETECTION_MODE attribute to NIRFSG_VAL_AUTO.

Units: dB

Default Value: 0

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841

Numeric Value	Data type	Access	Coercion	High Level Functions
	ViInt32	R/W	None	None

Specifies whether to perform the normalization on a waveform.

	Note  You can not set NIRFSG_ATTR_WRITE_WAVEFORM_NORMALIZATION and NIRFSG_ATTR_POWER_LEVEL_TYPE attributes at the same time.
Defined Values:

NIRFSG_VAL_ENABLE	Enables normalization on a waveform to transform the waveform data so that its maximum is 1.00 and its minimum is -1.00
NIRFSG_VAL_DISABLE	Disables normalization on the waveform.
Default Value: NIRFSG_VAL_DISABLED

Supported Devices: PXIe-5820/5830/5831/5832/5840/5841