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

Page: 216 / 1186

216 Agilent Infiniium 90000 Series Oscilloscopes Programmer's Reference
12
Channel Commands
:CHANnel<N>:PROBe
Command
:CHANnel<N>:PROBe <attenuation_factor>[,{RATio | DECibel}]
The :CHANnel<N>:PROBe command sets the probe attenuation factor and
the units (ratio or decibels) for the probe attenuation factor for a
user- defined probe.
The DECibel and RATio parameters also set the "mode" for the probe
attenuation. These parameters, along with attenuation factor, determine
the scaling of the display and affect automatic measurements and trigger
levels.
This mode also determines the units (ratio or decibels) that may be used
for a subsequent command.
<N> An integer, 1- 4
<attenuation
_factor>
A real number from 0.0001 to 1000 for the RATio attenuation units or
from - 80 dB to 60 dB for the DECibel attenuation units.
Example
This example sets the probe attenuation factor for a 10:1 probe on channel
1 in ratio units.
myScope.WriteString ":CHANNEL1:PROBE 10,RAT"
Query
:CHANnel<N>:PROBe?
The :CHANnel<N>:PROBe? query returns the current probe attenuation
setting and units for the selected channel.
Returned Format
[:CHANnel<N>:PROBe] <attenuation>,{RATio | DECibel}<NL>
Example This example places the current attenuation setting for channel 1 in the
string variable, strAtten, then the program prints the contents.
Dim strAtten As String ' Dimension variable.
myScope.WriteString ":CHANNEL1:PROBE?"
strAtten = myScope.ReadString
Debug.Print strAtten
If you use a string variable, the query returns the attenuation value and
the factor (decibel or ratio). If you use an integer variable, the query
returns the attenuation value. You must then read the attenuation units
into a string variable.