Measurement Computing Personal Daq rev.6.0 - Manual (Page 146)

B-14 API Commands Appendix B, 887095 Personal Daq User’s Manual
daqAdcSetTrigEnhanced
DLL Function daqAdcSetTrigEnhanced(DaqHandleT handle, daqAdcTriggerSource *trigSources,
daqAdcGain *gains, daqAdcRangeT *adcRanges, daqEnhTrigSensT *trigSensitivity, PFLOAT
level, PFLOAT hysteresis, PDWORD channels, DWORD chanCount,
char *opStr);
C daqAdcSetTrigEnhanced(DaqHandleT handle, DaqAdcTriggerSource *trigSources,
DaqAdcGain *gains, DaqAdcRangeT *adcRanges, DaqEnhTrigSensT *trigSensitivity, PFLOAT
level, PFLOAT hysteresis, PDWORD channels, DWORD chanCount,
char *opStr);
Visual BASIC VBdaqAdcSetTrigEnhanced&(ByVal handle&, ByRef triggerSources&(), ByRef gains&(),
ByRef adcRanges&(), ByRef trigSense&(), ByRef levels!(), ByRef hysteresis!(),
ByRef chan&(), ChanCount&, opstr$)
Delphi daqAdcSetTrigEnhanced(handle:DaqHandleT; trigSource:daqAdcTriggerSourceP;
gains:daqAdcGainP; adcRanges:daqAdcRangeTP; trigSensitivity:daqEnhTrigSensTP;
level:PSINGLE; hysteresis:PSINGLE; channel:PDWORD; chanCount:DWORD; opStr:PCHAR)
handle Handle to the device for which the ADC acquisition trigger is to be configured.
triggerSource A pointer to an array of trigger sources for each defined trigger channel.
gains A pointer to an array of gains for each defined A/D trigger channel.
levels A pointer to an array of A/D analog trigger levels for each defined A/D trigger channel.
hysteresis A pointer to an array of hysteresis values for each defined A/D trigger channel.
trigSense A pointer to an array of trigger sensitivity flags for each defined A/D channel trigger source.
adcRanges A pointer to an array of polarity flag definitions for each defined A/D channel.
channels A pointer to an array of trigger channels representing the actual A/D trigger channels to
trigger on.
Parameters
chanCount Indicates the number of configured A/D channels.
Returns DerrNoError No error
See Also daqAdcSetAcq, daqAdcSetTrig, daqAdcSetScan
Program References ADCEX1.C, FREQEX1.C, PULSEEX1.C, MULTEX1.C, DAQEX.FRM (VB), DAQEX.PAS (Delphi)
Used With Personal Daq/55 and Personal Daq/56
Description
daqAdcSetTrigEnhanced configures the device for triggering. Trigger configuration allows the device to be configured to detect A/D
triggering formed with multiple A/D channel trigger-event conditions. The trigger event may be defined as a combination of multiple A/D
analog-level event conditions that are logically and’d or or’d.
The trigger event is formulated based on the channel trigger event for each channel in the trigger sequence. The total number of trigger
channels is defined by the chanCount parameter. Each channel trigger configuration parameter definition is a pointer to an array of
chanCount
length and is defined as follows:
•
channels - Defines a pointer to an array of actual device/channel numbers for which to configure the corresponding trigger events.
•
triggerSources - Defines a pointer to an array of trigger sources for which to configure the corresponding trigger events for the
corresponding channel in the channels array. See the ADC Trigger Source Definitions table for valid triggers.
•
gains - Defines a pointer to an array of gains corresponding to the actual A/D channels in the corresponding A/D channel number
in the channels array.
•
adcRanges - Defines a pointer to an array of A/D ranges for the A/D channels defined in the corresponding channels array.
Note: Personal Daq ignores adcRanges parameters.
•
hysteresis - Defines a pointer to an array of hysteresis values for each corresponding A/D channel defined in the channels array.
•
levels - Defines a pointer to an array of levels for which, when satisfied, will set the trigger event for the corresponding channel
defined in the channels array.
•
opStr - Defines a string that defines the logical relationship between the individual channel trigger events and the global A/D trigger
condition. Currently, the string can be defined as “*” to perform an and operation or “+” to perform an or operation on the individual
channel trigger events to formulate the global A/D trigger condition.
Note: Personal Daq ignores opStr parameters.
•
trigSense - Defines an array of trigger sensitivity definitions for satisfying the defined trigger event for the corresponding channel
defined in the channels array. Currently, the valid trigger sensitivity values are as follows:
DetsRisingEdge Trigger the channel on the rising edge of the signal at the specified level.
DetsFallingEdge Trigger the channel on the falling edge of the signal at the specified level.