/

Keysight

/

Keysight MSOX2012A

SCPI COMMAND REFERENCE

Keysight MSOX2012A

Keysight MSOX2012A

The Keysight MSOX2012A is Keysight's oscilloscope in the InfiniiVision 2000 X-Series family. Its SCPI remote-control interface exposes 527 commands across 50 subsystems - 525 settable and 2 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.

527

Commands

525

Settable

2

Queries

50

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 *CLS 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 zero disables it.

NameTypeValuesDescription
mask_argumentinteger0 - 255Mask value written to the Standard Event Status Enable Register.
*ESRset / query

Returns the contents of the Standard Event Status Register as an integer in NR1 format. Reading the register clears it.

integer - The contents of the Standard Event Status Register; the returned value is the total bit weight of all bits that are high at the time of reading.
*IDNset / query

Queries the instrument identification string, including instrument type and software version.

string - Returns the identification string in the format AGILENT TECHNOLOGIES,<model>,<serial number>,X.XX.XX.
*LRNset / query

Returns the current instrument state as a valid command that can be used to restore the setup later. The result is a binary block in IEEE 488.2 # format prefixed with ":SYST:SET ".

arbitrary_block - Returns <learn_string><NL>, where <learn_string> ::= :SYST:SET <setup_data> and <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. The query version places an ASCII "1" in the output queue when all pending device operations have completed and the interface hangs until it returns.

*OPC
*OPC?
*OPTset / query

Queries the installed options in the instrument. It returns a string identifying the module and its software revision level.

string - Returns the option identification string in the form 0,0,<license info>. The <license info> field is a comma-separated set of option codes indicating installed features.
*RCLset / query

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

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

Places the instrument in a known factory-default state. It is the same as pressing [Save/Recall] > Default/Erase > Factory Default on the front panel, and differs from :SYSTem:PRESet, which preserves some user settings.

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

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

NameTypeValuesDescription
valueinteger0 - 9Specifies the save register.
*SREset / query

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

NameTypeValuesDescription
maskinteger0 - 255Sum of all bits that are set in the Service Request Enable Register.
*SRE <mask>
*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 - The status byte value.
*TRGset / query

Triggers acquisition. The command 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 the test failed.

integer - Self-test result in NR1 format: 0 if the test passed, or a non-zero value if the test failed.
*WAIset / query

Waits until all commands sent prior to *WAI have been executed. In this oscilloscope, the command has no function but is parsed for compatibility with other instruments.

:ACTivityset / query

Clears the cumulative edge variables for the next activity query.

block - Returns whether there has been activity (edges) on the digital channels since the last query, and returns the current logic levels as <edges>,<levels>.

:AERset / query

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

integer - The Arm Event Register value, where 0 or 1 indicates the armed state.

:AUToscaleset / query

Evaluates all input signals and sets the correct conditions to display the signals, equivalent to pressing the front-panel Auto Scale key. If sources are specified, those sources are enabled and all others blanked before autoscale is performed.

NameTypeValuesDescription
sourceoptdiscrete-Input source to autoscale; may be repeated up to five times.
myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
:AUToscale:AMODEset / query

Specifies the acquisition mode that is set by subsequent :AUToscale commands. NORMal sets NORMal acquisition type and RTIMe mode; CURRent keeps the current acquisition type and mode.

NameTypeValuesDescription
valueenumNORMal | CURRentAcquisition mode to be set by subsequent autoscale operations.

Specifies which channels will be displayed on subsequent autoscale operations. When ALL is selected, all channels that meet the autoscale requirements will be displayed; when DISPlayed is selected, only channels that are turned on are autoscaled.

NameTypeValuesDescription
valueenumALL | DISPlayedSelects which channels are included in subsequent autoscale operations.

Turns fast debug autoscaling on or off. The fast debug option changes :AUToscale behavior to help quickly distinguish DC voltage, ground, or an active AC signal while maintaining channel coupling.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables fast debug autoscaling.

:BLANkset / query

Turns off the specified displayed source, such as a channel, math function, digital pod, or serial decode bus. With no parameter, it turns off all sources.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r>Source to blank.

:DIGitizeset / query

Specialized RUN command that causes the instrument to acquire waveforms according to the :ACQuire settings and then stop when acquisition is complete. If no source is given, it acquires the currently displayed channels, or all channels if none are displayed.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | SBUS1 | DIGital<d> | POD{1 | 2} | BUS{1 | 2}Acquisition source to digitize; may be repeated up to five times.
myScope.WriteString ":DIGitize CHANnel1"

:MTEenableset / query

Sets the mask in the Mask Test Event Enable register. Setting specific bits enables corresponding Mask Test events and can trigger bit 9 in the Operation Status Condition Register, potentially causing an SRQ.

NameTypeValuesDescription
maskinteger-16-bit mask value to load into the Mask Test Event Enable register.

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

integer - The register value in NR1 format; the query returns the integer value contained in the Mask Test Event Register and clears the register.

:OPEEset / query

Sets the mask in the Operation Status Enable register. Setting any of the defined bits to 1 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 - The 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 Event Enable Register mask and enables reporting of overload events. The command uses a 16-bit integer mask to enable fault and overload events for the analog input channels.

NameTypeValuesDescription
enable_maskinteger-16-bit integer mask representing the overload enable settings.
:OVLenable <enable_mask>
:OVLenable?

:OVLRegisterset / query

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

integer - The overload protection value stored in the Overload Event Register; 1 indicates an overload has occurred.

:PRINtset / query

Formats the output according to the currently selected format (device). 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, repeated up to 5 times.
:PRINt?query

Pulls image data back over the bus for storage. It is an obsolete command provided for compatibility to previous oscilloscopes; use :DISPlay:DATA instead.

NameTypeValuesDescription
optionsoptenumCOLor | GRAYscale | BMP8bit | BMPPrint option(s) to apply to the query.
block - Image data returned over the bus for storage.

Returns the oscilloscope run state.

enum - The current run state: RUN, STOP, or SING.

:RUNset / query

Starts repetitive acquisitions, equivalent to 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 serial number of the instrument.

: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. MATH is an alias for FUNCtion.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r>Displayed source to query on DSO models.
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 - 16-bit integer value of the Trigger Event Register; 1 indicates trigger occurred and 0 indicates no trigger.

:VIEWset / query

Turns on the specified channel, function, or serial decode bus. For MSO models, the source may also be a digital channel, pod, or bus; MATH is an alias for FUNCtion.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | SBUS1 | WMEMory<r>Specifies which source to display.
:VIEW CHANnel1

Sets the minimum completion criteria for an acquisition. The only legal value is 100, meaning all time buckets must contain data before the acquisition is considered complete.

NameTypeValuesDescription
completeinteger100 - 100Completion criteria percentage for the 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 AVERage, the count can be set from 2 to 65536; the command :ACQuire:COUNt 1 is deprecated.

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

Sets the oscilloscope acquisition mode. Use RTIMe for real time mode or SEGMented for 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 - Number of data points that 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 must be enabled with :ACQuire:MODE, and the command is available only when the segmented memory license (SGM) is enabled.

NameTypeValuesDescription
countinteger2 - 250Number of memory segments to acquire, in NR1 format.

Sets the index into the acquired memory segments. The command is available when the segmented memory license (SGM) is enabled and segmented acquisition mode is in use.

NameTypeValuesDescription
indexinteger1 - 250Memory segment index to select, in NR1 format.
:ACQuire:SEGMented:INDex <index>
myScope.WriteString ":ACQuire:SEGMented:INDex " + CStr(lngI)
:ACQuire:SRATeset / query

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

real - Current oscilloscope acquisition sample rate, returned in NR3 format.
:ACQuire:TYPEset / query

Selects the acquisition type for the oscilloscope. Available types are normal, average, high-resolution (smoothing), and peak detect.

NameTypeValuesDescription
typeenumNORMal | AVERage | HRESolution | PEAKSelects the acquisition mode to use.
:ACQuire:TYPE NORMal

:BUS<n>:BIT<m>set / query

Includes or excludes a selected digital bit as part of the definition for the selected bus. This command is only valid for MSO models.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFSelects whether the specified bit is included in or excluded from the bus definition.
myScope.WriteString ":BUS1:BIT1 ON"
:BUS<n>:BITSset / query

Includes or excludes selected digital channels in the definition of the specified bus. The command is only valid for MSO models.

NameTypeValuesDescription
channel_listchannel_list-List of digital channels or channel ranges to include or exclude, written as (@<m>,<m>:<m>, ...).
displayenum1 | ON | 0 | OFFSpecifies whether the listed bits are included in the bus definition (1/ON) or excluded (0/OFF).
enum - Returns the bus definition as a channel list and display state.
myScope.WriteString ":BUS1:BITS (@1,2,4:7), ON"
myScope.WriteString ":BUS1:BITS (@1,5,7), ON"
myScope.WriteString ":BUS1:BITS (@1:7), ON"
myScope.WriteString ":BUS1:BITS (@1:3,5,7), ON"
:BUS<n>:CLEarset / query

Excludes all of the digital channels from the selected bus definition. The bus number suffix <n> must be 1 or 2, and the command is only valid for MSO models.

NameTypeValuesDescription
ninteger1 - 2Bus number suffix attached to BUS that defines the affected bus.
:BUS<n>:DISPlayset / query

Enables or disables the view of the selected bus. This command is only valid for MSO models.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFSelects whether the bus display is enabled or disabled.
enum - Returns the display value of the selected bus.
:BUS<n>:LABelset / query

Sets the label for the specified bus to a quoted string, and adds that name to the label list. The query returns the current bus name.

NameTypeValuesDescription
quoted_stringstring-Quoted ASCII label string, 10 characters or less.
string - The name of the specified bus as a quoted string.
myScope.WriteString ":BUS1:LABel 'Data'"
:BUS<n>:MASKset / query

Sets the mask for the specified bus. The mask determines which bits are included or excluded in the selected bus; a bit value of 1 includes the bit and 0 excludes it. This command is only valid for the MSO models.

NameTypeValuesDescription
maskinteger-32-bit mask value in decimal, nondecimal, or string form.
:BUS<n>:MASK <mask>
:BUS<n>:MASK?

:CALibrate:DATEset / query

Returns the date of the last calibration.

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

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

NameTypeValuesDescription
stringstring-Quoted ASCII string to store as the calibration label, up to 32 characters excluding the quotes.

Sets the signal available on the rear-panel TRIG OUT BNC. The query returns the current source of the TRIG OUT BNC signal.

NameTypeValuesDescription
signalenumTRIGgers | MASK | WAVEgenSelects the TRIG OUT BNC source signal.

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

enum - Rear-panel calibration protect (CAL PROTECT) button state.

