Hantek DSO2000 Series Operating and maintenance manual

SCPI Programmers Manual
DSO2000 Series Digital Storage Oscilloscope

SCPI Programmers Manual
2
Introduction to SCPI commands
SCPI is the abbreviation of Programmable Instrument Standard Commands. It defines a set of standard
syntax and commands for controlling programmable test and measurement instruments. SCPI
commands are ASCII strings that are passed into the instrument through the physical transport layer.
The command consists of a series of keywords, and some also need to include parameters. In the
protocol, the command is specified as the following form: CONFigure. In use, you can either write the
full name or only the abbreviation that contains only uppercase letters. Usually, the feedback of the
instrument to the query command is also an ASCII code.
Command format
Commands usually begin with a colon ":". Keywords are separated by a colon ":", and keywords are
followed by optional parameter settings. A question mark "?" is added after the command line to
indicate that this function is being queried. The command keyword and the first parameter are
separated by a space.
For example:
:ACQuire:TYPE
:ACQuire:TYPE?
ACQuire is the root keyword of the command, and TYPE is the second-level keyword. The command
line starts with a colon ":", and the keywords of each level are separated with a colon ":". indicates a
parameter that can be set. The question mark "?" Indicates a query. Command keyword: ACQuire:
TYPE and parameter are separated by spaces.
In some commands with parameters, multiple parameters are usually separated by a comma ",",
for example:
[:TRACe[<n>]]:DATA:VALue volatile,<points>,<data>
Symbol Description
The following symbols are not sent with the command.
1. Braces {}
The contents of the braces are parameter options. Parameter items are usually separated by a vertical
bar "|". When using a command, you must select one of the parameters.
2. Vertical bar |
Vertical bar is used to separate multiple parameter options. One of the parameters must be selected
when using the command.
3. Square brackets []
The content in square brackets is omissible.
4. Triangle brackets <>
The parameters in the triangle brackets must be replaced with a valid value.
Command abbreviation
All commands are not case sensitive, you can use all uppercase or lowercase. But if you want to
abbreviate, you must enter all capital letters in the command format.

SCPI Programmers Manual
3
For example:
:MEASure:ADISplay? Can be abbreviated to :MEAS:ADIS?

SCPI Programmers Manual
4
Contents
Introduction to SCPI commands ..........................................................................................................2
1. CHANnel<n> Command Subsystem.................................................................................................9
1.1 CHANnel<n>:BWLimit ............................................................................................................9
1.2 CHANnel<n>:COUPling...........................................................................................................9
1.3 CHANnel<n>:DISPlay............................................................................................................10
1.4 CHANnel<n>:INVert .............................................................................................................10
1.5 CHANnel<n>:OFFSet ............................................................................................................10
1.6 CHANnel<n>:SCALe..............................................................................................................11
1.7 CHANnel<n>:PROBe.............................................................................................................11
1.8 CHANnel<n>:VERNier...........................................................................................................11
2. TIMebase Command Subsystem....................................................................................................12
2.1 TIMebase:WINDow:ENABle.................................................................................................12
2.2 TIMebase:WINDow:POSition...............................................................................................12
2.3 TIMebase:WINDow:SCALe...................................................................................................13
2.4 TIMebase:POSition...............................................................................................................13
2.5 TIMebase:SCALe...................................................................................................................13
2.6 TIMebase:RANGe.................................................................................................................13
2.7 TIMebase:MODE ..................................................................................................................13
3. ACQuire Command Subsystem ......................................................................................................14
3.1 ACQuire:POINts....................................................................................................................14
3.2 ACQuire:TYPE .......................................................................................................................14
3.3 ACQuire:SRATe?...................................................................................................................15
3.4 ACQuire:COUNt....................................................................................................................15
4. TRIGger Command Subsystem.......................................................................................................15
4.1 TRIGger:FORCe.....................................................................................................................16
4.2 TRIGger:MODE .....................................................................................................................16
4.3 TRIGger:STATus?..................................................................................................................16
4.4 TRIGger:SWEep ....................................................................................................................17
4.5 TRIGger:HOLDoff..................................................................................................................17
4.6 TRIGger:EDGe.......................................................................................................................17
4.6.1 TRIGger:EDGe:SOURce..............................................................................................17
4.6.2 TRIGger:EDGe:SLOPe ................................................................................................18
4.6.3 TRIGger:EDGe:LEVel..................................................................................................18
4.7 TRIGger:PULSe......................................................................................................................18
4.7.1 TRIGger:PULSe:SOURce.............................................................................................18
4.7.2 TRIGger:PULSe:POLarity............................................................................................18
4.7.3 TRIGger:PULSe:WHEN...............................................................................................19
4.7.4 TRIGger:PULSe:WIDth...............................................................................................19
4.7.5 TRIGger:PULSe:LEVel.................................................................................................19
4.8 TRIGger:SLOPe .....................................................................................................................19

