3156B User Manual
Programming Reference 5-126
Racal Instrument © 2005
Ri3156b_apply_AM_waveform
Description
Programs the generator to output amplitude modulated waveforms. This command lets you specify all
parameters to execute the carrier frequency, amplitude, offset modulation frequency divider and modulation
depth. It also sets AM to be the active waveform mode.
Channel Dependency: Independent
C Syntax
ViStatus ri3156b_apply_AM_waveform (ViSession instrHandle, ViReal64 AMCarrierFrequency, ViReal64
amplitude, ViReal64 offset, ViInt16 AMModulationFrequencyDivider, ViReal64 AMModulationDepth)
Parameters
Name
Variable
Type
Description
AMCarrierFrequency
ViReal64
Programs the carrier frequency.
Valid range: 0.01 to 25e6 (Hz)
Default: 1e6
amplitude
ViReal64
Programs the amplitude for the selected function
Valid range: 10e-3 to 10 (V, into 50
Ω
)
Default:5
offset
ViReal64
Programs the offset for the selected function
Valid range: -4.995 to 4.995 (V, into 50
Ω
)
Default: 0
AMModulationFrequencyDivider
ViInt16
Programs the frequency divider ratio for the modulating
frequency parameter.
Valid range: 2 to 4096
Default: 100
AMModulationDepth
ViReal64
Programs the modulation depth for the amplitude
modulation.
Valid range: 0 to 100 (%)
Default: 50
Return Values
Displays the return status of the function call. If the function was successful, it will return a status of
VI_SUCCESS, otherwise it will return an error code. Passing the error code into the function
"ri3156B_error_message()" will return a string describing the error.