Agilent Technologies Infiniium 90000 Q-Series, Programmer'S Manual

Page: 225 / 1186

Channel Commands
12
Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference 225
:CHANnel<N>:PROBe:EXTernal:GAIN
Command
:CHANnel<N>:PROBe:EXTernal:GAIN <gain_factor>[,{RATio | DECibel}]
The :CHANnel<N>:PROBe:EXTernal:GAIN command sets the probe external
scaling gain factor and, optionally, the units for the probe gain factor. The
reference factors that are used for scaling the display are changed with
this command, and affect automatic measurements and trigger levels.
The RATio or DECibel also sets the mode for the probe attenuation and
also determines the units that may be used for a subsequent command.
For example, if you select RATio mode, then the attenuation factor must
be given in ratio gain units. In DECibel mode, you can specify the units
for the argument as "dB".
<N> An integer, 1- 4.
<gain_factor>
A real number from 0.001 to 10000 for the RATio gain units, or from
- 60 dB to 80 dB for the DECibel gain units.
Example
This example sets the probe external scaling gain factor for channel 1 to
10.
myScope.WriteString ":CHANNEL1:PROBE:EXTERNAL ON"
myScope.WriteString ":CHANNEL1:PROBE:EXTERNAL:GAIN 10,RATIO"
Query
:CHANnel<N>:PROBe:EXTernal:GAIN?
The :CHANnel<N>:PROBe:EXTernal:GAIN? query returns the probe external
gain setting for the selected channel.
Returned Format
[:CHANnel<N>:PROBe:EXTernal:GAIN] <gain_factor><NL>
Example
This example places the external gain value of the probe on the specified
channel in the variable, varGain, then prints the contents of the variable
to the computer's screen.
myScope.WriteString ":CHANNEL1:PROBE:EXTERNAL ON"
myScope.WriteString ":CHANNEL1:PROBE:EXTERNAL:GAIN?"
varGain = myScope.ReadNumber
Debug.Print FormatNumber(varGain, 0)
N O T E
CHANnel<N>:PROBe:EXTernal command must be set to ON before issuing this command
or query or this command will have no effect.