Rigol DG800 Pro Series Operating instructions

Guaranty and Declaration
Copyright
© 2023 RIGOL TECHNOLOGIES CO., LTD. All Rights Reserved.
Trademark Information
RIGOL®is the trademark of RIGOL TECHNOLOGIES CO., LTD.
Notices
•RIGOL products are covered by P.R.C. and foreign patents, issued and pending.
•RIGOL reserves the right to modify or change parts of or all the specifications and pricing
policies at the company's sole decision.
•Information in this publication replaces all previously released materials.
•Information in this publication is subject to change without notice.
•RIGOL shall not be liable for either incidental or consequential losses 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 be copied, photocopied, or rearranged without prior
written approval of RIGOL.
Product Certification
RIGOL guarantees that this product conforms to the national and industrial standards in China as
well as the ISO9001:2015 standard and the ISO14001:2015 standard. Other international standard
conformance certifications are in progress.
Contact Us
If you have any problem or requirement when using our products or this manual, please contact
RIGOL.
E-mail: ser[email protected]
Website:
http://www.rigol.com

Section Description Page
List of Tables..................................................................................................................................IX
1 Document Overview ....................................................................................................... 1
2 Programming Overview .................................................................................................3
2.1 SCPI Introduction .................................................................................................................................3
2.2 Remote Control ....................................................................................................................................5
3 Command System ............................................................................................................7
3.1 :ABORt ..................................................................................................................................................... 7
3.2 :COUNter Commands .........................................................................................................................8
3.2.1 :COUNter:AVERage:ALL? ...................................................................................................... 8
3.2.2 :COUNter:AVERage:CLEar .................................................................................................... 9
3.2.3 :COUNter:AVERage[:STATe] ................................................................................................. 9
3.2.4 :COUNter:COUPling .............................................................................................................10
3.2.5 :COUNter[:FREQuency]:RANGe ....................................................................................... 10
3.2.6 :COUNter:GATetime .............................................................................................................11
3.2.7 :COUNter:GATetime:AUTO[:STATe] ................................................................................. 12
3.2.8 :COUNter:HF .......................................................................................................................... 12
3.2.9 :COUNter:IMPedance ..........................................................................................................13
3.2.10 :COUNter:MEASure? ............................................................................................................14
3.2.11 :COUNter:RUN:STATe .......................................................................................................... 14
3.2.12 :COUNter:SINGle .................................................................................................................. 15
3.2.13 :COUNter[:STATe] ..................................................................................................................16
3.3 :DISPlay Commands ......................................................................................................................... 16
3.3.1 :DISPlay:BRIGhtness .............................................................................................................16
3.3.2 :DISPlay:COUNter .................................................................................................................17
3.3.3 :DISPlay:FOCus ...................................................................................................................... 18
3.3.4 :DISPlay[:STATe] .....................................................................................................................18
3.3.5 :DISPlay:TEXT ......................................................................................................................... 19
3.3.6 :DISPlay:TEXT:CLEar ............................................................................................................. 20
3.3.7 :DISPlay:UNIT:PULSe ............................................................................................................20
3.3.8 :DISPlay:UNIT:RATE ..............................................................................................................21
3.3.9 :DISPlay:UNIT:SWEep ..........................................................................................................21
3.3.10 :DISPlay:UNIT:VOLTage .......................................................................................................22
3.4 :HCOPy Commands ..........................................................................................................................23
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
I

