/

Keysight

/

Keysight DSOX1202G

SCPI COMMAND REFERENCE

Keysight DSOX1202G

Keysight DSOX1202G

The Keysight DSOX1202G is Keysight's oscilloscope in the InfiniiVision 1200 X-Series family. Its SCPI remote-control interface exposes 503 commands across 47 subsystems - 502 settable and 1 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.

503

Commands

502

Settable

1

Queries

47

Subsystems

SCPI

Verified

2026-07-16

All commands

*CLSset / query

Clears the status data structures, the device-defined error queue, and the Request-for-OPC flag. If it immediately follows a program message terminator, the output queue and MAV bit are also cleared.

*ESEset / query

Sets the bits in the Standard Event Status Enable Register. A 1 enables the corresponding bit in the Standard Event Status Register; a 0 disables it.

NameTypeValuesDescription
mask_argumentinteger0 - 255Mask value used to enable or disable bits in the Standard Event Status Enable Register.
*ESRset / query

Queries the contents of the Standard Event Status Register. Reading the register returns the total bit weights of all bits that are high and clears the register.

integer - Contents of the Standard Event Status Register as an NR1 integer in the range 0 to 255. Reading the register clears it.
*IDNset / query

Identifies the instrument type and software version.

string - Returns <manufacturer_string>,<model>,<serial_number>,X.XX.XX <NL>.
*LRNset / query

Returns the current state of the instrument as a valid command string that can be used to restore instrument settings later. The returned string contains ":SYST:SET " before the IEEE 488.2 binary block setup data.

string - A learn string in the form ":SYST:SET <setup_data>" followed by <NL>; <setup_data> is binary block data in IEEE 488.2 # format.
*OPCset / query

Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished.

*OPTset / query

Reports the options installed in the instrument. The query returns a string identifying the module and its software revision level.

string - Returns the option/license information in the format 0,0,<license info>.
*RCLset / query

Restores the state of the instrument from the specified save/recall register.

NameTypeValuesDescription
valueinteger0 - 9Save/recall register number to recall.
*RSTset / query

Places the instrument in a known factory-default state. This is the same as pressing [Save/Recall] > Default/Erase > Factory Default on the front panel.

myScope.WriteString "*RST" ' Reset the oscilloscope to the defaults.
*SAVset / query

Stores the current state of the instrument in a save register. The value specifies which register the data will be saved in.

NameTypeValuesDescription
valueinteger0 - 9Save register number.
*SREset / query

Sets the Service Request Enable Register mask. A one in the mask enables the corresponding bit in the Status Byte Register; a zero disables it.

NameTypeValuesDescription
maskinteger0 - 255Mask value with bits defined in the SRE table.
*STBset / query

Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit.

integer - Current status byte value.
*STB?
*TRGset / query

Triggers a digitize operation. It has the same effect as the :DIGitize command with no parameters.

*TSTset / query

Performs a self-test on the instrument and places the result in the output queue. A zero indicates the test passed; a non-zero value indicates failure.

integer - Integer self-test result: 0 indicates pass, non-zero indicates fail.
*WAIset / query

Waits to continue execution of subsequent commands. The oscilloscope does not implement any function for *WAI, but it is parsed for compatibility with other instruments.

:AERset / query

Reads the Arm Event Register and then clears it. A value of 1 indicates the trigger system is armed and ready to accept a trigger.

integer - The Armed Event Register value, with 1 indicating the trigger system is in the armed state and 0 indicating it is not.

:AUToscaleset / query

Evaluates input signals and automatically sets display conditions, like pressing the front-panel Auto Scale key. If one or more sources are specified, those channels are enabled and all others blanked before autoscale is performed.

NameTypeValuesDescription
sourceoptchannel_list-One or more channels to autoscale; each source is a CHANnel<n> and may be repeated up to 5 times.
:AUToscale
myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
:AUToscale:AMODEset / query

Specifies the acquisition mode used by subsequent :AUToscale operations. The query returns the current autoscale acquire mode setting.

NameTypeValuesDescription
valueenumNORMal | CURRentAcquisition mode to set for subsequent autoscale operations.
enum - Returns the autoscale acquire mode setting.

Specifies which channels will be displayed on subsequent :AUToscales. All channels that meet the autoscale requirements are displayed when ALL is selected; only channels that are turned on are autoscaled when DISPlayed is selected.

NameTypeValuesDescription
valueenumALL | DISPlayedSelects which channels are included in subsequent autoscale operations.
enum - Returns the autoscale channels setting.

Turns fast debug auto scaling on or off. The Fast Debug option changes the behavior of :AUToscale to make quick visual comparisons for determining whether the probed signal is a DC voltage, ground, or an active AC signal.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns fast debug auto scaling on or off.

:BLANkset / query

Turns off the specified channel, math function, or serial decode bus. With no parameter, it turns off all sources.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXTSource to blank (stop displaying).

:DIGitizeset / query

Causes the instrument to acquire waveforms according to the :ACQuire settings and then stop. If no source is given, it acquires the currently displayed channels, or all channels if none are displayed.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | ABUS | EXTSpecifies one or more sources to acquire, repeatable up to 5 times.
myScope.WriteString ":DIGitize CHANnel1"

:MTEenableset / query

Sets the Mask Test Event Enable register with a 16-bit integer mask. Setting selected bits enables corresponding mask test event conditions and may generate an SRQ.

NameTypeValuesDescription
maskinteger-16-bit integer mask written to the Mask Test Event Enable register.

Returns the integer value contained in the Mask Test Event Event Register and clears the register.

integer - Integer value contained in the Mask Test Event Event Register; reading it clears the register.

:OPEEset / query

Sets a 15-bit mask in the Operation Status Enable register. Setting selected bits enables bit 7 in the Status Byte Register and may generate an SRQ.

NameTypeValuesDescription
maskinteger-15-bit integer mask written to the Operation Status Enable register.

Returns the integer value contained in the Operation Status Condition Register.

integer - Integer value contained in the Operation Status Condition Register.

Returns the integer value contained in the Operation Status Event Register.

integer - The integer value contained in the Operation Status Event Register.

:OVLenableset / query

Sets the overload enable mask in the Overload Event Enable Register and enables reporting of the Overload Event Register. If enabled, an overload event sets bit 11 in the Operation Status Register.

NameTypeValuesDescription
enable_maskinteger-16-bit integer mask representing the enabled overload-event inputs.

:OVLRegisterset / query

Returns the overload protection value stored in the Overload Event Register (OVLR). A value of 1 indicates an overload has occurred.

integer - Integer in NR1 format representing the Overload Event Register value.

:PRINtset / query

Formats the output according to the currently selected print device and options. If an option is not specified, the value selected in the Print Config menu is used.

NameTypeValuesDescription
optionsoptenumCOLor | GRAYscale | PRINter0 | PRINter1 | BMP8bit | BMP | PNG | NOFactors | FACTorsOne or more print options, each repeated up to 5 times.
:PRINt?query

Pulls image data back over the bus for storage. It is an obsolete compatibility query and is not a core command.

NameTypeValuesDescription
optionsoptenumCOLor | GRAYscale | BMP8bit | BMPSelects the print output format or palette options used for the query.
returns

:RUNset / query

Starts repetitive acquisitions. This is the same as pressing the Run key on the front panel.

myScope.WriteString ":RUN" ' Start data acquisition.

:SERialset / query

Returns the serial number of the instrument.

string - The instrument serial number.

:SINGleset / query

Causes the instrument to acquire a single trigger of data. This is the same as pressing the Single key on the front panel.

:STATusset / query

Reports whether the specified source is displayed. The source may be a channel, function, serial decode bus, memory waveform, or EXT source; MATH is an alias for FUNCtion.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXTSpecifies which source to check for display state.
enum - Returns 1 if the specified source is displayed, or 0 if it is not displayed.

:STOPset / query

Stops the acquisition. This is the same as pressing the Stop key on the front panel.

:TERset / query

Reads the Trigger Event Register. After the register is read, it is cleared; 1 indicates a trigger has occurred and 0 indicates it has not.

integer - Returns the Trigger Event Register value as a 16-bit NR1 integer, where 1 means a trigger occurred and 0 means it did not.

:VIEWset / query

Turns on the specified channel, function, or serial decode bus. MATH is an alias for FUNCtion, and EXT is available on 2-channel oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | SBUS{1} | FFT | WMEMory<r> | ABUS | EXTSpecifies which source to display.
:VIEW CHANnel1

:ABUS:BIT<m>set / query

Includes or excludes the selected bit as part of the definition for the selected bus. The suffix <m> specifies the analog channel affected by the command.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFIncludes (1/ON) or excludes (0/OFF) the selected bit from the bus definition.
enum - Returns whether the specified bit is included or excluded in the selected bus definition.
myScope.WriteString ":ABUS:BIT1 ON"
:ABUS:BITSset / query

Includes or excludes selected bits in the channel list for the definition of the analog bus. The query returns the current bus bit definition.

NameTypeValuesDescription
channel_listchannel_list-Bit or bit-range list in the form (@<m>,<m>:<m>, ...) where commas separate bits and colons define bit ranges.
displayenum1 | ON | 0 | OFFIncludes selected bits when set to 1 or ON, and excludes them when set to 0 or OFF.
string - Returns the bus definition as <channel_list>, <display>.
myScope.WriteString ":ABUS:BITS (@0,2), ON"
myScope.WriteString ":ABUS:BITS (@0:2), ON"
:ABUS:CLEarset / query

Excludes all of the analog channels from the selected bus definition.

:ABUS:DISPlayset / query

Enables or disables the view of the selected bus. The query returns the display value of the selected bus.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFEnables or disables bus display.
enum - Display value of the selected bus.
:ABUS:LABelset / query

Sets the bus label to a quoted string. Labels are 10 characters or less; longer labels are truncated. The query returns the specified bus name.

NameTypeValuesDescription
quoted_stringstring-Quoted ASCII label string, up to 10 characters.
string - Name of the specified bus as a quoted string.
myScope.WriteString ":ABUS:LABel 'Data'"
:ABUS:MASKset / query

Defines the bits included and excluded in the selected bus according to a mask. Set a mask bit to 1 to include that bit in the selected bus, and 0 to exclude it.

