NI SCOPE Onboard Signal Processing Attributes - ni/grpc-device GitHub Wiki

Onboard Signal Processing Attributes

NISCOPE_ATTRIBUTE_DDC_ENABLED

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViBoolean R/W Channel None None

Description

Enables/disables the DDC block of the digitizer. When the DDC block is disabled, all DDC-related properties are disabled and have no effect on the acquired signal.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP
Default Value: VI_FALSE

Defined Values

VI_TRUE

VI_FALSE

Tip  To achieve maximum flatness in the filter response of the device in DDC mode, set the maximum input frequency to full bandwidth (–1). However, keep in mind that this action does not protect against aliasing frequency content of the input signal above (0.5 × Sample Clock Timebase Rate). When using internal clocking, the Sample Clock Timbase Rate is 100 MS/s.

Related Topics

DDC Enabled Overview

NISCOPE_ATTRIBUTE_DDC_DATA_PROCESSING_MODE

Specific Attribute

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

Description

The way in which data is processed by the DDC block.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Default Value: Complex

Defined Values

NISCOPE_VAL_REAL—The waveform data points are real numbers (I data)

NISCOPE_VAL_COMPLEX—The waveform data points are complex numbers (IQ data)

NISCOPE_ATTRIBUTE_DDC_FREQUENCY_TRANSLATION_ENABLED

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViBoolean R/W Channel None None

Description

Enables/disables frequency translating the data around the user-selected center frequency down to baseband.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Default Value: VI_TRUE

Defined Values

VI_TRUE

VI_FALSE

NISCOPE_ATTRIBUTE_DDC_CENTER_FREQUENCY

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViReal64 R/W Channel None None

Description

The frequency at which the DDC block frequency translates the input data.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Units: Hz

Default Value: 10 MHz

Valid Values

0 – (0.5 × Sample Clock Timebase Rate for digitizer)

NISCOPE_ATTRIBUTE_FETCH_INTERLEAVED_IQ_DATA

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViBoolean R/W N/A None None

Description

Specifies whether a fetch call retrieves a single waveform with I and Q interleaved, or two separate waveforms. If set to TRUE, the number of elements returned by scalar fetch types (such as 16-bit integer) is twice the requested number of samples. If set to FALSE during DDC acquisitions in Complex mode, two noninterleaved arrays of data are returned per channel, per record.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Default Value: VI_TRUE

Defined Values

VI_TRUE—A scalar fetch returns an array of waveforms in the following format: IQIQIQ...

VI_FALSE—A scalar fetch returns an array of waveforms in the following format: III...QQQ...

Related topics:

  • Frequency Domain Fundamentals


NISCOPE_ATTRIBUTE_DDC_Q_SOURCE

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViString R/W Channel None None

Description

Specifies the channel that is the input to the Q data stream of the DDC.

Note  For multi-instrument sessions, the channel you define with this attribute as the Q data stream and the channel for the corresponding I data stream must both be located within the same physical instrument.
Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Valid Values: All valid channels for the device

Default Value: The channel to which the attribute is registered

NISCOPE_ATTRIBUTE_DDC_FREQUENCY_TRANSLATION_PHASE_I

Specific Attribute

Data type Access Applies to Coercion High Level Functions
ViReal64 R/W Channel None None

Description

The I oscillator phase in degrees at the first point acquired.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Units: Degrees

Default Value: 0

Valid Values

–360 to 360

NISCOPE_ATTRIBUTE_DDC_FREQUENCY_TRANSLATION_PHASE_Q

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViReal64 R/W Channel None None

Description

The Q oscillator phase in degrees at the first point acquired. Use this attribute only when NISCOPE_ATTRIBUTE_DDC_DATA_PROCESSING_MODE is set to Complex.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Units: Degrees

Default Value: 90

Valid Values

–360 to 360

NISCOPE_ATTRIBUTE_EQUALIZATION_FILTER_ENABLED

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViBoolean R/W Channel None None

Description

Enables the onboard signal processing equalization FIR block, which is connected directly to the input signal. The equalization filter is designed to compensate the input signal for artifacts introduced to the signal outside of the digitizer. Because this filter is a generic FIR filter, any coefficients are valid. Coefficient values should be between +1 and –1.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Default value: VI_FALSE

Defined Values

VI_TRUE

VI_FALSE

Related topics:

  • Frequency Domain Fundamentals
  • Flatness


NISCOPE_ATTRIBUTE_EQUALIZATION_NUM_COEFFICIENTS

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViInt32 RO Channel None None

Description

Returns the number of coefficients that the equalization FIR filter can accept. This filter is designed to compensate the input signal for artifacts introduced to the signal outside of the digitizer. Because this filter is a generic FIR filter, any coefficients are valid. Coefficient values should be between +1 and –1.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.

Related topics:

  • Frequency Domain Fundamentals
  • Flatness


NISCOPE_ATTRIBUTE_FRACTIONAL_RESAMPLE_ENABLED

Specific Attribute

Datatype Access Applies to Coercion High Level Functions
ViBoolean R/W N/A None None

Description

Enables the onboard signal processing block that resamples the input waveform to the desired sample rate.

Default Value: VI_FALSE
Valid Values: VI_TRUE or VI_FALSE

Related topics:

  • Frequency Domain Fundamentals


NISCOPE_ATTRIBUTE_OVERFLOW_ERROR_REPORTING

Specific Attribute

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

Description

Configures error reporting when the onboard signal processing block detects an overflow in any of its stages. Overflows lead to clipping of the waveform.

Note  This attribute can be used only with high-speed digitizers that support onboard signal processing (OSP). NI-SCOPE returns an error if you use this attribute with a device that does not support OSP.
Default Value: Warning

Valid Values

NISCOPE_VAL_ERROR_REPORTING_ERROR (0)—NI-SCOPE returns an error when an overflow has occurred in the OSP block.

NISCOPE_VAL_ERROR_REPORTING_WARNING (1)—NI-SCOPE returns a warning when an overflow has occurred in the OSP block.

NISCOPE_VAL_ERROR_REPORTING_DISABLED (2)—NI-SCOPE does not return an error when an overflow has occurred in the OSP block.

⚠️ **GitHub.com Fallback** ⚠️