User Manual

Programming with the PicoScope 4000 Series66

4.10.44

ps4000SetEts

PICO_STATUS ps4000SetEts

(

short handle,

PS4000_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.

Applicability

Block mode only. ETS is not supported by PicoScope 4262.

Arguments

handle, the handle of the required device

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

PS4000_ETS_OFF disables ETS

PS4000_ETS_FAST enables ETS and provides ets_cycles

cycles of data, which may contain data

from previously returned cycles

PS4000_ETS_SLOW enables ETS and provides fresh data

every ets_cycles cycles. This mode

takes longer to provide each data set,

but the data sets are more stable and

are guaranteed to contain only new

data.

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

select ets_interleave cycles to give the most uniform spread of

samples. ets_cycles should be between two and five times the

value of ets_interleave.

ets_interleave, the number of ETS interleaves to use. If the

sample time is 20 ns and the interleave is 10, the approximate time

per sample will be 2 ns.

sampleTimePicoseconds, returns the effective sample time used

by the function

Returns

PICO_OK

PICO_USER_CALLBACK

PICO_INVALID_HANDLE

PICO_INVALID_PARAMETER