Installation guide

PicoScope 4000 Series (A API) Programmer's Guide 77

4.52

ps4000aSetTriggerChannelConditions

PICO_STATUS ps4000aSetTriggerChannelConditions

(

int16_t handle,

PS4000A_CONDITION * conditions,

int16_t nConditions,

PS4000A_CONDITIONS_INFO info

)

This function sets up trigger conditions on the scope's inputs. The trigger is set up by

defining an array of one or more PS4000A_CONDITION structures that are then

ANDed together. The function can be called multiple times, in which case the trigger

logic is ORed with that defined by previous calls. This AND-OR logic allows you to

create any possible Boolean function of the scope's inputs.

Applicability

All modes

Arguments

handle, the handle of the required device.

* conditions, an array of PS4000A_CONDITION structures

specifying the conditions that should be applied to each channel. In

the simplest case, the array consists of a single element. When there

are several elements, the overall trigger condition is the logical AND

of all the elements.

nConditions, the number of elements in the conditions array,

or zero to switch off triggering.

info, determines whether the function clears previous conditions:

PS4000A_CLEAR, clears previous conditions

PS4000A_ADD, adds the specified conditions (ORing them with

previously set conditions, if any)

You can combine both actions by passing

(PS4000A_CONDITIONS_INFO)(PS4000A_CLEAR |

PS4000A_ADD).

Returns

PICO_OK

PICO_INVALID_HANDLE

PICO_USER_CALLBACK

PICO_CONDITIONS

PICO_MEMORY_FAIL