LibTiePie  0.9.12
Library for interfacing TiePie engineering instruments

Description

The channel trigger kind property is used to control how the channel trigger responds to the channel input signal.

Use ScpChTrGetKinds() to find out which trigger kinds are supported by the channel. Depending on the selected trigger kind, other properties like e.g. level(s) and hysteresis are available to configure the channel trigger. Read more on trigger kind.

By default kind is set to rising edge (TK_RISINGEDGE).

Functions

uint64_t ScpChTrGetKinds (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the supported channel trigger kinds for a specified channel with the currently selected measure mode. More...
 
uint64_t ScpChTrGetKind (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the currently selected channel trigger kind for a specified channel. More...
 
uint64_t ScpChTrSetKind (LibTiePieHandle_t hDevice, uint16_t wCh, uint64_t qwTriggerKind)
 Set the channel trigger kind for a specified channel. More...
 

Function Documentation

uint64_t ScpChTrGetKinds ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the supported channel trigger kinds for a specified channel with the currently selected measure mode.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
The supported trigger kinds, a set of OR-ed TK_* values or TKM_NONE if the channel has no trigger support.
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
ScpChTrSetKind
Since
0.4.1
uint64_t ScpChTrGetKind ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the currently selected channel trigger kind 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 kind, a TK_* value.
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
ScpChTrGetKinds
ScpChTrSetKind
Since
0.4.1
uint64_t ScpChTrSetKind ( LibTiePieHandle_t  hDevice,
uint16_t  wCh,
uint64_t  qwTriggerKind 
)

Set the channel trigger kind for a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]qwTriggerKindThe required trigger kind: a TK_* value.
Returns
The actually set trigger kind, a TK_* value.
Status values
INVALID_VALUE The requested trigger kind is invalid.
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.
Remarks
Changing the channel trigger kind may change the input range if the channel trigger is enabled, trigger level mode is TLM_ABSOLUTE and auto ranging is enabled.
See also
ScpChTrGetKinds
ScpChTrGetKind
Since
0.4.1