Skip to content

NI SCOPE Acquisition Attributes

ni-siray edited this page May 7, 2021 · 2 revisions

Acquisition Attributes

NISCOPE_ATTRIBUTE_BINARY_SAMPLE_WIDTH

Specific Attribute

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

Description

Indicates the bit width of the binary data in the acquired waveform, which is useful for determining which Binary Fetch function to use. Compare to NISCOPE_ATTRIBUTE_RESOLUTION.

To configure the device to store samples with a lower resolution than the native resolution, set this attribute to the desired binary width. This process can be useful for streaming at faster speeds at the cost of resolution. The least significant bits are lost with this configuration.

Defined Values

8, 16, 32

NISCOPE_ATTRIBUTE_RESOLUTION

Specific Attribute

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

Description

Indicates the bit width of valid data (as opposed to padding bits) in the acquired waveform. Compare to NISCOPE_ATTRIBUTE_BINARY_SAMPLE_WIDTH.

Related topics:

  • Resolution


NISCOPE_ATTRIBUTE_ACQUISITION_TYPE

Specific Attribute

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

Description

Specifies how the oscilloscope acquires data and fills the waveform record.

Defined Values

NISCOPE_VAL_NORMAL (0) Sets the oscilloscope to normal resolution mode. The oscilloscope can use real-time sampling or equivalent-time sampling.
NISCOPE_VAL_FLEXRES (1001) Sets legacy oscilloscopes to flexible resolution mode, if supported.
NISCOPE_VAL_DDC (1002) Sets legacy oscilloscopes to DDC mode, if supported. To use DDC mode for the PXI/PCI-5142 or PXIe-5622, set this attribute to NISCOPE_VAL_NORMAL and set the NISCOPE_ATTRIBUTE_DDC_ENABLED attribute to VI_TRUE.

Related topics:

  • Acquisition Functions


NISCOPE_ATTRIBUTE_SAMPLE_MODE

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViInt32 RO N/A None niScope_SampleMode

Description

Specifies the sample mode the digitizer is currently using.

Defined Values

NISCOPE_VAL_REAL_TIME (0)

NISCOPE_VAL_EQUIVALENT_TIME (1)

NISCOPE_ATTRIBUTE_FETCH_RELATIVE_TO

Specific Attribute

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

Description

Position to start fetching within one record.

Default Value: NISCOPE_VAL_PRETRIGGER

Defined Values

NISCOPE_VAL_PRETRIGGER (477)—Fetches relative to the first pretrigger point requested with niScope_ConfigureHorizontalTiming.

NISCOPE_VAL_NOW (481)—Fetch data at the last sample acquired.

NISCOPE_VAL_START (482)—Fetch data starting at the first point sampled by the digitizer.

NISCOPE_VAL_TRIGGER (483)—Fetch at the first posttrigger sample.

NISCOPE_VAL_READ_POINTER (388)—The read pointer is set to zero when a new acquisition is initiated. After every fetch the read pointer is incremented to be the sample after the last sample retrieved. Therefore, you can repeatedly fetch relative to the read pointer for a continuous acquisition program.

Related topics:

  • Fetching the Most Recent Data


NISCOPE_ATTRIBUTE_FETCH_OFFSET

Specific Attribute

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

Description

Offset in samples to start fetching data within each record. The offset is applied relative to NISCOPE_ATTRIBUTE_FETCH_RELATIVE_TO. The offset can be positive or negative.

Default Value: 0

Related topics:

  • Fetching the Most Recent Data


NISCOPE_ATTRIBUTE_FETCH_RECORD_NUMBER

Specific Attribute

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

Description

Zero-based index of the first record to fetch. Use NISCOPE_ATTRIBUTE_FETCH_NUM_RECORDS to set the number of records to fetch.

Default Value: 0

Related topics:

  • Making Multiple-Record Acquisitions
  • Fetching Multiple-Record Acquisitions


NISCOPE_ATTRIBUTE_FETCH_NUM_RECORDS

Specific Attribute

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

Description

Number of records to fetch. Use –1 to fetch all configured records.

Default Value: –1

NISCOPE_ATTRIBUTE_FETCH_MEAS_NUM_SAMPLES

