Page 1
Page 2
Guaranty and Declaration
Copyright
© 2025 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: service@rigol.com
Website:
http://www.rigol.com
Page 3
Section Description Page
List of Figures.............................................................................................................................XIX
List of Tables................................................................................................................................ XX
1 Document Overview ....................................................................................................... 1
2 Programming Overview .................................................................................................3
2.1 SCPI Command Overview .................................................................................................................3
2.2 Remote Control ....................................................................................................................................5
2.2.1 Remote Control via USB .......................................................................................................6
2.2.2 Remote Control via LAN ...................................................................................................... 6
2.3 Sequential Commands and Overlapped Commands ..............................................................7
3 Command System ......................................................................................................... 11
3.1 Root Commands ................................................................................................................................11
3.1.1 :CLEar ........................................................................................................................................11
3.1.2 :RUN ..........................................................................................................................................11
3.1.3 :STOP ........................................................................................................................................ 12
3.1.4 :SINGle ..................................................................................................................................... 13
3.1.5 :TFORce ....................................................................................................................................13
3.2 :AUToset Commands ........................................................................................................................14
3.2.1 :AUToset ...................................................................................................................................14
3.2.2 :AUToset:PEAK ....................................................................................................................... 15
3.2.3 :AUToset:OPENch ................................................................................................................. 15
3.2.4 :AUToset:OVERlap ................................................................................................................ 16
3.2.5 :AUToset:KEEPcoup ..............................................................................................................17
3.2.6 :AUToset:LOCK .......................................................................................................................17
3.2.7 :AUToset:ENAble ...................................................................................................................18
3.3 :ACQuire Commands ........................................................................................................................19
3.3.1 :ACQuire:AVERages ..............................................................................................................19
3.3.2 :ACQuire:MDEPth ................................................................................................................. 20
3.3.3 :ACQuire:TYPE ........................................................................................................................21
3.3.4 :ACQuire:SRATe? ....................................................................................................................22
3.3.5 :ACQuire:ULTRa:MODE ....................................................................................................... 23
3.3.6 :ACQuire:ULTRa:TIMeout ................................................................................................... 24
3.3.7 :ACQuire:ULTRa:MAXFrame .............................................................................................. 24
3.4 :BUS<n> Commands ....................................................................................................................... 25
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
I
Page 4
3.4.1 :BUS<n>:MODE .................................................................................................................... 25
3.4.2 :BUS<n>:DISPlay .................................................................................................................. 26
3.4.3 :BUS<n>:FORMat .................................................................................................................26
3.4.4 :BUS<n>:EVENt .....................................................................................................................27
3.4.5 :BUS<n>:LABel ......................................................................................................................28
3.4.6 :BUS<n>:DATA? .....................................................................................................................28
3.4.7 :BUS<n>:EEXPort ..................................................................................................................29
3.4.8 :BUS<n>:POSition ................................................................................................................30
3.4.9 :BUS<n>:THReshold ............................................................................................................31
3.4.10 :BUS<n>:PARallel ................................................................................................................. 32
3.4.10.1 :BUS<n>:PARallel:BUS ........................................................................................33
3.4.10.2 :BUS<n>:PARallel:CLK .........................................................................................34
3.4.10.3 :BUS<n>:PARallel:SLOPe ....................................................................................34
3.4.10.4 :BUS<n>:PARallel:WIDTh ...................................................................................35
3.4.10.5 :BUS<n>:PARallel:BITX .......................................................................................36
3.4.10.6 :BUS<n>:PARallel:SOURce ................................................................................ 37
3.4.10.7 :BUS<n>:PARallel:ENDian ................................................................................. 37
3.4.10.8 :BUS<n>:PARallel:POLarity ............................................................................... 38
3.4.11 :BUS<n>:RS232 .....................................................................................................................39
3.4.11.1 :BUS<n>:RS232:TX ...............................................................................................40
3.4.11.2 :BUS<n>:RS232:RX .............................................................................................. 40
3.4.11.3 :BUS<n>:RS232:POLarity ...................................................................................41
3.4.11.4 :BUS<n>:RS232:PARity .......................................................................................42
3.4.11.5 :BUS<n>:RS232:ENDian .....................................................................................43
3.4.11.6 :BUS<n>:RS232:BAUD ........................................................................................43
3.4.11.7 :BUS<n>:RS232:DBITs .........................................................................................44
3.4.11.8 :BUS<n>:RS232:SBITs ......................................................................................... 45
3.4.12 :BUS<n>:IIC ............................................................................................................................45
3.4.12.1 :BUS<n>:IIC:SCLK:SOURce ................................................................................46
3.4.12.2 :BUS<n>:IIC:SDA:SOURce ................................................................................. 46
3.4.12.3 :BUS<n>:IIC:EXCHange ...................................................................................... 47
3.4.12.4 :BUS<n>:IIC:ADDRess .........................................................................................48
3.4.13 :BUS<n>:SPI ...........................................................................................................................48
3.4.13.1 :BUS<n>:SPI:SCLK:SOURce ...............................................................................49
3.4.13.2 :BUS<n>:SPI:SCLK:SLOPe .................................................................................. 50
3.4.13.3 :BUS<n>:SPI:MISO:SOURce ..............................................................................50
3.4.13.4 :BUS<n>:SPI:MOSI:SOURce ..............................................................................51
DHO800/DHO900 Programming
Guide
II
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 5
3.4.13.5 :BUS<n>:SPI:POLarity ......................................................................................... 52
3.4.13.6 :BUS<n>:SPI:MISO:POLarity ............................................................................. 52
3.4.13.7 :BUS<n>:SPI:MOSI:POLarity ............................................................................. 53
3.4.13.8 :BUS<n>:SPI:DBITs ...............................................................................................54
3.4.13.9 :BUS<n>:SPI:ENDian ........................................................................................... 54
3.4.13.10 :BUS<n>:SPI:MODE ............................................................................................. 55
3.4.13.11 :BUS<n>:SPI:TIMeout:TIME .............................................................................. 56
3.4.13.12 :BUS<n>:SPI:SS:SOURce .................................................................................... 57
3.4.13.13 :BUS<n>:SPI:SS:POLarity ................................................................................... 57
3.4.14 :BUS<n>:CAN ........................................................................................................................ 58
3.4.14.1 :BUS<n>:CAN:SOURce .......................................................................................59
3.4.14.2 :BUS<n>:CAN:STYPe ...........................................................................................60
3.4.14.3 :BUS<n>:CAN:BAUD ........................................................................................... 60
3.4.14.4 :BUS<n>:CAN:SPOint ......................................................................................... 61
3.4.15 :BUS<n>:LIN .......................................................................................................................... 62
3.4.15.1 :BUS<n>:LIN:PARity .............................................................................................62
3.4.15.2 :BUS<n>:LIN:SOURce ......................................................................................... 63
3.4.15.3 :BUS<n>:LIN:STANdard ..................................................................................... 63
3.5 :BODeplot Commands .....................................................................................................................64
3.5.1 :BODeplot:ENABle ................................................................................................................64
3.5.2 :BODeplot:RUNStop ............................................................................................................ 65
3.5.3 :BODeplot:SWEeptype ........................................................................................................65
3.5.4 :BODeplot:REF:IN ..................................................................................................................66
3.5.5 :BODeplot:REF:OUT ............................................................................................................. 67
3.5.6 :BODeplot:STARt ...................................................................................................................67
3.5.7 :BODeplot:STOP ....................................................................................................................68
3.5.8 :BODeplot:POINts .................................................................................................................69
3.5.9 :BODeplot:VOLTage ............................................................................................................. 69
3.6 :CHANnel<n> Commands ............................................................................................................. 70
3.6.1 :CHANnel<n>:BWLimit ...................................................................................................... 71
3.6.2 :CHANnel<n>:COUPling ....................................................................................................72
3.6.3 :CHANnel<n>:DISPlay ........................................................................................................ 72
3.6.4 :CHANnel<n>:INVert .......................................................................................................... 73
3.6.5 :CHANnel<n>:OFFSet .........................................................................................................74
3.6.6 :CHANnel<n>:TCALibrate ................................................................................................. 74
3.6.7 :CHANnel<n>:SCALe .......................................................................................................... 75
3.6.8 :CHANnel<n>:PROBe ......................................................................................................... 76
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
III
Page 6
3.6.9 :CHANnel<n>:LABel:SHOW ............................................................................................. 77
3.6.10 :CHANnel<n>:LABel:CONTent .........................................................................................77
3.6.11 :CHANnel<n>:UNITs ........................................................................................................... 78
3.6.12 :CHANnel<n>:VERNier .......................................................................................................79
3.6.13 :CHANnel<n>:POSition ......................................................................................................79
3.7 :COUNter Commands ......................................................................................................................80
3.7.1 :COUNter:CURRent? ............................................................................................................ 80
3.7.2 :COUNter:ENABle ................................................................................................................. 81
3.7.3 :COUNter:SOURce ................................................................................................................81
3.7.4 :COUNter:MODE ...................................................................................................................82
3.7.5 :COUNter:NDIGits ................................................................................................................ 83
3.7.6 :COUNter:TOTalize:ENABle ................................................................................................83
3.7.7 :COUNter:TOTalize:CLEar ....................................................................................................84
3.8 :CURSor Commands .........................................................................................................................84
3.8.1 :CURSor:MODE ......................................................................................................................86
3.8.2 :CURSor:MEASure:INDicator ............................................................................................ 87
3.8.3 :CURSor:MANual .................................................................................................................. 88
3.8.3.1 :CURSor:MANual:TYPE ....................................................................................... 88
3.8.3.2 :CURSor:MANual:SOURce .................................................................................88
3.8.3.3 :CURSor:MANual:CAX .........................................................................................89
3.8.3.4 :CURSor:MANual:CAY ......................................................................................... 90
3.8.3.5 :CURSor:MANual:CBX .........................................................................................90
3.8.3.6 :CURSor:MANual:CBY .........................................................................................91
3.8.3.7 :CURSor:MANual:AXValue? ...............................................................................92
3.8.3.8 :CURSor:MANual:AYValue? ............................................................................... 92
3.8.3.9 :CURSor:MANual:BXValue? ...............................................................................93
3.8.3.10 :CURSor:MANual:BYValue? ............................................................................... 93
3.8.3.11 :CURSor:MANual:XDELta? .................................................................................94
3.8.3.12 :CURSor:MANual:IXDelta? .................................................................................94
3.8.3.13 :CURSor:MANual:YDELta? .................................................................................95
3.8.4 :CURSor:TRACk ......................................................................................................................95
3.8.4.1 :CURSor:TRACk:SOURce1 ..................................................................................95
3.8.4.2 :CURSor:TRACk:SOURce2 ..................................................................................96
3.8.4.3 :CURSor:TRACk:CAX ............................................................................................97
3.8.4.4 :CURSor:TRACk:CBX ............................................................................................ 97
3.8.4.5 :CURSor:TRACk:CAY ............................................................................................ 98
3.8.4.6 :CURSor:TRACk:CBY .............................................................................................99
DHO800/DHO900 Programming
Guide
IV
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 7
3.8.4.7 :CURSor:TRACk:AXValue? ..................................................................................99
3.8.4.8 :CURSor:TRACk:AYValue? ................................................................................ 100
3.8.4.9 :CURSor:TRACk:BXValue? ................................................................................100
3.8.4.10 :CURSor:TRACk:BYValue? ................................................................................101
3.8.4.11 :CURSor:TRACk:XDELta? ..................................................................................101
3.8.4.12 :CURSor:TRACk:YDELta? ..................................................................................102
3.8.4.13 :CURSor:TRACk:IXDelta? ................................................................................. 102
3.8.4.14 :CURSor:TRACk:MODE .....................................................................................103
3.8.5 :CURSor:XY ...........................................................................................................................103
3.8.5.1 :CURSor:XY:AX ....................................................................................................103
3.8.5.2 :CURSor:XY:BX .....................................................................................................104
3.8.5.3 :CURSor:XY:AY .....................................................................................................105
3.8.5.4 :CURSor:XY:BY .....................................................................................................105
3.8.5.5 :CURSor:XY:AXValue? ....................................................................................... 106
3.8.5.6 :CURSor:XY:AYValue? ........................................................................................106
3.8.5.7 :CURSor:XY:BXValue? ........................................................................................107
3.8.5.8 :CURSor:XY:BYValue? ........................................................................................107
3.8.5.9 :CURSor:XY:XDELta? ..........................................................................................107
3.8.5.10 :CURSor:XY:YDELta? ..........................................................................................108
3.9 :DISPlay Commands .......................................................................................................................108
3.9.1 :DISPlay:CLEar ......................................................................................................................109
3.9.2 :DISPlay:TYPE .......................................................................................................................109
3.9.3 :DISPlay:GRADing:TIME ................................................................................................... 110
3.9.4 :DISPlay:WBRightness ...................................................................................................... 111
3.9.5 :DISPlay:GRID ...................................................................................................................... 111
3.9.6 :DISPlay:GBRightness ........................................................................................................112
3.9.7 :DISPlay:DATA? .................................................................................................................... 112
3.9.8 :DISPlay:RULers ...................................................................................................................113
3.9.9 :DISPlay:COLor .................................................................................................................... 114
3.9.10 :DISPlay:WHOLd .................................................................................................................114
3.10 :DVM Commands ............................................................................................................................115
3.10.1 :DVM:CURRent? ..................................................................................................................115
3.10.2 :DVM:ENABle .......................................................................................................................115
3.10.3 :DVM:SOURce ......................................................................................................................116
3.10.4 :DVM:MODE .........................................................................................................................117
3.11 :HISTogram Commands ................................................................................................................117
3.11.1 :HISTogram:ENABle ........................................................................................................... 118
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
V
Page 8
3.11.2 :HISTogram:TYPE ................................................................................................................119
3.11.3 :HISTogram:SOURce ..........................................................................................................119
3.11.4 :HISTogram:HEIGht ............................................................................................................120
3.11.5 :HISTogram:RANGe:LEFT ................................................................................................. 120
3.11.6 :HISTogram:RANGe:RIGHt .............................................................................................. 121
3.11.7 :HISTogram:RANGe:TOP ..................................................................................................122
3.11.8 :HISTogram:RANGe:BOTTom ..........................................................................................123
3.11.9 :HISTogram:STATistics:RESult? ....................................................................................... 124
3.12 IEEE488.2 Common Commands ................................................................................................ 124
3.12.1 *IDN? ......................................................................................................................................126
3.12.2 *RST ........................................................................................................................................ 127
3.12.3 *CLS ........................................................................................................................................ 127
3.12.4 *ESE .........................................................................................................................................127
3.12.5 *ESR? ...................................................................................................................................... 128
3.12.6 *OPC .......................................................................................................................................129
3.12.7 *RCL ........................................................................................................................................129
3.12.8 *SAV ........................................................................................................................................130
3.12.9 *SRE ........................................................................................................................................ 130
3.12.10 *STB? ...................................................................................................................................... 131
3.12.11 *WAI ....................................................................................................................................... 131
3.12.12 *TST? .......................................................................................................................................132
3.13 Digital Channel Commands ........................................................................................................ 133
3.13.1 :LA:ENABle ............................................................................................................................133
3.13.2 :LA:ACTive .............................................................................................................................133
3.13.3 :LA:AUTosort ........................................................................................................................134
3.13.4 :LA:DELete .............................................................................................................................135
3.13.5 :LA:DIGital:ENABle .............................................................................................................135
3.13.6 :LA:DIGital:LABel .................................................................................................................136
3.13.7 :LA:POD<n>:DISPlay .........................................................................................................137
3.13.8 :LA:POD<n>:THReshold .................................................................................................. 137
3.13.9 :LA:SIZE ..................................................................................................................................138
3.14 :LAN Commands .............................................................................................................................139
3.14.1 :LAN:DHCP ........................................................................................................................... 139
3.14.2 :LAN:AUToip .........................................................................................................................140
3.14.3 :LAN:GATeway ..................................................................................................................... 140
3.14.4 :LAN:DNS ..............................................................................................................................141
3.14.5 :LAN:MAC? ........................................................................................................................... 142
DHO800/DHO900 Programming
Guide
VI
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 9
3.14.6 :LAN:DSERver? .................................................................................................................... 142
3.14.7 :LAN:MANual .......................................................................................................................143
3.14.8 :LAN:IPADdress ...................................................................................................................143
3.14.9 :LAN:SMASk .........................................................................................................................144
3.14.10 :LAN:STATus? ....................................................................................................................... 145
3.14.11 :LAN:VISA? ............................................................................................................................145
3.14.12 :LAN:MDNS ..........................................................................................................................146
3.14.13 :LAN:HOST:NAME .............................................................................................................. 147
3.14.14 :LAN:DESCription ...............................................................................................................147
3.14.15 :LAN:APPLy ...........................................................................................................................148
3.15 :MASK Commands ..........................................................................................................................148
3.15.1 :MASK:ENABle .....................................................................................................................148
3.15.2 :MASK:SOURce ....................................................................................................................149
3.15.3 :MASK:OPERate .................................................................................................................. 150
3.15.4 :MASK:X .................................................................................................................................150
3.15.5 :MASK:Y .................................................................................................................................151
3.15.6 :MASK:CREate ......................................................................................................................152
3.15.7 :MASK:RESet ........................................................................................................................ 152
3.15.8 :MASK:FAILed? .................................................................................................................... 153
3.15.9 :MASK:PASSed? ...................................................................................................................153
3.15.10 :MASK:TOTal? .......................................................................................................................154
3.15.11 :MASK:OUTPut:ENABle .................................................................................................... 154
3.15.12 :MASK:OUTPut:EVENt .......................................................................................................155
3.15.13 :MASK:OUTPut:TIME ......................................................................................................... 155
3.16 :MATH<n> Commands .................................................................................................................156
3.16.1 :MATH<n>:DISPlay ............................................................................................................159
3.16.2 :MATH<n>:OPERator ........................................................................................................160
3.16.3 :MATH<n>:SOURce1 ........................................................................................................ 160
3.16.4 :MATH<n>:SOURce2 ........................................................................................................ 162
3.16.5 :MATH<n>:LSOurce1 ........................................................................................................163
3.16.6 :MATH<n>:LSOurce2 ........................................................................................................163
3.16.7 :MATH<n>:SCALe .............................................................................................................. 164
3.16.8 :MATH<n>:OFFSet .............................................................................................................165
3.16.9 :MATH<n>:INVert ..............................................................................................................166
3.16.10 :MATH<n>:RESet ............................................................................................................... 166
3.16.11 :MATH<n>:GRID ................................................................................................................ 167
3.16.12 :MATH<n>:EXPand ............................................................................................................167
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
VII
Page 10
3.16.13 :MATH<n>:WAVetype ......................................................................................................168
3.16.14 :MATH<n>:FFT:SOURce ...................................................................................................169
3.16.15 :MATH<n>:FFT:WINDow .................................................................................................169
3.16.16 :MATH<n>:FFT:UNIT .........................................................................................................170
3.16.17 :MATH<n>:FFT:SCALe ...................................................................................................... 171
3.16.18 :MATH<n>:FFT:OFFSet .....................................................................................................172
3.16.19 :MATH<n>:FFT:HSCale .....................................................................................................173
3.16.20 :MATH<n>:FFT:HCENter ..................................................................................................173
3.16.21 :MATH<n>:FFT:FREQuency:STARt ................................................................................174
3.16.22 :MATH<n>:FFT:FREQuency:END ...................................................................................175
3.16.23 :MATH<n>:FFT:SEARch:ENABle .................................................................................... 175
3.16.24 :MATH<n>:FFT:SEARch:NUM ........................................................................................ 176
3.16.25 :MATH<n>:FFT:SEARch:THReshold ..............................................................................177
3.16.26 :MATH<n>:FFT:SEARch:EXCursion ...............................................................................177
3.16.27 :MATH<n>:FFT:SEARch:ORDer ......................................................................................178
3.16.28 :MATH<n>:FFT:SEARch:RES? ..........................................................................................178
3.16.29 :MATH<n>:FILTer:TYPE .................................................................................................... 179
3.16.30 :MATH<n>:FILTer:W1 ........................................................................................................180
3.16.31 :MATH<n>:FILTer:W2 ........................................................................................................181
3.16.32 :MATH<n>:SENSitivity ..................................................................................................... 182
3.16.33 :MATH<n>:DISTance .........................................................................................................183
3.16.34 :MATH<n>:THReshold1 ...................................................................................................183
3.16.35 :MATH<n>:THReshold2 ...................................................................................................184
3.16.36 :MATH<n>:THReshold3 ...................................................................................................185
3.16.37 :MATH<n>:THReshold4 ...................................................................................................186
3.16.38 :MATH<n>:WINDow:TITLe? ........................................................................................... 187
3.16.39 :MATH<n>:LABel:SHOW .................................................................................................187
3.17 :MEASure Commands ....................................................................................................................188
3.17.1 :MEASure:SOURce ..............................................................................................................194
3.17.2 :MEASure:ITEM ................................................................................................................... 195
3.17.3 :MEASure:CLEar .................................................................................................................. 196
3.17.4 :MEASure:AMSource .........................................................................................................197
3.17.5 :MEASure:STATistic:COUNt ............................................................................................. 197
3.17.6 :MEASure:STATistic:DISPlay ............................................................................................ 198
3.17.7 :MEASure:STATistic:RESet ................................................................................................199
3.17.8 :MEASure:STATistic:ITEM ................................................................................................. 199
3.17.9 :MEASure:SETup:MAX .......................................................................................................201
DHO800/DHO900 Programming
Guide
VIII
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 11
3.17.10 :MEASure:SETup:MID ........................................................................................................ 202
3.17.11 :MEASure:SETup:MIN ........................................................................................................203
3.17.12 :MEASure:SETup:PSA .........................................................................................................203
3.17.13 :MEASure:SETup:PSB .........................................................................................................204
3.17.14 :MEASure:SETup:DSA ........................................................................................................ 205
3.17.15 :MEASure:SETup:DSB ........................................................................................................ 206
3.17.16 :MEASure:THReshold:SOURce .......................................................................................206
3.17.17 :MEASure:THReshold:TYPE ............................................................................................. 207
3.17.18 :MEASure:THReshold:DEFault ........................................................................................ 208
3.17.19 :MEASure:AREA ...................................................................................................................208
3.17.20 :MEASure:INDicator .......................................................................................................... 209
3.17.21 :MEASure:COUNter:ENABle ............................................................................................209
3.17.22 :MEASure:COUNter:SOURce .......................................................................................... 210
3.17.23 :MEASure:COUNter:VALue? ............................................................................................211
3.17.24 :MEASure:AMP:TYPE ......................................................................................................... 211
3.17.25 :MEASure:AMP:MANual:TOP ......................................................................................... 212
3.17.26 :MEASure:AMP:MANual:BASE ....................................................................................... 212
3.17.27 :MEASure:CATegory ...........................................................................................................213
3.18 :QUICK Command ...........................................................................................................................214
3.18.1 :QUICk:OPERation ..............................................................................................................214
3.19 :RECord Commands .......................................................................................................................215
3.19.1 :RECord:WRECord:ENABle .............................................................................................. 215
3.19.2 :RECord:ENABle .................................................................................................................. 215
3.19.3 :RECord:WRECord:OPERate ............................................................................................216
3.19.4 :RECord:STARt ..................................................................................................................... 217
3.19.5 :RECord:WRECord:FRAMes .............................................................................................217
3.19.6 :RECord:FRAMes .................................................................................................................218
3.19.7 :RECord:WRECord:FRAMes:MAX .................................................................................. 218
3.19.8 :RECord:WRECord: FMAX? ..............................................................................................219
3.19.9 :RECord:WRECord:FINTerval ...........................................................................................219
3.19.10 :RECord:WRECord:PROMpt ............................................................................................ 220
3.19.11 :RECord:WREPlay:FCURrent ............................................................................................220
3.19.12 :RECord:CURRent ............................................................................................................... 221
3.19.13 :RECord:WREPlay:FCURrent:TIME? ...............................................................................222
3.19.14 :RECord:WREPlay:FSTart ...................................................................................................222
3.19.15 :RECord:WREPlay:FEND ....................................................................................................223
3.19.16 :RECord:WREPlay:FMAX? .................................................................................................223
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
IX
Page 12
3.19.17 :RECord:WREPlay:FINTerval ............................................................................................ 224
3.19.18 :RECord:WREPlay:MODE ..................................................................................................224
3.19.19 :RECord:WREPlay:DIRection ........................................................................................... 225
3.19.20 :RECord:WREPlay:OPERate ..............................................................................................226
3.19.21 :RECord:PLAY .......................................................................................................................226
3.19.22 :RECord:WREPlay:BACK ....................................................................................................227
3.19.23 :RECord:WREPlay:NEXT ....................................................................................................227
3.19.24 :RECord:WREPlay:PLAY .....................................................................................................228
3.20 :REFerence Commands ................................................................................................................. 228
3.20.1 :REFerence:SOURce ...........................................................................................................228
3.20.2 :REFerence:VSCale ............................................................................................................. 229
3.20.3 :REFerence:VOFFset ...........................................................................................................230
3.20.4 :REFerence:RESet ................................................................................................................230
3.20.5 :REFerence:CURRent ......................................................................................................... 231
3.20.6 :REFerence:SAVE ................................................................................................................. 231
3.20.7 :REFerence:COLor ...............................................................................................................232
3.20.8 :REFerence:LABel:ENABle ................................................................................................ 233
3.20.9 :REFerence:LABel:CONTent .............................................................................................233
3.21 :SAVE Commands ............................................................................................................................234
3.21.1 :SAVE:IMAGe:INVert ..........................................................................................................234
3.21.2 :SAVE:IMAGe:COLor .......................................................................................................... 235
3.21.3 :SAVE:IMAGe:FORMat .......................................................................................................235
3.21.4 :SAVE:IMAGe:HEADer ....................................................................................................... 236
3.21.5 :SAVE:IMAGe:DATA? ..........................................................................................................236
3.21.6 :SAVE:IMAGe ........................................................................................................................237
3.21.7 :SAVE:SETup ..........................................................................................................................238
3.21.8 :SAVE:WAVeform ................................................................................................................ 239
3.21.9 :SAVE:MEMory:WAVeform .............................................................................................. 240
3.21.10 :SAVE:STATus? ......................................................................................................................240
3.21.11 :SAVE:OVERlap ....................................................................................................................241
3.21.12 :SAVE:PREFix ........................................................................................................................ 241
3.21.13 :SAVe:SMB:SERVerpath .....................................................................................................242
3.21.14 :SAVe:SMB:USERname ......................................................................................................243
3.21.15 :SAVe:SMB:PASSword ........................................................................................................243
3.21.16 :SAVe:SMB:AUToconnect ................................................................................................. 244
3.21.17 :SAVe:SMB:CONNect .........................................................................................................245
3.21.18 :SAVe:SMB:DISConnect .................................................................................................... 245
DHO800/DHO900 Programming
Guide
X
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 13
3.21.19 :SAVe:SMB:CONState? ...................................................................................................... 245
3.21.20 :LOAD:SETup ........................................................................................................................ 246
3.22 :SEARch Commands .......................................................................................................................247
3.22.1 :SEARch:COUNt? .................................................................................................................247
3.22.2 :SEARch:STATe ..................................................................................................................... 247
3.22.3 :SEARch:MODE ....................................................................................................................248
3.22.4 :SEARch:EVENt .................................................................................................................... 248
3.22.5 :SEARch:VALue? .................................................................................................................. 249
3.22.6 :SEARch:EDGE:SLOPe ........................................................................................................ 249
3.22.7 :SEARch:EDGE:SOURce .....................................................................................................250
3.22.8 :SEARch:EDGE:THReshold ............................................................................................... 251
3.22.9 :SEARch:PULSe:POLarity .................................................................................................. 251
3.22.10 :SEARch:PULSe:QUALifier ................................................................................................252
3.22.11 :SEARch:PULSe:SOURce ................................................................................................... 253
3.22.12 :SEARch:PULSe:UWIDth ................................................................................................... 253
3.22.13 :SEARch:PULSe:LWIDth .................................................................................................... 254
3.22.14 :SEARch:PULSe:THReshold ..............................................................................................254
3.23 :NAVigate Commands ...................................................................................................................255
3.23.1 :NAVigate:ENABle ..............................................................................................................255
3.23.2 :NAVigate:MODE ................................................................................................................256
3.23.3 :NAVigate:TIME:SPEed ......................................................................................................256
3.23.4 :NAVigate:TIME:PLAY ........................................................................................................257
3.23.5 :NAVigate:TIME:END .........................................................................................................258
3.23.6 :NAVigate:TIME:STARt ......................................................................................................258
3.23.7 :NAVigate:TIME:NEXT .......................................................................................................259
3.23.8 :NAVigate:TIME:BACK .......................................................................................................259
3.23.9 :NAVigate:SEARch:END .................................................................................................... 260
3.23.10 :NAVigate:SEARch:STARt ................................................................................................. 260
3.23.11 :NAVigate:SEARch:NEXT ..................................................................................................260
3.23.12 :NAVigate:SEARch:BACK ..................................................................................................261
3.23.13 :NAVigate:FRAMe:DISPlay:MODE .................................................................................261
3.23.14 :NAVigate:FRAMe:END:FRAMe ..................................................................................... 263
3.23.15 :NAVigate:FRAMe:STARt:FRAMe ...................................................................................263
3.23.16 :NAVigate:FRAMe:END .....................................................................................................264
3.23.17 :NAVigate:FRAMe:STARt ..................................................................................................264
3.23.18 :NAVigate:FRAMe:NEXT ...................................................................................................265
3.23.19 :NAVigate:FRAMe:BACK ...................................................................................................265
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
XI
Page 14
3.23.20 :NAVigate:FRAMe:PLAY ....................................................................................................266
3.24 :SYSTem Commands ...................................................................................................................... 266
3.24.1 :SYSTem:AOUTput ..............................................................................................................267
3.24.2 :SYSTem:BEEPer ...................................................................................................................267
3.24.3 :SYSTem:ERRor[:NEXT]? ....................................................................................................268
3.24.4 :SYSTem:PON .......................................................................................................................268
3.24.5 :SYSTem:PSTatus .................................................................................................................269
3.24.6 :SYSTem:RAMount? ........................................................................................................... 270
3.24.7 :SYSTem:RESet .....................................................................................................................270
3.24.8 :SYSTem:SETup .................................................................................................................... 270
3.24.9 :SYSTem:LOCKed ................................................................................................................ 271
3.24.10 :SYSTem:MODules? ............................................................................................................272
3.24.11 :SYSTem:AUToscale ............................................................................................................272
3.24.12 :SYSTem:GAMount? ...........................................................................................................273
3.24.13 :SYSTem:VERSion? ..............................................................................................................274
3.24.14 :SYSTem:DGSTatus? ........................................................................................................... 274
3.24.15 :SYSTem:KEYBOARDCheck? ............................................................................................275
3.25 :SOURce Commands ......................................................................................................................275
3.25.1 :SOURce:OUTPut:STATe ....................................................................................................275
3.25.2 :SOURce:FUNCtion ............................................................................................................ 276
3.25.3 :SOURce:FREQuency ......................................................................................................... 276
3.25.4 :SOURce:PHASe .................................................................................................................. 277
3.25.5 :SOURce:FUNCtion:RAMP:SYMMetry ......................................................................... 278
3.25.6 :SOURce:FUNCtion:SQUare:DUTY ................................................................................279
3.25.7 :SOURce:VOLTage:AMPLitude ....................................................................................... 279
3.25.8 :SOURce:VOLTage:OFFSet ............................................................................................... 280
3.25.9 :SOURce:MOD:STATe .........................................................................................................281
3.25.10 :SOURce:MOD:TYPe .......................................................................................................... 281
3.25.11 :SOURce:MOD:AM:DEPTh ...............................................................................................282
3.25.12 :SOURce:MOD:AM:INTernal:FREQuency .................................................................... 283
3.25.13 :SOURce:MOD:AM:INTernal:FUNCtion ....................................................................... 283
3.25.14 :SOURce:MOD:FM:DEViation ......................................................................................... 284
3.25.15 :SOURce:MOD:FM:INTernal:FREQuency .....................................................................285
3.25.16 :SOURce:MOD:FM:INTernal:FUNCtion ........................................................................286
3.25.17 :SOURce:MOD:PM:DEViation .........................................................................................286
3.25.18 :SOURce:MOD:PM:INTernal:FREQuency .....................................................................287
3.25.19 :SOURce:MOD:PM:INTernal:FUNCtion ........................................................................288
DHO800/DHO900 Programming
Guide
XII
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 15
3.26 :TIMebase Commands ...................................................................................................................288
3.26.1 :TIMebase:DELay:ENABle .................................................................................................289
3.26.2 :TIMebase:DELay:OFFSet ................................................................................................. 290
3.26.3 :TIMebase:DELay:SCALe ...................................................................................................291
3.26.4 :TIMebase[:MAIN][:OFFSet] ............................................................................................ 291
3.26.5 :TIMebase[:MAIN]:SCALe ................................................................................................ 292
3.26.6 :TIMebase:MODE ............................................................................................................... 293
3.26.7 :TIMebase:HREFerence:MODE .......................................................................................294
3.26.8 :TIMebase:HREFerence:POSition .................................................................................. 295
3.26.9 :TIMebase:VERNier ............................................................................................................ 295
3.26.10 :TIMebase:HOTKeys ...........................................................................................................296
3.26.11 :TIMebase:ROLL ..................................................................................................................296
3.26.12 :TIMebase:XY:ENABle ........................................................................................................297
3.26.13 :TIMebase:XY:X ....................................................................................................................298
3.26.14 :TIMebase:XY:Y ....................................................................................................................298
3.26.15 :TIMebase:XY:Z ....................................................................................................................299
3.26.16 :TIMebase:XY:GRID ............................................................................................................299
3.27 :TRIGger Commands ......................................................................................................................300
3.27.1 :TRIGger:MODE .................................................................................................................. 300
3.27.2 :TRIGger:COUPling ............................................................................................................301
3.27.3 :TRIGger:STATus? ................................................................................................................302
3.27.4 :TRIGger:SWEep ................................................................................................................. 302
3.27.5 :TRIGger:HOLDoff .............................................................................................................. 303
3.27.6 :TRIGger:NREJect ............................................................................................................... 304
3.27.7 :TRIGger:POSition? ............................................................................................................304
3.27.8 :TRIGger:EDGE .....................................................................................................................305
3.27.8.1 :TRIGger:EDGE:SOURce ................................................................................... 305
3.27.8.2 :TRIGger:EDGE:SLOPe .......................................................................................306
3.27.8.3 :TRIGger:EDGE:LEVel .........................................................................................306
3.27.9 :TRIGger:PULSe ...................................................................................................................307
3.27.9.1 :TRIGger:PULSe:SOURce ..................................................................................307
3.27.9.2 :TRIGger:PULSe:POLarity .................................................................................308
3.27.9.3 :TRIGger:PULSe:WHEN .....................................................................................309
3.27.9.4 :TRIGger:PULSe:UWIDth ..................................................................................309
3.27.9.5 :TRIGger:PULSe:LWIDth ...................................................................................310
3.27.9.6 :TRIGger:PULSe:LEVel ....................................................................................... 311
3.27.10 :TRIGger:SLOPe ...................................................................................................................311
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
XIII
Page 16
3.27.10.1 :TRIGger:SLOPe:SOURce ..................................................................................312
3.27.10.2 :TRIGger:SLOPe:POLarity .................................................................................312
3.27.10.3 :TRIGger:SLOPe:WHEN .....................................................................................313
3.27.10.4 :TRIGger:SLOPe:TUPPer ................................................................................... 314
3.27.10.5 :TRIGger:SLOPe:TLOWer .................................................................................. 314
3.27.10.6 :TRIGger:SLOPe:WINDow ................................................................................315
3.27.10.7 :TRIGger:SLOPe:ALEVel .................................................................................... 316
3.27.10.8 :TRIGger:SLOPe:BLEVel .....................................................................................316
3.27.11 :TRIGger:VIDeo ...................................................................................................................317
3.27.11.1 :TRIGger:VIDeo:SOURce ..................................................................................317
3.27.11.2 :TRIGger:VIDeo:POLarity ................................................................................. 318
3.27.11.3 :TRIGger:VIDeo:MODE .....................................................................................318
3.27.11.4 :TRIGger:VIDeo:LINE .........................................................................................319
3.27.11.5 :TRIGger:VIDeo:STANdard .............................................................................. 320
3.27.11.6 :TRIGger:VIDeo:LEVel ........................................................................................321
3.27.12 :TRIGger:PATTern ................................................................................................................322
3.27.12.1 :TRIGger:PATTern:PATTern ...............................................................................322
3.27.12.2 :TRIGger:PATTern:SOURce ...............................................................................323
3.27.12.3 :TRIGger:PATTern:LEVel ....................................................................................324
3.27.13 :TRIGger:DURation ............................................................................................................ 325
3.27.13.1 :TRIGger:DURation:SOURce ...........................................................................326
3.27.13.2 :TRIGger:DURation:TYPE ................................................................................. 326
3.27.13.3 :TRIGger:DURation:WHEN ..............................................................................327
3.27.13.4 :TRIGger:DURation:TUPPer .............................................................................328
3.27.13.5 :TRIGger:DURation:TLOWer ........................................................................... 329
3.27.13.6 :TRIGger:DURation:LEVel .................................................................................330
3.27.14 :TRIGger:TIMeout ...............................................................................................................330
3.27.14.1 :TRIGger:TIMeout:SOURce ..............................................................................331
3.27.14.2 :TRIGger:TIMeout:SLOPe .................................................................................331
3.27.14.3 :TRIGger:TIMeout:TIME ....................................................................................332
3.27.14.4 :TRIGger:TIMeout:LEVel ................................................................................... 333
3.27.15 :TRIGger:RUNT ....................................................................................................................333
3.27.15.1 :TRIGger:RUNT:SOURce ...................................................................................334
3.27.15.2 :TRIGger:RUNT:POLarity ..................................................................................334
3.27.15.3 :TRIGger:RUNT:WHEN ......................................................................................335
3.27.15.4 :TRIGger:RUNT:WUPPer ...................................................................................336
3.27.15.5 :TRIGger:RUNT:WLOWer ................................................................................. 337
DHO800/DHO900 Programming
Guide
XIV
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 17
3.27.15.6 :TRIGger:RUNT:ALEVel ..................................................................................... 337
3.27.15.7 :TRIGger:RUNT:BLEVel ......................................................................................338
3.27.16 :TRIGger:WINDows ............................................................................................................339
3.27.16.1 :TRIGger:WINDows:SOURce .......................................................................... 339
3.27.16.2 :TRIGger:WINDows:SLOPe ..............................................................................339
3.27.16.3 :TRIGger:WINDows:POSition .........................................................................340
3.27.16.4 :TRIGger:WINDows:TIME ................................................................................ 341
3.27.16.5 :TRIGger:WINDows:ALEVel ............................................................................. 341
3.27.16.6 :TRIGger:WINDows:BLEVel ............................................................................. 342
3.27.17 :TRIGger:DELay ................................................................................................................... 342
3.27.17.1 :TRIGger:DELay:SA .............................................................................................343
3.27.17.2 :TRIGger:DELay:ASLop ..................................................................................... 343
3.27.17.3 :TRIGger:DELay:SB .............................................................................................344
3.27.17.4 :TRIGger:DELay:BSLop ......................................................................................345
3.27.17.5 :TRIGger:DELay:TYPE ........................................................................................ 345
3.27.17.6 :TRIGger:DELay:TUPPer ....................................................................................346
3.27.17.7 :TRIGger:DELay:TLOWer .................................................................................. 347
3.27.17.8 :TRIGger:DELay:ALEVel .....................................................................................348
3.27.17.9 :TRIGger:DELay:BLEVel ..................................................................................... 348
3.27.18 :TRIGger:SHOLd ..................................................................................................................349
3.27.18.1 :TRIGger:SHOLd:DSRC ..................................................................................... 349
3.27.18.2 :TRIGger:SHOLd:CSRC ......................................................................................350
3.27.18.3 :TRIGger:SHOLd:SLOPe ....................................................................................351
3.27.18.4 :TRIGger:SHOLd:PATTern .................................................................................351
3.27.18.5 :TRIGger:SHOLd:TYPE .......................................................................................352
3.27.18.6 :TRIGger:SHOLd:STIMe ....................................................................................353
3.27.18.7 :TRIGger:SHOLd:HTIMe ...................................................................................353
3.27.18.8 :TRIGger:SHOLd:DLEVel ...................................................................................354
3.27.18.9 :TRIGger:SHOLd:CLEVel ................................................................................... 355
3.27.19 :TRIGger:NEDGe .................................................................................................................355
3.27.19.1 :TRIGger:NEDGe:SOURce ................................................................................356
3.27.19.2 :TRIGger:NEDGe:SLOPe ................................................................................... 357
3.27.19.3 :TRIGger:NEDGe:IDLE .......................................................................................357
3.27.19.4 :TRIGger:NEDGe:EDGE .....................................................................................358
3.27.19.5 :TRIGger:NEDGe:LEVel ......................................................................................358
3.27.20 :TRIGger:RS232 ...................................................................................................................359
3.27.20.1 :TRIGger:RS232:SOURce ..................................................................................359
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
XV
Page 18
3.27.20.2 :TRIGger:RS232:LEVel ....................................................................................... 360
3.27.20.3 :TRIGger:RS232:POLarity .................................................................................361
3.27.20.4 :TRIGger:RS232:WHEN .....................................................................................361
3.27.20.5 :TRIGger:RS232:DATA ....................................................................................... 362
3.27.20.6 :TRIGger:RS232:BAUD ......................................................................................363
3.27.20.7 :TRIGger:RS232:WIDTh .................................................................................... 363
3.27.20.8 :TRIGger:RS232:STOP ....................................................................................... 364
3.27.20.9 :TRIGger:RS232:PARity ..................................................................................... 364
3.27.21 :TRIGger:IIC ..........................................................................................................................365
3.27.21.1 :TRIGger:IIC:SCL ..................................................................................................365
3.27.21.2 :TRIGger:IIC:CLEVel ............................................................................................366
3.27.21.3 :TRIGger:IIC:SDA .................................................................................................367
3.27.21.4 :TRIGger:IIC:DLEVel ........................................................................................... 367
3.27.21.5 :TRIGger:IIC:WHEN ............................................................................................368
3.27.21.6 :TRIGger:IIC:AWIDth ..........................................................................................369
3.27.21.7 :TRIGger:IIC:ADDRess .......................................................................................370
3.27.21.8 :TRIGger:IIC:DIRection ......................................................................................370
3.27.21.9 :TRIGger:IIC:DBYTes ...........................................................................................371
3.27.21.10 :TRIGger:IIC:DATA .............................................................................................. 371
3.27.21.11 :TRIGger:IIC:CURRbit ........................................................................................ 372
3.27.21.12 :TRIGger:IIC:CODE ............................................................................................. 373
3.27.22 :TRIGger:SPI ......................................................................................................................... 373
3.27.22.1 :TRIGger:SPI:CLK .................................................................................................374
3.27.22.2 :TRIGger:SPI:SCL .................................................................................................374
3.27.22.3 :TRIGger:SPI:CLEVel ...........................................................................................375
3.27.22.4 :TRIGger:SPI:SLOPe ............................................................................................376
3.27.22.5 :TRIGger:SPI:MISO .............................................................................................376
3.27.22.6 :TRIGger:SPI:SDA ................................................................................................377
3.27.22.7 :TRIGger:SPI:DLEVel ...........................................................................................378
3.27.22.8 :TRIGger:SPI:WHEN ...........................................................................................378
3.27.22.9 :TRIGger:SPI:CS ...................................................................................................379
3.27.22.10 :TRIGger:SPI:SLEVel ........................................................................................... 380
3.27.22.11 :TRIGger:SPI:MODE ...........................................................................................381
3.27.22.12 :TRIGger:SPI:TIMeout ....................................................................................... 381
3.27.22.13 :TRIGger:SPI:WIDTh ...........................................................................................382
3.27.22.14 :TRIGger:SPI:DATA ............................................................................................. 382
3.27.22.15 :TRIGger:SPI:CURRbit ....................................................................................... 383
DHO800/DHO900 Programming
Guide
XVI
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 19
3.27.22.16 :TRIGger:SPI:CODE .............................................................................................384
3.27.23 :TRIGger:CAN ...................................................................................................................... 384
3.27.23.1 :TRIGger:CAN:BAUD ......................................................................................... 385
3.27.23.2 :TRIGger:CAN:SOURce .....................................................................................385
3.27.23.3 :TRIGger:CAN:STYPe .........................................................................................386
3.27.23.4 :TRIGger:CAN:WHEN ........................................................................................387
3.27.23.5 :TRIGger:CAN:SPOint ........................................................................................388
3.27.23.6 :TRIGger:CAN:EXTended ..................................................................................389
3.27.23.7 :TRIGger:CAN:DEFine ....................................................................................... 390
3.27.23.8 :TRIGger:CAN:DWIDth ..................................................................................... 390
3.27.23.9 :TRIGger:CAN:DATA .......................................................................................... 391
3.27.23.10 :TRIGger:CAN:CURRbit .....................................................................................392
3.27.23.11 :TRIGger:CAN:CODE ..........................................................................................392
3.27.23.12 :TRIGger:CAN:LEVel ...........................................................................................393
3.27.24 :TRIGger:LIN .........................................................................................................................394
3.27.24.1 :TRIGger:LIN:SOURce ........................................................................................394
3.27.24.2 :TRIGger:LIN:LEVel ............................................................................................. 395
3.27.24.3 :TRIGger:LIN:STANdard ....................................................................................395
3.27.24.4 :TRIGger:LIN:BAUD ............................................................................................396
3.27.24.5 :TRIGger:LIN:SAMPlepoint ..............................................................................397
3.27.24.6 :TRIGger:LIN:WHEN .......................................................................................... 397
3.27.24.7 :TRIGger:LIN:ERRor ............................................................................................398
3.27.24.8 :TRIGger:LIN:ID ...................................................................................................399
3.27.24.9 :TRIGger:LIN:DATA .............................................................................................399
3.27.24.10 :TRIGger:LIN:CURRbit .......................................................................................400
3.27.24.11 :TRIGger:LIN:CODE ............................................................................................400
3.28 :WAVeform Commands .................................................................................................................401
3.28.1 :WAVeform:SOURce .......................................................................................................... 404
3.28.2 :WAVeform:MODE ............................................................................................................. 405
3.28.3 :WAVeform:FORMat .......................................................................................................... 406
3.28.4 :WAVeform:POINts ............................................................................................................ 406
3.28.5 :WAVeform:DATA? ..............................................................................................................407
3.28.6 :WAVeform:XINCrement? ................................................................................................ 408
3.28.7 :WAVeform:XORigin? ........................................................................................................ 408
3.28.8 :WAVeform:XREFerence? ................................................................................................. 409
3.28.9 :WAVeform:YINCrement? ................................................................................................ 410
3.28.10 :WAVeform:YORigin? ........................................................................................................ 410
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
XVII
Page 20
3.28.11 :WAVeform:YREFerence? ................................................................................................. 411
3.28.12 :WAVeform:STARt ...............................................................................................................411
3.28.13 :WAVeform:STOP ................................................................................................................412
3.28.14 :WAVeform:PREamble? .....................................................................................................413
4 Application Examples .................................................................................................415
4.1 To Configure Basic Parameters .................................................................................................. 415
4.2 To Set Measurements ....................................................................................................................416
4.3 To Read the Waveform ..................................................................................................................417
5 Programming Examples ............................................................................................419
5.1 Programming Preparations .........................................................................................................419
5.2 LabVIEW Programming Example .............................................................................................. 419
5.3 Visual Basic Programming Example .........................................................................................423
5.4 Visual C++ Programming Example .......................................................................................... 425
DHO800/DHO900 Programming
Guide
XVIII
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 21
List of Figures
Figure 3.1 Schematic Diagram of Parallel Decoding ................................................... 33
Figure 3.2 Schematic Diagram of RS232 Serial Bus .....................................................39
Figure 3.3 I2C Serial Bus ........................................................................................................45
Figure 3.4 SPI Serial Bus ........................................................................................................ 49
Figure 3.5 Sample Position ...................................................................................................59
Figure 3.6 Cursors ....................................................................................................................85
Figure 3.7 Schematic Diagram of RS232 Frame Format ..........................................359
Figure 3.8 Schematic Diagram of I2C Frame Format ................................................365
Figure 3.9 Sequential Chart of SPI Bus .......................................................................... 373
Figure 3.10 Data Frame Format of the CAN Bus ........................................................384
Figure 3.11 Data Frame Format of the LIN Bus .......................................................... 394
Figure 3.12 Parameter Definitions in NORMAL Mode ............................................. 402
Figure 3.13 Parameter Definitions in RAW Mode ......................................................402
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
XIX
Page 22
List of Tables
Table 3.128 Table of the Bit Definition of Standard Event Status Register ........124
Table 3.129 Table of the Bit Definition of Status Byte Register ............................. 125
Table 3.161 Window Function ...........................................................................................157
Table 3.162 Logic Operation Results .............................................................................. 158
DHO800/DHO900 Programming
Guide
XX
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 23
Document Overview
1
Document Overview
This manual introduces how to program and control DHO800 and DHO900 series via
the remote interface by using the SCPI (Standard Commands for Programmable
Instruments) commands. DHO800 and DHO900 series can communicate with PC via
USB and LAN interfaces.
TIP
For the latest version of this manual, download it from RIGOL official website (
www.rigol.com
Publication Number
PGA39106-1110
Software Version
00.01.03
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.
).
http://
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,
the "Utility" function menu. You can click or tap Setup to access the "Setup" menu.
3. Operation Procedures
The next step of the operation is denoted by ">" in the manual. For example,
> Storage indicates first clicking or tapping and then clicking or tapping
Storage.
4. Connector
Setup indicates the "Setup" sub-menu under
The front/rear panel connector is denoted by "Brackets + Connector Name (Bold)",
for example, [AUX OUT].
Content Conventions in this Manual
DHO800 series digital oscilloscope includes the following models. Four-channel
models and two-channel models share the same operation method. Unless otherwise
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
1
Page 24
Document Overview
specified, this manual takes the four-channel model DHO814 as an example to
illustrate the operation methods of DHO800 series oscilloscope.
Model Max. Analog Bandwidth No. of Analog Channels
DHO802 70 MHz 2+EXT
DHO804 70 MHz 4
DHO812 100 MHz 2+EXT
DHO814 100 MHz 4
DHO900 series digital oscilloscope includes the following models. Unless otherwise
specified, this manual takes DHO924S as an example to illustrate the operation
methods of DHO900 series.
Model Max. Analog Bandwidth No. of Analog Channels
DHO914 125 MHz 4
DHO914S 125 MHz 4
DHO924 250 MHz 4
DHO924S 250 MHz 4
DHO800/DHO900 Programming
Guide
2
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 25
Programming Overview
2
Programming Overview
2.1 SCPI Command Overview
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 quotation 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,
type
year
>
type
> indicates a settable parameter. The command ending
type
> are separated by a space.
>,<
month
>,<
day
>
:ACQuire:TYPE <
:ACQuire:TYPE?
ACQuire 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. <
with a quotation mark "?" indicates querying a certain function. The command
keywords :ACQuire:TYPE and the parameter <
In some commands with parameters, "," is often used to separate multiple
parameters. For example,
:SYSTem:DATE <
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 |
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
3
Page 26
Programming Overview
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 <
:SYSTem:BEEPer?
bool
>
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,
sat
:SYSTem:PSTatus <
>
: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,
:DISPlay:GBRightness <
:DISPlay:GBRightness?
Wherein, <
returns an integer ranging from 1 to 100.
4. Real
DHO800/DHO900 Programming
Guide
4
brightness
brightness
>
> can be set to an integer ranging from 1 to 100. The query
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 27
Programming Overview
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,
:TRIGger:TIMeout:TIME <
:TRIGger:TIMeout:TIME?
Wherein, <
+1 (10 s). The query returns a real number in scientific notation.
5. ASCII String
The parameter can be the combinations of ASCII characters. For example,
:LAN:GATeway <
Wherein, <
192.168.1.1
Command Abbreviation
The keywords of all the commands are case-insensitive. They can all be in upper case
or in lower case. If an abbreviation is used, you must input all the capital letters in the
command. For example,
:DISPlay:GBRightness?
time
> can be set to any real number ranging from 1.6E-8 (16 ns) to 1E
string
string
> can be set to
time
>
>
can be abbreviated as
:DISP:GBR?
2.2 Remote Control
This instrument can be connected to the PC via the USB, or LAN interface 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. RIGOL Ultra Sigma is recommended. When the instrument is
connected to the PC via the USB, or LAN interface, the Ultra Sigma software can
search for instrument resources and enable command interaction.
Log in to the RIGOL official website. Click Support and select Soft/Firmware to
obtain the Ultra Sigma software package and help documentation.
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.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
5
Page 28
Programming Overview
The operation procedures are as follows:
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
command. The operation process and the returned value will be displayed in the
current interface.
2.2.1 Remote Control via USB
1. Connect the device
Use the USB cable to connect the rear-panel USB DEVICE interface of the
instrument to the USB HOST interface of the PC.
2. Search for the device resource
Start up Ultra Sigma and the software will automatically search for the resource
currently connected to the PC via the USB interface. You can also click
search for the resource.
3. View the device resource
The resources found will appear under the "RIGOL Online Resource" directory, and
the model number and USB interface information of the instrument will also be
displayed.
Send & Read to send the
USB-TMC to
4. Control the instrument remotely
Right-click the device resource name and select "SCPI Panel Control" to open the
remotely command control panel. Then you can send commands and read data
through the panel. For details about the SCPI commands and programming, refer
to the Programming Guide of this instrument.
2.2.2 Remote Control via LAN
1. Connect the device
Use the network cable to connect the instrument to your local area network (LAN).
2. Configure network parameters
Configure the network parameters of the instrument in Utility>IO menu.
3. Search for Search device resource
DHO800/DHO900 Programming
Guide
6
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 29
Programming Overview
Start up Ultra Sigma and click LAN to open the panel as shown in the figure below.
Click Search and the software searches for the instrument resources currently
connected to the LAN and the resources found are displayed at the right section of
the window as shown in the figure below. Click OK to add it.
Besides, you can input the IP address of the instrument manually into the text field
under "Manual Input LAN Instrument IP", then click
the test, click Add to add the instrument to the LAN instrument resource list in the
right section; if the instrument fails the test, please check whether the IP address
that you input is correct, or use the auto search method to add the instrument
resource.
4. View the device resource
The resources found will appear under the "RIGOL Online Resource" directory.
5. Control the instrument remotely
Right-click the device resource name and select "SCPI Panel Control" to open the
remotely command control panel. Then you can send commands and read data
through the panel.
6. Load LXI webpage
As this instrument conforms to LXI CORE 2011 DEVICE standards, you can load LXI
web page through Ultra Sigma (right-click the instrument resource name and
select "LXI-Web"). Various important information about the instrument (including
the model, manufacturer, serial number, description, MAC address, and IP address)
will be displayed on the web page. You can also directly input the IP address of the
instrument in the address bar of the PC browser to load the LXI web page.
TEST. If the instrument passes
2.3 Sequential Commands and Overlapped Commands
IEEE488.2 defines the differentiation between the Sequential commands and the
Overlapped commands.
• Sequential Commands
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
7
Page 30
Programming Overview
Commands that shall be executed in sequence. Before completing the execution
of one sequential command, another command shall not be executed. A
command is a Sequential Command when Execution Control waits for the
resulting device action to complete before it initiates the next device action.
The following figure shows the example of the sequence order for the sequential
command.
time
Sequential Command 1
Sequential Command 2
Sequential Command 3
• Overlapped Commands
Commands that can be executed with several other commands being executed
in parallel. During the execution process, several commands may be overlapped
with each other. An overlapped command is a command that allows execution of
subsequent commands while the device operations initiated by that overlapped
command are still in progress.
The following figure shows the example of the sequence order for the
overlapped command.
Overlapped Command 1
Overlapped Command 2
Sequential Command 3
time
To ensure that the instrument functions can be synchronized through the commands
executed in the specified order and query the command execution status, IEEE488.2
defines three general commands (
complete (OPC) function of the instrument.
• *WAI: The *WAI command shall prevent the instrument from executing further
commands or queries until all the received commands have been completely
executed. The *WAI command will not operate on the register.
DHO800/DHO900 Programming
Guide
8
*WAI, *OPC
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
, and
*OPC?
) to check the operation
Page 31
Programming Overview
If you want the overlapped commands to be executed in sequence just like the
sequential commands, you can send the *WAI command before or after the
specified overlapped command. For example,
time
Overlapped Command 1
*WAI
Overlapped Command 2
*WAI
Overlapped Command 3
*WAI
• *OPC: Upon receiving the *OPC command, the instrument will wait until all the
previously received commands have been completely executed. Meanwhile, it
will set Bit 0 in the
Standard Event Register
to 1, and then execute the following
commands.
• *OPC?: Upon receiving the *OPC? Command, the instrument will query whether
all the previous received commands have been completely executed. If
completed, the query returns 1; if not, it will wait until all the pending operations
have been completed and then returns 1. The *OPC? command shall not operate
on the register.
If you want to query the execution status of a series of commands and control
the execution sequence of the command, send the *OPC? Command. For
example,
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
9
Page 32
Programming Overview
time
Overlapped Command
Sequential
Command 1
Sequential
Command 2
*OPC?
查询命令
是否结束
Sequential
Command 3
The following table lists the overlapped commands that support the Operation
Complete (OPC) function. While using the overlapped commands, pay attention to
the execution order of the command to avoid causing any abnormalities to the
results.
Command Constraint Condition
*RST
-
DHO800/DHO900 Programming
Guide
10
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 33
Command System
3
Command System
This chapter introduces the syntax, functions, parameters, and usage of each
command. By default, only CH1 is enabled.
NOTE
For the parameter setting command (time, frequency, amplitude, etc.), the digital oscilloscope
can only recognize the numbers, unable to recognize the unit sent together with them. The
unit of the parameter is a default one. For the default units of various parameters, refer to the
descriptions for the specified command.
3.1 Root Commands
Root level commands only have the root keywords, without the next level keywords.
They control many of the basic operations of the instrument.
3.1.1 :CLEar
Syntax
:CLEar
Description
Clears all the waveforms on the screen.
This command functions the same as the front-panel key .
Parameter
N/A
Remarks
N/A
Return Format
N/A
Example
N/A
3.1.2 :RUN
Syntax
:RUN
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
11
Page 34
Command System
Description
The :RUN command starts running the oscilloscope
This command functions the same as clicking or tapping the icon
operation bar at the upper-right part of the screen; or the tap the on the front
panel.
Parameter
N/A
Remarks
N/A
Return Format
N/A
Example
N/A
3.1.3 :STOP
Syntax
in the quick
:STOP
Description
The :STOP command stops running the oscilloscope.
This command functions the same as clicking or tapping the icon in the quick
operation bar at the upper-right part of the screen; or the key on the front
panel.
Parameter
N/A
Remarks
N/A
Return Format
N/A
Example
N/A
DHO800/DHO900 Programming
Guide
12
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 35
3.1.4 :SINGle
Syntax
:SINGle
Description
Performs a single trigger. Sets the trigger mode of the oscilloscope to "Single". This
command functions the same as sending the
This command functions the same as the front-panel key .
Parameter
N/A
Remarks
Command System
:TRIGger:SWEep SINGle
command.
• In the single trigger mode, the oscilloscope performs a single trigger when the
trigger conditions are met and then it stops.
• When the waveform recording function is enabled or the recorded waveforms
are played back, this command is invalid.
• For the single trigger, you can use the
trigger by force.
Return Format
N/A
Example
N/A
3.1.5 :TFORce
Syntax
:TFORce
command to generate one
:TFORce
Description
Generates a trigger signal forcefully. This command is only applicable to the normal
and single trigger modes. Refer to the
This command functions the same as the key in the trigger control area of the
front panel.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
:TRIGger:SWEep
command).
Guide
13
Page 36
Command System
Parameter
N/A
Remarks
N/A
Return Format
N/A
Example
N/A
3.2 :AUToset Commands
The :AUToset commands are used to perform waveform auto setting operations.
3.2.1 :AUToset
Syntax
:AUToset
Description
Enables the waveform auto setting function. The oscilloscope will automatically adjust
the vertical scale, horizontal time base, and trigger mode according to the input
signal to realize optimal waveform display.
This command functions the same as the front-panel key
Parameter
N/A
Remarks
• When the AUTO function is disabled, this command is invalid. For details, refer
to
:SYSTem:AUToscale
.
.
• When the pass/fail test is enabled, the AUTO function runs normally, but the
pass/fail test function is forced to be disabled.
• When the waveform recording function is enabled, the AUTO function runs
normally, but the recording or playing function is forced to be disabled.
DHO800/DHO900 Programming
Guide
14
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 37
Return Format
N/A
Example
N/A
3.2.2 :AUToset:PEAK
Syntax
Command System
:AUToset:PEAK <
:AUToset:PEAK?
Description
Sets or queries whether the peak-peak priority setting is enabled.
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 1|ON
Remarks
This function is intended for the shifted signal. If there is a large deviation, you can
view the signal waveform in priority when you enable the function.
Return Format
The query returns 0 or 1.
Example
bool
>
:AUToset:PEAK OFF /*Disables the peak-peak priority setting.*/
:AUToset:PEAK? /*The query returns 0.*/
3.2.3 :AUToset:OPENch
Syntax
:AUToset:OPENch <
:AUToset:OPENch?
Description
Sets or queries whether to only test the enabled channel when performing the AUTO
operation.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
bool
>
Guide
15
Page 38
Command System
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
• If you select "0|OFF", the system will test the four analog channels (CH1-CH4) in
• If you select "1|ON", the system will only test the enabled channels when
sequence when performing the AUTO operation. If no signal is found on the
channel, then the channel is disabled. If a signal is found on the channel, adjust
the channel to an optimal scale to show the signal.
performing the AUTO operation.
Return Format
The query returns 0 or 1.
Example
:AUToset:OPENch ON /*Sets to test only the enabled channel(s) for
AUTO operation.*/
:AUToset:OPENch? /*The query returns 1.*/
3.2.4 :AUToset:OVERlap
Syntax
:AUToset:OVERlap <
:AUToset:OVERlap?
Description
Sets or queries whether to enable the waveform display mode.
Parameter
Name Type Range Default
bool
>
<bool> Bool {{1|ON}|{0|OFF}} 1|ON
Remarks
• 1|ON: enables the waveform overlay display. Waveforms of different channels
will be displayed in the same position of the screen.
DHO800/DHO900 Programming
Guide
16
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 39
• 0|OFF: disables the waveform overlay display. Waveforms of different channels
will be displayed on the screen from top to bottom in sequence.
Return Format
The query returns 0 or 1.
Example
:AUToset:OVERlap OFF /*Disables the waveform overlay display.*/
:AUToset:OVERlap? /*The query returns 0.*/
3.2.5 :AUToset:KEEPcoup
Syntax
Command System
:AUToset:KEEPcoup <
:AUToset:KEEPcoup?
Description
Sets or queries whether to enable keeping coupling.
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
• 1|ON: Enables keeping coupling. When enabled, the system performs auto
setting operation. The settings for the channel coupling remain unchanged.
• 0|OFF: Disables keeping coupling. When disabled, the channel is, by default, DC
coupled.
bool
>
Return Format
The query returns 0 or 1.
Example
:AUToset:KEEPcoup ON /*Sets to enable keeping coupling.*/
:AUToset:KEEPcoup? /*The query returns 1.*/
3.2.6 :AUToset:LOCK
Syntax
:AUToset:LOCK <
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
bool
>
Guide
17
Page 40
Command System
:AUToset:LOCK?
Description
Sets or queries the on/off status of the AUTO function.
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
• 1|ON: locks the AUTO key; disables the AUTO function.
• 0|OFF: unlocks the AUTO key; enables the AUTO function.
You can also send the
:AUToset:ENAble
function.
Return Format
The query returns 0 or 1.
Example
:AUToset:LOCK ON /*Locks the AUTO key; disables the AUTO
function.*/
:AUToset:LOCK? /*The query returns 1.*/
3.2.7 :AUToset:ENAble
Syntax
:AUToset:ENAble <
:AUToset:ENAble?
Description
Sets or queries whether to enable the AUTO function.
bool
command to enable or disable the AUTO
>
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 1|ON
Remarks
• 1|ON: enables the AUTO function. It functions the same as enabling the front-
panel key .
DHO800/DHO900 Programming
Guide
18
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 41
Command System
• 0|OFF: disables the AUTO function. It functions the same as disabling the front-
panel key .
You can also send the
function.
Return Format
The query returns 0 or 1.
Example
:AUToset:ENAble OFF /*Disables the AUTO function.*/
:AUToset:ENAble? /*The query returns 0.*/
:AUToset:LOCK
3.3 :ACQuire Commands
The :ACQuire commands are used to set the memory depth of the oscilloscope, the
acquisition mode, the average times, as well as query the current sample rate.
3.3.1 :ACQuire:AVERages
Syntax
:ACQuire:AVERages <
count
>
command to enable or disable the AUTO
:ACQuire:AVERages?
Description
Sets or queries the number of averages in the average acquisition mode.
Parameter
Name Type Range Default
<count> Integer
Remarks
• You can send the
• In the average acquisition mode, greater number of averages can lower the
noise and increase the vertical resolution; but will also slow the response of the
displayed waveform to the waveform changes.
:ACQuire:TYPE
2n(n is an integer, and its range
is from 1 to 16).
command to set the acquisition mode.
2
• The number of averages must be in the Nth power of 2. When the value is not in
the Nth power of 2, a value that is smaller than the one you input and the closest
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
19
Page 42
Command System
to the N power-of-2 increments will be input automatically. For example, if you
input 9 with the numeric keypad, the average count will be input 8 automatically.
Return Format
The query returns an integer ranging from 2 to 65536.
Example
:ACQuire:AVERages 128 /*Sets the average times to 128.*/
:ACQuire:AVERages? /*The query returns 128.*/
3.3.2 :ACQuire:MDEPth
Syntax
:ACQuire:MDEPth <
mdep
>
:ACQuire:MDEPth?
Description
Sets or queries the memory depth of the oscilloscope (that is, the number of
waveform points that can be stored through the sampling in a single trigger). The
default unit is pts.
Parameter
Name Type Range Default
{AUTO|1k|10k|100k|1M|5M|10M|
25M|50M|1000|10000|100000|
<mdep> Discrete
1000000|5000000|10000000|
10k
25000000|50000000|1e3|1e4|
1e5|1e6|5e6|1e7|2.5e7|5e7}
Remarks
When you select the "Auto" mode, the oscilloscope selects the memory depth
automatically according to the current sample rate.
• When any one of the channels is enabled, the available memory depths are
AUTO, 1k, 10k, 100k, 1M, 5M, 10M, 25M, and 50M (50M is only available for
DHO900).
• When any two of the channels are enabled, the available memory depths are
AUTO, 1k, 10k, 100k, 1M, 5M, 10M, and 25M (25M is only available for DHO900).
DHO800/DHO900 Programming
Guide
20
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 43
• When three or four channels (only available for 4-channel models) are enabled,
the available memory depths are AUTO, 1k, 10k, 100k, 1M, 5M, and 10M (10M is
only available for DHO900).
Modifying the memory depth will affect the sample rate. To query the current sample
rate, run the
:ACQuire:SRATe?
Return Format
The query returns the memory depth in scientific notation.
Example
:ACQuire:MDEPth 1M /*Sets the memory depth to 1M.*/
:ACQuire:MDEPth? /*The query returns 1.000E+6.*/
3.3.3 :ACQuire:TYPE
Command System
command.
Syntax
:ACQuire:TYPE <
type
>
:ACQuire:TYPE?
Description
Sets or queries the acquisition mode of the oscilloscope.
Parameter
Name Type Range Default
<type> Discrete
{NORMal|PEAK|AVERages|
ULTRa}
NORMal
Remarks
• NORMal: In this mode, the oscilloscope samples the signal at a specified fixed
time interval to rebuild the waveform. For most of the waveforms, using this
mode can produce the optimal display effects.
• AVERages: In this mode, the oscilloscope averages the waveforms from multiple
samples to reduce the random noise of the input signal and improve the vertical
resolution. Greater number of averages can lower the noise and increase the
vertical resolution; while at the same time, it will slow the response of the
displayed waveform to the waveform changes.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
21
Page 44
Command System
• PEAK: indicates the peak detection. In this mode, the oscilloscope samples the
• ULTRa (UltraAcquire): divides the oscilloscope's memory into segments and fills
Return Format
The query returns NORM, PEAK, AVER, or ULTR.
maximum and minimum value of the signal at the fixed sampling interval to
acquire the signal envelope or the narrow pulses that might be lost. In this
mode, signal aliasing can be prevented, but the noise displayed would be larger.
a memory segment for each individual trigger event. In this mode, the refresh
rate of the waveforms is highly improved, greatly minimizing the dead time
between trigger events.
Example
:ACQuire:TYPE AVERages /*Sets the acquisition mode to Average.*/
:ACQuire:TYPE? /*The query returns AVER.*/
3.3.4 :ACQuire:SRATe?
Syntax
:ACQuire:SRATe?
Description
Queries the current sample rate. The default unit is Sa/s.
Parameter
N/A
Remarks
• Sample rate indicates the frequency of the signal sampling, that is, the number
of waveform points sampled per second.
• The sample rate and memory depth will change accordingly in accordance with
the horizontal time base.
Return Format
The query returns the sample rate in scientific notation.
Example
:ACQuire:SRATe? /*The query returns 1.00000E+6.*/
DHO800/DHO900 Programming
Guide
22
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 45
3.3.5 :ACQuire:ULTRa:MODE
Syntax
Command System
:ACQuire:ULTRa:MODE <
mode
>
:ACQuire:ULTRa:MODE?
Description
Sets or queries the display mode of Ultra Acquire.
Parameter
Name Type Range Default
<mode> Discrete
{ADJacent|OVERlay|WATerfall|
PERSpective|MOSaic}
-
Remarks
• ADJacent: indicates the adjacent display. Waveform segments are shown in
adjacent display, with each segment shown next to the previous segment. In this
mode, a maximum of 100 frames of waveforms can be displayed on the screen
at a time.
• OVERlay: indicates the overlay display. All the captured waveform segments are
overwritten to display as one single segment of the waveform. In this mode, a
maximum of 100 frames of waveforms can be displayed on the screen at a time.
• WATerfall: indicates the waterfall display. It displays the captured waveform
segments in a cascaded display order. In this mode, a maximum of 100 frames of
waveforms can be displayed on the screen at a time.
• PERSpective: indicates the perspective display. The waveform segments are
displayed in the ladder-like form, with each segment being arranged above
another with a certain perspective (angle), moving up like a rising slope. In this
mode, a maximum of 100 frames of waveforms can be displayed on the screen
at a time.
• MOSaic: indicates the mosaic display. The whole waveform view is divided into
several blocks, and each waveform segment is displayed in each block in
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
23
Page 46
Command System
sequence. In this mode, a maximum of 80 frames of waveforms can be displayed
on the screen at a time.
Return Format
The query returns ADJ, OVER, WAT, PERS, or MOS.
Example
:ACQuire:ULTRa:MODE ADJacent /*Sets the Ultra Acquire display
mode to ADJacent.*/
:ACQuire:ULTRa:MODE? /*The query returns ADJ.*/
3.3.6 :ACQuire:ULTRa:TIMeout
Syntax
:ACQuire:ULTRa:TIMeout <
:ACQuire:ULTRa:TIMeout?
Description
Sets or queries the timeout value of Ultra Acquire.
Parameter
Name Type Range Default
<tmo> Real 1 us to 1 s 1.00 ms
Remarks
N/A
Return Format
The query returns a real number in scientific notation.
Example
:ACQuire:ULTRa:TIMeout 0.1 /*Sets the Ultra Acquire timeout
value to 0.1 s.*/
:ACQuire:ULTRa:TIMeout? /*The query returns 1E-1.*/
tmo
>
3.3.7 :ACQuire:ULTRa:MAXFrame
Syntax
:ACQuire:ULTRa:MAXFrame <
:ACQuire:ULTRa:MAXFrame?
DHO800/DHO900 Programming
Guide
24
frame
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 47
Command System
Description
Sets or queries the maximum number of frames that can be set for Ultra Acquire
sampling mode.
Parameter
Name Type Range Default
<frame> Integer
Remarks
N/A
Return Format
The query returns the maximum number of frames in integer.
Example
:ACQuire:ULTRa:MAXFrame 100 /*Sets the maximum number of frames
to 100.*/
:ACQuire:ULTRa:MAXFrame? /*The query returns 100.*/
3.4 :BUS<n> Commands
The :BUS<n> commands are used to execute the decoding-related settings and
operations.
1 to the maximum number of
frames
-
3.4.1 :BUS<n>:MODE
Syntax
:BUS<n>:MODE <
n
:BUS<
Description
Sets or queries the decoding type of the specified decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<mode> Discrete {PARallel|RS232|SPI|IIC|LIN|CAN} PARallel
Remarks
LIN decoding type is only available for the DHO900 series.
>:MODE?
mode
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
25
Page 48
Command System
Return Format
The query returns PAR, RS232, SPI, IIC, LINor CAN.
Example
:BUS1:MODE SPI /*Sets the decoding type of Bus 1 to SPI.*/
:BUS1:MODE? /*The query returns SPI.*/
3.4.2 :BUS<n>:DISPlay
Syntax
:BUS<n>:DISPlay <
n
:BUS<
Description
Enables or disables the specified decoding bus; or queries the on/off display status of
the specified decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
N/A
Return Format
The query returns 1 or 0.
>:DISPlay?
bool
>
Example
:BUS1:DISPlay ON /*Enables the decoding bus.*/
:BUS1:DISPlay? /*The query returns 1.*/
3.4.3 :BUS<n>:FORMat
Syntax
:BUS<n>:FORMat <
n
:BUS<
Description
Sets or queries the format of decoding data on the specified decoding bus.
DHO800/DHO900 Programming
Guide
26
>:FORMat?
format
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 49
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<format> Discrete {HEX|ASCii|DEC|BIN} HEX
Remarks
• Hex: indicates Hexadecimal;
• ASCii: indicates ASCII;
• DEC: indicates Decimal;
• BIN: indicates Binary.
Return Format
The query returns HEX, ASC, DEC, or BIN.
Example
:BUS1:FORMat HEX /*Sets the display format of the bus to HEX.*/
:BUS1:FORMat? /*The query returns HEX.*/
3.4.4 :BUS<n>:EVENt
Syntax
:BUS<n>:EVENt <
n
:BUS<
>:EVENt?
Description
Enables or disables the event table of the specified decoding bus; or queries the
on/off status of the specified decoding bus event table.
Parameter
Name Type Range Default
bool
>
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
Before using the command, enable the specified decoding bus.
Return Format
The query returns 1 or 0.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
27
Page 50
Command System
Example
:BUS1:EVENt ON /*Enables the event table of the specified
decoding bus.*/
:BUS1:EVENt? /*The query returns 1.*/
3.4.5 :BUS<n>:LABel
Syntax
:BUS<n>:LABel <
n
:BUS<
Description
Enables or disables the label of the specified decoding bus; or queries the on/off
display status of the label of the specified decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 1|ON
Remarks
Before using the command, enable the specified decoding bus.
Return Format
The query returns 1 or 0.
>:LABel?
bool
>
Example
:BUS1:LABel ON /*Enables the label of the specified decoding bus.*/
:BUS1:LABel? /*The query returns 1.*/
3.4.6 :BUS<n>:DATA?
Syntax
:BUS<n>:DATA?
Description
Reads the data from the decoding event table.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
DHO800/DHO900 Programming
Guide
28
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 51
Command System
Remarks
N/A
Return Format
The query returns the data in the decoding event table with the following formats.
#9000000086PARALLEL
Time,Data,
-2.47us,0,
-2.444us,1,
-1.448us,0,
-446ns,1,
551.6ns,0,
1.554us,1,
Wherein, "#9000000086" is the TMC data block header, which is followed by the data
in the event table. The 9-digit data following #9 in the data block header indicates the
number of bytes of the effective data. "PARALLEL" indicates the decoding type. The
available decoding type can also be RS232, I2C, SPI, LIN, and etc. The data are
separated by a comma, and will automatically switch to the next line according to the
data information in the decoding list. The data value is related to the numeral system
that you have set.
CAUTION
You can save all the data (except TMC data block header and decoding type, e.g.
#9000000086PARALLEL) as the "*.csv" file and view the data in the form of a list.
Example
N/A
3.4.7 :BUS<n>:EEXPort
Syntax
:BUS<n>:EEXPort <
Description
Exports the decoding information from the specified decoding bus event table in CSV
form.
Parameter
Name Type Range Default
path
>
<n> Discrete {1|2|3|4} -
<path> ASCII String Refer to
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Remarks
-
Guide
29
Page 52
Command System
Remarks
• <path> includes the file storage location and the filename with a suffix. If the
specified storage location already contains a file with the same filename, the
original file will be overwritten.
• When the operating status of the instrument is STOP (set it by sending the
command), you can export the time and corresponding decoding data from the
current event table.
• This command is valid when the display of the event table is enabled. You can
enable the display of the event table by sending the
• The stored "*.csv" file can be opened and edited in Excel.
Return Format
N/A
Example
:BUS1:EEXPort C:/123.csv /*Exports the decoding information from
the bus event table and saves it to the local Disk C, with the
filename 123.csv.*/
3.4.8 :BUS<n>:POSition
:BUS<n>:EVENt
:STOP
command.
Syntax
:BUS<n>:POSition <
n
:BUS<
>:POSition?
pos
>
Description
Sets or queries the vertical position of the bus on the screen.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<pos> Integer -250 to 250 0
Remarks
N/A
DHO800/DHO900 Programming
Guide
30
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 53
Return Format
The query returns an integer ranging from -250 to 250.
Example
:BUS1:POSition 200 /*Sets the vertical position of the bus to
200.*/
:BUS1:POSition? /*The query returns 200.*/
3.4.9 :BUS<n>:THReshold
Syntax
Command System
:BUS<n>:THReshold <
n
:BUS<
Description
Sets or queries the threshold of the specified decoding source on the specified
decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<value> Real
<type> Discrete
Remarks
>:THReshold? <
value
type
>,<
>
type
>
(-5 x VerticalScale - OFFSet) to
(5 x VerticalScale - OFFSet)
{PAL|TX|RX|SCL|SDA|CS|CLK|
MISO|MOSI|LIN|CAN|PALCLK|
CH1|CH2|CH3|CH4}
0
-
For VerticalScale, refer to the
the
:CHANnel<n>:OFFSet
• PAL: indicates the bus source of Parallel decoding.
• PALCLK: indicates the clock source of Parallel decoding. Only when the source is
enabled, can you set the threshold.
• TX: indicates the TX channel source of RS232 decoding.
• RX: indicates the RX channel source of RS232 decoding. Only when the RX
source is enabled, can you set the threshold.
• SCL: indicates the clock source of I2C decoding.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
:CHANnel<n>:SCALe
command.
command. For OFFSet, refer to
Guide
31
Page 54
Command System
• SDA: indicates the data source of I2C decoding.
• CS: indicates the source of the CS line of SPI decoding.
• CLK: indicates the clock source of SPI decoding.
• MISO: indicates the MISO data source of SPI decoding.
• MOSI: indicates the MOSI data source of SPI decoding.
• LIN: indicates the bus source of LIN decoding.
• CAN: indicates the source of CAN decoding.
• CH1|CH2|CH3|CH4: CH1-CH4, available for all the decoding types.
Only the DHO900 series supports LIN decodings.
For the DHO800 series, only the 4-channel model supports CS in SPI decoding.
Return Format
The query returns the threshold of the specified decoding source in scientific
notation.
Example
:BUS1:THReshold 2.4,PAL /*Sets the threshold of the Parallel
decoding source to 2.4 V.*/
:BUS1:THReshold? PAL /*The query returns 2.400000E0.*/
3.4.10 :BUS<n>:PARallel
:BUS<n>:PARallel commands are used to set relevant parameters for parallel
decoding.
Parallel bus consists of clock line and data line. As shown in the figure below, CLK is
the clock line, whereas Bit0 and Bit1 are the 0 bit and 1st bit on the data line
respectively. The oscilloscope will sample the channel data on the rising edge, falling
edge, or the rising/falling edge of the clock and judge each data point (logic "1" or
logic "0") according to the preset threshold level.
DHO800/DHO900 Programming
Guide
32
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 55
CLK
Bit0
Bit1
Command System
Parallel[BIN] 11 10
Figure 3.1 Schematic Diagram of Parallel Decoding
3.4.10.1 :BUS<n>:PARallel:BUS
Syntax
:BUS<n>:PARallel:BUS <
n
:BUS<
>:PARallel:BUS?
Description
Sets or queries the source of Parallel decoding on the specific bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<source> Discrete
source
10
10 00
>
{D7D0|D15D8|D15D0|D0D7|
D8D15|D0D15|CHANnel1|
CHANnel2|CHANnel3|CHANnel4|
USER}
CHANnel1
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D7D0, D15D8, D15D0, D0D7, D8D15, D0D15, CHAN1, CHAN2,
CHAN3, CHAN4, or USER.
Example
:BUS1:PARallel:BUS CHANnel1 /*Sets the source of Parallel
decoding to CHANnel1.*/
:BUS1:PARallel:BUS? /*The query returns CHAN1.*/
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
33
Page 56
Command System
3.4.10.2 :BUS<n>:PARallel:CLK
Syntax
:BUS<n>:PARallel:CLK <
n
:BUS<
>:PARallel:CLK?
source
>
Description
Sets or queries the clock source of Parallel decoding on the specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
OFF
CHANnel4|OFF}
Remarks
N/A
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:PARallel:CLK CHANnel2 /*Sets the clock source of Parallel
decoding to CHANnel2.*/
:BUS1:PARallel:CLK? /*The query returns CHAN2.*/
3.4.10.3 :BUS<n>:PARallel:SLOPe
Syntax
:BUS<n>:PARallel:SLOPe <
n
:BUS<
>:PARallel:SLOPe?
Description
Sets or queries the edge type of the clock channel when being sampled by Parallel
decoding on the data channel.
slope
>
DHO800/DHO900 Programming
Guide
34
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 57
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<slope> Discrete {POSitive|NEGative|BOTH} POSitive
Remarks
If no clock channel is selected, the instrument will sample when the channel data
hopping occurs during the decoding.
Return Format
The query returns POS, NEG, or BOTH.
Example
:BUS1:PARallel:SLOPe BOTH /*Sets the Parallel decoding to
sample on any edge of the clock channel.*/
:BUS1:PARallel:SLOPe? /*The query returns BOTH.*/
3.4.10.4 :BUS<n>:PARallel:WIDTh
Syntax
:BUS<n>:PARallel:WIDTh <
n
:BUS<
>:PARallel:WIDTh?
Description
Sets or queries the data width (number of bits per frame) of Parallel decoding on the
specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<wid> Integer 1 to 4 1
Remarks
wid
>
• Only when the data source is set to User (
BUS<n>:PARallel:BUS USER
), can this
command be available to use.
• After you send this command to set the data width of the bus, send
the
:BUS<n>:PARallel:BITX
and
:BUS<n>:PARallel:SOURce
commands to select
the bit respectively and set the channel source for the bit.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
35
Page 58
Command System
Return Format
The query returns an integer ranging from 1 to 4.
Example
:BUS1:PARallel:WIDTh 4 /*Sets the data width of Parallel
decoding to 4.*/
:BUS1:PARallel:WIDTh? /*The query returns 4.*/
3.4.10.5 :BUS<n>:PARallel:BITX
Syntax
:BUS<n>:PARallel:BITX <
n
:BUS<
>:PARallel:BITX?
bit
>
Description
Sets or queries the data bit that the parallel bus requires to set for the channel
source.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bit> Integer 0 to (data width - 1) 0
Remarks
• Only when the bus source is set to User (
BUS<n>:PARallel:BUS USER
), can this
command be valid.
• The data width is set by the
• After selecting the desired bit, send the
set the channel source for the bit.
Return Format
The query returns the current data bits in integer. Its unit is Hz.
Example
:BUS1:PARallel:BITX 2 /*Sets the current bit to 2.*/
:BUS1:PARallel:BITX? /*The query returns 2.*/
DHO800/DHO900 Programming
Guide
36
:BUS<n>:PARallel:WIDTh
:BUS<n>:PARallel:SOURce
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
command.
command to
Page 59
3.4.10.6 :BUS<n>:PARallel:SOURce
Syntax
Command System
:BUS<n>:PARallel:SOURce <
n
:BUS<
>:PARallel:SOURce?
src
>
Description
Sets or queries the channel source of the currently selected data bit.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<src> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
Related to the
selected bit
CHANnel4}
Remarks
• Only when the bus source is set to User (
BUS<n>:PARallel:BUS USER
), can this
command be valid.
• Before sending this command, send the
select the desired data bit.
• D0-D15 are only available for the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:PARallel:SOURce CHANnel2 /*Sets the channel source of the
current bit to CHANnel2.*/
:BUS1:PARallel:SOURce? /*The query returns CHAN2.*/
3.4.10.7 :BUS<n>:PARallel:ENDian
Syntax
:BUS <n>:PARallel:ENDian <
endian
:BUS<n>:PARallel:BITX
command to
>
n
:BUS <
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
>:PARallel:ENDian?
Guide
37
Page 60
Command System
Description
Sets or queries the endian of Parallel decoding on the specified decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<endian> Discrete {MSB|LSB} MSB
Remarks
• MSB: indicates Most Significant Bit transmission sequence, i.g. the highest bit
• LSB: indicates Least Significant Bit transmission sequence, i.g. the lowest bit of
of the data is transmitted first.
the data is transmitted first.
Return Format
The query returns MSB or LSB.
Example
:BUS1:PARallel:ENDian LSB /*Sets the endian of Parallel decoding
to LSB.*/
:BUS1:PARallel:ENDian? /*The query returns LSB.*/
3.4.10.8 :BUS<n>:PARallel:POLarity
Syntax
:BUS<n>:PARallel:POLarity <
n
:BUS<
>:PARallel:POLarity?
Description
Sets or queries the data polarity of Parallel decoding.
pol
>
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<pol> Discrete {NEGative|POSitive} POSitive
Remarks
• NEGative: indicates negative polarity.
DHO800/DHO900 Programming
Guide
38
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 61
• POSitive: indicates positive polarity.
Return Format
The query returns NEG or POS.
Example
:BUS1:PARallel:POLarity NEGative /*Sets the data polarity of
Parallel decoding to Negative.*/
:BUS1:PARallel:POLarity? /*The query returns NEG.*/
3.4.11 :BUS<n>:RS232
The :BUS<n>:RS232 commands are used to set relevant parameters for RS232
decoding.
RS232 serial bus consists of the transmitting data line (TX) and the receiving data line
(RX).
Command System
Figure 3.2 Schematic Diagram of RS232 Serial Bus
In RS232, baud rate is used to represent the transmission rate (namely bits per
second) of the data. In RS232, you need to set the start bit, data bits, check bit
(optional), and stop bit for each frame of data.
• Start Bit: indicates when to output data.
• Data Bits: indicates the number of data bits actually contained in each frame of
data.
• Check Bit: used to check whether the data are properly transmitted.
• Stop Bit: indicates when to stop outputting data.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
39
Page 62
Command System
3.4.11.1 :BUS<n>:RS232:TX
Syntax
:BUS<n>:RS232:TX <
n
:BUS<
>:RS232:TX?
source
>
Description
Sets or queries the Tx source of RS232 decoding on the specific bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4|OFF}
Remarks
The Tx and Rx sources cannot be set to OFF at the same time. The Rx source can be
set by using the
:BUS<n>:RS232:RX
command.
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:RS232:TX CHANnel2 /*Sets the Tx source of RS232 decoding
to CHANnel2.*/
:BUS1:RS232:TX? /*The query returns CHAN2.*/
3.4.11.2 :BUS<n>:RS232:RX
Syntax
:BUS<n>:RS232:RX <
n
:BUS<
>:RS232:RX?
Description
Sets or queries the Rx source of RS232 decoding on the specific bus.
source
>
DHO800/DHO900 Programming
Guide
40
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 63
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
OFF
CHANnel4|OFF}
Remarks
The Tx and Rx sources cannot be set to OFF at the same time. The Tx source can be
set by using the
:BUS<n>:RS232:TX
command.
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:RS232:RX CHANnel2 /*Sets the Rx source of RS232 decoding
to CHANnel2.*/
:BUS1:RS232:RX? /*The query returns CHAN2.*/
3.4.11.3 :BUS<n>:RS232:POLarity
Syntax
:BUS<n>:RS232:POLarity <
n
:BUS<
>:RS232:POLarity?
Description
Sets or queries the polarity of RS232 decoding on the specified bus.
Parameter
Name Type Range Default
pol
>
<n> Discrete {1|2|3|4} -
<pol> Discrete {POSitive|NEGative} NEGative
Remarks
• POSitive: indicates positive polarity. High level is logic "1" and low level is logic
"0".
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
41
Page 64
Command System
• NEGative: indicates negative polarity. High level is logic "0" and low level is
logic "1".
Return Format
The query returns POS or NEG.
Example
:BUS1:RS232:POLarity POSitive /*Sets the polarity of RS232
decoding to POSitive.*/
:BUS1:RS232:POLarity? /*The query returns POS.*/
3.4.11.4 :BUS<n>:RS232:PARity
Syntax
:BUS<n>:RS232:PARity <
n
:BUS<
>:RS232:PARity?
parity
>
Description
Sets or queries the odd-even check mode of data transmission in RS232 decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<parity> Discrete {NONE|ODD|EVEN} NONE
Remarks
• None: indicates that there is no parity bit in data transmission.
• ODD: indicates the odd parity bit. The total count of occurrences of 1 in the
data bit and check bit is an odd number. For example, if 0x55 (01010101) is
transmitted, 1 shall be added to the check bit.
• Even: indicates the even parity bit. The total count of occurrences of 1 in the
data bit and check bit is an even number. For example, if 0x55 (01010101) is
transmitted, 0 shall be added to the check bit.
Return Format
The query returns NONE, ODD, or EVEN.
DHO800/DHO900 Programming
Guide
42
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 65
Example
:BUS1:RS232:PARity ODD /*Sets the odd-even check mode of
data transmission in RS232 decoding to ODD.*/
:BUS1:RS232:PARity? /*The query returns ODD.*/
3.4.11.5 :BUS<n>:RS232:ENDian
Syntax
Command System
:BUS<n>:RS232:ENDian <
n
:BUS<
>:RS232:ENDian?
endian
>
Description
Sets or queries the endian of data transmission in RS232 decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<endian> Discrete {MSB|LSB} LSB
Remarks
• LSB: indicates Least Significant Bit transmission sequence, that is, the lowest bit
of the data is transmitted first.
• MSB: indicates Most Significant Bit transmission sequence, that is, the highest
bit of the data is transmitted first.
Return Format
The query returns LSB or MSB.
Example
:BUS1:RS232:ENDian MSB /*Sets the transmission order of
RS232 decoding to MSB.*/
:BUS1:RS232:ENDian? /*The query returns MSB.*/
3.4.11.6 :BUS<n>:RS232:BAUD
Syntax
:BUS<n>:RS232:BAUD <
n
:BUS<
>:RS232:BAUD?
baud
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
43
Page 66
Command System
Description
Sets or queries the baud rate of data transmission in RS232 decoding. The default
unit is bps.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<baud> Integer 1bps to 20Mbps 9600 bps
Remarks
If the baud rate is set to a value with "M", then "A" should be added at the end of
the value. For example, if you send 5M, you need to send 5MA.
Return Format
The query returns an integer ranging from 1 to 20M.
Example
:BUS1:RS232:BAUD 4800 /*Sets the baud rate of data
transmission in RS232 decoding to 4800 bps.*/
:BUS1:RS232:BAUD? /*The query returns 4800.*/
3.4.11.7 :BUS<n>:RS232:DBITs
Syntax
:BUS<n>:RS232:DBITs <
n
:BUS<
>:RS232:DBITs?
Description
Sets or queries the data width of RS232 decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
bits
>
<bits> Discrete {5|6|7|8|9} 8
Remarks
N/A
Return Format
The query returns 5, 6, 7, 8, or 9.
DHO800/DHO900 Programming
Guide
44
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 67
Example
:BUS1:RS232:DBITs 7 /*Sets the data width of RS232 decoding to
7.*/
:BUS1:RS232:DBITs? /*The query returns 7.*/
3.4.11.8 :BUS<n>:RS232:SBITs
Syntax
Command System
:BUS<n>:RS232:SBITs <
n
:BUS<
>:RS232:SBITs?
stop bits
>
Description
Sets or queries the stop bits of each frame of data in RS232 decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<stop bits> Discrete {1|1.5|2} 1
Remarks
N/A
Return Format
The query returns 1, 1.5, or 2.
Example
:BUS1:RS232:SBITs 2 /*Sets the stop bits of RS232 decoding to
2.*/
:BUS1:RS232:SBITs? /*The query returns 2.*/
3.4.12 :BUS<n>:IIC
The :BUS<n>:IIC commands are used to set relevant parameters for I2C decoding.
I2C serial bus consists of the clock line (SCL) and the data line (SDA).
• SCL: samples SDA on the of rising or falling edge of the clock.
• SDA: indicates the data channel.
SCL
SDA
Figure 3.3 I2C Serial Bus
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
45
Page 68
Command System
3.4.12.1 :BUS<n>:IIC:SCLK:SOURce
Syntax
:BUS<n>:IIC:SCLK:SOURce <
n
:BUS<
>:IIC:SCLK:SOURce?
source
>
Description
Sets or queries the clock source of I2C decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4}
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIC:SCLK:SOURce CHANnel2 /*Sets the clock source of I2C
decoding to CHANnel2.*/
:BUS1:IIC:SCLK:SOURce? /*The query returns CHAN2.*/
3.4.12.2 :BUS<n>:IIC:SDA:SOURce
Syntax
:BUS<n>:IIC:SDA:SOURce <
n
:BUS<
>:IIC:SDA:SOURce?
Description
Sets or queries the data source of the I2C decoding on the specified bus.
Parameter
source
>
Name Type Range Default
<n> Discrete {1|2|3|4} -
DHO800/DHO900 Programming
Guide
46
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 69
Command System
Name Type Range Default
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4}
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:IIC:SDA:SOURce CHANnel2 /*Sets the data source of I2C
decoding to CHANnel2.*/
:BUS1:IIC:SDA:SOURce? /*The query returns CHAN2.*/
3.4.12.3 :BUS<n>:IIC:EXCHange
Syntax
:BUS<n>:IIC:EXCHange <
n
:BUS<
>:IIC:EXCHange?
Description
Sets to exchange the clock channel source and the data channel source of I2C
decoding on the specified bus; queries whether the clock channel source and the
data channel source of I2C decoding on the specified bus have been exchanged.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
bool
>
N/A
Return Format
The query returns 0 or 1.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
47
Page 70
Command System
Example
:BUS1:IIC:EXCHange ON /*Sets to exchange the clock channel source
and the data channel source.*/
:BUS1:IIC:EXCHange? /*The query returns 1.*/
3.4.12.4 :BUS<n>:IIC:ADDRess
Syntax
:BUS<n>:IIC:ADDRess <
n
:BUS<
>:IIC:ADDRess?
addr
>
Description
Sets or queries the address mode of I2C decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<addr> Discrete {NORMal|RW} NORMal
Remarks
• NORMal: indicates that the address width does not include the R/W bit.
• RW: indicates that the address width includes the R/W bit.
Return Format
The query returns NORM or RW.
Example
:BUS1:IIC:ADDRess RW /*Sets the address of I2C decoding to
include the R/W bit.*/
:BUS1:IIC:ADDRess? /*The query returns RW.*/
3.4.13 :BUS<n>:SPI
The :BUS<n>:SPI commands are used to set relevant parameters for SPI decoding.
SPI bus is based on the master-slave configuration and usually consists of chip select
line (CS), clock line (CLK), and data line (SDA). Wherein, the data lines include the
master input/slave output (MISO) data line and master output/slave input (MOSI)
data line. The oscilloscope will sample the channel data on the rising edge, falling
edge, or the rising/falling edge of the clock and judge each data point (logic "1" or
logic "0") according to the preset threshold level).
DHO800/DHO900 Programming
Guide
48
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 71
CLK
MOSI
Master
MISO
CS
3.4.13.1 :BUS<n>:SPI:SCLK:SOURce
Syntax
Command System
Slave
CLK
SDA
(MISO/MOSI)
Figure 3.4 SPI Serial Bus
:BUS<n>:SPI:SCLK:SOURce <
n
:BUS<
>:SPI:SCLK:SOURce?
source
>
Description
Sets or queries the clock source of SPI decoding on the specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4}
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:SPI:SCLK:SOURce CHANnel2 /*Sets the clock source of SPI
decoding to CHANnel2.*/
:BUS1:SPI:SCLK:SOURce? /*The query returns CHAN2.*/
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
49
Page 72
Command System
3.4.13.2 :BUS<n>:SPI:SCLK:SLOPe
Syntax
:BUS<n>:SPI:SCLK:SLOPe <
n
:BUS<
>:SPI:SCLK:SLOPe?
slope
>
Description
Sets or queries the clock edge type of the SPI decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<slope> Discrete {POSitive|NEGative} POSitive
Remarks
N/A
Return Format
The query returns POS or NEG.
Example
:BUS1:SPI:SCLK:SLOPe NEGative /*Sets the clock edge type of SPI
decoding to Negative.*/
:BUS1:SPI:SCLK:SLOPe? /*The query returns NEG.*/
3.4.13.3 :BUS<n>:SPI:MISO:SOURce
Syntax
:BUS<n>:SPI:MISO:SOURce <
n
:BUS<
>:SPI:MISO:SOURce?
Description
Sets or queries the MISO data source of SPI decoding on the specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
source
>
<source> Discrete
DHO800/DHO900 Programming
Guide
50
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel2
CHANnel4|OFF}
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 73
Remarks
Command System
The source specified in this command and the
cannot be set to OFF at the same time.
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Example
:BUS1:SPI:MISO:SOURce CHANnel2 /*Sets the MISO data source of
SPI decoding to CHANnel2.*/
:BUS1:SPI:MISO:SOURce? /*The query returns CHAN2.*/
3.4.13.4 :BUS<n>:SPI:MOSI:SOURce
Syntax
:BUS<n>:SPI:MOSI:SOURce <
n
:BUS<
>:SPI:MOSI:SOURce?
source
:BUS<n>:SPI:MOSI:SOURce
command
>
Description
Sets or queries the MOSI data source of SPI decoding on the specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
OFF
CHANnel4|OFF}
Remarks
The source specified in this command and the
:BUS<n>:SPI:MISO:SOURce
command
cannot be set to OFF at the same time.
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, CHAN4, or OFF.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
51
Page 74
Command System
Example
:BUS1:SPI:MOSI:SOURce CHANnel2 /*Sets the MOSI data source of
SPI decoding to CHANnel2.*/
:BUS1:SPI:MOSI:SOURce? /*The query returns CHAN2.*/
3.4.13.5 :BUS<n>:SPI:POLarity
Syntax
:BUS<n>:SPI:POLarity <
n
:BUS<
>:SPI:POLarity?
polarity
>
Description
Sets or queries the polarity of the SPI decoding on the specified decoding bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<polarity> Discrete {HIGH|LOW} HIGH
Remarks
• HIGH: indicates positive polarity. The high level is 1, and low level is 0.
• LOW: indicates negative polarity. The high level is 0, and low level is 1.
Return Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:POLarity HIGH /*Sets the polarity of the SPI
decoding to Positive.*/
:BUS1:SPI:POLarity? /*The query returns HIGH.*/
3.4.13.6 :BUS<n>:SPI:MISO:POLarity
Syntax
:BUS<n>:SPI:MISO:POLarity <
n
:BUS<
>:SPI:MISO:POLarity?
Description
Sets or queries the polarity of MISO data line of SPI decoding.
polarity
>
DHO800/DHO900 Programming
Guide
52
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 75
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<polarity> Discrete {HIGH|LOW} HIGH
Remarks
• HIGH: positive polarity. It indicates that high level is 1, and low level is 0.
• LOW: negative polarity. It indicates that low level is 1, and high level is 0.
This command exists for backwards compatibility. Use the
command
:BUS<n>:SPI:POLarity
.
Return Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:MISO:POLarity HIGH /*Sets the polarity of MISO data
line to Positive.*/
:BUS1:SPI:MISO:POLarity? /*The query returns HIGH.*/
3.4.13.7 :BUS<n>:SPI:MOSI:POLarity
Syntax
:BUS<n>:SPI:MOSI:POLarity <
n
:BUS<
>:SPI:MOSI:POLarity?
Description
Sets or queries the polarity of MOSI data line of SPI decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
polarity
>
<polarity> Discrete {HIGH|LOW} HIGH
Remarks
• HIGH: positive polarity. It indicates that high level is 1, and low level is 0.
• LOW: negative polarity. It indicates that low level is 1, and high level is 0.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
53
Page 76
Command System
Return Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:MOSI:POLarity HIGH /*Sets the polarity of MOSI data
line to HIGH.*/
:BUS1:SPI:MOSI:POLarity? /*The query returns HIGH.*/
3.4.13.8 :BUS<n>:SPI:DBITs
Syntax
:BUS<n>:SPI:DBITs <
n
:BUS<
>:SPI:DBITs?
width
>
Description
Sets or queries the data width of SPI decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<width> Integer 4 to 32 8
Remarks
N/A
Return Format
The query returns an integer ranging from 4 to 32.
Example
:BUS1:SPI:DBITs 10 /*Sets the data width of SPI decoding to
10.*/
:BUS1:SPI:DBITs? /*The query returns 10.*/
3.4.13.9 :BUS<n>:SPI:ENDian
Syntax
:BUS<n>:SPI:ENDian <
n
:BUS<
>:SPI:ENDian?
Description
Sets or queries the endian of data transmission in SPI decoding.
DHO800/DHO900 Programming
Guide
54
endian
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 77
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<endian> Discrete {MSB|LSB} MSB
Remarks
• MSB: indicates Most Significant Bit transmission sequence, that is, the highest
bit of the data is transmitted first.
• LSB: indicates Least Significant Bit transmission sequence, that is, the lowest bit
of the data is transmitted first.
Return Format
The query returns MSB or LSB.
Example
:BUS1:SPI:ENDian LSB /*Sets the endian of data transmission
in SPI decoding to LSB.*/
:BUS1:SPI:ENDian? /*The query returns LSB.*/
3.4.13.10 :BUS<n>:SPI:MODE
Syntax
:BUS<n>:SPI:MODE <
n
:BUS<
>:SPI:MODE?
Description
Sets or queries the decode mode of SPI decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
mode
>
<mode> Discrete {CS|TIMeout} TIMeout
Remarks
• CS: indicates chip select. It contains a chip select line (CS). You can perform
frame synchronization according to CS.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
55
Page 78
Command System
• TIMeout: indicates timed out. You can perform frame synchronization
according to the timeout.
For DHO800 series, only 4-channel models support CS setting for SPI decoding.
Return Format
The query returns CS or TIM.
Example
:BUS1:SPI:MODE CS /*Sets the decode mode of SPI decoding to CS.*/
:BUS1:SPI:MODE? /*The query returns CS.*/
3.4.13.11 :BUS<n>:SPI:TIMeout:TIME
Syntax
:BUS<n>:SPI:TIMeout:TIME <
n
:BUS<
>:SPI:TIMeout:TIME?
time
>
Description
Sets or queries the timeout value of SPI decoding on the specified bus. The unit is s.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<time> Real 8 ns to 10 s 1μs
Remarks
• This setting command is only valid in timeout mode. You can
send
:BUS<n>:SPI:MODE
to set or query the decode mode of SPI decoding.
• The timeout must be greater than the maximum clock pulse width and less than
the idle time between frames.
Return Format
The query returns the timeout value in scientific notation.
Example
:BUS1:SPI:TIMeout:TIME 0.000005 /*Sets the timeout value to 5
μs.*/
:BUS1:SPI:TIMeout:TIME? /*The query returns
5.000000E-6.*/
DHO800/DHO900 Programming
Guide
56
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 79
3.4.13.12 :BUS<n>:SPI:SS:SOURce
Syntax
Command System
:BUS<n>:SPI:SS:SOURce <
n
:BUS<
>:SPI:SS:SOURce?
source
>
Description
Sets or queries the source of the CS line of SPI decoding on the specified bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel3
CHANnel4}
Remarks
This setting command is only valid in CS mode. You can send
:BUS<n>:SPI:MODE
set or query the decode mode of the SPI decoding.
to
Digital channels (D0 to D15) are only supported by the DHO900 series.
For DHO800 series, only 4-channel models support this command.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:SPI:SS:SOURce CHANnel2 /*Sets the source of CS line of
SPI decoding to CHANnel2.*/
:BUS1:SPI:SS:SOURce? /*The query returns CHAN2.*/
3.4.13.13 :BUS<n>:SPI:SS:POLarity
Syntax
:BUS<n>:SPI:SS:POLarity <
n
:BUS<
>:SPI:SS:POLarity?
Description
polarity
>
Sets or queries the polarity of CS line of SPI decoding on the specified bus.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
57
Page 80
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<polarity> Discrete {HIGH|LOW} LOW
Remarks
• HIGH: indicates that the oscilloscope samples data of the source channel of
• LOW: indicates that the oscilloscope samples data of the source channel of data
data line on the specified edge of the clock signal when the CS signal is high
level.
line on the specified edge of the clock signal when the CS signal is low level.
This setting command is only valid in CS mode. You can send
set or query the decode mode of the SPI decoding.
For DHO800 series, only 4-channel models support this command.
Return Format
The query returns HIGH or LOW.
Example
:BUS1:SPI:SS:POLarity HIGH /*Sets the polarity of CS line of SPI
decoding to HIGH.*/
:BUS1:SPI:SS:POLarity? /*The query returns HIGH.*/
3.4.14 :BUS<n>:CAN
The :BUS<n>:CAN commands are used to set relevant parameters for CAN/CAN-FD
decoding.
The oscilloscope samples the CANsignal in the specified sample position, and judges
each data point to be logic "1" or logic "0" according to the set threshold level. The
CAN/CAN-FD decoding is required to specify the CAN signal type and the sample
position.
:BUS<n>:SPI:MODE
to
Sample Position
Sample position is a point within a bit's time. The oscilloscope samples the bit level at
this point. The sample point position is expressed as the ratio of "time from the bit
start to the sample point" to "bit time", in %.
DHO800/DHO900 Programming
Guide
58
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 81
3.4.14.1 :BUS<n>:CAN:SOURce
Syntax
Command System
One Bit
60%
70%
80%
Figure 3.5 Sample Position
:BUS<n>:CAN:SOURce <
n
:BUS<
>:CAN:SOURce?
source
>
Description
Sets or queries the source of CAN decoding on the specific bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4}
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returnsD0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:CAN:SOURce CHANnel2 /*Sets the source of CAN decoding on
Bus1 to CHANnel2.*/
:BUS1:CAN:SOURce? /*The query returns CHAN2.*/
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
59
Page 82
Command System
3.4.14.2 :BUS<n>:CAN:STYPe
Syntax
:BUS<n>:CAN:STYPe <
n
:BUS<
>:CAN:STYPe?
stype
>
Description
Sets or queries the signal type of CAN decoding.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<stype> Discrete {TX|RX|CANH|CANL|DIFFerential} CANL
Remarks
• TX: indicates the Transmit signal from the CAN bus transceiver.
• RX: indicates the Receive signal from the CAN bus transceiver.
• CANH: indicates the actual CAN_H differential bus signal.
• CANL: indicates the actual CAN_L differential bus signal.
• DIFFerential: indicates the CAN differential bus signal connected to an analog
channel by using a differential probe. Connect the differential probe's positive
lead to the CAN_H bus signal and connect the negative lead to the CAN_L bus
signal.
Return Format
The query returns TX, RX, CANH, CANL, or DIFF.
Example
:BUS1:CAN:STYPe TX /*Sets the signal type of CAN decoding
to TX.*/
:BUS1:CAN:STYPe? /*The query returns TX.*/
3.4.14.3 :BUS<n>:CAN:BAUD
Syntax
:BUS<n>:CAN:BAUD <
n
:BUS<
DHO800/DHO900 Programming
Guide
60
>:CAN:BAUD?
baud
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 83
Command System
Description
Sets or queries the signal rate of CAN decoding on the specified decoding bus. The
unit is bps.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<baud> Integer 10 kbps to 5 Mbps 1 Mbps
Remarks
If the baud rate is set to a value with "M", then "A" should be added at the end of
the value. For example, if you send 5M, you need to send 5MA.
Return Format
The query returns an integer ranging from 10k to 5M.
Example
:BUS1:CAN:BAUD 120000 /*Sets the signal rate of CAN decoding to
120000 bps*/
:BUS1:CAN:BAUD? /*The query returns 120000.*/
3.4.14.4 :BUS<n>:CAN:SPOint
Syntax
:BUS<n>:CAN:SPOint <
n
:BUS<
>:CAN:SPOint?
Description
Sets or queries the sample point position of CAN decoding on the specified bus
(expressed in %).
Parameter
Name Type Range Default
spoint
>
<n> Discrete {1|2|3|4} -
<spoint> Integer 10 to 90 50
Remarks
For detailed information about sample point position, refer to
Sample Position
.
Return Format
The query returns an integer ranging from 10 to 90.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
61
Page 84
Command System
Example
:BUS1:CAN:SPOint 70 /*Sets the sample point position of CAN
decoding to 70%.*/
:BUS1:CAN:SPOint? /*The query returns 70.*/
3.4.15 :BUS<n>:LIN
The :BUS<n>:LIN commands are used to set relevant parameters for LIN decoding.
The oscilloscope samples the LIN signal at the specified sample position (if the source
is an analog channel, the oscilloscope will also judge each data point (logic "1" or
logic "0") according to the preset threshold level). You need to specify the LIN signal
protocol version.
NOTE
Only the DHO900 series oscilloscope supports :BUS<n>:LIN commands.
3.4.15.1 :BUS<n>:LIN:PARity
Syntax
:BUS<n>:LIN:PARity <
n
:BUS<
>:LIN:PARity?
Description
Sets or queries whether the LIN decoding on the specified decoding bus includes
the parity bit.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
bool
>
• 1|ON: includes the parity bit.
• 0|OFF: does not include the parity bit.
Return Format
The query returns 0 or 1.
DHO800/DHO900 Programming
Guide
62
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 85
Example
:BUS1:LIN:PARity ON /*Sets the parity bit to be
included in LIN decoding.*/
:BUS1:LIN:PARity? /*The query returns 1.*/
3.4.15.2 :BUS<n>:LIN:SOURce
Syntax
Command System
:BUS<n>:LIN:SOURce <
n
:BUS<
>:LIN:SOURce?
source
>
Description
Sets or queries the source of LIN decoding on the specific bus.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{D0|D1|D2|D3|D4|D5|D6|D7|D8|
<source> Discrete
D9|D10|D11|D12|D13|D14|D15|
CHANnel1|CHANnel2|CHANnel3|
CHANnel1
CHANnel4}
Remarks
Digital channels (D0 to D15) are only supported by the DHO900 series.
Return Format
The query returns D0, D1, D2, D3, D4, D5, D6, D7, D8, D9, D10, D11, D12, D13, D14,
D15, CHAN1, CHAN2, CHAN3, or CHAN4.
Example
:BUS1:LIN:SOURce CHANnel2 /*Sets the source of LIN decoding to
CHANnel2.*/
:BUS1:LIN:SOURce? /*The query returns CHAN2.*/
3.4.15.3 :BUS<n>:LIN:STANdard
Syntax
:BUS<n>:LIN:STANdard <
n
:BUS<
>:LIN:STANdard?
Description
Sets or queries the version of LIN bus.
value
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
63
Page 86
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<value> Discrete {V1X|V2X|MIXed} MIXed
Remarks
N/A
Return Format
The query returns V1X, V2X, or MIX.
Example
:BUS1:LIN:STANdard V2X /*Sets the LIN bus version to
V2X.*/
:BUS1:LIN:STANdard? /*The query returns V2X.*/
3.5 :BODeplot Commands
The :BODeplot commands are used to set the relevant parameters of the bode plot
function.
A Bode plot is a graph that maps the frequency response of the system. Through the
analysis on the gain margin and phase margin of the system, you can determine the
stability of the system.
With the built-in signal generator module, the series generates the sweep signal of a
specified frequency range and outputs to the switching power supply circuit under
test. Then, the oscilloscope draws a Bode plot displaying the variation of phase and
gain with different frequencies.
NOTE
These commands are only available for DHO914S and DHO924S models.
3.5.1 :BODeplot:ENABle
Syntax
:BODeplot:ENABle <
:BODeplot:ENABle?
Description
Sets or queries the on/off status of the bode plot.
DHO800/DHO900 Programming
Guide
64
bool
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 87
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
N/A
Return Format
The query returns 1 or 0.
Examples
:BODeplot:ENABle ON /*Enables the bode plot.*/
:BODeplot:ENABle? /*The query returns 1.*/
3.5.2 :BODeplot:RUNStop
Command System
Syntax
:BODeplot:RUNStop <
:BODeplot:RUNStop?
Description
Sets or queries the run/stops status of the bode plot.
Parameter
Name Type Range Default
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
N/A
Return Format
The query returns 1 or 0.
Example
bool
>
:BODeplot:RUNStop ON /*Starts the bode plot drawing.*/
:BODeplot:RUNStop? /*The query returns 1.*/
3.5.3 :BODeplot:SWEeptype
Syntax
:BODeplot:SWEeptype <
:BODeplot:SWEeptype?
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
type
>
Guide
65
Page 88
Command System
Description
Sets or queries the sweep type of the bode plot.
Parameter
Name Type Range Default
<type> Discrete {LOG|LINE} LOG
Remarks
• LOG: logarithmic sweep, indicating that the frequency of the swept sine wave
• LINE: linear sweep, indicating that the frequency of the swept sine wave varies
varies logarithmically with the time.
linearly with the time.
Return Format
The query returns LOG or LINE.
Example
:BODeplot:SWEeptype LINE /*Sets the sweep type of the bode plot
to Linear.*/
:BODeplot:SWEeptype? /*The query returns LINE.*/
3.5.4 :BODeplot:REF:IN
Syntax
:BODeplot:REF:IN <
:BODeplot:REF:IN?
Description
Sets or queries the input source of the bode plot.
Parameter
Name Type Range Default
source
>
<source> Discrete
Remarks
N/A
Return Format
The query returns CHANnel1, CHANnel2, CHANnel3, or CHANnel4.
DHO800/DHO900 Programming
Guide
66
{CHANnel1|CHANnel2|
CHANnel3|CHANnel4}
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
CHANnel1
Page 89
Example
:BODeplot:REF:IN CHANnel1 /*Sets the input source of the bode plot
to CH1.*/
:BODeplot:REF:IN? /*The query returns CHANnel1.*/
3.5.5 :BODeplot:REF:OUT
Syntax
Command System
:BODeplot:REF:OUT <
:BODeplot:REF:OUT?
Description
Sets or queries the output source of the bode plot.
Parameter
Name Type Range Default
<source> Discrete
Remarks
N/A
Return Format
The query returns CHANnel1, CHANnel2, CHANnel3, or CHANnel4.
Example
source
>
{CHANnel1|CHANnel2|
CHANnel3|CHANnel4}
CHANnel1
:BODeplot:REF:OUT CHANnel1 /*Sets the output source of the bode
plot to CH1.*/
:BODeplot:REF:OUT? /*The query returns CHANnel1.*/
3.5.6 :BODeplot:STARt
Syntax
:BODeplot:STARt <
:BODeplot:STARt?
Description
Sets or queries the start frequency of the sweep signal in the bode plot. The default
unit is Hz.
Parameter
Name Type Range Default
<freq> Real 10 Hz to 24.99 MHz 100 Hz
freq
>
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
67
Page 90
Command System
Remarks
The start frequency that you set shall be smaller than the stop frequency.
To set or query the stop frequency of the sweep signal, run the
command.
Return Format
The query returns the start frequency value in scientific notation. The unit is Hz.
Example
:BODeplot:STARt 100 /*Sets the start frequency of the sweep
signal to 100 Hz.*/
:BODeplot:STARt? /*The query returns 1.000000E+2.*/
3.5.7 :BODeplot:STOP
Syntax
:BODeplot:STOP <
:BODeplot:STOP?
Description
Sets or queries the stop frequency of the sweep signal in the bode plot. The default
unit is Hz.
freq
:BODeplot:STOP
>
Parameter
Name Type Range Default
<freq> Real 100 Hz to 25 MHz 1 MHz
Remarks
The stop frequency that you set shall be greater than the start frequency.
To set or query the start frequency of the sweep signal, run the
:BODeplot:STARt
command.
Return Format
The query returns the stop frequency in scientific notation. The unit is Hz.
Example
:BODeplot:STOP 500 /*Sets the stop frequency of the sweep
signal to 500 Hz.*/
:BODeplot:STOP? /*The query returns 5.000000E+2.*/
DHO800/DHO900 Programming
Guide
68
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 91
3.5.8 :BODeplot:POINts
Syntax
Command System
:BODeplot:POINts <
:BODeplot:POINts?
Description
Sets or queries the number of sweep points per decade.
Parameter
Name Type Range Default
<num> Integer 10 to 300 10
Remarks
N/A
Return Format
The query returns the number of sweep points per decade in integer.
Example
:BODeplot:POINts 20 /*Sets the number of the sweep points per
decade to 20.*/
:BODeplot:POINts? /*The query returns 20.*/
num
>
3.5.9 :BODeplot:VOLTage
Syntax
:BODeplot:VOLTage <
:BODeplot:VOLTage? <
Description
Sets or queries the variable amplitude of the sweep signal in the specified frequency
range in the bode plot. The default unit of voltage is V, and the default frequency unit
is Hz.
Parameter
Name Type Range Default
<amp> Real Refer to
<range> Discrete
range
range
>,<
>
amp
>
Remarks
{ALL|10|100|1K|10K|100K|1M|
10M|25M|1000|10000|100000|
1000000|10000000|25000000|
200 mV
-
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
69
Page 92
Command System
Name Type Range Default
Remarks
The range of <amp> is 20 mV to 5 V
• When <range> is set to ALL: sets a unified voltage amplitude for the sweep
• When <range> is set to other values other than ALL: sets a voltage amplitude for
Return Format
1e1|1e2|1e3|1e4|1e5|1e6|1e7|
2.5e7}
signal in all the frequency ranges, with the voltage amplitude invariable.
the specified range, with the voltage amplitude variable.
The query returns the voltage amplitude of the sweep signal for the specified output
frequency range in real number. The unit is V.
Example
:BODeplot:VOLTage 100,0.3 /*Sets the voltage amplitude of the
signal whose frequency range is greater than 100 Hz to 300 mV.*/
:BODeplot:VOLTage? 100 /*The query returns 0.300000.*/
3.6 :CHANnel<n> Commands
The :CHANnel<n> commands are used to set or query the bandwidth limit, coupling,
vertical scale, vertical offset, and other vertical system parameters of the analog
channel.
• Setting the bandwidth limit can reduce the noises in the displayed waveforms.
For example, the signal under test is a pulse with high frequency oscillation.
When the bandwidth limit is turned off, the high frequency components of the
signal under test can pass the channel. When the bandwidth limit is turned on,
the high frequency components found in the signal under test that are greater
than the limit are attenuated.
• You can remove unwanted signals by setting the coupling mode. For example,
the signal under test is a square waveform with DC offset. AC coupling mode can
block the DC components.
DHO800/DHO900 Programming
Guide
70
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 93
Command System
• When you use an oscilloscope to make actual measurements, a small offset that
arises from the temperature drift of the component or external environment
disturbance may occur on the zero-cross voltage of the channel, which will affect
the measurement results of the vertical parameters. This series oscilloscope
allows you to set an offset calibration voltage for calibrating the zero point of
the corresponding channel so as to improve the accuracy of the measurement
results.
• When the fine adjustment is enabled, you can further adjust the vertical scale
within a relatively smaller range to improve vertical resolution, making it easier
to view waveform details.
3.6.1 :CHANnel<n>:BWLimit
Syntax
:CHANnel<n>:BWLimit <
n
:CHANnel<
>:BWLimit?
Description
Sets or queries the bandwidth limit of the specified channel.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<val> Discrete Refer to
Remarks
This series oscilloscope supports the 20 MHz bandwidth limit.
val
>
Remarks
OFF
When set to OFF, the bandwidth limit is disabled.
Return Format
The query returns 20M or OFF.
Example
:CHANnel1:BWLimit 20M /*Enables the 20MHz bandwidth limit.*/
:CHANnel1:BWLimit? /*The query returns 20M.*/
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
71
Page 94
Command System
3.6.2 :CHANnel<n>:COUPling
Syntax
:CHANnel<n>:COUPling <
n
:CHANnel<
Description
Sets or queries the coupling mode of the specified channel.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<coupling> Discrete {AC|DC|GND} DC
Remarks
• AC: the DC components of the signal under test are blocked.
• DC: both DC and AC components of the signal under test can pass through the
channel.
>:COUPling?
coupling
>
• GND: both DC and AC components of the signal under test are blocked.
Return Format
The query returns AC, DC, or GND.
Example
:CHANnel1:COUPling AC /*Sets the coupling mode to AC.*/
:CHANnel1:COUPling? /*The query returns AC.*/
3.6.3 :CHANnel<n>:DISPlay
Syntax
:CHANnel<n>:DISPlay <
n
:CHANnel<
Description
Enables or disables the specified channel; or queries the on/off status of the specified
channel.
>:DISPlay?
bool
>
DHO800/DHO900 Programming
Guide
72
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 95
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 1|ON
Remarks
N/A
Return Format
The query returns 1 or 0.
Example
:CHANnel1:DISPlay ON /*Enables CHANnel1.*/
:CHANnel1:DISPlay? /*The query returns 1.*/
3.6.4 :CHANnel<n>:INVert
Syntax
:CHANnel<n>:INVert <
n
:CHANnel<
>:INVert?
Description
Turns on or off the waveform invert for the specified channel; or queries the on/off
status of the waveform invert for the specified channel.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} 0|OFF
Remarks
When the waveform invert is turned off, the waveform is displayed normally; when
the waveform invert is turned on, the voltage values of the displayed waveform are
inverted.
bool
>
Return Format
The query returns 1 or 0.
Example
:CHANnel1:INVert ON /*Enables the waveform invert for CH1.*/
:CHANnel1:INVert? /*The query returns 1.*/
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
73
Page 96
Command System
3.6.5 :CHANnel<n>:OFFSet
Syntax
:CHANnel<n>:OFFSet <
n
:CHANnel<
Description
Sets or queries the vertical offset of the specified channel. The default unit is V.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<offset> Real Refer to
Remarks
The range of the vertical offset of the specified channel is related to the its current
vertical scale.
• ±0.5 V (<500 μV/div)
• ±1 V (≥500 μV/div, ≤65 mV/div)
>:OFFSet?
offset
>
Remarks
0 V
• ±8 V (≥65.01 mV/div, ≤260 mV/div)
• ±20 V (≥260.01 mV/div, ≤2.65 V/div)
• ±100 V (≥2.6501 V/div, ≤10 V/div)
You can send the
the specified channel.
Return Format
The query returns the vertical offset in scientific notation.
Example
:CHANnel1:OFFSet 0.01 /*Sets the vertical offset of CH1 to 10
mV.*/
:CHANnel1:OFFSet? /*The query returns 1.000000E-02.*/
:CHANnel<n>:SCALe
3.6.6 :CHANnel<n>:TCALibrate
Syntax
:CHANnel<n>:TCALibrate <
val
>
command to set or query the vertical scale of
:CHANnel<
DHO800/DHO900 Programming
Guide
74
n
>:TCALibrate?
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 97
Command System
Description
Sets or queries the delay calibration time (used to calibrate the zero offset of the
corresponding channel) of the specified channel. The unit is s.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<val> Real -100 ns to 100 ns 0 s
Remarks
When the horizontal time base is greater than 10 μs, the parameter <val> cannot be
set.
Return Format
The query returns the delay calibration time in scientific notation.
Example
:CHANnel1:TCALibrate 0.00000002 /*Sets the delay calibration time
to 20 ns.*/
:CHANnel1:TCALibrate? /*The query returns 2.000000E-8.*/
3.6.7 :CHANnel<n>:SCALe
Syntax
:CHANnel<n>:SCALe <
n
:CHANnel<
>:SCALe?
Description
Sets or queries the vertical scale of the specified channel. Its default unit is V/div.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
scale
>
<scale> Real Refer to
Remarks
50 mV
Remarks
The range of the vertical scale of the channel is related to probe ratio, .
• For the DHO800 series, when the probe ratio is 1X, the range of <scale> is from
500 μV/div to 10 V/div.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
Guide
75
Page 98
Command System
• For the DHO900 series, when the probe ratio is 1X, the range of <scale> is from
200 μV/div to 10 V/div.
You can send the
:CHANnel<n>:PROBe
specified analog channel.
Return Format
The query returns the vertical scale in scientific notation. The unit is V/div.
Example
:CHANnel1:SCALe 0.1/*Sets the vertical scale of CH1 to 0.1 V/div.*/
:CHANnel1:SCALe? /*The query returns 1.000000E-01.*/
3.6.8 :CHANnel<n>:PROBe
Syntax
:CHANnel<n>:PROBe <
n
:CHANnel<
>:PROBe?
Description
Sets or queries the probe ratio of the specified analog channel.
atten
>
to set or query the probe ratio of the
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
{0.001|0.002|0.005|0.01|0.02|
<atten> Discrete
0.05|0.1|0.2|0.5|1|2|5|10|20|50|
100|200|500|1000|2000|5000|
1
10000|20000|50000}
Remarks
• Display amplitude of the signal under test = Actual amplitude of the signal
under test x Probe ratio(Probe ratio does not affect the actual amplitude of the
signal)
• The set probe ratio affects the value and settable range of the current vertical
scale. To query the vertical scale, run the
:CHANnel<n>:SCALe
command.
DHO800/DHO900 Programming
Guide
76
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Page 99
Return Format
The query returns0.001, 0.002, 0.005, 0.01, 0.02, 0.05, 0.1, 0.2, 0.5, 1, 2, 5, 10, 20, 50,
100, 200, 500, 1000, 2000, 5000, 10000, 20000, or 50000.
Example
:CHANnel1:PROBe 10 /*Sets the probe attenuation ratio of CH1 to
10X.*/
:CHANnel1:PROBe? /*The query returns 10.*/
3.6.9 :CHANnel<n>:LABel:SHOW
Syntax
Command System
:CHANnel<n>:LABel:SHOW <
n
:CHANnel<
Description
Sets or queries whether to display the label of the specified channel.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<bool> Bool {{1|ON}|{0|OFF}} -
Remarks
N/A
Return Format
The query returns 1 or 0.
>:LABel:SHOW?
bool
>
Example
:CHANnel1:LABel:SHOW ON /*Displays the label of the
specified channel.*/
:CHANnel1:LABel:SHOW? /*The query returns 1.*/
3.6.10 :CHANnel<n>:LABel:CONTent
Syntax
:CHANnel<n>:LABel:CONTent <
n
:CHANnel<
Description
Sets or queries the label of the specified channel.
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved. DHO800/DHO900 Programming
>:LABel:CONTent?
str
>
Guide
77
Page 100
Command System
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<str> ASCII String
Remarks
N/A
Return Format
The query returns the label of the specified channel in strings.
Example
The label can contain English
letters and numbers, as well as
some symbols.
-
:CHANnel1:LABel:CONTent ch1 /*Sets the label of Channel 1 to
ch1.*/
:CHANnel1:LABel:CONTent? /*The query returns ch1.*/
3.6.11 :CHANnel<n>:UNITs
Syntax
:CHANnel<n>:UNITs <
n
:CHANnel<
>:UNITs?
Description
Sets or queries the amplitude display unit of the specified analog channel.
Parameter
Name Type Range Default
<n> Discrete {1|2|3|4} -
<units> Discrete
units
>
{WATT|AMPere|VOLTage|
UNKNown}
VOLTage
Remarks
N/A
Return Format
The query returns VOLT, WATT, AMP, or UNKN.
DHO800/DHO900 Programming
Guide
78
Copyright ©RIGOL TECHNOLOGIES CO., LTD. All rights reserved.
Loading...