Trigger system

Functions
double	ScpGetTriggerTimeOut (TpDeviceHandle_t hDevice)
double	ScpSetTriggerTimeOut (TpDeviceHandle_t hDevice, double dTimeout)
double	ScpVerifyTriggerTimeOut (TpDeviceHandle_t hDevice, double dTimeout)
uint64_t	ScpGetTriggerSources (TpDeviceHandle_t hDevice)
uint64_t	ScpGetTriggerSourcesEx (TpDeviceHandle_t hDevice, uint32_t dwMeasureMode)
uint64_t	ScpGetTriggerSourceOR (TpDeviceHandle_t hDevice)
uint64_t	ScpSetTriggerSourceOR (TpDeviceHandle_t hDevice, uint64_t qwTriggerSourceMask)
uint64_t	ScpGetTriggerSourceAND (TpDeviceHandle_t hDevice)
uint64_t	ScpSetTriggerSourceAND (TpDeviceHandle_t hDevice, uint64_t qwTriggerSourceMask)
uint64_t	ScpGetTriggerKinds (TpDeviceHandle_t hDevice, uint64_t qwTriggerSourceMask)
uint64_t	ScpGetTriggerKindsEx (TpDeviceHandle_t hDevice, uint64_t qwTriggerSourceMask, uint32_t dwMeasureMode)
uint64_t	ScpGetTriggerKind (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource)
uint64_t	ScpSetTriggerKind (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource, uint64_t qwTriggerKind)
double	ScpGetTriggerLevel (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource, uint32_t dwIndex)
double	ScpSetTriggerLevel (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource, uint32_t dwIndex, double dLevel)
double	ScpGetTriggerHysteresis (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource, uint32_t dwIndex)
double	ScpSetTriggerHysteresis (TpDeviceHandle_t hDevice, uint64_t qwTriggerSource, uint32_t dwIndex, double dHysteresis)
uint64_t	ScpChGetTriggerKinds (TpDeviceHandle_t hDevice, uint16_t wCh)
uint64_t	ScpChGetTriggerKindsEx (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwMeasureMode)
uint64_t	ScpChGetTriggerKind (TpDeviceHandle_t hDevice, uint16_t wCh)
uint64_t	ScpChSetTriggerKind (TpDeviceHandle_t hDevice, uint16_t wCh, uint64_t qwTriggerKind)
double	ScpChGetTriggerLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex)
double	ScpChSetTriggerLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex, double dLevel)
double	ScpChGetTriggerHysteresis (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex)
double	ScpChSetTriggerHysteresis (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex, double dHysteresis)
double	ScpChGetTriggerPulseTime (TpDeviceHandle_t hDevice, uint16_t wCh)
double	ScpChSetTriggerPulseTime (TpDeviceHandle_t hDevice, uint16_t wCh, double dPulseTime)

---

Detailed Description

---

Function Documentation

double ScpChGetTriggerHysteresis	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex
	)

Get current trigger hysteresis

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dwIndex	...

Returns:

current trigger hysteresis: 0..1

uint64_t ScpChGetTriggerKind	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get current trigger kind for channel

See also:

Trigger kinds

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1

Returns:

TK_* value

uint64_t ScpChGetTriggerKinds	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get all available trigger kinds for channel

See also:

Trigger kinds

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1

Returns:

set of ORed TK_* values

uint64_t ScpChGetTriggerKindsEx	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwMeasureMode
	)

Get all available trigger kinds for channel

See also:

Trigger kinds

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dwMeasureMode	...

Returns:

set of ORed TK_* values

double ScpChGetTriggerLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex
	)

Get current trigger level

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dwIndex	...

Returns:

relative trigger level: 0..1

double ScpChGetTriggerPulseTime	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get current trigger pulse time

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1

Returns:

double ScpChSetTriggerHysteresis	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex,
		double	dHysteresis
	)

Set trigger hysteresis

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dwIndex	...
dHysteresis	trigger hysteresis: 0..1

Returns:

current trigger hysteresis: 0..1

uint64_t ScpChSetTriggerKind	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint64_t	qwTriggerKind
	)

Set trigger kind for channel

See also:

Trigger kinds

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
qwTriggerKind	trigger kind: a TK_* value

Returns:

TK_* value

double ScpChSetTriggerLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex,
		double	dLevel
	)

Set trigger level

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dwIndex	...
dLevel	trigger level: 0..1

Returns:

current trigger level: 0..1

double ScpChSetTriggerPulseTime	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		double	dPulseTime
	)

Set trigger pulse time

Parameters:

hDevice	a device handle
wCh	channel number: 0..ScpGetChannelCount() - 1
dPulseTime

Returns:

double ScpGetTriggerHysteresis	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource,
		uint32_t	dwIndex
	)

