libtiepie-hw  1.2.0

Some trigger kinds require an additional condition to indicate how the channel trigger must respond to the input signal. More...

Collaboration diagram for Condition:

Functions

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_conditions (tiepie_hw_handle handle, uint16_t ch)
 Get the supported trigger conditions for a specified channel with the currently selected trigger kind. More...
 
TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_condition (tiepie_hw_handle handle, uint16_t ch)
 Get the current selected trigger condition for a specified channel. More...
 
TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_set_condition (tiepie_hw_handle handle, uint16_t ch, uint32_t value)
 Set the trigger condition for a specified channel. More...
 

Detailed Description

Some trigger kinds require an additional condition to indicate how the channel trigger must respond to the input signal.

The available trigger conditions depend on the currently set trigger kind. Use tiepie_hw_oscilloscope_channel_trigger_get_conditions() to determine the available trigger conditions for the currently selected trigger kind. Read more on trigger condition.

By default the trigger condition is set to: larger than (TIEPIE_HW_TC_LARGER).

Function Documentation

◆ tiepie_hw_oscilloscope_channel_trigger_get_conditions()

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_conditions ( tiepie_hw_handle  handle,
uint16_t  ch 
)

Get the supported trigger conditions for a specified channel with the currently selected trigger kind.

Parameters
[in]handleA device handle identifying the oscilloscope.
[in]chThe channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.
Returns
The supported trigger conditions for this channel and trigger kind, a set of OR-ed TIEPIE_HW_TC_* values.
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
See also
tiepie_hw_oscilloscope_channel_trigger_get_kind
tiepie_hw_oscilloscope_channel_trigger_get_condition
tiepie_hw_oscilloscope_channel_trigger_set_condition
Since
1.0

◆ tiepie_hw_oscilloscope_channel_trigger_get_condition()

TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_condition ( tiepie_hw_handle  handle,
uint16_t  ch 
)

Get the current selected trigger condition for a specified channel.

Parameters
[in]handleA device handle identifying the oscilloscope.
[in]chThe channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.
Returns
The current trigger condition, a TIEPIE_HW_TC_* value.
Status values
TIEPIE_HW_STATUS_NOT_SUPPORTED The indicated channel does not support trigger (condition) 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
See also
tiepie_hw_oscilloscope_channel_trigger_get_conditions
tiepie_hw_oscilloscope_channel_trigger_set_condition
Since
1.0

◆ tiepie_hw_oscilloscope_channel_trigger_set_condition()

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

Set the trigger condition for a specified channel.

Parameters
[in]handleA device handle identifying the oscilloscope.
[in]chThe channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.
[in]valueThe required trigger condition, a TIEPIE_HW_TC_* value.
Returns
The actually set trigger condition, a TIEPIE_HW_TC_* value.
Status values
TIEPIE_HW_STATUS_INVALID_VALUE The requested trigger condition is invalid.
TIEPIE_HW_STATUS_NOT_SUPPORTED The indicated channel does not support trigger (condition) 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
See also
tiepie_hw_oscilloscope_channel_trigger_get_conditions
tiepie_hw_oscilloscope_channel_trigger_get_condition
Since
1.0