libtiepie-hw
1.1.3
|
The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal. More...
Functions | |
TIEPIE_HW_API uint32_t | tiepie_hw_oscilloscope_channel_trigger_get_level_count (tiepie_hw_handle handle, uint16_t ch) |
Get the number of channel trigger levels for a specified channel with the currently selected trigger kind. More... | |
TIEPIE_HW_API double | tiepie_hw_oscilloscope_channel_trigger_get_level (tiepie_hw_handle handle, uint16_t ch, uint32_t index) |
Get the currently set channel trigger level value for a specified channel and trigger level. More... | |
TIEPIE_HW_API double | tiepie_hw_oscilloscope_channel_trigger_set_level (tiepie_hw_handle handle, uint16_t ch, uint32_t index, double value) |
Set the channel trigger level value for a specified channel and trigger level. More... | |
The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal.
The number of available trigger levels depends on the currently set trigger kind. Use tiepie_hw_oscilloscope_channel_trigger_get_level_count() to determine the number of trigger levels for the currently set trigger kind.
If the trigger level mode is 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:
If the trigger level mode is TIEPIE_HW_TLM_ABSOLUTE, the trigger level is set as a floating point value, clipped by the full scale input range.
By default the trigger level is set to 0.5 (50%) of the full-scale range.
TIEPIE_HW_API uint32_t tiepie_hw_oscilloscope_channel_trigger_get_level_count | ( | tiepie_hw_handle | handle, |
uint16_t | ch | ||
) |
Get the number of channel trigger levels for a specified channel with the currently selected trigger kind.
[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 . |
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 double tiepie_hw_oscilloscope_channel_trigger_get_level | ( | tiepie_hw_handle | handle, |
uint16_t | ch, | ||
uint32_t | index | ||
) |
Get the currently set channel trigger level value for a specified channel and trigger level.
[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] | index | The trigger level index, 0 to Scp_chTr_get_level_count() - 1 . |
TIEPIE_HW_STATUS_NOT_SUPPORTED | The indicated channel does not support trigger (level) with the current settings. |
TIEPIE_HW_STATUS_INVALID_INDEX | The trigger level index 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 |
TIEPIE_HW_API double tiepie_hw_oscilloscope_channel_trigger_set_level | ( | tiepie_hw_handle | handle, |
uint16_t | ch, | ||
uint32_t | index, | ||
double | value | ||
) |
Set the channel trigger level value for a specified channel and trigger level.
[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] | index | The trigger level index, 0 to Scp_chTr_get_level_count() - 1 . |
[in] | value | The required trigger level. |
TIEPIE_HW_STATUS_VALUE_CLIPPED | The requested trigger level is outside the valid range and clipped to the closest limit. |
TIEPIE_HW_STATUS_NOT_SUPPORTED | The indicated channel does not support trigger (level) with the current settings. |
TIEPIE_HW_STATUS_INVALID_INDEX | The trigger level index 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 |