SCPI Programmers Manual
5
4.8.1 TRIGger:SLOPe:SOURce ............................................................................................20
4.8.2 TRIGger:SLOPe:POLarity............................................................................................20
4.8.3 TRIGger:SLOPe:WHEN...............................................................................................20
4.8.4 TRIGger:SLOPe:WIDth...............................................................................................21
4.8.5 TRIGger:SLOPe:ALEVel ..............................................................................................21
4.8.6 TRIGger:SLOPe:BLEVel ..............................................................................................21
4.9 TRIGger:TV ...........................................................................................................................21
4.9.1 TRIGger:TV:SOURce ..................................................................................................22
4.9.2 TRIGger:TV:POLarity..................................................................................................22
4.9.3 TRIGger:TV:MODE.....................................................................................................22
4.9.4 TRIGger:TV:LINE ........................................................................................................22
4.9.5 TRIGger:TV:STANdard ...............................................................................................23
4.9.6 TRIGger:VIDeo:LEVel.................................................................................................23
4.10 TRIGger:TIMeout................................................................................................................23
4.10.1 TRIGger:TIMeout:SOURce.......................................................................................23
4.10.2 TRIGger:TIMeout:LEVel...........................................................................................23
4.10.3 TRIGger:TIMeout:WIDth .........................................................................................24
4.10.4 TRIGger:TIMeout:POLarity......................................................................................24
4.11 TRIGger:WINDOw...............................................................................................................24
4.11.1 TRIGger:WINDOw:SOURce......................................................................................24
4.11.2 TRIGger:WINDOw:ALEVel .......................................................................................24
4.11.3 TRIGger:WINDOw:BLEVel .......................................................................................25
4.12 TRIGger:INTERVAl ..............................................................................................................25
4.12.1 TRIGger:INTERVAl:SOURce .....................................................................................25
4.12.2 TRIGger:INTERVAl:SLOp ..........................................................................................25
4.12.3 TRIGger:INTERVAl:WHEN........................................................................................26
4.12.4 TRIGger:INTERVAl:TIME..........................................................................................26
4.12.5 TRIGger:INTERVAl:ALEVel .......................................................................................26
4.13 TRIGger:UNDER_Am ..........................................................................................................26
4.13.1 TRIGger:UNDER_Am:SOURce .................................................................................27
4.13.2 TRIGger:UNDER_Am:POLarity.................................................................................27
4.13.3 TRIGger:UNDER_Am:WHEN....................................................................................27
4.13.4 TRIGger:UNDER_Am:TIME......................................................................................27
4.13.5 TRIGger:UNDER_Am:ALEVel ...................................................................................27
4.13.6 TRIGger:UNDER_Am:BLEVel ...................................................................................28
4.14 TRIGger:UART.....................................................................................................................28
4.14.1 TRIGger:UART:SOURce............................................................................................28
4.14.2 TRIGger:UART:CONdition........................................................................................28
4.14.3 TRIGger:UART:BAUd ...............................................................................................28
4.14.4 TRIGger:UART:ALEVel .............................................................................................29
4.14.5 TRIGger:UART:DATA ...............................................................................................29
4.14.6 TRIGger:UART:WIDTh .............................................................................................29

SCPI Programmers Manual
6
4.14.7 TRIGger:UART:PARIty..............................................................................................29
4.15 TRIGger:CAN.......................................................................................................................30
4.15.1 TRIGger:CAN:SOURce..............................................................................................30
4.15.2 TRIGger:CAN:IDLe ...................................................................................................30
4.15.3 TRIGger:CAN:BAUd .................................................................................................30
4.15.4 TRIGger:CAN:CONdition..........................................................................................31
4.15.5 TRIGger:CAN:ID.......................................................................................................31
4.15.6 TRIGger:CAN:DLC ....................................................................................................31
4.15.7 TRIGger:CAN:DATA .................................................................................................31
4.15.8 TRIGger:CAN:ALEVel ...............................................................................................31
4.16 TRIGger:LIN ........................................................................................................................32
4.16.1 TRIGger:LIN:SOURce ...............................................................................................32
4.16.2 TRIGger:LIN:IDLe .....................................................................................................32
4.16.3 TRIGger:LIN:BAUd ...................................................................................................32
4.16.4 TRIGger:LIN:CONdition ...........................................................................................33
4.16.5 TRIGger:LIN:ID.........................................................................................................33
4.16.6 TRIGger:LIN:DATA ...................................................................................................33
4.16.7 TRIGger:LIN:ALEVel .................................................................................................33
4.17 TRIGger:IIC..........................................................................................................................33
4.17.1 TRIGger:IIC:SDA:SOURce.........................................................................................34
4.17.2 TRIGger:IIC:SCL:SOURce..........................................................................................34
4.17.3 TRIGger:IIC:CONdition.............................................................................................34
4.17.4 TRIGger:IIC:ADDer...................................................................................................34
4.17.5 TRIGger:IIC:DATA ....................................................................................................35
4.17.6 TRIGger:IIC:ALEVel ..................................................................................................35
4.17.7 TRIGger:IIC:BLEVel ..................................................................................................35
4.18 TRIGger:SPI.........................................................................................................................35
4.18.1 TRIGger:SPI:SDA:SOURce ........................................................................................36
4.18.2 TRIGger:SPI:SCL:SOURce.........................................................................................36
4.18.3 TRIGger:SPI:SCK.......................................................................................................36
4.18.4 TRIGger:SPI:WIDth ..................................................................................................36
4.18.5 TRIGger:SPI:DATA....................................................................................................36
4.18.6 TRIGger:SPI:MASK...................................................................................................37
4.18.7 TRIGger:SPI:ALEVel .................................................................................................37
4.18.8 TRIGger:SPI:BLEVel..................................................................................................37
4.19 TRIGger:PATTern................................................................................................................37
4.19.1 TRIGger:PATTern:PATTern......................................................................................37
4.19.2 :TRIGger:PATTern:LEVel..........................................................................................38
:TRIGger:PATTern:LEVel <chan>,<level>............................................................................38
5. CALibrate Command Subsystem....................................................................................................38
5.1 CALibrate:STARt ...................................................................................................................38
5.2 CALibrate:STATus? ...............................................................................................................39

