niHSDIO_ConfigureDataPosition

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigureDataPosition

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigureDataPosition (ViSession vi, ViConstString channelList, ViInt32 position);

Purpose

Configures channels to be clocked in various ways by the Sample clock edges. You have three options for data position: rising edge, falling edge, or delayed.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
channelList ViConstString Identifies channels to apply settings. Use "" or VI_NULL to specify all channels.
position ViInt32 Specifies which edge of the Sample clock signal times the operation. You can also configure the device to generate data at a configurable delay past each rising edge of the Sample clock.

Defined Values

NIHSDIO_VAL_SAMPLE_CLOCK_RISING_EDGE (18)—The device samples or generates data on the rising edge of the Sample clock.
NIHSDIO_VAL_SAMPLE_CLOCK_FALLING_EDGE (19)—The device samples or generates data on the falling edge of the Sample clock.
NIHSDIO_VAL_DELAY_FROM_SAMPLE_CLOCK_RISING_EDGE (20)—The device samples or generates data with delay from rising edge of the Sample clock. Specify the delay using NIHSDIO_ATTR_DATA_POSITION_DELAY or the niHSDIO_ConfigureDataPositionDelay function.
Notes  NIHSDIO_VAL_DELAY_FROM_SAMPLE_CLOCK_RISING_EDGE has more jitter than the rising or falling edge values.
Certain devices have sample clock frequency limitations when a custom delay is used. Refer to the device documentation for details.
To configure a delay on NI 656x devices, you must delay all channels on the device. NI-HSDIO returns an error if you apply a delay to only a partial channel list.
Default Value: NIHSDIO_VAL_SAMPLE_CLOCK_RISING_EDGE

Return Value