LibTiePie  0.4.4
Library for interfacing TiePie engineering instruments
 All Files Functions Typedefs Macros Groups Pages
Level

The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal. More...

Functions

uint32_t ScpChTrGetLevelCount (TpDeviceHandle_t hDevice, uint16_t wCh)
 Get the number of trigger levels for a specified channel with the current trigger kind.
 
double ScpChTrGetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex)
 Get the currently set channel trigger level value for a specified channel and trigger level.
 
double ScpChTrSetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex, double dLevel)
 Set the channel trigger level value for a specified channel and trigger level.
 

Detailed Description

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 ScpChTrGetLevelCount to determine the number of trigger levels for the currently set trigger kind.

The trigger level is set as a floating point value between 0 and 1, corresponding to a percentage of the full scale input range:

By default the trigger level is set to 0.5 (50%) of the full-scale range.

Function Documentation

uint32_t ScpChTrGetLevelCount ( TpDeviceHandle_t  hDevice,
uint16_t  wCh 
)

Get the number of trigger levels for a specified channel with the current trigger kind.

Parameters
hDeviceA device handle.
wChChannel number, 0 to ScpGetChannelCount() - 1.
Returns
The number of available trigger levels for the currently set trigger kind.
See Also
ScpChTrGetKind
ScpChTrGetLevel
ScpChTrSetLevel
Since
0.4.1
double ScpChTrGetLevel ( TpDeviceHandle_t  hDevice,
uint16_t  wCh,
uint32_t  dwIndex 
)

Get the currently set channel trigger level value for a specified channel and trigger level.

Parameters
hDeviceA device handle.
wChChannel number, 0 to ScpGetChannelCount() - 1.
dwIndexTrigger level index, 0 to ScpChTrGetLevelCount() - 1.
Returns
The currently set trigger level value, a number between 0 and 1.
Since
0.4.1
double ScpChTrSetLevel ( TpDeviceHandle_t  hDevice,
uint16_t  wCh,
uint32_t  dwIndex,
double  dLevel 
)

Set the channel trigger level value for a specified channel and trigger level.

Parameters
hDeviceA device handle.
wChChannel number, 0 to ScpGetChannelCount() - 1.
dwIndexTrigger level index, 0 to ScpChTrGetLevelCount() - 1.
dLevelThe required trigger level, a number between 0 and 1.
Returns
The actually set trigger level, a number between 0 and 1.
Since
0.4.1