SCPI Programmers Manual
7
5.3 CALibrate:QUIT.....................................................................................................................39
6. MATH Command Subsystem .........................................................................................................39
6.1 MATH:DISPlay ......................................................................................................................39
6.2 MATH:OPERator...................................................................................................................40
6.3 MATH:SOURce1 ...................................................................................................................40
6.4 MATH:SOURce2 ...................................................................................................................40
6.5 MATH:SCALe ........................................................................................................................40
6.6 MATH:OFFSet.......................................................................................................................41
6.7 MATH:FFT:SOURce...............................................................................................................41
6.8 MATH:FFT:WINDow .............................................................................................................41
6.9 MATH:FFT:UNIT....................................................................................................................41
6.10 MATH:FFT:HSCale ..............................................................................................................41
6.11 MATH:FFT:HCENter............................................................................................................42
7. WAVeform Command Subsystem..................................................................................................42
7.1 WAVeform:DATA:ALL?.........................................................................................................42
8. DISPlay Command Subsystem........................................................................................................43
8.1 DISPlay:TYPE.........................................................................................................................43
8.2 DISPlay:WBRightness ...........................................................................................................43
8.3 DISPlay:GRID ........................................................................................................................44
8.4 DISPlay:GBRightness ............................................................................................................44
9. CURSor Command Subsystem .......................................................................................................44
9.1 CURSor:MODE......................................................................................................................45
9.2 CURSor:MANual:TYPE ..........................................................................................................45
9.3 CURSor:MANual:SOURce .....................................................................................................45
9.4 CURSor:MANual:AX..............................................................................................................46
9.5 CURSor:MANual:AXValue?...................................................................................................46
9.6 CURSor:MANual:AY..............................................................................................................46
9.7 CURSor:MANual:AYValue?...................................................................................................46
9.8 CURSor:MANual:BX..............................................................................................................47
9.9 CURSor:MANual:BXValue?...................................................................................................47
9.10 CURSor:MANual:BY............................................................................................................47
9.11 CURSor:MANual:BYValue?.................................................................................................47
9.12 CURSor:TRACk:SOURcea ....................................................................................................47
9.13 CURSor:TRACk:SOURceb....................................................................................................48
9.14 CURSor:TRACk:AX...............................................................................................................48
9.15 CURSor:TRACk:AXValue? ...................................................................................................48
9.16 CURSor:TRACk:AY?.............................................................................................................48
9.17 CURSor:TRACk:AYValue?....................................................................................................48
9.18 CURSor:TRACk:BX...............................................................................................................49
9.19 CURSor:TRACk:BXValue?....................................................................................................49
9.20 CURSor:TRACk:BY?.............................................................................................................49
9.21 CURSor:TRACk:BYValue?....................................................................................................49

SCPI Programmers Manual
8
10. MEASure Command Subsystem...................................................................................................49
10.1 MEASure:ENABle................................................................................................................50
10.2 MEASure:SOURce...............................................................................................................50
10.3 MEASure:ADISplay .............................................................................................................50
10.4 MEASure: CHANnel<n>:ITEM.............................................................................................50
10.5 MEASure:GATE:ENABle......................................................................................................51
10.6 MEASure:GATE:AY .............................................................................................................51
10.7 MEASUre:GATE:BY .............................................................................................................51
11. MASK Command Subsystem........................................................................................................51
11.1 MASK:EANBle.....................................................................................................................52
11.2 MASK:SOURce....................................................................................................................52
11.3 MASK:MDISplay .................................................................................................................52
11.4 MASK:Output .....................................................................................................................52
11.5 MASK:SOOutput.................................................................................................................53
11.6 MASK:X...............................................................................................................................53
11.7 MASK:Y...............................................................................................................................53
11.8 MASK:CREate .....................................................................................................................53
12. SYSTem Command Subsystem.....................................................................................................53
12.1 SYSTem:GAM?....................................................................................................................54
12.2 SYSTem:RAM?....................................................................................................................54
12.3 SYSTem:PON.......................................................................................................................54
12.4 SYSTem:LANGuage.............................................................................................................54
12.5 SYSTem:LOCKed .................................................................................................................54
12.6 SETUp:ALL?.........................................................................................................................55
13. DDS Command Subsystem...........................................................................................................57
13.1 DDS:SWITch........................................................................................................................57
13.2 DDS:TYPE............................................................................................................................58
13.3 DDS:FREQ ...........................................................................................................................58
13.4 DDS:AMP............................................................................................................................58
13.5 DDS:OFFSet ........................................................................................................................58
13.6 DDS:DUTY...........................................................................................................................58
13.7 DDS:WAVE:MODE ..............................................................................................................59
13.8 DDS:MODE:TYPE ................................................................................................................59
13.9 DDS:MODE:WAVE:TYPE .....................................................................................................59
13.10 DDS:MODE:FREQ..............................................................................................................59
13.11 DDS:MODE:DEPThordeviation.........................................................................................60
13.12 DDS:BURSt:SWITch ..........................................................................................................60
13.13 DDS:BURSt:TYPE...............................................................................................................60
13.14 DDS:BURSt:CNT................................................................................................................60
13.15 DDS:BURSt:TRIGger..........................................................................................................60
13.16 DDS:ARB:DAC16:BIN ........................................................................................................61

