advertisement
:REFerence Commands
:REFerence<n>:CURRent
Syntax
:REFerence<n>:CURRent
Description
Select the current reference channel.
Parameter
Name Type Range
<n> Discrete {1|2|3|4|5|6|7|8|9|10}
Default
1
Explanation
Only reference channels currently turned on can be selected as the current channel. Refer to
the :REFerence<n>:ENABle command to turn on or off the reference channels.
RIGOL
MSO2000A/DS2000A Programming Guide 2-215
RIGOL
:REFerence<n>:ENABle
Syntax
:REFerence<n>:ENABle <bool>
:REFerence<n>:ENABle?
Description
Turn on or off the specified reference channel; or query the status of the specified reference channel.
Parameter
Name
<n>
Type
Discrete
Range
{1|2|3|4|5|6|7|8|9|10}
Default
--
<bool> Bool {{1|ON}|{0|OFF}}
Ref1: 1|ON
Ref2 to Ref10: 0|OFF
Return Format
The query returns 1 or 0.
:REFerence:COLor
Syntax
:REFerence:COLor <color>
:REFerence:COLor?
Description
Set or query the color of the current reference channel waveform.
Parameter
Name
<color>
Type
Discrete
Range
{GRAY|GREEn|LBLue|MAGenta|ORANge}
Default
GRAY
Explanation
The reference waveform color can be set to GRAY, GREEn, LBLue (light blue), MAGenta or ORANge.
Return Format
The query returns GRAY, GREE, LBL, MAG or ORAN.
2-216 MSO2000A/DS2000A Programming Guide
RIGOL
:REFerence:CURRent?
Syntax
:REFerence:CURRent?
Description
Query the current REF channel.
Return Format
The query returns REFn; wherein, n is an integer from 1 to 10.
:REFerence:DISPlay
Syntax
:REFerence:DISPlay <bool>
:REFerence:DISPlay?
Description
Turn on or off the REF control menu; or query whether the REF control menu is turned on.
Parameter
Name Type Range Default
0|OFF <bool> Bool
Return Format
The query returns 1 or 0.
{{1|ON}|{0|OFF}}
:REFerence:RESet
Syntax
:REFerence:RESet
Description
Reset the vertical scale and vertical position of the reference waveform of the current channel to the settings of the signal source channel when storing the reference waveform.
Explanation
Before using this command, use the :REFerence:SAVe command to store the waveform (screen region) of
the specified signal source to the internal memory.
MSO2000A/DS2000A Programming Guide 2-217
RIGOL
:REFerence:SAVe
Syntax
:REFerence:SAVe
Description
Store the waveform (screen region) of the specified signal source to the internal memory as the reference waveform of the current reference channel and display the waveform on the screen.
Explanation
This operation can only store the reference waveform in the volatile memory and the waveform will be cleared at power-off.
:REFerence:SOURce
Syntax
:REFerence:SOURce <source>
:REFerence:SOURce?
Description
Set or query the reference source of the current reference channel.
Parameter
Name Type
<source> Discrete
Range
{D0|D1|D2|D3|D4|D5|D6|D7|D8|D9|D10|D11|
D12|D13|D14|D15|CHANnel1|CHANnel2|MATH}
Default
CHANnel1
Explanation
Only channels currently turned on can be selected as the reference source of the current channel.
You can use the :REFerence<n>:CURRent command to selected the current channel.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14, D15, CHAN1,
CHAN2 or MATH.
2-218 MSO2000A/DS2000A Programming Guide
RIGOL
:REFerence:VSCale
Syntax
:REFerence:VSCale <vscale>
:REFerence:VSCale?
Description
Set or query the vertical scale of the current refrence channel waveform. The unit is the same with that of the current signal source.
Parameter
Name Type Range Default
<vscale> Integer 1 to 10
Explanation
5
Define the vertical scale of the reference channel waveform when performing the store operation as
“Vscale0” and the vertical scale of the reference channel waveform currently set as “Vscale1”. Different
<vscale> values are used to represent different ratio relations between Vscale0 and Vscale1, as shown in the table below.
<vscale>
1
2
3
4
5
Vscale1/Vscale0
0.05
0.1
0.2
0.5
1
6
7
8
9
2
5
10
20
10
Return Format
50
The query returns an integer from 1 to 10. If the REF function is currently disabled or no reference waveform is stored for the current reference channel, the query returns Null.
MSO2000A/DS2000A Programming Guide 2-219
RIGOL
:REFerence:VOFFset
Syntax
:REFerence:VOFFset <voffset>
:REFerence:VOFFset?
Description
Set or query the vertical offset of the current reference channel waveform. The unit is the same with that of the current signal source.
Parameter
Name Type Range Default
<voffset> Integer -150 to +150 0
Note: When <voffset> is 0, the vertical position of the reference waveform is the same with that of the original waveform. When the parameter increases or decreases by 1, the reference waveform moves upward or downward by
1/25*vertical scale of the original waveform relative to the vertical position of the original waveform.
Return Format
The query returns the vertical offset of the current reference channel waveform in integer.
2-220 MSO2000A/DS2000A Programming Guide
advertisement
Related manuals
advertisement