GtWaveFuncSetFmDeviation

Supported By

GX1120

Applies To

Function Generator mode only.

Purpose

Sets the FM deviation frequency.

Syntax

GtWaveFuncSetFmDeviation (nHandle, nChannel, dDeviation, pnStatus)

Parameters

Name
Type
Comments
nHandle
SHORT
Handle to a GX11X0 board.
nChannel
SHORT
Specified Channel number.
GX1120:
0 = GTWAVE_CHANNEL_A: Channel A.
1 = GTWAVE_CHANNEL_B: Channel B.
pdDeviation
PDOUBLE
GX1120:
FM deviation frequency range is 0Hz to 2MHz
pnStatus
PSHORT
Returned status: 0 on success, negative number on failure.

Comments

When the FM source is set to internal then the FM deviation frequency range is 0Hz to 2MHz. When the FM source is set to external then the deviation frequency will be 2x the carrier frequency over the range of -5V to +5V. The deviation will increase linearly as a percentage of the max value. E.g. an external signal with peak voltage of 2.5V will result in a deviation that is +/- 50% of the carrier frequency.

Example

The following example sets the FM deviation frequency to 10KHz:

 

GtWaveFuncSetFmDeviation (nHandle, GTWAVE_CHANNEL_A, 10e3, &nStatus);

 

See Also

GtWaveFuncGetFmDeviation, GtWaveFuncSetFmFrequency, GtWaveFuncSetFmSource, GtWaveFuncSetFmState, GtWaveFuncSetFmWaveform, GtWaveGetErrorString