Measurements
[Oscilloscope]

Functions
void	ScpStart (TpDeviceHandle_t hDevice, int64_t iMeasurmentCount)
void	ScpStop (TpDeviceHandle_t hDevice, int64_t iMeasurmentCount)
void	ScpForceTrigger (TpDeviceHandle_t hDevice)
bool8_t	ScpIsReady (TpDeviceHandle_t hDevice)
bool8_t	ScpIsRunning (TpDeviceHandle_t hDevice)
bool8_t	ScpIsTriggered (TpDeviceHandle_t hDevice)
uint32_t	ScpGetMeasureMode (TpDeviceHandle_t hDevice)
uint32_t	ScpSetMeasureMode (TpDeviceHandle_t hDevice, uint32_t dwMeasureMode)
double	ScpChGetDataValueMin (TpDeviceHandle_t hDevice, uint16_t wCh)
double	ScpChGetDataValueMax (TpDeviceHandle_t hDevice, uint16_t wCh)
uint64_t	ScpChGetData (TpDeviceHandle_t hDevice, uint16_t wCh, float *pBuffer, uint64_t qwSampleCount)
uint64_t	ScpChGetDataRaw8 (TpDeviceHandle_t hDevice, uint16_t wCh, uint8_t *pBuffer, uint64_t qwSampleCount)
uint64_t	ScpChGetDataRaw16 (TpDeviceHandle_t hDevice, uint16_t wCh, uint16_t *pBuffer, uint64_t qwSampleCount)

---

Function Documentation

uint64_t ScpChGetData	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		float *	pBuffer,
		uint64_t	qwSampleCount
	)

Get measure data in Volts/Ampere/Ohm (based on coupling)

Parameters:

	hDevice	a device handle
	wCh	channel number: 0..ScpGetChannelCount() - 1
	pBuffer	buffer to write samples to
	qwSampleCount	number of samples to write into buffer

Returns:

number of samples ready

uint64_t ScpChGetDataRaw16	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint16_t *	pBuffer,
		uint64_t	qwSampleCount
	)

Get raw 16 bit values, if the instruments resolution is greater than 16 bit only the 16 most segnificant bits are returned, when the instruments resulution is less than 16 bits only the most segnificant bits are set, the remaining bits will be set to zero

Parameters:

	hDevice	a device handle
	wCh	channel number: 0..ScpGetChannelCount() - 1
	pBuffer	buffer to write samples to
	qwSampleCount	number of samples to write into buffer

Returns:

number of samples ready

uint64_t ScpChGetDataRaw8	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint8_t *	pBuffer,
		uint64_t	qwSampleCount
	)

Get raw 8 bit values, if the instruments resolution is greater than 8 bit only the 8 most segnificant bits are returned

Parameters:

	hDevice	a device handle
	wCh	channel number: 0..ScpGetChannelCount() - 1
	pBuffer	buffer to write samples to
	qwSampleCount	number of samples to write into buffer

Returns:

number of samples ready

double ScpChGetDataValueMax	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get possible maximum value for current availible data

Parameters:

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

Returns:

possible maximum value

double ScpChGetDataValueMin	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get possible minimum value for current availible data

Parameters:

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

Returns:

possible minimum value

void ScpForceTrigger

(

TpDeviceHandle_t

hDevice

)

Force trigger

Parameters:

hDevice

a device handle

uint32_t ScpGetMeasureMode

(

TpDeviceHandle_t

hDevice

)

Get oscilloscope measure mode

Parameters:

hDevice

a device handle

Returns:

measure mode: a CM_* value

bool8_t ScpIsReady

(

TpDeviceHandle_t

hDevice

)

Check is measuring is done

Parameters:

hDevice

a device handle

Returns:

1 if measuring done, 0 otherwise

bool8_t ScpIsRunning

(

TpDeviceHandle_t

hDevice

)

Check if instrument is measuring

Parameters:

hDevice

a device handle

Returns:

1 if instrument is measuring, 0 otherwise

bool8_t ScpIsTriggered

(

TpDeviceHandle_t

hDevice

)

Check is instrument has triggered

Parameters:

hDevice

a device handle

Returns:

1 if oscilloscope has triggerd, 0 otherwise

uint32_t ScpSetMeasureMode	(	TpDeviceHandle_t	hDevice,
		uint32_t	dwMeasureMode
	)

Set oscilloscope measure mode

Note:

Only MM_BLOCK is supported

Parameters:

	hDevice	a device handle
	dwMeasureMode	measure mode, a CM_* value

Returns:

current measure mode, a CM_* value

void ScpStart	(	TpDeviceHandle_t	hDevice,
		int64_t	iMeasurmentCount
	)

Start measuring

Note:

Only iMeasurmentCount = 1 is supported

Parameters:

	hDevice	a device handle
	iMeasurmentCount	number of measurements before stop, -1 means continously mode

void ScpStop	(	TpDeviceHandle_t	hDevice,
		int64_t	iMeasurmentCount
	)

Stop measuring

Note:

Only iMeasurmentCount = 0 is supported

Parameters:

	hDevice	a device handle
	iMeasurmentCount	number of measurements before stop, 0 means stop imidiatly