IviRFSigGen_ConfigurePulse

CVI/LabWindows IVI Class Driver

IviRFSigGen_ConfigurePulse

IviRFSigGenPulseGenerator Capability Group

C Function Prototype

ViStatus IviRFSigGen_ConfigurePulse (ViSession vi, ViInt32 triggerSource, ViReal64 pulseWidth, ViBoolean gatingEnabled);

Purpose

This function configures the trigger source, pulse width, and gating enabled for the pulse generator within the RF signal generator.

Parameters

Name Type Description
vi ViSession The ViSession handle that you obtain from the IviRFSigGen_init or IviRFSigGen_InitWithOptions function. The handle identifies a particular instrument session.

Default Value: None

triggerSource ViInt32 Specifies the source of the signal the pulse generator uses to generate one pulse. The driver uses this value to set the IVIRFSIGGEN_ATTR_PULSE_TRIGGER_SOURCE attribute.

Defined Values:
IVIRFSIGGEN_VAL_PULSE_TRIGGER_SOURCE_INTERNAL
- No external trigger is used. The pulse period is specified by the IVIRFSIGGEN_ATTR_PULSE_INTERNAL_TRIGGER_PERIOD attribute.

IVIRFSIGGEN_VAL_PULSE_TRIGGER_SOURCE_EXTERNAL
- The pulse is started with a trigger after the delay time specified by the IVIRFSIGGEN_ATTR_PULSE_EXTERNAL_TRIGGER_DELAY attribute.

Default Value:

IVIRFSIGGEN_VAL_PULSE_TRIGGER_SOURCE_INTERNAL

pulseWidth ViReal64 Specifies the width of the output pulse. The driver uses this value to set the IVIRFSIGGEN_ATTR_PULSE_WIDTH attribute.

Units: Seconds

Default Value: 50.0e-6 seconds

gatingEnabled ViBoolean Enables pulse gating. The driver uses this value to set the IVIRFSIGGEN_ATTR_PULSE_GATING_ENABLED attribute.

Valid Values: VI_TRUE; VI_FALSE

Default Value: VI_FALSE

Return Values