3.4.1 :HCOPy:SDUMp:DATA? .......................................................................................................23
3.4.2 :HCOPy:SDUMp:DATA:FORMat ........................................................................................23
3.5 IEEE488.2 Common Commands ...................................................................................................24
3.5.1 *CLS ...........................................................................................................................................26
3.5.2 *ESE ...........................................................................................................................................26
3.5.3 *ESR? .........................................................................................................................................27
3.5.4 *IDN? ........................................................................................................................................ 27
3.5.5 *OPC ......................................................................................................................................... 28
3.5.6 *OPT? ........................................................................................................................................29
3.5.7 *PSC .......................................................................................................................................... 29
3.5.8 *RCL ...........................................................................................................................................30
3.5.9 *RST ...........................................................................................................................................31
3.5.10 *SAV .......................................................................................................................................... 31
3.5.11 *SRE ...........................................................................................................................................32
3.5.12 *STB? .........................................................................................................................................32
3.5.13 *TRG ..........................................................................................................................................33
3.5.14 *TST? .........................................................................................................................................33
3.5.15 *WAI ..........................................................................................................................................34
3.6 :INITiate Commands .........................................................................................................................34
3.6.1 :INITiate[<n>]:CONTinuous ..............................................................................................35
3.6.2 :INITiate[<n>]:CONTinuous:ALL ......................................................................................36
3.6.3 :INITiate[<n>][:IMMediate] ...............................................................................................36
3.6.4 :INITiate[<n>][:IMMediate]:ALL ...................................................................................... 37
3.7 :LXI Commands ..................................................................................................................................37
3.7.1 :LXI:MDNS:STATe ...................................................................................................................38
3.7.2 :LXI:MDNS:SNAMe:DESired .............................................................................................. 38
3.7.3 :LXI:RESet .................................................................................................................................39
3.7.4 :LXI:RESTart .............................................................................................................................39
3.8 :MEMory Commands .......................................................................................................................40
3.8.1 :MEMory:NSTates? ............................................................................................................... 40
3.8.2 :MEMory:STATe:CATalog? ...................................................................................................40
3.8.3 :MEMory:STATe:DELete .......................................................................................................41
3.8.4 :MEMory:STATe:NAME ........................................................................................................42
3.8.5 :MEMory:STATe:RECall:AUTO ............................................................................................42
3.8.6 :MEMory:STATe:VALid? ....................................................................................................... 43
3.9 :MMEMory Commands ...................................................................................................................44
3.9.1 :MMEMory:CATalog[:ALL]? ................................................................................................44
DG800 Pro/DG900 Pro Programming
Guide
II
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3.9.2 :MMEMory:CATalog:DATA:ARBitrary? ............................................................................45
3.9.3 :MMEMory:CATalog:STATe? ...............................................................................................46
3.9.4 :MMEMory:CDIRectory .......................................................................................................47
3.9.5 :MMEMory:COPY ..................................................................................................................47
3.9.6 :MMEMory:COPY:SEQuence .............................................................................................48
3.9.7 :MMEMory:DELete ...............................................................................................................49
3.9.8 :MMEMory:LOAD:DATA ......................................................................................................49
3.9.9 :MMEMory:LOAD:STATe ..................................................................................................... 50
3.9.10 :MMEMory:MDIRectory ..................................................................................................... 51
3.9.11 :MMEMory:MOVE ................................................................................................................ 51
3.9.12 :MMEMory:RDIRectory .......................................................................................................52
3.9.13 :MMEMory:STORe:DATA .................................................................................................... 53
3.9.14 :MMEMory:STORe:STATe ....................................................................................................53
3.10 :OUTPut Commands .........................................................................................................................54
3.10.1 :OUTPut[<n>]:IDLE .............................................................................................................. 54
3.10.2 :OUTPut[<n>]:LOAD ............................................................................................................55
3.10.3 :OUTPut[<n>]:POLarity ...................................................................................................... 56
3.10.4 :OUTPut[<n>][:STATe] .........................................................................................................56
3.10.5 :OUTPut[<n>]:SYNC ............................................................................................................57
3.10.6 :OUTPut[<n>]:SYNC:MODE ..............................................................................................58
3.10.7 :OUTPut[<n>]:SYNC:POLarity ..........................................................................................59
3.10.8 :OUTPut[<n>]:SYNC:SOURce ...........................................................................................59
3.10.9 :OUTPut[<n>]:TRIGger .......................................................................................................60
3.10.10 :OUTPut[<n>]:TRIGger:SLOPe ......................................................................................... 61
3.11 :SOURce Commands ........................................................................................................................ 62
3.11.1 [:SOURce[<n>]]:AM .............................................................................................................64
3.11.1.1 [:SOURce[<n>]]:AM:DEPTh ...............................................................................64
3.11.1.2 [:SOURce[<n>]]:AM:DSSC .................................................................................65
3.11.1.3 [:SOURce[<n>]]:AM:INTernal:FREQuency ....................................................65
3.11.1.4 [:SOURce[<n>]]:AM:INTernal:FUNCtion .......................................................66
3.11.1.5 [:SOURce[<n>]]:AM:SOURce ............................................................................67
3.11.1.6 [:SOURce[<n>]]:AM:STATe ................................................................................ 68
3.11.2 [:SOURce[<n>]]:APPLy ........................................................................................................68
3.11.2.1 [:SOURce[<n>]]:APPLy? ......................................................................................69
3.11.2.2 [:SOURce[<n>]]:APPLy:ARBitrary ....................................................................69
3.11.2.3 [:SOURce[<n>]]:APPLy:DC .................................................................................70
3.11.2.4 [:SOURce[<n>]]:APPLy:NOISe ..........................................................................71
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
III