Get current trigger hysteresis

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value
dwIndex	...

Returns:

current trigger hysteresis: 0..1

uint64_t ScpGetTriggerKind	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource
	)

Get current trigger kind

See also:

Trigger kinds

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value

Returns:

TK_* value

uint64_t ScpGetTriggerKinds	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSourceMask
	)

Get available trigger kinds by source(s)

When getting available trigger kinds of multiple source the result is a set of ORed TK_* values which are supported by all sources.

See also:

Trigger kinds

Parameters:

hDevice	a device handle
qwTriggerSourceMask	TS_* value or multiple ORed TS_* values

Returns:

set of ORed TK_* values

uint64_t ScpGetTriggerKindsEx	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSourceMask,
		uint32_t	dwMeasureMode
	)

Get available trigger kinds by source(s)

When getting available trigger kinds of multiple source the result is a set of ORed TK_* values which are supported by all sources.

See also:

Trigger kinds

Parameters:

hDevice	a device handle
qwTriggerSourceMask	TS_* value or multiple ORed TS_* values
dwMeasureMode	...

Returns:

set of ORed TK_* values

double ScpGetTriggerLevel	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource,
		uint32_t	dwIndex
	)

Get current trigger level

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value
dwIndex	...

Returns:

relative trigger level: 0..1

uint64_t ScpGetTriggerSourceAND

(

TpDeviceHandle_t

hDevice

)

Set trigger sources AND

See also:

Trigger sources

Parameters:

hDevice

a device handle

Returns:

current trigger sources, set of ORed TS_* values

uint64_t ScpGetTriggerSourceOR

(

TpDeviceHandle_t

hDevice

)

Get current trigger sources OR

See also:

Trigger sources

Parameters:

hDevice

a device handle

Returns:

current trigger sources, set of ORed TS_* values

uint64_t ScpGetTriggerSources

(

TpDeviceHandle_t

hDevice

)

Get supported trigger sources

See also:

Trigger sources

Parameters:

hDevice

a device handle

Returns:

supported trigger sources, set of ORed TK_* values

uint64_t ScpGetTriggerSourcesEx	(	TpDeviceHandle_t	hDevice,
		uint32_t	dwMeasureMode
	)

Get supported trigger sources

See also:

Trigger sources

Parameters:

hDevice	a device handle
dwMeasureMode	...

Returns:

supported trigger sources, set of ORed TK_* values

double ScpGetTriggerTimeOut

(

TpDeviceHandle_t

hDevice

)

Get current trigger timeout in seconds

See also:

to

Parameters:

hDevice

a device handle

Returns:

trigger timeout in seconds or TO_INFINITY

double ScpSetTriggerHysteresis	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource,
		uint32_t	dwIndex,
		double	dHysteresis
	)

Set trigger hysteresis

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value
dwIndex	...
dHysteresis	trigger hysteresis: 0..1

Returns:

current trigger hysteresis: 0..1

uint64_t ScpSetTriggerKind	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource,
		uint64_t	qwTriggerKind
	)

Set trigger kind

See also:

Trigger kinds

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value
qwTriggerKind	trigger kind: a TK_* value

Returns:

TK_* value

double ScpSetTriggerLevel	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSource,
		uint32_t	dwIndex,
		double	dLevel
	)

Set trigger level

Parameters:

hDevice	a device handle
qwTriggerSource	TS_* value
dwIndex	...
dLevel	trigger level: 0..1

Returns:

current trigger level: 0..1

uint64_t ScpSetTriggerSourceAND	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSourceMask
	)

Get current trigger sources AND

See also:

Trigger sources

Parameters:

hDevice	a device handle
qwTriggerSourceMask	trigger sources, set of ORed TK_* values

Returns:

current trigger sources, set of ORed TS_* values

uint64_t ScpSetTriggerSourceOR	(	TpDeviceHandle_t	hDevice,
		uint64_t	qwTriggerSourceMask
	)

Set trigger sources OR

See also:

Trigger sources

Parameters:

hDevice	a device handle
qwTriggerSourceMask	trigger sources, set of ORed TK_* values

Returns:

current trigger sources, set of ORed TS_* values

double ScpSetTriggerTimeOut	(	TpDeviceHandle_t	hDevice,
		double	dTimeout
	)

Set trigger timeout in seconds

See also:

to

Parameters:

hDevice	a device handle
dTimeout	trigger timeout in seconds or TO_INFINITY

Returns:

trigger timeout in seconds or TO_INFINITY

double ScpVerifyTriggerTimeOut	(	TpDeviceHandle_t	hDevice,
		double	dTimeout
	)

Verify trigger timeout in seconds

See also:

to

Parameters:

hDevice	a device handle
dTimeout	trigger timeout in seconds or TO_INFINITY

Returns:

trigger timeout in seconds or TO_INFINITY