User manual

Programming with the PicoScope 6000 Series64

3.9.37

ps6000SetEts

PICO_STATUS ps6000SetEts

(

short handle,

PS6000_ETS_MODE mode,

short etsCycles,

short etsInterleave,

long * sampleTimePicoseconds

)

This function is used to enable or disable ETS (equivalent-time sampling) and to set

the ETS parameters. See ETS overview for an explanation of ETS mode.

Applicability

Block mode

Arguments

handle, the handle of the required device

mode, the ETS mode. Use one of these values:

PS6000_ETS_OFF - disables ETS

PS6000_ETS_FAST - enables ETS and provides etsCycles of

data, which may contain data from previously returned cycles

PS6000_ETS_SLOW - enables ETS and provides fresh data every

etsCycles. This mode takes longer to provide each data set, but

the data sets are more stable and are guaranteed to contain only

new data.

etscycles, the number of cycles to store: the computer can then

select etsInterleave cycles to give the most uniform spread of

samples.

Range: between two and five times the value of etsInterleave,

and not more than PS6000_MAX_ETS_CYCLES

etsInterleave, the number of waveforms to combine into a

single ETS capture

Maximum value: PS6000_MAX_INTERLEAVE

* sampleTimePicoseconds, on exit, the effective sampling

interval of the ETS data. For example, if the captured sample time is

20 ns and etsInterleave is 10, then the effective sample time in

ETS mode is 2 ns.

Returns

PICO_OK

PICO_USER_CALLBACK

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER

PICO_DRIVER_FUNCTION