LibTiePie  0.7.1
Library for interfacing TiePie engineering instruments

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 frequency and/or resolution.

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

Functions

bool8_t ScpChTrGetEnabled (LibTiePieHandle_t hDevice, uint16_t wCh)
 Check whether channel trigger for a specified channel is enabled. More...
 
bool8_t ScpChTrSetEnabled (LibTiePieHandle_t hDevice, uint16_t wCh, bool8_t bEnable)
 To select a channel as trigger source, set channel trigger enable. More...
 

Function Documentation

bool8_t ScpChTrGetEnabled ( LibTiePieHandle_t  hDevice,
uint16_t  wCh 
)

Check whether channel trigger for a specified channel is enabled.

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
BOOL8_TRUE if enabled, BOOL8_FALSE otherwise.
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.
See also
ScpChTrSetEnabled
Since
0.4.2
bool8_t ScpChTrSetEnabled ( LibTiePieHandle_t  hDevice,
uint16_t  wCh,
bool8_t  bEnable 
)

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

Parameters
[in]hDeviceA device handle identifying the oscilloscope.
[in]wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
[in]bEnableBOOL8_TRUE or BOOL8_FALSE.
Returns
BOOL8_TRUE if enabled, BOOL8_FALSE otherwise.
Status values
NOT_AVAILABLE With the current settings, the requested functionality is not available.
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.
Remarks
Enabling the channel trigger may change the input range if trigger level mode is TLM_ABSOLUTE and auto ranging is enabled.
See also
ScpChTrGetEnabled
Since
0.4.2