3.11.2.5 [:SOURce[<n>]]:APPLy:PULSe ..........................................................................72
3.11.2.6 [:SOURce[<n>]]:APPLy:RAMP .......................................................................... 73
3.11.2.7 [:SOURce[<n>]]:APPLy:SINusoid .....................................................................74
3.11.2.8 [:SOURce[<n>]]:APPLy:SQUare ....................................................................... 75
3.11.3 [:SOURce[<n>]]:ASKey ....................................................................................................... 76
3.11.3.1 [:SOURce[<n>]]:ASKey:AMPLitude ................................................................ 76
3.11.3.2 [:SOURce[<n>]]:ASKey:INTernal:RATE ...........................................................77
3.11.3.3 [:SOURce[<n>]]:ASKey:POLarity ..................................................................... 78
3.11.3.4 [:SOURce[<n>]]:ASKey:SOURce ...................................................................... 78
3.11.3.5 [:SOURce[<n>]]:ASKey:STATe ...........................................................................79
3.11.4 [:SOURce[<n>]]:BURSt ........................................................................................................80
3.11.4.1 [:SOURce[<n>]]:BURSt:GATE:POLarity .......................................................... 80
3.11.4.2 [:SOURce[<n>]]:BURSt:INTernal:PERiod .......................................................81
3.11.4.3 [:SOURce[<n>]]:BURSt:MODE ..........................................................................82
3.11.4.4 [:SOURce[<n>]]:BURSt:NCYCles ......................................................................83
3.11.4.5 [:SOURce[<n>]]:BURSt:PHASe .........................................................................84
3.11.4.6 [:SOURce[<n>]]:BURSt:STATe ...........................................................................84
3.11.5 [:SOURce[<n>]]:FM ..............................................................................................................85
3.11.5.1 [:SOURce[<n>]]:FM[:DEViation] ......................................................................85
3.11.5.2 [:SOURce[<n>]]:FM:INTernal:FREQuency .....................................................86
3.11.5.3 [:SOURce[<n>]]:FM:INTernal:FUNCtion ........................................................87
3.11.5.4 [:SOURce[<n>]]:FM:SOURce ............................................................................ 88
3.11.5.5 [:SOURce[<n>]]:FM:STATe .................................................................................89
3.11.6 [:SOURce[<n>]]:FREQuency ............................................................................................. 90
3.11.6.1 [:SOURce[<n>]]:FREQuency ............................................................................. 90
3.11.6.2 [:SOURce[<n>]]:FREQuency:CENTer ..............................................................91
3.11.6.3 [:SOURce[<n>]]:FREQuency:COUPle:MODE ............................................... 92
3.11.6.4 [:SOURce[<n>]]:FREQuency:COUPle:OFFSet ..............................................93
3.11.6.5 [:SOURce[<n>]]:FREQuency:COUPle:RATio .................................................94
3.11.6.6 [:SOURce[<n>]]:FREQuency:COUPle[:STATe] ..............................................94
3.11.6.7 [:SOURce[<n>]]:FREQuency:SPAN ................................................................. 95
3.11.6.8 [:SOURce[<n>]]:FREQuency:STARt .................................................................96
3.11.6.9 [:SOURce[<n>]]:FREQuency:STOP ..................................................................97
3.11.7 [:SOURce[<n>]]:FSKey ........................................................................................................98
3.11.7.1 [:SOURce[<n>]]:FSKey:FREQuency .................................................................98
3.11.7.2 [:SOURce[<n>]]:FSKey:INTernal:RATE ............................................................99
3.11.7.3 [:SOURce[<n>]]:FSKey:POLarity ....................................................................100
DG800 Pro/DG900 Pro Programming
Guide
IV
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3.11.7.4 [:SOURce[<n>]]:FSKey:SOURce .....................................................................101
3.11.7.5 [:SOURce[<n>]]:FSKey:STATe ......................................................................... 102
3.11.8 [:SOURce[<n>]]:FUNCtion ..............................................................................................102
3.11.8.1 [:SOURce[<n>]]:FUNCtion ..............................................................................103
3.11.8.2 [:SOURce[<n>]]:FUNCtion:ARBitrary .......................................................... 103
3.11.8.3 [:SOURce[<n>]]:FUNCtion:PULSe:DCYCle .................................................104
3.11.8.4 [:SOURce[<n>]]:FUNCtion:PULSe:PERiod ................................................. 105
3.11.8.5 [:SOURce[<n>]]:FUNCtion:PULSe:TRANsition:LEADing ....................... 106
3.11.8.6 [:SOURce[<n>]]:FUNCtion:PULSe:TRANsition:TRAiling ........................107
3.11.8.7 [:SOURce[<n>]]:FUNCtion:PULSe:WIDTh ..................................................108
3.11.8.8 [:SOURce[<n>]]:FUNCtion:RAMP:SYMMetry ...........................................109
3.11.8.9 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:APPLy ...................................110
3.11.8.10 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:CLEar ....................................110
3.11.8.11 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:FILTer ....................................111
3.11.8.12 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:LENGth ................................111
3.11.8.13 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:PERiod .................................112
3.11.8.14 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:SRATe ...................................113
3.11.8.15 [:SOURce[<n>]]:FUNCtion:SEQuence:LIST:WAVE ...................................114
3.11.8.16 [:SOURce[<n>]]:FUNCtion:SEQuence[:STATe] ..........................................115
3.11.8.17 [:SOURce[<n>]]:FUNCtion:SQUare:DCYCle .............................................. 116
3.11.8.18 [:SOURce[<n>]]:FUNCtion:SQUare:PERiod ...............................................117
3.11.9 [:SOURce[<n>]]:HARMonic ............................................................................................118
3.11.9.1 [:SOURce[<n>]]:HARMonic:COMBine ........................................................ 118
3.11.9.2 [:SOURce[<n>]]:HARMonic:COMBine:AMPLitude ................................. 119
3.11.9.3 [:SOURce[<n>]]:HARMonic:COMBine:PHASe ..........................................120
3.11.9.4 [:SOURce[<n>]]:HARMonic:ORDer ..............................................................121
3.11.9.5 [:SOURce[<n>]]:HARMonic:ORDEr:AMPLitude .......................................122
3.11.9.6 [:SOURce[<n>]]:HARMonic:ORDEr:PHASe ............................................... 122
3.11.9.7 [:SOURce[<n>]]:HARMonic[:TYPE] .............................................................. 123
3.11.10 [:SOURce[<n>]]:MARKer:FREQuency ..........................................................................124
3.11.11 [:SOURce[<n>]]:PARameter:COPY ............................................................................... 125
3.11.12 [:SOURce[<n>]]:PHASe ....................................................................................................126
3.11.12.1 [:SOURce[<n>]]:PHASe ....................................................................................126
3.11.12.2 [:SOURce[<n>]]:PHASe:COUPle:MODE ......................................................127
3.11.12.3 [:SOURce[<n>]]:PHASe:COUPle:OFFSet .....................................................128
3.11.12.4 [:SOURce[<n>]]:PHASe:COUPle:RATio ....................................................... 128
3.11.12.5 [:SOURce[<n>]]:PHASe:COUPle[:STATe] .................................................... 129
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
V

