Condition

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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The 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_INITIALIZED	The 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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The 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_INITIALIZED	The 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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]	dwCondition	The 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_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also

ScpChTrGetConditions

ScpChTrGetCondition

Since

0.4.1