Installation guide

ManualsBrandsC-SCOPE ManualsBusiness equipmentR1

PicoScope 4000 Series (A API) Programmer's Guide 69

It is also possible to sweep the frequency by continually modifying the deltaPhase.

This is done by setting up a deltaPhaseIncrement that the oscilloscope adds to the

deltaPhase at specified intervals.

Note 1: in general, this function can be called with new arguments while waiting for a

trigger; the exceptions are the arguments offsetVoltage, pkToPk,

arbitraryWaveform, arbitraryWaveformSize and operation, which must

unchanged on subsequent calls, otherwise the function will return a PICO_BUSY

status code.

Applicability

All modes

Arguments

handle, the handle of the required device.

offsetVoltage, the voltage offset, in microvolts, to be applied to the waveform.

pkToPk, the peak-to-peak voltage, in microvolts, of the waveform signal.

startDeltaPhase, the initial value added to the phase counter as the generator

begins to step through the waveform buffer.

stopDeltaPhase, the final value added to the phase counter before the generator

restarts or reverses the sweep. When frequency sweeping is not required, set equal

to startDeltaPhase.

deltaPhaseIncrement, the amount added to the delta phase value every time

the dwellCount period expires. This determines the amount by which the

generator sweeps the output frequency in each dwell period. When frequency

sweeping is not required, set to zero.

dwellCount, the time, in multiples of dacPeriod, between successive additions of

deltaPhaseIncrement to the delta phase counter. This determines the rate at

which the generator sweeps the output frequency. Minimum allowable values are as

follows:

PicoScope 4824:

MIN_DWELL_COUNT

* arbitraryWaveform, a buffer that holds the waveform pattern as a set of

samples equally spaced in time. The sample value range is [0, 4095].

arbitraryWaveformSize, the size of the arbitrary waveform buffer, in samples:

Min: MIN_SIG_GEN_BUFFER_SIZE (1)

Max: MAX_SIG_GEN_BUFFER_SIZE (16 384)

sweepType, determines whether the startDeltaPhase is swept up to the

stopDeltaPhase, or down to it, or repeatedly up and down. Use one of the

following values: UP, DOWN, UPDOWN, DOWNUP.

operation, configures the white noise/PRBS (pseudo-random binary sequence)

generator:

PS4000A_ES_OFF:

White noise/PRBS output disabled. The waveform is

defined by the other arguments.

PS4000A_WHITENOISE:

The signal generator produces white noise and

ignores all settings except offsetVoltage and

pkTopk.

PS4000A_PRBS:

The signal generator produces a PRBS.