Returns the summary results of the last user calibration procedure.

string - A comma-separated pair containing an integer status code and an ASCII status string.

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

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

Returns the time of the last calibration.

string - The time of the last calibration.

Sets the channel bandwidth limit value and turns on bandwidth limiting. On query, returns the current low-pass filter setting, or the oscilloscope's maximum possible bandwidth when MAXimum is used.

NameTypeValuesDescription
ninteger1 - # analog channelsChannel number.
limitreal25E6 - 25E6Bandwidth limit value; the oscilloscope accepts any requested value but uses 25 MHz.
real (Hz) - The current low-pass filter setting, or the full bandwidth of the oscilloscope if bandwidth limiting is off; with MAXimum, returns the oscilloscope's maximum possible bandwidth.

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

NameTypeValuesDescription
bwlimitenum1 | ON | 0 | OFFTurns the channel bandwidth limit filter on or off.

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

NameTypeValuesDescription
couplingenumAC | DCInput coupling for the specified channel.
noptinteger1 - (# analog channels)Analog 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 | OFFTurns the specified channel display on or off.
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. Inversion may be enabled or disabled for channel n.

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

Sets the analog channel label to the quoted ASCII string that follows. Labels are limited to 10 characters; longer labels are truncated and lowercase characters are converted to upper case.

NameTypeValuesDescription
stringstring-Quoted ASCII label to assign to the channel.
string - Returns the label associated with the specified 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 screen center for the selected channel. Values outside the legal range are automatically adjusted to the nearest legal value, and the legal range depends on :CHANnel<n>:RANGe, :CHANnel<n>:SCALe, and probe attenuation.

NameTypeValuesDescription
offsetreal-Vertical offset value in NR3 format.
suffixoptenumV | mVUnit suffix for the offset value.

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

NameTypeValuesDescription
attenuationreal0.001 - 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. Valid only for 113xA Series probes.

NameTypeValuesDescription
ninteger1 - 4Channel number.
head_paramenumSEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | NONEProbe head type and dB value.

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 type of probe attached to the specified oscilloscope channel, returned 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
skew valuereal-100 ns - +100 nsSkew time in NR3 format.
ninteger1 - (# analog channels)Selects the analog channel number.

Sets the channel probe signal type to differential or single-ended for 113xA Series probes, which determines 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 analog channel overvoltage protection for channel <n>. On 2000 X-Series oscilloscopes this command does nothing because the channel input impedance is always 1 M, and the query always returns NORM.

NameTypeValuesDescription
ninteger1 - (# analog channels)Analog channel number in NR1 format.
clearoptenumCLEarClears protection settings.

Defines the full-scale vertical axis of the selected channel. When using 1:1 probe attenuation, legal values are from 8 mV to 40 V; the range value is multiplied by the probe attenuation factor if probe attenuation is changed.

NameTypeValuesDescription
rangereal8 mV - 40 VVertical full-scale range value in NR3 format.
suffixoptenumV | mVOptional unit suffix appended to 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
scalereal-Vertical units per division in NR3 format.
suffixoptenumV | mVOptional unit suffix.

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

NameTypeValuesDescription
unitsenumVOLT | AMPereMeasurement units for the channel probe.
enum - Returns the current units setting for the specified channel.

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 | OFFTurns the channel vernier setting on or off.
enum - Current state of the channel's vernier setting.

Selects the input impedance setting for the specified channel. This obsolete command is provided for compatibility with previous oscilloscopes; for the 2000 X-Series, the only legal value is ONEMeg (1 M).

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number in NR1 format.
impedanceenumONEMegInput impedance setting.

Controls the probe sense mode for the specified channel, but this obsolete compatibility command cannot actually change the setting. If the sent mode matches the oscilloscope's current setting, the command is accepted; otherwise a setting conflict error is generated.

NameTypeValuesDescription
pmode valueenumAUTo | MANualProbe sense mode value to send.

:DEMO:FUNCtionset / query

Selects the type of demo signal output by the instrument. The available signal types include sine, noise, burst, digital, serial, and other demo patterns.

NameTypeValuesDescription
signalenumSINusoid | NOISy | PHASe | LFSine | AM | RFBurst | FMBurst | HARMonics | COUPling | RINGing | SINGle | CLK | RUNT | TRANsition | SHOLd | MSO | BURSt | GLITch | ETE | I2C | UART | SPI | CAN | LINSelects the demo signal type.

Sets the phase shift for the second sine waveform used in the phase shifted sine demo signals. The query returns the currently set phase shift.

NameTypeValuesDescription
anglereal0 - 360Phase shift angle for the second sine waveform, expressed in degrees and formatted as NR3.
real (degrees) - Currently set phase shift angle in degrees, returned in NR3 format.
:DEMO:OUTPutset / query

Specifies whether the demo signal output is ON (1) or OFF (0). The query returns the current state of the demo signal output setting.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSets the demo signal output state.
enum - Returns the current state of the demo signal output setting as 1 or 0.

Turns the digital display on or off for the specified channel. This command is only valid for the MSO models.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Specifies the digital channel number in NR1 format.
displayenum1 | ON | 0 | OFFSets the digital display state.

Sets the label of the specified digital channel to a quoted ASCII string of 10 characters or less. The query returns the current channel label.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel index in NR1 format.
stringstring10 charactersLabel text as a quoted ASCII string of up to 10 characters.
string - The specified channel label as a quoted ASCII string.

Sets the position of the specified digital channel. The query returns the current position; "-1" indicates there is no space to display the digital waveform.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel number to affect.
positioninteger-Display position for the selected channel.
:DIGital<d>:SIZEset / query

Sets the display size of digital channels. The size is set for all digital channels, and the command is only valid for MSO models.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel index.
valueenumSMALl | MEDium | LARGeDisplay size for the digital channels.

Sets the logic threshold value for all channels in the same pod as the specified digital channel. The threshold is used for triggering purposes and for displaying the digital data as high or low.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel index in NR1 format.
valueenumCMOS | ECL | TTLThreshold setting or a user-defined threshold value with optional suffix.

Turns the display annotation on and off. When on, the annotation appears in the upper left corner of the oscilloscope display and can be used for documentation notes before capturing screens.

NameTypeValuesDescription
settingenum1 | ON | 0 | OFFEnables or disables annotation.

Specifies the background mode for annotation display. The query returns the specified annotation background mode.

NameTypeValuesDescription
modeenumOPAQue | INVerted | TRANsparentSets the annotation background mode.
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 set.

Specifies the annotation string displayed on the oscilloscope screen. The string may be up to 254 quoted ASCII characters, and "\n" can be included to represent a carriage return; use an empty string to clear the annotation text.

NameTypeValuesDescription
stringstring-Quoted ASCII annotation text, up to 254 characters.
: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, active-channel and function data 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 optional color or grayscale palette selection.

NameTypeValuesDescription
formatoptenumBMP | BMP8bit | PNGSelects the image format returned by the query.
paletteoptenumCOLor | GRAYscaleSelects color or grayscale output.
block - Returns screen image data as IEEE-488.2 # binary block data.
:DISPlay:DATA? BMP, COLOR
myScope.WriteString ":DISPlay:DATA? BMP, COLOR"

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

NameTypeValuesDescription
valueinteger0 - 100Waveform intensity setting in NR1 format.
:DISPlay:LABelset / query

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

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

Adds labels to the label list in alphabetical order. Labels are treated as duplicates if they begin with the same alphabetic base string followed by decimal digits, 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 display persistence setting. You can select zero persistence, infinite persistence, or a variable persistence time in seconds.

NameTypeValuesDescription
valueenumMINimum | INFinitePersistence setting to apply.
timereal100E-3 - 60E0Persistence time in seconds for variable persistence.

Erases all persistence data from the display, leaving the data from the last acquisition. If the oscilloscope is running, the display begins accumulating waveform and persistence data again.

: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.
enum - Returns the current vectors setting.
:DISPlay:CONNectset / query

Turns display vectors on or off. When vectors are on, the oscilloscope displays lines connecting sampled data points; when off, only the sampled data is displayed.

NameTypeValuesDescription
connectenum1 | ON | 0 | OFFSelects whether vectors are displayed.
:DISPlay:ORDerset / query

Returns a list of digital channel numbers in screen order, from top to bottom, separated by commas. Busing is displayed as digital channels with no separator; NONE indicates a channel is turned off.

string - Unquoted ASCII string containing the digital channel numbers in screen order, from top to bottom, separated by commas. Busing is displayed as digital channels with no separator; NONE indicates a channel is turned off.
:DISPLAY:ORDER?
myScope.WriteString ":DISPLAY:ORDER 0,10"

:DVM:ARANgeset / query

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

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Enables or disables Auto Range.
enum - Returns a flag indicating whether the digital voltmeter's Auto Range capability is on or off.
:DVM:CURRentset / query

Returns the displayed 3-digit DVM value based on the current mode. After DVM analysis is enabled, it may temporarily return +9.9E+37 until good results are available.

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 | 1Turns the DVM analysis feature on or off.
enum - Returns a flag indicating whether the digital voltmeter (DVM) analysis feature is on or off.
:DVM:FREQuencyset / query

Returns the displayed 5-digit frequency value shown below the main DVM value.

real - The displayed frequency value below the main DVM value, returned as a floating-point number in NR3 format.
:DVM:MODEset / query

Sets the digital voltmeter (DVM) mode. The query returns the selected DVM mode.

NameTypeValuesDescription
dvm_modeenumACRMs | DC | DCRMs | FREQuencyDigital voltmeter mode to select.
enum - Selected DVM mode.
:DVM:SOURceset / query

Sets the selected 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>Selects the DVM input source channel.
enum - Returns the selected DVM input source.

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

NameTypeValuesDescription
bwlimitenum0 | OFFBandwidth limit setting.
:EXTernal:PROBeset / query

Specifies the probe attenuation factor for the external trigger. It does not change the actual input sensitivity of the oscilloscope, only the reference constants used for display scaling and trigger levels.

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

Sets the full-scale range for the external trigger. The command is provided for product compatibility; with 1:1 probe attenuation, the range can only be set to 8.0 V and is multiplied by the probe attenuation factor if probe attenuation changes.

NameTypeValuesDescription
rangerealVVertical full-scale range value in NR3 format.
suffixoptenumV | mVOptional unit suffix for the range value.
: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.

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

Obsolete compatibility command for controlling probe sense mode. If the sent mode matches the oscilloscope setting, the command is accepted; otherwise a setting conflict error is generated.

NameTypeValuesDescription
pmode valueenumAUTo | MANualSelects the probe sense mode.

Selects the clock signal source for the Chart Logic Bus State operation. The query returns the currently selected clock source.

NameTypeValuesDescription
sourceenumDIGital<d>Clock signal source.
enum - The selected clock signal source.

Specifies the clock signal edge for the Chart Logic Bus State operation. The query returns the current clock edge setting.

NameTypeValuesDescription
slopeenumNEGative | POSitive | EITHerClock signal edge to use for the Chart Logic Bus State operation.
enum - Current clock edge setting.

Specifies the value associated with each increment in Chart Logic Bus data.

NameTypeValuesDescription
valuereal-Value per bus code, in NR3 format.

Specifies the value associated with Chart Logic Bus data equal to zero. The query returns the value associated with data equal to zero.

NameTypeValuesDescription
valuereal-Value at bus code = 0, in NR3 format.
real - Value at bus code = 0, in NR3 format.

Specifies the vertical units for the Chart Logic Bus operations. The query returns the current Chart Logic Bus vertical units.

NameTypeValuesDescription
unitsenumVOLT | AMPere | NONEVertical units for Chart Logic Bus operations.

Turns the function display on or off. When ON is selected, the function performs as specified using the other FUNCtion commands; when OFF is selected, 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 valid range is 0 Hz to 25 GHz.

NameTypeValuesDescription
frequencyreal0 - 25 GHzCurrent center frequency in NR3 format.

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.

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

NameTypeValuesDescription
unitsenumDECibel | VRMSSelects the FFT vertical units.
enum - Returns the current FFT vertical units.

Selects the FFT windowing transform used for the function. The available windows are RECTangular, HANNing, FLATtop, and BHARris (Blackman-Harris).

NameTypeValuesDescription
windowenumRECTangular | HANNing | FLATtop | BHARrisSelects the FFT window type.

Sets the high-pass filter's -3 dB cutoff frequency. The high-pass filter is a single-pole high pass filter.

NameTypeValuesDescription
3dB_freqnumeric--3dB cutoff frequency value in NR3 format

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

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

Sets the math operation for the g(t) source used as input to transform or filter functions. The query returns the current g(t) source operation setting.

NameTypeValuesDescription
operationenumADD | SUBTract | MULTiplyMath operation to apply to the g(t) source.
enum - Current g(t) source operation setting.

Selects the first input channel for the g(t) source used as the input to transform or filter functions, if available.

NameTypeValuesDescription
valueenumCHANnel<n>First input channel for the g(t) source.

Selects the second input channel for the g(t) source used as the input to transform or filter functions, if available.

NameTypeValuesDescription
valueenumCHANnel1 | CHANnel2 | CHANnel3 | CHANnel4Selects the second input channel.

Sets the DC offset correction factor for the integrate math waveform input signal. This correction can be used to level a ramped waveform.

NameTypeValuesDescription
input_offsetreal-DC offset correction in NR3 format.

Specifies the 'A' value in the Ax + B operation. The query returns the current gain value.

NameTypeValuesDescription
valuereal-'A' in Ax + B, value in NR3 format.
real - Returns the gain value.

Specifies the B value in the Ax + B operation.

NameTypeValuesDescription
valuereal-B value in the Ax + B operation, formatted as NR3.
:FUNCtion:OFFSetset / query

Sets the voltage or vertical value represented at center screen for the selected function. The value is automatically clamped to the nearest legal value if it is outside the allowed range.

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

Sets the desired waveform math operation for the selected function. The operation can be one of the listed math, filter, trend, or bus chart modes.

NameTypeValuesDescription
operationenumADD | SUBTract | MULTiply | INTegrate | DIFF | FFT | SQRT | MAGNify | ABSolute | SQUare | LN | LOG | EXP | TEN | LOWPass | HIGHpass | DIVide | LINear | TRENd | BTIMing | BSTateDesired 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-Full-scale vertical axis value in NR3 format.
real - Current full-scale range value for the selected function.

Sets the reference level for the selected function, i.e. the voltage or vertical value represented at center screen. Values outside the legal range are clipped to the nearest legal value; this command is equivalent to :FUNCtion:OFFSet.

NameTypeValuesDescription
levelreal-Current 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. It is used for operator math functions and as the single source for transform, filter, and visualization functions.

NameTypeValuesDescription
source1enumCHANnel<n> | GOFT | BUS<m>First source for the function operation.

Specifies the second source for math operator functions that have two sources. The setting is not used for transform, filter, or visualization functions except in the measurement trend visualization case when the measurement requires two sources.

NameTypeValuesDescription
valueenumCHANnel<n> | NONESecond source selection for the math function.
enum - Returns the currently specified second source for math operations.

Selects the measurement whose trend is shown in the math waveform. The query returns the selected measurement.

NameTypeValuesDescription
typeenumVAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDth | NWIDth | DUTYcycle | RISetime | FALLtimeMeasurement to display as the trend.
enum - Selected measurement code.
:FUNCtion:SOURceset / query

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

NameTypeValuesDescription
valueenumCHANnel<n> | ADD | SUBTract | MULTiplySource for function operations.
:FUNCtion:VIEWset / query

Turns the selected function on or off. ON enables the function to be calculated and displayed; OFF disables calculation and display.

NameTypeValuesDescription
viewenum1 | ON | 0 | OFFSelects whether the function is viewed.

:HARDcopy:AREAset / query

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

NameTypeValuesDescription
areaenumSCReenSelects the display area to print.
enum - Returns the selected display area.

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

NameTypeValuesDescription
active_printernumeric-Active printer specified as either the printer list index or the printer name.
string - Name of the active printer.

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

NameTypeValuesDescription
factorsenumOFF | 0 | ON | 1Turns hardcopy scale factors off or on.
:HARDcopy:FFEedset / query

Controls whether a formfeed is output between the screen image and factors of a hardcopy dump. The query returns a flag indicating whether a formfeed is output at the end of the hardcopy dump.

NameTypeValuesDescription
ffeedenumOFF | 0 | ON | 1Selects whether formfeed output is disabled or enabled.
enum - Flag indicating whether a formfeed is output at the end of the hardcopy dump.

Controls whether the graticule colors are inverted or not.

NameTypeValuesDescription
valueenumOFF | 0 | ON | 1Sets whether graticule colors are inverted.
enum - Returns a flag indicating whether graticule colors are inverted or not.
:HARDcopy:LAYoutset / query

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

NameTypeValuesDescription
layoutenumLANDscape | PORTraitHardcopy layout mode.
enum - Selected hardcopy layout mode.

Sets the address for a network printer slot. The address is the server/computer name and printer share name in \\server\share format; use :HARDcopy:NETWork:APPLy to apply the entered address.

NameTypeValuesDescription
addressstring-Quoted ASCII string containing the network printer address.

Sets the Windows network domain name. The domain name setting is a common setting for both network printer slots.

NameTypeValuesDescription
domainstring-Windows network domain name as a quoted ASCII string.

Sets the password for the specified Windows network domain and user name. The password setting is a common setting for both network printer slots.

NameTypeValuesDescription
passwordstring-Quoted ASCII string password.

Selects the network printer slot used for the address and apply commands. There are two network printer slots to choose from.

NameTypeValuesDescription
slotenumNET0 | NET1Network printer slot to select.

Sets the user name used when connecting to the Windows network domain. The setting is common to both network printer slots.

NameTypeValuesDescription
usernamestring-Quoted ASCII string user name to set.

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

NameTypeValuesDescription
paletteenumCOLor | GRAYscale | NONEHardcopy palette color to use.
enum - Returns the selected hardcopy palette color.

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

string - Returns a printer list in the form of one or more printer specifications terminated by <NL>. Each printer specification contains an integer index, an active flag, and the printer name.

Sets the hardcopy destination. This is an obsolete command 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 command is obsolete and provided for compatibility with previous oscilloscopes.

NameTypeValuesDescription
stringstring-Quoted ASCII string specifying the filename.
:HARDcopy:FILename <string>
:HARDcopy:FILename?

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

NameTypeValuesDescription
grayenumOFF | 0 | ON | 1Selects whether grayscale is disabled or enabled.

Controls whether the graticule colors are inverted. This is an obsolete compatibility command; the manual recommends using :HARDcopy:INKSaver instead.

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

Sets the hardcopy printer driver used for the selected printer. This obsolete command is provided for compatibility with previous oscilloscopes; 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 the selected printer.

:LISTer:DATAset / query

Returns the lister data.

block - The lister data.
:LISTer:DISPlayset / query

Configures which serial buses are displayed in the Lister, or turns the Lister display off. Setting "ON" or "1" is equivalent to "SBUS1"; setting "ALL" interleaves decode information from different buses in time.

NameTypeValuesDescription
valueenumOFF | 0 | SBUS1 | ON | 1 | ALLSelects the Lister display mode or bus display selection.

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 - Returns the Lister time reference setting.

:MARKer:MODEset / query

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

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

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

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

Sets the source for the cursors. If marker mode is not currently WAVeform, sending the command puts the cursors in MANual mode and setting one marker pair source sets the other pair as well; in WAVeform mode, X1Y1 and X2Y2 sources can be set separately.

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

Sets the X2 cursor position to the specified value and sets :MARKer:MODE to MANual if it is not currently WAVeform. The query returns the current X2 cursor position.

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

Sets the source for the cursors. The specified channel must be enabled for cursors to be displayed; otherwise an error is issued. If marker mode is not WAVeform, sending this command puts the cursors in MANual mode and also sets the other marker pair’s source.

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

Returns the value difference between the current X1 and X2 cursor positions. The X-axis cursor units are set by :MARKer:XUNits; if front-panel cursors are off, the marker position values are not defined.

real - Difference value in NR3 format, computed as (Value at X2 cursor) - (Value at X1 cursor).
:MARKer:XUNitsset / query

Sets the X cursor units. Available units are seconds, hertz, degrees, or percent; changing X units affects the X1Position, X2Position, and XDELta commands/queries.

NameTypeValuesDescription
unitsenumSEConds | HERTz | DEGRees | PERCentX cursor units to use for measurements.

Sets the current X1 location as 0 degrees and the current X2 location as 360 degrees when :MARKer:XUNits is DEGRees, or as 0 percent and 100 percent when :MARKer:XUNits is PERCent. Inputs to and outputs from :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta are then relative to those set locations.

Sets the Y1 cursor position when marker mode is not WAVeform; if needed, it first changes :MARKer:MODE to MANual. The query returns the current Y1 cursor position.

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

Sets the Y2 cursor position in NR3 format, with an optional unit suffix of mV, V, or dB. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual and updates the Y2 cursor position; Y positions cannot be set while in WAVeform mode.

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

Returns the value difference between the current Y1 and Y2 cursor positions. The result is Ydelta = (Value at Y2 cursor) - (Value at Y1 cursor).

real - Difference value in NR3 format.
: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 cursors units.

When PERCent is selected for :MARKer:YUNits, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. After the 0 and 100 percent locations are set, inputs to and outputs from :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta are relative to those set 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 an optional source is specified, the currently specified source is modified.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.
real (Hz) - Returns the bit rate value in Hertz.
:MEASure:CLEarset / query

Clears all selected measurements and markers from the screen.

:MEASure:DEFineset / query

Sets up the definition used by measurement queries by specifying delay edge specifications or threshold values. Changing these values can affect results of other measurement commands; for DELay, the definition only affects the :MEASure:DELay? query.

NameTypeValuesDescription
meas_specenumDELay | THResholdsSelects whether the command defines delay edges or threshold settings.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the waveform source for the measurement definition.
:MEASure:DELayset / query

Places the instrument in continuous measurement mode and starts a delay measurement. The query measures and returns the delay between two sources using the edges and thresholds defined by :MEASure:DEFine.

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 becomes the current source. The signal must be displayed, and the command is not available if the source is FFT.

NameTypeValuesDescription
sourceopt--Measurement source to use.
real - Returns the measured duty cycle as the ratio of positive pulse width to period, calculated as (+pulse width/period)*100.

Installs a screen measurement and starts a fall-time measurement. 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.

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

NameTypeValuesDescription
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use for the frequency measurement.
real (Hz) - 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. The signal must be displayed, and the command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptdiscrete-Measurement source to use.
real - Ratio of negative pulse width to period, returned in NR3 format as the measured negative duty cycle.
:MEASure:NEDGesset / query

Installs a falling edge 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.
real - Returns the on-screen falling edge count in NR3 format.
:MEASure:NPULsesset / query

Installs a falling pulse count measurement on screen. If the optional source parameter is not specified, the current source is measured.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source.
real - Returns the on-screen falling pulse count in NR3 format.
:MEASure:NWIDthset / query

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

NameTypeValuesDescription
sourceoptenum<digital channels> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.

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

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement source.
:MEASure:OVERshoot [<source>]
:MEASure:OVERshoot? [<source>]
:MEASure:PEDGesset / query

Installs a rising 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 to use.
:MEASure:PERiodset / query

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

NameTypeValuesDescription
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use for the period measurement.
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 the delay and period measurements.

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

Installs a rising 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.

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 source waveform for the preshoot measurement.
real (%) - Returns the percent of preshoot of the selected waveform in NR3 format.
: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
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source; DIGital<d> is used for MSO models.
:MEASure:RESultsset / query

Returns the results of the continuously displayed measurements. The response is a comma-separated list of measurement results, and if no quick measurements are installed it returns an empty string.

string - Comma-separated list of measurement results for the continuously displayed measurements; returns an empty string when no quick measurements are installed.
:MEASure:RESults?

Installs a screen rise-time measurement and starts measuring rise time. If an optional source is specified, the current source is modified. The query measures and outputs the rise time of the displayed rising edge closest to the trigger reference.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use.
real (s) - Rise time in seconds.
:MEASure:SHOWset / query

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

NameTypeValuesDescription
showenum1 | ONTurns measurement tracking markers on.
:MEASure:SOURceset / query

Sets the default sources for measurements. The specified sources are used by MEASure subsystem commands unless overridden, and the current source changes whenever a source is specified for a measurement.

NameTypeValuesDescription
source1enumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Primary measurement source.
source2optenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Secondary measurement source.
:MEASure:SOURce CHANnel1
:MEASure:TEDGeset / query

Queries the time interval between the trigger event and a specified transition occurrence on the displayed signal. The sign of the slope selects a rising or falling edge; if the optional source is specified, the current source is modified.

NameTypeValuesDescription
slopeenum | +Direction of the waveform: space or plus sign (+) for rising slope, minus sign (-) for falling edge.
occurrenceinteger-The transition number to be reported, counted from the left screen edge.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Optional source to measure from; can be a digital channel, analog channel, function, math, or waveform memory source.
real (s) - Time in seconds of the specified transition, reported in NR3 format. If the specified crossing cannot be found, the oscilloscope reports +9.9E+37.
:MEASURE:TEDGE? +1, CHAN1
:MEASURE:TEDGE? +2, CHAN1
:MEASure:TVALueset / query

Searches the displayed signal for the specified value level and transition, then returns the time interval between the trigger event and that crossing. If an optional source is specified, the current source is modified; the query is not available if the source is FFT.

NameTypeValuesDescription
valuereal-The vertical value that the waveform must cross.
slopeoptinteger-Direction of the waveform crossing; plus sign (+) for rising and minus sign (-) for falling.
occurrenceinteger-The transition number to be reported; 1 returns the first crossing, 2 the second, and so on.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to search.
real (s) - Time in seconds of the specified value crossing, returned 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 to use.
real - Returns the vertical amplitude of the selected waveform in NR3 format.

Installs a screen measurement and starts an average value measurement. An optional source can be specified to modify the current source, and an optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlaySpecifies the measurement interval.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Specifies the measurement source.
: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 | WMEMory<r>Selects the waveform source to measure.
real - Returns the maximum vertical value of the selected waveform in NR3 format.
:MEASure:VMAX [<source>]
:MEASure:VMAX? [<source>]
: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 | WMEMory<r>Selects the waveform source for the 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 | WMEMory<r>Measurement source to use.
:MEASure:VRMSset / query

Installs a screen measurement and starts an RMS value measurement. Optional interval, type, and source arguments can modify the measurement; if omitted, DISPlay and DC are implied respectively.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval, either an integral number of cycles or the full screen.
typeoptenumAC | DCSelects AC RMS or DC RMS measurement mode.
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Measurement source to use or modify.
:MEASure:VTIMeset / query

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

NameTypeValuesDescription
vtime_argumentrealsTime from trigger in seconds.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATH | WMEMory<r>Source on which to measure; optional.
real - Value at the specified time in NR3 format.
: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 the measurement window used when the zoomed time base is displayed. The setting can be MAIN, ZOOM, or AUTO; the query returns the current measurement window setting.

NameTypeValuesDescription
typeenumMAIN | ZOOM | AUTOSelects the measurement window to use.
enum - Returns the current measurement window setting.
: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, it modifies the current source.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Selects the measurement 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. This command is an alias for :MEASure:TMIN.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Source for the measurement; if specified, it also modifies the current 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 threshold are interpreted as absolute values when thresholds are absolute, and as percentages when thresholds are percent as defined by :MEASure:DEFine THResholds. The command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
voltagerealVLower threshold value.
real (V) - Returns the current lower threshold level in volts.
: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

Returns the time difference between the Tstop marker (X2 cursor) and the Tstart marker (X1 cursor). This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:XDELta instead.

real - Time difference between the start and stop markers, equal to Tstop - Tstart, in NR3 format. No new measurement is made when the query is received; the current delta time value is returned.

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

NameTypeValuesDescription
thresholdsenumT1090 | T2080 | VOLTageThreshold set to use for time measurements.
enum - Returns the currently selected measurement thresholds.
: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, the current source is modified. This command is obsolete and provided for backward compatibility; use :MEASure:XMAX instead.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATHSelects the waveform source for the measurement.
: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 becomes the current source. This command is obsolete and provided for backward compatibility; use :MEASure:XMIN instead.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion | MATHSelects the waveform source to measure; if omitted, the current source is used.
:MEASure:TSTArtset / query

Moves the start marker (X1 cursor) to the specified time with respect to the trigger time. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:X1Position instead.

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

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

NameTypeValuesDescription
valuerealsTime at the stop marker in seconds.
suffixoptenums | ms | us | ns | psOptional time suffix.
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 crossing occurrence. It is obsolete and provided for backward compatibility; use :MEASure:TVALue instead.

NameTypeValuesDescription
valuereal-The voltage level that the waveform must cross.
slopeoptinteger-Direction of the waveform; positive sign for rising edge, negative sign for falling edge.
occurrenceinteger-The transition number to be reported.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATHSelects the measurement source.
real (s) - Time in seconds of the specified voltage crossing, returned in NR3 format. If the specified crossing cannot be found, +9.9E+37 is returned.
:MEASure:UPPerset / query

Sets the upper measurement threshold value. This command is obsolete and provided for backward compatibility; use :MEASure:DEFine THResholds instead.

NameTypeValuesDescription
valuereal-The 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). No measurement is made when the query is received; the returned delta is the current value.

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

Moves the vertical marker (Y1 cursor) to the specified value corresponding to 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 the vertical marker 2 (Y2 cursor) to the specified value for the selected source. This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:Y2Position instead.

NameTypeValuesDescription
vstop_argumentreal-Value for the Y2 cursor.
:MEASure:VSTOp?

:MTESt:ALLset / query

Specifies which channel(s) 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 parameters defined by :MTESt:AMASk:XDELta, :MTESt:AMASk:YDELta, and :MTESt:AMASk:UNITs. The mask encompasses only the portion of the waveform visible on the display.

Selects the source used to interpret the :MTESt:AMASk:XDELta and :MTESt:AMASk:YDELta parameters when :MTESt:AMASk:UNITs is set to CURRent. This command is the same as :MTESt:SOURce.

NameTypeValuesDescription
sourcediscrete-Source channel to use for mask delta interpretation.
:MTESt:AMASk:SOURce <source>
:MTESt:AMASk:SOURce?

Sets how the mask test subsystem interprets automask tolerance parameters. The setting can be based on the current channel units or on screen divisions.

NameTypeValuesDescription
unitsenumCURRent | DIVisionsSelects whether automask tolerance parameters use channel units or graticule divisions.

Sets the X-direction tolerance used by the automasking feature. The absolute tolerance is added to and subtracted from waveform horizontal values to determine the mask boundaries, and the value is interpreted according to :MTESt:AMASk:UNITs.

NameTypeValuesDescription
valuereal-X delta value in NR3 format.

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

NameTypeValuesDescription
valuereal-Y delta value in NR3 format.

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

NameTypeValuesDescription
channel<n>optinteger1 - (# analog channels)Channel number to query.
integer - Number of failed waveforms.

Returns the elapsed time in the current mask test run.

string (s) - Elapsed time in the current mask test run, returned as elapsed seconds in NR3 format.

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

integer - Number of waveforms 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 - Mask data in binary block format using the IEEE 488.2 # definite-length format.
:MTESt:ENABleset / query

Enables or disables the mask test features.

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

Enables or disables the mask lock feature. ON locks a mask to the source so it is redrawn as the source scaling or position changes; OFF makes the mask static.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns mask lock on or off.
:MTESt:RMODeset / query

Sets the mask test termination condition. The available conditions are Forever, Sigma, Time, or Waveforms.

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 that contain a mask violation; passing waveforms do not affect measurements and measurement statistics.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables measuring only mask failures.

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.

Sets saving on mask failures on or off. Setting 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 ON and a mask violation is detected, the mask test and acquisition system are stopped.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables stopping on mask failure.

Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The setting indirectly specifies the number of waveforms that must be tested to reach the sigma level.

NameTypeValuesDescription
levelreal0.1 - 9.3Sigma level to use for the mask test, in NR3 format.

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 in NR3 format.
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 - 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 control on or off.
:MTESt:SCALe:X1set / query

Defines where X=0 in the base coordinate system used for mask testing. The X1 value is a time value specifying the location of the X1 coordinate, which is treated as X=0 for mask region coordinates.

NameTypeValuesDescription
x1_valuereal-X1 value in NR3 format.
real - Returns the current X1 coordinate setting in NR3 format.

Defines the position of the X2 marker with respect to the X1 marker in the mask test coordinate system. The X-coordinate of polygon vertices is normalized using X = (X * ΔX) + X1.

NameTypeValuesDescription
xdelta_valuereal-X delta value in NR3 format; a time value specifying the distance of the X2 marker with respect to the X1 marker.
real - Returns the current value of ΔX in NR3 format.
:MTESt:SCALe:Y1set / query

Defines where Y=0 in the mask-testing coordinate system by setting the Y1 boundary. The query returns the current Y1 marker setting.

NameTypeValuesDescription
y1_valuerealVY1 value in NR3 format.
real (V) - Current setting of the Y1 marker, returned as a Y1 value in NR3 format.
:MTESt:SCALe:Y2set / query

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

NameTypeValuesDescription
y2_valuerealVY2 value in NR3 format.
real (V) - Returns the current setting of the Y2 marker 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
sourceenumCHANnel<n>Channel to select.
enum - Returns the channel configured by the current mask file.
:MTESt:TITLeset / query

Queries the mask title. The returned title is displayed in the mask test dialog box and mask test tab when a mask file is loaded.

string - Mask title as a string of up to 128 ASCII characters.
:MTESt:AVERageset / query

Enables or disables averaging for the oscilloscope. When ON, the scope acquires multiple data values for each time bucket and averages them; when OFF, averaging is disabled. This command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables averaging.

Sets the number of averages for waveforms when the acquisition type is AVERage. This command is obsolete and provided for backward compatibility.

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 name of the file, up to 254 characters long including the path name if used.
:MTESt:RUModeset / query

Determines the termination conditions for the mask test. It can run forever, for a specified time in seconds, or until a specified number of waveforms have been acquired.

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 as FOR, TIME,<seconds>, or WAV,<wfm_count>.

Enables or disables the Stop On Failure run-until criteria for mask testing. When enabled, a mask test stops and the acquisition system stops if a mask violation is detected. This command is obsolete and provided for backward compatibility; the manual recommends :MTESt:RMODe:FACTion:STOP instead.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables Stop On Failure.

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> where n is 1 to the number of analog channels in NR1 format.

:POD<n>:DISPlayset / query

Turns displaying of the specified group of channels on or off. This command is only valid for MSO models.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFTurns display on or off for the specified POD group.
:POD<n>:SIZEset / query

Specifies the size of digital channels on the display for the selected POD group. This command is only valid for MSO models.

NameTypeValuesDescription
valueenumSMALl | MEDium | LARGeSets the digital channel size.

Sets the threshold for the specified group of channels. The threshold is used for triggering purposes and for displaying digital data as high or low.

NameTypeValuesDescription
typeenumCMOS | ECL | TTLPreset threshold type or a user-defined threshold value.
user defined valuereal-8.00 - +8.00User-defined threshold value in NR3 format.
suffixoptenumV | mV | uVUnit suffix for a user-defined threshold value.
:POD1:THRESHOLD CMOS

:RECall:FILenameset / query

Specifies the source for RECall operations by setting the file's base name. The name is a quoted ASCII string and includes no path information or extension.

NameTypeValuesDescription
base_namestring-Quoted ASCII string used as the file's base name.

Recalls a mask. If a file name is provided, its extension must be ".msk".

NameTypeValuesDescription
file_specopt--File specification for the mask to recall; may be an internal location or a quoted file name.
:RECall:PWDset / query

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

NameTypeValuesDescription
path_namestring-Quoted ASCII string specifying the recall working directory.
string - The currently set working directory for recall operations.

Recalls an oscilloscope setup. If a file extension is provided as part of a specified file name, it must be ".scp".

NameTypeValuesDescription
file_specoptstring-Internal location or quoted ASCII file name to recall from.

Recalls a reference waveform from a specified file. If a file extension is provided in <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 current SAVE filename. The file base name is used without path information or an extension.

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

Saves an image to a file. Set :SAVE:IMAGe:FORMat before using it; if the file extension conflicts with the selected format, the format may be changed to match a valid image extension.

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII file name for the saved image.

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 the ".txt" extension.

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

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

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

Controls whether the graticule colors are inverted or not.

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

Sets the image palette color. The query returns the selected image palette color.

NameTypeValuesDescription
paletteenumCOLor | GRAYscaleImage palette color to set.
enum - Selected image palette color.

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

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII file name to save the display data to.

Saves a mask. If a file extension is provided as part of the specified file name, it must be ".msk".

NameTypeValuesDescription
file_specoptstring-File specification for the saved mask, either an internal location or a quoted ASCII file name.

Saves multi-channel waveform data to a file that can be opened by the D9010BSEO Infiniium Offline oscilloscope analysis software. If a file extension is provided, 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 working directory for save operations.
string - Currently set working directory for save operations.

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

NameTypeValuesDescription
file_specoptstring-File specification for the saved setup, either an internal location or a quoted ASCII file name.

Saves oscilloscope waveform data to a file. Set :SAVE:WAVeform:FORMat before saving; if a provided file extension does not match the expected waveform file extension, the format may be changed if the extension is valid.

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string specifying the file name.

Sets the waveform data format type used by :SAVE:WAVeform. 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, that is, the number of points saved, when :SAVE:WAVeform:LENGth:MAX is OFF. When :SAVE:WAVeform:LENGth:MAX is ON, this setting has no effect.

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

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

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Selects whether maximum waveform length saving is disabled or enabled.

Specifies which acquired segments are included when a waveform is saved in segmented memory. The query returns the current segmented waveform save option setting.

NameTypeValuesDescription
optionenumALL | CURRentSelects which segments are saved.
enum - Returns the current segmented waveform save option setting.

Selects the source to be saved as a reference waveform file. Only ADD or SUBtract math operations can be saved as reference waveforms; MATH is an alias for FUNCtion.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | WMEMory<r>Source to be saved as a reference waveform file.

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, given as a quoted ASCII string.
:SAVE:IMAGe:AREAset / query

Returns the selected image area. When saving images it returns SCR (screen); when saving setups or waveform data it returns GRAT (graticule).

enum - Selected image area. Returns SCR when saving images, and GRAT when saving setups or waveform data.

:SBUS<n>:DISPlayset / query

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

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFDisplay state of the serial decode bus.
:SBUS<n>:MODEset / query

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

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

Returns the percent utilization of the CAN counter. The return format is a floating-point percent value in NR3 format.

real (%) - Percent utilization returned as a floating-point value in NR3 format.

Sets the CAN sample point during the bit time, expressed as a percentage of the bit interval. The query returns the current CAN sample point setting.

NameTypeValuesDescription
valuereal60 - 87.5CAN sample point value in NR3 format.
real - The current CAN sample point setting, returned in NR3 format as a percentage value.

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

NameTypeValuesDescription
baudrateinteger10000 - 4000000Baud rate to set for the CAN signal.

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

NameTypeValuesDescription
signalenumCANH | CANL | RX | TX | DIFFerential | DIFL | DIFHCAN signal type to use.
enum - Returns the current CAN signal type.

Sets the source for the CAN signal.

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

Sets the CAN trigger condition for the selected serial bus. The query returns the current CAN trigger condition.

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

Defines the CAN data pattern resource from a string parameter. The string may be binary (0, 1, X, $) or hexadecimal when prefixed with "0x"; excess bits are truncated to the programmed data length.

NameTypeValuesDescription
stringstring-Binary or hexadecimal data pattern string used to define the CAN data pattern resource.

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

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 with X as don't care, and the pattern is truncated to 29 bits if longer.

NameTypeValuesDescription
stringstring-CAN identifier pattern string in binary or hexadecimal form.
string - Returns the current settings of the specified CAN identifier pattern resource in 29-bit binary string format.

Sets the CAN identifier mode for trigger pattern ID matching. Standard selects the 11-bit identifier and Extended selects the 29-bit identifier.

NameTypeValuesDescription
valueenumSTANdard | EXTendedCAN 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 display mode.
enum - Current IIC address width setting.

Sets the source for the IIC serial clock (SCL). The query returns the current source for the IIC serial clock.

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

Sets the source for IIC serial data (SDA). The query returns the current source.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for IIC serial data (SDA).
enum - Current source for IIC serial data.

Sets the address for IIC data. The address can be a 7-bit or 10-bit hexadecimal value, or a don't care address to ignore the address value.

NameTypeValuesDescription
valueinteger0x00 - 0x7FIIC address value.
integer - Returns the current address for IIC data.

Sets the IIC data pattern for trigger qualification. The data value can range from 0x00 to 0x0FF; use -1 or 0xFFFFFFFF for a don't-care data pattern.

NameTypeValuesDescription
valuenumeric0x00 - 0x0FFIIC data pattern value.

Sets IIC data 2 for the trigger pattern. The data value may be given as an integer or as a hexadecimal string of the form "0xnn"; the don't care value (-1 or 0xFFFFFFFF) ignores the data value.

NameTypeValuesDescription
valueinteger0x00 - 0x0FFIIC data 2 pattern value.

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 for the selected bus. The value may be one of the listed trigger frame types; the short forms READ and WRIT are also accepted for READ7 and WRITe7, respectively.

NameTypeValuesDescription
valueenumSTARt | STOP | READ7 | READEprom | WRITe7 | WRITe10 | NACKnowledge | ANACk | R7Data2 | W7Data2 | RESTartSelects the IIC trigger type.

Determines whether LIN parity bits are included as the most significant bits in the display of the Frame Id field. The query returns the current LIN parity bits display setting.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFSets whether parity bits are shown as MSB in the Frame Id field display.
enum - Returns the current LIN parity bits display setting.

Sets the LIN sample point during the bit time used to determine whether the bit is dominant or recessive. The sample point is expressed as a percentage of bit time and is not limited by the baud rate.

NameTypeValuesDescription
valuereal60 - 87.5Sample point value in NR3 format.

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

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

Sets the source for the LIN signal.

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

Sets the LIN standard in effect for triggering and decoding to LIN1.3 or LIN2.0. The query returns the current LIN standard setting.

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

Sets the LIN sync break length to 11, 12, or 13 clock lengths. The query returns the current LIN sync break setting.

NameTypeValuesDescription
valueinteger11 - 13Sets the length of the LIN sync break in clock lengths.
enum - Returns the current LIN sync break setting.

Sets the LIN trigger condition. The query returns the current LIN trigger value.

NameTypeValuesDescription
conditionenumSYNCbreak | ID | DATASelects the LIN trigger condition.
enum - Returns the current LIN trigger value.

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

NameTypeValuesDescription
valueinteger0 - 637-bit identifier value in decimal.

Sets the LIN trigger data pattern searched for in each LIN data field. The pattern is entered as a string whose format depends on the :SBUS<n>:LIN:TRIGger:PATTern:FORMat base setting, and queried as the currently specified pattern.

NameTypeValuesDescription
stringstring-LIN trigger data pattern string.
string - Returns 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 set by the :SBUS<n>:LIN:TRIGger:PATTern:DATA command.

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. The default base is BINary; the query returns the currently set number base.

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

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

NameTypeValuesDescription
orderenumLSBFirst | MSBFirstBit order to use for SPI decode display.
enum - Returns the current SPI decode bit order.

Sets the SPI clock source slope used to clock in data. Positive selects the rising edge and negative selects the falling edge.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the rising edge or falling edge of the SPI clock source.

Sets the SPI signal clock timeout resource in seconds when :SBUS<n>:SPI:FRAMing is set to TIMeout. The timer is used to frame 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 in seconds.

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

NameTypeValuesDescription
valueenumCHIPselect | NCHipselect | NOTC | TIMeoutSPI framing value to select.
:SBUS<n>:SPI:FRAMing <value>
:SBUS<n>:SPI:FRAMing?

Sets the source for the SPI serial clock. The query returns the current source for the SPI serial clock.

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

Sets the frame source when :SBUS<n>:SPI:FRAMing is set to CHIPselect or NOTChipselect. The query returns the current frame source for the SPI serial frame.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the frame source.
enum - Current frame source for the SPI serial frame.

Sets the source for the SPI serial MISO data. The query returns the current source for the SPI serial MISO data.

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

Sets the source for the SPI serial MOSI data. The equivalent :SBUS<n>:SPI:SOURce:DATA command can also be used to set the MOSI data source.

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

Defines the SPI data pattern resource according to a string parameter. The pattern, together with the data width, controls the data pattern searched for in the data stream.

NameTypeValuesDescription
stringstring-Pattern string made up of binary digits and don't-care characters, or hexadecimal digits if prefixed with 0x.
string - Returns the current settings of the specified SPI data pattern resource in binary string format.

Sets the width of the SPI data pattern. The width must be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.

NameTypeValuesDescription
widthinteger4 - 64Width of the SPI data pattern in bits.

Defines the SPI MOSI data pattern resource according to the string parameter. The pattern, together with the data width, controls the data pattern searched for in the data stream; the width should be set before this command.

NameTypeValuesDescription
stringstring-Binary string of 0, 1, X, and $ characters, or hexadecimal string prefixed with 0x containing hexadecimal digits and X/$ don't-care characters.

Sets the width of the SPI data pattern. The width can be set from 4 bits to 64 bits and should be set before :SBUS<n>:SPI:TRIGger:PATTern:MOSI:DATA.

NameTypeValuesDescription
widthinteger4 - 64SPI data pattern width in bits.

Specifies whether the SPI trigger is based 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 - Returns the current SPI trigger type setting.

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

NameTypeValuesDescription
word_widthinteger4 - 16Number of bits in a 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 | HEXBase to use for UART decode and Lister display.
enum - Current UART decode and Lister base setting.

Selects the bit rate in bps for the serial decoder and/or trigger when in UART mode. The baud rate can be set from 100 b/s to 8 Mb/s.

NameTypeValuesDescription
baudrateinteger100 - 8000000Bit rate to use for UART mode.
integer - Returns the current UART baud rate setting.

Specifies 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 | MSBFirstSets the UART bit order.

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

NameTypeValuesDescription
valueenumOFFByte value to use for framing, or OFF to disable framing.
enum - Returns the current UART decode base setting as OFF or an 8-bit 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 setting to use for 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.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the UART Rx source signal.

Controls which signal is used as the Tx source by the serial decoder and/or trigger when in UART mode.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the source used for the UART Tx signal.

Sets the front panel UART/RS232 trigger setup data selection option. ASCII selects ASCII values; HEX selects hexadecimal values.

NameTypeValuesDescription
baseenumASCii | HEXFront panel UART/RS232 trigger data selection base.

Selects the UART trigger burst value, i.e. the Nth frame after an idle period, for UART mode. The valid range is 1 to 4096 or OFF.

NameTypeValuesDescription
valueenumOFFBurst value to use for the trigger.

Sets the UART trigger data byte value for the selected :SBUS<n> trigger qualifier in UART mode. The value is used when RD or TD trigger types are selected.

NameTypeValuesDescription
valueinteger0 - 2558-bit trigger data value, entered as decimal, hexadecimal, binary, or quoted string.

Selects the idle period for burst trigger when in UART mode. The setting is in the range from 1 us to 10 s.

NameTypeValuesDescription
time_valuereal1 us - 10 sTime value for the UART trigger idle period, expressed in NR3 format.

Selects the data qualifier used for the UART trigger when :TYPE is set to RDATa, RD1, RD0, RDX, TDATa, TD1, TD0, or TDX. The query returns the current UART trigger qualifier.

NameTypeValuesDescription
valueenumEQUal | NOTequal | GREaterthan | LESSthanSets the UART trigger data qualifier.
enum - Returns the current UART trigger qualifier.

Selects the UART trigger type. When an RD or TD type 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 for the serial decoder and/or trigger when in UART mode. The valid width is 5 to 9 bits.

NameTypeValuesDescription
widthenum5 | 6 | 7 | 8 | 9UART width setting in bits.
enum - Returns the 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 as <year>,<month>,<day>.

Returns the oscilloscope's Host ID as part of a quoted string. The exact format is product-specific, and portable programs should not attempt to parse the returned contents.

string - Returns the oscilloscope's Host ID as a quoted ASCII string.
:SYSTem:DSPset / query

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

NameTypeValuesDescription
stringstring-Quoted ASCII string displayed in the center text box, up to 75 characters.
:SYSTem:ERRorset / query

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

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

Disables the front panel. 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 the front panel softkey menu.
:SYSTem:PRESetset / query

Places the instrument in a known default state, equivalent to pressing Default Setup on the front panel. Some user settings remain unchanged; use *RST to restore factory defaults for all user settings.

Disables the fifty ohm impedance setting for all analog channels.

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 | ONTurns remote command logging off or on.
file_nameoptstring-Quoted ASCII string used as the log file name.
write_modeoptenumCREate | APPendSelects whether to create a new log file or append to an existing one.

Specifies whether remote commands are logged to a text file, to the screen, or to 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, if applicable, their return values. The query reports 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. Because log files are ASCII text files, the ".txt" extension is automatically added to the name specified.

NameTypeValuesDescription
file_namestring-Quoted ASCII string specifying the log file name.
:SYSTem:RLOGger:FNAMe <file_name>
:SYSTem:RLOGger:FNAMe?

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

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables remote command logging.
enum - Returns the remote command logging state.

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

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects transparent or solid background.

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 from setup (learn) string data sent from the controller. The setup string is transmitted as an IEEE 488.2 definite-length binary block and does not change the interface mode or interface address.

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

Sets the system time using a 24-hour format. Commas separate hours, minutes, and seconds, and validity checking is performed to ensure the time is valid.

NameTypeValuesDescription
timestring-Hours, minutes, and seconds in NR1 format.

:TIMebase:MODEset / query

Sets the current time base mode. The available modes are MAIN, WINDow, XY, and 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 this command is an alias for :TIMebase:DELay.

NameTypeValuesDescription
posrealsTime in seconds from the trigger to the display reference, in NR3 format.
:TIMebase:RANGeset / query

Sets the full-scale horizontal time for the main window. The range is 10 times the current time-per-division setting; the query returns the current full-scale range value.

NameTypeValuesDescription
range_valuerealsTime for 10 divisions, in seconds, in NR3 format.
real (s) - Current full-scale range value for the main window, 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. Time reference is the point on the display where the trigger point is referenced.

NameTypeValuesDescription
referenceenumLEFT | CENTer | RIGHtTime reference position to set.
myScope.WriteString ":TIMebase:REFerence CENTer" ' Set reference to 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) - 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). The query returns the current vernier setting.

NameTypeValuesDescription
vernier valueenum1 | ON | 0 | OFFSets the vernier setting.
enum - Returns the current state of the time base control's vernier setting.

Sets the horizontal position in the zoomed (delayed) view of the main sweep. The value must keep the zoomed view window within the main sweep range.

NameTypeValuesDescription
pos valuerealsTime from the trigger event to the zoomed (delayed) view reference point in NR3 format.
real (s) - Returns the current horizontal window position setting in the zoomed view, in seconds.

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

NameTypeValuesDescription
range valuerealsRange value in seconds in NR3 format.
real (s) - Returns the current window timebase range setting in seconds.

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

NameTypeValuesDescription
scale_valuerealsScale value in seconds for the zoomed window.
:TIMebase:WINDow:SCALe <scale_value>
: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.
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 in seconds. Holdoff prevents another trigger from occurring until a specified time has passed since the last trigger.

NameTypeValuesDescription
holdoff_timereal40 ns - 10 sSets the holdoff time value.

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; it has no effect when dual trigger levels are used.

Sets the high trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.

NameTypeValuesDescription
levelreal-High trigger voltage level, specified in NR3 format for internal triggers.
sourceenumCHANnel<n>Trigger source channel.

Sets the low trigger voltage level for the specified source. High and low trigger levels are used with runt triggers and rise/fall time (transition) triggers.

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>Trigger source channel.
:TRIGger:MODEset / query

Selects the trigger mode (trigger type). The query returns the current trigger mode; if :TIMebase:MODE is ROLL or XY, it returns "NONE".

NameTypeValuesDescription
modeenumEDGE | GLITch | PATTern | TV | DELay | EBURst | OR | RUNT | SHOLd | TRANsition | SBUS1 | USBTrigger mode to select.
enum - Current trigger mode. Returns "NONE" when :TIMebase:MODE is ROLL or XY.
myScope.WriteString ":TRIGger:MODE EDGE"
:TRIGger:NREJectset / query

Turns the trigger noise reject filter off and on. When noise reject is on, the trigger circuitry is less sensitive to noise but may require a larger waveform amplitude to trigger the oscilloscope; 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 | NORMalSets the trigger sweep mode.

Specifies the arming edge slope for the Edge Then Edge trigger delay. The query returns the current arming edge slope setting.

NameTypeValuesDescription
slopeenumNEGative | POSitiveRising or falling edge slope used for arming.
enum - Current arming edge slope setting.
:TRIGger:DELay:ARM:SLOPe <slope>
:TRIGger:DELay:ARM:SLOPe?

Selects the input used for the arming edge in the Edge Then Edge trigger. The query returns the current arming edge source.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Input source used for the arming edge.
enum - Returns the current arming edge source as a channel or digital input identifier.

Sets the delay time between the arming edge and the trigger edge in the Edge Then Edge trigger. The time is specified in seconds and must be from 4 ns to 10 s.

NameTypeValuesDescription
time_valuereal4 ns - 10 sTime in seconds in NR3 format.

Sets the Nth edge of the trigger source to trigger on. The query returns the current Nth trigger edge setting.

NameTypeValuesDescription
countinteger-Nth trigger edge setting in NR1 integer format.
integer - Current Nth trigger edge setting in NR1 integer format.

Specifies the trigger edge slope for the Edge Then Edge trigger. Positive selects a rising edge; negative selects a falling edge.

NameTypeValuesDescription
slopeenumNEGative | POSitiveTrigger edge slope to use.

Selects the input used for the trigger edge in the Edge Then Edge trigger. The source may be an analog channel or a digital channel.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Source channel for the trigger edge.
enum - Returns the current trigger edge source.

Sets the Nth edge at the burst counter resource, which is used in the trigger stage to determine which edge in a burst will generate a trigger. The query returns the current Nth edge burst edge counter setting.

NameTypeValuesDescription
countinteger-Nth edge burst counter setting in NR1 integer format.
integer - Current Nth edge burst edge counter setting.

Sets the Nth edge in a burst idle resource in seconds. The timer sets the minimum time before the next burst.

NameTypeValuesDescription
time_valuereal10 ns - 10 sTime in seconds in NR3 format.

Specifies whether the rising edge (POSitive) or falling edge (NEGative) of the Nth edge in a burst will generate a trigger.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the burst edge polarity used to generate the trigger.
enum - Returns the current Nth edge in a burst slope.

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

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Input source for the Nth edge burst trigger.
enum - Current Nth edge burst trigger source, or "NONE" if all channels are off.

Sets the input coupling for the selected trigger sources. The coupling can be set to AC, DC, or LFReject; the query returns the current coupling selection.

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, the active source is not changed and its level is not affected.

NameTypeValuesDescription
levelreal0.75 x full-scale voltage from center screen - ±(external range setting)Trigger level voltage to set; uses a source-dependent format for internal, external, or digital trigger sources.
sourceoptenumCHANnel<n> | EXTernal | DIGital<d>Optional trigger source whose level is being set.

Turns the low-frequency or high-frequency reject filter on or off. Only one of the two filters can be on at a time, and the reject setting is coupled to :TRIGger[:EDGE]:COUPling.

NameTypeValuesDescription
rejectenumOFF | LFReject | HFRejectSelects reject filter state or type.

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

NameTypeValuesDescription
slopeenumNEGative | POSitive | EITHer | ALTernateSelects the trigger edge slope.
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"

Selects the input that produces the trigger. Supported sources depend on the model type and include analog channels, digital channels on MSO models, EXTernal, LINE, and WGEN.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | LINE | WGENSelects the trigger source for DSO models.
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 time in NR3 floating-point format.
real - Returns 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_timerealsMaximum pulse width duration.
real - Pulse width duration time for :TRIGger:GLITch:SOURce.

Sets the trigger level voltage for the active pulse width trigger. The level depends on trigger source and instrument type; for the query, if all channels are off it returns "NONE."

NameTypeValuesDescription
levelrealVTrigger level voltage.
sourceoptenumCHANnel<n> | EXTernal | DIGital<d>Trigger source channel or external/digital source.
enum - Returns the trigger level of the current pulse width trigger mode; if all channels are off, returns "NONE."

Sets the polarity for the glitch pulse width trigger. The query returns the glitch pulse width trigger polarity.

NameTypeValuesDescription
polarityenumPOSitive | NEGativePolarity to set for the glitch pulse width trigger.
enum - The glitch pulse width trigger polarity.

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

NameTypeValuesDescription
operatorenumGREaterthan | LESSthan | RANGeSelects the glitch pulse width qualifier mode.
:TRIGger:GLITch:QUALifier <operator>
:TRIGger:GLITch:QUALifier?

Sets the pulse width duration for the selected :TRIGger:GLITch:SOURce. You can enter the two time parameters in any order; the smaller value becomes <greater_than_time> and the larger value becomes <less_than_time>.

NameTypeValuesDescription
less_than_timereal15 ns - 10 secondsUpper pulse-width time limit.
greater_than_timereal10 ns - 9.99 secondsLower pulse-width time limit.

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>Source channel to use for the pulse width trigger.
enum - Current pulse width source, or "NONE" if all channels are off.
:TRIGger:ORset / query

Specifies the edges to include in the OR'ed edge trigger. Each bit in the string corresponds to a channel, using R for rising edge, F for falling edge, E for either edge, and X for don't care.

NameTypeValuesDescription
stringstring-Edge-selection string made up of characters R, F, E, and X, one per channel bit.
:TRIGger:PATTernset / query

Specifies the channel values to be used in the pattern trigger. The optional edge source and edge parameters must be sent together or not at all, and they take precedence over the ASCII string edge encoding.

NameTypeValuesDescription
patternstring-Pattern string, optionally followed by edge source and edge when the format is HEX.

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.
enum - Returns the currently set number base for pattern trigger patterns.

Qualifies when the trigger occurs. On InfiniiVision 2000 X-Series oscilloscopes, the trigger always occurs when the pattern is entered.

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

Sets the polarity for the runt trigger. The query returns the current runt trigger polarity.

NameTypeValuesDescription
polarityenumPOSitive | NEGative | EITHerSelects whether runt trigger pulses are positive, negative, or either polarity.
enum - Returns the runt trigger polarity.

Selects the qualifier used for specifying runt pulse widths. GREaterthan triggers on runt pulses wider than :TRIGger:RUNT:TIME, LESSthan triggers on runt pulses narrower than :TRIGger:RUNT:TIME, and NONE triggers on runt pulses of any width.

NameTypeValuesDescription
qualifierenumGREaterthan | LESSthan | NONESelects the runt pulse width qualifier.

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

NameTypeValuesDescription
sourcechannel_list-Channel used to produce the trigger.
channel_list - Returns the current runt trigger source.

Sets the runt pulse qualifier time used when triggering on runt pulses whose width is greater than or less than a specified value. The time value is a floating-point NR3 number with an optional time suffix.

NameTypeValuesDescription
timereal-Runt pulse qualifier time setting.

Specifies whether the rising edge or the falling edge of the clock signal is used. The query returns the current rising or falling edge setting.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the clock edge slope used for triggering.
enum - Returns the current rising or falling edge setting.

Selects the input channel probing the clock signal.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Input channel source for the clock signal.

Selects the input channel probing the data signal.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Data signal source channel.

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

NameTypeValuesDescription
timereal-Hold time value in NR3 floating-point format.
suffixoptenums | ms | us | ns | psOptional time suffix.
real - Currently specified hold time returned as <time><NL>.

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

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

Specifies whether the trigger looks for rise/fall times greater than or less than a specified time value. The time value is set with :TRIGger:TRANsition:TIME.

NameTypeValuesDescription
qualifierenumGREaterthan | LESSthanSelects whether the transition time condition is greater than or less than the specified time value.

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

NameTypeValuesDescription
slopeenumNEGative | POSitiveSpecifies the trigger transition slope.
enum - Current rise/fall time trigger slope setting.

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

NameTypeValuesDescription
sourcestring-Channel to use as the trigger source.
string - Current transition trigger source.

Sets the time value for rise/fall time triggers. Use :TRIGger:TRANsition:QUALifier to specify whether triggering occurs for times greater than or less than this value.

NameTypeValuesDescription
timereal-Floating-point time value in NR3 format.
suffixoptenums | ms | us | ns | psOptional time unit suffix.
:TRIGger:TV:LINEset / query

Sets the TV trigger to fire on a specific video line. Valid line-number limits vary with the selected TV standard and mode.

NameTypeValuesDescription
line_numberinteger1 - 625Video line number in NR1 integer format.
:TRIGger:TV:MODEset / query

Selects the TV trigger mode and field. Old forms for the mode value are accepted.

NameTypeValuesDescription
modeenumFIEld1 | FIEld2 | AFIelds | ALINes | LFIeld1 | LFIeld2 | LALTernateTV trigger mode and field.

Sets the polarity for the TV trigger.

NameTypeValuesDescription
polarityenumPOSitive | NEGativeTV trigger polarity to set.

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

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

Selects the TV trigger standard.

NameTypeValuesDescription
standardenumNTSC | PALM | PAL | SECamVideo standard to use for TV triggering.

Sets the source for the USB D- signal. The allowed source keywords differ between DSO and MSO models.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Source for the USB D- signal.

Sets the source for the USB D+ signal. The allowable sources depend on the model family: DSO models accept a channel or external source, while MSO models accept a channel or digital source.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Source for the USB D+ signal.
enum - Returns the current source for the USB D+ signal.

Sets the expected USB signal speed to Low Speed or Full Speed. The query returns the current USB signal speed value.

NameTypeValuesDescription
valueenumLOW | FULLExpected USB signal speed.
enum - Current USB signal speed value.

Sets where the USB trigger will occur. The query returns the current USB trigger value.

NameTypeValuesDescription
valueenumSOP | EOP | ENTersuspend | EXITsuspend | RESetSelects the USB trigger event.
enum - Returns the current USB trigger value.

Sets the trigger threshold for a pod of 8 digital channels. The threshold can be set to a predefined level or to a user-defined voltage; for predefined thresholds, the voltage value is not required.

NameTypeValuesDescription
channel groupenumPOD1 | POD2Selects which pod channel group the threshold applies to.
threshold typeenumCMOS | ECL | TTL | USERdefChooses a predefined threshold level or a user-defined threshold.
valueoptrealVUser-defined threshold voltage in volts.

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.
:TRIGger:TV:TVMode <mode>
:TRIGger:TV:TVMode?

Sets the output sequence of WORD data. It affects transmitting sequence only when :WAVeform:FORMat WORD is selected, and the default setting is MSBFirst.

NameTypeValuesDescription
valueenumLSBFirst | MSBFirstSpecifies whether the most significant byte or least significant byte is transmitted first.
:WAVeform:COUNtset / query

Returns the count used to acquire the current waveform. For all acquisition types except average, this value is 1.

integer - The count used to acquire the current waveform.
:WAVeform:DATAset / query

Returns the binary block of sampled data points in IEEE 488.2 arbitrary block data format. 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 waveform data points, terminated by <NL>.
:WAVeform:DATA?
:WAVeform:FORMatset / query

Sets the data transmission mode for waveform data points, controlling how waveform data is formatted when sent from the oscilloscope. For queries, returns the current output format for waveform data transfer.

NameTypeValuesDescription
valueenumWORD | BYTE | ASCiiSelects the waveform data format.
enum - Returns the current output format for the transfer of waveform data.
:WAVeform:POINtsset / query

Sets the number of waveform points transferred with the :WAVeform:DATA? query. The allowed values depend on the waveform points mode, and the <points_mode> option is deprecated in favor of :WAVeform:POINts:MODE.

NameTypeValuesDescription
pointsinteger100 - 1000000Number of waveform points to transfer.
myScope.WriteString ":WAVEFORM:POINTS 1000"

Sets the data record transferred with the :WAVeform:DATA? query. The mode selects the measurement record, raw acquisition record, or whichever record contains the maximum number of points.

NameTypeValuesDescription
points_modeenumNORMal | MAXimum | RAWSelects which data record is transferred by :WAVeform:DATA?.
enum - Returns the current points mode.

Requests the preamble information for the selected waveform source. The preamble contains the vertical and horizontal scaling information for the corresponding channel and is returned as a preamble block.

block - Returns a preamble block containing format, type, points, count, xincrement, xorigin, xreference, yincrement, yorigin, and yreference.
:WAVeform:PREamble?

Returns the number of memory segments in the acquired data. It can be queried while segments are being acquired, though :DIGitize blocks subsequent queries until segmented acquisition completes.

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.

string - Time tag of the currently selected segmented memory index, returned in NR3 format.
:WAVeform:SOURceset / query

Selects the source used by the WAVeform commands. The source can be an analog channel, function, reference waveform, or, on MSO models, a digital pod or bus; FUNCtion and MATH are treated as the same source in the query response.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion | MATH | WMEMory<r> | SBUS1 | POD{1 | 2} | BUS{1 | 2}Selects the waveform source.
myScope.WriteString ":WAVEFORM:SOURCE CHAN1"

Selects the waveform subsource when the waveform source is SBUS<n> serial decode. SUB0 is the default; UART uses SUB1 for TX, and SPI uses SUB1 for MISO.

NameTypeValuesDescription
subsourceenumSUB0 | RX | MOSI | SUB1 | TX | MISOSpecifies which serial-decode data set to use.
:WAVeform:TYPEset / query

Returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by :ACQuire:TYPE; if :WAVeform:SOURce is POD1 or POD2, the type is always NORM.

enum - The acquisition mode of 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 always the X-axis value of the first data point (XREFerence = 0).

real - x-origin value in the current preamble 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.

integer - 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; for digital waveforms, the y-increment is always "1".

real (V) - y-increment value in the current preamble in 32-bit floating point NR3 format

Returns the y-origin value for the currently specified source. For this product, it is the Y-axis value of the center of the screen.

real - Y-origin in the current preamble, returned as a 32-bit floating point NR3 value.

Returns the y-reference value for the currently specified source. This is the data point value where the y-origin occurs; in this product, it is the data point value at the center of the screen. It is undefined if the format is ASCII.

real - y-reference value in the current preamble.

: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
frequencyrealHzWaveform generator frequency in Hz, in NR3 format.
real (Hz) - Returns the currently set waveform generator frequency in Hz.
: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 | DCWaveform type to output.
enum - Currently selected signal type.

Specifies the pulse width for Pulse waveforms. The pulse 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.

Sets the symmetry of the ramp waveform. Symmetry represents the amount of time per cycle that the ramp waveform is rising.

NameTypeValuesDescription
percentreal0% - 100%Symmetry percentage in NR1 format.

Sets the square wave duty cycle. Duty cycle is the percentage of the period that the waveform is high.

NameTypeValuesDescription
percentinteger20 - 80Duty cycle percentage in NR1 format.

Specifies the amount of amplitude modulation. The setting is expressed as AM depth percentage from 0% to 100% in NR1 format.

NameTypeValuesDescription
percentreal0% - 100%AM depth percentage.
real (%) - Returns the AM depth percentage setting.

Specifies the frequency of the modulating signal. The query returns the frequency of the modulating signal.

NameTypeValuesDescription
frequencyrealHzModulating waveform frequency in Hz in NR3 format.
real (Hz) - Frequency of the modulating signal in Hz in NR3 format.

Sets the FM frequency deviation from the original carrier signal frequency. The deviation is specified in Hz and must satisfy the carrier-frequency limits described in the manual.

NameTypeValuesDescription
frequencyrealHzFrequency deviation in Hz, in NR3 format.

Specifies the frequency of the modulating signal.

NameTypeValuesDescription
frequencyrealHzModulating waveform frequency in NR3 format.
real (Hz) - Returns the frequency of the modulating signal.

Specifies the FSK hop frequency. The output frequency shifts between the original carrier frequency and this hop frequency.

NameTypeValuesDescription
frequencyrealHzHop frequency in Hz in NR3 format.

Sets the FSK modulation rate, which determines how fast the output frequency shifts. The rate is specified in Hz using NR3 format.

NameTypeValuesDescription
raterealHzFSK modulation rate.
real (Hz) - Returns the FSK rate setting in Hz.

Specifies the shape of the modulating signal. It applies to AM and FM modulation; for RAMP, the ramp symmetry is set with :WGEN:MODulation:FUNCtion:RAMP:SYMMetry.

NameTypeValuesDescription
shapeenumSINusoid | SQUare | RAMPShape of the modulating signal.

Sets the ramp waveform symmetry percentage, which controls the amount of time per cycle that the ramp waveform is rising. The query returns the current ramp symmetry percentage setting.

NameTypeValuesDescription
percentreal0 - 100Symmetry percentage in NR1 format.
real (%) - Ramp symmetry percentage setting in NR1 format.

Adds noise to the currently selected waveform generator signal. The allowable percent range varies with the current amplitude because the combined original signal and injected noise are limited by the regular amplitude limit.

NameTypeValuesDescription
percentreal0 - 100Percent of noise to add to the selected signal.

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 | 1Specifies whether modulation is enabled or disabled.

Selects the modulation type for the waveform generator. The available types are AM, FM, and FSK.

NameTypeValuesDescription
typeenumAM | FM | FSKModulation type to select.
enum - Returns the selected modulation type.
:WGEN:OUTPutset / query

Specifies whether the waveform generator signal output is ON (1) or OFF (0). The query returns the current state of the waveform generator output setting.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns the waveform generator output on or off.
enum - Current state of the waveform generator output setting.

Selects the expected output load impedance used for displayed amplitude and offset calculations. The actual Gen Out BNC output impedance is fixed at 50 ohms.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.
:WGEN:PERiodset / query

Sets the waveform generator period for all waveforms except Noise and DC. The period may also be specified indirectly using :WGEN:FREQuency.

NameTypeValuesDescription
periodrealsPeriod of the waveform in seconds, using NR3 format.
real (s) - Returns the currently set waveform generator period in seconds, using 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 this command to specify amplitude; use :WGEN:VOLTage:OFFSet for offset voltage or DC level.

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

Sets the waveform high-level voltage for all waveforms except DC. The query returns the currently specified waveform high-level voltage.

NameTypeValuesDescription
highrealVHigh-level voltage in volts, in NR3 format.
real (V) - Currently specified waveform high-level voltage.

Sets 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 can 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, or DC level. Use :WGEN:VOLTage to specify the amplitude, or :WGEN:VOLTage:HIGH and :WGEN:VOLTage:LOW to set amplitude and offset indirectly.

NameTypeValuesDescription
offsetrealVOffset voltage in NR3 format.
:WGEN:VOLTage:OFFSet <offset>
:WGEN:VOLTage:OFFSet?

Clears the specified reference waveform location.

NameTypeValuesDescription
rinteger1 - 2Reference waveform location 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 in NR1 format.
on_offenum1 | ON | 0 | OFFTurns the specified reference waveform display on or off.

Sets the reference waveform label to the specified string. Labels 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
rinteger1 - 2Reference waveform location in NR1 format.
sourceenumCHANnel<n> | FUNCtion | MATHWaveform source 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.
skewrealsTime skew value in seconds in NR3 format.
real (s) - Current skew setting for the selected reference waveform.

Sets the vertical offset value represented at screen center for the selected reference waveform. The legal range depends on :WMEMory<r>:YRANge or :WMEMory<r>:YSCale, and out-of-range values are adjusted to the nearest legal value.

NameTypeValuesDescription
offsetreal-Vertical offset value in NR3 format.
suffixoptenumV | mVVoltage suffix for the offset value.

Defines the full-scale vertical axis of the selected reference waveform. Legal values 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 appended to the range.
real - 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
scalerealVVertical units per division.
suffixoptenumV | mVOptional unit suffix for the scale.
real - Returns the current scale setting for the specified reference waveform.

Clears the cumulative edge variables for the next activity query. This is an obsolete command provided for compatibility with previous oscilloscopes; use :ACTivity instead.

:CHANnel:LABelset / query

Sets the source text to a quoted ASCII string and adds the name to the label list. This obsolete command is provided for compatibility; use :CHANnel<n>:LABel or :DIGital<n>:LABel instead.

NameTypeValuesDescription
source_textenumCHANnel1 | CHANnel2 | DIGital<d>Selects the analog or digital channel whose label source text is being set.
stringstring-Quoted ASCII string to assign as the label.
string - Returns the label associated with a particular analog channel.

Sets the threshold for a group of channels. The threshold may be one of the predefined types, or a user-defined voltage value; for predefined values, the voltage parameter is ignored.

NameTypeValuesDescription
channel groupenumPOD1 | POD2Channel group to configure.
threshold typeenumCMOS | ECL | TTL | USERdefThreshold type to apply.
valueoptrealVVoltage for USERdef threshold type.

:CHANnel2:SKEWset / query

Sets the skew between channels 1 and 2. This obsolete command is provided for compatibility with previous oscilloscopes; the probe skew control can be used to remove cable delay errors.

NameTypeValuesDescription
skew valuereal-100 ns - +100 nsSkew time in NR3 format.

:ERASeset / query

Erases the screen. This is an obsolete compatibility command; use :DISplay:CLEar instead.