Rigol DS1000E Series, DS1000D Series Programming Manual Download Page 18

Page: 18 / 135

RIGOL

Command Systems

Programming Guide for DS1000E, DS1000D Series

2-6

ACQuire Commands

ACQuire Commands set the acquire mode for the oscilloscope, including:



:ACQuire:TYPE



:ACQuire:MODE



:ACQuire:AVERages



:ACQuire:SAMPlingrate?



:ACQuire:MEMDepth <depth>

The detailed information of each command are given as follows:

Summary of Contents for DS1000E Series, DS1000D Series

Page 1: ...RIGOL Programming Guide DS1000E DS1000D Series Digital Oscilloscope July 2009 RIGOL Technologies Inc ...

Page 2: ......

Page 3: ... Information in this publication replaces all previously corresponding material RIGOL shall not be liable for losses caused by either incidental or consequential in connection with the furnishing use or performance of this manual as well as any information contained Any part of this document is forbidden to copy or photocopy or rearrange without prior written approval of RIGOL Product Certificatio...

Page 4: ...em Commands 2 4 ACQuire Commands 2 6 DISPlay Commands 2 10 TIMebase Commands 2 15 TRIGger Commands 2 19 Trigger Control 2 22 EDGE Trigger 2 26 PULSe Trigger 2 27 VIDEO Trigger 2 29 SLOPe Trigger 2 32 PATTern Trigger 2 36 DURation Trigger 2 37 ALTernation Trigger 2 39 STORage Command 2 48 MATH Commands 2 50 CHANnel Commands 2 53 MEASure Commands 2 59 WAVeform Command 2 68 LA Commands 2 70 KEY Comma...

Page 5: ...I Programming based on RIGOL USB Driver 3 2 Program in Visual C 6 0 3 2 Program in Visual Basic 6 0 3 7 Programming based on VISA 3 16 Program in Visual C 6 0 3 16 Program in Visual Basic 6 0 3 21 Program in LabVIEW 8 6 3 24 Command Quick Reference A Z 1 ...

Page 6: ......

Page 7: ...duction This chapter provides the introduction about the interfces and commands so as to control DS1000E DS1000D series digital oscilloscopes via remote commands The chapter contains following topics Communication Interfaces Command Introduction Command Syntax Symbol Instruction Command Input Parameter Type ...

Page 8: ...II character strings embedded inside the output statements of a host language available on your computer 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 Connection USB connect the oscilloscope with the computer through an USB data cable RS232 connect the oscilloscope...

Page 9: ...addition after a command line denotes to query its function and space is used to divide command and parameter For example TRIGger EDGE SLOPe POSitive NEGative TRIGger EDGE SLOPe TRIGger is the root keyword of this command EDGE and SLOPe are second and third keyword respectively all of these keywords are separated by Connects enclosed in the denote the parameters permitted to be set by user queries...

Page 10: ...several elements separated by a vertical line are enclosed by braces only one element may be selected for example MEASure TOTal ON OFF Thereinto ON OFF indicates that only ON or OFF may be selected not both 2 Square Brackets Items enclosed in square brackets are optional for example TIMebase DELayed OFFSet offset Thereinto DELayed could be omitted 3 Triangle Brackets Items enclosed in should be re...

Page 11: ...ands of both DS1000E DS1000D series are case insensitive You can use capital letter to input the whole command or you can input the abbreviation Note that if use abbreviation the capital letters specified in commands must be written completely For example TRIGger EDGE SLOPe can be entered as TRIG EDGE SLOP ...

Page 12: ...tness ncount Thereinto ncount could be an integer between 0 and 32 including 0 and 32 3 Consecutive Real Number The parameters could be any value within effective range and precision permitting for example TRIGger EDGE SENSitivity count Thereinto count could be a real number between 0 1 and 1 including 0 1 and 1 4 Discrete The parameters can only be the cited value for example ACQuire AVERages cou...

Page 13: ...using considerations as well as some application examples The subcommands systems contain General Commands SYSTem Commands ACQuire Commands DISPlay Commands TIMebase Commands TRIGger Commands Trigger Control EDGE Trigger PULSe Trigger VIDEO Trigger SLOPe Trigger PATTern Trigger DURation Trigger ALTernation Trigger STORage Command MATH Commands CHANnel Commands MEASure Commands WAVeform Command LA ...

Page 14: ...neds common commands for querying or executing some basic information about instrument which usually begins with and holds 3 character long command keywords DS1000E DS1000D series digital oscilloscopes support following IEEE488 2 commands IDN RST The detailed information of each command are given as follows ...

Page 15: ...strument including a field separated by 4 commas manufactory model serial number and the version number composed of numbers and separated by Returned Format RIGOL TECHNOLOGIES model serial number software version number Example RIGOL TECHNOLOGIES DS1102E DS1EB104702974 00 02 01 01 00 2 RST Command Format RST Function Explanation The command resets the system parameters ...

Page 16: ...mmands SYSTem Commands are the fundamental commands for the operation of an oscilloscope They can either be used for operational control or screen data interception and more SYSTem Commands include RUN STOP AUTO HARDcopy The detailed information of each command are given as follows ...

Page 17: ...tion The command controls the oscilloscope to stop acquiring data To restart the acquisition use the RUN command 3 AUTO Command Format AUTO Function Explanation The command controls the oscilloscope to evaluate all input waveforms characteristics and set the optimum conditions to display the waveforms 4 HARDcopy Command Format HARDcopy Function Explanation The command is to extract the current inf...

Page 18: ...DS1000D Series 2 6 ACQuire Commands ACQuire Commands set the acquire mode for the oscilloscope including ACQuire TYPE ACQuire MODE ACQuire AVERages ACQuire SAMPlingrate ACQuire MEMDepth depth The detailed information of each command are given as follows ...

Page 19: ...AGE or PEAKDETECT Example ACQ TYPE AVER Setup the acquire type as Average ACQ TYPE The query returns AVERAGE 2 ACQuire MODE Command Format ACQuire MODE mode ACQuire MODE Function Explanation The commands set and query the current acquire mode of the oscilloscope mode could be RTIMe Real time Sampling or ETIMe Equivalent Sampling Returned Format The query returns REAL_TIME or EQUAL_TIME Example ACQ...

