Rigol DS1204B Specifications Page 1

Programming Guide RIGOL Publication Number: PGA04105-1110 Oct. 2008 DS1000B Series Digital Oscilloscope DS1204B/DS1104B/DS1064B

RIGOL Programming Guide for DS1000B Series 2-2 System Commands System Commands are used for the basic operations of an oscilloscope. They can no

RIGOL Programming Guide for DS1000B Series 2-92 1. :SAVERECALL:TYPE Command Format: :SAVERECALL:TYPE□<type> Function: The command sets

RIGOL Programming Guide for DS1000B Series 2-93 Command Format: :SAVERECALL:LOAD

RIGOL Programming Guide for DS1000B Series 2-94 Example: :SAVE:IMAGe:FACTors□ON Save the system parameters. :SAVE:IMAGe:FACTors? Return

RIGOL Programming Guide for DS1000B Series 2-95 Function: The command starts the sa

RIGOL Programming Guide for DS1000B Series 2-96 Mask Commands Mask Commad are used to create and modify the rules for pass/fail test function.

RIGOL Programming Guide for DS1000B Series 2-97 1. :MASK:CREate Command Format:

RIGOL Programming Guide for DS1000B Series 2-98 Example: :MASK:X□1 Set the X direction rule as 1div. :MASK:X? Return 1.000000. 4.

RIGOL Programming Guide for DS1000B Series 2-99 6. :MASK:OPERate Command Format:

RIGOL Programming Guide for DS1000B Series 2-100 8. :MASK:STOPonoutput Command Format: :MASK:STOPonoutput□{{1|ON}|{0|OFF}} Function: The comm

RIGOL Programming Guide for DS1000B Series 2-101 NOTE: In commands, the file name m

RIGOL Programming Guide for DS1000B Series 2-3 1. *IDN? Command Format: *IDN? Fun

RIGOL Programming Guide for DS1000B Series 2-102 Cursor Commands Cursor Commands are used to set cursor parameters to measure manually

RIGOL Programming Guide for DS1000B Series 2-103 1. :CURSor:MODE Command Format:

RIGOL Programming Guide for DS1000B Series 2-104 Command Format: :CURSor:MANUal:SOURce□<source> Function: The command sets the cursor so

RIGOL Programming Guide for DS1000B Series 2-105 Command Format: :CURSor:MANUal:C

RIGOL Programming Guide for DS1000B Series 2-106 Function: The command sets the BY position of manual cursor. The <value> range

RIGOL Programming Guide for DS1000B Series 2-107 Function: The command sets the sig

RIGOL Programming Guide for DS1000B Series 2-108 Query Format: :CURSor:TRACk:CURB? Return Format: The query returns the position of cursor B.

RIGOL Programming Guide for DS1000B Series 2-109 Other Commands There are some

RIGOL Programming Guide for DS1000B Series 2-110 1. :SYSTem:ERRor Command Format: :SYSTem:ERRor Function: The command clears the queue of err

RIGOL Programming Guide for DS1000B Series 2-111 4. :SYSTem:SETup? Command Format:

RIGOL Programming Guide for DS1000B Series 2-4 Function: The command makes the oscilloscope tests all input waveforms and set the waveforms autom

RIGOL Programming Guide for DS1000B Series 3-1 Chapter 3 Programming Examples This chapter lists some application examples of RIGOL DS100

RIGOL Programming Guide for DS1000B Series 3-2 Example 1 The Preparation for Programming #include <stdlib.h> #include <visa.h>

RIGOL Programming Guide for DS1000B Series 3-3 Example 2 Setting the basic measureme

RIGOL Programming Guide for DS1000B Series 3-4 Example 3 Storaging and Setting the File #define BUFFER_SETUP_SIZE 1636 void SetupUpload()

