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 (TpDeviceHandle_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 (TpDeviceHandle_t hDevice, uint16_t wCh)
	Get the currently selected channel trigger kind for a specified channel. More...
uint64_t	ScpChTrSetKind (TpDeviceHandle_t hDevice, uint16_t wCh, uint64_t qwTriggerKind)
	Set the channel trigger kind for a specified channel. More...

Function Documentation

uint64_t ScpChTrGetKinds	(	TpDeviceHandle_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 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.
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	(	TpDeviceHandle_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 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.
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	(	TpDeviceHandle_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 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.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also

ScpChTrGetKinds

ScpChTrGetKind

Since

0.4.1