Page 20: ...ion time as 16 ACQ AVER The query returns 16 4 ACQuire SAMPlingrate Command Format ACQuire SAMPlingrate CHANnel n DIGITAL Function Explanation The command queries the current sampling rate of the analog channel or digital channel only for DS1000D series n is 1 or 2 means channel 1 or channel 2 Returned Format The query returns the setting value of the sampling rate Example ACQ SAMP CHANnel2 Query ...

Page 21: ...Series 2 9 The commands set and query the memory depth of the oscilloscope depth could be LONG long memory or NORMal normal memory Returned Format The query returns LONG or NORMAL Example ACQ MEMD LONG Set the memory type as LONG ACQ MEMD The query returns LONG ...

Page 22: ...mmands DISPlay Commands setup the display type of the oscilloscope DISPlay Commands include DISPlay TYPE DISPlay GRID DISPlay PERSist DISPlay MNUDisplay DISPlay MNUStatus DISPlay CLEar DISPlay BRIGhtness DISPlay INTensity The detailed information of each command are given as follows ...

Page 23: ...e DISP TYPE VECT Setup the display type as VECTors DISP TYPE The query returns VECTORS 2 DISPlay GRID Command Format DISPlay GRID grid DISPlay GRID Function Explanation The commands set and query the state of the screen grid grid could be FULL open the background grid and coordinates HALF turn off the background grid or NONE turn off the background grid and coordinates Returned Format The query re...

Page 24: ...ormat The query returns ON or OFF Example DISP PERS ON Enable the waveform persist DISP PERS The query returns ON 4 DISPlay MNUDisplay Command Format DISPlay MNUDisplay time DISPlay MNUDisplay Function Explanation The commands set and query the time for hiding menus automatically time could be 1s 2s 5s 10s 20s or Infinite Returned Format The query returns 1s 2s 5s 10s 20s or Infinite Example DISP ...

Page 25: ...DISPlay CLEar Command Format DISPlay CLEar Function Explanation The command clears out of date waveforms on the screen during waveform persist 7 DISPlay BRIGhtness Command Format DISPlay BRIGhtness ncount DISPlay BRIGhtness Function Explanation The commands set and query the brightness of the grid The range of ncount is from 0 to 32 from dark to bright Returned Format The query returns the setting...

Page 26: ...ISPlay INTensity count DISPlay INTensity Function Explanation The commands set and query the brightness of the waveform count could be the integer between 0 and 32 Returned Format The query returns the setting value of count Example DISP INT 12 Setup the waveform brightness as 12 DISP INT The query returns 12 ...

Page 27: ...izontal scale time base and the waveform horizontal position in the memory trigger offset The waveform will enlarge or shrink among various horizontal scale TIMebase Commands include TIMebase MODE TIMebase DELayed OFFSet TIMebase DELayed SCALe TIMebase FORMat The detailed information of each command are given as follows ...

Page 28: ...yed OFFSet offset TIMebase DELayed OFFSet Function Explanation The commands set and query the offset of the MAIN or DELayed timebase that is offset of the waveform position relative to the trigger midpoint Thereinto In NORMAL mode the range of scale_val is 1s end of the memory In STOP mode the range of scale_val is 500s 500s In SCAN mode the range of scale_val is 6 Scale 6 Scale Note Scale indicat...

Page 29: ...he range of scale_val is 2ns 50s In ROLL mode the range of scale_val is 500ms 50s In MAIN state the item DELayed should be omitted Returned Format The query returns the setting value of scale_val in s Example TIM MODE MAIN Setup the timebase as MAIN TIM SCAL 2 Setup its scale as 2s TIM SCAL The query returns 2 000e 00 4 TIMebase FORMat Command Format TIMebase FORMat value TIMebase FORMat Function ...

Page 30: ...RIGOL Command Systems Programming Guide for DS1000E DS1000D Series 2 18 TIM FORM YT Setup the form of grid as YT TIM FORM The query returns Y T ...

Page 31: ...rigger point The oscilloscope continues to acquire data while waiting for the trigger condition to occur After it detects a trigger the oscilloscope continues to acquire enough data so that it can display the waveform to the right of the trigger point The available trigger mode provided by DS1000E DS1000D series digital oscilloscopes are Edge Pulse Video Slope Pattern Duration and Alternation Trig...

Page 32: ...RIGger SLOPe LEVelB PATTern Trigger TRIGger PATTern PATTern DURation Trigger TRIGger DURation PATTern TRIGger DURation TIME TRIGger DURation QUALifier ALTernation trigger TRIGger ALTernation SOURce TRIGger ALTernation TYPE TRIGger ALTernation TimeSCALe TRIGger ALTernation TimeOFFSet TRIGger ALTernation mode LEVel TRIGger ALTernation EDGE SLOPe TRIGger ALTernation mode MODE TRIGger ALTernation mode...

Page 33: ... DS1000D Series 2 21 TRIGger ALTernation SLOPe LEVelA TRIGger ALTernation SLOPe LEVelB TRIGger ALTernation mode COUPling TRIGger ALTernation mode HOLDoff TRIGger ALTernation mode SENSitivity The detailed information of each command are given as follows ...

Page 34: ...up the trigger mode as EDGE TRIG MODE The query returns EDGE 2 TRIGger mode SOURce Command Format TRIGger mode SOURce src TRIGger mode SOURce Function Explanation The commands set and query the trigger source src could be the input channel CHANnel1 CHANnel2 external trigger channel EXT AC Line Mains supply or digital channel Digital In EDGE mode src could be CHANnel n EXT ACLine or DIGital m In PU...

Page 35: ...r level level could be EDGE PULSe or VIDEO the range is 6 Scale 6 Scale Scale indicates the current vertical scale the unit is V div Returned Format The query returns the setting value of level in V Example TRIG EDGE LEV 1 Setup the level of EDGE trigger as 1 TRIG EDGE LEV The query returns 1 00e 00 4 TRIGger mode SWEep Command Format TRIGger mode SWEep AUTO NORMal SINGle TRIGger mode SWEep Functi...

Page 36: ...d attenuate the signals lower than 10Hz HF Reject high frequency signals Higher than 150KHz LF Reject DC signals and attenuate low frequency signals Lower than 8KHz mode could be EDGE PULSe or SLOPe Returned Format The query returns DC AC HF or LF Example TRIG EDGE COUP DC Setup the coupling type as DC TRIG EDGE COUP The query returns DC 6 TRIGger HOLDoff Command Format TRIGger HOLDoff count TRIGg...

