Installation guide

ManualsBrandsC-SCOPE ManualsBusiness equipmentR1

API functions72

4.48

ps4000aSetSigGenBuiltIn

PICO_STATUS ps4000aSetSigGenBuiltIn (

int16_t handle,

int32_t offsetVoltage, // see note 1

uint32_t pkToPk, // see note 1

PS4000A_WAVE_TYPE waveType, // see note 1

double startFrequency,

double stopFrequency,

double increment,

double dwellTime,

PS4000A_SWEEP_TYPE sweepType,

PS4000A_EXTRA_OPERATIONS operation, // see note 1

uint32_t shots,

uint32_t sweeps,

PS4000A_SIGGEN_TRIG_TYPE triggerType,

PS4000A_SIGGEN_TRIG_SOURCE triggerSource,

int16_t extInThreshold

)

This function sets up the signal generator to produce a signal from a list of built-in

waveforms. If different start and stop frequencies are specified, the oscilloscope will

sweep either up, down or up and down.

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

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

the waveform.

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

signal.

waveType, the type of waveform to be generated by the

oscilloscope:

PS4000A_SINE

sine wave

PS4000A_SQUARE

square wave

PS4000A_TRIANGLE

triangle wave

PS4000A_RAMP_UP

rising sawtooth

PS4000A_RAMP_DOWN

falling sawtooth

PS4000A_SINC

sin(x)/x

PS4000A_GAUSSIAN

normal distribution

PS4000A_HALF_SINE

full-wave rectified sinusoid

PS4000A_DC_VOLTAGE

DC voltage

PS4000A_WHITE_NOISE

random values

startFrequency, the frequency in hertz at which the signal

generator should begin. Range: MIN_SIG_GEN_FREQ to

MAX_SIG_GEN_FREQ.