Specific Attribute

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

Description

Number of samples to fetch when performing a measurement. Use –1 to fetch the actual record length.

Default Value: –1

Related topics:

  • Fetching Data
  • Acquiring Data Continuously


NISCOPE_ATTRIBUTE_POINTS_DONE

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViReal64 RO N/A None None

Description

Actual number of samples acquired since the last fetch, relative to the configured value for NISCOPE_ATTRIBUTE_FETCH_RELATIVE_TO, including NISCOPE_ATTRIBUTE_FETCH_OFFSET, and for the current configured NISCOPE_ATTRIBUTE_FETCH_RECORD_NUMBER.

NISCOPE_ATTRIBUTE_RECORDS_DONE

Specific Attribute

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

Description

Specifies the number of records that have been completely acquired.

Related topics:

  • Making Multiple-Record Acquisitions
  • Fetching Multiple-Record Acquisitions


NISCOPE_ATTRIBUTE_DATA_TRANSFER_BLOCK_SIZE

Specific Attribute

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

Description

Specifies the maximum number of samples to transfer at one time from the device to host memory. Increasing this number should result in better fetching performance because the driver does not need to restart the transfers as often. However, increasing this number may also increase the amount of page-locked memory required from the system.

Related topics:

  • Fetching Data
  • Acquiring Data Continuously


NISCOPE_ATTRIBUTE_BACKLOG

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViReal64 RO N/A None None

Description

Returns the number of samples (NISCOPE_ATTRIBUTE_POINTS_DONE that have been acquired but not fetched for the record specified by NISCOPE_ATTRIBUTE_FETCH_RECORD_NUMBER.

NISCOPE_ATTRIBUTE_ENABLED_CHANNELS

Specific Attribute

Data
type
Access Applies to Coercion High Level Functions
ViString RO N/A None None

Description

Returns a comma-separated list of the channels enabled for the session in ascending order.

  • If no channels are enabled, this attribute returns an empty string, "".
  • If all channels are enabled, this attribute enumerates all of the channels.

Because this attribute returns channels in ascending order, but the order in which you specify channels for the channelList input to NISCOPE functions is important, the value of this attribute may not necessarily reflect the order in which NISCOPE performs certain actions. Refer to Channel String Syntax for more information on the effects of channel order in NISCOPE.

NISCOPE_ATTRIBUTE_RIS_IN_AUTO_SETUP_ENABLE

Specific Attribute

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

Description

Indicates whether the digitizer should use RIS sample rates when searching for a frequency in autosetup.

NISCOPE_ATTRIBUTE_DATA_TRANSFER_MAXIMUM_BANDWIDTH

Specific Attribute

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

Description

Specifies the maximum bandwidth that the device is allowed to consume. The NI device limits itself to transfer fewer bytes per second on the PCIe bus than the value you specify for this property.

NISCOPE_ATTRIBUTE_DATA_TRANSFER_PREFERRED_PACKET_SIZE

Specific Attribute

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

Description

Specifies the preferred size of the data field in the PCI Express packet. In general, the larger the packet size, the more efficiently the device uses the bus. However, some systems, because of their implementation, perform better with smaller packet sizes. The value of this property must be a power of two (64, 128, ... , 512).

Table of Contents

Internal Development

Creating and Setting Up a gRPC Server

Server Security Support

Creating a gRPC Client

gRPC Client Examples

Session Utilities API Reference

Driver Documentation

gRPC API Differences From C API

Sharing Driver Sessions Between Clients

C API Docs
NI-DAQmx
NI-DCPOWER
NI-DIGITAL PATTERN DRIVER
NI-DMM
NI-FGEN
NI-FPGA
NI-RFmx Bluetooth
NI-RFmx NR
NI-RFmx WCDMA
NI-RFmx GSM
NI-RFmx CDMA2k
NI-RFmx Instr
NI-RFmx LTE
NI-RFmx SpecAn
NI-RFmx TD-SCDMA
NI-RFmx WLAN
NI-RFSA
NI-RFSG
NI-SCOPE
NI-SWITCH
NI-TCLK
NI-XNET
Clone this wiki locally