Page 37: ...mand queries the operating status of the oscilloscope The status could be RUN STOP T D WAIT or AUTO Returned Format The query returns RUN STOP T D WAIT or AUTO 8 Trig 50 Command Format Trig 50 Function Explanation The command sets the trigger level to the vertical midpoint of amplitude 9 FORCetrig Command Format FORCetrig Function Explanation The command forces the oscilloscope to trigger signal w...

Page 38: ...at The query returns POSITIVE or NEGATIVE Example TRIG EDGE SLOP POS Set up the edge of trigger as POSitive TRIG EDGE SLOP The query returns POSITIVE 2 TRIGger EDGE SENSitivity Command Format TRIGger EDGE SENSitivity count TRIGger EDGE SENSitivity Function Explanation The commands set and query the sensitive of edge trigger The range of count could be 0 1div 1div Returned Format The query returns ...

Page 39: ...ater than LESSthan negative pulse less than or EQUal negative pulse equals to Returned Format The query returns GREATER THAN LESS THAN EQUAL GREATER THAN LESS THAN or EQUAL Example TRIG PULS MODE GRE Setup the trigger condition as GREaterthan TRIG PULS MODE The query returns GREATER THAN 2 TRIGger PULSe SENSitivity Command Format TRIGger PULSe SENSitivity count TRIGger PULSe SENSitivity Function E...

Page 40: ... 00e 01 3 TRIGger PULSe WIDTh Command Format TRIGger PULSe WIDTh wid TRIGger PULSe WIDTh Function Explanation The commands set and query the pulse width The range of wid is 20ns 10s Returned Format The query returns the setting value of the wid in s Example TRIG PULS WIDT 0 001 Setup the width of the pulse as 1ms TRIG PULS WIDT The query returns 1 000e 03 ...

Page 41: ... ODD FIELD EVEN FIELD LINE or ALL LINES Example TRIG VIDEO MODE EVEN Setup the synchronous mode as EVENfield TRIG VIDEO MODE The query returns EVEN FIELD 2 TRIGger VIDEO POLarity Command Format TRIGger VIDEO POLarity POSitive NEGative TRIGger VIDEO POLarity Function Explanation The commands set and query the video polarity The polarity could be POSitive or NEGative Returned Format The query return...

Page 42: ...video standard as PALSecam TRIG VIDEO STAN The query returns PAL SECAM 4 TRIGger VIDEO LINE Command Format TRIGger VIDEO LINE value TRIGger VIDEO LINE Function Explanation The commands set and query the number of specified line of synchronous In NTSC standard the range of value is 1 525 in PAL SECAM standard the range of value is 1 625 Returned Format The query returns the numbers of current line ...

Page 43: ...TRIGger VIDEO SENSitivity Function Explanation The commands set and query the trigger sensitive the range of count is 0 1div 1div Returned Format The query returns the setting value of count in div Example TRIG VIDEO SENS 0 5 Setup the trigger sensitive as 0 5div TRIG VIDEO SENS The query returns 5 00e 01 ...

Page 44: ...ns the setting value of count in s Example TRIG SLOP TIME 0 01 Setup the slope time is 10ms TRIG SLOP TIME The query returns 1 000e 02 2 TRIGger SLOPe SENSitivity Command Format TRIGger SLOPe SENSitivity count TRIGger SLOPe SENSitivity Function Explanation The commands set and query the trigger sensitive The range of count is 0 1div 1div Returned Format The query returns the setting value of count...

Page 45: ...turns GREATER THAN LESS THAN EQUAL GREATER THAN LESS THAN 或 EQUAL Example TRIG SLOP MODE GRE Setup the slope condition as GREaterthan TRIG SLOPe MODE The query returns GREATER THAN 4 TRIGger SLOPe WINDow Command Format TRIGger SLOPe WINDow count TRIGger SLOPe WINDow Function Explanation The commands set and query the type of trigger level which can be adjusted by When the slope condition is GREate...

Page 46: ...er boundary Level A of trigger level The range of value is LevelB 6 Scale Scale indicates the current vertical level the unit is V div Returned Format The query returns the setting value of level in V Example TRIG SLOP LEVA 2 Setup the upper boundary of trigger level as 2V TRIG SLOP LEVA The query returns 2 000e 00 6 TRIGger SLOPe LEVelB Command Format TRIGger SLOPe LEVelB value TRIGger SLOPe LEVe...

Page 47: ...ies 2 35 The query returns the setting value of level in V Note Level A upper boundary can not be less than the maximum of Level B lower boundary Example TRIG SLOP LEVB 1 5 Setup the lower boundary of trigger level as 1 5V TRIG SLOP LEVB The query returns 1 500e 00 ...

Page 48: ...ue is a 16 bit integer without sign high is 1 and low is o When mask is an 16 bit integer without sign enable is 1 and X is 0 The range of edge source is 0 15 DIG0 DIG15 edge is 1 at rising edge and 0 at falling edge separately Returned Format The query returns the setting value of value mask edge source and edge in turns Thereinto the value returned by value and mask is a decimal data Example TRI...

Page 49: ...ut sign enable is 1 and X is 0 Returned Format The query returns the setting value of value mask in turns Example TRIG DUR PATT 65535 655535 Setup the type of pattern TRIG DUR PATT The query returns 65535 65535 2 TRIGger DURation TIME Command Format TRIGger DURation TIME time TRIGger DURation TIME Function Explanation The commands set and query the limiting time of duration trigger The range of ti...

Page 50: ... qual TRIGger DURation QUALifier Function Explanation The commands set and query the limiting condition of trigger time qual could be GREaterthan LESSthan or EQUal Returned Format The query returns GREATER THAN LESS THAN or EQUAL Example TRIG DUR QUAL GRE Setup the limiting condition as GREaterthan TRIG DUR QUAL The query returns GREATER THAN ...

Page 51: ... Format The query returns CH1 or CH2 Example TRIG ALT SOUR CHAN2 Select CHANnel2 as current channel TRIG ALT SOUR The query returns CH2 2 TRIGger ALTernation TYPE Command Format TRIGger ALTernation TYPE value TRIGger ALTernation TYPE Function Explanation The commands set and query the trigger type in alternation mode value could be EDGE PULSe SLOPe or VIDEO Returned Format The query returns EDGE P...

