LibTiePie  0.4.5
Library for interfacing TiePie engineering instruments
 All Files Functions Typedefs Macros Modules Pages

Description

Functions to control the trigger settings of an input channel.

Depending on the settings of the oscilloscope, a channel trigger may not be supported or temporarily unavailable. In streaming measure mode, channel trigger is not supported, use ScpChHasTrigger() to check if triggering is supported in the currently set measure mode. When channel trigger is supported, it can be temporarily unavailable due to other settings like e.g. sample frequency, resolution and/or the number of enabled channels, use ScpChTrIsAvailable() to check if the trigger is available.

To use a channel as trigger source, the channel must be enabled.

Modules

 Enabled
 The enabled state of a channel trigger determines whether a channel is selected as trigger source.
 
 Kind
 The channel trigger kind property is used to control how the channel trigger responds to the channel input signal.
 
 Level
 The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal.
 
 Hysteresis
 The channel trigger hysteresis property is used to control the sensitivity of the trigger system.
 
 Condition
 Some trigger kinds require an additional condition to indicate how the channel trigger must respond to the input signal.
 
 Time
 The Time property determines how long a specific condition must last for the channel trigger to respond.
 

Functions

bool8_t ScpChHasTrigger (TpDeviceHandle_t hDevice, uint16_t wCh)
 Check whether the specified channel has trigger support with the currently selected measure mode. More...
 
bool8_t ScpChTrIsAvailable (TpDeviceHandle_t hDevice, uint16_t wCh)
 Check whether the channel trigger for the specified channel is available, with the current oscilloscope settings. More...
 

Function Documentation

bool8_t ScpChHasTrigger ( TpDeviceHandle_t  hDevice,
uint16_t  wCh 
)

Check whether the specified channel has trigger support with the currently selected measure mode.

Parameters
hDeviceA device handle identifying the oscilloscope.
wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
BOOL8_TRUE if the channel has trigger support, BOOL8_FALSE otherwise.
Status values
INVALID_CHANNELThe requested channel number is not valid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
DEVICE_GONE The device indicated by the device handle is no longer available.
SUCCESS The function executed successfully.
Since
0.4.2
bool8_t ScpChTrIsAvailable ( TpDeviceHandle_t  hDevice,
uint16_t  wCh 
)

Check whether the channel trigger for the specified channel is available, with the current oscilloscope settings.

Parameters
hDeviceA device handle identifying the oscilloscope.
wChThe channel number identifying the channel, 0 to ScpGetChannelCount() - 1.
Returns
BOOL8_TRUE if available, BOOL8_FALSE otherwise.
Status values
INVALID_CHANNELThe requested channel number is not valid.
INVALID_HANDLE The handle is not a valid oscilloscope handle.
DEVICE_GONE The device indicated by the device handle is no longer available.
SUCCESS The function executed successfully.
Since
0.4.4