LibTiePie  0.9.13
Library for interfacing TiePie engineering instruments

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

Functions

uint32_t ScpChTrGetLevelModes (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the supported trigger level modes of a specified channel. More...
 
uint32_t ScpChTrGetLevelMode (LibTiePieHandle_t hDevice, uint16_t wCh)
 Get the current trigger level mode of a specified channel. More...
 
uint32_t ScpChTrSetLevelMode (LibTiePieHandle_t hDevice, uint16_t wCh, uint32_t dwLevelMode)
 Set the trigger level mode of a specified channel. More...
 

Function Documentation

uint32_t ScpChTrGetLevelModes ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the supported trigger level modes of a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
The supported trigger level modes, a set of OR-ed TLM_* values or TLMM_NONE when unsuccessful.
Status values
NOT_SUPPORTED The indicated channel does not support trigger with the current settings.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.6
uint32_t ScpChTrGetLevelMode ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Get the current trigger level mode of a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
The curretly set trigger level mode, a TLM_* value, or TLMM_NONE when unsuccessful.
Status values
NOT_SUPPORTED The indicated channel does not support trigger with the current settings.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.6
uint32_t ScpChTrSetLevelMode ( LibTiePieHandle_t  hDevice,
uint16_t  wCh,
uint32_t  dwLevelMode 
)

Set the trigger level mode of a specified channel.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]dwLevelModeThe requested trigger level mode, a TLM_* value.
Returns
The actually set trigger level mode, a TLM_* value, or TLMM_NONE when unsuccessful.
Status values
NOT_SUPPORTED The indicated channel does not support trigger with the current settings.
INVALID_VALUE The requested trigger level mode is invalid.
INVALID_CHANNEL The requested channel number is invalid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
OBJECT_GONE The object indicated by the handle is no longer available.
LIBRARY_NOT_INITIALIZEDThe library is not initialized, see LibInit().
SUCCESS The function executed successfully.
Since
0.6