Page 52: ...y returns 1 000e 03 4 TRIGger ALTernation TimeOFFSet Command Format TRIGger ALTernation TimeOFFSet value TRIGger ALTernation TimeOFFSet Function Explanation The commands set and query the horizontal timebase offset of the current channel Thereinto In NORMAL mode the range of value is 1s end point of memory In STOP mode the range of value is 500s 500s In ROLL mode the range of value is 6 scale 6 Sc...

Page 53: ...ned Format The query returns the setting value of value in V Example TRIG ALT EDGE LEV 2 Setup the trigger level of the current channel as 2V TRIG ALT EDGE LEV The query returns 2 00e 00 6 TRIGger ALTernation EDGE SLOPe Command Format TRIGger ALTernation EDGE SLOPe value TRIGger ALTernation EDGE SLOPe Function Explanation The commands set and query the current edge type value could be POSitive ris...

Page 54: ...he value could be ODDfield EVENfield LINE or ALLlines Returned Format The query returns the setting value of value Example TRIG ALT PULS MODE GRE Setup the pulse condition TRIG ALT PULS MODE The query returns GREATER THAN 8 TRIGger ALTernation mode TIME Command Format TRIGger ALTernation mode TIME value TRIGger ALTernation mode TIME Function Explanation The commands set and query the current pulse...

Page 55: ...up the video polarity as POSITIVE TRIG ALT VIDEO POL The query returns POSITIVE 10 TRIGger ALTernation VIDEO STANdard Command Format TRIGger ALTernation VIDEO STANdard NTSC PALSecam TRIGger ALTernation VIDEO STANdard Function Explanation The commands set and query the current video trigger standard Returned Format The query returns NTSC or PAL SECAM Example TRIG ALT VIDEO STAN NTSC Setup the video...

Page 56: ...mand Format TRIGger ALTernation SLOPe WINDow count TRIGger ALTernation SLOPe WINDow Function Explanation The commands set and query the type of trigger level which can be adjusted by in current state When the slope is GREaterthan LESSthan or EQUal the count could be PA rising edge Level A PB rising edge Level B or PAB rising edge Level AB When the slope condition is GREaterthan LESSthan or EQUal t...

Page 57: ...A 2 Setup the upper boundary Level A of trigger level as 2V TRIG ALT SLOP LEVA The query returns 2 000e 00 14 TRIGger ALTernation SLOPe LEVelB Command Format TRIGger ALTernation SLOPe LEVelB value TRIGger ALTernation SLOPe LEVelB Function Explanation The commands set and query the current lower boundary Level B of trigger level in slope trigger mode The range of value is 6 Scale LevelA Scale indic...

Page 58: ...equency signals Higher than 150 KHz LF Low frequency reject Reject DC signals and attenuate low frequency signals Lower than 8KHz mode could be EDGE PULSe or SLOPe Returned Format The query returns DC AC HF or LF Example TRIG ALT EDGE COUP DC Setup the coupling mode as DC TRIG ALT EDGE COUP The query returns DC 16 TRIGger ALTernation mode HOLDoff Command Format TRIGger ALTernation mode HOLDoff cou...

Page 59: ...t TRIGger ALTernation mode SENSitivity count TRIGger ALTernation mode SLOPe SENSitivity Function Explanation The commands set and query the trigger sensitive The mode could be EDGE PULSe SLOPe or VIDEO The range of count is 0 1div 1div Returned Format The query returns the setting value of count in div Example TRIG ALT EDGE SENS 0 5 Setup the trigger sensitive as 0 5div TRIG ALT EDGE SLOP SENS The...

Page 60: ...ms Programming Guide for DS1000E DS1000D Series 2 48 STORage Command STORage Command is used for recalling the factory settings including STORage FACTory LOAD The detailed information of each command are given as follows ...

Page 61: ...d Systems RIGOL Programming Guide for DS1000E DS1000D Series 2 49 1 STORage FACTory LOAD Command Format STORage FACTory LOAD Function Explanation The command recalls the system settings before leaving factory ...

Page 62: ...eration Commands are used for executing the add reduce multiply and FFT operations of wavefrom from CH1 and CH2 and display the results The results are measured by grid or cusor MATH Commands include MATH DISPlay MATH OPERate FFT DISPlay The detailed information of each command are given as follows ...

Page 63: ...N or OFF Example MATH DISP ON Enable math operation MATH DISP The query returns ON 2 MATH OPERate Command Format MATH OPERate operate MATH OPERate Function Explanation The commands set and query the math operation type of the current channel operate could be A B A B AB or FFT Returned Format The query returns A B A B A B or FFT Example MATH OPER A B Setup the operation as A B MATH OPER The query r...

Page 64: ... for DS1000E DS1000D Series 2 52 FFT DISPlay Function Explanation The commands set and query the On Off state of FFT operation Returned Format The query returns ON or OFF Example FFT DISP ON Enable FFT operation FFT DISP The query returns ON ...

Page 65: ...annel has an independent vertical menu and each option could be set separately based on different channels CHANnel Commands include CHANnel n BWLimit CHANnel n COUPling CHANnel n DISPlay CHANnel n INVert CHANnel n OFFSet CHANnel n PROBe CHANnel n SCALe CHANnel n FILTer CHANnel n MEMoryDepth CHANnel n VERNier The detailed information of each command are given as follows ...

Page 66: ...dth limit to CH2 CHAN2 BWL The query returns OFF 2 CHANnel n COUPling Command Format CHANnel n COUPling DC AC GND CHANnel n COUPling Function Explanation The commands set and query the coupling mode of channel DC indicates both the AC and DC components passed from input signal AC indicates the blocked DC components GND indicates to cut off the input of signal n could be 1 or 2 Returned Format The ...

Page 67: ...e CHAN2 DISP ON Open the display of Channel 2 CHAN2 DISP The query returns ON 4 CHANnel n INVert Command Format CHANnel n INVert ON OFF CHANnel n INVert Function Explanation The commands set and query the On Off state of the waveform inverted n could be 1 or 2 Returned Format The query returns ON or OFF Example CHAN2 INV OFF Turn off the inverted display of Channel 2 CHAN2 INV The query returns OF...

