Measurements

Functions to perform measurements. More...

Collaboration diagram for Measurements:

Modules
	Mode
	Functions for controlling the measure mode.
	Status
	Functions to check the measurement status.

Functions
TIEPIE_HW_API tiepie_hw_bool	tiepie_hw_oscilloscope_start (tiepie_hw_handle handle)
	Start a single measurement.
TIEPIE_HW_API tiepie_hw_bool	tiepie_hw_oscilloscope_stop (tiepie_hw_handle handle)
	Stop a running measurement.
TIEPIE_HW_API tiepie_hw_bool	tiepie_hw_oscilloscope_force_trigger (tiepie_hw_handle handle)
	Force a trigger.

Detailed Description

Functions to perform measurements.

Oscilloscopes can measure in block mode or in streaming mode. This is determined by the measure mode.

Several polling routines and callbacks are available to determine the measurement status.

Function Documentation

tiepie_hw_oscilloscope_start()

TIEPIE_HW_API tiepie_hw_bool tiepie_hw_oscilloscope_start

(

tiepie_hw_handle

handle

)

Start a single measurement.

Use the measurement status functions or callbacks to determine the status of a running measurement.

Parameters

[in]

handle

A device handle identifying the oscilloscope.

Returns

TIEPIE_HW_BOOL_TRUE if the measurement is started, TIEPIE_HW_BOOL_FALSE otherwise.

Status values

TIEPIE_HW_STATUS_UNSUCCESSFUL	The measurement could not be started.
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_MEASUREMENT_RUNNING
TIEPIE_HW_STATUS_SUCCESS

Since

1.0

tiepie_hw_oscilloscope_stop()

TIEPIE_HW_API tiepie_hw_bool tiepie_hw_oscilloscope_stop

(

tiepie_hw_handle

handle

)

Stop a running measurement.

Parameters

[in]

handle

A device handle identifying the oscilloscope.

Returns

TIEPIE_HW_BOOL_TRUE if the measurement is aborted, TIEPIE_HW_BOOL_FALSE otherwise.

Status values

TIEPIE_HW_STATUS_UNSUCCESSFUL	The measurement could not be stopped.
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_SUCCESS

Since

1.0

tiepie_hw_oscilloscope_force_trigger()

TIEPIE_HW_API tiepie_hw_bool tiepie_hw_oscilloscope_force_trigger

(

tiepie_hw_handle

handle

)

Force a trigger.

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. Use this function to force a trigger, independent from the input signal(s).

Parameters

[in]

handle

A device handle identifying the oscilloscope.

Returns

TIEPIE_HW_BOOL_TRUE if succeeded, TIEPIE_HW_BOOL_FALSE otherwise.

Status values

TIEPIE_HW_STATUS_UNSUCCESSFUL	The trigger could not be forced.
TIEPIE_HW_STATUS_NOT_SUPPORTED	The oscilloscope does not support force trigger.
TIEPIE_HW_STATUS_INVALID_HANDLE	The handle is not a valid oscilloscope handle.
TIEPIE_HW_STATUS_OBJECT_GONE
TIEPIE_HW_STATUS_LIBRARY_NOT_INITIALIZED
TIEPIE_HW_STATUS_SUCCESS

Returns

TIEPIE_HW_BOOL_TRUE if succeeded, TIEPIE_HW_BOOL_FALSE otherwise.

Since

1.0