Gx3748MeasureSetTriggerSource

Purpose

Sets the measurement unit trigger source.

Syntax

Gx3748MeasureSetTriggerSource (nHandle, nSource, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle for a GX3748 board.
nSource
SHORT
Measurement unit trigger sources are:
0.      GX3748_CALCULATE_TRIGGER_SOFTWARE: Software trigger
1.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_0: PXI Trigger bus 0.
2.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_1: PXI Trigger bus 1.
3.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_2: PXI Trigger bus 2.
4.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_3: PXI Trigger bus 3.
5.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_4: PXI Trigger bus 4.
6.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_5: PXI Trigger bus 5.
7.      GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_6: PXI Trigger bus 6.
8.   GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_7: PXI Trigger bus 7. 
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

The function sets the measurement unit trigger source. Trigger source can be a software trigger, used by the Gx3748Measure() API, or one of the PXI Trigger Lines.

The user can read back the measurement that was triggered by the PXI line using the Gx3748MeasureGetLastTriggeredData() API. The user can call Gx3748MeasureGetStatus() API to check when the is a new measurement.

Example

The following example sets the measurement unit 3 channels, one form each group, and takes measurements using PXI Trigger Bus line 0:

 

SHORT nHandle, nStatus nMeasurementStatus;

DOUBLE dMeasurement;

 

// Set channel 0 from group 0

Gx3748MeasureSetInputSource(nHandle, GX3748_GROUP0, GX3748_GROUP_CH0, &nStatus);

// Set channel 1 from group 1

Gx3748MeasureSetInputSource(nHandle, GX3748_GROUP1, GX3748_GROUP_CH1, &nStatus);

// Set channel 2 from group 2

Gx3748MeasureSetInputSource(nHandle, GX3748_GROUP2, GX3748_GROUP_CH2, &nStatus);

// Set PXI Trigger Bus line  0

Gx3748MeasureSetTriggerSource(nHandle, GX3748_CALCULATE_TRIGGER_PXI_TRIGGER_0, &nStatus);

// Check status

Gx3748MeasureGetStatus(nHandle, &nMeasurementStatus, &nStatus);

if ((nMeasurementStatus&0x3)==0x2)

{  // Read back the measurement

Gx3748MeasureGetLastTriggeredData(nHandle, GX3748_GROUP0, &dMeasurement, &nStatus);

Gx3748MeasureGetLastTriggeredData(nHandle, GX3748_GROUP1, &dMeasurement, &nStatus);

Gx3748MeasureGetLastTriggeredData(nHandle, GX3748_GROUP2, &dMeasurement, &nStatus);

}

 

See Also

Gx3748MeasureSetInputSource, Gx3748MeasureGetTriggerSource, Gx3748Measure, Gx3748MeasureGetStatus, GxFpgaGetErrorString