Description

The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal.

The number of available trigger levels depends on the currently set trigger kind. Use ScpChTrGetLevelCount() to determine the number of trigger levels for the currently set trigger kind.

The trigger level is set as a floating point value between 0 and 1, corresponding to a percentage of the full scale input range:

0.0 (0%) equals -full scale
0.5 (50%) equals mid level or 0 Volt
1.0 (100%) equals full scale.

By default the trigger level is set to 0.5 (50%) of the full-scale range.

Functions
uint32_t	ScpChTrGetLevelCount (TpDeviceHandle_t hDevice, uint16_t wCh)
	Get the number of channel trigger levels for a specified channel with the currently selected trigger kind. More...

double	ScpChTrGetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex)
	Get the currently set channel trigger level value for a specified channel and trigger level. More...

double	ScpChTrSetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex, double dLevel)
	Set the channel trigger level value for a specified channel and trigger level. More...

Function Documentation

uint32_t ScpChTrGetLevelCount	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get the number of channel trigger levels 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 number of available trigger levels for the currently set trigger kind.

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; ScpChTrGetLevel; ScpChTrSetLevel

Since: 0.4.1

double ScpChTrGetLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex
	)

Get the currently set channel trigger level value for a specified channel and trigger level.

Parameters

[in]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The channel number identifying the channel, `0` to `ScpGetChannelCount() - 1`.
[in]	dwIndex	The trigger level index, `0` to `ScpChTrGetLevelCount() - 1`.

Returns: The currently set trigger level value, a number between 0 and 1.

Status values

NOT_SUPPORTED	The indicated channel does not support trigger (level) with the current settings.
INVALID_INDEX	The trigger level index is invalid.
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: ScpChTrGetLevelCount; ScpChTrSetLevel

Since: 0.4.1

double ScpChTrSetLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex,
		double	dLevel
	)

Set the channel trigger level value for a specified channel and trigger level.

Parameters

[in]	hDevice	A device handle identifying the oscilloscope.
[in]	wCh	The channel number identifying the channel, `0` to `ScpGetChannelCount() - 1`.
[in]	dwIndex	The trigger level index, `0` to `ScpChTrGetLevelCount() - 1`.
[in]	dLevel	The required trigger level, a number between `0` and `1`.

Returns: The actually set trigger level, a number between 0 and 1.

Status values

VALUE_CLIPPED	The requested trigger level is outside the valid range and clipped to the closest limit.
NOT_SUPPORTED	The indicated channel does not support trigger (level) with the current settings.
INVALID_INDEX	The trigger level index is invalid.
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: ScpChTrGetLevelCount; ScpChTrGetLevel

Since: 0.4.1

Description

Functions

Function Documentation