Rigol DS1000 Series Operating instructions

Programming Guide RIGOL
Publication Number: PGA02100-1210
June, 2008
DS1000, DS1000CA Series Digital Oscilloscope
DS1000CD, DS1000C, DS1000MD, DS1000M
DS1302CA, DS1202CA, DS1102CA, DS1062CA
© 2008 RIGOL Technologies, Inc.
All Right Reserved

RIGOL
© 2008 RIGOL Technologies, Inc. I
Programming Guide for DS1000/DS1000CA Series
©2008 RIGOL Technologies, Inc. All Rights Reserved.
RIGOL products are protected by patent laws in and outside of the P.R. China.
Information in this publication replaces all previous corresponding material.
RIGOL Technologies, Inc. reserves the right to modify or change part of or all
the specifications and pricing policies at company‟s sole decision.
NOTE: RIGOL is registered trademark of RIGOL Technologies, Inc.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
II
Content
Chapter 1 Programming Introduction................................................ 1-1
Communication Ports..............................................................................1-2
Symbol Instruction .................................................................................1-3
The Abbreviation of the Commands .........................................................1-4
Chapter 2 Set the Command Systems ................................................ 2-1
System Commands.................................................................................2-2
Keyboard Commands..............................................................................2-7
Measurement commands ......................................................................2-19
Acquire Commands ..............................................................................2-28
Display System Commands ...................................................................2-31
Vertical Commands...............................................................................2-37
Horizontal Commands........................................................................... 2-44
Trigger Commands ............................................................................... 2-48
Trigger control commands ......................................................................2-48
Trigger Mode Commands ........................................................................2-53
LA Commands (Only for DS1000*D Series）........................................... 2-77
Math Commands..................................................................................2-81
Waveform commands ...........................................................................2-83
Chapter 3 Command Quick Reference................................................ 3-1

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
1-1
Chapter 1 Programming Introduction
This book provides guidance to the remote control programming of the DS1000 and
DS1000CA series digital oscilloscopes.
It includes the necessary conceptual information, the command structure for the
subsystem and the case in the application. Users can carry on the remote control to
the oscilloscope or do the further development according to this manual.
NOTE: The Programming Reference is applicable to the Oscilloscope of
the firmware version above 01.02.18.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
1-2
Communication Ports
Computers communicate with the oscilloscope by sending and receiving messages
over an I/O port, such as USB, GPIB port or a RS-232 port. Commands appear as
ASCII character strings embedded inside the output statements of a “host” language
available on your computer. The input commands of the host language are used to
read responses from the oscilloscope.
Basic operations that you can do with a computer and an oscilloscope include:
Set up the oscilloscope.
Make measurements.
Retrieve data (waveforms or measurements) from the oscilloscope.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
1-3
Symbol Instruction
1. Command Separator :
Commands usually begin with a colon (:). Queries are formed by adding a question
mark (?) to the end of the commands. The return values of the queries are mostly
expressed in scientific count such as 2.64e+00.
2. Blank Space □
Blank space is used to separate the instruction from the program data. If the
instruction does not require any program data, blank space is not needed.
3. Braces { }
When several elements, separated by a vertical line (|) are enclosed by braces, { },
only one element may be selected. For example, {ON | OFF} indicates that only ON
or OFF may be selected, not both.
4. Square Brackets [ ]
Items enclosed in square brackets [ ] are optional.
5. Triangle Brackets < >
Items enclosed in < > should be replaced by a numericalvalue or character string.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
1-4
The Abbreviation of the Commands
Some commands are too long to memory and spell. In order to reduce your work
and memory difficulty, we set the abbreviation of the commands.
The abbreviation rule is to omit all the small letters in the instruction header.
For example:
:TRIGger:ALTernation:SLOPe:LEVelA
can be entered as:
:TRIG:ALT:SLOP:LEVA

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-1
Chapter 2 Set the Command Systems
For remote control programming, DS1000 and DS1000CA Series oscilloscopes
have the following command groups:
System Commands
Keyboard Commands
Measurement Commands
Acquire Commands
Display Commands
Vertical Commands
Horizontal Commands
Trigger Commands
LA Commands（Only for DS1000*D Series）
Math Commands
Waveform Commands

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-2
System Commands
System commands are the fundamental commands for the operation of an
oscilloscope. They can either be used as individual instructions or in conjunction with
other instructions to form a script.
System Commands include:
*IDN?
:RUN
:STOP
:AUTO
:FORCetrig
:Trig%50
:HARDcopy
:INFO:LANGuage
:COUNter:ENABle
:BEEP:ENABle
:BEEP:ACTion
We will give specific explanations for each command in the following part.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-3
1. *IDN?
Command Format:
*IDN?
Explanation:
The query returns the company name, oscilloscope model number, sequence
number, and software revision number.
Returned Format:
RIGOL TECHNOLOGIES,<model>,<sequence_number>,<rev_number>
Example:
RIGOL TECHNOLOGIES, DS1102C, DS1102200000122, 03.03.05
2. :RUN
Command Format:
:RUN
Explanation:
The command initiates the oscilloscope to acquire waveform data according to its
current settings. Acquisition runs continuously until the oscilloscope receives a :STOP
command, or a single acquisition has occurred when the Trigger mode is set to
“Single”.
3. :STOP
Command Format:
:STOP
Explanation:
The command controls the oscilloscope to stop acquiring data. To restart the
acquisition, use the :RUN command.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-4
4. :AUTO
Command Format:
:AUTO
Explanation:
The command controls the oscilloscope to evaluate all input waveforms characteristics and
set the optimum conditions to display the waveforms.
5. :FORCetrig
Command Format:
:FORCetrig
Explanation:
The command forces the oscilloscope to display a steady waveform when there is
no suitable trigger condition. The usual trigger modes are “Normal” and “Single”.
6. :Trig%50
Command Format:
:Trig%50
Explanation:
The command sets the trigger level to the vertical middle of the signal amplitude.
7. :HARDcopy
Command Format:
:HARDcopy
Explanation:
The command is to extract the current information on the screen.
8. :INFO:LANGuage
Command Format:

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-5
:INFO:LANGuage□<lang>
Explanation:
The command is to set the System language. The options are: “SIMPlifiedChinese”,
“TRADitionalChinese”and “ENGLish”.
Query Format:
:INFO:LANGuage?
Returned Format:
Query returns “Simplified Chinese”, “Traditional Chinese”or “English”. The double
quotes are not returned.
Example:
:INFO:LANGuag□SimplifiedChinese
Set the System language to SimplifiedChinese.
:INFO:LANGuage?
Query returns “Simplified Chinese”.
9. :COUNter:ENABle
Command Format:
:COUNter:ENABle□{ON|OFF}
Explanation:
This command is to turn the counter function on or off.
Query Format:
:COUNter:ENABle?
Returned Format:
Query returns “ON”or “OFF”. The double quotes are not returned.
Example:
:COUNter:ENABle□ON Enable the counter function
:COUNter:ENABle？Query returns “ON”

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-6
10. :BEEP:ENABle
Command Format:
:BEEP:ENABle□{ON|OFF}
Explanation:
This command is to turn the buzzer on or off.
Query Format:
:BEEP:ENABle?
Returned Format:
Query returns “ON”or “OFF”. The double quotes are not returned.
Example:
:BEEP:ENABle□ON Turn the buzzer On
:BEEP:ENABle? Query returns “ON”
11. :BEEP:ACTion
Command Format:
:BEEP:ACTion
Explanation:
This command is to control the buzzer to sound once (no matter the buzzer is on
or off).

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-7
Keyboard Commands
The Keyboard Commands are the controls of the keys and knobs on the front panel
of the oscilloscope.
Keyboard Commands include:
:KEY:LOCK
:KEY:FORCe
:KEY:RUN
:KEY:V_POS_INC
:KEY:AUTO
:KEY:V_POS_DEC
:KEY:CHANnel1
:KEY:V_SCALE_INC
:KEY:CHANnel2
:KEY:V_SCALE_DEC
:KEY:MATH
:KEY:H_SCALE_INC
:KEY:REF
:KEY:H_SCALE_DEC
:KEY:F1
:KEY:TRIG_LVL_INC
:KEY:F2
:KEY:TRIG_LVL_DEC
:KEY:F3
:KEY:H_POS_INC
:KEY:F4
:KEY:H_POS_DEC
:KEY:F5
:KEY:PROMPT_V
:KEY:MNUoff
:KEY:PROMPT_H
:KEY:MEASure
:KEY:FUNCtion
:KEY:CURSor
:KEY:+FUNCtion
:KEY:ACQuire
:KEY:-FUNCtion
:KEY:DISPlay
:KEY:LA（only for DS1000*D series）
:KEY:STORage
:KEY:PROMPT_V_POS
:KEY:UTILity
:KEY:PROMPT_H_POS
:KEY:MNUTIME
:KEY:PROMPT_TRIG_LVL
:KEY:MNUTRIG
:KEY:OFF
:KEY:Trig%50
We will give specific explanations for each command in the following part.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-8
1. :KEY:LOCK
Command Format:
:KEY:LOCK□{ENABle|DISable}
Explanation:
This command is to enable or disable the remote control of the front panel keys.
Query Format:
:KEY:LOCK?
Returned Format:
Query returns “ENABle”. The double quotes are not returned.
Example:
:KEY:LOCK□ENABle Enable the key on the front panel
:KEY:LOCK? Query returns “ENABLE”
2. :KEY:RUN
Command Format:
:KEY:RUN
Explanation:
This command is to control the RUN/STOP mode of the oscilloscope. Toggle
between RUN/STOP every time this command is sent.
3. :KEY:AUTO
Command Format:
:KEY:AUTO
Explanation:
This command is equivalent to the AUTO key, enables the oscilloscope to set the
optimum conditions to display the input signal (waveform).

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-9
4. :KEY:CHANnel1
Command Format:
:KEY:CHANnel1
Explanation:
This command is to set the Channel 1 and the menu on or off.
5. :KEY:CHANnel2
Command Format:
:KEY:CHANnel2
Explanation:
This command is to set the Channel 2 and the menu on or off.
6. :KEY:MATH
Command Format:
:KEY:MATH
Explanation:
This command is to set the Math function and the menu on or off.
7. :KEY:REF
Command Format:
:KEY:REF
Explanation:
This command is to set the Reference waveform function and the menu on or off.
8. :KEY:F1
Command Format:
:KEY:F1

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-10
Explanation:
This command is similar to press and select the option of Menu F1. Repeating this
command would enter next level of menu.
9. :KEY:F2
Command Format:
:KEY:F2
Explanation:
This command is similar to press and select the option of Menu F2. Repeating this
command would enter next level of menu.
10. :KEY:F3
Command Format:
:KEY:F3
Explanation:
This command is similar to press and select the option of Menu F3. Repeating this
command would enter next level of menu.
11. :KEY:F4
Command Format:
:KEY:F4
Explanation:
This command is similar to press and select the option of Menu F4. Repeating this
command would enter next level of menu.
12. :KEY:F5
Command Format:
:KEY:F5
Explanation:

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-11
This command is similar to press and select the option of Menu F5. Repeating this
command would enter next level of menu.
13. :KEY:MNUoff
Command Format:
:KEY:MNUoff
Explanation:
This command is to set the menu on or off.
14. :KEY:MEASure
Command Format:
:KEY:MEASure
Explanation:
This command is to set the Measurement function and the menu on or off.
15. :KEY:CURSor
Command Format:
:KEY:CURSor
Explanation:
This command is to set the Cursor function and the menu on or off. Select the
cursor mode by repeating the command.
16. :KEY:ACQuire
Command Format:
:KEY:ACQuire
Explanation:
This command is to set the Acquirement function and the menu on or off.

RIGOL
© 2008 RIGOL Technologies, Inc.
Programming Guide for DS1000/DS1000CA Series
2-12
17. :KEY:DISPlay
Command Format:
:KEY:DISPlay
Explanation:
This command is to set the Display function and the menu on or off.
18. :KEY:STORage
Command Format:
:KEY:STORage
Explanation:
This command is to set the Storage function and the menu on or off.
19. :KEY:UTILity
Command Format:
:KEY:UTILity
Explanation:
This command is to initiate the system Utility function and the menu on or off.
20. :KEY:MNUTIME
Command Format:
:KEY:MNUTIME
Explanation:
This command is to set the delayed scan function and the menu on or off.
21. :KEY:MNUTRIG
Command Format:
:KEY:MNUTRIG