3.11.12.6 [:SOURce[<n>]]:PHASe:SYNChronize .........................................................130
3.11.13 [:SOURce[<n>]]:PM ...........................................................................................................131
3.11.13.1 [:SOURce[<n>]]:PM:DEViation ......................................................................131
3.11.13.2 [:SOURce[<n>]]:PM:INTernal:FREQuency ..................................................132
3.11.13.3 [:SOURce[<n>]]:PM:INTernal:FUNCtion .....................................................133
3.11.13.4 [:SOURce[<n>]]:PM:SOURce ..........................................................................134
3.11.13.5 [:SOURce[<n>]]:PM:STATe .............................................................................. 134
3.11.14 [:SOURce[<n>]]:PSKey ..................................................................................................... 135
3.11.14.1 [:SOURce[<n>]]:PSKey:INTernal:RATE .........................................................135
3.11.14.2 [:SOURce[<n>]]:PSKey:PHASe .......................................................................136
3.11.14.3 [:SOURce[<n>]]:PSKey:POLarity ................................................................... 137
3.11.14.4 [:SOURce[<n>]]:PSKey:SOURce .................................................................... 138
3.11.14.5 [:SOURce[<n>]]:PSKey:STATe .........................................................................139
3.11.15 [:SOURce[<n>]]:PWM ...................................................................................................... 139
3.11.15.1 [:SOURce[<n>]]:PWM:DEViation ..................................................................140
3.11.15.2 [:SOURce[<n>]]:PWM:DEViation:DCYCle .................................................. 140
3.11.15.3 [:SOURce[<n>]]:PWM:INTernal:FREQuency ..............................................141
3.11.15.4 [:SOURce[<n>]]:PWM:INTernal:FUNCtion .................................................142
3.11.15.5 [:SOURce[<n>]]:PWM:SOURce ..................................................................... 143
3.11.15.6 [:SOURce[<n>]]:PWM:STATe ..........................................................................144
3.11.16 [:SOURce[<n>]]:SUM ........................................................................................................145
3.11.16.1 [:SOURce[<n>]]:SUM:AMPLitude .................................................................145
3.11.16.2 [:SOURce[<n>]]:SUM:INTernal:FREQuency ...............................................146
3.11.16.3 [:SOURce[<n>]]:SUM:INTernal:FUNCtion ..................................................147
3.11.16.4 [:SOURce[<n>]]:SUM:SOURce .......................................................................147
3.11.16.5 [:SOURce[<n>]]:SUM:STATe ........................................................................... 148
3.11.17 [:SOURce[<n>]]:SWEep ................................................................................................... 149
3.11.17.1 [:SOURce[<n>]]:SWEep:HTIMe:STARt ........................................................ 149
3.11.17.2 [:SOURce[<n>]]:SWEep:HTIMe[:STOP] .......................................................150
3.11.17.3 [:SOURce[<n>]]:SWEep:RTIMe ......................................................................151
3.11.17.4 [:SOURce[<n>]]:SWEep:SPACing ..................................................................152
3.11.17.5 [:SOURce[<n>]]:SWEep:STATe .......................................................................153
3.11.17.6 [:SOURce[<n>]]:SWEep:STEP .........................................................................154
3.11.17.7 [:SOURce[<n>]]:SWEep:TIME ........................................................................ 154
3.11.18 [:SOURce[<n>]][:TRACe]:DATA:DAC16 ....................................................................... 155
3.11.19 [:SOURce[<n>]]:TRACk .................................................................................................... 157
3.11.20 [:SOURce[<n>]]:VOLTage ................................................................................................158
DG800 Pro/DG900 Pro Programming
Guide
VI
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3.11.20.1 [:SOURce[<n>]]:VOLTage ................................................................................158
3.11.20.2 [:SOURce[<n>]]:VOLTage:COUPle:MODE ..................................................159
3.11.20.3 [:SOURce[<n>]]:VOLTage:COUPle:OFFSet .................................................160
3.11.20.4 [:SOURce[<n>]]:VOLTage:COUPle:RATio ................................................... 161
3.11.20.5 [:SOURce[<n>]]:VOLTage:COUPle[:STATe] .................................................161
3.11.20.6 [:SOURce[<n>]]:VOLTage:HIGH .................................................................... 162
3.11.20.7 [:SOURce[<n>]]:VOLTage:LOW ..................................................................... 163
3.11.20.8 [:SOURce[<n>]]:VOLTage:OFFSet .................................................................164
3.11.20.9 [:SOURce[<n>]]:VOLTage:UNIT .....................................................................165
3.12 :SYSTem Commands ...................................................................................................................... 166
3.12.1 :SYSTem:BEEPer[:IMMediate] ......................................................................................... 166
3.12.2 :SYSTem:BEEPer:STATe ......................................................................................................166
3.12.3 :SYSTem:DATE ......................................................................................................................167
3.12.4 :SYSTem:COMMunicate ................................................................................................... 167
3.12.4.1 :SYSTem:COMMunicate:LAN:CONTrol? ......................................................167
3.12.4.2 :SYSTem:COMMunicate:LAN:DHCP[:STATe] ..............................................168
3.12.4.3 :SYSTem:COMMunicate:LAN:DNS ................................................................169
3.12.4.4 :SYSTem:COMMunicate:LAN:DOMain? ...................................................... 170
3.12.4.5 :SYSTem:COMMunicate:LAN:GATeway .......................................................170
3.12.4.6 :SYSTem:COMMunicate:LAN:HOSTname ...................................................171
3.12.4.7 :SYSTem:COMMunicate:LAN:IPADdress .....................................................171
3.12.4.8 :SYSTem:COMMunicate:LAN:MAC? .............................................................172
3.12.4.9 :SYSTem:COMMunicate:LAN:SMASk ...........................................................173
3.12.4.10 :SYSTem:COMMunicate:LAN:UPDate ..........................................................173
3.12.4.11 :SYSTem:COMMunicate:USB:INFormation? .............................................. 174
3.12.5 :SYSTem:ERRor? .................................................................................................................. 175
3.12.6 :SYSTem:KLOCk ...................................................................................................................175
3.12.7 :SYSTem:LANGuage ...........................................................................................................176
3.12.8 :SYSTem:LICense:CATalog? ..............................................................................................176
3.12.9 :SYSTem:LICense:DELete ..................................................................................................177
3.12.10 :SYSTem:LICense:DELete:ALL ..........................................................................................178
3.12.11 :SYSTem:LICense:INSTall .................................................................................................. 178
3.12.12 :SYSTem:LICense:INSTall:UDISk ..................................................................................... 179
3.12.13 :SYSTem:PSTatus .................................................................................................................180
3.12.14 :SYSTem:TIME ...................................................................................................................... 180
3.12.15 :SYSTem:TOUCh .................................................................................................................. 181
3.12.16 :SYSTem:VERSion? ..............................................................................................................182
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
VII

