/

Rigol

/

Rigol DS1204B

SCPI COMMAND REFERENCE

Rigol DS1204B

Rigol DS1204B

The Rigol DS1204B is Rigol's oscilloscope in the DS1000B Series Digital Oscilloscope family. Its SCPI remote-control interface exposes 305 commands across 28 subsystems - 167 settable and 138 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.

305

Commands

167

Settable

138

Queries

28

Subsystems

SCPI

Verified

2026-07-16

All commands

Clears the queue of error information.

string - Returns the error information from the queue.

Downloads the system setup data. The setup data is binary data that uses the IEEE 488.2 definite-length block (#) format.

NameTypeValuesDescription
setup_datablock-Binary system setup data to download.
block - Returns the value of the system setup data.
:SYSTem:SETup <setup_data>
:SYSTem:ERRorset / query

Returns the next system error in the error queue. Repeated queries retrieve subsequent errors until the queue is empty.

string - The next error message from the system error queue, typically as an error code and text.
:SYSTem:SETupset / query

Sets up the system. The quick reference lists the command but does not provide syntax details, parameters, or a return value in this slice.

Sets the acquisition mode. The mode may be real-time sample or equal-time sample.

enum - Returns the present acquisition mode.
:ACQ:MODE ETIM
:ACQ:MODE?

Sets the acquisition type. The available types are NORMal, AVERage, and PEAKdetect.

enum - Returns the current acquisition type as NORMal, AVERAGE, or PEAKDETECT.
:ACQ:TYPE AVERage Set the acquisition type as average acquisition.
:ACQ:TYPE? Return AVERAGE.

Sets the average acquisition count. The count range is 2 to 256 and must be a power of 2.

NameTypeValuesDescription
countinteger2 - 256Average acquisition count.
integer - Returns the current average acquisition count as one of 2, 4, 8, 16, 32, 64, 128, or 256.
:ACQ:AVER 16 Set the average acquisition time as 16.
:ACQ:AVER? Return 16.

Sets the averaging mode for acquisition. It is listed in the quick reference as an acquisition command.

Returns the current acquisition sample rate.

real (Sa/s) - The present acquisition sample rate.
:ACQuire:TYPEset / query

Selects the acquisition type.

NameTypeValuesDescription
typeenum-

Sets the display type of the screen grid. The grid setting may be FULL, HALF, or NONE, and the query returns the current grid state.

enum - Returns the current screen grid setting.
:DISP:GRID FULL Make grid and coordinate shown.
:DISP:GRID? Return FULL.

Sets the display type of acquisition points. The query returns the current display type, either VECTORS or DOTS.

enum - Returns VECTORS or DOTS.
[:DISP:TYPE] VECT
[:DISP:TYPE]?

Sets the display time of the on-screen menu; the menu hides after the selected time. The query returns the current menu display time.

NameTypeValuesDescription
timeenum1s | 2s | 5s | 10s | 20s | INFiniteMenu display time before the menu is hidden.
enum - Returns the current menu display time.
:DISP:MNUD 10s Set the display time as 10s.
:DISP:MNUD? Return 10s.

Queries the waveform persist state. The query returns 1 for ON or 0 for OFF.

enum - Returns 1 or 0, respectively indicating ON or OFF.
*none provided in slice*

Queries the menu display function state. The query returns 1 when menu display is ON and 0 when it is OFF.

enum - Returns 1 for ON and 0 for OFF.
:DISP:MNUS? Return 1.

Sets the display mode of the screen. The mode may be normal or inverted.

enum - Returns the current screen display mode as NORMAL or INVERTED.
:DISP:SCR NORM Set the screen as normal display mode.
:DISP:SCR? Return NORMAL.

Returns or sets the display grid brightness. The setting range is 0 to 100, with larger values making the grid brighter.

integer - Returns the current grid brightness as a value from 0 to 100.
:DISP:BRIG? Return 10.

Queries the brightness of the waveform on the screen. The returned value is in the range 0 to 100.

integer - Returns the waveform brightness as a value from 0 to 100.
:DISP:IN? Return 12.
:DISPlay:CLEarset / query

Clears the display. The command is listed in the Display command group in the quick reference.

Returns the screen display data. The command is a query and does not take parameters.

block - Screen display data.
:DISPlay:GRIDset / query

Sets the display grid on or off.

NameTypeValuesDescription
stateenumON | OFFTurns the display grid on or off.

Sets the display intensity. This command adjusts how bright the display appears.

NameTypeValuesDescription
intensityreal0 - 100Display intensity level.

Sets the menu display state.

NameTypeValuesDescription
stateenum-Menu display state.

Sets the menu display status. The command appears in the display subsystem quick reference.

:DISPlay:SCReenset / query

Sets the display to show the screen view. The command is listed in the quick reference under display commands.

:DISPlay:TYPEset / query

Sets the display type. The command is listed in the quick reference under display commands.

NameTypeValuesDescription
typeenum-

Sets the timebase offset of main mode, i.e. the waveform position relative to the center of the screen. The query returns the current timebase offset in seconds.

real (s) - Returns the value of the timebase offset.
:TIM:OFFS? Return 1.000e000.

Sets the scan mode of the horizontal timebase to MAIN or DELayed. The query returns MAIN or DELAYED.

enum - Returns the current scan mode of the horizontal timebase.
:TIM:MODE MAIN Set the scan mode as main time base.
:TIM:MODE? Return MAIN.

Sets the timebase offset of delayed scan, i.e. the waveform position relative to center screen. The query returns the offset value in seconds.

real (s) - Returns the value of offset.
:TIM:DEL:OFFS? Return 1.000e000.

Sets the timebase scale of delayed scan. When Delayed is ON, changing this scale enlarges the waveform window to view waveform details.

NameTypeValuesDescription
scale_valreal1ns/div - 50s/divTimebase scale for delayed scan.
real (s) - Returns the value of the delayed timebase scale.
:TIMebase:DELayed:SCALe <scale_val>
:TIMebase:DELayed:SCALe?

Sets or queries the main timebase scale. The unit is s/div; in NORMAL mode the allowed range depends on instrument model, and in SCAN mode the range is 50 ms to 50 s.

real (s) - Returns the timebase scale value.
:TIM:MODE MAIN Set the scan mode as main.
:TIM:SCAL 2 Set the timebase scale as 2s.
:TIM:SCAL? Return 2.000e000.

Sets the timebase format to XY, YT, or ROLL. The query returns the current timebase format.

enum - Returns X-Y or Y-T, ROLL.
:TIM:FORM YT Set the timebase format as Y-T.
:TIM:FORM? Return Y-T.

Sets the delayed timebase scale.

NameTypeValuesDescription
scalereal-Delayed timebase scale value.

Sets the timebase main offset. The command is documented in the quick reference only; no parameter details or return value are given in this slice.

Sets the main timebase scale.

NameTypeValuesDescription
scalereal1.0 ns/div - 50.0 s/divTimebase scale for the main timebase.

Queries the current trigger mode. The query returns EDGE, PULSE, VIDEO, ALTERNATION, or PATTERN.

enum - Returns the present trigger mode.
:TRIG:MODE? Return EDGE.

Sets the trigger coupling mode. The query returns the current coupling mode.

enum - Returns the trigger coupling mode.

Sets the trigger sensitivity. The value range is 0.1 div to 1 div.

NameTypeValuesDescription
countreal0.1 - 1Trigger sensitivity value in divisions.
real (div) - Returns the trigger sensitivity value in divisions.
:TRIG:SENS 0.2 Set the trigger sensitivity as 0.2div.
:TRIG:SENS? Return 2.000e-001.

Sets the high frequency reject trigger function on or off. The query returns 1 or 0, indicating ON or OFF, respectively.

enum - Returns 1 or 0, indicating ON or OFF, respectively.
:TRIG:HFRE ON
:TRIG:HFRE?

Returns or sets the trigger edge slope. The setting can be POSitive (rising edge), NEGative (falling edge), or ALTernation (rising and falling edge).

enum - Returns the present trigger edge slope as POSITIVE, NEGATIVE, or ALTERNATION.
:TRIG:EDGE:SLOP? Return POSITIVE.

Returns the current pulse trigger mode. The query yields one of the listed pulse polarity/width relation states.

enum - Returns the current pulse trigger mode as one of the documented states.
:TRIG:PULS:MODE? Return +GREATER THAN.

Sets the pulse width for pulse trigger conditions. The query returns the current pulse width in seconds.

real (s) - Returns the value of pulse width.

Returns the video trigger sync mode. The query yields ODD FIELD, EVEN FIELD, LINE, or ALL LINES.

enum - Returns the trigger sync mode.
:TRIG:VIDEO:MODE? Return EVEN FIELD.

Sets the video trigger polarity. POSitive is for a video signal where the black level is low, and NEGative is for a video signal where the black level is high.

NameTypeValuesDescription
polarityenumPOSitive | NEGativeVideo trigger polarity.
enum - Returns the current video polarity.
:TRIG:VIDEO:POL POS Set the video polarity as positive.
:TRIG:VIDEO:POL? Return POSITIVE.

Sets the specified sync line number for video trigger. The valid range depends on the video standard: 1 to 525 for NTSC and 1 to 625 for PAL.

integer - Returns the specified line number.
:TRIG:VIDEO:LINE 25 Set the specified sync line number as 25.
:TRIG:VIDEO:LINE? Return 25.

Sets the video standard as NTSC or PAL/SECAM. The query returns the current video standard.

enum - Returns the video standard.
:TRIG:VIDEO:STAN PALS
:TRIG:VIDEO:STAN?

Sets or queries the code pattern used for pattern triggering. The query returns the stored value, mask, external source, edge source, and edge setting.

string - Returns the value, mask, ext source, edge source, and edge. The value and mask are expressed in decimal.
:TRIG:PATT:PATT? Return 27, 31, EXT5, Channel3, Positive.

Sets the current alternation trigger source. The source depends on the current alternation channel and may be Source A or Source B.

enum - Returns the current source selection for the alternation trigger.
:TRIG:ALT:CURRSOUR SOURB Set the current channel as source B.
:TRIG:ALT:CURRSOUR? Return SOURceB.

Selects the alternation trigger channel. The query returns the currently selected alternation trigger channel.

enum - Returns the selected alternation trigger channel.
:TRIG:ALT:SOUR? Return CH1CH2.

Queries the trigger type for the alternating trigger source. The query may optionally specify a source; it returns EDGE, PULSE, or VIDEO.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects the alternation source to query.
enum - Returns the trigger type for the specified alternation source.
:TRIG:ALT:TYPE EDGE,SOURB Set the trigger type as edge trigger.
:TRIG:ALT:TYPE? SOURB Return EDGE.

Sets or queries the time scale of the current alternation channel. The value range is 2 ns to 20 ms, and the source may be SourceA or SourceB depending on the current alternation channel.

NameTypeValuesDescription
valuereal2ns - 20msTime scale value to set.
sourceoptenumSOURceA | SOURceBSelects the alternation source channel.
real (s) - Returns the current time scale value.
:TRIG:ALT:TSCAL 0.001,SOURB
:TRIG:ALT:TSCAL? SOURB

Sets the trigger level of the current channel in alternate trigger mode. The query returns the trigger voltage level, in volts, for the specified source.

NameTypeValuesDescription
valuereal-6*Scale-Offset① - +6*Scale+Offset①Trigger level value to set.
sourceoptenumSOURceA | SOURceBSelects the alternate trigger source.
real (V) - Returns the trigger voltage level for the specified source.
:TRIG:ALT:LEV 2, SOURB Set the trigger voltage level as 2V.
:TRIG:ALT:LEV? SOURB Return 2.000e000.

Queries the timebase offset. An optional source can be specified.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects the source channel for the query.
real (s) - Returns the value of the timebase offset in seconds.
:TRIG:ALT:TOFFS? SOURB Return 2.000e-004.

Queries the edge type of the edge trigger in the current channel. The query can be qualified by source A or source B.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects source A or source B for the current alternation channel.
enum - Returns the edge type as POSITIVE or NEGATIVE.
:TRIG:ALT:EDGE:SLOP? SOURB Return POSITIVE.

Sets the trigger condition of pulse trigger for the current alternation channel. The source may be SOURCEA or SOURCEB, which vary with the current alternation channel.

NameTypeValuesDescription
valueenum+GREaterthan | +LESSthan | +EQUal | -GREaterthan | -LESSthan | –EQUalTrigger condition to set.
sourceoptenumSOURceA | SOURceBSelects the source channel.
enum - Returns the pulse trigger condition for the selected source.
:TRIG:ALT:PULS:MODE +GRE, SOURB
:TRIG:ALT:PULS:MODE? SOURB

Sets or queries the pulse width used for alternate triggering. The optional source selects SOURCEA or SOURCEB, varying with the current alternation channel.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects the alternation source channel.
real (s) - Returns the pulse width value in seconds.
:TRIG:ALT:PULS:TIME? SOURB Return 2.000e-003.

Sets the video polarity for alternation triggering. The query returns the current polarity as POSITIVE or NEGATIVE, optionally for a specified source.

NameTypeValuesDescription
polarityenumPOSitive | NEGativeSelects the video polarity.
sourceopt--Specifies the source as SOURCEA or SOURCEB.
enum - Returns the current video polarity.
:TRIG:ALT:VIDEO:POL POS,SOURB
:TRIG:ALT:VIDEO:POL? SOURB

Sets the sync mode of alternation trigger and video trigger. The source may be SOURceA or SOURceB, varying with the current alternation channel.

NameTypeValuesDescription
modeenumALLLins | ODDField | EVENfield | LINESync mode to set for the alternation trigger and video trigger.
sourceoptenumSOURceA | SOURceBSource selection for the current alternation channel.
:TRIG:ALT:VIDEO:MODE ALLLINES,SOURB Set the sync mode as all lines.
:TRIG:ALT:VIDEO:MODE? SOURB Return ALL LINES.

Sets or queries the video standard used by the alternation trigger. The setting can be applied to source A or source B, depending on the current alternation channel.

NameTypeValuesDescription
standardenumNTSC | PALSecamVideo standard to set.
sourceoptenumSOURceA | SOURceBSource to apply the setting to.
enum - Returns the current video standard.
:TRIG:ALT:VIDEO:STAN NTSC,SOURB Set the video standard as NTSC.
:TRIG:ALT:VIDEO:STAN? SOURB Return NTSC.

Sets the trigger alternation coupling mode for the specified source. The available modes are DC, AC, and LF.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects the alternation source to apply the setting to.
enum - Returns the current coupling mode.
:TRIG:ALT:COUP? SOURB Return DC.

Queries the specified sync line number for an alternation video trigger source. If a source is specified, it applies to SOURCEA or SOURCEB for the current alternation channel.

NameTypeValuesDescription
sourceoptenumSOURceA | SOURceBSelects the alternation source.
integer - The specified line number.
*none provided in slice for exact long-form mnemonic*

Sets the high frequency reject function of ALTernation Trigger on or off. The query returns 1 or 0, indicating ON or OFF.

NameTypeValuesDescription
stateenum1 | ON | 0 | OFFEnables or disables high frequency reject for ALTernation Trigger.
enum - Returns 1 or 0, respectively indicating ON or OFF.
:TRIG:ALT:HFRE ON Set HFR on.
:TRIG:ALT:HFRE? Return 1.

Sets the alternate trigger holdoff time for the specified source. The holdoff time is the waiting time before the oscilloscope can start a new trigger; during holdoff, triggering is inhibited until the holdoff ends.

NameTypeValuesDescription
countreal100ns - 1.5sHoldoff time value.
sourceoptenumSOURceA | SOURceBTrigger source to which the holdoff time applies.
real (s) - Returns the holdoff time value for the specified source.
:TRIG:HOLD 0.0001, SOURA Set the holdoff time of source A as 100us.
:TRIG:HOLD? SOURA Return 1.000e-004.

Sets the trigger sensitivity for alternation trigger. The sensitivity count range is 0.1 div to 1 div, and an optional source may be specified for source A or B.

NameTypeValuesDescription
countreal0.1 - 1Trigger sensitivity count.
sourceoptenumSOURceA | SOURceBSelects source A or source B.
real (div) - Returns the trigger sensitivity value.
:TRIG:ALT:SENS 0.1, SOURceB Set the trigger sensitivity as 01.
:TRIG:ALT:SENS? SOURceB Return 1.000e-001.

Sets the trigger coupling mode.

NameTypeValuesDescription
couplingenum-Trigger coupling mode.

Sets the trigger coupling high-frequency reject option. This command is documented as part of the trigger coupling group.

:TRIGger:HOLDoffset / query

Sets the trigger holdoff time.

NameTypeValuesDescription
holdoffrealMINimum - MAXimumTrigger holdoff time.

Sets the trigger sensitivity. The command is documented in the quick reference only; no parameter details are provided in this slice.

Returns the current trigger status.

enum - Returns the current trigger status.

Sets the trigger video polarity. The command is listed in the trigger video command group.

NameTypeValuesDescription
polarityenum-

Sets the coupling mode for alternate trigger. The manual slice does not provide the allowed values or further parameter details.

Selects the current source used for alternate trigger. The command is listed in the quick reference, but this slice does not provide syntax details or a return value.

Sets whether high-frequency reject is enabled for alternate trigger coupling.

NameTypeValuesDescription
stateenumON | OFFEnables or disables high-frequency reject.

Sets the trigger alternation holdoff. The command is listed in the quick reference with no further syntax or value details on this page slice.

Sets the trigger level for the alternate trigger source. The quick reference lists this command under alternate trigger settings.

NameTypeValuesDescription
levelreal-Trigger level for alternate trigger.

Sets the trigger alternation source. The slice only identifies the command in the quick reference and does not document parameter details.

Sets the trigger alternate time scale. The command is listed in the alternate trigger subsystem quick reference.

NameTypeValuesDescription
time scalereal-Time scale for alternate trigger.

Sets the trigger pattern pattern. The quick reference lists the command but provides no further syntax or parameter details on this page.

Sets the line number used for video trigger. This command is part of the video trigger subsystem.

Sets or queries the trigger source for the selected trigger mode. Allowed sources depend on the mode: EDGE allows channel, external, EXT5, or AC line; PULSE, VIDEO, and PATTERN allow channel or external sources.

enum - Returns the current trigger source.

Sets the voltage level for Edge, Pulse, Video, or Pattern trigger modes. The query returns the current trigger level in volts.

NameTypeValuesDescription
levelreal-6*Scale-Offset① - +6*Scale+Offset①Voltage trigger level to set.
srcoptenumCHANnel<n> | EXTSource used in Pattern mode.
real (V) - Returns the value of voltage level.
:TRIG:EDGE:LEV 2 Set the trigger level as 2V.
:TRIG:EDGE:LEV? Return 2.000e000.

Sets the trigger sweep mode for Edge, Pulse, or Pattern trigger operation. The mode can be AUTO, NORMal, or SINGle.

enum - Returns the current trigger sweep mode.
:TRIG:EDGE:SWEep AUTO
:TRIG:EDGE:SWEep?

Sets the trigger sweep mode for the specified trigger mode.

NameTypeValuesDescription
modeenum-Trigger mode node used in the command path.

Sets Math waveform display on or off. The query returns 1 for ON or 0 for OFF.

enum - Returns 1 or 0, respectively indicating ON or OFF.
:MATH:DISP ON Set Math waveform to be on.
:MATH:DISP? Return 1.
:MATH:DISPlayset / query

Displays the mathematical waveform on the screen.

Turns the channel bandwidth limit function on or off for channel <n> 1 through 4. The limit reduces bandwidth to 20 MHz when ON.

NameTypeValuesDescription
stateenum1 | ON | 0 | OFFSets the bandwidth limit state.
enum - Returns 1 for ON or 0 for OFF.
:CHAN2:BWL OFF Set BW limit function of channel 2 off.
:CHAN2:BWL? Return 0.

Sets the input coupling mode for the specified channel. The channel number <n> may be 1, 2, 3, or 4; the query returns the current coupling mode.

enum - Returns the current coupling mode.
:CHAN2:COUP? Return DC.

Sets the specified channel display state to ON or OFF. The channel number <n> may be 1, 2, 3, or 4.

NameTypeValuesDescription
ninteger1 - 4Channel number to control.
enum - Returns 1 or 0, indicating ON or OFF respectively.
:CHAN2:DISP ON Set channel 2 to on.
:CHAN2:DISP? Return 1.

Sets the waveform invert function for channel <n> to ON (inverted waveform displayed) or OFF (normal waveform displayed). The <n> may be 1, 2, 3 or 4.

NameTypeValuesDescription
stateenum1 | ON | 0 | OFFTurns waveform inversion on or off for the selected channel.
enum - Returns 1 for ON and 0 for OFF.
:CHAN2:INV OFF Set the invert function of channel 2 to off.
:CHAN2:INV? Return 0.

Sets the vertical offset of the specified channel. The channel number <n> may be 1, 2, 3, or 4; the allowed offset range depends on the scale.

NameTypeValuesDescription
offsetreal-40V - +40VVertical offset to set for the channel.
real (V) - Returns the present offset value.
:CHAN2:OFFS 20 Set the vertical offset of channel 2 as 20V.
:CHAN2:OFFS? Return 2.000e001.

Sets the probe attenuation factor for the specified channel. The channel number <n> may be 1, 2, 3, or 4, and the attenuation <attn> may be one of the listed X factors.

NameTypeValuesDescription
attnenum0.001 X | 0.01 X | 0.1 X | 1X | 2 X | 5X | 10X | 20 X | 50X | 100X | 200 X | 500X | 1000XAttenuation factor of the probe.
enum - Returns the attenuation factor setting.
:CHAN2:PROB 10X
:CHAN2:PROB?

Queries the vertical scale for the specified channel. The channel number <n> may be 1, 2, 3, or 4.

real (V) - Returns the value of the vertical scale.
:CHAN2:SCAL?

Queries the digital filter state for the specified channel. The query returns 1 for ON and 0 for OFF.

NameTypeValuesDescription
ninteger1 - 4Channel number.
enum - Returns 1 when the filter is ON and 0 when it is OFF.
:CHAN2:FILT?

Sets the displayed unit for the specified channel. The query returns the current unit setting.

enum - Returns the channel unit setting.
:CHAN1:UNIT VOLT Set the unit of channel 1 as V.
:CHAN1:UNIT? Return VOLTs.

Queries the vertical adjustment mode for the specified channel. The query returns 1 for ON (Fine) and 0 for OFF (Coarse).

NameTypeValuesDescription
channelinteger1 - 4Channel number n.
integer - Returns 1 or 0, respectively indicating ON or OFF.
:CHAN2:VERN? Return 1.

Sets the bandwidth limit for the specified channel. The command belongs to the channel configuration group and uses the channel number placeholder <n>.

NameTypeValuesDescription
ninteger1Channel number.

Sets the input coupling for the specified channel.

NameTypeValuesDescription
ninteger1 - 4Channel number.
couplingenum-Input coupling mode.

Turns the specified channel display on or off.

NameTypeValuesDescription
ninteger-Channel number to which the command applies.

Enables or disables the channel filter for the specified channel. The command applies to channel <n>.

NameTypeValuesDescription
ninteger1Channel number to which the filter setting applies.

Inverts the selected channel signal display. The command is set per channel using the channel index <n>.

NameTypeValuesDescription
ninteger1 - 4Channel index.

Returns the memory depth currently set for the specified channel.

integer - The current memory depth for channel n.

Sets the vertical offset of the specified channel.

NameTypeValuesDescription
ninteger1 - 4Channel number.

Sets the vertical scale for the specified channel. The channel number is given by <n>.

NameTypeValuesDescription
ninteger-Channel number.
scalereal-Vertical scale for the channel.

Sets the units used to display the selected channel's waveform values.

NameTypeValuesDescription
ninteger1 - 4Channel number to configure.
unitsenum-Units selection for the channel.

Sets the channel vernier function for the specified channel. The command applies to channel <n>.

NameTypeValuesDescription
ninteger-Channel number.

Sets all measurement functions on or off. The query returns 1 or 0, indicating ON or OFF respectively.

enum - Returns 1 or 0, indicating ON or OFF respectively.

Selects the channels used for measuring time delay. The query returns the selected channel pair.

enum - Returns the selected delay-source channel pair.
:MEAS:DELASOUR? Return CH1, CH2.

Selects the measurement channel for measurements. The query returns the currently selected source as CH1, CH2, CH3, or CH4.

enum - Returns the selected measurement channel.
:MEAS:SOUR? Return CH1.

Selects the channel pair used for phase delay measurement. The query returns the selected source pair as two channel identifiers.

NameTypeValuesDescription
sourceenumCHANnel1 | CHANnel2 | CHANnel3 | CHANnel4Channel used for phase delay measurement.
sourceenumCHANnel1 | CHANnel2 | CHANnel3 | CHANnel4Channel used for phase delay measurement.
enum - Returns the selected phase-delay source pair. Valid returned pairs are CH1, CH2; CH1, CH3; CH1, CH4; CH2, CH3; CH2, CH4; and CH3, CH4.
:MEAS:PHASOUR CHAN1 CHAN2 Measure the phase delay.
:MEAS:PHASOUR? Return CH1, CH2.
:MEASure:DISableset / query

Disables measurement functions. This command is listed in the Quick Reference; no syntax, parameters, or return data are provided in the slice.

Measures the fall time of the selected waveform. The command is a measurement query and returns the measured fall time value.

real (s) - The measured fall time.

Returns the measured frequency of the signal.

real (Hz) - Measured frequency of the signal.

Measures the negative delay between two waveforms.

real (s) - Returns the measured negative delay.

Measures the negative duty cycle of the waveform. This is a measurement query.

real (%) - Returns the measured negative duty cycle.

Measures the negative phase between two signals. This command is listed in the quick reference; the slice does not provide syntax details beyond the command name.

real (deg) - Returns the measured negative phase.

Measures negative pulse width. This is a query command.

real - Returns the measured negative pulse width.

Measures overshoot on the selected waveform or source. This command is a measurement query.

real - Returns the overshoot measurement result.

Measures pulse delay. The command is listed in the quick reference with no additional syntax or result details on this page slice.

real - Returns the measured pulse delay.

Measures positive duty cycle. This is a measurement query and returns the current positive duty-cycle value.

real (%) - The measured positive duty-cycle value.

Returns the period measurement.

real (s) - The measured period value.

Sets the measurement phase source. The source used for phase measurement is specified by the command.

NameTypeValuesDescription
sourceenum-Measurement phase source.

Returns the positive phase difference measurement. This query is listed in the measurement command quick reference.

returns

Returns the preshoot measurement result.

real - The preshoot measurement value.

Measures pulse width on the selected source.

real - Returns the measured pulse width.

Returns the rise time measurement.

real - The rise time of the selected signal.
:MEASure:SOURceset / query

Selects the measurement source used by the instrument. The command is listed in the quick reference only; this slice does not show syntax details or the returned value.

:MEASure:TOTalset / query

Performs a total measurement. This command is listed in the quick reference as a measurement command.

Measures the amplitude of the selected waveform source. This is a query command.

real - Returns the measured amplitude of the selected source.

Returns the average voltage measurement result.

real (V) - The average voltage measurement result.

Returns the vertical base measurement. It is a measurement query under :MEASure.

returns

Returns the maximum value of the current waveform measurement.

real - The maximum measurement value is returned.

Returns the minimum value of the current measurement.

real - The minimum measured value.

Returns the peak-to-peak voltage measurement.

real (V) - The peak-to-peak voltage value is returned.

Returns the measured VRMS value.

real - The measured VRMS value.

Returns the VTOP measurement result.

real - The VTOP measurement value.

Returns the measurement display state and settings. The quick reference lists this command as a measurement command but does not provide parameter syntax here.

returns - Returns the present measurement configuration or state; the slice does not specify the exact format.

Returns the current waveform data format. The query returns WORD, BYTE, or ASCii.

enum - Returns the waveform data format.
:WAV:FORM? Return ASCii.

Sets the number of waveform points to be returned. The default is 0, and the allowed range depends on the current mode.

NameTypeValuesDescription
pointsinteger0 - 600Number of waveform points required to be returned.
integer - Returns the number of waveform points; if the setting is 0, the query returns the maximum points in the current mode.

Sets or queries the waveform points mode. The mode determines what data points :WAVeform:POINts? returns in NORMal, MAXimum, or RAW mode.

enum - Returns the current waveform points mode.

Queries the current waveform source used for waveform data. The source can be one of the channel inputs or MATH.

enum - Returns the current waveform data source.
:WAV:SOUR? Return Channel2.

Returns waveform data. The command is a query and is listed as part of the waveform subsystem quick reference.

returns - Returns waveform data.
:WAVeform:FORMatset / query

Sets the waveform data format used for waveform transfer. The format is selected by a keyword value.

NameTypeValuesDescription
formatenumBYTE | WORD | ASCiiWaveform data format.
:WAVeform:POINtsset / query

Sets the number of waveform points used for data acquisition or display. The command is documented in the waveform command group, with a related :WAVeform:POINts:MODE command controlling the mode.

NameTypeValuesDescription
pointsinteger0 - MAXimumNumber of waveform points.

Sets the waveform points mode. The command determines how waveform points are handled for waveform readout.

:WAVeform:SOURceset / query

Selects the waveform source used by the oscilloscope. The command is listed in the quick reference under waveform commands.

Returns the horizontal increment between adjacent waveform points.

real - Returns the horizontal increment between adjacent waveform points.

Returns the waveform X-axis origin.

real - Returns the waveform X-axis origin.

Returns the waveform vertical increment.

real - The waveform vertical increment.

Returns the waveform Y-origin value used in waveform preamble information.

real - The Y-origin value.

Enables or disables remote control on the front-panel keys.

NameTypeValuesDescription
stateenumENABle | DISableSets the front-panel key remote-control function to enable or disable.
enum - Returns the current front-panel key remote-control state.
:KEY:LOCK ENAB Enable remote control on the keys of front panel .
:KEY:LOCK? Return ENABLE.
:KEY:CH4_VOLT_Zset / query

Sets the adjustment mode of vertical scale of channel 4 as Fine or Coarse. In Coarse the vertical scale steps by 1-2-5; in Fine it steps by equality.

:KEY:CURSorset / query

Selects the cursor function key on the front panel. This is a quick-reference entry only; no syntax details are given on this page slice.

:KEY:LOCKset / query

Locks or unlocks the front-panel key controls.

NameTypeValuesDescription
stateenumON | OFFTurns key lock on or off.
:KEY:MEASureset / query

Assigns the MEASURE function to the front-panel KEY key.

:KEY:STORageset / query

Stores the current settings under the STORAGE key. The command is listed in the quick reference as a front-panel key function.

:KEY:UTILityset / query

Assigns the Utility function to the front-panel KEY key. The command appears in the key assignment group with other front-panel key mappings.

:KEY:ACQuireset / query

Simulates pressing the ACQUIRE key on the front panel.

:KEY:AUTOset / query

Executes the AUTO key operation. This command is listed in the command quick reference; no further details are provided in the supplied slice.

:KEY:CH1set / query

Executes the front-panel CH1 key action. The quick reference lists the command only and provides no parameter or return details.

:KEY:CH1_POS_DECset / query

Simulates pressing the CH1 position decrement key on the front panel. This command is listed in the command quick reference only.

:KEY:CH1_POS_Zset / query

Simulates pressing the CH1 position zero key.

Simulates pressing the CH1 voltage decrease key on the front panel.

Simulates pressing the CH1 voltage increment key on the front panel.

:KEY:CH4_VLOT_Zset / query

Simulates the front-panel CH4 vertical offset zero key action.

:KEY:DISPlayset / query

Simulates pressing the DISPLAY key on the instrument front panel.

:KEY:F1set / query

Simulates pressing the F1 front-panel key.

:KEY:FUNC_DECset / query

Decreases the value assigned to the selected function key. It is a front-panel key command in the quick reference list.

:KEY:FUNC_INCset / query

Simulates pressing the front-panel FUNC increment key. The command is listed in the quick reference only.

:KEY:FUNC_Zset / query

Executes the front-panel FUNC Z key action. This command is listed in the command quick reference only.

:KEY:HELPset / query

Executes the HELP key action from the front panel. The quick reference lists the command only and does not document parameters or a return value.

:KEY:MATHset / query

Simulates pressing the front-panel MATH key.

:KEY:MNUTIMEset / query

Enters the time menu on the front panel.

Generates a quick measurement key event. The quick reference lists the command but provides no syntax or parameter details on this page.

:KEY:QUICKPRINtset / query

Simulates pressing the QUICK PRINT key on the instrument front panel.

:KEY:REFset / query

Sets the front-panel REF key function.

:KEY:RUNset / query

Simulates pressing the RUN key on the oscilloscope front panel.

:KEY:SINGLeset / query

Simulates pressing the SINGLE key on the front panel. Used to make the oscilloscope acquire a single trigger event and then stop.

:KEY:SINGLe
:KEY:TIME_DECset / query

Simulates the front-panel TIME DEC key press. This command is part of the :KEY subsystem quick reference.

:KEY:TIME_INCset / query

Simulates pressing the TIME increment key on the front panel.

:KEY:TIME_INC

Emulates the TIME position decrement key on the front panel.

Simulates pressing the TIME position increment key on the instrument front panel. This is a quick-reference command with no further syntax or parameter details on the cited page.

:KEY:TIME_POS_Zset / query

Simulates pressing the TIME position zero key on the front panel.

:KEY:TIME_Zset / query

Centers or resets the timebase position to zero. This command is listed in the command quick reference only; no parameter or return details are provided in the slice.

Simulates the front-panel TRIG LEVEL down key. It is a quick-reference key command with no parameters documented in this slice.

Sets the trigger level to the zero-reference position. This is a quick-reference key command and the slice does not document any parameters or return value.

:KEY:Trig%50set / query

Simulates pressing the %50 key in the trigger menu.

:KEY:TrigFORCeset / query

Forces a trigger event. This command is listed in the front-panel key command quick reference.

:KEY:TrigMENUset / query

Simulates pressing the trigger menu key on the front panel.

Sets the storage location. The location may be from 0 to 9.

NameTypeValuesDescription
locationinteger0 - 9Storage location number.
integer - Returns the storage location as a decimal number from 0 to 9.
:SAVERECALL:LOC 1 Set the storage location as the second.
:SAVERECALL:LOC? Return 1.

Sets or queries the data type used for storage. The type may be waveform data or setup data.

NameTypeValuesDescription
typeenumWAVeform | SETupsSelects the storage data type.
enum - Returns the current storage type.
:SAVERECALL:TYPE WAV Set the storage type as waveform data.
:SAVERECALL:TYPE? Return WAVEFORM.
:SAVERECALL:LOADset / query

Loads a saved setup or waveform from the specified location. The command belongs to the save/recall subsystem.

NameTypeValuesDescription
locationinteger0 - 9Specifies the saved location to load.
:SAVERECALL:SAVeset / query

Saves the current setup or waveform data to internal memory or to an external location, depending on the selected save type and location settings.

:SAVERECALL:TYPEset / query

Selects the save/recall type. The command is listed in the Quick Reference index at page 2-100.

Sets the saving function of system parameters to on or off while saving an image. The query returns 1 for ON and 0 for OFF.

NameTypeValuesDescription
stateenum1 | ON | 0 | OFFEnables or disables saving a file that records all system parameters while saving an image.
enum - Returns 1 or 0, respectively indicating ON or OFF.
:SAVE:IMAG:FACT ON Save the system parameters.
:SAVE:IMAG:FACT? Return 1.

Sets the format of saved images. The format may be 24-bit real color (BMP|BMP24bit), 8-bit bitmap (BMP8bit), or PNG.

NameTypeValuesDescription
formatenumBMP | BMP24bit | BMP8bit | PNGImage file format to save.
enum - Returns the saved image format.
:SAVE:IMAG:FORM BMP Set the format as 24-bit real color.
:SAVE:IMAG:FORM? Return BMP24bit.

Sets image scaling factors for saved screenshots. The command is listed as a quick-reference entry only; no syntax or parameter details are shown on this page slice.

Sets the image file format used by the save-image function.

NameTypeValuesDescription
formatenum-Image file format.

Starts saving an image. This command is part of the save/recall command set.

Starts saving the current setup to storage. The quick reference lists this command under the Save/Recall functions.

Enables or disables the passing test state. The query returns 1 or 0, indicating ON or OFF respectively.

integer - Returns 1 or 0, respectively indicating ON or OFF.
:MASK:ENAB? Return 1.

Sets the rule of testing X direction. The <x> value is in div.

NameTypeValuesDescription
xreal0.04div - 4divThe X-direction test rule value.
real (div) - Returns the x value.

Sets or queries the passing test source for mask testing. The source may be one of the channel inputs CHANnel1 through CHANnel4.

enum - Returns the selected source as CHAN1, CHAN2, CHAN3, or CHAN4.
:MASK:SOUR CHAN1 Set the passing test source as channel 1.
:MASK:SOUR? Return CHAN1.

Sets the rule of testing the Y direction for mask testing. The query returns the Y value in div.

NameTypeValuesDescription
yreal0.04div - 4divY-direction rule value.
real (div) - The y value.
:MASK:Y 1 Set the Y direction rule as 1div.
:MASK:Y? Return 1.000e000.

Sets the passing-test operation to run or stop. The query returns the current setting.

enum - Returns the current passing-test operation setting.
:MASK:OPER? Return RUN.

Sets the output mode of passing test. The query returns the current output mode.

enum - Returns the current output mode.
:MASK:OUTP PASS Set the output mode of passing test as pass.
:MASK:OUTP? Return PASS.

Sets the prompt information function for pass/fail testing to ON or OFF. The query returns 1 or 0, respectively indicating ON or OFF.

NameTypeValuesDescription
stateenum1 | ON | 0 | OFFEnables or disables the prompt information function.
integer - Returns 1 or 0, respectively indicating ON or OFF.
:MASK:MSG ON Set the prompt information function to on.
:MASK:MSG? Return 1.
:MASK:ENABleset / query

Enables or disables the mask function.

NameTypeValuesDescription
stateenum-
:MASK:LOADset / query

Loads a mask setup from the specified source. The command is listed in the quick reference only; this slice does not provide syntax details or parameter descriptions.

:MASK:OPERateset / query

Operates on the current mask configuration. The quick reference lists the command but provides no further syntax, parameters, or return value on this page.

:MASK:OUTPutset / query

Turns mask output on or off for the mask test function.

NameTypeValuesDescription
stateenumON | OFFEnables or disables mask output.
:MASK:SAVEset / query

Saves the current mask configuration. This command is listed in the mask command group in the quick reference.

:MASK:SOURceset / query

Sets the source used for mask operations.

Sets whether mask testing stops when an output condition is reached. This command is part of the MASK subsystem quick reference.

:MASK:Xset / query

No command definition is provided on this quick-reference page; only the mnemonic and its page reference are listed.

:MASK:Yset / query

Sets the Y-coordinate for a mask point or mask region. The quick reference lists the command under the MASK subsystem but does not provide syntax details on this page.

Sets the cursor type for manual cursor mode. The query returns the current manual cursor type.

enum - Returns the current manual cursor type.
:CURS:MANU:TYPE TIME
:CURS:MANU:TYPE?

Returns the current cursor mode. The query returns CLOSE, MANUAL, TRACK, or MEASURE.

enum - Returns the current cursor mode.
:CURS:MODE? Return TRACK.

Sets the AX position of the manual cursor. The query returns the AX position value.

integer - Returns the value of AX position.

Sets the source of the manual cursor. The source may be one of the channel inputs or MATH; the query returns the currently selected source.

enum - Returns the current manual cursor source as Channel1, Channel2, Channel3, Channel4, or Math.
:CURS:MANU:SOUR? Return Channel1.

Sets the AY position of the manual cursor. The value range is 4 to 194.

integer - Returns the value of AY position.
:CURS:MANU:CURAY 100
:CURS:MANU:CURAY?

Sets or queries the BX position of the manual cursor.

integer - Returns the value of BX position.
:CURS:MANU:CURBX 100
:CURS:MANU:CURBX?

Returns the BY position of the manual cursor.

integer - The value of the BY position.
:CURS:MANU:CURBY? Return 100.

Returns or sets the signal source A of the track cursor.

enum - Returns Channel1, Channel2, Channel3, Channel4, Math, or None.

Sets the position of track cursor A. The allowed value range is 4 to 297.

NameTypeValuesDescription
valueinteger4 - 297Position of track cursor A.
integer - Returns the position of cursor A.
:CURS:TRAC:CURA 100 Set the position of track cursor A as 100.
:CURS:TRAC:CURA? Return 100.

Sets the signal source B of the track cursor. The query returns the currently selected source.

NameTypeValuesDescription
sourceenumCHANnel1 | CHANnel2 | CHANnel3 | CHANnel4 | MATH | NONESignal source B for the track cursor.
enum - Returns the selected source for track cursor B.
:CURS:TRAC:SOURB CHAN1 Set the signal source B of track cursor.
:CURS:TRAC:SOURB? Return Channel1.

Returns or sets the position of track cursor B.

integer - The query returns the position of cursor B.
[:CURS:TRAC:CURB 100]
[:CURS:TRAC:CURB?]

Sets the X-axis cursor position for the manual cursor mode. This command is listed in the quick reference alongside the other :CURSor:MANUal cursor commands.

No command details are provided on this quick-reference page beyond its index entry.

No command details are given on this page slice beyond the quick-reference listing. The entry only identifies the command and its manual page reference.

Selects source A for cursor tracking. This is a quick-reference entry only; no additional syntax details are given on this page.

Selects the source used for cursor tracking B. The command is listed in the cursor tracking subsystem quick reference.

Sets the system beeper to ON or OFF. The query returns 1 or 0, respectively indicating ON or OFF.

enum - Returns 1 or 0, respectively indicating ON or OFF.
:BEEP:ENAB ON
:BEEP:ENAB?
:BEEP:ACTionset / query

Sets the beep action to be taken when beep is enabled. The exact action choices are documented on the command’s detail page, but they are not shown in this slice.

:BEEP:ENABleset / query

Enables or disables the beeper.

NameTypeValuesDescription
stateenumON | OFFTurns the beeper on or off.

Sets the counter to ON or OFF. The query returns 1 or 0, respectively indicating ON or OFF.

enum - 1 or 0, respectively indicating ON or OFF.
:COUN:ENAB? Return 1.
:COUNter:ENABleset / query

Enables or disables the counter function.

NameTypeValuesDescription
stateenumON | OFFTurns the counter function on or off.

Returns the current system language. The response can be Simplified Chinese, Traditional Chinese, Korean, Japanese, English, German, French, Italian, Russian, Portuguese, or Spanish.

enum - Returns the current system language.
:INFO:LANG? Return Simplified Chinese.

:RTC?query

Returns the system time as year, month, day, hour, minute, and second.

integer - Returns the year, month, day, hour, minute, and second.
:RTC? Return 2008, 8, 8, 20, 8, 8.
:RTCset / query

Sets or queries the real-time clock. This entry is a quick-reference listing only; the page slice does not provide syntax details, parameters, or returned data.

*IDN?query

Returns the instrument identification string.

string - Returns the manufacturer, model, serial number, and firmware version string.
*LRN?query

Returns the current settings of the instrument as a command string. The string can be used to restore the instrument state.

string - Returns the current settings of the instrument as a command string that can be used to restore the instrument state.
*OPC?query

Indicates that all pending overlapped commands have been completed. It is used to synchronize command processing.

boolean - Returns 1 when all pending overlapped commands have completed; otherwise returns 0.
*RSTset / query

Resets the instrument to its default state.

:AUTOset / query

Performs an autoset/autoscale operation to automatically adjust the display settings. The quick reference lists it as a command entry only and does not provide syntax details or a return value.

Disables autoscale. This is the setter form of the autoscale command.

Enables autoscale. This command is the enable counterpart to :AUToscale:DISable.

Automatically scales the display. This is the query form of the AUToscale command.

enum - Returns the autoscale state.

:FORCetrigset / query

Forces a trigger event immediately.

Starts recalling a setup file. The command is listed in the quick reference only; this slice does not provide syntax details or parameter descriptions.

Starts waveform recall. The command is listed in the quick reference; no syntax details are shown on this page slice.

:RUNset / query

Starts acquisition and puts the oscilloscope into run mode.

:SINGLEset / query

Starts single acquisition mode.

:STOPset / query

Stops acquisition on the instrument.

:Trig%50set / query

Sets the trigger holdoff to 50% of the trigger period.