niHSDIO_ConfigureRefClock

NI Digital Waveform Generator/Analyzer

niHSDIO_ConfigureRefClock

Specific Function

C Function Prototype

ViStatus niHSDIO_ConfigureRefClock (ViSession vi, ViConstString clockSource, ViReal64 clockRate);

Purpose

Configures the Reference clock. Use this function when you are using the On Board Clock as a Sample clock, and you want the Sample clock to be phase-locked to a reference signal. Phase-locking the Sample clock to a Reference clock prevents the Sample clock from "drifting" relative to the Reference clock.

Parameters

Name Type Description
vi ViSession This handle identifies your instrument session. vi was obtained from the niHSDIO_InitAcquisitionSession or niHSDIO_InitGenerationSession function.
clockSource ViConstString Specifies the PLL Reference clock source. Refer to NIHSDIO_ATTR_REF_CLOCK_SOURCE for details.

Defined Values

NIHSDIO_VAL_NONE_STR ("None")—The device does not use a Reference clock.
NIHSDIO_VAL_CLK_IN_STR ("ClkIn")—The device uses the signal present on the front panel CLK IN SMB jack connector as the Reference clock source.
NIHSDIO_VAL_PXI_CLK10_STR ("PXI_CLK10")—The device uses the 10 MHz PXI backplane clock as the Reference clock source. This source is only available for PXI devices.
NIHSDIO_VAL_RTSI7_STR ("RTSI7")—The device uses the signal on RTSI 7 as the Reference clock source. This source is only available for PCI devices.

Default Value: NIHSDIO_VAL_NONE_STR
clockRate ViReal64 Specifies the Reference clock rate, expressed in Hz. Refer to NIHSDIO_ATTR_REF_CLOCK_RATE for details.

Default Value: 10000000

Return Value