Kind

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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The 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_INITIALIZED	The 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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The 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_INITIALIZED	The 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]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]	qwTriggerKind	The 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_INITIALIZED	The 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