3.12.17 :SYSTem:ROSCillator:SOURce ........................................................................................ 182
3.13 :TRIGger Commands ......................................................................................................................183
3.13.1 :TRIGger<n>:COUNt .........................................................................................................183
3.13.2 :TRIGger<n>:DELay ...........................................................................................................184
3.13.3 :TRIGger<n>[:IMMediate] .............................................................................................. 185
3.13.4 :TRIGger<n>:SLOPe .......................................................................................................... 186
3.13.5 :TRIGger<n>:SOURce .......................................................................................................186
3.13.6 :TRIGger<n>:TIMer ........................................................................................................... 187
4 Application Examples .................................................................................................189
4.1 To Output Basic Waveforms ........................................................................................................189
4.2 To Output Arbitrary Waveforms ................................................................................................189
4.3 To Output Harmonic ......................................................................................................................190
4.4 To Output AM Modulated Waveform ......................................................................................190
4.5 To Output FSK Modulated Waveform ..................................................................................... 191
4.6 To Output a Frequency Sweep ...................................................................................................191
4.7 To Output a Burst Waveform ......................................................................................................192
4.8 To Use the Frequency Counter ...................................................................................................193
5 Programming Examples ............................................................................................194
5.1 Programming Preparations .........................................................................................................194
5.2 LabVIEW Programming Example .............................................................................................. 194
5.3 Visual Basic Programming Example .........................................................................................201
5.4 Visual C++ Programming Example ..........................................................................................202
DG800 Pro/DG900 Pro Programming
Guide
VIII
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

