libtiepie-hw  1.1.3

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

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:

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]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 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]handleA device handle identifying the oscilloscope.
[in]chThe 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]handleA device handle identifying the oscilloscope.
[in]chThe channel number identifying the channel, 0 to tiepie_hw_oscilloscope_get_channel_count() - 1.
[in]valueThe 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