SCPI COMMAND REFERENCE
The Rigol DS1052E is Rigol's oscilloscope in the DS1000E/DS1000D Series Digital Oscilloscope family. Its SCPI remote-control interface exposes 227 commands across 24 subsystems - 130 settable and 97 queries - and every command is documented here with its parameters, accepted values, return format, and a copy-paste PyVISA example for automating test and measurement.
227
Commands
130
Settable
97
Queries
24
Subsystems
SCPI
Verified
2026-07-16
All commands
Sets or queries the current acquire mode of the oscilloscope. The mode can be real-time sampling or equivalent sampling.
:ACQ:MODE ETIM Setup the acquire mode as ETIMe. :ACQ:MODE? The query returns EQUAL_TIME.
Returns the current acquisition type setting.
:ACQuire:TYPE?
Sets the acquisition mode to averaging. The command is listed in the quick reference only; no syntax details or parameter values are provided in this slice.
Sets the memory depth for acquisition. The command takes a <depth> value.
| Name | Type | Values | Description |
|---|---|---|---|
| depth | integer | - | Acquisition memory depth. |
Sets the acquisition mode.
Returns the current sampling rate.
Sets the acquisition type. The command is listed in the acquisition subsystem quick reference.
Sets or queries the menu display state of the oscilloscope. This command is listed among the display commands, but the provided slice does not include its detailed syntax or return information.
Sets the menu status of the oscilloscope display.
Sets or queries the display persistence mode of the oscilloscope.
Sets or queries the oscilloscope display type between sampling points. The display type can be VECTors or DOTS.
Sets or queries the brightness of the waveform display. The count value can be an integer between 0 and 32.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 0 - 32 | Brightness setting value. |
:DISP:INT 12 Setup the waveform brightness as 12. :DISP:INT? The query returns 12.
Sets the display brightness.
Clears the display.
Sets the display grid mode.
Sets the display intensity. The command is listed in the Display subsystem quick reference.
Sets the display of the menu area on or off.
| Name | Type | Values | Description |
|---|---|---|---|
| state | enum | ON | OFF | Turns the menu display on or off. |
Controls whether the menu status is shown on the display.
Sets the display persistence mode.
Sets the display type.
Sets or queries the horizontal timebase scan mode. The mode can be MAIN for the main timebase or DELayed for delayed scan.
:TIM:MODE? The query returns MAIN.
Sets and queries the offset of the MAIN or delayed timebase, i.e. the waveform position relative to the trigger midpoint. In MAIN state, the optional :DELayed node should be omitted.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | -500s - +500s | Offset of the timebase position relative to the trigger midpoint. |
:TIM:OFFS 1
Sets or queries the horizontal timebase format. The value can be XY, YT, or SCANning.
Sets or queries the horizontal scale for the MAIN or DELayed timebase. The unit is seconds per division, with the valid range depending on acquisition mode.
| Name | Type | Values | Description |
|---|---|---|---|
| scale_val | real | 2ns - 50s | Horizontal scale value for the MAIN or DELayed timebase. |
:TIM:SCAL 2 Setup its scale as 2s. :TIM:SCAL? The query returns 2.000e+00.
Sets the timebase display format.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | YT | XY | Selects the timebase format. |
:TIMebase:FORMat
Sets the timebase mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | - |
Sets the horizontal delay offset of the timebase. The command applies to the delayed timebase path when :TIMebase:MODE is delayed.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | - | Horizontal offset for the delayed timebase. |
Sets the timebase scale for the main or delayed timebase. The delayed timebase node is optional in the command path.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | MINimum - MAXimum | Timebase scale setting. |
Sets or queries the trigger mode. The mode can be EDGE, PULSE, VIDEO, SLOPE, PATTERN, DURATION, or ALTERNATION.
:TRIG:MODE EDGE Setup the trigger mode as EDGE. :TRIG:MODE? The query returns EDGE.
Sets or queries the trigger holdoff time. The valid range for <count> is 500 ns to 1.5 s.
Sets or queries the sensitivity of the edge trigger. The allowed count range is 0.1 div to 1 div.
Queries the edge trigger slope type. The query returns POSITIVE for a rising edge or NEGATIVE for a falling edge.
:TRIG:EDGE:SLOP? The query returns POSITIVE.
Sets or queries the pulse trigger condition. The mode can be positive or negative greater-than, less-than, or equal-to.
:TRIG:PULS:MODE? The query returns +GREATER THAN.
Sets or queries the pulse trigger sensitivity. The setting range is 0.1 div to 1 div.
| Name | Type | Values | Description |
|---|---|---|---|
| count | real | 0.1 - 1 | Sensitivity value in divisions. |
Sets or queries the pulse width. The allowed range for the width value is 20 ns to 10 s.
:TRIG:PULS:WIDT 0.001 :TRIG:PULS:WIDT?
Sets or queries the synchronous mode of the video trigger. The mode can be ODDfield, EVENfield, LINE, or ALLlines.
:TRIG:VIDEO:MODE EVEN :TRIG:VIDEO:MODE?
Sets or queries the video trigger polarity. The polarity can be positive or negative.
Sets or queries the number of the specified synchronous line for video triggering. In NTSC standard the valid range is 1 to 525; in PAL/SECAM standard the valid range is 1 to 625.
:TRIG:VIDEO:LINE 25 :TRIG:VIDEO:LINE?
Queries the type of video trigger standard.
:TRIG:VIDEO:STAN? The query returns PAL/SECAM.
Sets or queries the trigger sensitivity. The valid range for the count is 0.1 div to 1 div.
| Name | Type | Values | Description |
|---|---|---|---|
| count | real | 0.1 - 1 | Trigger sensitivity in divisions. |
:TRIG:VIDEO:SENS 0.5 Setup the trigger sensitive as 0.5div. :TRIG:VIDEO:SENS? The query returns 5.00e-01.
Sets or queries the trigger sensitivity for slope trigger. The allowed range is 0.1 div to 1 div.
Sets or queries the slope trigger time setting. The allowed range is 20 ns to 10 s.
:TRIG:SLOP:TIME 0.01 Setup the slope time is 10ms. :TRIG:SLOP:TIME? The query returns 1.000e-02.
Sets or queries the trigger slope condition. The mode can be positive or negative greater-than, less-than, or equal.
:TRIG:SLOP:MODE +GRE Setup the slope condition as +GREaterthan. :TRIG:SLOPe:MODE? The query returns +GREATER THAN.
Sets or queries the trigger level type used for slope triggering. The available values depend on the current slope condition: PA, PB, or PAB for positive-slope conditions, and NA, NB, or NAB for negative-slope conditions.
| Name | Type | Values | Description |
|---|---|---|---|
| count | enum | PA | PB | PAB | NA | NB | NAB | Trigger level type to select. |
:TRIGger:SLOPe:WINDow <count> :TRIGger:SLOPe:WINDow?
Sets or queries the upper boundary "Level A" of trigger level. The valid value range is from LevelB to +6 times the current vertical scale (V/div).
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | LevelB - +6*Scale | Upper boundary of the trigger level. |
:TRIG:SLOP:LEVA 2 Setup the upper boundary of trigger level as 2V. :TRIG:SLOP:LEVA? The query returns 2.000e+00.
Sets or queries the lower boundary, Level B, of the trigger level. The allowed value range is -6*Scale to Level A, where Scale is the current vertical scale in V/div.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | -6*Scale - LevelA | Lower trigger level boundary to set. |
:TRIG:SLOP:LEVB -1.5 :TRIG:SLOP:LEVB?
Sets or queries the type of pattern for a digital signal. The value and mask are 16-bit unsigned integers; edge source ranges from DIG0 to DIG15, and edge is 1 for rising edge or 0 for falling edge.
:TRIG:PATT:PATT? The query returns 65535, 65535, DIG2, Positive.
Sets and queries the digital signal pattern type for duration trigger. The value and mask are 16-bit unsigned integers; the query returns both in order.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 65535 | Pattern value; high is 1 and low is 0. |
| mask | integer | 0 - 65535 | Pattern mask; enabled bits are 1 and X bits are 0. |
:TRIG:DUR:PATT 65535,655535 :TRIG:DUR:PATT?
Sets or queries the limiting time of the duration trigger. The allowed time range is 2 ns to 10 s.
:TRIG:DUR:TIME 0.05 :TRIG:DUR:TIME?
Queries or sets the limiting condition of trigger time. The qualifier can be GREaterthan, LESSthan, or EQUal.