Page 68: ...HAN2 OFFS The query returns 2 000e 01 6 CHANnel n PROBe Command Format CHANnel n PROBe attn CHANnel n PROBe Function Explanation The commands set and query the attenuation factor of the probe n could be 1 or 2 attn could be 1 5 10 50 100 500 or 1000 Returned Format The query returns the setting value of attn Example CHAN2 PROB 10 Setup the attenuation ratio of channel 2 as 10X CHAN2 PROB The query...

Page 69: ... 1V 5000V When the Probe is set to 1000X the range of range is 2V 10000V Returned Format The query returns the setting value of range in V Example CHAN2 PROB 10 Setup the attenuation ratio of the probe as 10X CHAN2 SCAL 20 Setup the vertical scale as 20V CHAN2 SCAL The query returns 2 000e 01 8 CHANnel n FILTer Command Format CHANnel n FILTer ON OFF CHANnel n FILTer Function Explanation The comman...

Page 70: ...annels In common memory up to 16kpts could be stored in single channel and 8kpts in dual channels Returned Format Such as 8192 8kpts 10 CHANnel n VERNier Command Format CHANnel n VERNier ON OFF CHANnel n VERNier Function Explanation The commands set and query the adjusting mode of scale ON denotes Fine OFF denotes Coarse n could be 1 or 2 Returned Format The query returns Coarse or Fine Example CH...

Page 71: ...ASure Commands include MEASure CLEar MEASure VPP MEASure VMAX MEASure VMIN MEASure VAMPlitude MEASure VTOP MEASure VBASe MEASure VAVerage MEASure VRMS MEASure OVERshoot MEASure PREShoot MEASure FREQuency MEASure RISetime MEASure FALLtime MEASure PERiod MEASure PWIDth MEASure NWIDth MEASure PDUTycycle MEASure NDUTycycle MEASure PDELay MEASure NDELay MEASure TOTal MEASure SOURce The detailed informa...

Page 72: ...ction Explanation The command queries the peak peak value of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 5 12e 03 the unit is V 3 MEASure VMAX Command Format MEASure VMAX source Function Explanation The command queries the maximum of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 2 60e 03 the unit is V 4 MEASure V...

Page 73: ...ormat MEASure VAMPlitude source Function Explanation The command queries the amplitude of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 5 07e 03 the unit is V 6 MEASure VTOP Command Format MEASure VTOP source Function Explanation The command queries the top value of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 2 5...

Page 74: ...re VAVerage source Function Explanation The command queries the average value of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 4 01e 01 the unit is V 9 MEASure VRMS Command Format MEASure VRMS source Function Explanation The command queries the root mean square value of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as...

Page 75: ...ASure PREShoot source Function Explanation The command queries the preshoot of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 0 00e 00 12 MEASure FREQuency Command Format MEASure FREQuency source Function Explanation The command queries the frequency of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 1 00e 03 the unit...

Page 76: ...and Format MEASure FALLtime source Function Explanation The command measures the falling time of the waveform source could be CHANnel1 or CHANnel2 Returned Format Such as 3 10e 04 the unit is s 15 MEASure PERiod Command Format MEASure PERiod source Function Explanation The command queries the period of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 1 00e 03...

Page 77: ...Sure NWIDth source Function Explanation The command queries the negative pulse width of the waveform under measure source could be CHANnel1 or CHANnel2 Returned Format Such as 5 00e 04 the unit is s 18 MEASure PDUTycycle Command Format MEASure PDUTycycle source Function Explanation The command queries the positive duty cycle of the waveform under measure source could be CHANnel1 or CHANnel2 Return...

Page 78: ...e PDELay source Function Explanation The command queries the delay relative to rising edge of channel1 or channel 2 source could be CHANnel1 or CHANnel2 Returned Format Such as 1 00e 04 21 MEASure NDELay Command Format MEASure NDELay source Function Explanation The command queries the delay relative to falling edge of channel1 or channel 2 source could be CHANnel1 or CHANnel2 Returned Format Such ...

Page 79: ... OFF Example MEAS TOT ON Turn on all measurements MEAS TOT The query returns ON 23 MEASure SOURce Command Format MEASure SOURce source MEASure SOURce Function Explanation The commands select and query the current measured channel source could be CHANnel1 or CHANnel2 Returned Format The query returns CH1 or CH2 Example MEAS SOUR CHAN1 Select the waveform form CH1 to measure MEAS SOUR The query retu...

Page 80: ...1000E DS1000D Series 2 68 WAVeform Command WAVeform Command reads the waveform data on the screen of the oscilloscope and returns up to 1024 data WAVeform Command includes WAVeform DATA The detailed information of each command are given as follows ...

Page 81: ...E DS1000D Series 2 69 1 WAVeform DATA Command Format WAVeform DATA source Function Explanation The command reads the waveform data in the specified source source could be CHANnel1 CHANnel2 DIGital MATH or FFT Returned Format The query returns 1024 data ...

Page 82: ...ommands are used for controlling the acquisition and analysis to digital signals executed by logic analyzer LA Commands include LA DISPlay DIGital n TURN DIGital n POSition LA THReshold LA POSition RESet LA GROUp LA GROUp n SIZe The detailed information of each command are given as follows ...

Page 83: ... Example LA DISP ON Open the digital channel LA DISP The query returns ON 2 DIGital n TURN Command Format DIGital n TURN ON OFF DIGital n TURN Function Explanation The commands set and query the On Off state of specified channel in digital channel The range of n is 0 15 Returned Format The query returns ON or OFF Example DIG2 TURN ON Open the digital channel 2 DIG2 TURN The query returns ON 3 DIGi...

Page 84: ...tion is 0 15 Returned Format The query returns the setting value of position Example DIG2 POS 3 Setup the waveform of digital channel2 displays at the position of D3 DIG2 POS The query returns 3 4 LA THReshold Command Format LA THReshold value suffix LA THReshold Function Explanation The commands set and query the type of threshold of digital channel value could be TTL CMOS ECL or User User define...

Page 85: ...f GROUp1 D7 D0 and GROUp2 D15 D8 n could be 1 or 2 Returned Format The query returns ON or OFF Example LA GROU1 ON Turn on the group D7 D0 LA GROU1 The query returns ON 7 LA GROUp n SIZe Command Format LA GROUp n SIZe size LA GROUp n SIZe Function Explanation The commands set and query the waveform size from group n could be 1 or 2 size could be Small or Big which represents to display 16 channels...

