advertisement
:SYSTem Commands
MSO2000A/DS2000A Programming Guide
RIGOL
2-247
RIGOL
:SYSTem:AOUTput
Syntax
:SYSTem:AOUTput <aux output>
:SYSTem:AOUTput?
Description
Set or query the type of the signal output from the [Trigger Out] connector at the rear panel.
Parameter
Name
<aux output>
Explanation
Type
Discrete
Range
{TOUT|PFAil}
Default
TOUT
TOUT: output a signal that can reflect the current acquisition rate of the oscilloscope via the
[Trigger Out] connector each time the oscilloscope triggers.
PFAil: output a pulse via the [Trigger Out] connector when a failed waveform is detected. You can connect the signal to other control systems to view the test result.
Return Format
The query returns TOUT or PFA.
:SYSTem:AUToscale
Syntax
:SYSTem:AUToscale <opt>
:SYSTem:AUToscale?
Description
Disable or recover the AUTO function; or query the status of the AUTO function.
Parameter
Name Type Range Default
<opt> Bool {{1|ON}|{0|OFF}} 1|ON
Explanation
By default, pressing AUTO or sending the :AUToscale command can execute a waveform auto setting
operation. This command can be used to disable or recover this function.
0|OFF: disable the AUTO function
1|ON: recover the AUTO function
Return Format
The query returns 1 or 0.
2-248 MSO2000A/DS2000A Programming Guide
RIGOL
:SYSTem:BEEPer
Syntax
:SYSTem:BEEPer <bool>
:SYSTem:BEEPer?
Description
Enable or disable the beeper; or query the status of the beeper.
Parameter
Range
{{1|ON}|{0|OFF}}
Name
<bool>
Type
Bool
Return Format
The query returns 1 or 0.
:SYSTem:DATE
Default
0|OFF
Syntax
:SYSTem:DATE <year>,<month>,<day>
:SYSTem:DATE?
Description
Set or query the system date.
Parameter
Name
<year>
Type
Integer
Range
2011 to 2099
Default
--
<month>
<day>
Integer
Integer
1 to 12
1 to 31 (28, 29 or 30)
--
--
Return Format
The query returns the current date in string. The year, month and date parameters are separated by commas.
MSO2000A/DS2000A Programming Guide 2-249
RIGOL
:SYSTem:ERRor[:NEXT]?
Syntax
:SYSTem:ERRor[:NEXT]?
Description
Query and delete the last system error message.
Return Format
The query returns the error message in “<Message Number>,<Message Content>” format. Wherein,
<Message Number> is an integer and <Message Content> is a double-quotated ASCII string. For example, -410,"Query INTERRUPTED".
:SYSTem:EXPand
Syntax
:SYSTem:EXPand <exp>
:SYSTem:EXPand?
Description
Set or query the reference around which the waveform is expanded or compressed.
Parameter
Name
<exp>
Explanation
Type
Discrete
Range
{CENTer|GROund}
Default
GROund
CENTer: when changing the vertical scale, the oscilloscope expands or compresses the waveform vertically around the center of the screen.
GROund: when changing the vertical scale, the oscilloscope expands and compresses the waveform vertically around the ground level.
Return Format
The query returns CENT or GRO.
2-250 MSO2000A/DS2000A Programming Guide
RIGOL
:SYSTem:GAMount?
Syntax
:SYSTem:GAMount?
Description
Query the number of grids on the screen horizontally.
Return Format
The query returns the number of grids on the screen horizontally in integer. For this oscilloscope, the return value is always 14.
:SYSTem:GPIB
Syntax
:SYSTem:GPIB <adr>
:SYSTem:GPIB?
Description
Set or query the GPIB address.
Parameter
Name
<adr>
Type Range
Integer 1 to 30
Return Format
The query returns an integer between 1 and 30.
Default
--
MSO2000A/DS2000A Programming Guide 2-251
RIGOL
:SYSTem:KEY:PRESs
Syntax
:SYSTem:KEY:PRESs <key>
Description
Press the specified key at the front panel of the oscilloscope.
Parameter
Name Type Range Default
<key> Discrete
{CH1|CH2|MATH|REF|LA|DECode1|DECode2|AOFF|
MOFF|F1|F2|F3|F4|F5|F6|F7|QPRevious|QNEXt|
VPOSition|VPOSition1|VPOSition2|VSCale|VSCale1|
VSCale2|HSCale|HPOSition|HMENu|KFUNction|
TLEVel|TMENu|TFORce|TMODe|CLEar|AUTO|RSTop|
SINGle|QPRInt|MEASure|ACQuire|STORage|
CURSor|DISPlay|UTILity|HELP|SRECord|ERECord|
PPAuse|FFP10|FFP20|FFP30|FFP40|FFP50|
FFP60|FFP70|FFN10|FFN20|FFN30|FFN40|
FFN50|FFN60|FFN70|SOURce}
--
Explanation
The ranges of <key> correspond to the keys at the front panel of the oscilloscope. The definitions are as follows.
CH1|CH2|MATH|REF|LA|DECode1|DECode2|CLEar|AUTO|SINGle|MEASure|ACQuire|STORage|CUR
Sor|DISPlay|UTILity|HELP|SOURce: press the corresponding key at the front panel.
AOFF: turn off the analog channels and MATH channel.
MOFF: hide or recover the display of the menu at the right of the screen.
F1|F2|F3|F4|F5|F6|F7: press the 7 menu softkeys at the right of the screen.
QPRevious|QNEXt: open the previous page or next page of the menu at the left of the screen.
VPOSition|VPOSition1: press the CH1 vertical position knob; namely set the vertical position of CH1 to 0.
VPOSition2: press the CH2 vertical position knob; namely set the vertical position of CH2 to 0.
VSCale|VSCale1: press the CH1 vertical scale knob; namely switch between the coarse and fine adjustment of the CH1 vertical scale.
VSCale2: press the CH2 vertical scale knob; namely switch between the coarse and fine adjustment of the CH2 vertical scale.
HSCale: press the horizontal time base adjustment knob; namely turn on or off the sweep delay.
HPOSition: press the horizontal position adjustment knob; namely set the horizontal position to 0.
HMENu: press MENU in the horizontal control area.
KFUNction: press the multifunction knob to set the waveform brightness to 50% (only valid when the menu at the right side of the screen is hidden or the Display menu is opened).
TLEVel: press the trigger level adjustment knob; namely set the trigger level to 0.
2-252 MSO2000A/DS2000A Programming Guide
RIGOL
TMENu: press MENU in the trigger control area.
TFORce: press FORCE in the trigger control area.
TMODe: press MODE in the trigger control area.
RSTop: press RUN/STOP.
QPRInt: press the print key.
SRECord|ERECord: start or stop recording waveforms.
PPAuse: start, pause or resume the playback of the recorded waveform (only valid when waveforms are recorded).
FFP10|FFP20|FFP30|FFP40|FFP50|FFP60|FFP70: rotate the outer layer of the navigation knob clockwise. The number in the paramerter denotes the rotation step. Larger number corresponds to faster rotating speed.
FFN10|FFN20|FFN30|FFN40|FFN50|FFN60|FFN70: rotate the outer layer of the navigation knob counterclockwise. The number in the paramerter denotes the rotation step. Larger number corresponds to faster rotating speed.
MSO2000A/DS2000A Programming Guide 2-253
RIGOL
:SYSTem:KEY:INCRease
:SYSTem:KEY:DECRease
Syntax
:SYSTem:KEY:INCRease <key>[,<val>]
:SYSTem:KEY:DECRease <key>[,<val>]
Description
Rotate the specified knob clockwise or counterclockwise.
Parameter
Name Type
<key>
<val>
Discrete
Integer
Range
{VPOSition|VPOSition1|VPOSition2|
VSCale|VSCale1|VSCale2|HSCale|HPOSition|
KFUNction|TLEVel|SFINd}
Determined by the range of the parameter corresponding to
<key> and the current setting of the parameter
Explanation
Default
--
1
The values of <key> correspond to the knob at the front panel of the oscilloscope. The definitions are as follows.
VPOSition|VPOSition1: CH1 vertical position adjustment knob.
VPOSition2: CH2 vertical scale adjustment knob.
VSCaLe| VSCaLe1: CH1 vertical scale adjustment knob.
VSCaLe2: CH2 vertical scale adjustment knob.
HSCale: horizontal time base adjustment knob.
HPOSition: horizontal position adjustment knob.
KFUNction: multifunction knob. It can be used to adjust the waveform brightness (only valid when the menu at the right side of the screen is hidden or the Display menu is opened).
TLEVel: trigger level adjustment knob.
SFINd: inner knob of the navigation knob.
<val> defines the number of rotations of the specified knob. When the parameter is omitted, rotate the specified knob once.
2-254 MSO2000A/DS2000A Programming Guide
RIGOL
:SYSTem:LANGuage
Syntax
:SYSTem:LANGuage <lang>
:SYSTem:LANGuage?
Description
Set or query the system language.
Parameter
Name Type
<lang> Discrete
Range
{SCHinese|TCHinese|KORean|JAPanese|ENGLish|GERMan|
PORTuguese|POLish}
Return Format
The query returns SCH, TCH, KOR, JAP, ENGL, GERM, PORT or POL.
:SYSTem:OPTion:INSTall
Default
--
Syntax
:SYSTem:OPTion:INSTall <license>
Description
Install the option.
Explanation
<license> represents the serial number of the option (do not add space between characters).
Example
:SYSTem:OPTion:INSTall PDUY9N9QTS9PQSWPLAETRD3UJHYA
:SYSTem:OPTion:UNINSTall
Syntax
:SYSTem:OPTion:UNINSTall
Description
Unload all the options installed.
MSO2000A/DS2000A Programming Guide 2-255
RIGOL
:SYSTem:OPTion:VALid?
Syntax
:SYSTem:OPTion:VALid? <module>
Description
Query the status of the options of the oscilloscope.
Parameter
Name
<module>
Explanation
Type
Discrete
Range
{TRIGger|DECode|CAN|MEMDepth}
TRIGger: advanced trigger option
Default
--
DECode: decoding option
CAN: CAN protocol analysis option (include CAN trigger and CAN decoding)
MEMDepth: deep memory depth option
Return Format
The query returns 0, 1, 2 or 3.
0: the option is not installed
1: the trial period of the option expires
2: original option is installed
3: valid trial option is installed
:SYSTem:PON
Syntax
:SYSTem:PON <power_on>
:SYSTem:PON?
Description
Set or query the configuration to be recalled when the oscilloscope is powered on after power-off.
Parameter
Name Type
<power_on> Discrete
Explanation
Range
{LATest|DEFault}
Default
--
LATest: restore the oscilloscope to the setting at the last power-off.
DEFault: restore the oscilloscope to the factory setting.
Return Format
The query returns LAT or DEF.
2-256 MSO2000A/DS2000A Programming Guide
RIGOL
:SYSTem:PSTatus
Syntax
:SYSTem:PSTatus <sat>
:SYSTem:PSTatus?
Description
Set or query the power status of the oscilloscope.
Parameter
Name Type Range
<sat>
Explanation
Discrete {DEFault|OPEN}
Default
--
DEFault: you need to press the power key at the front panel to start the oscilloscope after the instrument is energized.
OPEN: the oscilloscope starts directly after it is energized.
Return Format
The query returns DEF or OPEN.
:SYSTem:RAMount?
Syntax
:SYSTem:RAMount?
Description
Query the number of analog channels of the instrument.
Return Format
The query returns the number of analog channels of the instrument in integer. For this oscilloscope, the query always returns 2.
:SYSTem:RESet
Syntax
:SYSTem:RESet
Description
Power on the system again.
Explanation
This command is applicable to instrument with 1.0 version hardware or higher.
MSO2000A/DS2000A Programming Guide 2-257
RIGOL
:SYSTem:SSAVer:TIME
Syntax
:SYSTem:SSAVer:TIME <time>
:SYSTem:SSAVer:TIME?
Description
Set or query the screen saver time.
Parameter
Name Type Range Default
<time> Discrete
{1MIN|2MIN|5MIN|15MIN|30MIN|
45MIN|60MIN|2HOur|5HOur|OFF}
OFF
Explanation
After the oscilloscope enters idle state for the specified period of time, the screen saver program will be enabled. OFF denotes do not use the screen saver program.
Return Format
The query returns the screen saver time currently set or OFF.
:SYSTem:SETup
Syntax
:SYSTem:SETup <setup_data>
:SYSTem:SETup?
Description
Send or read the data of the system setup file.
Parameter
Name Type Range Default
<setup_data>
Explanation
Refer to the Explanation
When sending the command, <setup_data> is a binary data block. The data stream is added directly behind the command string to send the data in one operation.
When reading the data, make sure that the buffer is large enough to receive the data stream; otherwise, the program might be abnormal during the reading.
The data stream format: Stream Block Header ::= #NX...X is used to describe the length of the data stream. Wherein, # is the start denoter of the data stream. N is less than or equal to 9 and the N figures followsing it denotes the length (number of bytes) of the data stream. For example, #9000002493; wherein, N is 9 and 000002493 denotes that the length of the data stream is 2493byte.
2-258 MSO2000A/DS2000A Programming Guide
RIGOL
:SYSTem:TIME
Syntax
:SYSTem:TIME <hours>,<minutes>,<seconds>
:SYSTem:TIME?
Description
Set or query the system time.
Parameter
Name
<hours>
Type
Integer
Range
0 to 23
Default
--
<minutes>
<seconds>
Integer
Integer
0 to 59
0 to 59
--
--
Return Format
The query returns the current time in string.
Note: There is a certain delay between the return time and the set time because of the command response time and other consideration.
:SYSTem:UDEVice
Syntax
:SYSTem:UDEVice <udv>
:SYSTem:UDEVice?
Description
Set or query the type of the device connected to the USB Device interface.
Parameter
Name Type Range Default
<udv> Discrete {COMPuter|PICTbridge} COMPuter
Explanation
The oscilloscope can communicate with a PC or PictBridge printer via the USB Device interface at the rear panel.
Return Format
The query returns COMP.
When PICTbridge is selected, the PC cannot communicate with the instrument; therefore, the query command cannot be used.
MSO2000A/DS2000A Programming Guide 2-259
RIGOL
:SYSTem:VERSion?
Syntax
:SYSTem:VERSion?
Description
Query the SCPI version number of the oscilloscope.
Return Format
The query always returns 1999.0.
2-260
MSO2000A/DS2000A Programming Guide
advertisement
* Your assessment is very important for improving the workof artificial intelligence, which forms the content of this project
Related manuals
advertisement