PicoScope 3000 Series User Guide
17
Copyright 2005 Pico Technology Limited. All rights reserved.
PS3000044 1.4
Arguments
handle
, the handle of the required device.
wave_type
, the type of wave. Choose
PS3000_SQUARE (0),
PS3000_TRIANGLE (1)
or
PS3000_SINE (2)
.
This argument has no
effect if used with the PicoScope 3204 variant.
start_frequency
, the required frequency, in the range 0 < freq < 1
MHz, to start the sweep or the frequency generated in a non-sweep
mode.
0
switches the signal generator off.
stop_frequency
, the required stop frequency of the sweep, in the
range 0 < freq < 1 MHz but not necessarily greater than
start_frequency
. If the start and stop frequencies are the same, the
signal generator will be run with a constant frequency.
This argument
has no effect if used with the PicoScope 3204 variant..
increment
, the size of the steps to increment or decrement the
frequency by in a sweep mode. This must always be positive; the start
and stop frequencies will determine whether to increment or decrement.
This must be a frequency in the range 0.1 Hz <
increment
<
|
stop_frequency
-
start_frequency
|. This is not used in a non-
sweep mode.
This argument has no effect if used with the PicoScope
3204 variant..
dwell_time
, This is the time, in ms, to wait before increasing the
frequency by
increment
in a sweep mode. This is unused in a non-
sweep mode.
This argument has no effect if used with the PicoScope
3204 variant..
repeat
,
TRUE
restarts the sweep when the
stop_frequency
is
reached,
FALSE
continues indefinitely at
stop_frequency
when it is
reached.
This argument has no effect if used with the PicoScope 3204
variant..
dual_slope
, if repeat is
TRUE
this specifies what to do at the
stop_frequency
.
TRUE
will sweep back towards the
start_frequency
,
FALSE
will restart the sweep from
start_frequency
.
This argument has no effect if used with the
PicoScope 3204 variant..
Returns
The actual frequency or start frequency, in hertz, that is generated. Zero
if one of the parameters are not in range.
Remarks
The PicoScope 3204 variant has a simple 1 kHz square wave signal generator for scope
probe calibration. With this variant, therefore, only two arguments of this function have
any effect:
To switch the square wave on, use a valid
handle
and set
start_frequency
to a non-
zero value. To switch the square wave off, use a valid
handle
and set
start_frequency
to
0
.