NameTypeValuesDescription
maskinteger-32-bit integer mask value, accepted in decimal, nondecimal (#H or #B), or string form.

Specifies the minimum completion criteria for an acquisition and affects the operation of :DIGitize. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.

NameTypeValuesDescription
completeinteger100 - 100Minimum completion criteria for an acquisition.
myScope.WriteString ":ACQuire:COMPlete 100"
:ACQuire:COUNtset / query

Sets the number of values to be averaged for each time bucket in averaging mode. When :ACQuire:TYPE is set to AVERage, the count can be set from 2 to 65536; the :ACQuire:COUNt 1 command is deprecated.

NameTypeValuesDescription
countinteger2 - 65536Number of values to average for each time bucket.
:ACQuire:MODEset / query

Sets the oscilloscope acquisition mode. RTIMe selects real time mode; SEGMented selects segmented memory mode.

NameTypeValuesDescription
modeenumRTIMe | SEGMentedAcquisition mode to set.
enum - Returns the current acquisition mode as RTIM or SEGM.
:ACQuire:POINtsset / query

Returns the number of data points that the hardware will acquire from the input signal. The number of points acquired is not directly controllable; use :WAVeform:POINts to set the number of points transferred from the oscilloscope.

integer - The number of points the hardware will acquire from the input signal.

Calculates measurement statistics and/or infinite persistence over all acquired segments. The oscilloscope must be stopped and in segmented acquisition mode, with either quick measurements or infinite persistence on.

Sets the number of memory segments to acquire. Segmented memory acquisition mode is enabled with :ACQuire:MODE, and acquisition is performed using :DIGitize, :SINGle, or :RUN.

NameTypeValuesDescription
countinteger2 - 500Number of memory segments to acquire.

Sets the index into the acquired segmented memory segments. The query returns the current segmented memory index setting.

NameTypeValuesDescription
indexinteger1 - 500Index into the memory segments that have been acquired.
integer - Current segmented memory index setting.
:ACQuire:SEGMented:INDex 25
:ACQuire:SEGMented:INDex?
:ACQuire:SRATeset / query

Returns the current oscilloscope acquisition sample rate. The sample rate is not directly controllable.

string - Current oscilloscope acquisition sample rate in NR3 format.
:ACQuire:TYPEset / query

Selects the oscilloscope acquisition type. The query returns the current acquisition type.

NameTypeValuesDescription
typeenumNORMal | AVERage | HRESolution | PEAKAcquisition type to use.
enum - Returns the current acquisition type.
:ACQuire:TYPE NORMal
myScope.WriteString ":ACQuire:TYPE NORMal"

:CALibrate:DATEset / query

Returns the date of the last calibration.

string - The date of the last calibration, in year,month,day NR1 format.
:CALibrate:LABelset / query

Saves a calibration label string in the instrument's non-volatile memory. The label can be used to record calibration dates or other information.

NameTypeValuesDescription
stringstring-Quoted ASCII string up to 32 characters, not including the quotes.

Sets the signal available on the Gen Out BNC for oscilloscopes with a built-in waveform generator. The query returns the current Gen Out BNC signal selection.

NameTypeValuesDescription
signalenumTRIGgers | MASK | OFFSelects the Gen Out BNC signal.
enum - Returns the Gen Out BNC signal selection.

Returns the rear-panel calibration protect (CAL PROTECT) button state. "PROTected" indicates calibration is disabled, and "UNPRotected" indicates calibration is enabled.

enum - Returns the rear-panel calibration protect button state.

Returns the summary results of the last user calibration procedure.

string - A comma-separated pair containing the status code and status string.

Returns the change in temperature since the last user calibration procedure.

real (deg C) - Degrees C delta since the last calibration, returned in NR3 format.
:CALibrate:TIMEset / query

Returns the time of the last calibration.

string - The time of the last calibration, returned as <date> in NR1 format as hour, minutes, and seconds.

Sets the channel bandwidth limit and turns on bandwidth limiting. The oscilloscope accepts any requested limit but uses the only available limit, 25 MHz.

NameTypeValuesDescription
limitreal25E6 - 25E6Bandwidth limit value to set.

Controls an internal low-pass filter for the specified channel. When enabled, the channel bandwidth is limited to approximately 25 MHz.

NameTypeValuesDescription
bwlimitenum1 | ON | 0 | OFFTurns the bandwidth limit filter on or off.
ninteger1 - (# analog channels)Channel number in NR1 format.

Selects the input coupling for the specified channel. The coupling for each analog channel can be set to AC or DC.

NameTypeValuesDescription
couplingenumAC | DCInput coupling for the specified channel.
ninteger1 - (# analog channels)Channel number in NR1 format.

Turns the display of the specified channel on or off. The query returns the current display setting for the specified channel.

NameTypeValuesDescription
display valueenum1 | ON | 0 | OFFSets the channel display state.
enum - Current display setting for the specified channel.

Selects the input impedance setting for the specified analog channel. The only legal value is ONEMeg (1 Ma9).

NameTypeValuesDescription
impedanceenumONEMegInput impedance setting for the specified analog channel.

Selects whether to invert the input signal for the specified channel. The inversion state may be set to ON (inverted) or OFF (not inverted).

NameTypeValuesDescription
invert valueenum1 | ON | 0 | OFFSets the channel inversion state.

Sets the analog channel label to the specified quoted ASCII string. Labels are limited to 10 characters; longer labels are truncated and lowercase letters are converted to uppercase.

NameTypeValuesDescription
stringstring-Quoted ASCII label string to assign to the analog channel.
myScope.WriteString ":CHANnel1:LABel ""CAL 1""" ' Label ch1 "CAL 1".
myScope.WriteString ":CHANnel2:LABel ""CAL2""" ' Label ch1 "CAL2".

Sets the vertical offset value represented at center screen for the selected channel. Legal values depend on :CHANnel<n>:RANGe, :CHANnel<n>:SCALe, and probe attenuation; out-of-range values are adjusted to the nearest legal value.

NameTypeValuesDescription
offsetreal-Vertical offset value in NR3 format.
suffixoptenumV | mVOptional unit suffix.
real - Returns the current offset value for the selected channel.

Sets the probe attenuation factor for the selected channel. The factor may be 0.1 to 10000, and obsolete attenuation values X1, X10, X20, and X100 are also supported.

NameTypeValuesDescription
attenuationreal0.1 - 10000Probe attenuation ratio in NR3 format.
myScope.WriteString ":CHANnel1:PROBe 10" ' Set Probe to 10:1.

Sets the analog channel probe head type and dB value for the selected channel. This command is valid only for the 113xA Series probes.

NameTypeValuesDescription
head_paramenumSEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | NONEAnalog channel probe head type and dB setting.
enum - Returns the current probe head type setting for the selected channel.

Returns the type of probe attached to the specified oscilloscope channel.

NameTypeValuesDescription
ninteger1 - (# analog channels)Specifies the oscilloscope channel number in NR1 format.
string - The probe ID as an unquoted ASCII string up to 11 characters.

Sets the channel-to-channel probe skew factor for the specified analog channel. The skew can be adjusted from -100 ns to +100 ns to remove cable-delay errors between channels.

NameTypeValuesDescription
ninteger1 - (# analog channels)Analog channel number to configure.
skew valuereal-100 ns - +100 nsSkew time in NR3 format.

Sets the channel probe signal type to differential or single-ended for 113xA Series probes and affects how offset is applied. The query returns the current probe signal type for the selected channel.

NameTypeValuesDescription
signal typeenumDIFFerential | SINGleSelects the probe signal type.
enum - Returns the current probe signal type for the selected channel.

Sets or clears the channel protection state for analog channel <n>. On these oscilloscopes the command does nothing because the analog input impedance is always 1 MΩ, and the query always returns NORM.

NameTypeValuesDescription
ninteger1 - (# analog channels)Analog channel number in NR1 format.
enum - Always returns NORM (normal).

Defines the full-scale vertical axis of the selected channel. For 1:1 probe attenuation, legal range values are from 8 mV to 40 V, and the entered range is multiplied by the probe attenuation factor if probe attenuation changes.

NameTypeValuesDescription
rangereal8 mV - 40 VVertical full-scale range value in NR3 format.
suffixoptenumV | mVUnits suffix for the range value.
:CHANnel1:RANGe 8

Sets the vertical scale, or units per division, of the selected channel. If the probe attenuation is changed, the scale value is multiplied by the probe's attenuation factor.

NameTypeValuesDescription
ninteger1 - # analog channelsSelected channel number.
scalerealVVertical units per division in NR3 format.
suffixoptenumV | mVUnit suffix appended to the scale value.

Sets the measurement units for the connected probe on the specified channel. Measurement results, channel sensitivity, and trigger level reflect the selected units.

NameTypeValuesDescription
unitsenumVOLT | AMPereMeasurement units to use for the channel probe.

Specifies whether the channel's vernier (fine vertical adjustment) setting is on or off. The query returns the current state of the channel's vernier setting.

NameTypeValuesDescription
vernier valueenum1 | ON | 0 | OFFSets the channel vernier state.
enum - Returns the current vernier setting state.

Selects the input impedance setting for the specified channel. This command is obsolete and provided for compatibility with previous oscilloscopes; use :CHANnel<n>:IMPedance instead.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyInput impedance setting to select.

Sets or queries the probe sense mode for the specified channel. The setting is obsolete and provided for compatibility; the mode cannot actually be changed, and the query returns whether an autosense probe is attached.

NameTypeValuesDescription
ninteger1 - # analog channelsChannel number in NR1 format.
pmode valueenumAUTo | MANualProbe sense mode value.

:DEMO:FUNCtionset / query

Selects the type of demo signal output on the demo terminal. The query returns the currently selected demo signal type.

NameTypeValuesDescription
signalenumSINusoid | NOISy | LFSine | AM | RFBurst | FMBurst | HARMonics | COUPling | RINGing | SINGle | CLK | TRANsition | BURSt | GLITch | CAN | LINSpecifies the demo signal function to output.
:DEMO:OUTPutset / query

Sets whether the demo signal output is ON or OFF.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSpecifies the demo signal output state.

Turns annotation on or off. When on, the annotation appears in the upper left corner of the oscilloscope display and can be used for documentation purposes.

NameTypeValuesDescription
settingenum1 | ON | 0 | OFFSets the annotation state.
enum - Returns the annotation setting.

Specifies the background mode for annotations. The query returns the currently specified annotation background mode.

NameTypeValuesDescription
modeenumOPAQue | INVerted | TRANsparentSelects the annotation background style.
enum - Returns the specified annotation background mode.

Specifies the annotation color. You can choose white, red, or colors that match analog channels, digital channels, math waveforms, reference waveforms, or markers.

NameTypeValuesDescription
colorenumCH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARKer | WHITe | REDAnnotation color to use.
enum - Returns the specified annotation color.

Specifies the annotation text displayed on the oscilloscope screen. The string may be up to 254 characters and can be cleared by sending an empty quoted string.

NameTypeValuesDescription
stringstring-Quoted ASCII annotation string, up to 254 characters.
string - Returns the specified annotation text. Any carriage returns in the text are returned as actual carriage return characters (ASCII 0x0D).
:DISPlay:ANNotation:TEXT <string>
:DISPlay:ANNotation:TEXT?
:DISPlay:CLEarset / query

Clears the display and resets all associated measurements. If the oscilloscope is stopped, all currently displayed data is erased; if it is running, data for active channels and functions is erased and new data appears on the next acquisition.

:DISPlay:DATAset / query

Reads screen image data from the display. The image can be returned in BMP, BMP8bit, or PNG format, with color or grayscale palette selection; default is BMP, COLOR.

NameTypeValuesDescription
formatoptenumBMP | BMP8bit | PNGScreen image file format to return.
paletteoptenumCOLor | GRAYscaleColor or grayscale palette for the returned screen image.
block - Binary block screen image data in IEEE-488.2 # format.
:DISPlay:DATA? BMP, COLOR

Sets the waveform intensity, the same as adjusting the front panel Intensity knob.

NameTypeValuesDescription
valueinteger0 - 100Waveform intensity setting.
integer - Returns the waveform intensity setting.
:DISPlay:LABelset / query

Turns the analog channel labels on and off. The query returns the display mode of the analog channel labels.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFTurns the analog channel labels on or off.
enum - Returns the display mode of the analog channel labels.
myScope.WriteString ":DISPlay:LABel ON" ' Turn on labels.
:DISPlay:LABListset / query

Adds labels to the display label list. Labels are added in alphabetical order, and duplicate labels are not added.

NameTypeValuesDescription
binary block datablock-An ordered list of up to 75 labels, with a maximum of 10 characters each, separated by newline characters.

Sets the softkey menu timeout period. OFF and MAX are equivalent.

NameTypeValuesDescription
valueinteger5 - 60Softkey menu timeout period in NR1 format.
qualifierenumOFF | MAXAlternative keywords equivalent to a numeric timeout value.

Sets the display persistence setting. You can choose zero persistence, infinite persistence, or a variable persistence time in seconds.

NameTypeValuesDescription
valueenumMINimum | INFinitePersistence setting to apply.

Enables or disables transparent mode for DVM, mask test statistics, and waveform memory readouts in the front panel graphical user interface. The query returns the current transparent setting.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONSets the transparent mode state.
enum - Returns the transparent setting.
:DISPlay:VECTorsset / query

Turns display vectors on or off. When enabled, lines are drawn between acquired data points on the screen.

NameTypeValuesDescription
vectorsenum1 | ONSpecifies whether display vectors are enabled.
:DISPlay:CONNectset / query

Turns vectors on and off, controlling whether the oscilloscope displays lines connecting sampled data points or only the sampled data. This obsolete command is provided for compatibility with previous oscilloscopes; use :DISPlay:VECTors instead.

NameTypeValuesDescription
connectenum1 | ON | 0 | OFFTurns vectors on or off.
enum - Returns the current state of the vectors setting.

:DVM:ARANgeset / query

Turns the digital voltmeter's Auto Range capability on or off for the selected DVM source channel when that channel is not used in oscilloscope triggering. When enabled, the channel's vertical scale, vertical position, and trigger level are automatically adjusted; when disabled, the channel can be adjusted normally.

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Enables or disables Auto Range.
:DVM:CURRentset / query

Returns the displayed 3-digit DVM value based on the current mode. After DVM analysis is enabled, it may take a few seconds before the query returns a good value instead of +9.9E+37.

real - The displayed DVM value in NR3 floating-point format.
:DVM:ENABleset / query

Turns the digital voltmeter (DVM) analysis feature on or off.

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Selects whether DVM analysis is disabled or enabled.
:DVM:FREQuencyset / query

Returns the displayed 5-digit frequency value shown below the main DVM value. If the DVM FREQuency mode requirements are not met, the query returns 9.9E+37.

real - Displayed 5-digit frequency value in NR3 floating-point format.
:DVM:MODEset / query

Sets the digital voltmeter (DVM) mode. The frequency mode requires EDGE or GLITch trigger mode, and the DVM source and trigger source must be the same analog channel.

NameTypeValuesDescription
dvm_modeenumACRMs | DC | DCRMs | FREQuencySelects the DVM mode.
:DVM:SOURceset / query

Sets the analog channel on which DVM measurements are made. The selected channel does not have to be displayed for DVM measurements to be made.

NameTypeValuesDescription
sourceenumCHANnel<n>Analog channel used as the DVM input source.

Sets the external trigger bandwidth limit. This command is provided for product compatibility; the only legal value is 0 or OFF. The related :TRIGger:HFReject command is used to limit bandwidth on the external trigger input.

NameTypeValuesDescription
bwlimitenum0 | OFFBandwidth-limit setting for the external trigger input.

Sets the external trigger input display setting. On InfiniiVision DSOX1204A/G oscilloscopes, the command can be set to OFF only.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONExternal trigger input display setting.
:EXTernal:LABelset / query

Sets the external trigger input's label. Labels are quoted ASCII strings up to 10 characters; longer labels are truncated and lowercase characters are converted to uppercase.

NameTypeValuesDescription
stringstring-Quoted ASCII label string to assign to the external trigger input.
:EXTernal:LEVelset / query

Sets the external trigger input threshold voltage level. The query returns the current external trigger input threshold voltage setting.

NameTypeValuesDescription
levelreal-External trigger input threshold value in NR3 format.
suffixenumV | mVUnit suffix for the level value.
real - External trigger input threshold voltage setting.

Sets the external trigger input waveform's vertical position on the oscilloscope display. The base of the displayed waveform can be positioned from -3.5 divisions to 2.5 divisions; on InfiniiVision DSOX1204A/G oscilloscopes it can be set to zero only.

NameTypeValuesDescription
valuereal-3.5 - 2.5Vertical position of the external trigger input waveform in divisions.
:EXTernal:PROBeset / query

Specifies the probe attenuation factor for the external trigger. The setting affects trigger scaling references, not the oscilloscope input sensitivity.

NameTypeValuesDescription
attenuationreal0.1 - 10000Probe attenuation ratio in NR3 format.
:EXTernal:RANGeset / query

Sets the external trigger input signal range. For DSOX1200-Series oscilloscopes the range is 1.6 V or 8 V with a 1:1 probe; for EDUX1000-Series oscilloscopes it is 8 V with a 1:1 probe and cannot be changed.

NameTypeValuesDescription
rangerealVVertical full-scale range value in NR3 format.
suffixoptenumV | mVOptional unit suffix for the range value.
real - Returns the current full-scale range setting for the external trigger.
:EXTernal:UNITsset / query

Sets the measurement units for the probe connected to the external trigger input. Select VOLT for a voltage probe and AMPere for a current probe; measurement results, channel sensitivity, and trigger level reflect the selected units.

NameTypeValuesDescription
unitsenumVOLT | AMPereMeasurement units for the external trigger probe.
:EXTernal:PMODeset / query

Obsolete compatibility command related to external probe sense mode. The mode is internally controlled and cannot be set; if the sent value matches the oscilloscope setting, the command is accepted, otherwise a setting conflict error is generated.

NameTypeValuesDescription
pmode valueenumAUTo | MANualProbe sense mode value.

:FFT:CENTerset / query

Sets the FFT center frequency when FFT is selected. The query returns the current center frequency in Hertz.

NameTypeValuesDescription
frequencyreal-25 GHz - 25 GHzCurrent center frequency in NR3 format.
real (Hz) - The current center frequency in Hertz.
:FFT:DISPlayset / query

Turns the FFT function display on or off. When ON, the FFT function is calculated and displayed; when OFF, it is neither calculated nor displayed.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether FFT display is off or on.
:FFT:OFFSetset / query

Sets the FFT vertical value represented at center screen. If the specified value is outside the legal range, it is adjusted to the nearest legal value. This command is equivalent to :FFT:REFerence.

NameTypeValuesDescription
offsetreal-The value at center screen in NR3 format.
real - Returns the current offset value for the FFT function.
:FFT:RANGeset / query

Defines the full-scale vertical axis value for the FFT function.

NameTypeValuesDescription
rangereal-Full-scale vertical axis value in NR3 format.
real - Current full-scale range value for the FFT function.
:FFT:REFerenceset / query

Specifies the FFT vertical value represented at center screen. If the level is set outside the legal range, it is automatically adjusted to the nearest legal value.

NameTypeValuesDescription
levelreal-Current reference level in NR3 format.
:FFT:SCALeset / query

Sets the vertical scale, or units per division, of the FFT function. Legal values depend on the selected function.

NameTypeValuesDescription
scale_valuereal-Floating-point scale value in NR3 format.
suffixoptenumdBOptional suffix for the scale value.
real - Returns the current scale value for the FFT function.
:FFT:SOURce1set / query

Selects the source for the FFT function.

NameTypeValuesDescription
offset--
:FFT:SPANset / query

Sets the frequency span of the display when FFT is selected. The query returns the current frequency span in Hertz.

NameTypeValuesDescription
spanreal1 Hz - 100 GHzCurrent frequency span in NR3 format.
real (Hz) - Current frequency span in Hertz.
:FFT:VTYPeset / query

Specifies the FFT vertical units. The query returns the current FFT vertical units.

NameTypeValuesDescription
unitsenumDECibel | VRMSFFT vertical units to set.
enum - Current FFT vertical units.
:FFT:WINDowset / query

Selects the FFT windowing transform used for the FFT function. The default window is HANNing.

NameTypeValuesDescription
windowenumRECTangular | HANNing | FLATtop | BHARrisFFT window to apply.
:FFT:WINDow HANNing

:FRANalysis:DATAset / query

Returns the frequency response analysis data. The data is returned in four comma-separated columns for each step in the sweep: Frequency (Hz), Amplitude (Vpp), Gain (dB), and Phase (°).

block - Frequency response analysis data in a binary block format, with comma-separated data and newlines at the end of each row.

Turns the Frequency Response Analysis (FRA) feature on or off. The query returns a flag indicating whether FRA is on or off.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONSpecifies whether FRA is enabled or disabled.
enum - Returns a flag indicating whether the Frequency Response Analysis (FRA) feature is on or off.

Selects the frequency response analysis mode, either swept frequency response analysis or single-frequency analysis. The single mode is available only through the remote programming interface.

NameTypeValuesDescription
settingenumSWEep | SINGleSets the frequency mode.
enum - Returns the frequency mode setting.

Sets the single frequency value.

NameTypeValuesDescription
valuereal10 Hz - 20 MHzSingle frequency value in NR3 format.
suffixoptenumHz | kHz | MHzOptional unit suffix appended to the value.
real - Returns the single frequency setting.

Sets the frequency sweep start value. The query returns the frequency sweep start setting.

NameTypeValuesDescription
valuereal10 Hz - 19.99 MHzFrequency sweep start value, specified in NR3 format with an optional Hz, kHz, or MHz suffix.
real (Hz) - The frequency sweep start setting.

Sets the frequency sweep stop value. The query returns the frequency sweep stop setting.

NameTypeValuesDescription
valuereal10.1 Hz - 20 MHzFrequency sweep stop value in NR3 format.
suffixoptenumHz | kHz | MHzOptional unit suffix for the frequency value.
real (Hz) - Frequency sweep stop setting.
:FRANalysis:RUNset / query

Performs the Frequency Response Analysis by sweeping a sine wave across a frequency range and measuring gain and phase of the DUT. :FRANalysis:APPLy is a valid compatible alias.

Specifies the analog input channel used to probe the input voltage to the DUT in the frequency response analysis. The query returns the currently selected input channel.

NameTypeValuesDescription
sourcediscrete-Analog input channel to use for probing the DUT input voltage.
discrete - Currently selected channel probing the input voltage.

Specifies the analog input channel that is probing the output voltage from the DUT in the frequency response analysis. The query returns the currently selected channel.

NameTypeValuesDescription
sourcechannel_list-Analog input channel selecting the output-voltage probe input.
channel_list - The currently selected channel probing the output voltage.

Sets the total number of points in the frequency response analysis sweep. The query returns the current number of points setting.

NameTypeValuesDescription
ptsinteger1 - 1000Number of points in NR1 format.
integer - The number of points setting.

Specifies whether to include gain, phase, both, or neither in the frequency response analysis results. It affects the oscilloscope front panel graphical user interface and saved analysis data.

NameTypeValuesDescription
selectionenumNONE | ALL | GAIN | PHASeSelects which analysis data to include in the frequency response analysis results.

Selects the expected output load impedance used by the waveform generator to display correct amplitude and offset levels. The actual Gen Out BNC output impedance is fixed at 50 ohms.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.
enum - Returns the current expected output load impedance.

Specifies the waveform generator's output sine wave amplitude. Use :WGEN:VOLTage:OFFSet to specify the offset voltage or DC level, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to set amplitude and offset indirectly.

NameTypeValuesDescription
amplituderealVAmplitude in volts, in NR3 format.
real (V) - Returns the currently specified waveform generator amplitude in volts, in NR3 format.

Specifies the number of points per decade in the frequency response analysis. This command is deprecated; use :FRANalysis:SWEep:POINts instead.

NameTypeValuesDescription
valueinteger10 - 50Number of points per decade.

Turns function display on or off. When ON, the function is performed using the other FUNCtion commands; when OFF, the function is neither calculated nor displayed.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFSelects whether the function display is enabled or disabled.

Sets the FFT center frequency when FFT is selected. The query returns the current center frequency in Hertz.

NameTypeValuesDescription
frequencyreal0 Hz - 25 GHzCurrent center frequency in NR3 format.
real (Hz) - Returns the current center frequency in Hertz.

Sets the reference point for calculating the FFT Phase function to either the trigger point or the beginning of the displayed waveform. The query returns the selected reference point.

NameTypeValuesDescription
ref_pointenumTRIGger | DISPlayReference point for FFT phase calculation.
enum - Selected reference point.

Sets the FFT display frequency span from left graticule to right graticule. The current span can be queried in Hertz.

NameTypeValuesDescription
spanreal1 Hz - 100 GHzCurrent frequency span in NR3 format.

Specifies the FFT vertical units. The allowed units depend on whether the FFT magnitude or FFTPhase operation is selected.

NameTypeValuesDescription
unitsenumDECibel | VRMS | DEGRees | RADiansSets the FFT vertical units.
enum - Returns the current FFT vertical units. For FFT magnitude, the response is DEC or VRMS; for FFTPhase, the response is DEGR or RAD.

Selects the FFT windowing transform used for the :FUNCtion[:FFT] operation. The HANNing window is the default.

NameTypeValuesDescription
windowenumRECTangular | HANNing | FLATtop | BHARrisFFT window type to apply.

Sets the low-pass filter's -3 dB cutoff frequency. The low-pass filter is a 4th order Bessel-Thompson filter.

NameTypeValuesDescription
3dB_freqreal--3 dB cutoff frequency value in NR3 format.

Sets the math operation for the g(t) source used as the input to the FFT function. The available operations are ADD, SUBTract, and MULTiply.

NameTypeValuesDescription
operationenumADD | SUBTract | MULTiplyMath operation for the g(t) source.

Selects the first input channel for the g(t) source used as input to the FFT function.

NameTypeValuesDescription
valuechannel_list1 - # analog channelsChannel selection in CHANnel<n> form, where n ranges from 1 to the number of analog channels.

Selects the second input channel for the g(t) source used as the input to the FFT function.

NameTypeValuesDescription
valuechannel_list-Channel selection CHANnel<n>, where n is 1 to the number of analog channels in NR1 format.
channel_list - Returns the current selection for the second input channel for the g(t) source.
:FUNCtion:OFFSetset / query

Sets the voltage or vertical value represented at center screen for the selected function. Values outside the legal range are automatically set to the nearest legal value; this command is equivalent to :FUNCtion:REFerence.

NameTypeValuesDescription
offsetreal-The value at center screen in NR3 format.

Sets the desired waveform math operation for the selected function. Supported operations are ADD, SUBTract, MULTiply, DIVide, FFT, FFTPhase, and LOWPass.

NameTypeValuesDescription
operationenumADD | SUBTract | MULTiply | DIVide | FFT | FFTPhase | LOWPassSelects the waveform math operation.
:FUNCtion:RANGeset / query

Defines the full-scale vertical axis for the selected function. The query returns the current full-scale range value for the selected function.

NameTypeValuesDescription
rangereal-The full-scale vertical axis value in NR3 format.
real - The current full-scale range value for the selected function.

Sets the reference level (voltage or vertical value) represented at center screen for the selected function. The command is equivalent to :FUNCtion:OFFSet; values outside the legal range are rounded to the nearest legal value.

NameTypeValuesDescription
levelreal-10 - 10Current reference level in NR3 format.
:FUNCtion:SCALeset / query

Sets the vertical scale, or units per division, of the selected function. Legal values depend on the selected function.

NameTypeValuesDescription
scale valueinteger-Scale value in NR1 format.
suffixoptenumV | dBOptional unit suffix for the scale value.

Selects the first source for function operations, including channel math operations and FFT. For FFT, GOFT is only available and specifies a g(t) source used with :FUNCtion:GOFT:OPERation, :FUNCtion:GOFT:SOURce1, and :FUNCtion:GOFT:SOURce2.

NameTypeValuesDescription
valueenumCHANnel<n> | GOFTSource to use for function operations.
:FUNCtion:SOURce1 <value>
:FUNCtion:SOURce1?

Specifies the second source for math operations that have two sources, such as ADD, SUBTract, or MULTiply. The setting is not used when :FUNCtion:OPERation is FFT.

NameTypeValuesDescription
valueenumCHANnel<n> | NONESelects the second math source channel or disables the source.
:FUNCtion:SOURceset / query

Selects the source for function operations when an FFT operation is selected. This obsolete command is provided for compatibility with previous oscilloscopes; use :FUNCtion:SOURce1 instead.

NameTypeValuesDescription
valueenumCHANnel<n> | ADD | SUBTract | MULTiplySpecifies the source for FFT function operations.
enum - Returns the current source for function operations.
:FUNCtion:VIEWset / query

Turns the selected function on or off. When ON, the function is calculated and displayed; when OFF, it is neither calculated nor displayed.

NameTypeValuesDescription
viewenum1 | ON | 0 | OFFSelects whether the function is viewed (on) or hidden (off).

:HARDcopy:AREAset / query

Controls what part of the display area is printed. Currently, the only legal choice is SCReen.

NameTypeValuesDescription
areaenumSCReenSpecifies the display area to print.

Sets the active printer. The query returns the name of the active printer.

NameTypeValuesDescription
active_printernumeric-Specifies the active printer by index or by name.
string - The name of the active printer.

Controls whether the scale factors are output on the hardcopy dump.

NameTypeValuesDescription
factorsenumOFF | 0 | ON | 1Enables or disables output of the scale factors on the hardcopy dump.
:HARDcopy:FFEedset / query

Controls whether a formfeed is output between the screen image and factors of a hardcopy dump.

NameTypeValuesDescription
ffeedenumOFF | 0 | ON | 1Selects whether a formfeed is output.

Controls whether the graticule colors are inverted or not.

NameTypeValuesDescription
valueenumOFF | 0 | ON | 1Sets whether graticule colors are inverted.
:HARDcopy:LAYoutset / query

Sets the hardcopy layout mode. The query returns the selected hardcopy layout mode.

NameTypeValuesDescription
layoutenumLANDscape | PORTraitSelects the hardcopy layout mode.
enum - Returns the selected hardcopy layout mode.

Sets the address for a network printer slot. The address is entered as a quoted ASCII string in an IP-address or print-server path format.

NameTypeValuesDescription
addressstring-Quoted ASCII string specifying the printer or print server address.

Selects the network printer slot used for the address and apply commands. Two slots are available.

NameTypeValuesDescription
slotenumNET0 | NET1Network printer slot to use.

Sets the hardcopy palette color. The COLOR option is not available when connected to laser printers.

NameTypeValuesDescription
paletteenumCOLor | GRAYscale | NONEHardcopy palette color to use.

Returns a list of available printers. The list may be empty.

string - A printer list terminated by <NL>, consisting of zero or more printer_spec entries.

Sets the hardcopy destination. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:FILename instead.

NameTypeValuesDescription
destinationenumCENTronics | FLOPpySelects the hardcopy destination.

Sets the output filename for print formats whose output is a file. This is an obsolete compatibility command; use :SAVE:FILename or :RECall:FILename instead.

NameTypeValuesDescription
stringstring-Quoted ASCII string specifying the filename.

Controls whether grayscaling is performed in the hardcopy dump. This obsolete command is provided for compatibility; use :HARDcopy:PALette instead.

NameTypeValuesDescription
grayenumOFF | 0 | ON | 1Enables or disables grayscaling in the hardcopy dump.

Controls whether the graticule colors are inverted. This obsolete command is provided for compatibility with previous oscilloscopes; use :HARDcopy:INKSaver instead.

NameTypeValuesDescription
valueenumOFF | 0 | ON | 1Sets whether graticule colors are inverted.

Sets the hardcopy printer driver used for the selected printer. This command is obsolete and provided only for compatibility; use :HARDcopy:APRinter instead.

NameTypeValuesDescription
driverenumAP2Xxx | AP21xx | AP2560 | AP25 | DJ350 | DJ35 | DJ6xx | DJ630 | DJ63 | DJ6Special | DJ6Photo | DJ8Special | DJ8xx | DJ9Vip | OJPRokx50 | DJ9xx | GVIP | DJ55xx | PS470 | PS47 | PS100 | PS10 | CLASer | MLASer | LJFastraster | POSTscriptPrinter driver to use for hardcopy output.
enum - Returns the selected hardcopy printer driver.

:LISTer:DATAset / query

Returns the lister data.

block - The lister data is returned as a binary block response followed by a newline.
:LISTer:DISPlayset / query

Turns the serial bus Lister display on or off. Serial bus decode must be on before it can be displayed in the Lister.

NameTypeValuesDescription
valueenumOFF | 0 | SBUS1 | ON | 1Selects whether the Lister display is off or on.

Selects whether the time value for a Lister row is relative to the trigger or the previous Lister row. The query returns the current Lister time reference setting.

NameTypeValuesDescription
time_refenumTRIGger | PREViousSelects the time reference for a Lister row.
enum - Current Lister time reference setting.
:LISTer:REFerence <time_ref>
:LISTer:REFerence?

:MARKer:MODEset / query

Sets the cursors mode. OFF removes cursor information from the display; MANual enables manual cursor placement; MEASurement makes cursors track the most recent measurement; WAVeform makes the Y cursors track waveform values at the X cursors.

NameTypeValuesDescription
modeenumOFF | MEASurement | MANual | WAVeformSelects the cursors mode.

Sets the X1 cursor position to the specified value. It also sets :MARKer:MODE to MANual if the mode is not currently WAVeform; cursor units are set by :MARKer:XUNits.

NameTypeValuesDescription
positionreal-X1 cursor position in NR3 format.
suffixoptenums | ms | us | ns | ps | Hz | kHz | MHzOptional suffix for the X1 cursor position.

Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode and also sets the source for the other marker pair.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | EXTernalSource for the cursors.

Sets the X2 cursor position to the specified value and switches :MARKer:MODE to MANual if it is not currently WAVeform. The X cursor units are set by :MARKer:XUNits.

NameTypeValuesDescription
positionreal-X2 cursor position in NR3 format.
suffixoptenums | ms | us | ns | ps | Hz | kHz | MHzOptional unit suffix for the X2 cursor position.

Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode; if the mode is WAVeform, X2Y2source can be set separately from X1Y1source.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Source to use for the cursors.
:MARKer:XDELtaset / query

Returns the value difference between the current X1 and X2 cursor positions. Xdelta is calculated as the value at X2 minus the value at X1, using the X units set by :MARKer:XUNits.

real - Difference value in NR3 format.
:MARKer:XUNitsset / query

Sets the X cursors units. Changing X units affects the input and output values of :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta commands/queries.

NameTypeValuesDescription
unitsenumSEConds | HERTz | DEGRees | PERCentSelects the X cursor units.

Sets the current X1 location as 0 degrees and the current X2 location as 360 degrees when :MARKer:XUNits is set to DEGRees. When :MARKer:XUNits is set to PERCent, it sets X1 to 0 percent and X2 to 100 percent; subsequent X1/X2/Delta positions are relative to these set locations.

Sets or queries the Y1 cursor position. When :MARKer:MODE is not WAVeform, setting this command forces :MARKer:MODE to MANual and updates the Y1 cursor position; the query returns the current Y1 cursor position.

NameTypeValuesDescription
positionreal-Y1 cursor position in NR3 format.
suffixoptenummV | V | dBOptional unit suffix for the position.
real - Current Y1 cursor position in NR3 format.

Sets the Y2 cursor position in NR3 format and, if marker mode is not WAVeform, forces :MARKer:MODE to MANual. The query returns the current Y2 cursor position.

NameTypeValuesDescription
positionreal-Y2 cursor position in NR3 format.
suffixoptenummV | V | dBUnits suffix for the cursor position.
real - Current Y2 cursor position in NR3 format.
:MARKer:YDELtaset / query

Returns the value difference between the current Y1 and Y2 cursor positions, computed as Y2 minus Y1. The value is returned in the Y cursor units set by :MARKer:YUNits.

real - Difference value in NR3 format, equal to the value at the Y2 cursor minus the value at the Y1 cursor.
:MARKer:YUNitsset / query

Sets the Y cursor units. BASE uses the units associated with the cursor source, and PERCent uses ratio measurements.

NameTypeValuesDescription
unitsenumBASE | PERCentSelects the Y cursor units.
enum - Returns the current Y cursor units.

When :MARKer:YUNits is set to PERCent, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. After the percent locations are set, inputs to and outputs from :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta are relative to those locations.

:MEASure:ALLset / query

Installs a Snapshot All measurement on the screen.

:MEASure:BRATeset / query

Installs a screen measurement and starts the bit rate measurement. If the optional source parameter is specified, the currently specified source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalMeasurement source to use.
:MEASure:CLEarset / query

Clears all selected measurements and markers from the screen.

:MEASure:COUNterset / query

Installs a counter measurement and starts counting trigger-level crossings for the selected source. If an optional source is specified, it changes the current source; the source may be any channel except Math or EXTernal.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | EXTernalSpecifies the measurement source.
:MEASure:DEFineset / query

Sets up the definition for measurements by specifying delay edge specifications or threshold values. Changing these values may affect the results of other measurement commands.

NameTypeValuesDescription
meas_specenumDELay | THResholdsSelects whether delay or threshold definitions are being set.
sourceoptenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r>Selects the source used for the measurement definition.
:MEASure:DELayset / query

Places the instrument in continuous measurement mode and starts a delay measurement between two selected sources. The query measures and returns the delay using the user-defined edge and threshold settings from :MEASure:DEFine, while the non-query version runs in auto-edge select mode.

NameTypeValuesDescription
source1optenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>First measurement source.
source2optenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Second measurement source.

Installs a screen measurement and starts a duty cycle measurement on the current :MEASure:SOURce. If an optional source is specified, it also changes the current source.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSource signal to measure.
real - Returns the measured duty cycle, defined as the ratio of positive pulse width to period, in NR3 format.

Installs a screen measurement and starts a fall-time measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source.

Installs a screen measurement and starts a frequency measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalMeasurement source to use.
real (Hz) - Measures and outputs the frequency of the cycle on the screen closest to the trigger reference, in Hertz.
:MEASure:NDUTyset / query

Installs a screen measurement and starts a negative duty cycle measurement on the current :MEASure:SOURce. If an optional source is specified, it becomes the current source.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSpecifies the source signal to measure.
real - Ratio of negative pulse width to period, returned in NR3 format.
:MEASure:NEDGesset / query

Installs a falling edge count measurement on screen. If no source is specified, the current source is measured; the command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source.
real - Returns the on-screen falling edge count.
:MEASure:NPULsesset / query

Installs a falling pulse count measurement on screen. If the optional source is not specified, the current source is measured; the command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.
:MEASure:NWIDthset / query

Installs a screen measurement and starts a negative pulse width measurement. If the optional source parameter is omitted, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalMeasurement source to use.
:MEASure:NWIDth [<source>]
:MEASure:NWIDth? [<source>]

Installs a screen overshoot measurement and starts measuring overshoot. If an optional source is specified, the current source is modified. The command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.
:MEASure:PEDGesset / query

Installs a rising edge count measurement on screen. If the optional source is not specified, the current source is measured.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source.
:MEASure:PERiodset / query

Installs a screen period measurement and starts the period measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSelects the measurement source.
real (s) - Returns the waveform period in seconds.
:MEASure:PHASeset / query

Places the instrument in continuous measurement mode and starts a phase measurement. The query measures and returns the phase between the specified sources, calculated from delay and period.

NameTypeValuesDescription
source1optenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>First measurement source.
source2optenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Second measurement source.
real (deg) - The phase angle value in degrees.
:MEASure:PPULsesset / query

Installs a rising pulse count measurement on screen. If no source is specified, the current source is measured; the command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.
:MEASure:PPULses? [<source>]

Installs a screen measurement and starts a preshoot measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
:MEASure:PWIDthset / query

Installs a screen measurement and starts the positive pulse width measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalMeasurement source to use.
:MEASure:RESultsset / query

Returns the results of the continuously displayed measurements as a comma-separated list of values. If more than one continuous measurement is running, the results are duplicated in left-to-right display order.

string - A comma-separated result list of measurement results; returns an empty string when no quick measurements are installed.
:MEASure:RESults?

Installs a screen measurement and starts a rise-time measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
real (s) - Returns the measured rise time of the displayed rising edge closest to the trigger reference, in seconds.

Installs a screen measurement and starts standard deviation measurement; if an optional source is specified, the current source is modified. The query measures and outputs the standard deviation of the selected waveform.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source waveform.
real - Calculated standard deviation value.
:MEASure:SHOWset / query

Enables markers for tracking measurements on the display. This feature is always on.

NameTypeValuesDescription
showenum1 | ONMarker display state.
:MEASure:SOURceset / query

Sets the default source selections used by MEASure subsystem commands when sources are not explicitly specified. If a source is specified for any measurement, the current source is changed to that value.

NameTypeValuesDescription
source1enumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalPrimary measurement source.
source2optenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSecondary measurement source; applies only to delay and phase measurements.
:MEASure:SOURCE CHANNEL1

Determines the type of information returned by the :MEASure:RESults? query. ON means all statistics are on.

NameTypeValuesDescription
typeenumON | 1 | CURRent | MINimum | MAXimum | MEAN | STDDev | COUNtSelects the statistics mode.
:MEASure:STATistics?

Disables or enables the display of the measurement statistics.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether measurement statistics display is disabled or enabled.

Updates the statistics once by incrementing the count by one using the current measurement values. It is only allowed when the oscilloscope is stopped and quick measurements are on; segmented acquisition mode is allowed.

Specifies the maximum number of values used when calculating measurement statistics. The query returns the current measurement statistics max count setting.

NameTypeValuesDescription
settingenumINFiniteSets the statistics max count to infinite or to a numeric count.
countoptinteger2 - 2000Numeric maximum count in NR1 format.
enum - Current measurement statistics max count setting.

Resets the measurement statistics and zeroes the counts. The measurement statistics configuration is not deleted.

Disables or enables relative standard deviations, i.e. standard deviation/mean, in the measurement statistics.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether relative standard deviations are disabled or enabled.
enum - Returns the current relative standard deviation setting as 0 or 1.
:MEASure:TEDGeset / query

Queries the time interval between the trigger event and the specified waveform transition. The optional source parameter can be used to modify the current source.

NameTypeValuesDescription
slopeenum+ | -Direction of the waveform transition; rising is indicated by space or plus sign, falling by minus sign.
occurrenceinteger1Transition number to be reported, counted from the left screen edge.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSelects the signal source to search for the specified transition.
real (s) - Time in seconds of the specified transition, referenced to the trigger point (time zero). If the specified crossing cannot be found, +9.9E+37 is returned.
:MEASURE:TEDGE? +1, CHAN1
:MEASURE:TEDGE? +1, CHAN2
:MEASURE:TEDGE? +2, CHAN1
:MEASure:TVALueset / query

Queries the time interval from the trigger event to the specified value crossing of the displayed signal. The query searches for the requested level, slope, and occurrence, and returns the crossing time in seconds; if the crossing cannot be found, it returns +9.9E+37.

NameTypeValuesDescription
valuereal-Vertical value that the waveform must cross.
slopeoptenum+ | -Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge.
occurrenceinteger-Transition number to report, where 1 is the first crossing, 2 the second, and so on.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Source signal to measure; if specified, the current source is modified.
real (s) - Time in seconds of the specified value crossing, in NR3 format.

Installs a screen measurement and starts a vertical amplitude measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source.

Installs a screen measurement and starts an average value measurement. If an optional source is specified, the current source is modified; if interval is omitted, DISPlay is implied.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlaySpecifies the measurement interval as an integral number of cycles or the full screen.
sourceoptenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r>Selects the source for the average value measurement.
real - Returns the average value of an integral number of periods of the signal; if at least three edges are not present, the oscilloscope averages all data points.
:MEASure:VBASeset / query

Installs a screen measurement and starts a waveform base value measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
:MEASure:VMAXset / query

Installs a screen measurement and starts a maximum vertical value measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r>Selects the waveform source to measure.
:MEASure:VMINset / query

Installs a screen measurement and starts a minimum vertical value measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r>Selects the waveform source used for the minimum vertical value measurement.
:MEASure:VPPset / query

Installs a screen measurement and starts a vertical peak-to-peak measurement. If an optional source is specified, the current source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r>Selects the measurement source.
:MEASure:VRMSset / query

Installs a screen measurement and starts an RMS value measurement. If an optional source is specified, the current source is modified. For the query, measures and outputs the dc RMS value of the selected waveform.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval: an integral number of cycles or the full screen.
typeoptenumAC | DCSelects AC RMS or DC RMS measurement.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use or modify.
real - Calculated dc RMS value in NR3 format.
:MEASure:VTIMeset / query

Returns the value at a specified time on the source specified with :MEASure:SOURce. The specified time must be on the screen and is referenced to the trigger event; if the optional source is specified, the current source is modified.

NameTypeValuesDescription
vtime_argumentrealsTime from trigger in seconds.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | EXTernalSource to measure from; if specified, the current source is modified.
real - Value at the specified time in NR3 format. For EXTernal digital waveform source, the returned value is either 1 or 0 based on the threshold voltage setting.
:MEASure:VTOPset / query

Installs a screen measurement and starts a waveform top value measurement. The query returns the vertical value at the top of the waveform.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATHMeasurement source.
real - Vertical value at the top of the waveform in NR3 format.
:MEASure:WINDowset / query

Specifies which measurement window is used when the zoomed time base is displayed. MAIN selects the upper Main window, ZOOM selects the lower Zoom window, and AUTO tries the Zoom window first and falls back to the Main window.

NameTypeValuesDescription
typeenumMAIN | ZOOM | AUTOSelects the measurement window to use.
:MEASure:XMAXset / query

Installs a screen measurement and starts an X-at-Max-Y measurement on the selected window. If an optional source is specified, the current source is modified. The query returns the horizontal axis value at which the maximum vertical value occurs.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
real - Horizontal value of the maximum, returned in NR3 format.
:MEASure:XMAX [<source>]
:MEASure:XMAX? [<source>]
:MEASure:XMINset / query

Installs a screen measurement and starts an X-at-Min-Y measurement on the selected window. If an optional source is specified, the current source is modified. It is an alias for :MEASure:TMIN.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
real - Returns the horizontal axis value at which the minimum vertical value occurs.
:MEASure:LOWerset / query

Sets the lower measurement threshold value. The value and the UPPer value represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent as defined by :MEASure:DEFine THResholds.

NameTypeValuesDescription
voltagerealVLower threshold value.
real (V) - Returns the current lower threshold level as the user-defined lower threshold in volts in NR3 format.
:MEASure:SCRatchset / query

Clears all selected measurements and markers from the screen. This command is obsolete and provided for backward compatibility; use :MEASure:CLEar instead.

:MEASure:TDELtaset / query

Obsolete command provided for compatibility with previous oscilloscopes. The query returns the time difference between the Tstop marker (X2 cursor) and the Tstart marker (X1 cursor), equal to Tstop - Tstart.

real - Time difference between start and stop markers in NR3 format.

Selects the thresholds used when making time measurements. This command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.

NameTypeValuesDescription
thresholdsenumT1090 | T2080 | VOLTageThreshold set used for time measurements.
:MEASure:TMAXset / query

Installs a screen measurement and starts an X-at-Max-Y measurement on the selected waveform. If an optional source is specified, it becomes the current source. This command is obsolete and provided for backward compatibility; use :MEASure:XMAX instead.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATHSelects the source waveform to measure.
:MEASure:TMINset / query

Installs a screen measurement and starts an X-at-Min-Y measurement on the selected waveform. If an optional source is specified, it modifies the current source; the command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATHSelects the waveform source for the measurement.
:MEASure:TSTArtset / query

Moves the start marker (X1 cursor) to the specified time with respect to the trigger time. It is an obsolete compatibility command; the manual recommends :MARKer:X1Position instead.

NameTypeValuesDescription
valuerealsTime at the start marker in seconds.
suffixoptenums | ms | us | ns | psOptional time suffix.
real - Time at the start marker in NR3 format.
:MEASure:TSTOpset / query

Moves the stop marker (X2 cursor) to the specified time with respect to trigger time. The command is obsolete and provided for compatibility; use :MARKer:X2Position instead.

NameTypeValuesDescription
valuerealsTime at the stop marker in seconds.
suffixoptenums | ms | us | ns | psUnit suffix for the time value.
real - Returns the time at the stop marker (X2 cursor) in NR3 format.
:MEASure:TVOLtset / query

Queries the time interval between the trigger event and a specified voltage-level crossing on the displayed signal. The command is obsolete and provided for backward compatibility; if the crossing is not found, the oscilloscope returns +9.9E+37.

NameTypeValuesDescription
valuereal-The voltage level that the waveform must cross.
slopeoptreal-Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge.
occurrenceinteger1The crossing occurrence number to be reported.
sourceoptenumCHANnel<n> | FUNCtion | MATHOptional source channel or function to measure from.
real (s) - Time in seconds of the specified voltage crossing, referenced to the trigger point (time zero).
:MEASure:UPPerset / query

Sets the upper measurement threshold value. The value and the LOWer value represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent, as defined by :MEASure:DEFine THResholds.

NameTypeValuesDescription
valuereal-Upper measurement threshold value.
real - Returns the current upper threshold level in NR3 format.
:MEASure:VDELtaset / query

Returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). The returned delta is the current value and no measurement is made when the query is received.

real (V) - Delta V value in NR1 format; equal to the value at marker 2 minus the value at marker 1.
:MEASure:VSTArtset / query

Moves the vertical marker (Y1 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y1Position instead.

NameTypeValuesDescription
vstart_argumentrealVValue for vertical marker 1.
real (V) - Returns the current value of the Y1 cursor, in NR3 format.
:MEASure:VSTOpset / query

Moves vertical marker 2 (Y2 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility; use :MARKer:Y2Position instead.

NameTypeValuesDescription
vstop_argumentreal-Value for the Y2 cursor.
real - Returns the current value of the Y2 cursor in NR3 format.

:MTESt:ALLset / query

Specifies which channels are included in the mask test. ON includes all displayed analog channels; OFF includes only the selected source channel.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSelects whether all displayed analog channels or only the selected source channel are included in the mask test.

Automatically constructs a mask around the currently selected channel using the tolerance settings from :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask only covers the portion of the waveform visible on the display.

Selects the source used to interpret :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta when :MTESt:AMASk:UNITs is set to CURRent. It is equivalent to :MTESt:SOURce.

NameTypeValuesDescription
sourcestring-Source channel to use for interpreting the mask delta parameters.
string - Returns the currently set source.

Sets the units used by the mask test subsystem when interpreting automask tolerance parameters. CURRent uses the units set by :CHANnel<n>:UNITs; DIVisions uses graticule divisions as the measurement system.

NameTypeValuesDescription
unitsenumCURRent | DIVisionsMeasurement units used for automask tolerance settings.

Sets the tolerance in the X direction around the waveform for the automasking feature. The tolerance is interpreted according to the current :MTESt:AMASk:UNITs setting.

NameTypeValuesDescription
valuereal-X delta value in NR3 format.
real - Returns the current setting of the ΔX tolerance for automasking.

Sets the vertical tolerance around the waveform for the automasking feature. The tolerance is interpreted according to :MTESt:AMASk:UNITs.

NameTypeValuesDescription
valuereal-Y delta value in NR3 format.

Returns the total number of failed waveforms in the current mask test run. The count applies to all regions and all waveforms collected on the specified channel, or on the current source channel if no channel is given.

NameTypeValuesDescription
channel<n>optchannel_list-Optional channel number selector; <n> is 1 to the number of analog channels in NR1 format.
integer - Number of failed waveforms in NR1 format.

Returns the elapsed time in the current mask test run.

string - Elapsed time in the current mask test run, in NR3 format.

Returns the total number of waveforms acquired in the current mask test run.

numeric - Total number of waveforms acquired in the current mask test run, returned as a count in NR1 format.
:MTESt:DATAset / query

Loads a mask from binary block data. The query returns a mask in IEEE 488.2 definite-length binary block format.

NameTypeValuesDescription
maskblock-Binary block data in IEEE 488.2 # format.
block - A mask in binary block data format using the IEEE 488.2 # definite-length format.
:MTESt:ENABleset / query

Enables or disables the mask test features. The query returns the current mask test state.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSelects whether mask test features are enabled or disabled.
enum - Current state of mask test features.
:MTESt:LOCKset / query

Enables or disables the mask lock feature. When ON, the mask is locked to the source and is redrawn as the source scaling or position changes; when OFF, the mask remains static.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSelects whether mask lock is enabled or disabled.
:MTESt:RMODeset / query

Specifies the termination condition for the mask test. The condition can be set to forever, until Sigma level, for a fixed time, or until a fixed number of waveforms are acquired.

NameTypeValuesDescription
rmodeenumFORever | SIGMa | TIME | WAVeformsTermination condition for the mask test.
enum - Returns the currently set termination condition.

Sets measuring-only mask failures on or off. When ON, measurements and measurement statistics run only on waveforms containing a mask violation; passing waveforms do not affect measurements or statistics.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns mask-failure measurement mode on or off.

Sets printing on mask failures on or off. Setting :MTESt:RMODe:FACTion:PRINt ON automatically sets :MTESt:RMODe:FACTion:SAVE OFF.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns mask failure printing on or off.
:MTESt:RMODe:FACTion:PRINt ON
:MTESt:RMODe:FACTion:PRINt?

Sets saving on mask failures on or off. Setting :MTESt:RMODe:FACTion:SAVE ON automatically sets :MTESt:RMODe:FACTion:PRINt OFF.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns mask failure saving on or off.

Sets stopping on a mask failure on or off. When this setting is ON and a mask violation is detected, the mask test and acquisition system are stopped.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns mask-failure stopping on or off.

Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The query returns the current Sigma level setting.

NameTypeValuesDescription
levelreal0.1 - 9.3Test sigma level in NR3 format.
real - Current Sigma level setting.

Sets the number of seconds for a mask test to run when :MTESt:RMODe is set to TIME. The query returns the number of seconds currently set.

NameTypeValuesDescription
secondsreal1 - 86400Number of seconds for the mask test to run.
real - The number of seconds currently set.

Sets the number of waveform acquisitions that are mask tested when :MTESt:RMODe is set to WAVeforms. The query returns the number of waveforms currently set.

NameTypeValuesDescription
countinteger1 - 2,000,000,000Number of waveforms in NR1 format.
integer - The number of waveforms currently set.

Enables or disables Bind 1 & 0 Levels control, or Bind -1 & 0 Levels for inverted masks. When enabled, the paired level controls track each other; when disabled, adjusting one changes the mask height.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns Bind 1 & 0 Levels control on or off.
:MTESt:SCALe:X1set / query

Defines where X=0 in the base coordinate system used for mask testing. The current X1 coordinate setting can be queried.

NameTypeValuesDescription
x1_valuereal-X1 value in NR3 format.
real - Current X1 coordinate setting returned in NR3 format.

Defines the X delta value used to position the X2 marker relative to the X1 marker in the mask test coordinate system. Redefining ΔX also moves normalized polygon vertices so they remain in the same locations with respect to X1 and ΔX.

NameTypeValuesDescription
xdelta_valuereal-X delta value in NR3 format.
:MTESt:SCALe:Y1set / query

Defines where Y=0 in the coordinate system for mask testing. The value is a voltage specifying the point at which Y=0.

NameTypeValuesDescription
y1_valuerealVY1 value in NR3 format.
:MTESt:SCALe:Y2set / query

Defines the Y2 marker in the coordinate system for mask testing. The Y2 value is a voltage value specifying the location of the Y2 marker.

NameTypeValuesDescription
y2_valuereal-Y2 value in NR3 format.
real - Returns the current setting of the Y2 marker as a Y2 value in NR3 format.
:MTESt:SOURceset / query

Selects the channel configured by the commands contained in a mask file when it is loaded. The query returns the channel configured by the current mask file.

NameTypeValuesDescription
sourcediscrete-Channel number in NR1 format.
enum - Returns the selected source channel.
:MTESt:TITLeset / query

Sets or queries the mask title. The query returns the mask title, a string of up to 128 ASCII characters displayed in the mask test dialog box and mask test tab when a mask file is loaded.

string - The mask title, up to 128 ASCII characters.
:MTESt:AVERageset / query

Enables or disables averaging for test-mode acquisitions. This obsolete command is provided for backward compatibility; use :ACQuire:TYPE AVERage instead.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns averaging on or off.
enum - Returns the current averaging setting as 1 or 0.

Sets the number of averages for waveforms. With AVERage acquisition type, it specifies how many data values are averaged for each time bucket before the acquisition is complete for that bucket. The command is obsolete and provided for backward compatibility; use :ACQuire:COUNt instead.

NameTypeValuesDescription
countinteger2 - 65536Number of averages to use.
:MTESt:LOADset / query

Loads the specified mask file. The command is obsolete and provided for backward compatibility; use :RECall:MASK[:STARt] instead.

NameTypeValuesDescription
filenamestring-MS-DOS compatible file name, up to 254 characters long including the path name if used.
:MTESt:RUModeset / query

Determines the termination conditions for the mask test. The available choices are FORever, TIME, or WAVeforms; this command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
modeenumFORever | TIME | WAVeformsTermination condition for the mask test.
secondsreal1 - 86400Amount of time in seconds before the mask test terminates.
wfm_countinteger1 - 1,000,000,000Maximum number of waveforms required before the mask test terminates.
enum - Returns the currently selected termination condition and value.

Enables or disables the Stop On Failure run-until criteria. When a mask test is running and a mask violation is detected, the mask test and acquisition system are stopped. This command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables Stop On Failure.
enum - Returns the current state of the Stop on Failure control.

Sets the channel to use as the trigger. This command is obsolete and provided for backward compatibility to previous oscilloscopes.

NameTypeValuesDescription
sourcechannel_list-Trigger source channel, specified as CHANnel<n>.

:RECall:FILenameset / query

Specifies the source for RECall operations by setting the file's base name only, without path information or an extension.

NameTypeValuesDescription
base_namestring-Quoted ASCII string that names the base file for RECall operations.

Recalls a mask. The file specification may be an internal location from 0 to 3 or a quoted ASCII file name; if a file extension is provided, it must be ".msk".

NameTypeValuesDescription
file_specoptstring-Specifies the internal location or file name of the mask to recall.
:RECall:PWDset / query

Sets the present working directory for recall operations. The query returns the currently set working directory for recall operations.

NameTypeValuesDescription
path_namestring-Quoted ASCII string specifying the path name.
string - Currently set working directory for recall operations.

Recalls an oscilloscope setup. The file specification may be an internal location integer or a quoted ASCII file name; if a file extension is provided, it must be ".scp".

NameTypeValuesDescription
file_specoptstring-File specification to recall, either an internal location or a quoted ASCII file name.

Recalls a reference waveform. If a file extension is provided as part of the specified file name, it must be ".h5".

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string naming the file to recall.

:SAVE:FILenameset / query

Specifies the source for SAVE operations by setting the file's base name. The name is used without path information or an extension.

NameTypeValuesDescription
base_namestring-Quoted ASCII string that sets the file base name.

Saves an image. Set :SAVE:IMAGe:FORMat before saving; if the format is NONE the save will not succeed. If a file extension is provided and it does not match the current image format, the format may be changed to match a valid image extension.

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string used as the file name.

Controls whether oscilloscope factors are output along with the image. Factors are written to a separate file with the same path and base name but a ".txt" extension.

NameTypeValuesDescription
factorsenumOFF | 0 | ON | 1Enables or disables output of oscilloscope factors along with the image.

Sets the image format type. The query returns the selected image format type; if NONE is returned, a waveform data file format is currently selected.

NameTypeValuesDescription
formatenumBMP | BMP24bit | BMP8bit | PNGImage format type to select.
enum - Returns the selected image format type.

Controls whether the graticule colors are inverted. The query returns a flag indicating whether graticule colors are inverted or not.

NameTypeValuesDescription
valueenumOFF | 0 | ON | 1Sets whether graticule colors are inverted or not.
integer - Returns a flag indicating whether graticule colors are inverted or not.

Sets the image palette color for saved images. The query returns the selected image palette color.

NameTypeValuesDescription
paletteenumCOLor | GRAYscaleImage palette color to use for saving.
enum - Returns the selected image palette color.

Saves the Lister display data to a file. If a file extension is provided in <file_name>, it must be ".csv".

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string specifying the file name to save to.

Saves a mask to an internal location or a quoted file name. If a file name is specified with an extension, it must be ".msk".

NameTypeValuesDescription
file_specopt--File specification as either an internal location or a file name.

Saves multi-channel waveform data to a file. If a file extension is provided in the file name, it must be ".h5".

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII file name to save the waveform data to.
:SAVE:PWDset / query

Sets the present working directory for save operations. The query returns the currently set working directory for save operations.

NameTypeValuesDescription
path_namestring-Quoted ASCII string specifying the path name.
string - The currently set working directory for save operations, returned as a quoted ASCII string.

Saves an oscilloscope setup. If a file name is provided, any file extension must be ".scp".

NameTypeValuesDescription
file_specoptdiscrete-Specifies the internal location or quoted file name to save to.

Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if the file extension conflicts with the expected format, the format is changed when the extension is a valid waveform file extension.

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string specifying the file name.

Sets the waveform data format type for saving waveform data. The query returns the selected waveform data format type.

NameTypeValuesDescription
formatenumASCiixy | CSV | BINaryWaveform data format to save.
enum - Returns the selected waveform data format type. NONE indicates that an image file format is currently selected.

Sets the waveform data length, i.e. the number of points saved, when :SAVE:WAVeform:LENGth:MAX is OFF. If :SAVE:WAVeform:LENGth:MAX is ON, this setting has no effect.

NameTypeValuesDescription
lengthinteger100 - max. lengthWaveform data length to save, in NR1 integer format.
integer - Returns the current waveform data length setting.

Specifies whether the maximum number of waveform data points is saved. When OFF, :SAVE:WAVeform:LENGth specifies the number of waveform data points saved.

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Enables or disables saving the maximum number of waveform data points.
enum - Returns the current setting.

Specifies which acquired segments are included when a segmented waveform is saved. When segmented memory is used, ALL saves all acquired segments and CURRent saves only the currently selected segment.

NameTypeValuesDescription
optionenumALL | CURRentSelects which segments are included in the saved waveform.

Selects the source to be saved as a reference waveform file. For the query, returns the current save source; if the source is FUNCtion or MATH, the query returns FUNC.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Source to be saved as a reference waveform file.
enum - Returns the source to be saved as a reference waveform file. If the source is FUNCtion or MATH, the query returns FUNC.

Saves oscilloscope waveform data to a reference waveform file. If a file extension is provided in <file_name>, it must be ".h5".

NameTypeValuesDescription
file_nameoptstring-Reference waveform file name to save to.
:SAVE:IMAGe:AREAset / query

This obsolete command selects the image area used by :SAVE:IMAGe? operations. The query returns SCR for image saves and GRAT for saves of setups or waveform data.

enum - Returns the selected image area. When saving images, returns SCR; when saving setups or waveform data, returns GRAT.

:SBUS<n>:DISPlayset / query

Turns displaying of the serial decode bus on or off. The command is only valid when a serial decode option has been licensed.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFControls whether the serial decode bus display is enabled or disabled.
:SBUS<n>:MODEset / query

Determines the decode mode for the serial bus. It is only valid when a serial decode option has been licensed.

NameTypeValuesDescription
modeenumCAN | IIC | LIN | SPI | UARTSets the serial bus decode mode.

Queries the error frame count for the selected bus channel.

integer - Returns the error frame count.

Queries the current CAN counter utilization for the selected SBUS<n>.

real (%) - Returns the percent utilization.

Sets the CAN sample point, the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The sample point represents the percentage of time between the beginning and end of the bit time.

NameTypeValuesDescription
valuereal60 - 87.5CAN sample point setting in NR3 format.

Sets the standard CAN signal baud rate. Rates from 10 kb/s to 4 Mb/s are accepted in 100 b/s increments, and 5 Mb/s is also allowed; values not divisible by 100 b/s are rounded to the nearest valid baud rate.

NameTypeValuesDescription
baudrateinteger10000 - 5000000Standard CAN baud rate to set.
integer (b/s) - Returns the current CAN baud rate setting.

Sets the CAN signal type used when :SBUS<n>:CAN:TRIGger is set to SOF (start of frame). The query returns the current CAN signal type.

NameTypeValuesDescription
valueenumCANH | CANL | RX | TX | DIFFerential | DIFL | DIFHCAN signal type to use.
enum - Current CAN signal type.

Sets the source for the CAN signal. On 2-channel DSOX1200-Series oscilloscopes only, EXTernal can be specified as the source.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the CAN signal.
enum - Returns the current source for the CAN signal.

Sets the CAN trigger condition for :SBUS<n>. The command accepts one of several trigger conditions such as SOF, DATA, error types, ID-based conditions, or ACK error.

NameTypeValuesDescription
conditionenumSOF | DATA | ERRor | IDData | IDEither | IDRemote | ALLerrors | OVERload | ACKerrorCAN trigger condition to use.

Defines the CAN data pattern resource from a string parameter. The pattern works with the data length set by :SBUS<n>:CAN:TRIGger:PATTern:DATA:LENGth and may be specified as binary or hexadecimal with X and $ don't-care characters.

NameTypeValuesDescription
stringstring-Binary pattern string "nn...n" using 0, 1, X, or $; or hexadecimal pattern string "0xnn...n" using hexadecimal digits plus X and $.
string - Returns the current settings of the specified CAN data pattern resource in binary string format.

Sets the number of 8-bit bytes in the CAN data string. The value can be from 1 to 8 bytes and is set by the :SBUS<n>:CAN:TRIGger:PATTern:DATA command.

NameTypeValuesDescription
lengthinteger1 - 8Number of 8-bit bytes in the CAN data string.
integer - Returns the current CAN data pattern length setting.

Defines the CAN identifier pattern resource from a string parameter. If the string starts with "0x", it is interpreted as hexadecimal; otherwise it is interpreted as a binary string using 0, 1, and X don't-care characters.

NameTypeValuesDescription
stringstring-CAN identifier pattern string, either binary (0, 1, X) or hexadecimal prefixed with 0x.
string - Returns the current CAN identifier pattern resource in 29-bit binary string format.

Sets the CAN identifier mode for CAN trigger pattern ID matching. Standard selects the 11-bit identifier and Extended selects the 29-bit identifier; the identifier itself is set by :SBUS<n>:CAN:TRIGger:PATTern:ID.

NameTypeValuesDescription
valueenumSTANdard | EXTendedSelects the CAN identifier mode.
enum - Returns the current setting of the CAN identifier mode.

Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus. The query returns the current IIC address width setting.

NameTypeValuesDescription
sizeenumBIT7 | BIT8Sets the IIC address width setting.
enum - Returns the current IIC address width setting.

Sets the source for the IIC serial clock (SCL). EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the IIC serial clock.
enum - Returns the current source for the IIC serial clock.

Sets the source for IIC serial data (SDA). EXTernal is available only on 2-channel DSOX1200-Series oscilloscopes.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the source for IIC serial data (SDA).
enum - Returns the current source for IIC serial data.

Sets the address for IIC data. The address can be specified as an integer or as a hexadecimal string, and the don't care address can be used to ignore the address value.

NameTypeValuesDescription
valueinteger0x00 - 0x7FAddress value for IIC data.

Sets the IIC trigger pattern data value. The data can be entered as an integer or as a hexadecimal string from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF as a don't-care value to ignore the data.

NameTypeValuesDescription
valuenumeric0x00 - 0x0FFIIC data pattern value to set.

Sets IIC data 2 for the trigger pattern. The value can be specified as an integer or as a hex string from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF as a don't care pattern to ignore the data value.

NameTypeValuesDescription
valueinteger0x00 - 0x0FFIIC data 2 value to set.

Sets the IIC data qualifier when TRIGger:IIC:TRIGger[:TYPE] is set to READEprom. The query returns the current IIC data qualifier value.

NameTypeValuesDescription
valueenumEQUal | NOTequal | LESSthan | GREaterthanIIC data qualifier to set.
enum - Current IIC data qualifier value.

Sets the IIC trigger type. The query returns the current IIC trigger type value.

NameTypeValuesDescription
valueenumSTARt | STOP | READ7 | READEprom | WRITe7 | WRITe10 | NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTartIIC trigger type to set.
enum - Current IIC trigger type value.

Determines whether the parity bits are included as the most significant bits (MSB) in the display of the Frame Id field in the LIN decode bus.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFControls whether parity bits are included in the Frame Id display.

Sets the LIN sample point during the bit time, expressed as a percentage of the bit time. The sample point value is not limited by the baud rate.

NameTypeValuesDescription
valuereal60 - 87.5Sample point value in NR3 format; allowed values are 60, 62.5, 68, 70, 75, 80, or 87.5.

Sets the standard baud rate of the LIN signal. Values are rounded to the nearest 100 b/s increment if necessary.

NameTypeValuesDescription
baudrateinteger2400 - 625000Baud rate to set for the LIN signal.
integer (b/s) - Returns the current LIN baud rate setting.

Sets the source for the LIN signal. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the LIN signal.

Sets the LIN standard in effect for triggering and decoding. The standard can be set to LIN1.3 or LIN2.0.

NameTypeValuesDescription
stdenumLIN13 | LIN20LIN standard to use.
enum - Returns the current LIN standard setting.

Sets the length of the LIN sync break to be greater than or equal to 11, 12, or 13 clock lengths. The sync break is the idle period at the beginning of each packet that distinguishes one information packet from the previous one.

NameTypeValuesDescription
valueinteger11 - 13Sets the LIN sync break length in clock lengths.

Sets the LIN trigger condition. Use SYNCbreak for Sync Break, ID for Frame ID, or DATA for Frame ID and Data.

NameTypeValuesDescription
conditionenumSYNCbreak | ID | DATALIN trigger condition to set.
enum - Returns the current LIN trigger value as SYNC, ID, or DATA.

Defines the LIN identifier searched for in each CAN message when the LIN trigger mode is set to frame ID. Setting the ID to -1 results in 0xXX, equivalent to all IDs.

NameTypeValuesDescription
valueinteger0 - 63LIN identifier to search for; may also be entered as a nondecimal or string representation.
integer - Returns the current LIN identifier setting.

Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is entered as a string whose accepted format depends on :SBUS<n>:LIN:TRIGger:PATTern:FORMat; the query returns the currently specified pattern.

NameTypeValuesDescription
stringstring-LIN trigger data pattern string.
string - The currently specified LIN trigger data pattern.

Sets the number of 8-bit bytes in the LIN data string. The value can be from 1 to 8 bytes and is used by :SBUS<n>:LIN:TRIGger:PATTern:DATA.

NameTypeValuesDescription
lengthinteger1 - 8Number of 8-bit bytes in the LIN data string.
integer - Returns the current LIN data pattern length setting.

Sets the entry number base used by the :SBUS<n>:LIN:TRIGger:PATTern:DATA command, and the query returns the currently set number base for LIN pattern data. The default base is BINary.

NameTypeValuesDescription
baseenumBINary | HEX | DECimalSets the number base for LIN pattern data.
enum - Returns the currently set number base for LIN pattern data.

Selects the SPI decode bit order used when displaying data in the serial decode waveform and in the Lister.

NameTypeValuesDescription
orderenumLSBFirst | MSBFirstSets the bit order to least-significant-bit first or most-significant-bit first.
enum - Returns the current SPI decode bit order.

Sets the SPI clock source slope used to clock in data. The query returns the current SPI clock source slope.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSpecifies the rising edge (POSitive) or falling edge (NEGative) of the SPI clock source.
enum - Returns the current SPI clock source slope.

Sets the SPI signal clock timeout resource in seconds when :SBUS<n>:SPI:FRAMing is set to TIMeout. The timer frames a signal by a clock timeout.

NameTypeValuesDescription
time_valuereal100 ns - 10 sTime in seconds in NR3 format.
real (s) - Returns the current SPI clock timeout setting.

Sets the SPI trigger framing value for :SBUS<n>. If TIMeout is selected, the timeout value is set by :SBUS<n>:SPI:CLOCk:TIMeout; NOTC is deprecated and the same as NCHipselect.

NameTypeValuesDescription
valueenumCHIPselect | NCHipselect | NOTC | TIMeoutSPI framing value to set.

Sets the source for the SPI serial clock. On 2-channel DSOX1200-Series oscilloscopes only, EXTernal can be specified as the source.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the SPI serial clock.
enum - Returns the current source for the SPI serial clock.

Sets the source for the SPI serial data. On 2-channel DSOX1200-Series oscilloscopes that support 3-wire SPI, EXTernal may be specified as the source.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the SPI serial data source.

Sets the frame source for the SPI serial frame when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. EXTernal is available as the source on 2-channel DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the frame source.

Sets the source for the SPI serial MISO data on supported 4-channel oscilloscopes. The query returns the current source.

NameTypeValuesDescription
sourceenumCHANnel<n>Source channel for the SPI MISO data.
enum - Current source for the SPI serial MISO data.

Sets the source for the SPI serial MOSI data on 4-channel DSOX1200-Series oscilloscopes that support 4-wire SPI. The equivalent :SBUS<n>:SPI:SOURce:DATA command can also be used.

NameTypeValuesDescription
sourceenumCHANnel<n>Selects the source channel for MOSI data.
enum - Returns the current source for the SPI serial MOSI data.

Defines the SPI data pattern resource for 3-wire SPI trigger pattern search. The string parameter specifies the pattern in either binary or hexadecimal form, with X or $ treated as don't care characters.

NameTypeValuesDescription
stringstring-SPI data pattern string, either binary (0, 1, X, $) or hexadecimal when prefixed with 0x.
string - Returns the current settings of the specified SPI data pattern resource in binary string format.

Defines the SPI MISO data pattern resource for 4-wire SPI trigger pattern matching. The string may be entered as a binary pattern of 0, 1, and X, or as a hexadecimal string prefixed with "0x" using hexadecimal digits and X.

NameTypeValuesDescription
stringstring-Pattern string for the SPI MISO data resource.
string - Returns the current settings of the specified SPI MISO data pattern resource in binary string format.

Sets the width of the SPI MISO data pattern on 4-channel DSOX1200-Series oscilloscopes that support 4-wire SPI. The command should be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.

NameTypeValuesDescription
widthinteger4 - 64Width of the SPI MISO data pattern, in bits.
integer - Returns the current SPI MISO data pattern width setting.

Defines the SPI MOSI data pattern resource for the specified bus according to the string parameter. The pattern is used with the data width to control what is searched in the data stream; if the string starts with "0x" it is interpreted as hexadecimal, otherwise as binary.

NameTypeValuesDescription
stringstring-Binary or hexadecimal pattern string using 0, 1, X, and $ characters; a leading "0x" selects hexadecimal format.
string - Returns the current settings of the specified SPI MOSI data pattern resource in binary string format.

Sets the width of the SPI MOSI data pattern on supported 4-channel DSOX1200-Series oscilloscopes. The width can be set from 4 to 64 bits and should be configured before :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA.

NameTypeValuesDescription
widthinteger4 - 64SPI MOSI data pattern width in bits.
integer - Returns the current SPI MOSI data pattern width setting.

Sets the width of the SPI data pattern for 3-wire SPI on supported 2-channel DSOX1200-Series oscilloscopes. The width should be set before :SBUS<n>:SPI:TRIGger:PATTern:DATA.

NameTypeValuesDescription
widthinteger4 - 64SPI data pattern width in bits.
integer - Returns the current SPI data pattern width setting.

Specifies whether the SPI trigger is on MOSI data or MISO data. The query returns the current SPI trigger type setting.

NameTypeValuesDescription
valueenumMOSI | MISOSelects which SPI data line is used for triggering.
enum - Current SPI trigger type setting.

Sets the number of bits in a word of SPI data. The query returns the current SPI decode word width.

NameTypeValuesDescription
word_widthinteger4 - 16Number of bits in the SPI data word.
integer - Current SPI decode word width.

Determines the base used for UART decode and Lister display. The query returns the current UART decode and Lister base setting.

NameTypeValuesDescription
baseenumASCii | BINary | HEXSets the UART decode and Lister display base.
enum - Current UART decode and Lister base setting.

Sets the UART baud rate used by the serial decoder and/or trigger when :SBUS<n> is in UART mode. The baud rate may be set from 100 b/s to 8 Mb/s.

NameTypeValuesDescription
baudrateinteger100 - 8000000Bit rate for the UART serial decoder and/or trigger.
integer (bps) - Returns the current UART baud rate setting.

Sets the bit order used by the physical Tx and Rx input signals for the serial decoder and/or trigger when in UART mode. LSBFirst transmits the least significant bit first; MSBFirst transmits the most significant bit first.

NameTypeValuesDescription
bitorderenumLSBFirst | MSBFirstBit order used for UART transmission.

Sets the byte value used for framing (end of packet) in UART decode, or turns framing off. The query returns the current UART decode base setting.

NameTypeValuesDescription
valueenumOFF | <decimal> | <nondecimal>Framing byte value or OFF.
enum - Returns the current UART decode base setting as OFF or a decimal value.

Selects the parity used with each message byte for the serial decoder and/or trigger when in UART mode.

NameTypeValuesDescription
parityenumEVEN | ODD | NONEParity to use in UART mode.

Selects the UART polarity as idle low or idle high for the serial decoder and/or trigger when in UART mode.

NameTypeValuesDescription
polarityenumHIGH | LOWSets the UART polarity.

Controls which signal is used as the Rx source by the serial decoder and/or trigger when in UART mode. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the UART Rx source.
enum - Returns the current source for the UART Rx signal.

Controls which signal is used as the UART Tx source for the serial decoder and/or trigger in UART mode. EXTernal can be specified as the source on 2-channel DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the source signal for UART Tx.
enum - Returns the current source for the UART Tx signal.

Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects front panel data selection from ASCII values; HEX selects hexadecimal values. The setting does not affect :SBUS<n>:UART:TRIGger:DATA and is independent of :SBUS<n>:UART:BASE.

NameTypeValuesDescription
baseenumASCii | HEXFront panel UART/RS232 trigger data selection base.
:SBUS<n>:UART:TRIGger:BASE <base>
:SBUS<n>:UART:TRIGger:BASE?

Selects the UART trigger burst value for the nth frame after an idle period. The value may be OFF or an integer from 1 to 4096.

NameTypeValuesDescription
valueinteger1 - 4096Burst value (Nth frame after idle period) used for the UART trigger.

Selects the UART trigger data byte value used for RD or TD trigger types in UART mode. The value can be entered as a decimal, hexadecimal, binary, or quoted ASCII character representation.

NameTypeValuesDescription
valueinteger0 - 2558-bit UART trigger data byte value.

Selects the idle period value for burst trigger in UART mode. The query returns the current UART trigger idle period time.

NameTypeValuesDescription
time_valuereal1 us - 10 sIdle period time for burst trigger in UART mode.
real (s) - Current UART trigger idle period time.

Selects the UART trigger data qualifier when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX.

NameTypeValuesDescription
valueenumEQUal | NOTequal | GREaterthan | LESSthanSets the UART trigger qualifier.

Selects the UART trigger type for :SBUS<n>. When one of the RD or TD types is selected, :SBUS<n>:UART:TRIGger:DATA and :SBUS<n>:UART:TRIGger:QUALifier are used to specify the data value and comparison operator.

NameTypeValuesDescription
valueenumRSTArt | RSTOp | RDATa | RD1 | RD0 | RDX | PARityerror | TSTArt | TSTOp | TDATa | TD1 | TD0 | TDXSelects the UART trigger type.

Sets the number of bits for each message byte used by the serial decoder and/or trigger when in UART mode. The query returns the current UART width setting.

NameTypeValuesDescription
widthinteger5 - 9Number of bits per message byte in UART mode.
integer - Current UART width setting.

:SYSTem:DATEset / query

Sets the instrument date. Validity checking is performed to ensure that the date is valid.

NameTypeValuesDescription
datestring-Date value in <year>,<month>,<day> form.

Returns the oscilloscope's Host ID as part of a quoted ASCII string. The exact contents and format are product-specific and should not be parsed by portable programs.

string - The oscilloscope's Host ID returned as a quoted ASCII string; exact format is product-specific.
:SYSTem:DIDentifier?
:SYSTem:DSPset / query

Writes a quoted ASCII string to a text box in the center of the display. Use :SYSTem:DSP "" to remotely remove the message from the display.

NameTypeValuesDescription
stringstring-Quoted ASCII string to display, up to 75 characters.
:SYSTem:DSP <string>
:SYSTem:ERRorset / query

Outputs the next error number and text from the error queue. Repeatedly querying returns errors in order until the queue is empty, after which further queries return zero until another error occurs.

string - Returns <error number>,<error string><NL>, where the error number is an integer error code in NR1 format and the error string is a quoted ASCII message.
:SYSTem:LOCKset / query

Disables or enables the front panel lock. LOCK ON is equivalent to sending a local lockout message over the programming interface.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFSets the front panel lock state.
:SYSTem:MENUset / query

Changes the front panel softkey menu.

NameTypeValuesDescription
menuenumMASK | MEASure | SEGMented | LISTerSelects which front panel softkey menu is displayed.

Sets the manufacturer string portion of the identification string returned by *IDN?. The string is quoted ASCII and can be up to 63 characters; the query returns the currently set manufacturer string.

NameTypeValuesDescription
manufacturer_stringstring-Quoted ASCII manufacturer string to store.
string - Returns the currently set manufacturer string.
:SYSTem:PRESetset / query

Places the instrument in a known state, equivalent to the front-panel Default Setup action. Some user settings remain unchanged; use *RST to reset all user settings to factory defaults.

Disables the fifty ohm impedance setting for all analog channels. The query returns the analog channel protection lock status.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFSets the protection lock state.
:SYSTem:RLOGgerset / query

Enables or disables remote command logging, optionally specifying the log file name and write mode.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONEnables or disables remote command logging.
file_nameoptstring-Quoted ASCII string specifying the log file name.
write_modeoptenumCREate | APPendSpecifies the log file write mode.

Specifies whether remote commands are logged to a text file, to the screen, or both. If the destination is changed while remote command logging is running, logging is turned off.

NameTypeValuesDescription
destenumFILE | SCReen | BOTHSelects the remote command logging destination.

Enables or disables the screen display of logged remote commands and their return values. The query returns whether remote command logging display is enabled or disabled.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables the screen display of logged remote commands.
enum - Returns whether the screen display for remote command logging is enabled or disabled.

Specifies the remote command log file name. The ".txt" extension is added automatically to the name specified.

NameTypeValuesDescription
file_namestring-Quoted ASCII string specifying the file name.
string - Returns the remote command log file name.

Enables or disables remote command logging. The query returns the remote command logging state.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the remote command logging state.
enum - Returns the remote command logging state as 0 or 1.

Specifies whether the screen display background for remote command logging is transparent or solid.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONSets the transparent screen display background setting.

Specifies the remote command logging write mode. The query returns the current remote command logging write mode.

NameTypeValuesDescription
write_modeenumCREate | APPendSelects the remote command logging write mode.
enum - Returns the remote command logging write mode.
:SYSTem:SETupset / query

Sets the oscilloscope according to a setup (learn) string sent from the controller. The command does not change the interface mode or interface address.

NameTypeValuesDescription
setup_datablock-Binary block data in IEEE 488.2 # format.
:SYSTem:SETup <setup_data>
myScope.WriteIEEEBlock ":SYSTEM:SETUP ", varSetupString
:SYSTem:TIMEset / query

Sets the system time using a 24-hour format. Commas are used as separators, and validity checking is performed to ensure the time is valid.

NameTypeValuesDescription
timeinteger-hours,minutes,seconds in NR1 format
:SYSTem:TZONeset / query

Sets the system time zone based on the specified offset from UTC, keeping local time constant while moving UTC. Supported offsets are listed in the manual and the query returns the current time zone offset setting.

NameTypeValuesDescription
UTC_offsetinteger-1200 - 1200Integer offset from UTC in HHMM form, such as 1000 for UTC+1000 or -230 for UTC-0230.
integer - Returns the time zone offset setting in HHMM form.

Ejects connected USB storage devices. When ALL is given, it dismounts/ejects all connected USB storage devices.

NameTypeValuesDescription
modeenumALLEject all connected USB storage devices.
usb_pathstring-Path of the USB storage device to eject.

Returns the root path for all connected USB storage devices, delimited by a newline character. The returned string is up to 256 ASCII characters.

string - Root path for all connected USB storage devices, delimited by a newline character.

:TIMebase:MODEset / query

Sets the current time base mode. The mode can be MAIN, WINDow, XY, or ROLL; MAIN is the default after *RST.

NameTypeValuesDescription
valueenumMAIN | WINDow | XY | ROLLSelects the current time base mode.
enum - Returns the current time base mode.
myScope.WriteString ":TIMEBASE:MODE MAIN"

Sets the time interval between the trigger event and the display reference point on the screen. The display reference point is set with :TIMebase:REFerence, and the maximum position value depends on the time/division setting. This command is an alias for :TIMebase:DELay.

NameTypeValuesDescription
posrealsTime in seconds from the trigger to the display reference, in NR3 format.
real (s) - Returns the current time from the trigger to the display reference in seconds.
:TIMebase:RANGeset / query

Sets the full-scale horizontal time for the main window in seconds. The range is 10 times the current time-per-division setting.

NameTypeValuesDescription
range_valuerealsTime for 10 divisions in seconds, in NR3 format.
myScope.WriteString ":TIM:RANG 2e-3" ' Set the time range to 0.002 seconds.

Sets the time reference to one division from the left side of the screen, the center of the screen, or one division from the right side of the screen. The time reference is the point on the display where the trigger point is referenced.

NameTypeValuesDescription
referenceenumLEFT | CENTer | RIGHtSelects the time reference position on the display.
:TIMebase:REFerence CENTer
:TIMebase:SCALeset / query

Sets the horizontal scale, or units per division, for the main window. The query returns the current horizontal scale setting in seconds per division.

NameTypeValuesDescription
scale_valuerealsTime per division in seconds, in NR3 format.
real (s) - The current horizontal scale setting in seconds per division for the main window.

Specifies whether the time base control's vernier (fine horizontal adjustment) setting is ON (1) or OFF (0).

NameTypeValuesDescription
vernier valueenum1 | ON | 0 | OFFSets the vernier setting to ON/1 or OFF/0.

Sets the horizontal position in the zoomed (delayed) view of the main sweep. The value is the time from the trigger event to the zoomed view reference point and must keep the window within the main sweep range.

NameTypeValuesDescription
pos valuerealsTime from the trigger event to the zoomed (delayed) view reference point in NR3 format.

Sets the full-scale horizontal time in seconds for the zoomed (delayed) window. The main sweep range determines the range for this command, and the maximum value is one half of the :TIMebase:RANGe value.

NameTypeValuesDescription
range valuereal0.5*:TIMebase:RANGeRange value in seconds in NR3 format.

Sets the zoomed (delayed) window horizontal scale in seconds per division. The main sweep scale determines the range for this command, and the maximum value is one half of the :TIMebase:SCALe value.

NameTypeValuesDescription
scale_valuerealsScale value in seconds in NR3 format.
:TIMebase:WINDow:SCALe <scale_value>
:TIMebase:WINDow:SCALe?
:TIMebase:DELayset / query

Sets the main time base delay, the time between the trigger event and the delay reference point on the screen. This command is obsolete and provided for backward compatibility; use :TIMebase:POSition instead.

NameTypeValuesDescription
delay_valuerealsTime in seconds from trigger to the delay reference point on the screen.
real (s) - Returns the current delay value in seconds, in NR3 format.
myScope.WriteString ":TIMEBASE:DELAY 0.0"

:TRIGger:FORCeset / query

Causes an acquisition to be captured even though the trigger condition has not been met. It is equivalent to pressing the front panel Force Trigger key.

Turns the high frequency reject filter off and on. The filter adds a 50 kHz low-pass filter in the trigger path to remove high-frequency noise from the trigger waveform.

NameTypeValuesDescription
valueenum0 | OFF | 1 | ONSets the high frequency reject filter mode.
:TRIGger:HOLDoffset / query

Defines the trigger holdoff time value. Holdoff prevents triggering again until a specified time has elapsed since the last trigger.

NameTypeValuesDescription
holdoff_timereal60 ns - 10 sHoldoff time value in seconds, expressed in NR3 format.

Automatically sets the trigger levels of all displayed analog channels to their waveforms' 50% values. If AC coupling is used, the trigger levels are set to 0 V; when high and low dual trigger levels are used, the command has no effect.

Sets the high trigger voltage level for the specified source. The query returns the high trigger voltage level for the specified source.

NameTypeValuesDescription
levelreal0.75 x full-scale voltage from center screen - 0.75 x full-scale voltage from center screenHigh trigger voltage level, in NR3 format, for internal triggers.
sourceenumCHANnel<n> | EXTernalTrigger source to which the level applies.
real - High trigger voltage level for the specified source.

Sets the low trigger voltage level for the specified source. The query returns the low trigger voltage level for that source.

NameTypeValuesDescription
levelreal0.75 x full-scale voltage from center screen - 0.75 x full-scale voltage from center screenLow trigger voltage level in NR3 format for internal triggers.
sourceenumCHANnel<n> | EXTernalTrigger source.
real - Low trigger voltage level for the specified source.
:TRIGger:MODEset / query

Selects the trigger mode (trigger type). PATTern, SHOLd, and TRANsition modes are available on the DSOX1200-Series oscilloscopes only.

NameTypeValuesDescription
modeenumEDGE | GLITch | PATTern | SHOLd | TRANsition | TV | SBUS1Trigger mode to select.
myScope.WriteString ":TRIGger:MODE EDGE"
:TRIGger:NREJectset / query

Turns the noise reject filter off and on. When the filter is on, the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger; the command is not valid in TV trigger mode.

NameTypeValuesDescription
valueenum0 | OFF | 1 | ONSets the noise reject filter mode.
:TRIGger:SWEepset / query

Selects the trigger sweep mode. AUTO displays a baseline in the absence of a signal, while NORMal stops sweeping when no trigger is present.

NameTypeValuesDescription
sweepenumAUTO | NORMalTrigger sweep mode to select.

Sets the input coupling for the selected trigger sources. The coupling can be AC, DC, or LFReject; the setting is coupled with :TRIGger[:EDGE]:REJect.

NameTypeValuesDescription
couplingenumAC | DC | LFRejectInput coupling selection for the trigger path.

Sets the trigger level voltage for the active trigger source. If an optional source is specified and is not the active source, only that source’s level is changed and the active source is not changed.

NameTypeValuesDescription
levelreal0.75 x full-scale voltage from center screen - ±(external range setting)Trigger level voltage. Use the internal-trigger range for internal triggers or the external-trigger range for external triggers.
sourceoptenumCHANnel<n> | EXTernalOptional source whose trigger level is set.
real - Returns the trigger level of the current trigger source.

Turns the low-frequency or high-frequency reject filter on or off. Only one reject filter can be on at a time, and the reject and coupling settings are coupled.

NameTypeValuesDescription
rejectenumOFF | LFReject | HFRejectSelects the reject filter state.
:TRIGger[:EDGE]:REJect <reject>
:TRIGger[:EDGE]:REJect?

Specifies the slope of the edge used for the trigger. It is not valid in TV trigger mode; use :TRIGger:TV:POLarity instead.

NameTypeValuesDescription
slopeenumNEGative | POSitive | EITHer | ALTernateSets the trigger edge slope.
enum - Returns the current trigger slope.
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"

Selects the input that produces the trigger. The query returns the current source, or "NONE" if all channels are off.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | LINE | WGENInput source used to produce the trigger.
enum - Current trigger source.
myScope.WriteString ":TRIGger[:EDGE]:SOURce CHANnel1"

Sets the minimum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns that minimum pulse width duration time.

NameTypeValuesDescription
greater_than_timereal-Minimum pulse width duration.
real - The minimum pulse width duration time for :TRIGger:GLITch:SOURce.

Sets the maximum pulse width duration for the selected :TRIGger:GLITch:SOURce. The query returns the pulse width duration time for :TRIGger:GLITch:SOURce.

NameTypeValuesDescription
less_than_timereal-Maximum pulse width duration.
real - Pulse width duration time for :TRIGger:GLITch:SOURce.

Sets the trigger level voltage for the active pulse width trigger. The query returns the trigger level of the current pulse width trigger mode, or "NONE" if all channels are off.

NameTypeValuesDescription
levelrealVTrigger level voltage for internal triggers, or ±(external range setting) for external triggers.
sourceoptenumCHANnel<n> | EXTernalSelects the source channel or external input for the trigger level.
string - Returns the trigger level of the current pulse width trigger mode; returns "NONE" if all channels are off.

Sets the polarity for the glitch pulse width trigger.

NameTypeValuesDescription
polarityenumPOSitive | NEGativeSets the glitch pulse width trigger polarity.

Sets the mode of operation of the glitch pulse width trigger. The oscilloscope can trigger on a pulse width that is greater than a time value, less than a time value, or within a range of time values.

NameTypeValuesDescription
operatorenumGREaterthan | LESSthan | RANGeSelects whether the trigger qualifies on greater than, less than, or range of pulse width.
enum - Returns the glitch pulse width qualifier.

Sets the pulse width duration for the selected :TRIGger:GLITch:SOURce. The two time values may be entered in any order; the smaller value becomes <greater_than_time> and the larger becomes <less_than_time>.

NameTypeValuesDescription
less_than_timereal15 ns - 10 secondsUpper pulse-width duration limit.
greater_than_timereal10 ns - 9.99 secondsLower pulse-width duration limit.
real - Returns the pulse width duration time for :TRIGger:GLITch:SOURce as <less_than_time>,<greater_than_time>.

Selects the channel that produces the pulse width trigger. The query returns the current pulse width source; if all channels are off, it returns "NONE".

NameTypeValuesDescription
sourceenumDIGital<d> | CHANnel<n>Channel that produces the pulse width trigger.
:TRIGger:PATTernset / query

Specifies the channel values used in the pattern trigger. The optional edge source and edge parameters may be sent together with the pattern string, and they take precedence over the ASCII string edge notation.

NameTypeValuesDescription
patternstring-Pattern string, with optional edge source and edge when using HEX format.

Sets the entry and query number base used by the :TRIGger:PATTern command. The default base is ASCii.

NameTypeValuesDescription
baseenumASCii | HEXNumber base used for pattern trigger patterns.

Qualifies when the trigger occurs. On InfiniiVision 1200 X-Series and EDUX11052A/G oscilloscopes, the trigger always occurs when the pattern is entered.

NameTypeValuesDescription
qualifierenumENTeredSpecifies the trigger duration qualifier.
enum - Returns the trigger duration qualifier.

Specifies whether the rising edge or the falling edge of the clock signal is used.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the edge polarity used for trigger hold slope.

Selects the input channel used to probe the clock signal. The query returns the currently set clock signal source.

NameTypeValuesDescription
sourceenumCHANnel<n>Input channel probing the clock signal.
enum - Currently set clock signal source.

Selects the input channel used to probe the data signal. The query returns the currently set data signal source.

NameTypeValuesDescription
sourceenumCHANnel<n>Input channel to use as the data signal source.
enum - Currently set data signal source.

Sets the hold time for the trigger hold-time function. The query returns the currently specified hold time.

NameTypeValuesDescription
timereal-Hold time value in NR3 floating-point format.
real - The currently specified hold time.

Sets the setup time. The query returns the currently specified setup time.

NameTypeValuesDescription
timereal-Setup time value in NR3 floating-point format.
suffixoptenums | ms | us | ns | psOptional time suffix.
real - The currently specified setup time.

Specifies whether the rise/fall time trigger uses a greater-than or less-than qualifier. The time value is set with :TRIGger:TRANsition:TIME.

NameTypeValuesDescription
qualifierenumGREaterthan | LESSthanSelects whether the trigger looks for times greater than or less than the specified time value.
enum - Returns the current rise/fall time trigger qualifier setting.

Specifies a positive rising edge or a negative falling edge transition trigger slope. The query returns the current rise/fall time trigger slope setting.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the trigger slope polarity.
enum - Returns the current trigger slope setting as NEG or POS.

Selects the channel used to produce the trigger. The query returns the current transition trigger source.

NameTypeValuesDescription
sourceenumCHANnel<n>Channel to use as the trigger source.
enum - Current transition trigger source.

Sets the time value for rise/fall time triggers. Use :TRIGger:TRANsition:QUALifier to specify whether the trigger condition is greater than or less than this value.

NameTypeValuesDescription
timerealsFloating-point time value in NR3 format.
real - Returns the current rise/fall time trigger time value.
:TRIGger:TV:LINEset / query

Sets the video trigger to occur on a specific line of video. The valid line number range depends on the TV standard and mode.

NameTypeValuesDescription
line_numberinteger1 - 625Line number to trigger on, expressed as an integer in NR1 format.
:TRIGger:TV:LINE <line_number>
:TRIGger:TV:LINE?
:TRIGger:TV:MODEset / query

Selects the TV trigger mode and field. The query returns the current TV trigger mode.

NameTypeValuesDescription
modeenumFIEld1 | FIEld2 | AFIelds | ALINes | LFIeld1 | LFIeld2 | LALTernateTV trigger mode and field to select.
enum - Returns the current TV trigger mode.

Sets the polarity for the TV trigger. The query returns the TV trigger polarity.

NameTypeValuesDescription
polarityenumPOSitive | NEGativeSelects the TV trigger polarity.
enum - The TV trigger polarity.

Selects the channel used to produce the TV trigger. The query returns the current TV trigger source.

NameTypeValuesDescription
sourcechannel_list-Channel used to produce the trigger.
channel_list - The current TV trigger source.

Selects the video standard used for TV trigger operation. The query returns the current TV trigger standard setting.

NameTypeValuesDescription
standardenumNTSC | PALM | PAL | SECamVideo standard to select.
enum - Current TV trigger standard setting.

Selects the TV trigger mode and field. This obsolete command is provided for compatibility with previous oscilloscopes; use :TRIGger:TV:MODE instead.

NameTypeValuesDescription
modeenumFIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERticalSets the TV trigger mode and field.
enum - Returns the TV trigger mode.

Sets the output byte order for WORD waveform data. The setting affects transmission only when :WAVeform:FORMat WORD is selected; default is MSBFirst.

NameTypeValuesDescription
valueenumLSBFirst | MSBFirstSelects whether the least significant or most significant byte is transmitted first.
enum - Returns the current output sequence.
:WAVeform:COUNtset / query

Returns the count used to acquire the current waveform. For all acquisition types except average, the value is 1.

integer - The count used to acquire the current waveform.
:WAVeform:DATAset / query

Returns the sampled waveform data as an IEEE 488.2 arbitrary binary block. The data format depends on :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce, and the number of points is controlled by :WAVeform:POINts.

block - Binary block of sampled data points transmitted in IEEE 488.2 arbitrary block data format.
:WAV:DATA?
:WAVeform:FORMatset / query

Sets the waveform data transmission format. The query returns the current output format for waveform data transfer.

NameTypeValuesDescription
valueenumWORD | BYTE | ASCiiSelects how waveform data points are formatted for transfer.
enum - Returns the current output format for the transfer of waveform data.
:WAVeform:FORMat <value>
:WAVeform:FORMat?
:WAVeform:POINtsset / query

Sets the number of waveform points transferred with the :WAVeform:DATA? query. The allowed values depend on the waveform points mode; the <points mode> option is deprecated in favor of :WAVeform:POINts:MODE.

NameTypeValuesDescription
pointsinteger100 - 2000000Number of waveform points to transfer; allowed values depend on waveform points mode and may also be one of the deprecated points-mode keywords.
modeoptenumNORMal | MAXimum | RAWDeprecated points-mode keyword accepted in place of a numeric point count.
:WAVeform:POINts 1000

Sets the waveform data record transfer mode used by the :WAVeform:DATA? query. NORMal selects the measurement record, RAW selects the raw acquisition record, and MAXimum selects whichever record contains the most points.

NameTypeValuesDescription
points_modeenumNORMal | MAXimum | RAWSelects which data record is transferred.

Requests the preamble information for the selected waveform source. The preamble contains the vertical and horizontal scaling information for the corresponding channel data.

block - A preamble block containing format, type, points, count, X increment, X origin, X reference, Y increment, Y origin, and Y reference values.
myScope.WriteString ":WAVEFORM:PREAMBLE?" ' Query for the preamble.

Returns the number of memory segments in the acquired data. It can be used while segments are still being acquired.

integer - Number of memory segments in the acquired data, set by :ACQuire:SEGMented:COUNt.

Returns the time tag of the currently selected segmented memory index. The selected index is set with :ACQuire:SEGMented:INDex.

real - Time tag of the currently selected segmented memory index, returned in NR3 format.
:WAVeform:SOURceset / query

Selects the analog channel, function, or reference waveform to be used as the source for the :WAVeform commands. EXT is available on 2-channel oscilloscopes only.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | FFT | WMEMory<r> | SBUS1 | ABUS | EXTSource used by the waveform commands.
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"

Selects which serial decode waveform subsource is used when :WAVeform:SOURce is an SBUS<n> source. SUB0 is the default; TX/MISO are aliases for SUB1, and RX/MOSI are aliases for SUB0.

NameTypeValuesDescription
subsourceenumSUB0 | RX | MOSI | SUB1 | TX | MISOChooses the waveform subsource to display or decode.
:WAVeform:TYPEset / query

Returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by the :ACQuire:TYPE command.

enum - Returns the acquisition mode for the currently selected waveform.

Turns unsigned mode on or off for the currently selected waveform. It controls whether data values are sent as unsigned or signed integers and has no effect if the data format is ASCII.

NameTypeValuesDescription
unsignedenum0 | OFF | 1 | ONEnables or disables unsigned mode.
:WAVeform:VIEWset / query

Sets the view setting associated with the currently selected waveform. The only legal value is MAIN.

NameTypeValuesDescription
viewenumMAINView setting for the currently selected waveform.

Returns the x-increment value for the currently specified source. This value is the time difference between consecutive data points in seconds.

real (s) - x-increment in the current preamble in 64-bit floating point NR3 format

Returns the x-origin value for the currently specified source. In this product, it is the X-axis value of the first data point (XREFerence = 0).

real - x-origin value in the current preamble, returned in 64-bit floating point NR3 format.

Returns the x-reference value for the currently specified source. In this product, the x-reference point is the first point displayed and XREFerence is always 0.

real - x-reference value = 0 in 32-bit NR1 format

Returns the y-increment value in volts for the currently specified source. This is the voltage difference between consecutive data values.

real (V) - The y-increment value in the current preamble, returned as a 32-bit floating point NR3 value.

Returns the y-origin value for the currently specified source. This is the Y-axis value of the data value specified by :WAVeform:YREFerence; for this product, it is the Y-axis value of the center of the screen.

real - y-origin in the current preamble in 32-bit floating point NR3 format

Returns the y-reference value for the currently specified source. This value specifies the data point value where the y-origin occurs; it is undefined if the format is ASCii.

numeric - y-reference value in the current preamble in 32-bit NR1 format

:WGEN:FREQuencyset / query

Sets the waveform generator frequency in Hz. For all waveforms except Noise and DC, the frequency can also be specified indirectly using :WGEN:PERiod.

NameTypeValuesDescription
frequencyrealHzFrequency of the waveform in NR3 format.
:WGEN:FUNCtionset / query

Selects the waveform type for the waveform generator. The query returns the currently selected signal type.

NameTypeValuesDescription
signalenumSINusoid | SQUare | RAMP | PULSe | NOISe | DCSets the waveform type.
enum - Returns the currently selected signal type.

Specifies the pulse width for Pulse waveforms. The width can be adjusted from 20 ns to the period minus 20 ns.

NameTypeValuesDescription
widthreal20 ns - period minus 20 nsPulse width in seconds, in NR3 format.
real (s) - Returns the currently set pulse width, in NR3 format.

Sets the symmetry of the ramp waveform. The value is the amount of time per cycle that the ramp waveform is rising.

NameTypeValuesDescription
percentinteger0 - 100Symmetry percentage in NR1 format.

Sets the square wave duty cycle for the waveform generator. The duty cycle is adjustable from 1% to 99% in NR1 format, with the usable range narrowing at higher frequencies.

NameTypeValuesDescription
percentreal1% - 99%Duty cycle percentage to set for the square waveform.

Specifies the amount of amplitude modulation as a percentage of the amplitude range used by the modulation.

NameTypeValuesDescription
percentreal0% - 100%AM depth percentage in NR1 format.
real (%) - Returns the AM depth percentage setting.

Specifies the frequency of the modulating signal.

NameTypeValuesDescription
frequencyrealHzModulating waveform frequency in NR3 format.
real (Hz) - Returns the frequency of the modulating signal.

Sets the FM frequency deviation from the original carrier signal frequency. The deviation is limited by the original carrier frequency and by the maximum frequency of the selected waveform generator function plus 100 kHz.

NameTypeValuesDescription
frequencyrealHzFrequency deviation in Hz, in NR3 format.
real (Hz) - Returns the frequency deviation setting in Hz, in NR3 format.

Specifies the frequency of the modulating signal in Hz. The query returns the frequency of the modulating signal.

NameTypeValuesDescription
frequencyrealHzModulating waveform frequency in NR3 format.
real (Hz) - Frequency of the modulating signal in Hz, returned in NR3 format.

Specifies the hop frequency used for frequency-shift keying modulation. The output frequency shifts between the original carrier frequency and this hop frequency.

NameTypeValuesDescription
frequencyrealHzHop frequency in NR3 format.
real (Hz) - Returns the current hop frequency setting in Hz, in NR3 format.

Specifies the FSK modulation rate, i.e. the rate at which the output frequency shifts. The rate is given in Hz in NR3 format.

NameTypeValuesDescription
raterealHzFSK modulation rate in Hz in NR3 format.
real (Hz) - Returns the FSK rate setting in Hz in NR3 format.

Sets the shape of the modulating signal. This command applies to AM and FM modulation; the RAMP shape can be further controlled with :WGEN:MODulation:FUNCtion:RAMP:SYMMetry.

NameTypeValuesDescription
shapeenumSINusoid | SQUare | RAMPSpecifies the modulating signal shape.
enum - Returns the specified modulating signal shape.

Sets the ramp modulation symmetry percentage, which determines the amount of time per cycle that the ramp waveform is rising. The ramp modulating waveform shape is specified with :WGEN:MODulation:FUNCtion.

NameTypeValuesDescription
percentreal0% - 100%Symmetry percentage.
real (%) - Returns the ramp symmetry percentage setting.

Adds noise to the currently selected waveform generator signal. The noise percentage range is 0 to 100, but the effective range varies with the current amplitude limit.

NameTypeValuesDescription
percentreal0 - 100Percentage of added noise.

Enables or disables modulated waveform generator output. Modulation can be enabled for all waveform generator function types except pulse, DC, and noise.

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Enables or disables modulation.
enum - Returns whether the modulated waveform generator output is enabled or disabled.

Selects the modulation type for the waveform generator. The query returns the currently selected modulation type.

NameTypeValuesDescription
typeenumAM | FM | FSKModulation type to select.
enum - Selected modulation type.
:WGEN:OUTPutset / query

Specifies whether the waveform generator signal output is ON (1) or OFF (0).

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns the waveform generator output on or off.

Selects the expected output load impedance used for display of amplitude and offset levels. The Gen Out BNC output impedance itself is fixed at 50 ohms.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.

Specifies whether the waveform generator output is inverted.

NameTypeValuesDescription
polarityenumNORMal | INVertedSets the waveform generator output polarity.
:WGEN:PERiodset / query

Sets the waveform generator period for all waveforms except Noise and DC. The period can also be specified indirectly with :WGEN:FREQuency.

NameTypeValuesDescription
periodrealsPeriod of the waveform in NR3 format.
:WGEN:RSTset / query

Restores the waveform generator factory default settings (1 kHz sine wave, 500 mVpp, 0 V offset).

:WGEN:VOLTageset / query

Sets the waveform amplitude in volts for all waveforms except DC. Use :WGEN:VOLTage:OFFSet to specify the offset voltage or DC level, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to specify amplitude indirectly.

NameTypeValuesDescription
amplituderealVWaveform amplitude in volts, expressed in NR3 format.

Sets the waveform high-level voltage for all waveforms except DC. The high-level and low-level voltages can also be specified indirectly using :WGEN:VOLTage and :WGEN:VOLTage:OFFSet.

NameTypeValuesDescription
highrealVHigh-level voltage in volts, in NR3 format.

Specifies the waveform low-level voltage for all waveforms except DC. Use :WGEN:VOLTage:HIGH to specify the high-level voltage; the high and low levels may also be set indirectly with :WGEN:VOLTage and :WGEN:VOLTage:OFFSet.

NameTypeValuesDescription
lowrealVLow-level voltage in volts, in NR3 format.

Specifies the waveform offset voltage, also described as the DC level. The query returns the currently specified waveform offset voltage.

NameTypeValuesDescription
offsetrealVOffset voltage in NR3 format.
real (V) - The currently specified waveform offset voltage.

Clears the specified reference waveform location.

NameTypeValuesDescription
rinteger1 - 2Reference waveform location number in NR1 format.

Turns the display of the specified reference waveform on or off. Only one reference waveform can be displayed at a time; enabling one reference waveform automatically turns the other off.

NameTypeValuesDescription
rinteger1 - 2Reference waveform location number.
on_offenum1 | ON | 0 | OFFDisplay state to set for the selected reference waveform.

Sets the reference waveform label to the quoted ASCII string that follows. Label strings are limited to 10 characters; longer labels are truncated and lowercase characters are converted to uppercase.

NameTypeValuesDescription
rinteger1 - 2Reference waveform number in NR1 format.
stringstring-Quoted ASCII label string.
:WMEMory<r>:SAVEset / query

Copies the analog channel or math function waveform to the specified reference waveform location. Only ADD or SUBtract math operations can be saved as reference waveforms.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATHSelects the analog channel or math function waveform to save.
:WMEMory<r>:SKEWset / query

Sets the skew factor for the specified reference waveform. The query returns the current skew setting for the selected reference waveform.

NameTypeValuesDescription
rinteger1 - 2Reference waveform number in NR1 format.
skewrealsSkew value in seconds in NR3 format.
real (s) - Current skew setting for the selected reference waveform.

Sets the value represented at center screen for the selected reference waveform. If the value is outside the legal range, it is automatically adjusted to the nearest legal value; legal values depend on :WMEMory<r>:YRANge, :WMEMory<r>:YSCale, and probe attenuation.

NameTypeValuesDescription
rinteger1 - 2Reference waveform number in NR1 format.
offsetreal-Vertical offset value in NR3 format.
suffixoptenumV | mVUnits for the offset value.
real - Returns the current offset value for the selected reference waveform.

Defines the full-scale vertical axis of the selected reference waveform. Legal values for the range are copied from the original source waveform.

NameTypeValuesDescription
rinteger1 - 2Reference waveform number in NR1 format.
rangerealVVertical full-scale range value in NR3 format.
suffixoptenumV | mVUnits suffix for the range value.
real - Returns the current full-scale range setting for the specified reference waveform.

Sets the vertical scale, or units per division, of the selected reference waveform. Legal scale values are copied from the original source waveform.

NameTypeValuesDescription
scalereal-Vertical units per division in NR3 format.
suffixoptenumV | mVOptional unit suffix for the scale.

:CHANnel:LABelset / query

Sets the source text for CHANnel1 or CHANnel2 to the quoted ASCII string that follows. This obsolete command is provided for compatibility with previous oscilloscopes; use :CHANnel<n>:LABel instead.

NameTypeValuesDescription
source_textenumCHANnel1 | CHANnel2Selects which analog channel label source text is set.
stringstring-Quoted ASCII label text to assign.

:CHANnel2:SKEWset / query

Sets the skew between channels 1 and 2. This obsolete compatibility command is only valid for two-channel oscilloscope models; use :CHANnel<n>:PROBe:SKEW instead.

NameTypeValuesDescription
skew valuereal-100 ns - +100 nsSkew time in NR3 format.

:ERASeset / query

Erases the screen. This is an obsolete command provided for compatibility with previous oscilloscopes; use :DISplay:CLEar instead.