Page 86: ...RIGOL Command Systems Programming Guide for DS1000E DS1000D Series 2 74 LA GROU1 SIZ The query returns SMALL ...

Page 87: ...KEY F2 KEY F3 KEY F4 KEY F5 KEY MNUoff KEY MEASure KEY CURSor KEY ACQuire KEY DISPlay KEY STORage KEY UTILity KEY MNUTIME KEY MNUTRIG KEY Trig 50 KEY FORCe KEY V_POS_INC KEY V_POS_DEC KEY V_SCALE_INC KEY V_SCALE_DEC KEY H_SCALE_INC KEY H_SCALE_DEC KEY TRIG_LVL_INC KEY TRIG_LVL_DEC KEY H_POS_INC KEY H_POS_DEC KEY PROMPT_V KEY PROMPT_H KEY FUNCtion KEY FUNCtion KEY FUNCtion KEY LA KEY PROMPT_V_POS K...

Page 88: ...E Example KEY LOCK ENAB Enable the buttons on the front panel KEY LOCK The query returns ENABLE 2 KEY RUN Command Format KEY RUN Function Explanation The command controls the operating mode of the oscilloscope The running state will switch between ON and OFF if send this command continuously 3 KEY AUTO Command Format KEY AUTO Function Explanation The command sets every control values of the oscill...

Page 89: ...r disables Channel 2 and its menu display The On Off state of the channel along with its menu switched once you send this command continuously 6 KEY MATH Command Format KEY MATH Function Explanation The command enables or disables Math function and its menu display The On Off state of this function along with its menu switched once you send this command continuously 7 KEY REF Command Format KEY RE...

Page 90: ...ose options circularly 9 KEY F2 Command Format KEY F2 Function Explanation The command controls the option corresponds to F2 If some options exist in the drop down menu relative to this key repeat this command to select those options circularly 10 KEY F3 Command Format KEY F3 Function Explanation The command controls the option corresponds to F3 If some options exist in the drop down menu relative...

Page 91: ...f some options exist in the drop down menu relative to this key repeat this command to select those options circularly 13 KEY MNUoff Command Format KEY MNUoff Function Explanation The command enables or disables the current menu display The On Off state of this function switched once you send this command continuously 14 KEY MEASure Command Format KEY MEASure Function Explanation The command enabl...

Page 92: ...s Sample function and its menu display The On Off state of this function along with its menu switched once you send this command continuously 17 KEY DISPlay Command Format KEY DISPlay Function Explanation The command enables or disables Display function and its menu display The On Off state of this function along with its menu switched once you send this command continuously 18 KEY STORage Command...

Page 93: ...continuously 20 KEY MNUTIME Command Format KEY MNUTIME Function Explanation The command enables or disables Horizontal system and its menu display The On Off state of this function along with its menu switched once you send this command continuously 21 KEY MNUTRIG Command Format KEY MNUTRIG Function Explanation The command enables or disables Trigger and its menu display The On Off state of this f...

Page 94: ...ote control 24 KEY V_POS_INC Command Format KEY V_POS_INC Function Explanation The command increases the vertical scale of the current channel in uniformly spaced 25 KEY V_POS_DEC Command Format KEY V_POS_DEC Function Explanation The command reduces the vertical scale of the current channel in uniformly spaced 26 KEY V_SCALE_INC Command Format KEY V_SCALE_INC Function Explanation The command is us...

Page 95: ...ommand Format KEY H_SCALE_INC Function Explanation The command reduces the horizontal scale of the current channel in 5 2 1 29 KEY H_SCALE_DEC Command Format KEY H_SCALE_DEC Function Explanation The command increases the horizontal scale of the current channel in 1 2 5 30 KEY TRIG_LVL_INC Command Format KEY TRIG_LVL_INC Function Explanation The command increases the trigger level in uniformly spac...

Page 96: ...he horizontal offset of the current channel in uniformly spaced 33 KEY H_POS_DEC Command Format KEY H_POS_DEC Function Explanation The command reduces the horizontal offset of the current channel in uniformly spaced 34 KEY PROMPT_V Command Format KEY PROMPT_V Function Explanation The command switches the adjust mode of the vertical scale to Coarse or Fine Coarse steps in 1 2 5 and Coarse steps in ...

Page 97: ...at KEY FUNCtion Function Explanation The command enables the multi function knob 37 KEY FUNCtion Command Format KEY FUNCtion Function Explanation The command increases the offset of the multi function knob 38 KEY FUNCtion Command Format KEY FUNCtion Function Explanation The command reduces the offset of the multi function knob 39 KEY LA Command Format KEY LA Function Explanation The command enable...

Page 98: ...to zero 41 KEY PROMPT_H_POS Command Format KEY PROMPT_H_POS Function Explanation The command resets the trigger offset or the delay offset to zero 42 KEY PROMPT_TRIG_LVL Command Format KEY PROMPT_TRIG_LVL Function Explanation The command resets the position of trigger level to the center of the screen 43 KEY OFF Command Format KEY OFF Function Explanation The command turns off the CH1 CH2 MATH REF...

Page 99: ... Other Commands Besides above basic commands also there are other commands used for system language frequency counter and beep control Other Commands include INFO LANGuage COUNter ENABle BEEP ENABle BEEP ACTion The detailed information of each command are given as follows ...

Page 100: ... The query returns Simplified Chinese Traditional Chinese English Korean Japanese French German Russian Spanish or Portuguese Example INFO LANG SIMP Setup the system language as SIMPlifiedChinese INFO LANG The query returns Simplified Chinese 2 COUNter ENABle Command Format COUNter ENABle ON OFF COUNter ENABle Function Explanation The commands set and query the On Off state of the cymometer of the...

Page 101: ...xplanation The commands set and query the On Off state of the beeper Returned Format The query returns ON or OFF Example BEEP ENAB ON Turn on the beeper BEEP ENAB The query returns ON 4 BEEP ACTion Command Format BEEP ACTion Function Explanation The command makes the oscilloscope buzzed once no matter whether the beeper is on or not ...

Page 102: ......

