The enabled state of a channel trigger determines whether a channel is selected as trigger source. More...

Collaboration diagram for Enabled:

Functions
TIEPIE_HW_API tiepie_hw_bool	tiepie_hw_oscilloscope_channel_trigger_get_enabled (tiepie_hw_handle handle, uint16_t ch)
	Check whether channel trigger for a specified channel is enabled.

TIEPIE_HW_API tiepie_hw_bool	tiepie_hw_oscilloscope_channel_trigger_set_enabled (tiepie_hw_handle handle, uint16_t ch, tiepie_hw_bool value)
	To select a channel as trigger source, set channel trigger enable.

Detailed Description

The enabled state of a channel trigger determines whether a channel is selected as trigger source.

Channel triggers of multiple channels can be enabled, in that case they will be OR'ed.

The enabled state can be affected by changing the channel enable, sample rate and/or resolution.

By default channel 1 is enabled, all other channels are disabled.

Function Documentation

TIEPIE_HW_API tiepie_hw_bool tiepie_hw_oscilloscope_channel_trigger_get_enabled	(	tiepie_hw_handle	handle,
		uint16_t	ch
	)

Check whether channel trigger for a specified channel is enabled.

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`.

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

TIEPIE_HW_API tiepie_hw_bool tiepie_hw_oscilloscope_channel_trigger_set_enabled	(	tiepie_hw_handle	handle,
		uint16_t	ch,
		tiepie_hw_bool	value
	)

To select a channel as trigger source, set channel trigger enable.

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	TIEPIE_HW_BOOL_TRUE or TIEPIE_HW_BOOL_FALSE.

Status values

TIEPIE_HW_STATUS_NOT_AVAILABLE
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

Remarks: Enabling the channel trigger may change the input range if trigger level mode is TIEPIE_HW_TLM_ABSOLUTE and auto ranging is enabled.