List of Tables
Table 3.1 Unit Description .......................................................................................................7
Table 3.21 Table of the Bit Definition of Standard Event Status Register .............24
Table 3.22 Table of the Bit Definition of Status Byte Register ..................................25
Table 3.60 Range of Continuous Waveform Frequency .............................................62
Table 3.61 Range of Continuous Waveform Period .....................................................63
Table 3.62 Range of Amplitude ...........................................................................................63
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
IX

DG800 Pro/DG900 Pro Programming
Guide
X
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

1Document Overview
This manual introduces how to program and control DG800 Pro and DG900 Pro series
function/arbitrary waveform generator via the remote interface by using the SCPI
(Standard Commands for Programmable Instruments) commands. DG800 Pro and
DG900 Pro series can communicate with PC through USB or LAN interface.
TIP
For the latest version of this manual, download it from RIGOL official website ( www.rigol.com ).
Publication Number
PGB16100-1110
Software Version
00.01.00
Software upgrade might change or add product features. Please acquire the latest
version of the manual from RIGOL website or contact RIGOL to upgrade the software.
Format Conventions in this Manual
1. Key
The front panel key is denoted by the menu key icon. For example,
indicates the "Default" key.
2. Menu
The menu item is denoted by the format of "Menu Name (Bold) + Character
Shading" in the manual. For example, Setup.
3. Operation Procedures
The next step of the operation is denoted by ">" in the manual. For example,
> Utility indicates first clicking or tapping and then clicking or tapping Utility.
Content Conventions in this Manual
DG800 Pro series function/arbitrary waveform generator includes the following
models. Unless otherwise specified, this manual takes the two-channel model DG852
Pro as an example to illustrate the functions and operation methods of DG800 Pro
series.
Model No. of Channels Sample Rate Max. Output
Frequency
DG821 Pro 1 625 MSa/s 25 MHz
Document Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
1

