PICO picoscope 3204, Руководство пользователя

Страница: 16 / 40

PicoScope 3000 Series User Guide
15
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
3.3.6
ps3000_get_timebase
short ps3000_get_timebase ( short handle,
short timebase,
long no_of_samples,
long * time_interval_ns,
short * time_units,
short oversample,
long * max_samples)
This function discovers which timebases are available on the oscilloscope. This function
should be called after channel and ETS options have been set.
Arguments
handle
, the handle to the required device.
timebase
, a code between 0 and the maximum timebase (dependant
on variant). Timebase 0 is the fastest timebase, timebase 1 is twice the
time per sample as timebase 0, timebase 2 is four times, etc.
no_of_samples
, the number of samples required. This value is used
to calculate the most suitable time unit to use.
time_interval_ns
, a pointer to the time interval, in ns, between
readings at the selected timebase. If a null pointer is passed, nothing will
be written here.
time_units
, a pointer to the most suitable time units to return data in,
when calling ps3000_get_times_and_values . If a null pointer is passed,
nothing will be written here.
oversample
, the amount of oversample required. An oversample of 4
would quadruple the time interval and quarter the maximum samples. At
the same time it would increase the effective resolution by the amount
given by the equation below:
Increase in resolution (bits) = ( log oversample ) / ( 2 log 2 )
max_samples
, A pointer to the maximum samples available. The
maximum samples may vary depending on the number of channels
enabled, the timebase chosen and the oversample selected. If this
pointer is null, nothing would be written here.
Returns
1
if all parameters are in range, otherwise
0
.