SCPI Programmers Manual
9
1. CHANnel<n> Command Subsystem
:CHANnel<n> commands are used to set or query the vertical system parameters such as bandwidth
limit, coupling, vertical scale, and vertical offset of the analog channel of the oscilloscope.
Command List
⚫CHANnel<n>:BWLimit
⚫CHANnel<n>:COUPling
⚫CHANnel<n>:DISPlay
⚫CHANnel<n>:INVert
⚫CHANnel<n>:OFFSet
⚫CHANnel<n>:SCALe
⚫CHANnel<n>:PROBe
⚫CHANnel<n>:VERNier
1.1 CHANnel<n>:BWLimit
Command
:CHANnel<n>:BWLimit <type>
:CHANnel<n>:BWLimit?
Description
Set or query the parameters of bandwidth limit for the indicated channel.
Parameters
:<type>::= {{1 | ON} | {0 | OFF}
:<n>::= {1 | 2 | 3 | 4}
State
▷OFF: Turn off the 20MHz bandwidth limit, and the high-frequency components
contained in the measured signal can pass.
▷ON: Turn on the bandwidth limitation, and the high-frequency components contained in
the signal under test are attenuated.
Turning on bandwidth limiting reduces waveform noise, but attenuates high-frequency
components.
Return
The query returns 0 or 1.
Example
:CHANnel1:BWLimit 1 /*Enable 20MHz bandwidth limit*/
:CHANnel1:BWLimit? /*The query returns 1*/
1.2 CHANnel<n>:COUPling
Command
:CHANnel<n>:COUPling <coupling>
:CHANnel<n>:COUPling?
Description
Set or query the connection of the indicated channel signal.
Parameters
:<coupling> ::= {AC | DC | GND}
:<n>::= {1 | 2 | 3 | 4}
State
▷AC: The DC component of the signal under test is blocked.
▷DC: Both the DC and AC components of the signal under test can pass.
▷GND: Both the DC and AC components of the signal under test are blocked

SCPI Programmers Manual
10
1.3 CHANnel<n>:DISPlay
1.4 CHANnel<n>:INVert
1.5 CHANnel<n>:OFFSet
Return
The query returns AC,DC,GND
Example
:CHANnel1:COUPling AC /*Select AC coupling mode*/
:CHANnel1:COUPling? /*Query returns AC*/
Command
:CHANnel<n>:DISPlay <bool>
:CHANnel<n>:DISPlay?
Description
Turn on or off the specified channel or query the switch status of the specified
channel.
Parameters
:<bool> ::= {{1 | ON} | {0 | OFF}}
:<n>::= {1 | 2 | 3 | 4}
Return
The query returns 0 or 1.
Example
:CHANnel1:DISPlay ON /*Turn on CH1*/
:CHANnel1:DISPlay? /*The query returns 1*/
Command
:CHANnel<n>:INVert <bool>
:CHANnel<n>:INVert?
Description
Turn the waveform inversion of the specified channel on or off or query the switching
status of the waveform inversion of the specified channel.
Parameters
:<bool> ::= {{1 | ON} | {0 | OFF}}
:<n>::= {1 | 2 | 3 | 4}
Return
The query returns 0 or 1.
Example
:CHANnel1:INVert ON /*Turn on the waveform inversion of CH1*/
:CHANnel1:INVert? /*The query returns 1*/
Command
:CHANnel<n>:OFFSet <offset> [<suffix>]
:CHANnel<n>:OFFSet?
Description
Sets or queries the vertical displacement of the specified channel. The default unit is
V.
Parameters
:<offset> ::= Vertical offset value in NR3 format
:<suffix> ::= {V | mV}
:<n>::= {1 | 2 | 3 | 4}
State
▷The set vertical displacement value is affected by the vertical gear and probe ratio.
▷The range of legal values varies with the vertical scale and probe ratio. If 21 / 136
you set an offset outside the legal range, the offset value will be automatically set to
the closest legal value.
Return
The query returns the vertical displacement value in scientific notation.
Example
:CHANnel1:OFFSet 1V /*Set the vertical offset of CH1 to 1V*/
:CHANnel1:OFFSet? /*The query returns 1*/

SCPI Programmers Manual
11
1.6 CHANnel<n>:SCALe
1.7 CHANnel<n>:PROBe
1.8 CHANnel<n>:VERNier
Command
:CHANnel<n>:SCALe <scale> [<suffix>]
:CHANnel<n>:SCALe?
Description
Sets or queries the vertical scale of the specified channel. The default unit is V.
Parameters
:<scale> ::= vertical units per division in NR3 format
:<suffix> ::= {V | mV}
:<n>::= {1 | 2 | 3 | 4}
State
▷CHANnel<n>:SCALe command to setup each channel’s vertical scale.The settable
range of the vertical scale is related to the currently set probe ratio (set by the:
▷CHANnel : PROBe command).
Return
The query returns the vertical scale value in scientific notation.
Example
:CHANnel1:SCALe 1V /*Set the vertical scale to 1V*/
:CHANnel1:SCALe?/*The query returns 1.000e + 00*/
Command
:CHANnel<n>:PROBe <atten>
:CHANnel<n>:PROBe?
Description
Set or query the probe factor of the specified channel.
Parameters
:<atten> ::= {1 | 10 | 100 | 1000}
:<n>::= {1 | 2 | 3 | 4}
State
▷Set the probe factor, which is displayed after multiplying the acquired signal by a
specified multiple (does not affect the actual amplitude of the signal).
▷Setting the probe ratio affects the settable range of the current vertical scale.
Return
The query returns the probe attenuation ratio in scientific notation.
Example
:CHANnel1:PROBe 10 /*Set the probe attenuation ratio to 10X*/
:CHANnel1:PROBe? /*The query returns 1.000000e + 01*/
Command
:CHANnel<n>:VERNier <bool>
:CHANnel<n>:VERNier?
Description
Turn the fine adjustment function of the vertical scale of the specified channel on or
off, or query the status of the fine adjustment function of the vertical scale of the
specified channel.
Parameters
:<bool> ::= {{1 | ON} | {0 | OFF}}
:<n>::= {1 | 2 | 3 | 4}
State
The trim setting is off by default. At this time, you can only set the vertical scale in 1-
2-5 steps, that is, 500u, 1mV, 2mV, 5mV, 10mV ... 10V (probe ratio is 1X). When the
trim setting is on, you can further adjust the vertical scale within a smaller range to
improve vertical resolution. If the amplitude of the input waveform is slightly larger
than the full scale in the current scale, and the amplitude displayed by the waveform
of the next gear is slightly lower, you can use fine adjustment to improve the
waveform display amplitude to facilitate observation of signal details.
Return
The query returns 1 or 0.
Example
:CHANnel1:VERNier ON /*Turn on the fine adjustment function of CH1 vertical

SCPI Programmers Manual
12
2. TIMebase Command Subsystem
Command List
⚫TIMebase:WINDow:ENABle
⚫TIMebase:WINDow:POSition
⚫TIMebase:WINDow:SCALe
⚫TIMebase:POSition
⚫TIMebase:SCALe
⚫TIMebase:RANGe
⚫TIMebase:MODE
2.1 TIMebase:WINDow:ENABle
2.2 TIMebase:WINDow:POSition
scale*/
:CHANnel1:VERNier? /*The query returns 1*/
Command
:TIMebase:WINDow:ENABle <bool>
:TIMebase:WINDow:ENABle?
Description
Turn on or off the dual window function, or query the status of the dual window.
Parameters
:<bool> ::= {{1 | ON} | {0 | OFF}
State
The dual window mode can be used to zoom in a section of the waveform
horizontally in order to view the waveform details.
Return
The query returns ON or Off.
Example
:TIMebase:WINDow:ENABle ON /*Turn on delayed scanning*/
:TIMebase:WINDow:ENABle? /*The query returns 1*/
Command
:TIMebase:WINDow:POSition <pos value>
:TIMebase:WINDow:POSition?
Description
Set or query horizontal position of the zoomed view of the main scan.
Parameters
:<pos value> ::= The value of the horizontal position (in seconds)
State
The main scan range and the horizontal position of the main scan determine the
range of this command. The value of this command must keep the zoomed view
window within the main scan range.
Return
Returns the position of the current horizontal window in the zoomed view in scientific
notation.
Example
:TIMebase:WINDow:POSition 0.001 /*Set the horizontal position to 0.001s*/
:TIMebase:WINDow:POSition? /*The query returns1.000e-03*/

SCPI Programmers Manual
13
2.3 TIMebase:WINDow:SCALe
2.4 TIMebase:POSition
2.5 TIMebase:SCALe
2.6 TIMebase:RANGe
2.7 TIMebase:MODE
Command
:TIMebase:WINDow:SCALe <scale_value>
:TIMebase:WINDow:SCALe?
Description
Set or query the horizontal scale of the sub-window (microseconds/div).
Parameters
:<sacle_value> ::= The current number of microseconds per grid of the subwindow.
State
The main scan scale determines the range of this command, the maximum value is
half of the main scan scale.
Return
Return the time base gear of the sub-window in scientific notation.
Example
:TIMebase:WINDow:SCALe 0.0005 /*Set the delay time base to 500us*/
:TIMebase:WINDow:SCALe? /*The query returns 5.000e-4*/
Command
:TIMebase:POSition <pos value>
:TIMebase:POSition?
Description
Set or query the main time base offset.
Parameters
:<pos value> ::= offset value (in second).
Return
Return the main time base offset value in scientific notation.
Example
:TIMebase:POSition 0.0002 /*Set main time base to 200us*/
:TIMebase:POSition? /*The query returns 2.000e-4*/
Command
:TIMebase:SCALe <scale value>
:TIMebase:SCALe?
Description
Set or query the horizontal scale of the main window (seconds/div).
Parameters
:<scale value> ::= The current number of seconds per grid in the main window
Return
Return to the main window time base gear in scientific notation.
Example
:TIMebase:SCALe 0.0005 /*Set the main time base to 500us*/
:TIMebase:SCALe? /*The query returns 5.000e-4*/
Command
:TIMebase:RANGe <range value>
:TIMebase:RANGe?
Description
Set or query the full-scale horizontal time of the main window.
Parameters
:<range value> ::= range value (in second).
Return
Return the full-scale time base range of the main window in scientific notation.
Example
:TIMebase:RANGe 0.0016 /*Set main time base to100us*/
:TIMebase:RANGe? /*The query returns 1.600e-03*/
Command
:TIMebase:MODE <value>
:TIMebase:MODE?
Description
Sets or queries the horizontal time base mode.

SCPI Programmers Manual
14
3. ACQuire Command Subsystem
Command List
⚫ACQuire:POINts
⚫ACQuire:TYPE
⚫ACQuire:SRATe?
⚫ACQuire:COUNt
3.1 ACQuire:POINts
3.2 ACQuire:TYPE
Parameters
:<value> ::= <MAIN | XY | ROLL>
State
▷MAIN: YT mode
▷XY: XY mode
▷ROLL: ROLL mode
Return
The query returns MAIN, XY, or ROLL.
Example
:TIMebase:MODE XY /*Set the horizontal time base mode to XY mode*/
:TIMebase:MODE? /*The query returns XY*/
Command
:ACQuire:POINts <value>
:ACQuire:POINts?
Description
Set or query the storage depth of the oscilloscope.
Parameters
:<value> ::= memory depth value.
State
value
Memory depth
4000
4K
40000
40K
400000
400K
4000000
4M
8000000
8M
Return
The query returns the actual number of points (integer).
Example
:ACQuire:POINts 4000 /*Set memory depth to 4k*/
:ACQuire:POINts? /*The query returns 4000*/
Command
:ACQuire:TYPE <value>
:ACQuire:TYPE?
Description
Set or query the acquisition method of oscilloscope samples
Parameters
:<value> ::= < NORMal | AVERage | PEAK | HRESolution>
State
▷NORMal (normal): In this mode, the oscilloscope samples the signal at equal
time intervals to reconstruct the waveform. For most waveforms, using this
mode produces the best display results.
▷AVERages: In this mode, the oscilloscope averages waveforms that have been 18 /
136

SCPI Programmers Manual
15
3.3 ACQuire:SRATe?
3.4 ACQuire:COUNt
4. TRIGger Command Subsystem
Command List
⚫TRIGger:FORCe
⚫TRIGger:MODE
⚫TRIGger:STATus?
⚫TRIGger:SWEep
⚫TRIGger:HOLDoff
⚫TRIGger:EDGe
sampled multiple times to reduce random noise on the input signal and
improve vertical resolution. The number of averages can be set by the: ACQuire:
AVERages command. The higher the number of averages, the lower the noise
and the higher the vertical resolution, but the slower the response of the
displayed waveform to waveform changes.
▷PEAK (Peak Detection): In this mode, the oscilloscope collects the maximum
and minimum values of the sampling interval signal to obtain the signal
envelope or narrow pulses that may be lost. Using this mode can avoid aliasing
of the signal, but the display noise is relatively large.
▷HRESolution (high resolution): This mode uses an oversampling technique to
average the neighboring points of the sampled waveform to reduce random
noise on the input signal and produce a smoother waveform on the screen. It is
usually used when the sampling rate of the digitizer is higher than the storage
rate of the acquisition memory.
Return
The query returns NORM, AVERage, PEAK, or HRESolution.
Example
:ACQuire:TYPE AVERage /*Set the acquisition method to average*/
:ACQuire:TYPE? /*The query returns AVERage*/
Command
:ACQuire:SRATe?
Description
Query the current sampling rate.
State
The number of waveform points sampled per second.
Return
The query returns the sample rate as a real number.
Example
:ACQuire:SRATe? /*The query returns 1.25e+06*/
Command
:ACQuire:COUNt <value>
:ACQuire:COUNt?
Description
Set or query the average number of times in the average acquisition mode
Parameters
:<value> ::= <4|8|16|32|64|128>
Return
The query returns current average times.
Example
:ACQuire:COUNt 64 /*Set the average number to 64*/
:ACQuire:COUNt? /*The query returns 64*/

SCPI Programmers Manual
16
⚫TRIGger:PULSe
⚫TRIGger:SLOPe
⚫TRIGger:TV
⚫TRIGger:TIMeout
⚫TRIGger:WINDOw
⚫TRIGger:INTERVAl
⚫TRIGger:UNDER_Am
⚫TRIGger:UART
⚫TRIGger:CAN
⚫TRIGger:LIN
⚫TRIGger:IIC
⚫TRIGger:SPI
⚫TRIGger:PATTern
4.1 TRIGger:FORCe
4.2 TRIGger:MODE
4.3 TRIGger:STATus?
Command
:TRIGger:FORCe
Description
Select or query the force trigger.
State
Even if the trigger conditions are not met, this command will let the oscilloscope
acquire waveforms
Command
:TRIGger:MODE <mode>
:TRIGger:MODE?
Description
Select or query the trigger type.
Parameters
:<mode> ::= < EDGE | PULSe | TV | SLOPe | TIMeout | WINdow | PATTern |
INTerval | UNDerthrow | UART | LIN | CAN | SPI | IIC>
Return
Return EDGE, PULSe, TV, SLOPe, TIMeout, WINdow, PATTern, INTerval,
UNDerthrow, UART, LIN, CAN, SPI, IIC
Example
:TRIGger:MODE SLOPe /*Set the trigger type to slope trigger*/
:TRIGger:MODE? /*The query returns SLOPe*/
Command
:TRIGger:STATus?
Description
Query the current trigger status.
Return
Return TRIGed, NOTRIG

SCPI Programmers Manual
17
4.4 TRIGger:SWEep
4.5 TRIGger:HOLDoff
4.6 TRIGger:EDGe
Command List
⚫TRIGger:EDGe:SOURce
⚫TRIGger:EDGe:SLOPe
⚫TRIGger:EDGe:LEVel
4.6.1 TRIGger:EDGe:SOURce
Command
:TRIGger:SWEep <value>
:TRIGger:SWEep?
Description
Set or query the trigger mode.
Parameters
:<value> ::= < AUTO | NORMal | SINGle>
State
▷AUTO: Automatic triggering, waveform display regardless of whether trigger
conditions are met.
▷NORMal: Normal trigger, display the waveform when the trigger condition is
met, keep the original waveform display when the trigger condition is not met,
and wait for the next trigger.
▷SINGle: Single trigger. The oscilloscope waits for the trigger, displays the
waveform when the trigger conditions are met, and then stops.
Return
The query returns AUTO, NORMal, or SINGle.
Example
:TRIGger:SWEep SINGle /*Select single trigger mode*/
:TRIGger:SWEep? /*The query returns SINGle*/
Command
:TRIGger:HOLDoff <value>
:TRIGger:HOLDoff?
Description
Set or query the holdoff time.
Parameters
:<value> ::= Trigger holdoff time (in second)
State
Trigger holdoff can stably trigger complex waveforms (such as pulse series).
Holdoff time is the time the oscilloscope waits to re-enable the trigger circuit.
The oscilloscope will not trigger until the holdoff time is over.
When the trigger method is video trigger, timeout trigger, setup hold, UART,
LIN, CAN, IIC or SPI, this setting is not available.
Return
The query returns the trigger holdoff time in scientific notation.
Example
:TRIGger:HOLDoff 0.0000002 /*Set trigger holdoff time to 200ns*/
:TRIGger:HOLDoff? /*The query returns 2.000000e-07*/
Command
:TRIGger:EDGe:SOURce <source>
:TRIGger:EDGe:SOURce?
Description
Set or query the trigger source for edge trigger.
Parameters
:<source> ::= < CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4 | EXT/10>
Return
The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4, EXT/10
Example
:TRIGger:EDGe:SOURce CHANnel1 / * Set the trigger source to CH1 * /
:TRIGger:EDGe:SOURce? / * The query returns CHANnel1 * /

SCPI Programmers Manual
18
4.6.2 TRIGger:EDGe:SLOPe
4.6.3 TRIGger:EDGe:LEVel
4.7 TRIGger:PULSe
Command List
⚫TRIGger:PULSe:SOURce
⚫TRIGger:PULSe:POLarity
⚫TRIGger:PULSe:WHEN
⚫TRIGger:PULSe:WIDth
⚫TRIGger:PULSe:LEVel
4.7.1 TRIGger:PULSe:SOURce
4.7.2 TRIGger:PULSe:POLarity
Command
:TRIGger:EDGe:SLOPe <slope>
:TRIGger:EDGe:SLOPe?
Description
Set or query the type of edge trigger.
Parameters
:<slope> ::= < RISIng| FALLing | EITHer >
State
▷RISIng: rising edge
▷FALLing: falling edge
▷EITHer: rising or falling edge
Return
The query returns RISIng, FALLing, EITHer
Example
:TRIGger:EDGe:SLOPe RISIng /*Set the edge type to rising edge*/
:TRIGger:EDGe:SLOPe? /*The query returns RISIng*/
Command
:TRIGger:EDGe:LEVel <level>
:TRIGger:EDGe:LEVel?
Description
Set or query the trigger level when the edge triggers.
Parameters
:<level> ::= trigger level ( unit is V)
Return
The query returns the trigger level value in scientific notation.
Example
:TRIGger:EDGe:LEVel 0.16 /*Set the trigger level to 160mV*/
:TRIGger:EDGe:LEVel? /*The query returns 1.600e-1*/
Command
:TRIGger:PULSe:SOURce <source>
:TRIGger:PULSe:SOURce?
Description
Set or query the trigger source of the pulse width trigger.
Parameters
:<source> ::= < CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4>
Return
The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4
Example
:TRIGger:PULSe:SOURce CHANnel1 /*set trigger source to CH1*/
:TRIGger:PULSe:SOURce? /*The query returns CHANnel1*/
Command
:TRIGger:PULSe:POLarity <polarity>
:TRIGger:PULSe:POLarity?

SCPI Programmers Manual
19
4.7.3 TRIGger:PULSe:WHEN
4.7.4 TRIGger:PULSe:WIDth
4.7.5 TRIGger:PULSe:LEVel
4.8 TRIGger:SLOPe
Command List
Description
Set or query the trigger polarity of pulse width trigger
Parameters
:<polarity> ::= < POSItive | NEGAtive>
State
▷POSItive: Positive pulse trigger
▷NEGAtive: negative pulse trigger
Return
The query returns POSItive, NEGAtive
Example
:TRIGger:PULSe:POLarity POSItive /*Set positive pulse trigger*/
:TRIGger:PULSe:POLarity? /*The query returns POSItive*/
Command
:TRIGger:PULSe:WHEN <when>
:TRIGger:PULSe:WHEN?
Description
Set or query the trigger conditions for pulse width trigger.
Parameters
<when> ::= < EQUAl| NEQUal| GREAt| LESS>
State
▷EQUAl = (equal to time value): Only when the positive or negative pulse width
of the input signal is equal to the set pulse width can it trigger. [Pulse width error is
5%] NEQUal! = (Not equal to time value): Only when the positive or negative pulse
width of the input signal is not equal to the set pulse width, can the [pulse
width error be 5%] be triggered. GREAt ＞(greater than the time value): Only when
the positive or negative pulse width of the input signal is greater than the set pulse
width can it trigger [pulse width error is 5%].
▷LESS <(less than time value): Only when the positive or negative pulse width of
the input signal is less than the set pulse width can the [pulse width error be
5%] be triggered.
Return
The query returns EQUAl, NEQUal, GRAt, LESS
Example
:TRIGger:PULSe:WHEN NEQUal /*Set trigger condition to NEQUal*/
:TRIGger:PULSe:WHEN? /*The query returns NEQUal*/
Command
:TRIGger:PULSe:WIDth <value>
:TRIGger:PULSe:WIDth?
Description
Set or query the pulse width triggering time.
Parameters
:<value> ::=pulse width trigger (in second)
Return
The query returns the pulse width value in scientific notation
Example
:TRIGger:PULSe:WIDth 0.000003 /Set the pulse width value to 3μs*/
:TRIGger:PULSe:WIDth? /*The query returns 3.000000e-06*/
Command
:TRIGger:PULSe:LEVel <level>
:TRIGger:PULSe:LEVel?
Description
Set or query the trigger level when pulse width trigger.
Parameters
:<level> ::=trigger level value ( in V)
Return
The query returns the trigger level value in scientific notation.
Example
:TRIGger:PULSe:LEVel 0.16 /*Set the trigger level to 160mV*/
:TRIGger:PULSe:LEVel? /*The query returns 1.600000e-01*/

SCPI Programmers Manual
20
⚫TRIGger:SLOPe:SOURce
⚫TRIGger:SLOPe:POLarity
⚫TRIGger:SLOPe:WHEN
⚫TRIGger:SLOPe:WIDth
⚫TRIGger:SLOPe:ALEVel
⚫TRIGger:SLOPe:BLEVel
4.8.1 TRIGger:SLOPe:SOURce
4.8.2 TRIGger:SLOPe:POLarity
4.8.3 TRIGger:SLOPe:WHEN
Command
:TRIGger:SLOPe:SOURce <source>
:TRIGger:SLOPe:SOURce?
Description
Set or query the trigger source of slope trigger
Parameters
:<source> ::= < CHANnel1 | CHANnel2 | CHANnel3 | CHANnel4>
Return
The query returns CHANnel1, CHANnel2, CHANnel3, CHANnel4
Example
:TRIGger:SLOPe:SOURce CHANnel1 /*Set trigger source to CH1*/
:TRIGger:SLOPe:SOURce? /*The query returns CHANnel1*/
Command
:TRIGger:SLOPe:POLarity <polarity>
:TRIGger:SLOPe:POLarity?
Description
Set or query the trigger polarity of the slope trigger.
Parameters
:<polarity> ::= < POSItive | NEGAtive>
State
POSItive: Positive slope trigger
NEGAtive: negative slope trigger
Return
The query returns POSItive, NEGAtive
Example
:TRIGger:SLOPe:POLarity POSItive /*Set positive slope trigger*/
:TRIGger:SLOPe:POLarity? /*The query returns POSItive*/
Command
:TRIGger:SLOPe:WHEN <when>
:TRIGger:SLOPe:WHEN?
Description
Set or query the trigger condition of the slope trigger.
Parameters
:<when> ::= < EQUAl| NEQUal| GREAt| LESS>
State
▷EQUAl = (equal to time value): Only when the positive or negative pulse width
of the input signal is equal to the set pulse width can it trigger. [Pulse width
error is 5%]
▷NEQUal! = (Not equal to time value): Only when the positive or negative pulse
width of the input signal is not equal to the set pulse width, can the [pulse
width error be 5%] be triggered.
▷GREAt＞(greater than the time value): Only when the positive or negative pulse
width of the input signal is greater than the set pulse width can it trigger
[pulse width error is 5%].
▷LESS <(less than time value): Only when the positive or negative pulse width of
the input signal is less than the set pulse width can the [pulse width error be
5%] be triggered.