Enable the waveform auto setting function. The oscilloscope automatically adjusts the vertical scale, horizontal timebase, and trigger mode for optimum waveform display.
SCPI COMMAND REFERENCE
The Rigol DS1202Z-E is Rigol's oscilloscope in the DS1000Z-E Series Digital Oscilloscope family. Its SCPI remote-control interface exposes 394 commands across 26 subsystems - 336 settable and 58 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.
394
Commands
336
Settable
58
Queries
26
Subsystems
SCPI
Verified
2026-07-16
All commands
Clear all the waveforms on the screen. If the oscilloscope is in the RUN state, waveform will still be displayed. This command is equivalent to pressing the CLEAR key on the front panel.
Starts the oscilloscope. This command is equivalent to pressing the RUN/STOP key on the front panel.
Stops the oscilloscope. This command is equivalent to pressing the RUN/STOP key on the front panel.
Set the oscilloscope to the single trigger mode. It is equivalent to pressing the SINGLE key on the front panel or sending :TRIGger:SWEep SINGle.
Generate a trigger signal forcefully. This command is only applicable to the normal and single trigger modes and is equivalent to pressing the FORCE key in the trigger control area on the front panel.
Set or query the number of averages under the average acquisition mode.
| Name | Type | Values | Description |
|---|---|---|---|
| count | integer | 2 - 1024 | Number of averages to set. |
:ACQuire:AVERages 128 :ACQuire:AVERages?
Sets or queries the oscilloscope memory depth, i.e. the number of waveform points that can be stored in a single trigger sample. When AUTO is selected, the oscilloscope chooses the memory depth automatically according to the current sample rate.
| Name | Type | Values | Description |
|---|---|---|---|
| mdep | enum | AUTO | 12000 | 120000 | 1200000 | 12000000 | 24000000 | Memory depth setting. |
:ACQuire:MDEPth 12000 /*Set the memory depth to 12000pts*/ :ACQuire:MDEPth? /*The query returns 12000*/
Set or query the acquisition mode of the oscilloscope.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | NORMal | AVERages | PEAK | HRESolution | Acquisition mode to use. |
Queries the current sample rate. The default unit is Sa/s.
:ACQuire:SRATe? /*The query returns 2.000000e+09*/
Exit the self-calibration at any time.
Starts the oscilloscope self-calibration. During self-calibration, all channels must be disconnected from the inputs and most front-panel keys are disabled.
Sets or queries the bandwidth limit parameter of the specified channel. OFF disables the bandwidth limit; 20M enables the 20 MHz limit.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Specifies the channel number. |
| type | enum | 20M | OFF | Sets the channel bandwidth limit state. |
:CHANnel1:BWLimit 20M :CHANnel1:BWLimit?
Sets or queries the coupling mode of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| coupling | enum | AC | DC | GND | Selects the channel coupling mode. |
:CHANnel1:COUPling AC /*Select the AC coupling mode*/ :CHANnel1:COUPling? /*The query returns AC*/
Enable or disable the specified channel, or query the channel display status.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| bool | boolean | 1 | ON | 0 | OFF | Turns the specified channel display on or off. |
:CHANnel1:DISPlay ON :CHANnel1:DISPlay?
Enables or disables waveform inversion for the specified channel, or queries the inversion status.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Channel number. |
| bool | enum | 1 | ON | 0 | OFF | Turns waveform inversion on or off. |
:CHANnel1:INVert ON :CHANnel1:INVert?
Set or query the vertical offset of the specified channel. The default unit is V.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Specifies the channel number. |
| offset | real | -1000V - +1000V | Sets the vertical offset of the specified channel; allowable range depends on probe ratio and vertical scale. |
:CHANnel1:OFFSet 0.01 :CHANnel1:OFFSet?
Sets or queries the vertical range of the specified channel. The default unit is V.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Specified channel number. |
| range | real | 8mV - 80V | Vertical range; the allowed range depends on the probe ratio (1X: 8mV to 80V, 10X: 80mV to 800V). |
:CHANnel1:RANGe 8 :CHANnel1:RANGe?
Sets or queries the delay calibration time of the specified channel to calibrate the zero offset of that channel. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Specifies the channel number. |
| val | real | -100ns - 100ns | Delay calibration time to set; values are adjusted to the nearest allowed step for the current horizontal timebase. |
:CHANnel1:TCAL 0.00000002 :CHANnel1:TCAL?
Set or query the vertical scale of the specified channel. The default unit is V, and the valid range depends on the current probe ratio.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Channel number. |
| scale | real | V | Vertical scale for the selected channel. |
:CHANnel1:SCALe 1 /*Set the vertical scale of CH1 to 1V*/ :CHANnel1:SCALe? /*The query returns 1.000000e+00*/
Set or query the probe ratio of the specified channel. Setting the probe ratio affects the range of the vertical scale.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Channel number. |
| atten | discrete | 0.01 | 0.02 | 0.05 | 0.1 | 0.2 | 0.5 | 1 | 2 | 5 | 10 | 20 | 50 | 100 | 200 | 500 | 1000 | Probe attenuation ratio. |
:CHANnel1:PROBe 10 /*Set the probe ratio of CH1 to 10X*/ :CHANnel1:PROBe? /*The query returns 1.000000e+01*/
Sets or queries the amplitude display unit of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | Channel number. |
| units | enum | VOLTage | WATT | AMPere | UNKNown | Amplitude display unit. |
:CHANnel1:UNITs VOLTage /*Set the amplitude display unit of CH1 to V*/ :CHANnel1:UNITs? /*The query returns VOLT*/
Enable or disable the fine adjustment of the vertical scale of the specified channel, or query the fine adjustment status of the vertical scale of the specified channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables fine adjustment of the vertical scale. |
:CHANnel1:VERNier ON :CHANnel1:VERNier?
Sets or queries the cursor measurement mode. XY mode is valid only when the horizontal timebase mode is XY.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | OFF | MANual | TRACk | AUTO | XY | Cursor measurement mode. |
:CURSor:MODE MANual :CURSor:MODE?
Set or query the cursor type in manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | X | Y | Selects the manual cursor type. |
:CURSor:MANual:TYPE Y :CURSor:MANual:TYPE?
Sets or queries the cursor type in manual cursor measurement mode. X selects vertical cursors for time measurements; Y selects horizontal cursors for voltage measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | X | Y | Selects the manual cursor type. |
:CURSor:MANual:TYPE Y /*select the Y type cursors*/ :CURSor:MANual:TYPE? /*The query returns Y*/
Sets or queries the channel source used by the manual cursor measurement mode. Only the currently enabled channel can be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | MATH | Channel source for manual cursor measurements. |
:CURSor:MANual:SOURce CHANnel2 /*Set the channel source to CH2*/ :CURSor:MANual:SOURce? /*The query returns CHAN2*/
Sets or queries the horizontal unit in manual cursor measurement mode. The unit determines whether AX, BX, and BX-AX are shown in seconds, hertz, degrees, or percent.
| Name | Type | Values | Description |
|---|---|---|---|
| unit | enum | S | HZ | DEGRee | PERCent | Horizontal unit for manual cursor measurement results. |
:CURSor:MANual:TUNit DEGRee /*Set the horizontal unit to "degree"*/ :CURSor:MANual:TUNit? /*The query returns DEGR*/
Set or query the vertical unit in the manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| unit | enum | PERCent | SOURce | Selects whether AY, BY, and BY-AY are expressed in percent or use the current source unit. |
:CURSor:MANual:VUNit PERCent /*Set the system to express AY, BY, and BY-AY in the measurement results in percentage*/ :CURSor:MANual:VUNit? /*The query returns PERC*/
Set or query the horizontal position of cursor A in manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 594 | Horizontal cursor A position. |
:CURSor:MANual:AX 200 /*Set the horizontal position of cursor A to 200*/ :CURSor:MANual:AX? /*The query returns 200*/
Set or query the horizontal position of cursor B in the manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 594 | Horizontal position of cursor B in manual cursor measurement mode. |
:CURSor:MANual:BX 200 :CURSor:MANual:BX?
Set or query the vertical position of cursor A in the manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| y | integer | 5 - 394 | Vertical pixel position of cursor A. |
*:CURSor:MANual:AY 200 *:CURSor:MANual:AY?
Set or query the vertical position of cursor B in the manual cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| y | integer | 5 - 394 | Vertical position of cursor B in pixels. |
:CURSor:MANual:BY 200 :CURSor:MANual:BY?
Query the X value of cursor A in the manual cursor measurement mode. The unit depends on the horizontal unit currently selected.
:CURSor:MANual:AXValue? /*The query returns -4.000000e-06*/
Query the Y value of cursor A in manual cursor measurement mode. The unit depends on the vertical unit currently selected.
:CURSor:MANual:AYValue? /*The query returns 2.000000e+00*/
Queries the X value of cursor B in manual cursor measurement mode. The unit depends on the currently selected horizontal unit.
:CURSor:MANual:BXValue? /*The query returns 4.000000e-06*/
Queries the Y value of cursor B in manual cursor measurement mode. The unit depends on the currently selected vertical unit.
*:CURSor:MANual:BYValue? /*The query returns -2.000000e+00*/
Query the difference between the X values of cursor A and cursor B (BX-AX) in manual cursor measurement mode. The unit depends on the horizontal unit currently selected.
::CURSor:MANual:XDELta? /*The query returns 8.000000e-06*/
Queries the reciprocal of the absolute value of the difference between the X values of cursor A and cursor B (1/|dX|) in manual cursor measurement mode. The unit depends on the currently selected horizontal unit.
":CURSor:MANual:IXDELta? /*The query returns 1.250000e+05*/"
Sets or queries the channel source of cursor A in track cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | OFF | CHANnel1 | CHANnel2 | MATH | Channel source for cursor A. |
:CURSor:TRACk:SOURce1 CHANnel2 /*Set the channel source to CH2*/ :CURSor:TRACk:SOURce1? /*The query returns CHAN2*/
Queries the difference between the Y values of cursor A and cursor B (BY-AY) in manual cursor measurement mode. The unit depends on the currently selected vertical unit, and the result is returned in scientific notation when the source is CHANnel1, CHANnel2, or MATH.
:CURSor:MANual:YDELta? /*The query returns -4.000000e+00*/
Set or query the channel source of cursor A in the track cursor measurement mode. Only enabled channels can be selected as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | OFF | CHANnel1 | CHANnel2 | MATH | Channel source for cursor A. |
:CURSor:TRACk:SOURce1 CHANnel2 :CURSor:TRACk:SOURce1?
Set or query the channel source of cursor B in track cursor measurement mode. Only enabled channels can be selected.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | OFF | CHANnel1 | CHANnel2 | MATH | Channel source for cursor B. |
:CURSor:TRACk:SOURce2 CHANnel2 :CURSor:TRACk:SOURce2?
Sets or queries the horizontal position of cursor A in track cursor measurement mode. The position is defined by the screen pixel coordinate.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 594 | Horizontal position of cursor A. |
:CURSor:TRACk:AX 200 :CURSor:TRACk:AX?
Set or query the horizontal position of cursor B in the track cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 594 | Horizontal position of cursor B. |
:CURSor:TRACk:BX 200 :CURSor:TRACk:BX?
Query the vertical position of cursor A in track cursor measurement mode. The query returns 4294967295 when cursor A exceeds the vertical range of the screen display.
::CURSor:TRACk:AY? /*The query returns 284*/
Query the vertical position of cursor B in the track cursor measurement mode. The pixel coordinate screen range is from (0,0) to (600,400); if cursor B exceeds the vertical range of the display, the query returns 4294967295.
:CURSor:TRACk:BY? /*The query returns 200*/
Query the X value of cursor A in the track cursor measurement mode. The default unit is s.
:CURSor:TRACk:AXValue? /*The query returns -4.000000e-06*/
Query the Y value of cursor A in the track cursor measurement mode. The unit is the same as the channel unit currently selected.
Queries the X value of cursor B in track cursor measurement mode. The default unit is seconds, and the value is returned in scientific notation.
:CURSor:TRACk:BXValue? /*The query returns 4.000000e-06*/
Queries the Y value of cursor B in track cursor measurement mode. The unit is the same as the currently selected channel unit.
:CURSor:TRACk:BYValue? /*The query returns 4.000000e-01*/
Queries the difference between the X values of cursor A and cursor B (BX-AX) in track cursor measurement mode. The default unit is s, and the result is returned in scientific notation.
:CURSor:TRACk:XDELta? /*The query returns 8.000000e-06*/
Queries the difference between the Y values of cursor A and cursor B (BY-AY) in track cursor measurement mode. The unit is the same as the currently selected channel unit.
:CURSor:TRACk:YDELta? /*The query returns 8.000000e-01*/
The auto cursor function can measure waveform parameters; this command is the group heading for auto-cursor commands. The slice documents related subcommands, but not a direct setter/query action for :CURSor:AUTO itself.
Queries the reciprocal of the absolute value of the difference between the X values of cursor A and cursor B in track cursor measurement mode. The default unit is Hz.
:CURSor:TRACk:IXDELTA? /*The query returns 1.250000e+05*/
Selects which auto-cursor measured parameter is active from the five parameters enabled last, or queries the currently measured parameter. The auto cursor function can measure 37 waveform parameters.
| Name | Type | Values | Description |
|---|---|---|---|
| item | enum | OFF | ITEM1 | ITEM2 | ITEM3 | ITEM4 | ITEM5 | Selects the parameter to be measured by the auto cursor. |
:CURSor:AUTO:ITEM?
Queries the horizontal position of cursor A in auto cursor measurement. If cursor A of X type is not required for the selected measurement item, the query returns 4294967295.
Queries the horizontal position of cursor B in auto cursor measurement. If cursor B of X type is not required for some measurement items, the query returns 4294967295.
Queries the vertical position of cursor A in auto cursor measurement. The position is returned as a screen pixel coordinate, and if cursor A of Y type is not required for the measurement item, the query returns 4294967295.
Queries the vertical position of cursor B in auto cursor measurement. The position is expressed as a screen pixel coordinate, and the query returns 4294967295 when cursor B of Y type is not required for the selected measurement item.
Queries the X value of cursor A in auto cursor measurement. The unit depends on the currently selected horizontal unit.
*:CURSor:AUTO:AXValue? /*The query returns -4.000000e-06*/
Queries the Y value of cursor A in auto cursor measurement. The unit depends on the currently selected vertical unit.
Queries the X value of cursor B in auto cursor measurement. If cursor B of X type is not required for the selected measurement item, the query returns 9.9E37.
:CURSor:AUTO:BXValue? /*The query returns -4.000000e-06*/
Queries the Y value of cursor B in auto cursor measurement. The unit depends on the currently selected vertical unit; when cursor B of Y type is not required for some measurement items, the query returns 9.9E37.
::CURSor:AUTO:BYValue? /*The query returns 4.000000e-01*/
Sets or queries the XY cursor horizontal positions. The command group is only valid when the horizontal timebase mode is XY.
Sets or queries the horizontal position of cursor A in XY cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 394 | Horizontal cursor position in the XY display area. |
:CURSor:XY:AX 200 :CURSor:XY:AX?
Sets or queries the horizontal position of cursor B in the XY cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| x | integer | 5 - 394 | Horizontal cursor B position in XY mode. |
:CURSor:XY:BX 200 :CURSor:XY:BX?
Set or query the vertical position of cursor A in the XY cursor measurement mode.
| Name | Type | Values | Description |
|---|---|---|---|
| y | integer | 5 - 394 |
:CURSor:XY:AY 200 :CURSor:XY:AY?
Set or query the vertical position of cursor B in the XY cursor measurement mode. The query returns an integer between 5 and 394.
| Name | Type | Values | Description |
|---|---|---|---|
| y | integer | 5 - 394 | Vertical cursor B position in XY cursor measurement mode. |
:CURSor:XY:BY 200 :CURSor:XY:BY?
Query the X value of cursor A in XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel.
:CURSor:XY:AXValue? /*The query returns 2.000000e+00*/
Queries the Y value of cursor A in XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel.
:CURSor:XY:AYValue? /*The query returns 2.000000e+00*/
Query the X value of cursor B in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel.
:CURSor:XY:BXValue? /*The query returns -2.000000e+00*/
Query the Y value of cursor B in the XY cursor measurement mode. The unit depends on the amplitude unit of the corresponding channel.
:CURSor:XY:BYValue? /*The query returns -2.000000e+00*/
Sets or queries the decoder type for decoder <n>. The available modes are parallel, UART, SPI, and I2C decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| mode | enum | PARallel | UART | SPI | IIC | Selects the decoder type. |
:DECoder1:MODE SPI :DECoder1:MODE?
Turn on or off the decoder, or query the decoder status.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | |
| bool | boolean | 1 | ON | 0 | OFF | Turns the decoder display on or off. |
:DECoder1:DISPlay ON /*Turn on Decoder 1*/ :DECoder1:DISPlay? /*The query returns 1*/
Set or query the bus display format.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | Decoder index. |
| fmt | enum | HEX | ASCii | DEC | BIN | LINE | Bus display format. |
:DECoder1:FORMat HEX /*Set the bus display format to hexadecimal*/ :DECoder1:FORMat? /*The query returns HEX*/
Set or query the vertical position of the bus on the screen. The valid position range is 50 to 350.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| pos | integer | 50 - 350 | Vertical position of the bus on the screen. |
:DECoder1:POSition 350 :DECoder1:POSition?
Set or query the threshold level of the specified analog channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| thre | real | (-4 x VerticalScale - VerticalOffset) - (4 x VerticalScale - VerticalOffset) | Threshold level for the specified analog channel. |
:DECoder1:THREshold:CHANnel1 1.5 :DECoder1:THREshold:CHANnel1?
Set the threshold level of the specified analog channel for a decoder. The query returns the level in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| thre | real | -4 x VerticalScale - VerticalOffset - 4 x VerticalScale - VerticalOffset | Threshold level of the specified analog channel. |
:DECoder1:THREshold:CHANnel1 1.5 /*Set the threshold level of CH1 to 1.5V*/ :DECoder1:THREshold:CHANnel1? /*The query returns 1.500000e+00*/
Turns the auto threshold function of the analog channels on or off, or queries its status. By default the function is on; turning it off allows the threshold level to be set manually.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| bool | enum | 1 | ON | 0 | OFF | Enables or disables auto threshold. |
:DECoder1:THREshold:AUTO OFF /*Turn off the auto threshold function*/
Turns the label display function on or off, or queries its status. When enabled, the bus label is displayed at the lower-upper side of the bus (when bus display is on).
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Decoder number. |
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables label display. |
:DECoder1:CONFig:LABel ON :DECoder1:CONFig:LABel?
Turn on or off the bus display function, or query its status. When enabled, the bus is displayed on the screen and its vertical display position can be adjusted with :DECoder<n>:POSition.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | discrete | 1 - 2 | Decoder number. |
| <bool> | boolean | 1 | ON | 0 | OFF | Turns the bus display on or off. |
:DECoder1:CONFig:LINE OFF /*Turn off the bus display function*/ :DECoder1:CONFig:LINE? /*The query returns 0*/
Turns the format display function on or off, or queries its status.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | integer | 1 - 2 | Decoder number. |
| <bool> | boolean | 1 | ON | 0 | OFF | Enables or disables the format display function. |
Turns the endian display function on or off for serial bus decoding, or queries its status. The command is invalid in parallel decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Decoder number. |
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the endian display function. |
:DECoder1:CONFig:ENDian ON /*Turn on the endian display function*/ :DECoder1:CONFig:ENDian? /*The query returns 1*/
Turns the width display function on or off, or queries its status. When enabled, the width of each frame of data is shown at the right of the endian display when bus display is on.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | |
| bool | boolean | 1|ON | 0|OFF | Turns the width display function on or off. |
:DECoder1:CONFig:WIDth ON :DECoder1:CONFig:WIDth?
Query the current digital sample rate. The digital sample rate is related to the currently selected data source; by default, the data source is "Trace" and the sample rate is related to the horizontal time base.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder number. |
:DECoder1:CONFig:SRATe? /*The query returns 1.000000e+08*/
Sets the RS232 decoding parameters for decoder <n>. The command group includes TX, RX, polarity, endian, baud, width, stop, and parity settings.
Set or query the TX channel source of RS232 decoding. The TX and RX channel sources cannot both be set to OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| tx | enum | CHANnel1 | CHANnel2 | OFF | TX channel source for RS232 decoding. |
:DECoder1:UART:TX CHANnel2 :DECoder1:UART:TX?
Set or query the RX channel source of RS232 decoding. When OFF is selected, no RX channel source will be set, and the RX and TX channel sources cannot both be OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder number selector. |
| rx | enum | CHANnel1 | CHANnel2 | OFF | RX channel source for RS232 decoding. |
:DECoder1:UART:RX CHANnel2 :DECoder1:UART:RX?
Sets or queries the polarity of RS232 decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | Decoder number. |
| pol | enum | NEGative | POSitive | Polarity setting for RS232 decoding. |
:DECoder1:UART:POLarity NEGative :DECoder1:UART:POLarity? /*The query returns NEG*/
Set or query the endian of RS232 decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | Decoder number. |
| endian | enum | LSB | MSB | Endian setting for RS232 decoding. |
:DECoder1:UART:ENDian MSB /*Set the endian of RS232 decoding to MSB*/ :DECoder1:UART:ENDian? /*The query returns MSB*/
Set or query the baud rate of RS232 decoding. The default unit is bps (baud per second).
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | |
| baud | integer | bps | Baud rate for RS232 decoding. |
Set or query the width of each frame of data in RS232 decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| wid | integer | 5 - 8 |
:DECoder1:UART:WIDTh 7 /*Set the data width in RS232 decoding to 7*/ :DECoder1:UART:WIDTh? /*The query returns 7*/
Set or query the stop bit after each frame of data in RS232 decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | |
| stop | discrete | 1 | 1.5 | 2 | Stop bit value after each frame of data in RS232 decoding. |
:DECoder1:UART:STOP 1.5 /*Set the stop bit in RS232 decoding to 1.5*/ :DECoder1:UART:STOP? /*The query returns 1.5*/
Sets or queries the parity check mode used for RS232 decoding. The query returns the current parity setting.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| parity | enum | NONE | EVEN | ODD | Even-odd check mode for the decoded data. |
:DECoder1:UART:PARity ODD :DECoder1:UART:PARity?
Sets or queries the signal source of the clock channel used for I2C decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder number. |
| clk | enum | CHANnel1 | CHANnel2 | Clock channel source for I2C decoding. |
Sets or queries the signal source of the clock channel in I2C decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| clk | enum | CHANnel1 | CHANnel2 | Signal source for the I2C clock channel. |
:DECoder1:IIC:CLK CHANnel1 :DECoder1:IIC:CLK?
Sets or queries the signal source of the data channel in I2C decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| dat | enum | CHANnel1 | CHANnel2 | Signal source for the I2C data channel. |
:DECoder1:IIC:DATA CHANnel1 :DECoder1:IIC:DATA?
Sets or queries the address mode of I2C decoding. NORMal means the address bits do not include the R/W bit; RW means they include the R/W bit.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| addr | enum | NORMal | RW | Selects whether the decoded address includes the R/W bit. |
:DECoder1:IIC:ADDRess RW /*Set the address of I2C decoding to include the R/W bit*/ :DECoder1:IIC:ADDRess? /*The query returns RW*/
Set the SPI decoding parameters for decoder n.
Sets or queries the signal source of the clock channel used in SPI decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| clk | enum | CHANnel1 | CHANnel2 | Signal source of the clock channel in SPI decoding. |
:DECoder1:SPI:CLK CHANnel1 :DECoder1:SPI:CLK?
Set or query the MISO channel source in SPI decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 - 2 | |
| miso | enum | CHANnel1 | CHANnel2 | OFF | Selects the MISO channel source for SPI decoding. |
:DECoder1:SPI:MISO <miso> :DECoder1:SPI:MISO?
Sets or queries the MOSI channel source used for SPI decoding. OFF disables the MOSI source; MOSI and MISO cannot both be set to OFF.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder number selector. |
| mosi | discrete | CHANnel1 | CHANnel2 | OFF | MOSI channel source for SPI decoding. |
:DECoder1:SPI:MOSI CHANnel1 /*Set the MOSI channel source in SPI decoding to CH1*/ :DECoder1:SPI:MOSI? /*The query returns CHAN1*/
Sets or queries the CS channel source used for SPI decoding. This command is only valid in CS mode (:DECoder<n>:SPI:MODE).
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder number. |
| cs | enum | CHANnel1 | CHANnel2 | CS channel source. |
:DECoder1:SPI:CS CHANnel2 :DECoder1:SPI:CS?
Sets or queries the CS polarity used in SPI decoding. This command is only valid in CS mode.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | |
| CsNcs | enum | NCS | CS | Selects whether NCS (low level valid) or CS (high level valid) is used as the chip-select polarity. |
:DECoder1:SPI:SELect CS :DECoder1:SPI:SELect? /*The query returns CS*/
Set or query the frame synchronization mode of SPI decoding. In CS mode, frame synchronization is based on the chip select line; in TIMeout mode, it is based on the timeout time.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Decoder index. |
| mode | enum | CS | TIMeout | Frame synchronization mode for SPI decoding. |
:DECoder1:SPI:MODE CS :DECoder1:SPI:MODE?
Set or query the timeout time in the timeout mode of SPI decoding. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| tmo | real | s | Timeout time used for SPI frame synchronization in timeout mode. |
Sets or queries the polarity of the SDA data line in SPI decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Decoder number. |
| pol | enum | NEGative | POSitive | Polarity of the SDA data line. |
:DECoder1:SPI:POLarity NEG ative /*Set the polarity of the SDA data line in SPI decoding to negative*/ :DECoder1:SPI:POLarity? /*The query returns NEG*/
Set or query the clock type when the instrument samples the data line in SPI decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | |
| edge | enum | RISE | FALL |
:DECoder1:SPI:EDGE FALL /*Set the instrument to sample data on the falling edge of the clock in SPI decoding*/ :DECoder1:SPI:EDGE? /*The query returns FALL*/
Sets or queries the endian used for SPI decoding data.
| Name | Type | Values | Description |
|---|---|---|---|
| endian | enum | LSB | MSB | Selects the SPI data endian. |
:DECoder1:SPI:ENDian MSB :DECoder1:SPI:ENDian?
Set or query the number of bits of each frame of data in SPI decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | discrete | 1 | 2 | |
| wid | integer | 8 - 32 | Number of bits in each SPI decoding frame. |
:DECoder1:SPI:WIDTh 16 /*Set the data width in SPI decoding to 16*/ :DECoder1:SPI:WIDTh? /*The query returns 16*/
Sets the parallel decoding parameters for decoder n. The page lists related subcommands for CLK, EDGE, WIDTh, BITX, SOURce, POLarity, NREJect, NRTime, CCOMpensation, and PLOT.
Sets or queries the CLK channel source for parallel decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| <n> | integer | 1 - 2 | Decoder number. |
| <clk> | enum | CHANnel1 | CHANnel2 | OFF | Selects the CLK channel source. |
:DECoder1:PARallel:CLK CHANnel1 :DECoder1:PARallel:CLK?
Sets or queries the edge type used by the clock channel when the instrument samples the data channel in parallel decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| edge | enum | RISE | FALL | BOTH | Edge type of the clock channel used for sampling in parallel decoding. |
:DECoder1:PARallel:EDGE RISE :DECoder1:PARallel:EDGE?
Set or query the data width, namely the number of bits of each frame of data, of the parallel bus.
| Name | Type | Values | Description |
|---|---|---|---|
| n | enum | 1 | 2 | |
| wid | integer | 1 - 16 |
:DECoder1:PARallel:WIDTh 16 :DECoder1:PARallel:WIDTh?
Set or query the data bit that requires a channel source on the parallel bus. The bit index is constrained by the current parallel data width.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| bit | integer | 0 - (data width - 1) | Current data bit index. |
:DECoder1:PARallel:BITX 2 :DECoder1:PARallel:BITX? /*The query returns 2*/
Set or query the channel source of the data bit currently selected.
| Name | Type | Values | Description |
|---|---|---|---|
| src | - | - | Channel source for the selected data bit. |
Set or query the data polarity of parallel decoding.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | |
| pol | enum | NEGative | POSitive | Selects the data polarity: NEGative means the low level is 1, and POSitive means the high level is 1. |
:DECoder1:PARallel:POLarity NEGative /*Set the data polarity of parallel decoding to negative*/ :DECoder1:PARallel:POLarity? /*The query returns NEG*/
Turns the noise rejection function of parallel decoding on or off, or queries its status.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Decoder number. |
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables noise rejection. |
Sets or queries the noise rejection time of parallel decoding. The default unit is seconds; before using it, turn on noise rejection with :DECoder<n>:PARallel:NREJect.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Decoder index. |
| time | real | 0.00s - 100ms | Noise rejection time. |
:DECoder1:PARallel:NRTime 0.01 :DECoder1:PARallel:NRTime?
Set or query the clock compensation time of parallel decoding. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | |
| comp | real | -100ms - 100ms | Clock compensation time for parallel decoding. |
:DECoder1:PARallel:CCOMpensation 0.01 :DECoder1:PARallel:CCOMpensation?
Turns on or off the curve function of parallel decoding, or queries its status. When enabled, the variation trend of the bus data is displayed in vector diagram form.
| Name | Type | Values | Description |
|---|---|---|---|
| n | enum | 1 | 2 | Decoder number selector. |
| bool | boolean | - | Turns the parallel decode curve display on or off. |
:DECoder1:PARallel:PLOT ON :DECoder1:PARallel:PLOT?
Clear all the waveforms on the screen. If the oscilloscope is in the RUN state, waveform will still be displayed.
Read the data stream of the image currently displayed on the screen, with optional settings for color, invert display, and image format. The instrument returns the image data preceded by a TMC block header.
| Name | Type | Values | Description |
|---|---|---|---|
| coloropt | enum | ON | OFF | Color image mode; ON denotes color and OFF denotes intensity-graded color. |
| invertopt | enum | 1 | ON | 0 | OFF | Invert display setting; 1|ON turns the invert function on and 0|OFF turns it off. |
| formatopt | enum | BMP24 | BMP8 | PNG | JPEG | TIFF | Format of the returned image data stream. |
:DISPlay:DATA? [<color>,<invert>,<format>]
Set or query the display mode of the waveform on the screen.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | VECTors | DOTS | Selects the waveform display mode. |
:DISPlay:TYPE DOTS /*Select dots display mode*/ :DISPlay:TYPE? /*The query returns DOTS*/
Set or query the persistence time. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| time | enum | MIN | 0.1 | 0.2 | 0.5 | 1 | 5 | 10 | INFinite | Persistence time setting. |
:DISPlay:GRADing:TIME 0.1 :DISPlay:GRADing:TIME?
Set or query the waveform brightness.
| Name | Type | Values | Description |
|---|---|---|---|
| time | integer | 0 - 100 | Brightness level to set, from 0 to 100. |
*:DISPlay:WBRightness 50 /*Set the waveform brightness to 50%*/ *:DISPlay:WBRightness? /*The query returns 50*/
Sets or queries the grid type of the screen display.
| Name | Type | Values | Description |
|---|---|---|---|
| grid | enum | FULL | HALF | NONE | Grid type to display. |
:DISPlay:GRID NONE /*Turn the background grid and coordinate off*/ :DISPlay:GRID? /*The query returns NONE*/
Set or query the brightness of the screen grid.
| Name | Type | Values | Description |
|---|---|---|---|
| brightness | integer | 0 - 100 | Brightness level of the screen grid. |
:DISPlay:GBRightness 60 :DISPlay:GBRightness?
Turns the decoding event table on or off, or queries its status. This command is only valid when the decoder is turned on (:DECoder<n>:DISPlay).
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Selects the decoding event table number. |
| bool | enum | 1 | ON | 0 | OFF | Turns the decoding event table on or off. |
:ETABle1:DISP ON :ETABle1:DISP?
Set or query the data display format of the event table.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | |
| fmt | enum | HEX | ASCii | DEC | Selects the event table data display format. |
:ETABle1:FORMat ASCii :ETABle1:FORMat?
Set or query the display mode of the event table. The query returns PACK, DET, or PAYL.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 2 | Event table index. |
| view | enum | PACKage | DETail | PAYLoad | Display mode of the event table. |
:ETABle1:VIEW PAYLoad /*Set the display mode of the event table to PAYLoad*/ :ETABle1:VIEW? /*The query returns PAYL*/
Set or query the current column of the event table. The available column values depend on the selected decoder mode.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| col | enum | DATA | TX | RX | MISO | MOSI |
:ETABle1:COLumn DATA :ETABle1:COLumn?
Set or query the current row of the event table.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| row | integer | 1 - the maximum number of rows of the current event table |
:ETABle1:ROW 2 /*Set the current row to 2*/ :ETABle1:ROW? /*The query returns 2*/
Set or query the display type of the decoding results in the event table.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | |
| sort | enum | ASCend | DESCend | Controls whether events are displayed in chronological order or reverse chronological order. |
:ETABle1:SORT DESCend :ETABle1:SORT?
Reads the current event table data.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | Selects the event table to read. |
:ETABle1:DATA? /*The query returns the data as shown in the figure above*/
Set or query the end frame of waveform recording.
| Name | Type | Values | Description |
|---|---|---|---|
| frame | integer | 1 - the maximum number of frames can be recorded currently | End frame of the recording. |
:FUNCtion:WRECord:FEND 4096 :FUNCtion:WRECord:FEND?
Query the maximum number of frames that can be recorded currently. The maximum depends on the currently selected memory depth.
Sets or queries the time interval between frames in waveform recording. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| interval | real | 100ns - 10s | Time interval between recorded waveform frames. |
:FUNCtion:WRECord:FINTerval 0.001 :FUNCtion:WRECord:FINTerval?
Turns the recording-finish sound prompt on or off, or queries its current status. When enabled, the instrument sounds a prompt when recording finishes regardless of the system beep setting.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables the sound prompt when recording finishes. |
:FUNCtion:WRECord:PROMpt 1 /*Turn on the sound prompt when the recording finishes*/ :FUNCtion:WRECord:PROMpt? /*The query returns 1*/
Starts or stops waveform recording, or queries the recording status. Before using it, waveform recording must be enabled with :FUNCtion:WRECord:ENABle.
| Name | Type | Values | Description |
|---|---|---|---|
| opt | enum | RUN | STOP | Selects whether waveform recording starts or stops. |
:FUNCtion:WRECord:OPERate RUN /*Start the waveform recording*/ :FUNCtion:WRECord:OPERate? /*The query returns RUN if the recording is in progress and returns STOP if the recording has already finished*/
Turn on or off the waveform recording function, or query its status. Waveform recording can only be enabled when the horizontal timebase mode is YT and the horizontal timebase is lower than 200 ms.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the waveform recording function. |
:FUNCtion:WRECord:ENABle 1 :FUNCtion:WRECord:ENABle?
Sets or queries the start frame of waveform playback.
| Name | Type | Values | Description |
|---|---|---|---|
| sta | integer | 1 - the maximum number of frames recorded | Start frame index for waveform playback. |
:FUNCtion:WREPlay:FSTart 5 :FUNCtion:WREPlay:FSTart?
Set or query the end frame of waveform playback. The end frame cannot be lower than the start frame, and it can only be set when a waveform is currently recorded and not during recording or playback.
| Name | Type | Values | Description |
|---|---|---|---|
| end | integer | 1 - the maximum number of frames recorded | End frame of waveform playback. |
:FUNCtion:WREPlay:FEND 4096 /*Set the end frame of waveform playback to :FUNCtion:WREPlay:FEND? /*The query returns 4096*/
Queries the maximum number of frames that can be played, which is the same as the maximum number of frames recorded.
:FUNCtion:WREPlay:FMAX?
Sets or queries the time interval between frames in waveform playback. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| interval | real | 100ns - 10s | Time interval between frames in waveform playback. |
:FUNCtion:WREPlay:FINTerval 0.001 :FUNCtion:WREPlay:FINTerval?
Set or query the waveform playback mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | REPeat | SINGle | Selects cycle playback or single playback mode. |
:FUNCtion:WREPlay:MODE REPeat :FUNCtion:WREPlay:MODE? /*The query returns REP*/
Sets or queries the waveform playback direction. FORWard means positive direction from the start frame to the end frame, and BACKward means negative direction from the end frame to the start frame.
| Name | Type | Values | Description |
|---|---|---|---|
| dir | enum | FORWard | BACKward | Waveform playback direction. |
:FUNCtion:WREPlay:DIRection FORWard :FUNCtion:WREPlay:DIRection?
Start, pause, or stop the waveform playback, or query the status of the waveform playback.
| Name | Type | Values | Description |
|---|---|---|---|
| opt | enum | PLAY | PAUSe | STOP | Selects the waveform playback operation. |
:FUNCtion:WREPlay:OPERate PLAY /*Start the waveform playback*/ :FUNCtion:WREPlay:OPERate? /*The query returns PLAY if the playback is in progress and returns STOP if the playback finishes*/
Set or query the current frame in waveform playback.
| Name | Type | Values | Description |
|---|---|---|---|
| cur | integer | 1 - the maximum number of frames recorded | Current frame number to select for waveform playback. |
:FUNCtion:WREPlay:FCURrent 300 /*Set the current frame in waveform playback to 300*/ :FUNCtion:WREPlay:FCURrent? /*The query returns 300*/
Clear all the event registers and clear the error queue.
Set or query the enable register for the standard event status register set.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | - | Integer value corresponding to the standard event status register enable bits; bit 1 and bit 6 are always treated as 0. |
*ESE 16 *ESE?
Query and clear the standard event status register. The return value is an integer corresponding to the register bits, with bit 1 and bit 6 always treated as 0.
Query the ID string of the instrument.
Sets the Operation Complete bit (bit 0) in the standard event status register to 1 after the current operation is finished.
Restore the instrument to the default state.
Set or query the enable register for the status byte register set. The value is constrained to decimal numbers corresponding to binary numbers XXXXXX00, with bit 0 and bit 1 always treated as 0.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 0 - 255 | Enable register value for the status byte register set. |
*SRE 16 *SRE?
Query the event register for the status byte register. The status byte register is set to 0 after this command is executed.
Performs a self-test and then returns the self-test results.
Wait for the current operation to finish. Subsequent commands are executed only after the current command has completed.
Turns on or off the DHCP configuration mode, or queries the on/off status of the current DHCP configuration mode.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables DHCP configuration mode. |
:LAN:DHCP ON :LAN:DHCP?
Turns on or off the Auto IP configuration mode; or queries the on/off status of the current Auto IP configuration mode.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables Auto IP configuration mode. |
Sets or queries the default gateway for the oscilloscope. The address must be entered as nnn,nnn,nnn,nnn, and the command is used in Auto IP or Static IP mode.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Default gateway address in ASCII string form. |
:LAN:GATeway 192.168.1.1 /*Sets the default gateway to 192.168.1.1.*/ :LAN:GATeway? /*The query returns the current gateway.*/
Sets or queries the DNS address. The address format is nnn,nnn,nnn,nnn and the command is valid in Auto IP or Static IP mode.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | DNS address in ASCII string format. |
Queries the MAC address of the instrument. The address is displayed in the format 00-19-AF-30-00-00.
Turns on or off the static IP configuration mode, or queries its on/off status. When static IP mode is valid, DHCP and Auto IP must be disabled manually.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns static IP configuration mode on or off. |
:LAN:MANual ON :LAN:MANual?
Initiates the network parameters. Run this after confirming the oscilloscope is properly connected to the network.
Sets or queries the IP address of the instrument. The IP configuration mode must be static IP, and DHCP and auto IP must be disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | IP address in nnn,nnn,nnn,nnn format; the first section must be 0 to 223 except 127, and the other three sections must be 0 to 255. |
:LAN:IPADdress 192.168.1.10 :LAN:IPADdress?
Sets or queries the subnet mask. The subnet mask must be entered as an IPv4 address string in nnn,nnn,nnn,nnn format, and the instrument must be in static IP mode with DHCP and auto IP disabled.
| Name | Type | Values | Description |
|---|---|---|---|
| string | string | - | Subnet mask in nnn,nnn,nnn,nnn format. |
:LAN:SMASk 255.255.255.0 :LAN:SMASk?
Queries the current network configuration status.
Queries the VISA address of the instrument.
Applies the network configuration.
Enable or disable the math operation function, or query the math operation status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables the math operation function. |
:MATH:DISPlay ON :MATH:DISPlay?
Set or query the operator of the math operation. When :MATH:SOURce1 and/or :MATH:SOURce2 is FX, this command sets the outer-layer operator of a compound operation.
| Name | Type | Values | Description |
|---|---|---|---|
| opt | enum | ADD | SUBTract | MULTiply | DIVision | AND | OR | XOR | NOT | FFT | INTG | DIFF | SQRT | LOG | LN | EXP | ABS | FILTer | Operator to use for the math operation. |
:MATH:OPERator INTG /*Set the operator of the math operation to integration*/ :MATH:OPERator? /*The query returns INTG*/
Sets or queries source A of an algebraic operation, functional operation, or the outer layer operation of a compound operation. When FX is selected, related FX source and operator commands can be used to set the inner layer operation.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | FX | Source selection for the operation. |
:MATH:SOURce1 CHANnel2 :MATH:SOURce1?
Set or query source B of algebraic operation or the outer layer operation of a compound operation. When FX is selected, inner-layer source and operator commands can be used.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | FX | Selects the source for source B of an algebraic operation or the outer-layer operation of a compound operation. |
Set or query source A of the logic operation. The logic operations include A&&B, A||B, A^B, and !A.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | Selects the source for logic operation A. |
:MATH:LSOUrce1 CHANnel1 :MATH:LSOUrce1?
Set or query source B of the logic operation. This command is only applicable to logic operations that require two signal sources.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | Selects the source B signal channel. |
::MATH:LSOUrce2 CHANnel1 ::MATH:LSOUrce2?
Set or query the vertical scale of the operation result. The unit depends on the currently selected operator and the source unit.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | 1p - 5T | Vertical scale of the operation result. |
Set or query the vertical offset of the operation result. The unit depends on the operator currently selected and the unit of the source.
| Name | Type | Values | Description |
|---|---|---|---|
| offs | real | -1000 x MathVerticalScale - 1000 x MathVerticalScale | Vertical offset of the operation result, related to the vertical scale of the operation result. |
:MATH:OFFSet 8 /*Set the vertical offset to 8V*/ :MATH:OFFSet? /*The query returns 8.000000e+00*/
Enable or disable the inverted display mode of the operation result, or query the inverted display mode status of the operation result.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables inversion of the operation result display. |
:MATH:INVert <bool> :MATH:INVert?
Resets the math operation result display scaling. The instrument adjusts the vertical scale of the operation result to the most proper value according to the current operator and the horizontal timebase of the source.
Set or query the source of the FFT operation/filter.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | FFT source. |
:MATH:FFT:SOURce CHANnel1 /* Set the source of FFT operation to CH1*/ :MATH:FFT:SOURce? /* The query returns CHAN1*/
Set or query the window function of the FFT operation.
| Name | Type | Values | Description |
|---|---|---|---|
| wnd | enum | RECTangle | BLACkman | HANNing | HAMMing | FLATtop | TRIangle | Selects the FFT window function. |
:MATH:FFT:WINDow RECTangle :MATH:FFT:WINDow?
Enable or disable the half-screen display mode of the FFT operation, or query the status of that mode.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the FFT half-screen display mode. |
:MATH:FFT:SPLit OFF :MATH:FFT:SPLit?
Set or query the vertical unit of the FFT operation result.
:MATH:FFT:UNIT VRMS :MATH:FFT:UNIT?
Sets or queries the horizontal scale of the FFT operation result. The default unit is Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| hsc | real | 1/1000 - 1/20 | Horizontal scale of the FFT operation result. |
:MATH:FFT:HSCale 500000 :MATH:FFT:HSCale?
Set or query the center frequency of the FFT operation result, relative to the horizontal center of the screen. The default unit is Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| cent | real | 0 - 0.4 x FFT sample rate | Center frequency of the FFT operation result. |
:MATH:FFT:HCENter 10000000 :MATH:FFT:HCENter?
Sets or queries the FFT mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | TRACe | MEMory | Selects the data source used for the FFT operation. |
:MATH:FFT:MODE TRACe :MATH:FFT:MODE?
Set or query the filter type. The filter can be configured as low pass, high pass, band pass, or band stop.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | LPASs | HPASs | BPASs | BSTOP | Selects the filter type. |
Sets or queries the cutoff frequency (ωc1) for the low pass/high pass filter, or cutoff frequency 1 for the band pass/band stop filter. The default unit is Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| freq1 | real | 0.005 x screen sample rate - 0.1 x screen sample rate | Cutoff frequency to set; the valid range depends on the selected filter type. |
::MATH:FILTer:W1 1000000 ::MATH:FILTer:W1?
Set or query the cutoff frequency 2 (ωc2) of the band pass/band stop filter. The default unit is Hz.
| Name | Type | Values | Description |
|---|---|---|---|
| freq2 | real | Hz | Cutoff frequency 2 for the band pass/band stop filter. |
Sets or queries the start point of the waveform math operation. The command is invalid for FFT; sending it modifies the start points of all operations except FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| sta | integer | 0 - End point currently set - 1 | Start point index of the waveform math operation. |
:MATH:OPTion:STARt 50 :MATH:OPTion:STARt?
Set or query the end point of the waveform math operation. This command is invalid for the FFT operation and affects the end points of all operations except FFT.
| Name | Type | Values | Description |
|---|---|---|---|
| end | integer | (Start point currently set+1) - 1199 |
:MATH:OPTion:END <end> :MATH:OPTion:END?
Enable or disable the inverted display mode of the operation result, or query the inverted display mode status of the operation result. This command is invalid for the FFT operation and has the same function as :MATH:INVert.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables inverted display mode. |
:MATH:OPTion:INVert ON /*Enable the inverted display mode*/ :MATH:OPTion:INVert? /*The query returns 1*/
Set or query the sensitivity of the logic operation. The default unit is div, namely the current vertical scale.
| Name | Type | Values | Description |
|---|---|---|---|
| sens | real | 0 - 0.96 | Sensitivity of the logic operation. |
:MATH:OPTion:SENSitivity 0.24 /*Set the sensitivity of the logic operation to 0.24div*/ :MATH:OPTion:SENSitivity? /*The query returns 2.400000e-01*/
Set or query the smoothing window width of differential operation (diff). This command is only applicable to differential operation (diff).
| Name | Type | Values | Description |
|---|---|---|---|
| dist | integer | 3 - 201 | Smoothing window width. |
:MATH:OPTion:DIStance 25 :MATH:OPTion:DIStance?
Enable or disable the auto scale setting of the operation result, or query the auto scale status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables auto scale. |
:MATH:OPTion:ASCale ON /*Enable the auto scale setting */ :MATH:OPTion:ASCale? /*The query returns 1*/
Set or query the threshold level of source A in logic operations. The default unit is V.
| Name | Type | Values | Description |
|---|---|---|---|
| thre | real | -4 x VerticalScale - VerticalOffset - 4 x VerticalScale - VerticalOffset | Threshold level for source A in logic operations. |
:MATH:OPTion:THReshold1 <thre> :MATH:OPTion:THReshold1?
Set or query the threshold level of source B in logic operations. The default unit is V.
| Name | Type | Values | Description |
|---|---|---|---|
| thre | real | -4 x VerticalScale - VerticalOffset - 4 x VerticalScale - VerticalOffset | Threshold level for source B in logic operations. |
:MATH:OPTion:THReshold2 0.5 :MATH:OPTion:THReshold2?
Set or query source A of the inner layer operation of a compound operation.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | Source selection for the inner layer operation. |
Set or query source B of the inner layer operation of compound operation.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 |
:MATH:OPTion:FX:SOURce2 CHANnel1 :MATH:OPTion:FX:SOURce2?
Set or query the operator of the inner layer operation of a compound operation.
| Name | Type | Values | Description |
|---|---|---|---|
| op | enum | ADD | SUBTract | MULTiply | DIVision |
:MATH:OPTion:FX:OPERator ADD :MATH:OPTion:FX:OPERator?
Enable or disable the pass/fail test, or query its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables the pass/fail test. |
:MASK:ENABle ON /*Enable the pass/fail test*/ :MASK:ENABle? /*The query returns 1*/
Set or query the source of the pass/fail test.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Source channel for the pass/fail test. |
Run or stop the pass/fail test, or query its status. The pass/fail test must be enabled first with :MASK:ENABle.
| Name | Type | Values | Description |
|---|---|---|---|
| oper | enum | RUN | STOP | Selects whether to run or stop the pass/fail test. |
:MASK:OPERate RUN /*Run the pass/fail test*/ :MASK:OPERate? /*The query returns RUN*/
Enables or disables the statistic information for the pass/fail test when the mask test is enabled. The query returns the current display status as 1 or 0.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns statistic information on or off. |
:MASK:MDISplay ON :MASK:MDISplay? /*The query returns 1*/
Turns the "Stop on Fail" function on or off, or queries its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns the Stop on Fail function on or off. |
:MASK:SOOutput ON /*Turn the "Stop on Fail" function on*/ :MASK:SOOutput? /*The query returns 1*/
Enable or disable the sound prompt when failed waveforms are detected, or query its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns the sound prompt on or off. |
:MASK:OUTPut ON :MASK:OUTPut?
Set or query the horizontal adjustment parameter in the pass/fail test mask. The default unit is div.
| Name | Type | Values | Description |
|---|---|---|---|
| x | real | 0.02 - 4 | Horizontal adjustment parameter for the pass/fail test mask. |
:MASK:X 0.28 :MASK:X?
Set or query the vertical adjustment parameter in the pass/fail test mask. The default unit is div.
| Name | Type | Values | Description |
|---|---|---|---|
| y | real | 0.04 - 5.12 | Vertical adjustment parameter for the pass/fail test mask. |
:MASK:Y 0.36 :MASK:Y?
Create the pass/fail test mask using the current horizontal and vertical adjustment parameters.
Query the number of passed frames in the pass/fail test.
Queries the number of failed frames in the pass/fail test.
Query the total number of frames in the pass/fail test.
Reset the numbers of passed frames and failed frames as well as the total number of frames in the pass/fail test to 0.
Set or query the source of the current measurement parameter.
| Name | Type | Values | Description |
|---|---|---|---|
| sour | enum | CHANnel1 | CHANnel2 | MATH | Selects the source used for measurement parameters. |
:MEASure:SOURce CHANnel2 :MEASure:SOURce?
Set or query the source of the frequency counter, or disable the frequency counter.
| Name | Type | Values | Description |
|---|---|---|---|
| sour | enum | CHANnel1 | CHANnel2 | OFF | Source for the frequency counter. |
:MEASure:COUNter:SOURce CHANnel2 :MEASure:COUNter:SOURce?
Query the measurement result of the frequency counter. The default unit is Hz; if the counter is disabled, it returns 0.0000000e+00.
:MEASure:COUNter:VALue? /*The query returns 1.000004e+03*/
Clears one or all of the last five enabled measurement items. The item order is determined by the order in which they were turned on, and clearing items does not change that order.
| Name | Type | Values | Description |
|---|---|---|---|
| item | enum | ITEM1 | ITEM2 | ITEM3 | ITEM4 | ITEM5 | ALL | Measurement item to clear. |
:MEASure:CLEar ITEM1 /*Clear ITEM1*/
Recover the measurement item which has been cleared.
| Name | Type | Values | Description |
|---|---|---|---|
| item | discrete | ITEM1 | ITEM2 | ITEM3 | ITEM4 | ITEM5 | ALL |
:MEASure:RECover ITEM1
Enable or disable the all measurement function, or query its status. The all measurement function can measure multiple waveform parameters at the same time.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | 1 | ON | 0 | OFF | Enable or disable the all measurement function. |
Sets or queries the source(s) of the all measurement function.
| Name | Type | Values | Description |
|---|---|---|---|
| src | enum | CHANnel1 | CHANnel2 | MATH | Source for the all measurement function. |
:MEASure:AMSource CHANnel1,CHANnel2 :MEASure:AMSource?
Sets or queries the upper limit of the threshold used in time, delay, and phase measurements. The threshold is expressed as a percentage of amplitude.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 7 - 95 | Upper limit of the threshold, in percent of amplitude. |
:MEASure:SETup:MAX 95 :MEASure:SETup:MAX?
Sets or queries the middle point of the threshold, expressed as a percentage of amplitude, for time, delay, and phase measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 6 - 94 | Middle point of the threshold. |
MEASure:SETup:MID 89 MEASure:SETup:MID?
Sets or queries the lower limit of the threshold, expressed as a percentage of amplitude, for time, delay, and phase measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| value | integer | 5 - 93 | Lower threshold limit value. |
:MEASure:SETup:MIN 53 /*Set the lower limit of the threshold to 53%*/ :MEASure:SETup:MIN? /*The query returns 53*/
Sets or queries source A for Phase 1→2 measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the source channel. |
:MEASure:SETup:PSA CHANnel1 :MEASure:SETup:PSA?
Set or query source B of Phase 1→2 and Phase 1→2 measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the source channel for phase measurement B. |
:MEASure:SETup:PSB CHANnel2 :MEASure:SETup:PSB? /*The query returns CHAN2*/
Sets or queries source A of Delay 1→2 measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Source A for the delay measurement. |
:MEASure:SETup:DSA CHANnel1 :MEASure:SETup:DSA?
Sets or queries source B for Delay 1→2 and Delay 1→2 measurements.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel1 | CHANnel2 | Source B selection. |
:MEASure:SETup:DSB CHANnel2 :MEASure:SETup:DSB?
Enable or disable the statistic function, or query the status of the statistic function.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | boolean | 1 | ON | 0 | OFF | Enables or disables the statistic function. |
:MEASure:STATistic:DISPlay ON :MEASure:STATistic:DISPlay?
Set or query the statistic mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | DIFFerence | EXTRemum | Selects the statistic mode. |
:MEASure:STATistic:MODE <mode> :MEASure:STATistic:MODE?
Clears the statistic history data and starts statistical measurement again.
Enables the statistic function for a specified waveform parameter of a source, or queries the statistic result for that parameter. Single-source parameters need one source; two-source measurements require two sources.
| Name | Type | Values | Description |
|---|---|---|---|
| item | discrete | VMAX | VMIN | VPP | VTOP | VBASe | VAMP | VAVG | VRMS | OVERshoot | PREShoot | MARea | MPARea | PERiod | FREQuency | RTIMe | FTIMe | PWIDth | NWIDth | PDUTy | NDUTy | RDELay | FDELay | RPHase | FPHase | TVMAX | TVMIN | PSLEWrate | NSLEWrate | VUPper | VMID | VLOWer | VARIance | PVRMS | PPULses | NPULses | PEDGes | NEDGes | Parameter to be measured or queried. |
| srcopt | discrete | CHANnel1 | CHANnel2 | MATH | Source of the measurement parameter. |
| srcopt | discrete | CHANnel1 | CHANnel2 | MATH | Second source for two-source measurements. |
| type | discrete | MAXimum | MINimum | CURRent | AVERages | DEViation | Statistic result type to query. |
Measures a waveform parameter of the specified source, or queries the measurement result for that parameter. Some items require one source and others require two; if omitted, the default sources are taken from the measurement source/setup commands.
| Name | Type | Values | Description |
|---|---|---|---|
| item | discrete | VMAX | VMIN | VPP | VTOP | VBASe | VAMP | VAVG | VRMS | OVERshoot | PREShoot | MARea | MPARea | PERiod | FREQuency | RTIMe | FTIMe | PWIDth | NWIDth | PDUTy | NDUTy | RDELay | FDELay | RPHase | FPHase | TVMAX | TVMIN | PSLEWrate | NSLEWrate | VUPper | VMID | VLOWer | VARIance | PVRMS | PPULses | NPULses | PEDGes | NEDGes | Measurement item to be measured or queried. |
| srcopt | discrete | CHANnel1 | CHANnel2 | MATH | Source of the parameter to be measured. |
| srcopt | discrete | CHANnel1 | CHANnel2 | MATH | Second source for measurements that require two sources. |
:MEASure:ITEM OVERshoot,CHANnel2 /*Enable the overshoot measurement of CH2*/ :MEASure:ITEM? OVERshoot,CHANnel2 /*The query returns 8.888889e-03*/
Enable or disable the REF function, or query its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the REF function. |
:REFerence:DISPlay ON :REFerence:DISPlay?
Enable or disable the specified reference channel, or query its status.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Specifies the reference channel number. |
| bool | boolean | - | Enables or disables the selected reference channel. |
:REFerence1:ENABle ON :REFerence1:ENABle?
Sets or queries the source of the current reference channel. Only enabled channels can be selected as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Reference channel number. |
| source | enum | CHANnel1 | CHANnel2 | MATH | Source selected for the current reference channel. |
:REFerence1:SOURce CHANnel1 :REFerence1:SOURce?
Set or query the vertical scale of the specified reference channel. The unit is the same as the unit of the source.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Reference channel number. |
| scale | real | 1mV - 10V | Vertical scale of the reference channel; the valid range depends on the probe ratio. |
:REFerence1:VSCale 2 :REFerence1:VSCale?
Set or query the vertical offset of the specified reference channel. The unit is the same as the unit of the source.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Specifies the reference channel number. |
| offset | real | -10 x RefVerticalScale - 10 x RefVerticalScale | Sets the vertical offset for the specified reference channel. |
\:REFerence1:VOFFset 0.5 \:REFerence1:VOFFset?
Reset the vertical scale and vertical offset of the specified reference channel to their default values.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Reference channel number to reset. |
Select the current reference channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | - | Reference channel number to select. |
Store the waveform of the current reference channel to internal memory as a reference waveform.
| Name | Type | Values | Description |
|---|---|---|---|
| n | integer | 1 - 10 | Reference channel number. |
Set or query the display color of the current reference channel.
| Name | Type | Values | Description |
|---|---|---|---|
| n | discrete | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | Reference channel number. |
| color | enum | GRAY | GREEn | LBLue | Magenta | ORANge | Display color for the reference channel. |
:REFerence1:COLor GREEn :REFerence1:COLor?
Sets or queries the image type used when storing images.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | PNG | BMP8 | BMP24 | JPEG | TIFF | Image file type to use when storing images. |
:STORage:IMAGe:TYPE PNG :STORage:IMAGe:TYPE?
Turns the invert function on or off when storing images, or queries the invert status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns the image invert function on or off. |
:STORage:IMAGe:INVERT ON /*Turn on the invert function when storing images*/ :STORage:IMAGe:INVERT? /*The query returns ON*/
Sets the image color used when storing images to color (ON) or intensity graded color (OFF), or queries the current image color setting.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | ON | OFF | Selects whether stored images use color or intensity graded color. |
:STORage:IMAGe:COLor ON /*Set the image color when storing images to color*/ :STORage:IMAGe:COLor? /*The query returns ON*/
Enables or disables the AUTO key on the front panel, or queries the AUTO key status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the AUTO key. |
:SYSTem:AUToscale ON :SYSTem:AUToscale?
Enables or disables the beeper, or queries its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Turns the beeper on or off. |
:SYSTem:BEEPer ON /*Enable the beeper*/ :SYSTem:BEEPer? /*The query returns 1*/
Queries and deletes the last system error message. The query returns the error message as "<message number>,<message content>".
Queries the number of grids in the horizontal direction of the instrument screen. The query always returns 12.
Set or query the system language.
| Name | Type | Values | Description |
|---|---|---|---|
| lang | enum | SCHinese | TCHinese | ENGLish | PORTuguese | GERMan | POLish | KORean | JAPAnese | FRENch | RUSSian | System language to select. |
:SYSTem:LANGuage SCHinese :SYSTem:LANGuage? /*The query returns SCH*/
Enable or disable the keyboard lock function, or query its status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables keyboard lock. |
Set or query the system configuration to be recalled when the oscilloscope is powered on again after power-off.
| Name | Type | Values | Description |
|---|---|---|---|
| pon | enum | LATest | DEFault | Configuration to recall on power-on. |
:SYSTem:PON LATest :SYSTem:PON?
Install an option license. The license is a 28-byte ASCII string; hyphens should be omitted and only uppercase letters and numbers are allowed.
| Name | Type | Values | Description |
|---|---|---|---|
| license | string | - | Option license to install. |
:SYSTem:OPTion:INSTall PDUY9N9QTS9PQSWPLAETRD3UJHYA
Uninstalls the installed options.
Query the number of analog channels of the instrument.
Imports the oscilloscope setting parameters from a previously saved setup stream to restore the instrument to a specified setting. The query form returns the current setup data for export/import use.
| Name | Type | Values | Description |
|---|---|---|---|
| setup_stream | block | - | The specified setting parameters of the oscilloscope; this must be the return value previously acquired from :SYSTem:SETup?. |
Enables or disables the delayed sweep, or queries the delayed sweep status.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables the delayed sweep. |
:TIMebase:DELay:ENABle ON :TIMebase:DELay:ENABle?
Set or query the delayed timebase offset. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | -(LeftTime - DelayRange/2) - (RightTime - DelayRange/2) | Delayed timebase offset. |
:TIMebase:DELay:OFFSet 0.000002 :TIMebase:DELay:OFFSet?
Sets or queries the delayed timebase scale. The default unit is s/div.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | 50/(current sample rate x amplification factor) - main timebase scale currently set | Delayed timebase scale. |
:TIMebase:DELay:SCALe 0.00000005 /*Set the delayed timebase scale to 50ns/div*/ :TIMebase:DELay:SCALe? /*The query returns 5.0000000e-08*/
Set or query the main timebase offset. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| offset | real | -0.5 x MemDepth/SampleRate - 10 x MainScale | Main timebase offset. |
:TIMebase:MAIN:OFFSet 0.0002 /*Set the main timebase offset to 20ms*/ :TIMebase:MAIN:OFFSet? /*The query returns 2.0000000e-04*/
Sets or queries the main timebase scale. The default unit is s/div.
| Name | Type | Values | Description |
|---|---|---|---|
| scale | real | 5ns/div - 50s/div | Main timebase scale. |
:TIMebase:MAIN:SCALe 0.0002 :TIMebase:MAIN:SCALe?
Set or query the mode of the horizontal timebase. MAIN corresponds to YT mode, XY to XY mode, and ROLL to Roll mode.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | MAIN | XY | ROLL | Horizontal timebase mode to select. |
:TIMebase:MODE XY :TIMebase:MODE? /*The query returns XY*/
Select or query the trigger type.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | EDGE | PULSe | RUNT | WIND | NEDG | SLOPe | VIDeo | PATTern | DELay | TIMeout | DURation | SHOLd | RS232 | IIC | SPI | Trigger type to select. |
:TRIGger:MODE SLOPe /*Select slope trigger*/ :TRIGger:MODE? /*The query returns SLOP*/
Selects or queries the trigger coupling type. It applies only to edge trigger with an analog channel source.
| Name | Type | Values | Description |
|---|---|---|---|
| couple | enum | AC | DC | LFReject | HFReject | Sets the trigger coupling type. |
:TRIGger:COUPling LFReject :TRIGger:COUPling?
Queries the current trigger status.
Set or query the trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| sweep | enum | AUTO | NORMal | SINGle | Selects the trigger mode. |
:TRIGger:SWEep SINGle :TRIGger:SWEep?
Set or query the trigger holdoff time. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| value | real | 16ns - 10s | Trigger holdoff time to set. |
:TRIGger:HOLDoff 0.0000002 :TRIGger:HOLDoff?
Enable or disable noise rejection, or query the status of noise rejection. Noise rejection reduces the possibility of noise trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| bool | enum | 1 | ON | 0 | OFF | Enables or disables noise rejection. |
:TRIGger:NREJect ON /*Enable noise rejection*/ :TRIGger:NREJect? /*The query returns 1*/
Query the position in internal memory that corresponds to the waveform trigger position.
:TRIGger:POSition? /*The query returns 100*/
Sets or queries edge trigger settings. The slice lists the edge trigger source and slope subcommands under this command.
":TRIGger:EDGe:SOURce CHANnel1" ":TRIGger:EDGe:SOURce?" ":TRIGger:EDGe:SLOPe NEGative" ":TRIGger:EDGe:SLOPe?"
Sets or queries the trigger source used for edge trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | AC | Trigger source for edge trigger. |
:TRIGger:EDGe:SOURce CHANnel1 :TRIGger:EDGe:SOURce?
Sets or queries the edge type in edge trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | RFALl | Selects the edge polarity used for edge triggering. |
:TRIGger:EDGe:SLOPe NEGative :TRIGger:EDGe:SLOPe?
Sets or queries the trigger level in edge trigger. The unit is the same as the current amplitude unit of the selected signal source.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level to set for edge triggering. |
:TRIGger:EDGe:LEVel 0.16 :TRIGger:EDGe:LEVel?
Set or query the pulse width trigger source. The query returns the current source as CHAN1 or CHAN2.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for pulse width trigger. |
Set or query the trigger source in pulse width trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for pulse width trigger. |
:TRIGger:PULSe:SOURce CHANnel1 /*Set the trigger source to CH1*/ :TRIGger:PULSe:SOURce? /*The query returns CHAN1*/
Sets or queries the trigger condition in pulse width trigger. Different conditions use either a specified pulse width or upper and lower pulse widths, depending on the selected mode.
| Name | Type | Values | Description |
|---|---|---|---|
| when | enum | PGReater | PLESs | NGReater | NLESs | PGLess | NGLess | Trigger condition for pulse width trigger. |
:TRIGger:PULSe:WHEN NLESs :TRIGger:PULSe:WHEN?
Sets or queries the pulse width in pulse width trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | 8ns - 10s | Pulse width to set. |
:TRIGger:PULSe:WIDTh 0.000003 :TRIGger:PULSe:WIDTh?
Sets or queries the upper pulse width in pulse width trigger. The default unit is seconds; the query returns the upper pulse width in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | 16ns - 10s | Upper pulse width value to set. |
:TRIGger:PULSe:UWIDth 0.000003 :TRIGger:PULSe:UWIDth?
Set or query the lower pulse width in pulse width trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| width | real | 8ns - 9.99s | Lower pulse width value. |
:TRIGger:PULSe:LWIDth 0.000003 :TRIGger:PULSe:LWIDth?
Set or query the trigger level in pulse width trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level. |
:TRIGger:PULSe:LEVel 0.16 :TRIGger:PULSe:LEVel?
Set the trigger source or trigger condition in slope trigger. The command list shows related slope-trigger subcommands for time, limits, window, and levels.
Sets or queries the trigger source in slope trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for slope trigger. |
:TRIGger:SLOPe:SOURce CHANnel2 :TRIGger:SLOPe:SOURce?
Set or query the trigger condition in slope trigger. For PGReater/PLESs and NGReater/NLESs, a time value is required; for PGLess/NGLess, upper and lower time limits are used.
| Name | Type | Values | Description |
|---|---|---|---|
| when | enum | PGReater | PLESs | NGReater | NLESs | PGLess | NGLess | Slope trigger condition. |
:TRIGger:SLOPe:WHEN PGLess :TRIGger:SLOPe:WHEN?
Sets or queries the time value used in slope trigger. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 8ns - 10s | Time value for the slope trigger. |
:TRIGger:SLOPe:TIME 0.000003 :TRIGger:SLOPe:TIME?
Sets or queries the upper limit of the time in slope trigger. The default unit is seconds, and the query returns the upper limit in scientific notation.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 16ns - 10s | Upper limit of the time in slope trigger. |
:TRIGger:SLOPe:TUPPer 0.000003 :TRIGger:SLOPe:TUPPer?
Set or query the lower limit of the time in slope trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| time | real | 8ns - 9.99s | Lower-limit time value for the slope trigger. |
:TRIGger:SLOPe:TLOWer 0.000003 :TRIGger:SLOPe:TLOWer?
Set or query the vertical window type in slope trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| window | enum | TA | TB | TAB | Vertical window type for slope trigger. TA adjusts only the upper limit, TB only the lower limit, and TAB adjusts both limits at the same time. |
:TRIGger:SLOPe:WINDow TB /*Set the vertical window type to TB*/ :TRIGger:SLOPe:WINDow? /*The query returns TB*/
Set or query the upper limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Upper limit of the trigger level. |
:TRIGger:SLOPe:ALEVel 0.16 /*Set the upper limit of the trigger level to 160mV*/ :TRIGger:SLOPe:ALEVel? /*The query returns 1.600000e-01*/
Sets or queries the lower limit of the trigger level in slope trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Lower limit of the trigger level. |
:TRIGger:SLOPe:BLEVel 0.16 :TRIGger:SLOPe:BLEVel?
Select or query the video trigger source in video trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for video trigger. |
:TRIGger:VIDeo:SOURce CHANnel2 :TRIGger:VIDeo:SOURce?
Selects the video trigger source, or queries the current source. The source can be set to channel 1 or channel 2.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel1 | CHANnel2 | Video trigger source. |
:TRIGger:VIDeo:SOURce CHANnel2 :TRIGger:VIDeo:SOURce?
Select or query the video polarity in video trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Video polarity to use for triggering. |
:TRIGger:VIDeo:POLarity POSitive /*Set or query the video polarity to positive*/ :TRIGger:VIDeo:POLarity? /*The query returns POS*/
Set or query the sync type in video trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | ODDField | EVENfield | LINE | ALINes | Sync type used for video trigger. |
:TRIGger:VIDeo:MODE <mode> :TRIGger:VIDeo:MODE?
Set or query the line number when the video trigger sync type is LINE. The valid line range depends on the selected video standard.
| Name | Type | Values | Description |
|---|---|---|---|
| line | integer | 1 - 525 | Line number to use for video trigger line selection. |
:TRIGger:VIDeo:LINE 100 :TRIGger:VIDeo:LINE?
Sets or queries the video standard used by video trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| standard | enum | PALSecam | NTSC | 480P | 576P | Video standard to use for triggering. |
:TRIGger:VIDeo:STANdard <standard> :TRIGger:VIDeo:STANdard?
Set or query the trigger level in video trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level for video trigger. |
:TRIGger:VIDeo:LEVel 0.16 :TRIGger:VIDeo:LEVel?
Set or query the pattern of each channel in pattern trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| pa_ch1 | enum | H | L | X | R | F | Pattern state for analog channel CH1. |
| pa_ch2opt | enum | H | L | X | R | F | Pattern state for analog channel CH2. |
:TRIGger:PATTern:PATTern H,R,L,X /*Set the pattern of CH1 to H. The pattern of CH2 remains unchanged*/ :TRIGger:PATTern:PATTern? /*The query returns H,X*/
Sets or queries the pattern of each channel in pattern trigger. When setting, <pa_ch1> and optional <pa_ch2> specify the CH1 and CH2 pattern states; omitted parameters leave the corresponding channel unchanged.
| Name | Type | Values | Description |
|---|---|---|---|
| pa_ch1 | enum | H | L | X | R | F | Pattern state for analog channel CH1. |
| pa_ch2opt | enum | H | L | X | R | F | Pattern state for analog channel CH2. |
:TRIGger:PATTern:PATTern H,R,L,X /*Set the pattern of CH1 to H. The pattern of CH2 remains unchanged*/ :TRIGger:PATTern:PATTern? /*The query returns H,X*/
Sets or queries the trigger level of the specified channel in pattern trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| chan | discrete | CHANnel1 | CHANnel2 | Specified channel. |
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level to set. |
:TRIGger:PATTern:LEVel CHANnel2,0.16 :TRIGger:PATTern:LEVel? CHANnel2
Set or query the pattern of each channel in duration trigger. Users can send one or two channel pattern values; omitting the second parameter leaves CH2 unchanged.
| Name | Type | Values | Description |
|---|---|---|---|
| type_ch1 | enum | H | L | X | Pattern state for CH1. |
| type_ch2opt | enum | H | L | X | Pattern state for CH2. |
Sets or queries the trigger source used in duration trigger mode.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for duration trigger. |
:TRIGger:DURATion:SOURce CHANnel2 :TRIGger:DURATion:SOURce?
Set or query the pattern of each channel in duration trigger. You can send one value to set CH1 only, or two comma-separated values to set both channels.
| Name | Type | Values | Description |
|---|---|---|---|
| type_ch1 | enum | H | L | X | Pattern state for CH1 in the duration trigger. |
| type_ch2opt | enum | H | L | X | Pattern state for CH2 in the duration trigger. |
Sets or queries the trigger condition in duration trigger. The condition determines whether the oscilloscope triggers when the pattern duration is greater than, less than, or within the specified time limits.
| Name | Type | Values | Description |
|---|---|---|---|
| when | enum | GREater | LESS | GLESs | Trigger condition for duration trigger. |
:TRIGger:DURATion:WHEN LESS :TRIGger:DURATion:WHEN? /*The query returns LESS*/
Sets or queries the duration time upper limit in duration trigger. The default unit is seconds, and the command is available when the trigger condition is LESS or GLESs.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 8ns - 10s | Duration time upper limit; valid range depends on the trigger condition (LESS or GLESs). |
:TRIGger:DURATion:TUPPer 0.000003 :TRIGger:DURATion:TUPPer?
Set or query the duration time lower limit in duration trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 8ns - 9.99s | Duration time lower limit. |
:TRIGger:DURATion:TLOWer 0.000003 :TRIGger:DURATion:TLOWer?
Set or query the timeout trigger source, edge slope, or timeout time via the related subcommands. The command list shows the available subcommands for timeout triggering.
Set or query the trigger source in timeout trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the timeout trigger source channel. |
:TRIGger:TIMeout:SOURce CHANnel2 /*Set the trigger source to CH2*/ :TRIGger:TIMeout:SOURce? /*The query returns CHAN2*/
Set or query the edge type in timeout trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | RFALl | Edge type used to start timing when the input signal crosses the trigger level. |
:TRIGger:TIMeout:SLOPe NEGative :TRIGger:TIMeout:SLOPe?
Set or query the timeout time in the timeout trigger. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 16ns - 10s | Timeout time value. |
:TRIGger:TIMeout:TIMe 0.002 :TRIGger:TIMeout:TIMe? /*The query returns 2.000000e-03*/
Selects the trigger source used for runt triggering, or queries the current source. The source can be set to channel 1 or channel 2.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for runt trigger. |
:TRIGger:RUNT:SOURce CHANnel2 :TRIGger:RUNT:SOURce?
Sets or queries the trigger source in runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for runt trigger. |
:TRIGger:RUNT:SOURce CHANnel2 /*Set the trigger source to CH2*/ :TRIGger:RUNT:SOURce? /*The query returns CHAN2*/
Set or query the pulse polarity in runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| polarity | enum | POSitive | NEGative | Selects whether the instrument triggers on the positive or negative runt pulse. |
:TRIGger:RUNT:POLarity NEGative :TRIGger:RUNT:POLarity? /*The query returns NEG*/
Set or query the qualifier in the runt trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| when | enum | NONE | GREater | LESS | GLESs | Qualifier for the runt trigger condition. |
:TRIGger:RUNT:WHEN LESS :TRIGger:RUNT:WHEN?
Sets or queries the pulse width upper limit in runt trigger. The default unit is seconds, and the command is only available when the runt trigger qualifier is LESS or GLESs.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 8ns - 10s | Pulse width upper limit; the valid range depends on the runt trigger qualifier. |
:TRIGger:RUNT:WUPPer 0.02 :TRIGger:RUNT:WUPPer?
Sets or queries the pulse width lower limit in runt trigger. This command is only available when :TRIGger:RUNT:WHEN is GREater or GLESs.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 8ns - 10s | Pulse width lower limit; range is 8 ns to 10 s when the qualifier is GREater. |
:TRIGger:RUNT:WLOWer 0.01 :TRIGger:RUNT:WLOWer?
Set or query the trigger level upper limit in runt trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level upper limit for runt trigger. |
:TRIGger:RUNT:ALEVel 0.16 :TRIGger:RUNT:ALEVel?
Sets or queries the trigger level lower limit in runt trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level lower limit for runt trigger. |
:TRIGger:RUNT:BLEVel 0.16 /*Set the trigger level lower limit to 160mV*/ :TRIGger:RUNT:BLEVel? /*The query returns 1.600000e-01*/
Set or query the trigger source in windows trigger.
Sets or queries the trigger source in windows trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel1 | CHANnel2 | Trigger source for windows trigger. |
:TRIGger:WINDows:SOURce CHANnel2 :TRIGger:WINDows:SOURce?
Sets or queries the windows trigger slope/type in the windows trigger system.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | POSitive | NEGative | RFALl | Windows trigger slope/type to set. |
:TRIGger:WINDows:SLOPe NEGative :TRIGger:WINDows:SLOPe?
Sets or queries the trigger position in windows trigger. The position can be EXIT, ENTER, or TIMe.
| Name | Type | Values | Description |
|---|---|---|---|
| pos | enum | EXIT | ENTER | TIMe | Selects when the trigger occurs relative to the specified trigger level range. |
:TRIGger:WINDows:POSition ENTER /*Set the trigger position to enter*/ :TRIGger:WINDows:POSition? /*The query returns ENTER*/
Set or query the hold time in windows trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| hold time | real | 8ns - 10s | Hold time for the windows trigger. |
:TRIGger:WINDows:TIMe 0.002 :TRIGger:WINDows:TIMe?
Sets or queries the trigger level upper limit in windows trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level upper limit. |
:TRIGger:WINDows:ALEVel 0.16 :TRIGger:WINDows:ALEVel?
Set or query the trigger level lower limit in windows trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level lower limit. |
:TRIGger:WINDows:BLEVel 0.05 :TRIGger:WINDows:BLEVel?
Set or query the trigger source A in delay trigger. The command selects channel 1 or 2 as the source.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source A for delay trigger. |
Sets or queries the trigger source A in delay trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source A for delay trigger. |
:TRIGger:DELay:SA CHANnel2 :TRIGger:DELay:SA?
Set or query the edge type of edge A in delay trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects the edge type for delay trigger edge A. |
Sets or queries trigger source B in delay trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the trigger source B. |
:TRIGger:DELay:SB CHANnel2 /*Set the trigger source B to CH2*/ :TRIGger:DELay:SB? /*The query returns CHAN2*/
Set or query the edge type of edge B in delay trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Edge type of edge B in delay trigger. |
:TRIGger:DELay:SLOPB NEGative :TRIGger:DELay:SLOPB?
Sets or queries the delay type in delay trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | GREater | LESS | GLESs | GOUT | Selects the delay trigger comparison mode. |
:TRIGger:DELay:TYPe GOUT :TRIGger:DELay:TYPe?
Sets or queries the upper limit of the delay time in delay trigger. The default unit is seconds, and the command is only available when the delay type is LESS, GOUT, or GLESs.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 16ns - 10s | Upper limit of the delay time. |
:TRIGger:DELay:TUPPer 0.002 :TRIGger:DELay:TUPPer?
Sets or queries the lower limit of the delay time in delay trigger. The default unit is seconds, and the command is only available when the delay type is GREater, GOUT, or GLESs.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 8ns - 10s | Lower limit of the delay time; valid range depends on the delay type. |
:TRIGger:DELay:TLOWer 0.002 :TRIGger:DELay:TLOWer?
Set or query the data source in setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Data source for the setup/hold trigger. |
:TRIGger:SHOLd:DSrc CHANnel1 /*Set the data source to CH1*/ :TRIGger:SHOLd:DSrc? /*The query returns CHAN1*/
Sets or queries the data source in setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Data source selection. |
:TRIGger:SHOLd:DSrc CHANnel1 :TRIGger:SHOLd:DSrc?
Sets or queries the clock source in setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the clock source. |
:TRIGger:SHOLd:CSrc CHANnel2 /*Set the clock source to CH2*/ :TRIGger:SHOLd:CSrc? /*The query returns CHAN2*/
Sets or queries the edge type in the setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects the trigger edge type. |
:TRIGger:SHOLd:SLOPe NEGative /*Set the edge type to falling edge*/ :TRIGger:SHOLd:SLOPe? /*The query returns NEG*/
Set or query the data type in setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| pattern | enum | H | L | Selects the pattern used by the setup/hold trigger. |
:TRIGger:SHOLd:PATTern L :TRIGger:SHOLd:PATTern?
Set or query the setup type in setup/hold trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| type | enum | SETup | HOLd | SETHOLd | Selects the setup/hold trigger mode. |
:TRIGger:SHOLd:TYPe SETHOLd :TRIGger:SHOLd:TYPe?
Set or query the setup time in setup/hold trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| NR3 | real | 8ns - 1s | Setup time value. |
:TRIGger:SHOLd:STIMe 0.002 :TRIGger:SHOLd:STIMe?
Set or query the hold time in setup/hold trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 8ns - 1s | Hold time value. |
:TRIGger:SHOLd:HTIMe 0.002 /*Set the hold time to 2ms*/ :TRIGger:SHOLd:HTIMe? /*The query returns 2.000000e-03*/
Nth edge trigger subsystem command. It provides subcommands for setting the trigger source and slope.
Sets or queries the trigger source in Nth edge trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source for Nth edge trigger. |
:TRIGger:NEDGe:SOURce CHANnel2 /*Set the trigger source to CH2*/ :TRIGger:NEDGe:SOURce? /*The query returns CHAN2*/
Set or query the edge type in Nth edge trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects whether to trigger on the rising or falling edge of the input signal. |
:TRIGger:NEDGe:SLOPe NEGative :TRIGger:NEDGe:SLOPe?
Set or query the idle time in Nth edge trigger. The default unit is s.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR3> | real | 16ns - 10s | Idle time in Nth edge trigger. |
:TRIGger:NEDGe:IDLE 0.002 :TRIGger:NEDGe:IDLE?
Set or query the number of edges in Nth edge trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| <NR1> | integer | 1 - 65535 | Number of edges in Nth edge trigger. |
:TRIGger:NEDGe:EDGE 20 :TRIGger:NEDGe:EDGE?
Set or query the trigger level in Nth edge trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level. |
:TRIGger:NEDGe:LEVel 0.16 :TRIGger:NEDGe:LEVel?
Set the RS232 trigger configuration. The page lists the related RS232 trigger subcommands but does not document syntax, parameters, or return value for :TRIGger:RS232 itself.
Set or query the trigger source in RS232 trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Trigger source. |
:TRIGger:RS232:SOURce CHANnel2 :TRIGger:RS232:SOURce?
Set or query the RS232 trigger condition.
| Name | Type | Values | Description |
|---|---|---|---|
| when | enum | STARt | ERRor | PARity | DATA | RS232 trigger condition. |
:TRIGger:RS232:WHEN ERRor /*Set the trigger condition to error frame*/ :TRIGger:RS232:WHEN? /*The query returns ERR*/
Sets or queries the RS232 trigger parity type when the trigger condition is ERRor or PARity. When the trigger condition is PARity, NONE cannot be selected and the default parity is ODD.
| Name | Type | Values | Description |
|---|---|---|---|
| parity | enum | EVEN | ODD | NONE | Parity type to use for the RS232 trigger condition. |
:TRIGger:RS232:PARity EVEN /*Set the parity type to even*/ :TRIGger:RS232:PARity? /*The query returns EVEN*/
Set or query the stop bit when the trigger condition is ERRor in RS232 trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| bit | integer | 1 | 2 | Stop bit value. |
:TRIGger:RS232:STOP 2 /*Set the stop bit to 2*/ :TRIGger:RS232:STOP? /*The query returns 2*/
Set or query the data when the trigger condition is DATA in RS232 trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | 0 - 2n-1 | Data value to use for the RS232 trigger condition. |
:TRIGger:RS232:DATA 10 /*Set the data to 10*/ :TRIGger:RS232:DATA? /*The query returns 10*/
Sets or queries the data bits when the trigger condition is DATA in RS232 trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| width | enum | 5 | 6 | 7 | 8 | Data bits width for RS232 trigger. |
:TRIGger:RS232:WIDTh 6 :TRIGger:RS232:WIDTh?
Set or query the baud rate in RS232 trigger. The default unit is bps.
| Name | Type | Values | Description |
|---|---|---|---|
| baud_rate | enum | 2400 | 4800 | 9600 | 19200 | 38400 | 57600 | 115200 | 230400 | 460800 | 921600 | 1000000 | USER | Baud rate used for the RS232 trigger. |
:TRIGger:RS232:BAUD 4800 :TRIGger:RS232:BAUD?
Set or query the user-defined baud rate in RS232 trigger. The default unit is bps.
| Name | Type | Values | Description |
|---|---|---|---|
| user baud | integer | 110 - 20000000 | User-defined baud rate used for the RS232 trigger. |
:TRIGger:RS232:BUSer 50000 :TRIGger:RS232:BUSer?
Set or query the trigger level in RS232 trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level. |
:TRIGger:RS232:LEVel 0.16 /*Set the trigger level to 160mV*/ :TRIGger:RS232:LEVel? /*The query returns 1.600000e-01*/
Sets or queries the channel source of SCL in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | - | Channel source for SCL in the I2C trigger. |
:TRIGger:IIC:SCL CHANnel2 /*Set the SCL source to CH2*/ :TRIGger:IIC:SCL? /*The query returns CHAN2*/
Sets or queries the channel source of SCL in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel1 | CHANnel2 | Channel source for SCL. |
:TRIGger:IIC:SCL CHANnel2 :TRIGger:IIC:SCL?
Set or query the channel source of SDA in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | discrete | CHANnel1 | CHANnel2 |
*:TRIGger:IIC:SDA CHANnel2 *:TRIGger:IIC:SDA?
Sets or queries the trigger condition in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| trig_type | enum | STARt | RESTart | STOP | NACKnowledge | ADDRess | DATA | ADATa | Trigger condition to use for I2C triggering. |
:TRIGger:IIC:WHEN RESTart :TRIGger:IIC:WHEN?
Sets or queries the number of address bits used for I2C trigger conditions ADDRess or ADATa.
| Name | Type | Values | Description |
|---|---|---|---|
| bits | enum | 7 | 8 | 10 | Number of address bits to use. |
:TRIGger:IIC:AWIDth 10 :TRIGger:IIC:AWIDth?
Sets or queries the I2C trigger address when the trigger condition is ADDRESS or DATA. The allowed range depends on the current address bits.
| Name | Type | Values | Description |
|---|---|---|---|
| adr | integer | 0 - 2^n-1 | I2C trigger address. |
:TRIGger:IIC:ADDRess 100 :TRIGger:IIC:ADDRess?
Set or query the data direction when the trigger condition is ADDRess or ADATa in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| dir | enum | READ | WRITe | RWRite | Selects the I2C trigger data direction. |
:TRIGger:IIC:DIRection RWRite /*Set the data direction to read/write*/ :TRIGger:IIC:DIRection? /*The query returns RWR*/
Set or query the data when the trigger condition is DATA or ADATa in I2C trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | 0 - 2^40-1 | Data value to use for the I2C trigger. |
:TRIGger:IIC:DATA 64 :TRIGger:IIC:DATA?
Sets or queries the trigger level of SCL in I2C trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level for SCL in I2C trigger. |
:TRIGger:IIC:CLEVel 0.16 :TRIGger:IIC:CLEVel?
Set or query the trigger level of SDA in I2C trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level for SDA in I2C trigger. |
:TRIGger:IIC:DLEVel 0.16 :TRIGger:IIC:DLEVel?
Command list entry for SPI trigger settings. This slice only identifies the related subcommands; it does not document any direct action for :TRIGger:SPI itself.
Sets or queries the channel source of SCL in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Channel source for SCL. |
:TRIGger:SPI:SCL CHANnel1 :TRIGger:SPI:SCL?
Sets or queries the channel source of SDA in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Channel source for SDA. |
:TRIGger:SPI:SDA CHANnel2 :TRIGger:SPI:SDA?
Set or query the trigger condition in SPI trigger. When the trigger condition is set to TIMeout, use :TRIGger:SPI:TIMeout to set the timeout value.
| Name | Type | Values | Description |
|---|---|---|---|
| trig_type | enum | CS | TIMeout | Trigger condition to use for SPI triggering. |
:TRIGger:SPI:WHEN TIMeout :TRIGger:SPI:WHEN?
Set or query the data bits of the SDA channel in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| width | integer | 4 - 32 | Number of data bits of the SDA channel. |
:TRIGger:SPI:WIDTh 10 :TRIGger:SPI:WIDTh?
Set or query the data in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| data | integer | 0 - 2^32-1 | Data value for the SPI trigger. |
:TRIGger:SPI:DATA 5 :TRIGger:SPI:DATA?
Sets or queries the SPI trigger timeout value when the trigger condition is TIMeout. The default unit is seconds.
| Name | Type | Values | Description |
|---|---|---|---|
| time_value | real | 100ns - 1s | Timeout value to use for the SPI trigger TIMeout condition. |
:TRIGger:SPI:TIMeout 0.001 :TRIGger:SPI:TIMeout?
Set or query the clock edge in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| slope | enum | POSitive | NEGative | Selects which clock edge is used for SPI sampling. |
:TRIGger:SPI:SLOPe POSitive /*Set the clock edge to POSitive*/ :TRIGger:SPI:SLOPe? /*The query returns POS*/
Set or query the trigger level of the SCL channel in SPI trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | (-5 x VerticalScale - OFFSet) - (5 x VerticalScale - OFFSet) | Trigger level of the SCL channel. |
:TRIGger:SPI:CLEVel 0.16 :TRIGger:SPI:CLEVel? /*The query returns 1.600000e-01*/
Sets or queries the trigger level of the SDA channel in SPI trigger. The level uses the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet |
:TRIGger:SPI:DLEVel 0.16 :TRIGger:SPI:DLEVel?
Set or query the trigger level of the CS channel in SPI trigger. The unit is the same as the current amplitude unit.
| Name | Type | Values | Description |
|---|---|---|---|
| level | real | -5 x VerticalScale - OFFSet - 5 x VerticalScale - OFFSet | Trigger level for the CS channel in SPI trigger. |
:TRIGger:SPI:SLEVel 0.16 :TRIGger:SPI:SLEVel?
Set or query the CS mode when the trigger condition is CS in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | HIGH | LOW | CS mode for SPI trigger. |
:TRIGger:SPI:MODE LOW :TRIGger:SPI:MODE?
Sets or queries the data source of the CS signal in SPI trigger.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | Selects the CS signal data source. |
:TRIGger:SPI:CS CHANnel2 :TRIGger:SPI:CS?
Sets or queries the channel from which waveform data will be read. If MATH is selected, only NORMal can be selected in :WAVeform:MODE.
| Name | Type | Values | Description |
|---|---|---|---|
| source | enum | CHANnel1 | CHANnel2 | MATH | Selects the waveform source channel. |
:WAVeform:SOURce CHANnel2 :WAVeform:SOURce?
Set or query the waveform reading mode used by :WAVeform:DATA?.
| Name | Type | Values | Description |
|---|---|---|---|
| mode | enum | NORMal | MAXimum | RAW | Selects the waveform data reading mode. |
:WAVeform:MODE <mode> :WAVeform:MODE?
Set or query the return format of the waveform data. The query returns the current format.
| Name | Type | Values | Description |
|---|---|---|---|
| format | enum | WORD | BYTE | ASCii | Return format of the waveform data. |
:WAVeform:FORMat WORD :WAVeform:FORMat? /*The query returns WORD*/
Reads the waveform data. The returned data format depends on the currently selected :WAVeform:FORMat setting; in WORD or BYTE mode the response includes a TMC data description header followed by waveform data, and in ASCii mode it returns voltage values in scientific notation separated by commas.
:WAV:DATA?
Queries the time difference between two neighboring points of the specified channel source in the X direction. The returned value depends on the current data reading mode and channel source.
:WAVeform:XINCrement? /*The query returns 1.000000e-08*/
Queries the start time of the waveform data for the currently selected X-direction source. The returned value depends on the current data reading mode and channel source, and is returned in scientific notation.
:WAVeform:XORigin? /*The query returns -6.000000e-06*/
Queries the reference time of the specified channel source in the X direction.
Queries the waveform increment of the specified channel source in the Y direction. The unit is the same as the current amplitude unit, and the value depends on the current data reading mode.
:WAVeform:YINCrement? /*The query returns 8.000000e-03*/
Queries the vertical offset relative to the vertical reference position of the specified channel source in the Y direction. The returned integer depends on the current waveform data reading mode.
:WAVeform:YORigin? /*The query returns 25*/
Query the vertical reference position of the specified channel source in the Y direction. YREFerence is always 127 (the screen bottom is 0 and the screen top is 255).
Set or query the start point of waveform data reading. The valid range depends on the current waveform data reading mode and memory depth.
| Name | Type | Values | Description |
|---|---|---|---|
| sta | integer | 1 - 1200 | Start point of waveform data reading. |
| qualifieropt | enum | NORMal | MAX | RAW | Selects the range context for the start point: NORMal, MAX, or RAW. |
:WAVeform:STARt 100 :WAVeform:STARt? /*The query returns 100*/
Set or query the stop point of waveform data reading.
| Name | Type | Values | Description |
|---|---|---|---|
| stop | integer | 1 - 1200 | Stop point of waveform data reading; the valid range depends on the waveform data format and memory depth. NORMal allows 1 to 1200, MAX allows 1 to the number of effective points currently on the screen, and RAW allows 1 to the current maximum memory depth. |
:WAVeform:STOP 500 :WAVeform:STOP? /*The query returns 500*/
Queries and returns all waveform parameters as a comma-separated list of 10 values.
:WAVeform:PREamble? /*The query returns 0,2,6000000,1,1.000000e-09,-3.000000e-03,0,4.132813e-0 1,0,122*/