Page 103: ... be downloaded from http www ni com In the example we assume NI VISA is installed under C Program Files IVI Foundation VISA Prepare for Programming In this text we use USB data cable to achieve the communication between DS1000E DS1000D and PC See the figure below C US RS232 Pass Fail out ISOLATEO After successful connection turn on the instrument a dialog will guide you to install the driver of Ri...

Page 104: ... 0 take the following steps 1 Create a project IDNDemo based on MFC 2 Add controls Button Combo Box and Edit Box 3 Modify the properties of the controls 1 Name the Button to be Send and Read See the figure below 2 Choose Data in the property of Combo Box input two commands manually IDN ACQ TYPE 3 Respectively add two variables m_combox and m_receive for the controls of Combo Box and Edit Box See t...

Page 105: ...planation In IDNDemo only three functions from this ddl are required which are GetTMCDeviceNum WriteUSB and ReadUSB the function has been mentioned in the header files Rigolusb h Now take GetTMCDeviceNum as an example to introduce how to recall these three functions HMODULE module LoadLibrary RigolTMCUsb_UI dll typedef int CALLBACK pGetDeviceNum if module pGetDeviceNum GetDevice pGetDeviceNum GetP...

Page 106: ...MCDeviceNum and WriteUSB function from RigolTMCUsb_UI dll HMODULE module LoadLibrary RigolTMCUsb_UI dll typedef bool CALLBACK pWrite unsigned long unsigned char unsigned char unsigned long unsigned char typedef int CALLBACK pGetDeviceNum temp cmdstr GetLength strInput unsigned char cmdstr GetBuffer 10 if module pGetDeviceNum GetDevice pGetDeviceNum GetProcAddress module GetTMCDeviceNum pWrite Writ...

Page 107: ...LBACK pWrite unsigned long unsigned char unsigned char unsigned long unsigned char typedef bool CALLBACK pRead unsigned long unsigned long unsigned char if module pWrite Write pWrite GetProcAddress module WriteUSB pRead Read pRead GetProcAddress module ReadUSB send a command to ask for value after the success a value could be obtained from the oscilloscope Write 0 2 2 len 0 read Returned Format fr...

Page 108: ... GetLBText m_combox GetCurSel strTemp strInput char LPCTSTR strTemp SendToUSB strInput readInfo Read_USB display the results UpdateData TRUE m_receive readInfo UpdateData FALSE 7 Save compile and run the project you will get a single executable program about demo When the oscilloscope has been successfully connected with PC select a command IDN from Combo Box to send then click the Send and Read b...

Page 109: ...e channel status that is when the channel is on the label shows relative colour on the contrary if the channel is off the colour of label will be gray see the figure below 3 Enter into the programming environment then quote the functions ReadUSB WriteUSB GetTMCDeviceNum in the Dynamic Link Library RigolTMCUsb_UI dll and add the following codes in the area of project code Private Declare Function R...

Page 110: ...ommand to the oscilloscope the definition of interface has been mentioned in Rigolusb h retcode WriteUSB 0 1 1 Len cmdstr VarPtr send_buf 0 End Sub acquire Returned Format from the oscilloscope Public Function Read_USB As String Dim retcode As Boolean Dim rcv_buffer 256 As Byte Dim tmpstr As String Dim i size As Long Dim rSize As Long rSize 100 tmpstr send a command to ask for value after the succ...

Page 111: ...eadbuf As String rSize 100 sendbuf CHAN1 DISP initialize the USB device i GetTMCDeviceNum send a query command and read the results Call SendToUSB sendbuf readbuf Read_USB confirm the light state of corresponding channel according to the Returned Format If readbuf ON Then send a setting command sendbuf CHAN1 DISP 0 Call SendToUSB sendbuf Label1 0 ForeColor H808080 gray Else sendbuf CHAN1 DISP 1 Ca...

Page 112: ...add them to CH2 and MATH 6 Dblclick Label and add the following codes Dim i As Long Dim sendbuf As String Dim readbuf As String rSize 100 sendbuf CHAN1 DISP i GetTMCDeviceNum Call SendToUSB sendbuf readbuf Read_USB If readbuf ON Then Label1 0 ForeColor HFFFF yellow Else Label1 0 ForeColor H808080 gray End If sendbuf CHAN2 DISP i GetTMCDeviceNum Call SendToUSB sendbuf readbuf Read_USB If readbuf ON...

Page 113: ...eviceNum Call SendToUSB sendbuf readbuf Read_USB If readbuf ON Then Label1 2 ForeColor H800080 purple Else Label1 2 ForeColor H808080 gray End If 7 Save and run the project you will get a single executable program about demo When the oscilloscope has been successfully connected with PC you can open close each channel conveniently by clicking the button ...

Page 114: ...oject Add Module create a Module for declaring the global variable rcv_buffer as follows Global rcv_buffer 10240 As Byte Note For the waveform data returned from the oscilloscope are too much to save please use this buffer 4 Enter into the programming environment then quote the functions ReadUSB WriteUSB GetDeviceNum in the Dynamic Link Library RigolTMCUsb_UI dll and add the following codes in the...

Page 115: ...r As String cmdstr cmd temp Len cmdstr For i 0 To temp 1 tempStr Mid cmdstr i 1 1 send_buf i Asc tempStr Next i send a command to the oscilloscope the definition of interface has been mentioned in Rigolusb h retcode WriteUSB 0 1 1 Len cmdstr VarPtr send_buf 0 End Sub acquire the Returned Value Public Function Read_USB As Long Dim retcode As Boolean Dim i size As Long Dim rSize As Long rSize 100 se...

Page 116: ...i GetTMCDeviceNum send a query command and read the results Call SendToUSB sendbuf DataLen Read_USB stepW Picture1 Width stepH Picture1 Height 256 clear the waveform Picture1 Cls For i 0 To DataLen 1 link the waveform points and set the waveform color to yellow Picture1 Line i stepW DataLen rcv_buffer i stepH i 1 stepW DataLen rcv_buffer i 1 stepH HFFFF Next i Note Codes of CH2 are similar to CH1 ...

Page 117: ...D Series 3 15 7 Save and run the project you will get a single executable program about demo When the oscilloscope has been successfully connected with PC you can read the waveform data of each channel conveniently by clicking the button ...