Model No. of Channels Sample Rate Max. Output
Frequency
DG822 Pro 2 625 MSa/s 25 MHz
DG852 Pro 2 625 MSa/s 50 MHz
DG900 Pro series function/arbitrary waveform generator includes the following
models. Unless otherwise specified, this manual takes DG922 Pro as an example to
illustrate the functions and operation methods of DG900 Pro series.
Model No. of Channels Sample Rate Max. Output
Frequency
DG902 Pro 2 1.25 GSa/s 70 MHz
DG912 Pro 2 1.25 GSa/s 150 MHz
DG922 Pro 2 1.25 GSa/s 200 MHz
Document Overview
DG800 Pro/DG900 Pro Programming
Guide
2
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

2Programming Overview
2.1 SCPI Introduction
SCPI (Standard Commands for Programmable Instruments) is a standardized
instrument programming language that is built upon the existing standard IEEE 488.1
and IEEE 488.2 and conforms to various standards, such as the floating point
operation rule in IEEE 754 standard, ISO 646 7-bit coded character set for information
interchange (equivalent to ASCII programming). The SCPI commands provide a
hierarchical tree structure, and consist of multiple subsystems. Each command
subsystem consists of one root keyword and one or more sub-keywords.
Syntax
The command line usually starts with a colon; the keywords are separated by colons,
and following the keywords are the parameter settings available. The command
ending with a question mark indicates querying a certain function and returns the
query results. The keywords of the command and the first parameter are separated by
a space.
For example,
:COUNter:TYPE <
type >
:COUNter:TYPE?
COUNter is the root keyword of the command, TYPE is the second-level keyword. The
command line starts with a colon, and different levels of keywords are also separated
by colons. <
type > indicates a settable parameter. The command ending with a
quotation mark indicates querying a function. The command
keywords :COUNter:TYPE and the parameter <
type > are separated by a space.
In some commands with parameters, "," is often used to separate multiple
parameters. For example,
:SYSTem:DATE < year >,< month >,< day >
Symbol Description
The following symbols are not sent with the commands.
1. Braces { }
The contents in the braces can contain one or multiple parameters. These
parameters can be omitted or used for several times. Parameters are usually
separated by the vertical bar "|". When using the command, you must select one of
the parameters.
2. Vertical Bar |
Programming Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
3

The vertical bar is used to separate multiple parameters. When using the
command, you must select one of the parameters.
3. Square Brackets [ ]
The contents in the square brackets can be omitted.
4. Angle Brackets < >
The parameter enclosed in the angle brackets must be replaced by an effective
value.
Parameter Type
1. Bool
The parameter can be set to ON, OFF, 1, or 0. For example,
:SYSTem:BEEPer:STATe <
bool >
:SYSTem:BEEPer:STATe?
Wherein, < bool > can be set to {{1|ON}|{0|OFF}}. The query returns 1 or 0.
2. Discrete
The parameter can be any of the values listed. For example,
:SYSTem:PSTatus <
sat >
:SYSTem:PSTatus?
Wherein,
-<
sat > can be set to DEFault|OPEN.
-The query returns an abbreviated form: DEF or OPEN.
3. Integer
Unless otherwise specified, the parameter can be any integer (NR1 format) within
the effective value range.
CAUTION
Do not set the parameter to a decimal; otherwise, errors will occur.
For example,
[:SOURce[< n >]]:SWEep:STEP {< step >|< lim >}
Wherein, < step > can be set to an integer ranging from 2 to 1024. The query
returns an integer ranging from 2 to 1024.
4. Real
The parameter can be any real number within the effective value range, and this
command accepts parameter input in decimal (NR2 format) and scientific notation
(NR3 format). For example,
Programming Overview
DG800 Pro/DG900 Pro Programming
Guide
4
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

