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: greater than (TC_GREATER).

Functions
uint32_t	ScpChTrGetConditions (TpDeviceHandle_t hDevice, uint16_t wCh)
	Get the supported trigger conditions for a specified channel with the currently selected trigger kind. More...

uint32_t	ScpChTrGetCondition (TpDeviceHandle_t hDevice, uint16_t wCh)
	Get the current selected trigger condition for a specified channel. More...

uint32_t	ScpChTrSetCondition (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwCondition)
	Set the trigger condition for a specified channel. More...

Function Documentation

uint32_t ScpChTrGetConditions	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

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

Parameters

hDevice	A device handle identifying the oscilloscope.
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 not valid.
INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

See also: ScpChGetTriggerKind; ScpChTrGetCondition; ScpChTrSetCondition

Since: 0.4.1

uint32_t ScpChTrGetCondition	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get the current selected trigger condition for a specified channel.

Parameters

hDevice	A device handle identifying the oscilloscope.
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 not valid.
INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

See also: ScpChTrGetConditions; ScpChTrSetCondition

Since: 0.4.1

uint32_t ScpChTrSetCondition	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwCondition
	)

Set the trigger condition for a specified channel.

Parameters

hDevice	A device handle identifying the oscilloscope.
wCh	The channel number identifying the channel, `0` to `ScpGetChannelCount() - 1`.
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 not valid.
INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
SUCCESS	The function executed successfully.

See also: ScpChTrGetConditions; ScpChTrGetCondition

Since: 0.4.1

Description

Functions

Function Documentation