Level mode

Functions for controlling the trigger level mode. More...

Collaboration diagram for Level mode:

Functions
TIEPIE_HW_API uint32_t	tiepie_hw_oscilloscope_channel_trigger_get_level_modes (tiepie_hw_handle handle, uint16_t ch)
	Get the supported trigger level modes of a specified channel.
TIEPIE_HW_API uint32_t	tiepie_hw_oscilloscope_channel_trigger_get_level_mode (tiepie_hw_handle handle, uint16_t ch)
	Get the current trigger level mode of a specified channel.
TIEPIE_HW_API uint32_t	tiepie_hw_oscilloscope_channel_trigger_set_level_mode (tiepie_hw_handle handle, uint16_t ch, uint32_t value)
	Set the trigger level mode of a specified channel.

Detailed Description

Functions for controlling the trigger level mode.

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

• TIEPIE_HW_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.
• TIEPIE_HW_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 TIEPIE_HW_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 TIEPIE_HW_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 TIEPIE_HW_TLM_RELATIVE.

Function Documentation

tiepie_hw_oscilloscope_channel_trigger_get_level_modes()

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_level_modes	(	tiepie_hw_handle	handle,
		uint16_t	ch
	)

Get the supported trigger level modes of a specified channel.

Parameters

[in]	handle	A device handle identifying the oscilloscope.
[in]	ch	The channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.

Returns

The supported trigger level modes, a set of OR-ed TIEPIE_HW_TLM_* values or TIEPIE_HW_TLMM_NONE when unsuccessful.

Status values

TIEPIE_HW_STATUS_NOT_SUPPORTED	The indicated channel does not support trigger with the current settings.
TIEPIE_HW_STATUS_INVALID_CHANNEL
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_SUCCESS

Since

1.0

tiepie_hw_oscilloscope_channel_trigger_get_level_mode()

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_level_mode	(	tiepie_hw_handle	handle,
		uint16_t	ch
	)

Get the current trigger level mode of a specified channel.

Parameters

[in]	handle	A device handle identifying the oscilloscope.
[in]	ch	The channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.

Returns

The curretly set trigger level mode, a TIEPIE_HW_TLM_* value, or TIEPIE_HW_TLMM_NONE when unsuccessful.

Status values

TIEPIE_HW_STATUS_NOT_SUPPORTED	The indicated channel does not support trigger with the current settings.
TIEPIE_HW_STATUS_INVALID_CHANNEL
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_SUCCESS

Since

1.0

tiepie_hw_oscilloscope_channel_trigger_set_level_mode()

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_set_level_mode	(	tiepie_hw_handle	handle,
		uint16_t	ch,
		uint32_t	value
	)

Set the trigger level mode of a specified channel.

Parameters

[in]	handle	A device handle identifying the oscilloscope.
[in]	ch	The channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.
[in]	value	The requested trigger level mode, a TIEPIE_HW_TLM_* value.

Returns

The actually set trigger level mode, a TIEPIE_HW_TLM_* value, or TIEPIE_HW_TLMM_NONE when unsuccessful.

Status values

TIEPIE_HW_STATUS_NOT_SUPPORTED	The indicated channel does not support trigger with the current settings.
TIEPIE_HW_STATUS_INVALID_VALUE	The requested trigger level mode is invalid.
TIEPIE_HW_STATUS_INVALID_CHANNEL
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_SUCCESS

Since

1.0