[:SOURce[< n >]]:AM:INTernal:FREQuency {< frequency >|< lim_set >}
[:SOURce[< n >]]:AM:INTernal:FREQuency? [< lim_query >]
Wherein, <
frequency > can be set to any real number ranging from 2E-3 (2 mHz) to
1E+6 (1 MHz). The query returns a real number in scientific notation.
5. ASCII String
The parameter can be the combinations of ASCII characters. For example,
:SYSTem:COMMunicate:LAN:GATEway < string >
Wherein, < string > can be set to 192.168.1.1.
Use the MINimum, MAXimum, and DEFault parameters
For many commands, you can substitute "MINimum" or "MAXimum" in place of a
parameter. In some cases, you can also substitute "DEFault". For example,
[:SOURce[<
n >]]:FREQuency:STARt {< frequency >|< lim_set >}
Wherein, < lim_set > can be set to MINimum|MAXimum|DEFault.
Instead of selecting a specific value for < frequency >, you can substitute MINimum to
set the frequency to its minimum value and MAXimum to set the frequency to its
maximum value. You can also use DEFault to set the frequency to its default value.
Command Abbreviation
All the commands are case-insensitive. They can all be in upper case or in lower case.
If abbreviation is used, you must input all the capital letters in the command. For
example,
:SYSTem:LANGuage?
can be abbreviated as
:SYST:LANG?
2.2 Remote Control
This instrument can be connected to the PC via the USB and LAN interfaces to set up
communication and realize remote control through the PC. The remote control can be
realized by using SCPI (Standard Commands for Programmable Instruments)
commands.
PC Software
Users usually need to use the PC software to send commands to control the
instrument remotely. When the instrument is connected to the PC via the USB or LAN
interface, the PC software can search for instrument resources and enable command
interaction.
Programming Overview
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
5

Web Control
When the instrument is connected to the PC via the LAN interface, you can use Web
Control to send SCPI commands from the PC to the instrument. Operation
Procedures:
1. Obtain the instrument's IP address and input it in the browser address bar to log in
to the Web Control page.
2. After you enter the Web Control interface, click the "SCPI Panel Control" button to
enter the SCPI Command interface.
3. Input the specified SCPI command and then click Send & Read to send the
command. The operation process and the returned value will be displayed in the
current interface.
Programming Overview
DG800 Pro/DG900 Pro Programming
Guide
6
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.

3Command System
This chapter introduces the syntax, functions, parameters, and usage of each DG800
Pro/DG900 Pro command.
For the parameter setting command (frequency, amplitude, offset, high level, low
level, time), the instrument can recognize the unit. If omitted, it is interpreted as the
default unit. For the default units of parameters, see the table below.
Table 3.1 Unit Description
Parameter Available Units Default Unit
Frequency MHZ, KHZ, HZ, UHZ HZ
Amplitude VPP, MVPP, VRMS, MVRMS,
DBM
VPP, VRMS, or DBM
(related to the current
amplitude unit)
Offset/High Level/Low
Level V, MV V
Time KS, S, MS, US, NS S
NOTE
Since the SCPI parser is case-insensitive, there is some confusion over the letter "M" (or "m").
For your convenience, this instrument interprets "mV" (or "MV") as millivolts and "ms" (or
"Ms") as milliseconds. However, it interprets "MHZ" (or "mhz") as megahertz.
3.1 :ABORt
Syntax
:ABORt
Description
Stops any operation that is triggered.
Parameter
None.
Remarks
None.
Command System
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DG800 Pro/DG900 Pro Programming
Guide
7

Return Format
None.
Examples
:ABORt /*Stops any operation that is triggered.*/
3.2 :COUNter Commands
:COUNter commands are used to enable/disable the counter function, and set the
counter.
3.2.1 :COUNter:AVERage:ALL?
Syntax
:COUNter:AVERage:ALL?
Description
Queries the statistical results for counter measurements.
Parameter
None.
Remarks
The counter can provide the statistical function for the current measurement
parameters. Use :DISPlay:COUNter to set and query the current measurement
parameters.
Return Format
The query returns a string which consists of 6 parts (representing the current value,
maximum value, minimum value, average value, standard deviation, and statistical
count respectively) separated by commas. For example, the query might return
+1.000004E+06,+1.000005E+06,+1.000003E+06,+1.000004E+06,+0.000000E+00,35,
indicating that the current value is 1.000,004 MHz, the maximum value is 1.000,005
MHz, the minimum value is 1.000,003 MHz, the average value is 1.000,004 MHz, the
standard deviation is 0 Hz, and the count is 35.
When the counter statistical function is disabled, send this command and the query
returns 0,0,0,0,0,0.
Examples
:COUNter:AVERage:ALL? /*Queries the statistical results for counter
measurements. The query might return +1.000004E+06,+1.000005E
+06,+1.000003E+06,+1.000004E+06,+0.000000E+00,35.*/
Command System
DG800 Pro/DG900 Pro Programming
Guide
8
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.