API Functions
56Copyright © 2006–2022 Pico Technology Ltd. All rights reserved.ps2000pg.en-12
PicoScope 2000 Series Programmer's Guide
5.31 ps2000_set_trigger
int16_t ps2000_set_trigger
(
int16_t handle,
int16_t source,
int16_t threshold,
int16_t direction,
int16_t delay,
int16_t auto_trigger_ms
)
This function simplifies arming the trigger. It supports only the LEVEL trigger types on analog
channels, and does not allow more than one channel to have a trigger applied to it. Any
previous pulse width qualifier is canceled. The trigger threshold includes a small, fixed amount
of hysteresis.
For oscilloscopes that support advanced triggering, see
ps2000SetAdvTriggerChannelConditions, ps2000SetAdvTriggerDelay and related
functions.
Triggering is available in block mode and fast streaming mode
handle: the handle of the required oscilloscope
source: where to look for a trigger. Use PS2000_CHANNEL_A (0),
PS2000_CHANNEL_B (1) or PS2000_NONE(5). The number of channels
available depends on the oscilloscope.
threshold: the threshold for the trigger event. This is scaled in 16-bit ADC
counts at the currently selected range.
direction: use PS2000_RISING (0) or PS2000_FALLING (1)
delay: the delay, as a percentage of the requested number of data points,
between the trigger event and the start of the block. It should be in the
range -100% to +100%. Thus, 0% means that the trigger event is at the
first data value in the block, and -50% means that it is in the middle of the
block. If you wish to specify the delay as a floating-point value, use
ps2000_set_trigger2 instead. Note that if delay = 0 and you call
ps2000_stop before a trigger event occurs, the device will return no data.
auto_trigger_ms: the delay in milliseconds after which the oscilloscope
will collect samples if no trigger event occurs. If this is set to zero the
oscilloscope will wait for a trigger indefinitely.
0: if one of the parameters is out of range
non-zero: if successful
To Next Page
Loading...
