Timeout

This section contains trigger timeout related functions. More...

Functions
double	ScpGetTriggerTimeOut (TpDeviceHandle_t hDevice)
	Get the currently selected trigger timeout in seconds.
double	ScpSetTriggerTimeOut (TpDeviceHandle_t hDevice, double dTimeout)
	Set trigger timeout in seconds.

Detailed Description

This section contains trigger timeout related functions.

Trigger time-out defines the time that the system will wait for a trigger before a trigger is forced.

If the trigger conditions are set in such a way that the input signal(s) will never meet the trigger settings, the instrument will wait forever. When no measurement is performed, no signals will be displayed. To avoid that the system will wait infinitely, a trigger time-out is added to the trigger system. When after a user defined amount of time after starting the measurement still no trigger has occurred, the trigger time-out will force a trigger. This will ensure a minimum number of measurements per second.

The trigger time-out is entered as a number, representing the delay in seconds. There are two special values for the trigger time-out setting:

• trigger time-out = 0 Immediately after starting a measurement a trigger is forced. Basically this bypasses the trigger system and the instrument always measures immediately. No pre samples are recorded. The instrument is free-running, just like when no trigger source is selected.
• trigger-time-out = infinite (TO_INFINITY) The system will wait infinitely for a trigger. The software will never force a trigger, only when the trigger conditions are met, a trigger will occur and a measurement will take place. This setting is particularly useful for single shot measurements. On conventional desktop oscilloscopes, this is called Trigger mode NORM.

By default the trigger timeout is set to: 0.1 s (100 ms).

Function Documentation

double ScpGetTriggerTimeOut

(

TpDeviceHandle_t

hDevice

)

Get the currently selected trigger timeout in seconds.

Parameters

hDevice

A device handle.

Returns

Trigger timeout in seconds, or TO_INFINITY.

double ScpSetTriggerTimeOut	(	TpDeviceHandle_t	hDevice,
		double	dTimeout
	)

Set trigger timeout in seconds.

Parameters

hDevice	A device handle.
dTimeout	The required trigger timeout in seconds, or TO_INFINITY.

Returns

The actually set trigger timeout in seconds, or TO_INFINITY.