
Prog ramming the 3000A Series oscilloscopes
72
Copyright © 2011-2013 Pico Technology Limited. All rights reserved.
ps3000abpg.en r9
2.12.44 ps3000aSetEts
PICO_STATUS ps3000aSetEts
(
short handle,
PS3000A_ETS_MODE mode,
short etsCycles,
short etsInterleave,
long * sampleTimePicoseconds
)
This function is used to enable or disable
(equivalent-time sampling) and to set
the ETS parameters. See
for an explanation of ETS mode.
Applicability
Arguments
handle,
the handle of the required device
mode,
the ETS mode. Use one of these values:
PS3000A_ETS_OFF:
disables ETS
PS3000A_ETS_FAST:
enables ETS and provides
etsCycles
of
data, which may contain data from previously returned cycles
PS3000A_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 then
selects
etsInterleave
cycles to give the most uniform spread of
samples.
Range: between two and five times the value of
etsInterleave,
and not more than either:
PS3204A_MAX_ETS_CYCLES
PS3205A_MAX_ETS_CYCLES
PS3206A_MAX_ETS_CYCLES
PS3207A_MAX_ETS_CYCLES
etsInterleave,
the number of waveforms to combine into a single
ETS capture.
Maximum value is either:
* sampleTimePicoseconds,
on exit, the effective sampling
interval of the ETS data. For example, if the captured sample time is
4 ns and
etsInterleave
is 10, the effective sample time in ETS
mode is 400 ps.
PICO_OK
PICO_USER_CALLBACK
PICO_INVALID_HANDLE
PICO_INVALID_PARAMETER