Page 118: ... 16 Programming based on VISA Program in Visual C 6 0 Open Visual C 6 0 take the following steps 1 Create a project based on MFC 2 Choose Project Settings C C select Code Generation in Category and Debug Multithreaded DLL in Use run time library click OK ...

Page 119: ...nclude files in Show directories for and then dblclick the blank in Directories to add the path of Include C Program Files IVI Foundation VISA WinNT include Select Library files in Show directories for and then dblclick the blank in Directories to add the path of Lib C Program Files IVI Foundation VISA WinNT lib msc Note At present VISA library has been added successfully The blank ...

Page 120: ...Edit See the figure below 6 Modify the properties of the controls 1 Name the Text to be Command 2 Choose Data in the property of Com box input three commands manually IDN OPC ACQuire TYPE 3 Choose General in the property of Edit and select Disable 4 Modify the name of Button such as Send and Read ...

Page 121: ...Programming Guide for DS1000E DS1000D Series 3 19 7 Respectively add two variables m_combox and m_receive for the controls of Com box and Edit ...

Page 122: ...B resource of visa viFindRsrc defaultRM USB list nmatches matches viOpen defaultRM matches VI_NULL VI_NULL vi send the receiving commands m_combox GetLBText m_combox GetCurSel strTemp strTemp strTemp n stringTemp char LPCTSTR strTemp viPrintf vi stringTemp read the result viScanf vi t n buf display the results UpdateData TRUE m_receive buf UpdateData FALSE viClose vi viClose defaultRM 9 Save build...

Page 123: ...Project Add Module Existing find the visa bas file in the filefolder of include under the path of NI VISA and add 3 Add two Command Buttons and Lables to the demo each button denotes each channel and each Label denotes different states yellow and light blue which is the channel s color indicates opening while gray indicates close of the channels See the figure below ...

Page 124: ...atches As String 200 reserve to acquire the equipment ID acquire USB resource of visa Call viOpenDefaultRM defrm Call viFindRsrc defrm USB list nmatches matches open the equipment Call viOpen defrm matches 0 0 vi send the command to query the state of CH1 Call viVPrintf vi CHAN1 DISP Chr 10 0 get the state of CH1 Call viVScanf vi t strRes If Left strRes 2 ON Then send the setting command Call viVP...

Page 125: ...E DS1000D Series 3 23 6 Save and run the project you will get a single executable program about demo When the oscilloscope has been successfully connected with PC you can open close each channel conveniently by clicking the button ...

Page 126: ...lowing steps 1 Open Block Diagram choose Instrument I O VISA then separately add four functions VISA Open VISA Read VISA Write and VISA Close See the figure below 2 Move the mouse to the item of VISA resource name on the control of VISA Open right click the mouse to choose Create Control See the figure below ...

Page 127: ...th WAV DATA n on the VISA Write control while the latter reads the waveform data shown on the screen 5 Open the Front Panel choose Modern Graph Waveform Graph to add a Waveform Graph control See the figure below 6 open Block Diagram right click and choose Programming String String Array Path and select String To Byte Array then use this function to connect read buffer on VISA Read function with th...

Page 128: ...buttons one of the buttons is used to control the start of waveform fetching and the other one is to stop capturing See the figure below 8 Right click the selector label and choose Edit Events Handled by This Case or Add Event case to add events respectively for each button Press Start to capture waveform and Stop to exit the program ...

Page 129: ...Programming Guide for DS1000E DS1000D Series 3 27 After you set the Start event see the result below ...

Page 130: ...000E DS1000D Series 3 28 9 Add a While Loop add Boolean True Constant to point the event of the Stop button to While and exit 10 Change the input tunnel of VISA resource name and errors into Shift Register to finish creating program ...

Page 131: ...Programming Guide for DS1000E DS1000D Series 3 29 11 Adjust the style of Front Panel and click Fetch Waveform to get following interface the oscilloscope has been properly connected ...

Page 132: ......

Page 133: ... 2 56 CHANnel n FILTer 2 57 CHANnel n MEMoryDepth 2 57 CHANnel n VERNier 2 58 COUNter ENABle 2 88 D DISPlay TYPE 2 11 DISPlay GRID 2 11 DISPlay PERSist 2 11 DISPlay MNUDisplay 2 12 DISPlay MNUStatus 2 12 DISPlay CLEar 2 13 DISPlay BRIGhtness 2 13 DISPlay INTensity 2 14 DIGital n TURN 2 71 DIGital n POSition 2 71 F FFT DISPlay 2 51 FORCetrig 2 25 H HARDcopy 2 5 I INFO LANGuage 2 88 K KEY LOCK 2 76 ...

Page 134: ...Reshold 2 72 LA POSition RESet 2 72 LA GROUp 2 73 LA GROUp n SIZe 2 73 M MATH DISPlay 2 51 MATH OPERate 2 51 MEASure CLEar 2 60 MEASure VPP 2 60 MEASure VMAX 2 60 MEASure VMIN 2 60 MEASure VAMPlitude 2 61 MEASure VTOP 2 61 MEASure VBASe 2 61 MEASure VAVerage 2 62 MEASure VRMS 2 62 MEASure OVERshoot 2 62 MEASure PREShoot 2 63 MEASure FREQuency 2 63 MEASure RISetime 2 63 MEASure FALLtime 2 64 MEASur...

Page 135: ...TRIGger SLOPe LEVelB TRIGger PATTern PATTern 2 36 TRIGger DURation PATTern 2 37 TRIGger DURation TIME 2 37 TRIGger DURation QUALifier 2 38 TRIGger ALTernation SOURce 2 39 TRIGger ALTernation TYPE 2 39 TRIGger ALTernation TimeSCALe 2 40 TRIGger ALTernation TimeOFFSet 2 40 TRIGger ALTernation mode LEVel 2 41 TRIGger ALTernation EDGE SLOPe 2 41 TRIGger ALTernation mode MODE 2 41 TRIGger ALTernation m...

Search results

Summary of Contents for DS1000E Series, DS1000D Series

Reviews:

Related manuals for DS1000E Series, DS1000D Series

Brands by name

Popular brands

Rigol DS1000E Series, DS1000D Series, Programming Manual

Search results

Summary of Contents for DS1000E Series, DS1000D Series

Reviews:

Related manuals for DS1000E Series, DS1000D Series

Brands by name

Popular brands