LibTiePie  0.9.16
Library for interfacing TiePie engineering instruments

Description

Some trigger kinds require an additional condition to indicate how the channel trigger must respond to the input signal.

The available trigger conditions depend on the currently set trigger kind. Use ScpChTrGetConditions() to determine the available trigger conditions for the currently selected trigger kind. Read more on trigger condition.

By default the trigger condition is set to: larger than (TC_LARGER).

Functions

uint32_t ScpChTrGetConditions (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the supported trigger conditions for a specified channel with the currently selected trigger kind. More...
 
uint32_t ScpChTrGetCondition (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the current selected trigger condition for a specified channel. More...
 
uint32_t ScpChTrSetCondition (LibTiePieHandle_t hDevice, uint16_t wCh, uint32_t dwCondition)
 Set the trigger condition for a specified channel. More...
 

Function Documentation

uint32_t ScpChTrGetConditions ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the supported trigger conditions for a specified channel with the currently selected trigger kind.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
The supported trigger conditions for this channel and trigger kind, a set of OR-ed TC_* values.
Status values
NOT_SUPPORTED The indicated channel does not support trigger with the current settings.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
See also
ScpChTrGetKind
ScpChTrGetCondition
ScpChTrSetCondition
Since
0.4.1
uint32_t ScpChTrGetCondition ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the current selected trigger condition for a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
The current trigger condition, a TC_* value.
Status values
NOT_SUPPORTED The indicated channel does not support trigger (condition) with the current settings.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
See also
ScpChTrGetConditions
ScpChTrSetCondition
Since
0.4.1
uint32_t ScpChTrSetCondition ( LibTiePieHandle_t  hDevice,
uint16_t  wCh,
uint32_t  dwCondition 
)

Set the trigger condition for a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]dwConditionThe required trigger condition, a TC_* value.
Returns
The actually set trigger condition, a TC_* value.
Status values
INVALID_VALUE The requested trigger condition is invalid.
NOT_SUPPORTED The indicated channel does not support trigger (condition) with the current settings.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
See also
ScpChTrGetConditions
ScpChTrGetCondition
Since
0.4.1