RIGOL Programming Guide for DS1000B Series 3-5 void SetupDownLoad() { BYTE

RIGOL Programming Guide for DS1000B Series 3-6 Example 4 Reading the Data of Screen Image #define BUFFER_IMAGE_SIZE 320*240+256*4+54+1; voi

RIGOL Programming Guide for DS1000B Series 3-7 fclose(fp);

RIGOL Programming Guide for DS1000B Series I Command Quick Reference *IDN? 2-3 *RST 2-4 *LRN? 2-4 *OPC? 2-5 A :ACQuire:TYPE 2-34 :ACQuire:MODE

RIGOL Programming Guide for DS1000B Series 2-5 9. *OPC? Command Format: *OPC? F

RIGOL Programming Guide for DS1000B Series II :KEY:CH2 2-9 :KEY:CH3 2-9 :KEY:CH4 2-9 :KEY:MATH 2-9 :KEY:REF 2-10 :KEY:F1 2-10 :KEY:F2 2-10 :KEY:F3

RIGOL Programming Guide for DS1000B Series III :MEASure:VMIN? 2-23 :MEASure:VAMPlitu

RIGOL Programming Guide for DS1000B Series IV :TRIGger:ALTernation:TimeSCALe 2-67 :TRIGger:ALTernation:TimeOFFSet 2-68 :TRIGger:ALTernation:LEVe

RIGOL Programming Guide for DS1000B Series 2-6 Keyboard Commands Keyboard Commands are used to control the keys and knobs on the operation panel

RIGOL Programming Guide for DS1000B Series 2-7  :KEY:TIME_POS_INC  :KEY:TRIG_LEV

RIGOL Programming Guide for DS1000B Series 2-8 1. :KEY:LOCK Command Format: :KEY:LOCK□{ ENABle | DISable } Function: The command enables and di

RIGOL Programming Guide for DS1000B Series 2-9 Function: The command sets the trigg

RIGOL Programming Guide for DS1000B Series 2-10 Function: The command sets Math function amd its menu on or off. 10. :KEY:REF Command Format:

RIGOL Programming Guide for DS1000B Series 2-11 14. :KEY:F4 Command Format: :KEY:F

RIGOL Programming Guide for DS1000B Series 2-12 Function: The command sets cursor measurement function and its menu on or off. The cursor mode ca

RIGOL Programming Guide for DS1000B Series 2-13 Function: The command sets horizont

RIGOL Programming Guide for DS1000B Series 2-14 Function: The command sets the bulit-in help system on or off. 29. :KEY:QUICKMEASure Command F

RIGOL Programming Guide for DS1000B Series 2-15 Function: The command decreases the

RIGOL Programming Guide for DS1000B Series 2-16 Function: The command decreases the vertical offset of channel 1 evenly. 39. :KEY:CH1_POS_Z

RIGOL Programming Guide for DS1000B Series 2-17 Function: The command increases the

RIGOL Programming Guide for DS1000B Series 2-18 Function: The command sets the adjustment mode of vertical scaling of channel 3 as Fine or Coarse

RIGOL Programming Guide for DS1000B Series 2-19 Function: The command increases the

RIGOL Programming Guide for DS1000B Series 2-20 Function: The command decreases the time base by 1-2-5 step. 59. :KEY:TIME_DEC Command Format:

RIGOL Programming Guide for DS1000B Series 2-21 Function: The command adjusts the t

RIGOL Programming Guide for DS1000B Series I  © 2008 RIGOL Technologies, Inc. All Rights Reserved  RIGOL products are protected by patent law

RIGOL Programming Guide for DS1000B Series 2-22 Measurement Commands Measurement Commands are used for the fundamental measurement opera

RIGOL Programming Guide for DS1000B Series 2-23 1. :MEASure:CLEar Command Format:

RIGOL Programming Guide for DS1000B Series 2-24 Function: The command measures the minimum of signal from <source>. The <source> may

RIGOL Programming Guide for DS1000B Series 2-25 Return Format: The query returns -2

RIGOL Programming Guide for DS1000B Series 2-26 11. :MEASure:PREShoot? Command Format: :MEASure:PREShoot?□[<source>] Function: The com

RIGOL Programming Guide for DS1000B Series 2-27 Function: The command measures the

RIGOL Programming Guide for DS1000B Series 2-28 Return Format: The query returns 5.000e-004, and the unit is s. 18. :MEASure:PDUTycycle? Comm

RIGOL Programming Guide for DS1000B Series 2-29 21. :MEASure:NDELay? Command Forma

RIGOL Programming Guide for DS1000B Series 2-30 24. :MEASure:TOTal Command Format: :MEASure:TOTal□{{1|ON}|{0|OFF}} Function: The command sets

RIGOL Programming Guide for DS1000B Series 2-31 Command Format: :MEASure:DELAYSOURc

RIGOL Programming Guide for DS1000B Series II Content Chapter 1 Programming Introduction ... 1-1

RIGOL Programming Guide for DS1000B Series 2-32 28. :MEASure:ENABle Command Format: :MEASure:ENAble Functions： This command is open the locked

RIGOL Programming Guide for DS1000B Series 2-33 Acquire Commands Acquire Commands

RIGOL Programming Guide for DS1000B Series 2-34 1. :ACQuire:TYPE Command Format: :ACQuire:TYPE□<type> Function: The command sets the acqu

RIGOL Programming Guide for DS1000B Series 2-35 3. :ACQuire:AVERages Command Forma

RIGOL Programming Guide for DS1000B Series 2-36 Display Commands Diaplay Commands are used to set the display system. Display Commands include:

RIGOL Programming Guide for DS1000B Series 2-37 1. :DISPlay:TYPE Command Format:

RIGOL Programming Guide for DS1000B Series 2-38 3. :DISPlay:PERSist Command Format: :DISPlay:PERSist□{{1|ON }|{0|OFF}} Function: The command

RIGOL Programming Guide for DS1000B Series 2-39 5. :DISPlay:MNUStatus Command Form

RIGOL Programming Guide for DS1000B Series 2-40 Function: The command clears the last waveform on the screen. 8. :DISPlay:BRIGhtness Command F

RIGOL Programming Guide for DS1000B Series 2-41 10. :DISPlay:DATA? Command Format:

RIGOL Programming Guide for DS1000B Series 1-1 Chapter 1 Programming Introduction This book provides guidance to the remote control progr

RIGOL Programming Guide for DS1000B Series 2-42 Vertical Commands Vertical Commands are used to set the vertical system from every channel separ

RIGOL Programming Guide for DS1000B Series 2-43 1. :CHANnel<n>:BWLimit Comma

RIGOL Programming Guide for DS1000B Series 2-44 3. :CHANnel<n>:DISPlay Command Format: :CHANnel<n>:DISPlay□{{1|ON}|{0|OFF}} Funct

RIGOL Programming Guide for DS1000B Series 2-45 Function: The command sets the vert

RIGOL Programming Guide for DS1000B Series 2-46 Function: The command sets the vertical scale for magnifying waveform. The <n> may be 1, 2,

RIGOL Programming Guide for DS1000B Series 2-47 Return Format: The query returns 1

RIGOL Programming Guide for DS1000B Series 2-48 Example: :CHANnel1:UNITs VOLTs Set the unit of channel 1 as V. :CHANnel1:UNITs?

RIGOL Programming Guide for DS1000B Series 2-49 Horizontal Commands Horizontal Com

RIGOL Programming Guide for DS1000B Series 2-50 1. :TIMebase:MODE Command Format: :TIMebase:MODE□<mode> Function: The command sets the sc

RIGOL Programming Guide for DS1000B Series 2-51 Return Format: The query reutrns th

RIGOL Programming Guide for DS1000B Series 1-2 Communication Ports Computers can communicate with the oscilloscope by sending and receiving mess

RIGOL Programming Guide for DS1000B Series 2-52 Function: The command sets the timebase offset of main mode, that is the offset of the waveform p

RIGOL Programming Guide for DS1000B Series 2-53 Query Format: :TIMebase[:MAIN]:SCAL

RIGOL Programming Guide for DS1000B Series 2-54 Trigger Commands Trigger Control Commands Trigger system makes the meaningful waveform shown ste

RIGOL Programming Guide for DS1000B Series 2-55 1. :TRIGger:MODE Command Format:

RIGOL Programming Guide for DS1000B Series 2-56 Example: :TRIGGER:EDGE:SOURce□CHANnel1 Set the edge trigger source as channel 1. :TRIGGER:EDGE

RIGOL Programming Guide for DS1000B Series 2-57 Query Format: :TRIGger<mode>

RIGOL Programming Guide for DS1000B Series 2-58 oscilloscope will not trigger until Holdoff ends. The <count> range is 100ns~1.5s. Query F

RIGOL Programming Guide for DS1000B Series 2-59 Example: :TRIGger:SENSitivity□0.2

RIGOL Programming Guide for DS1000B Series 2-60 Trigger Mode Commands Trgger Mode includes: Edge, Pulse, Video, Alternation, and Pattern trigger.

RIGOL Programming Guide for DS1000B Series 2-61 1. Edge Trigger Edge trigger occu

RIGOL Programming Guide for DS1000B Series 1-3 Symbol Instruction 1. Command Sper

RIGOL Programming Guide for DS1000B Series 2-62 2. Pulse Trigger Setup a certain trigger condition to capture specified pulse. Pulse tigger occu

RIGOL Programming Guide for DS1000B Series 2-63 Example: :TRIGger:PULSe:WIDTh□0.001

RIGOL Programming Guide for DS1000B Series 2-64 3. Video Trigger In video trigger, the standard video signal (NTSC, PAL/SECAM) is triggered in f

RIGOL Programming Guide for DS1000B Series 2-65 :TRIGger:VIDEO:POLarity□POSitive

RIGOL Programming Guide for DS1000B Series 2-66 4. Alternation Trigger In alternation trigger, different signals can be triggered at the same ti

RIGOL Programming Guide for DS1000B Series 2-67 Return Format: The query returns

RIGOL Programming Guide for DS1000B Series 2-68  In NoRMAL mode, different types of instruments have different sweep ranges:

RIGOL Programming Guide for DS1000B Series 2-69 (6) :TRIGger:ALTernation:LEVel Com

RIGOL Programming Guide for DS1000B Series 2-70 Example: :TRIGger:ALTernation:EDGE:SLOPe□POSitive, SOURceB Set the edge type as rising ed

RIGOL Programming Guide for DS1000B Series 2-71 Query Format: :TRIGger:ALTernatio

RIGOL Programming Guide for DS1000B Series 1-4 Command Abbreviation Owing to some of the commands are too long to memory and spell, the commands

RIGOL Programming Guide for DS1000B Series 2-72 Function: The command sets the video standard as NTSC or PAL/SECAM. The <source> may be SOU

RIGOL Programming Guide for DS1000B Series 2-73 (13) :TRIGger:ALTernation:HOLDof

RIGOL Programming Guide for DS1000B Series 2-74 Example: :TRIGGER:ALTERNATION:VIDEO:LINE□100, SOURceB Set the specified line num

RIGOL Programming Guide for DS1000B Series 2-75 Query Format: :TRIGger:ALTernation

RIGOL Programming Guide for DS1000B Series 2-76 5. Pattern Trigger Pattern trigger identifies the trigger conditions by checking the specified c

RIGOL Programming Guide for DS1000B Series 2-77 Math Commands Math Commands are us

RIGOL Programming Guide for DS1000B Series 2-78 1. :MATH:DISPlay Command Format: :MATH:DISPlay□{{1|ON}|{0|OFF}} Function: The command sets Ma

RIGOL Programming Guide for DS1000B Series 2-79 Waveform Commands Waveform Command

RIGOL Programming Guide for DS1000B Series 2-80 1. :WAVeform:DATA? Command Format: :WAVeform:DATA?□[<source>] Function: The command is

RIGOL Programming Guide for DS1000B Series 2-81 3. :WAVeform:SOURce Command Format

RIGOL Programming Guide for DS1000B Series 2-1 Chapter 2 DS1000B Command Systems DS1000B Commands System includes the following command subsystem

RIGOL Programming Guide for DS1000B Series 2-82 The command queries the vertical scale of specified soucce. The <source> may be CHANnel1, C

RIGOL Programming Guide for DS1000B Series 2-83 8. :WAVeform:XORigin? Command Form

RIGOL Programming Guide for DS1000B Series 2-84 Example: :WAVeform:ERASeofroll? Return 3. 11. :WAVeform:WINDowzoom? Command Format: :

RIGOL Programming Guide for DS1000B Series 2-85 Return Format: The query returns t

RIGOL Programming Guide for DS1000B Series 2-86 Function: The command queries the position that the left of screen reaches the start point of mem

RIGOL Programming Guide for DS1000B Series 2-87 Function: The command queries the

RIGOL Programming Guide for DS1000B Series 2-88 Utility Commands Utility Commands are used to set other system function, such as counter, s

RIGOL Programming Guide for DS1000B Series 2-89 1. :COUNter:ENABle Command Format:

RIGOL Programming Guide for DS1000B Series 2-90 Function: The command tests the system beeper. 4. :RTC Command Format: :RTC□<year>,<

RIGOL Programming Guide for DS1000B Series 2-91 Storage Commands Storage Commands