Description

Functions for controlling the trigger level mode.

The trigger level can be set in two different ways, indicated by the trigger level mode:

TLM_RELATIVE, the trigger level is set as a floating point value between 0 and 1, corresponding to a percentage of the full scale input range.
TLM_ABSOLUTE, the trigger level is set as a floating point value, clipped by the full scale input range.

When trigger level mode is set to TLM_RELATIVE and auto ranging of the channel is enabled, the trigger level will remain at the same percentage when the input range changes, resulting in a different absolute voltage.

When trigger level mode is set to TLM_ABSOLUTE and auto ranging of the channel is enabled, the trigger level will remain at the same absolute voltage level when the input range changes. The input range will not auto range to a range that is smaller than the selected trigger level.

By default the trigger level mode is set to TLM_RELATIVE.

Functions
uint32_t	ScpChTrGetLevelModes (LibTiePieHandle_t hDevice, uint16_t wCh)
	Get the supported trigger level modes of a specified channel. More...

uint32_t	ScpChTrGetLevelMode (LibTiePieHandle_t hDevice, uint16_t wCh)
	Get the current trigger level mode of a specified channel. More...

uint32_t	ScpChTrSetLevelMode (LibTiePieHandle_t hDevice, uint16_t wCh, uint32_t dwLevelMode)
	Set the trigger level mode of a specified channel. More...

Function Documentation

uint32_t ScpChTrGetLevelModes	(	LibTiePieHandle_t	hDevice,
		uint16_t	wCh
	)

Get the supported trigger level modes of 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 supported trigger level modes, a set of OR-ed TLM_* values or TLMM_NONE when unsuccessful.

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.

Since: 0.6

uint32_t ScpChTrGetLevelMode	(	LibTiePieHandle_t	hDevice,
		uint16_t	wCh
	)

Get the current trigger level mode of 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 curretly set trigger level mode, a TLM_* value, or TLMM_NONE when unsuccessful.

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.

Since: 0.6

uint32_t ScpChTrSetLevelMode	(	LibTiePieHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwLevelMode
	)

Set the trigger level mode of 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]	dwTriggerLevelMode	The requested trigger level mode, a TLM_* value.

Returns: The actually set trigger level mode, a TLM_* value, or TLMM_NONE when unsuccessful.

Status values

NOT_SUPPORTED	The indicated channel does not support trigger with the current settings.
INVALID_VALUE	The requested trigger level mode is invalid.
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.

Since: 0.6