/

Keysight

/

Keysight MSOX4154G

SCPI COMMAND REFERENCE

Keysight MSOX4154G

Keysight MSOX4154G

The Keysight MSOX4154G is Keysight's oscilloscope in the InfiniiVision 4000G X-Series family. Its SCPI remote-control interface exposes 1067 commands across 60 subsystems - 1065 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.

1,067

Commands

1,065

Settable

2

Queries

60

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; 0 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 the total bit weight of all bits that are high when read. Reading the register clears it.

integer - The Standard Event Status Register value, 0 to 255, in NR1 format.
*IDNset / query

The *IDN? query identifies the instrument type and software version.

string - Returns <manufacturer_string>,<model>,<serial_number>,X.XX.XX <NL>. <manufacturer_string> is AGILENT TECHNOLOGIES, <model> is the instrument model number, <serial_number> is the instrument serial number, and X.XX.XX is the software revision.
*LRNset / query

Returns the current state of the instrument as a valid command string that can later be used to restore the setup. The result includes ":SYST:SET " followed by IEEE 488.2 binary block data.

arbitrary_block - A learn string containing ":SYST:SET " and the current setup data in IEEE 488.2 # binary block format.
*OPCset / query

Sets the operation complete bit in the Standard Event Status Register when all pending device operations have finished. The *OPC? query places an ASCII "1" in the output queue when all pending operations are complete.

integer - Returns 1 when all pending device operations have completed.
*OPTset / query

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

string - Returns the option identification string in the format `0,0,<license info>`.
*OPT?
*RCLset / query

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

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

Places the instrument in a known state, equivalent to the factory default front-panel setup. It resets many acquisition, channel, display, time base, and trigger settings to their default values.

*RST
*SAVset / query

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

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

Sets the bits in the Service Request Enable Register, which controls which Status Byte Register bits can generate a service request. A one enables the corresponding bit and a zero disables it.

NameTypeValuesDescription
maskinteger0 - 255Mask value with bits defined by the Service Request Enable Register table.
*STBset / query

Returns the current value of the instrument's status byte. The MSS bit is reported on bit 6 instead of the RQS bit when queried with *STB?.

integer - The current status byte value.
*TRGset / query

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 and a non-zero value indicates failure.

integer - Self-test result: 0 indicates the test passed; non-zero indicates the test failed.
*WAIset / query

Waits for all pending commands to complete before continuing. In this oscilloscope, the command has no function and is parsed only for compatibility with other instruments.

:ACTivityset / query

Clears the cumulative edge variables for the next activity query. The query returns whether there has been edge activity on the digital channels since the last :ACTivity? query, along with the current logic levels.

string - Returns <edges>,<levels> where <edges> is the presence of edges and <levels> is the logical highs or lows for the digital channels.

:AERset / query

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

integer - Returns the Arm Event Register value.

:AUToscaleset / query

Evaluates the input signals and sets the correct conditions to display them, equivalent to pressing the front-panel Auto Scale key. If one or more sources are specified, those sources are enabled and all others are blanked.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | DIGital<d> | POD1 | POD2 | CHANnel<n>Input source to autoscale; may be repeated up to 5 times.
myScope.WriteString ":AUToscale" ' Same as pressing Auto Scale key.
:AUToscale:AMODEset / query

Specifies the acquisition mode that is set by subsequent :AUToscale commands. When NORMal is selected, autoscale sets the NORMal acquisition type and RTIMe mode; when CURRent is selected, the current acquisition type and mode are kept.

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

Specifies which channels will be displayed on subsequent autoscale operations. ALL autoscales all channels that meet the autoscale requirements; DISPlayed autoscales only channels that are turned on.

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 determine whether the probed signal is DC voltage, ground, or an active AC signal, while maintaining channel coupling for easier viewing of oscillating signals.

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

:BLANkset / query

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

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r>Source to blank.

:DIGitizeset / query

Causes the instrument to acquire waveforms according to the :ACQuire settings, then stop when the acquisition is complete. If no argument is given, it acquires the currently displayed channels; if none are displayed, it acquires all channels.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2}Source to acquire on DSO models.
sourceoptenumCHANnel<n> | DIGital<d> | POD{1 | 2} | BUS{1 | 2} | FUNCtion<m> | MATH<m> | SBUS{1 | 2}Source to acquire on MSO models.
myScope.WriteString ":DIGitize CHANnel1"

:HWEenableset / query

Sets the Hardware Event Enable register mask. Setting bit 12 enables PLL Locked hardware event reporting and can potentially generate an SRQ.

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

Returns the integer value contained in the Hardware Event Condition Register.

integer - The current value of the Hardware Event Condition Register.

Returns the integer value contained in the Hardware Event Event Register.

integer - The integer value contained in the Hardware Event Event Register.

:MTEenableset / query

Sets the Mask Test Event Enable register with a 16-bit integer mask. Setting selected bits enables bit 9 in the Operation Status Condition Register and may generate an SRQ interrupt.

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

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

integer - Integer value contained in the Mask Test Event Register.

:OPEEset / query

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

NameTypeValuesDescription
maskinteger0 - 3276715-bit integer mask to load into the Operation Status Enable register.

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

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

Reads and clears the integer value contained in the Operation Status Event Register.

integer - The current contents of the Operation Status Event Register, returned in NR1 format, then cleared.

:OVLenableset / query

Sets the overload event enable mask in the Overload Event Enable Register and enables reporting of the Overload Event Register. The mask is a 16-bit integer.

NameTypeValuesDescription
enable_maskinteger-16-bit integer enable mask representing input events to enable.

:OVLRegisterset / query

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

integer - Integer value of the Overload Event Register; 1 bits indicate overload or fault conditions by channel.

:PRINtset / query

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

NameTypeValuesDescription
print optionenumCOLor | GRAYscale | PRINter0 | PRINter1 | BMP8bit | BMP | PNG | NOFactors | FACTorsPrint format option; may be repeated up to 5 times.
:PRINt?query

Queries the printer/image transfer options used for pulling image data back over the bus for storage. This obsolete compatibility command is not a core command; the manual recommends :DISPlay:DATA instead.

NameTypeValuesDescription
optionsoptenumCOLor | GRAYscale | BMP8bit | BMPOne or more print options to apply, separated by commas.
block - Image data is returned over the bus for storage.

Returns the oscilloscope run state.

enum - Returns the run state.

:RUNset / query

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

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

:SERialset / query

Returns the serial number of the instrument.

string - The 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 channel, function, serial decode bus, or reference waveform location is displayed. The query applies to DSO or MSO source types as listed in the syntax.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r>Displayed source to check for visibility.
enum - Returns whether the specified source is 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 and then clears it. A one indicates a trigger has occurred; a zero indicates no trigger has occurred.

integer - Returns the Trigger Event Register as a 16-bit integer in NR1 format; the value is 1 or 0.

:VIEWset / query

Turns on the specified channel, function, serial decode bus, or reference waveform location. For MSO models, digital channels and pods are also valid sources; MATH<m> is an alias for FUNCtion<m>.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | SBUS{1 | 2} | WMEMory<r> | DIGital<d> | POD{1 | 2} | BUS{1 | 2}Source to display.
:VIEW CHANnel1

:ACQuire:AALiasset / query

Returns the current state of the oscilloscope acquisition anti-alias control. The control can be directly disabled or disabled automatically.

enum - Current anti-alias control state.

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

NameTypeValuesDescription
completeinteger100 - 100Completion criteria for the acquisition; only 100 is allowed.
:ACQuire:COMPlete 100
: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:DAALiasset / query

Sets the oscilloscope's disable anti-alias mode. DISable keeps anti-alias always disabled; AUTO lets the oscilloscope turn off anti-alias control as needed.

NameTypeValuesDescription
modeenumDISable | AUTODisable anti-alias mode setting.

Turns Digitizer mode on or off. In Digitizer mode, the user chooses the acquisition sample rate and memory depth instead of using automatic time/division-based settings.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets Digitizer mode to off or on.
:ACQuire:MODEset / query

Sets the oscilloscope acquisition mode. The available modes are real time, equivalent time, and segmented memory mode.

NameTypeValuesDescription
modeenumRTIMe | ETIMe | SEGMentedAcquisition mode to set.

Sets the desired acquisition memory depth. AUTO selects the oscilloscope's automatic mode, while a numeric value puts it into digitizer/manual mode with the specified number of points.

NameTypeValuesDescription
pointsintegerAUTODesired analog memory depth in integer NR1 format, or AUTO for automatic mode.
integer - Returns the number of data points that the hardware will acquire from the input signal.

Enables or disables automatic determination of the analog channel memory depth. ON uses the oscilloscope's automatic mode; OFF sets memory depth using :ACQuire:POINts[:ANALog].

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns automatic analog memory-depth determination on or off.
enum - Returns the automatic analog memory depth setting.
:ACQuire:RSIGnalset / query

Selects the 10 MHz reference signal mode. OFF disables the oscilloscope's 10 MHz REF BNC connector, OUT is used to synchronize the timebase of two or more instruments, and IN supplies a sample clock to the oscilloscope.

NameTypeValuesDescription
ref_signal_modeenumOFF | OUT | INSelects the 10 MHz reference signal mode.

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 in segmented acquisition mode. The query returns the current count setting.

NameTypeValuesDescription
countinteger2 - 1000Number of memory segments to acquire.
integer - Current count setting.

Sets the index into the acquired memory segments. The segmented memory acquisition mode must be enabled separately, and the query form returns the current segmented memory index setting.

NameTypeValuesDescription
indexinteger1 - 1000Index into the memory segments that have been acquired.

Sets the desired acquisition sample rate. AUTO puts the oscilloscope into Automatic mode; a numerical sample rate puts it into Digitizer mode with the desired rate.

NameTypeValuesDescription
rateenumAUTODesired acquisition sample rate or AUTO mode.

Enables or disables automatic determination of the analog channel sample rate. ON uses automatic mode based on the horizontal time/div setting; OFF sets the sample rate using :ACQuire:SRATe[:ANALog].

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables automatic analog sample rate determination.
:ACQuire:TYPEset / query

Selects the type of data acquisition to take place. The available acquisition types are normal, averaging, high-resolution, and peak detect.

NameTypeValuesDescription
typeenumNORMal | AVERage | HRESolution | PEAKAcquisition type to set.
:ACQuire:TYPE NORMal

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

Includes or excludes the selected digital bit in the definition for the specified bus. On MSO models only.

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFSelects whether the bit is included (1/ON) or excluded (0/OFF) 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 query returns the current bus bit definition.

NameTypeValuesDescription
channel_listchannel_list-List of digital channels or bit ranges affected by the command.
displayenum1 | ON | 0 | OFFSpecifies whether the selected channels are included or excluded from the bus definition.
channel_list - The bus bit definition as a channel list followed by the display state.
:BUS1:BITS (@1,2,4:9), ON
:BUS1:BITS (@1,5,7,9), ON
:BUS1:BITS (@1:15), ON
:BUS1:BITS (@1:5,8,14), ON
:BUS<n>:CLEarset / query

Excludes all digital channels from the selected bus definition. The bus number suffix <n> must be 1 or 2 and is attached to BUS.

NameTypeValuesDescription
ninteger1 - 2Bus number that identifies the bus affected by the command.
:BUS<n>:DISPlayset / query

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

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFEnables or disables the bus display.
enum - Returns the display value of the selected bus.
:BUS<n>:LABelset / query

Sets the specified bus label to a quoted ASCII string 10 characters or less. For MSO models only, the label is also added to the label list.

NameTypeValuesDescription
quoted_stringstring-Bus label as a quoted ASCII string up to 10 characters.
string - Returns the name of the specified bus as a quoted string.
myScope.WriteString ":BUS1:LABel 'Data'"
:BUS<n>:MASKset / query

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

NameTypeValuesDescription
maskinteger-32-bit mask value in decimal, nondecimal (#H or #B), or quoted hexadecimal string.

: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 into the instrument's non-volatile memory. The label may be used to record calibration dates or other information, and can be up to 32 characters long.

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

Sets the signal available on the rear-panel TRIG OUT BNC. The selected source can be trigger events, mask test failure indication, waveform generator sync output, or the raw trigger source.

NameTypeValuesDescription
signalenumTRIGgers | MASK | WAVEgen | WGEN1 | WGEN2 | TSOurceSelects the TRIG OUT source.

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

enum - Returns the calibration protect state.

Returns the summary results of the last user calibration procedure.

string - A comma-separated pair consisting of a status code and a status string summarizing the last user calibration.

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 in NR1 format as hour, minutes, and seconds.

Sets or queries the channel low-pass bandwidth limit. Values of 20E6 or lower enable 20 MHz bandwidth limiting; values above 20E6 disable bandwidth limiting and restore full bandwidth.

NameTypeValuesDescription
limitreal-Bandwidth limit value in NR3 format.
real - Returns the current setting of the low-pass filter, either 20E6 or the full bandwidth of the oscilloscope. When MAXimum is used, returns the oscilloscope's maximum possible full 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 | OFFSets the low-pass filter state.

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.
ninteger1 - # analog channelsChannel number in NR1 format.
enum - Returns the current coupling for the specified channel.

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 | OFFDisplay state to set for the specified channel.
ninteger1 - (# analog channels)Specifies the channel number in NR1 format.
enum - Current display setting for the specified channel.

Selects the input impedance setting for the specified analog channel.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTySets the input impedance to 1 MΩ or 50 Ω.

Selects whether to invert the input signal for the specified channel. The inversion may be enabled or disabled.

NameTypeValuesDescription
invert valueenum1 | ON | 0 | OFFSpecifies whether channel inversion is on or off.

Sets the analog channel label to the specified quoted ASCII string. Labels are limited to 32 characters; longer labels are truncated and the label is also added to the non-volatile label list.

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

Sets the vertical offset represented at center screen for the selected channel. If the requested value is outside the legal range, the instrument automatically sets it to the nearest legal value; legal values depend on the channel range, scale, and probe attenuation settings.

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

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

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

Sets the probe's quick-action button mode for N275xA InfiniiMode probes. The setting controls what the probe's quick-action button does when pressed, such as headlight control, InfiniiMode cycling, run/stop, single acquisition, autoscale, force trigger, or no action.

NameTypeValuesDescription
settingenumHEADlight | INFiniimode | RSTop | SINGle | CDISplay | AUToscale | FTRigger | QACTion | NACTion | NONEQuick-action button mode to assign to the probe.

Enables or disables External Scaling on the analog input channel. External Scaling can apply additional gain to the input channel to account for attenuators, adapters, and other probing-system components.

NameTypeValuesDescription
settingenum0 | OFF | 1 | ONEnables or disables External Scaling.
enum - Indicates whether External Scaling is enabled or disabled.

Sets the gain associated with External Scaling for the selected channel. The query returns the External Scaling gain setting.

NameTypeValuesDescription
gain_factorreal0.0001 - 1000Gain factor to set, expressed as a real number in NR3 format.
real - Returns the External Scaling gain setting as a gain factor in NR3 format.

Sets the vertical offset associated with External Scaling.

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

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

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number in NR1 format.
unitsenumVOLT | AMPereMeasurement units for the connected probe.
enum - Returns the current units setting for the specified channel.

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

NameTypeValuesDescription
head_paramenumSEND0 | SEND6 | SEND12 | SEND20 | DIFF0 | DIFF6 | DIFF12 | DIFF20 | DSMA | DSMA6 | NONEProbe head type and dB value to set.
enum - Current probe head type setting for the selected channel.

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

NameTypeValuesDescription
ninteger1 - (# analog channels)Specifies the oscilloscope channel number in NR1 format.
string - Unquoted ASCII string up to 11 characters identifying the probe type attached to the specified channel.

Sets the model number of the supported Tektronix probe for the specified channel. The query returns the current model number setting.

NameTypeValuesDescription
valueenumP5205 | P5210 | P6205 | P6241 | P6243 | P6245 | P6246 | P6247 | P6248 | P6249 | P6250 | P6251 | P670X | P671X | TCP202Model number of the supported Tektronix probe.
enum - Returns the model number setting.

Sets the N275xA InfiniiMode probe's mode for the specified channel. The query returns the probe mode setting.

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number in NR1 format.
settingenumDIFFerential | DOFFset | SEA | SEB | CMProbe mode to select.
enum - Returns the N275xA InfiniiMode probe's mode setting.

Sets the R-sense resistor value probed in the DUT when the N2820A high-sensitivity current probe is used with the N2825A user-defined R-sense head. The supported R-sense resistor values are from 1 ma9 to 1 Ma9.

NameTypeValuesDescription
valuereal1 ma9 - 1 Ma9Ohms value in NR3 format.
string - Returns the R-sense resistor value setting; returns "INF" when the N2820A high-sensitivity current probe is not attached, or the value of the special head when attached.

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

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number to configure.
skew valuereal-100 ns - +100 nsSkew time to apply to the selected channel.

Sets the channel probe signal type to differential or single-ended for 113xA Series probes, which determines how offset is applied. The command is valid only for the 113xA Series probes.

NameTypeValuesDescription
signal typeenumDIFFerential | SINGleSelects the probe signal type.

Specifies whether the selected probe cable uses the Zoom In waveform or the Zoom Out waveform when the N2820A high-sensitivity current probe is used with both the Primary and Secondary cables. The other cable uses the opposite waveform.

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number in NR1 format.
stateenum0 | OFF | 1 | ONSelects Zoom Out (0/OFF) or Zoom In (1/ON).
enum - Returns the zoom setting.

Clears (resets) the channel overload protection so the input can be used again in 50 Ω mode after an overload has been removed. The query returns the protection state for the selected channel.

NameTypeValuesDescription
ninteger1 - # analog channelsChannel number in NR1 format.
enum - Returns the input protection state for the channel: NORM if normal, or TRIP if an overload has been detected.

Defines the full-scale vertical axis range of the selected channel. If probe attenuation is changed, the programmed range is multiplied by the probe attenuation factor.

NameTypeValuesDescription
rangereal8 mV - 40 VVertical full-scale range value in NR3 format.
suffixoptenumV | mVOptional unit suffix appended to the range value.
myScope.WriteString ":CHANnel1:RANGe 8" ' Set the vertical range to
8 volts.

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

NameTypeValuesDescription
ninteger1 - (# analog channels)Channel number to select.
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 connected probe.
enum - Returns the current units setting for the specified channel.

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

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; use :CHANnel<n>:IMPedance instead.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyInput impedance setting for the specified channel.

Sets the probe sense mode for the specified channel. This is an obsolete compatibility command; the mode is controlled internally and a conflict error is generated if the requested setting does not match the oscilloscope's setting.

NameTypeValuesDescription
pmode valueenumAUTo | MANualProbe sense mode to set.
ninteger1 - (# analog channels)Channel number in NR1 format.

Automatically sets up the oscilloscope for the selected signal quality test and USB compliance test packets. It sets horizontal scale/delay, analog channel scale/offset, and trigger mode/level, then causes the oscilloscope to run.

Specifies the number of internal hubs between the host and the test point. For Near-end test type, you can specify 0 to 5 hubs; for Far-end test type, the number is set to 0.

NameTypeValuesDescription
numberinteger0 - 5Number of internal hubs in NR1 format.
integer - Returns the specified number of internal hubs.

Runs the selected USB signal quality test. The oscilloscope stops acquisitions if they are running, analyzes the data on screen, and displays the results; tests may take several minutes.

Specifies the analog input channel that probes the adjacent D+ or D- signal for USB compliance testing. For Device Full Speed Signal Quality it probes D+, and for Device Low Speed Signal Quality it probes D-.

NameTypeValuesDescription
sourcediscrete-Analog input channel to use as the adjacent signal probe.

Specifies the analog input channel whose differential probe is connected to the Hi-Speed signal to be tested.

NameTypeValuesDescription
sourcechannel_list-Analog input channel to use as the differential probe source.
channel_list - Returns the specified analog input channel.

Specifies the analog input channel that is probing the D- signal. On 4-channel oscilloscopes, different channel pairs must be used for the D+ and D- signals to achieve maximum sample rate.

NameTypeValuesDescription
sourcechannel_list-Analog input channel used for the D- signal.
channel_list - The specified analog input channel.

Specifies which analog input channel probes the USB D+ signal. On 4-channel oscilloscopes, different channel pairs must be used for the D+ and D- signals to achieve the maximum sample rate.

NameTypeValuesDescription
sourcechannel_list-Analog input channel assigned to probe the D+ signal.

Selects the USB signal quality test type to perform. The query returns the currently selected test type.

NameTypeValuesDescription
testenumDHSS | HHSS | DLSS | HLSS | DFSS | HFSSUSB signal quality test type to perform.
enum - Returns the selected signal quality test type.

Specifies the USB compliance test fixture connection type for a selected Hi-Speed test. Use DIFFerential for a differential probe or SINGleended for two single-ended SMA cables.

NameTypeValuesDescription
connectionenumSINGleended | DIFFerentialSpecifies the test fixture connection type.

Selects whether a Hi-Speed USB test is near-end or far-end when a Hi-Speed test has been selected. The query returns the selected test type.

NameTypeValuesDescription
typeenumNEARend | FARendSelects the USB test type.
enum - Returns the selected test type.

:COUNter:CURRentset / query

Returns the current counter value.

numeric - Current counter value in NR3 format.
:COUNter:ENABleset / query

Enables or disables the counter feature.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether the counter is enabled or disabled.
:COUNter:MODEset / query

Sets the counter mode. FREQuency selects cycles per second (Hz), and PERiod selects the signal cycle period.

NameTypeValuesDescription
modeenumFREQuency | PERiodCounter mode to set.
enum - Returns the current counter mode setting.
:COUNter:NDIGitsset / query

Sets the number of digits of resolution used for the frequency or period counter. The resolution is normally 5 digits and can be increased to 8 digits when a 10 MHz reference signal is applied.

NameTypeValuesDescription
valueinteger5 - 8Number of digits of resolution to use.
integer - Returns the currently set number of digits of resolution.
:COUNter:SOURceset / query

Selects the waveform source that the counter measures. You can choose an analog input channel or the trigger qualified event signal.

NameTypeValuesDescription
sourceenumCHANnel<n> | TQEVentWaveform source used by the counter.

:DEMO:FUNCtionset / query

Selects the type of demo signal. The allowed signal keywords include waveform, bus, and interface demo types such as SINusoid, AM, SPI, USBPd, and KEYSight.

NameTypeValuesDescription
signalenumSINusoid | NOISy | PHASe | RINGing | SINGle | AM | CLK | GLITch | BURSt | MSO | RUNT | TRANsition | RFBurst | SHOLd | LFSine | FMBurst | ETE | CAN | LIN | UART | I2C | SPI | I2S | CANLin | CXPI | ARINc | FLEXray | MANChester | MIL | MIL2 | USB | NMONotonic | DCMotor | HARMonics | COUPling | CFD | SENT | USBPd | KEYSightSpecifies the demo signal function to select.

Sets the phase shift of the second sine waveform for the phase-shifted sine demo signals. The value is specified in degrees from 0 to 360 in NR3 format.

NameTypeValuesDescription
anglereal0 - 360Phase shift angle for the second sine waveform.
:DEMO:OUTPutset / query

Specifies whether the demo signal output is ON (1) or OFF (0).

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns the demo signal output on or off.
:DEMO:OUTPut <on_off>
:DEMO:OUTPut?

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

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel number in NR1 format.
displayenum1 | ON | 0 | OFFTurns the digital display on or off.
enum - Returns the current digital display setting for the specified channel.

Sets the label for the specified digital channel, and stores the label in the non-volatile label list. The query returns the name of the specified channel.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel number in NR1 format.
stringstring10 charactersQuoted ASCII label string, 10 characters or fewer.
string - Label string for the specified channel.

Sets the position of the specified digital channel. This command is only valid for the MSO models.

NameTypeValuesDescription
positioninteger-Integer position of the specified channel.
:DIGital<d>:SIZEset / query

Sets the display size of the digital channels. The setting applies to all digital channels and is only valid for MSO models.

NameTypeValuesDescription
dinteger0 - # digital channels - 1Digital channel index in NR1 format.
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 and for displaying digital data as high or low; valid only on MSO models.

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

Turns annotation on or off for annotation item <n>. When on, the annotation appears in the upper left corner of the oscilloscope display.

NameTypeValuesDescription
settingenum1 | ON | 0 | OFFSets the annotation state.
ninteger1 - 10Annotation index in NR1 format.
enum - Returns the annotation setting.

Sets the background of annotation <n>. The query returns the specified annotation background mode.

NameTypeValuesDescription
ninteger1 - 10Annotation index.
modeenumOPAQue | INVerted | TRANsparentBackground mode for the annotation.
enum - The specified annotation background mode.

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

NameTypeValuesDescription
ninteger1 - 10Annotation number in NR1 format.
colorenumCH1 | CH2 | CH3 | CH4 | DIG | MATH | REF | MARKer | WHITe | REDAnnotation color.

Specifies the annotation text for display annotation n. The text can be up to 254 characters and may be cleared by sending an empty quoted string.

NameTypeValuesDescription
stringstring-Quoted ASCII annotation text, up to 254 characters.
string - Returns the specified annotation text; carriage returns are returned as actual ASCII carriage return characters (0x0D).

Sets the annotation's horizontal X1 position. The query returns the annotation's horizontal X1 position.

NameTypeValuesDescription
valueinteger0 - 800 - width of annotationHorizontal X1 position in NR1 format.
integer - The annotation's horizontal X1 position.

Sets the annotation's vertical Y1 position. The query returns the annotation's vertical Y1 position.

NameTypeValuesDescription
valueinteger0 - 480 - height of annotationVertical Y1 position in NR1 format.
ninteger1 - 10Annotation number in NR1 format.
integer - The annotation's vertical Y1 position.

Turns the display's backlight off or on.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether the display backlight is off or on.
: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. The image can be returned as 24-bit BMP, 8-bit BMP8bit, or 24-bit PNG in color or grayscale, and the data is returned as an IEEE-488.2 # binary block.

NameTypeValuesDescription
formatoptenumBMP | BMP8bit | PNGSelects the image format.
paletteoptenumCOLor | GRAYscaleSelects color or grayscale output.
arbitrary_block - Screen image data returned in IEEE-488.2 # binary block format.
:DISPlay:DATA? BMP, COLOR

Turns graticule (grid) axis labels on or off.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether graticule axis labels are enabled or disabled.
enum - Returns the graticule (grid) axis labels setting.

Sets the graticule (grid) intensity. The query returns the current graticule intensity setting.

NameTypeValuesDescription
valueinteger0 - 100Graticule intensity level in NR1 format.
integer - The graticule intensity setting.

Sets the graticule (grid) type. When TV trigger mode is selected and at least one displayed channel is scaled at 140 mV/div, the available grid types are FULL, MVOLt, and IRE.

NameTypeValuesDescription
typeenumFULL | MVOLt | IREGraticule grid type to select.
enum - Returns the current graticule (grid) type setting.

Sets the waveform intensity, equivalent to adjusting the front panel Intensity knob. The query returns the waveform intensity setting.

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

Turns the analog and digital channel labels on and off.

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 display label list in alphabetical order. Labels are stored as an ordered list of up to 75 newline-separated labels, each up to 32 characters; duplicate labels are not added.

NameTypeValuesDescription
binary block datablock-An ordered list of labels separated by newline characters.
:DISPlay:LABList <binary block data>
:DISPlay:LABList?
:DISPlay:MENUset / query

Changes the front panel softkey menu or turns it off. When off, channel setup information is displayed instead.

NameTypeValuesDescription
menuenumMASK | MEASure | SEGMented | LISTer | POWer | OFFFront panel softkey menu to display, or OFF to turn it off.

Sets the display persistence setting. Use MINimum for zero persistence, INFinite for infinite persistence, or a time value for variable persistence.

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:PERSistence:CLEar
:DISPlay:SIDebarset / query

Specifies which sidebar dialog to display on the screen.

NameTypeValuesDescription
sidebarenumSUMMary | CURSors | MEASurements | DVM | NAVigate | CONTrols | EVENts | COUNter | HISTogramSidebar dialog to display.

Enables or disables transparent mode for dialog box backgrounds in the front panel graphical user interface. The query returns the current transparent setting.

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

Turns vector display on or off. When vectors are turned on, the oscilloscope displays lines connecting sampled data points.

NameTypeValuesDescription
vectorsenum1 | ON | 0 | OFFSets the vector display state.
:DISPlay:VECTors <vectors>
:DISPlay:VECTors?
:DISPlay:CONNectset / query

Turns vectors on and off so the oscilloscope displays lines connecting sampled data points when enabled. This is an obsolete compatibility command; use :DISPlay:VECTors instead.

NameTypeValuesDescription
connectenum1 | ON | 0 | OFFTurns vector display on or off.
: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 that a channel is turned off.

string - An unquoted ASCII string containing the digital channel order in screen order, with one return value for each digital channel.
:DISPLAY:ORDER 0,10

:DVM:ARANgeset / query

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

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Selects whether Auto Range is off or on.
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, the query may briefly return +9.9E+37 until good results are available.

real - 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 | 1Sets whether DVM analysis is enabled or disabled.
:DVM:MODEset / query

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

NameTypeValuesDescription
dvm_modeenumACRMs | DC | DCRMsSelects the DVM display mode.
enum - Returns the 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 on in order for DVM measurements to be made.

NameTypeValuesDescription
sourcechannel_list-Selects the DVM input source channel.
:DVM:SOURce CHANnel1
:DVM:SOURce CHANnel2

Sets the external trigger low-pass filter setting. The command is provided for product compatibility; the only legal value is 0 or OFF. The query returns the current setting, which is always 0.

NameTypeValuesDescription
bwlimitenum0 | OFFSelects the external trigger bandwidth limit setting.
:EXTernal:PROBeset / query

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

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

Sets the full-scale range for the external trigger. This command is provided for product compatibility; with 1:1 probe attenuation, the range is either 1.6 V or 8 V and is automatically recalculated when external trigger probe attenuation changes.

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

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

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

Controls the external probe sense mode for compatibility with previous oscilloscopes. The setting is internally determined; if the sent mode matches the oscilloscope's setting the command is accepted, otherwise a setting conflict error is generated.

NameTypeValuesDescription
pmode valueenumAUTo | MANualProbe sense mode value.

:FRANalysis:DATAset / query

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

NameTypeValuesDescription
modeoptenumSWEep | SINGleSelects whether to get data from a sweep or single-frequency analysis.
binary_block - Comma-separated data with newlines at the end of each row.

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

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

Selects between normal swept frequency response analysis and analysis at a single frequency. The query returns the current frequency mode setting.

NameTypeValuesDescription
settingenumSWEep | SINGleSelects the frequency analysis mode.
enum - Returns the frequency mode setting.

Sets the single frequency value for frequency response analysis. The setting is displayed on a log-scale Bode plot and may use the minimum frequency of 20 Hz or decade values.

NameTypeValuesDescription
valuereal20 - 10000000Single frequency value to set.
suffixoptenumHz | kHz | MHzOptional frequency unit suffix.
real (Hz) - Returns the single frequency setting.
:FRANalysis:FREQuency:SINGle <value>[suffix]
:FRANalysis:FREQuency:SINGle?

Sets the frequency sweep start value for frequency response analysis. The start value can be chosen from decade values, with an optional frequency suffix.

NameTypeValuesDescription
valueinteger20 - 10000000Frequency sweep start value.
suffixoptenumHz | kHz | MHzOptional frequency suffix.
integer - Returns the frequency sweep start setting.

Sets the frequency sweep stop value for frequency response analysis. The log-scale Bode plot allows decade values in addition to the maximum frequency of 20 MHz.

NameTypeValuesDescription
valueinteger100 - 20000000Frequency sweep stop value to set.
suffixoptenumHz | kHz | MHzOptional unit suffix for the stop value.
:FRANalysis:FREQuency:STOP <value>[suffix]
:FRANalysis:FREQuency:STOP?

Specifies the number of points per decade in the frequency response analysis. The query returns the current points-per-decade setting.

NameTypeValuesDescription
valueinteger10 - 100Points per decade setting.
integer - Current points per decade setting.
:FRANalysis:RUNset / query

Performs the Frequency Response Analysis, sweeping a sine wave across a frequency range while measuring the DUT input and output. The alias :FRANalysis:APPLy is also valid for this command.

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

NameTypeValuesDescription
sourcediscrete-Analog input channel to use as the probing input.
channel_list - The currently selected channel probing the input voltage.

Selects the analog input channel that probes the DUT output voltage for frequency response analysis.

NameTypeValuesDescription
sourceenumCHANnel<n>Analog input channel used to probe the output voltage.
enum - Returns the currently selected channel probing the output voltage.

Specifies the number of points in the frequency response analysis. Depending on the number of points specified and the number of decades in the frequency range, this command can also change the :FRANalysis:PPDecade setting.

NameTypeValuesDescription
pointsinteger1 - 1000Number of points in the frequency response analysis.
integer - Returns the points setting.

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

NameTypeValuesDescription
selectionenumNONE | ALL | GAIN | PHASeSelects which response data to include; the command also allows a second value of GAIN or PHASe to specify a gain/phase combination.

Selects the expected output load impedance for the waveform generator. This setting lets the display show correct amplitude and offset levels for the selected load.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.

Sets the waveform generator's output sine wave amplitude. When amplitude profile is on, the optional range specifies the initial ramp amplitude at the frequency setting. The query returns the currently specified waveform generator amplitude, or the initial ramp amplitude for the specified frequency when amplitude profile is on.

NameTypeValuesDescription
amplituderealVAmplitude in volts, in NR3 format.
rangeoptenumF20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZFrequency range used when amplitude profile setting is on.
real (V) - Amplitude in volts in NR3 format.

Enables or disables voltage profile mode, which allows amplitude ramping within different decades. The query returns the current voltage profile setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns voltage profile off or on.
enum - Returns the voltage profile setting.

Sets the number of waveforms to be averaged together for math function <m>. The number of averages can be set from 2 to 65536 in increments of powers of 2.

NameTypeValuesDescription
countinteger2 - 65536Number of waveforms to average together.

Selects the clock signal source for the Chart Logic Bus State operation. The query returns the currently selected 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 setting.
enum - Returns the clock edge setting.

Specifies the value associated with each increment in Chart Logic Bus data. The query returns that value.

NameTypeValuesDescription
minteger1 - # math functionsSelects the math function number in NR1 format.
valuenumeric-Value per bus code in NR3 format.
numeric - Returns the value associated with each increment in Chart Logic Bus data.

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

NameTypeValuesDescription
minteger1 - # math functionsFunction index in NR1 format.
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 the Chart Logic Bus operations.
enum - Returns the Chart Logic Bus vertical units.

Clears the number of evaluated waveforms when :FUNCtion<m>:OPERation is AVERage, MAXHold, or MINHold.

Turns the selected math function display on or off. When ON is selected, the function operates as specified by the other :FUNCtion<m> commands; if one math function is turned on, any previously displayed math function is turned off.

NameTypeValuesDescription
minteger1 - (# math functions)Math function index in NR1 format.
displayenum1 | ON | 0 | OFFTurns the function display on or off.

Returns the FFT Bin Size setting for the selected function. The query applies to :FUNCtion<m>[:FFT] and reports the bin size in Hz.

real (Hz) - The FFT bin size setting.

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

NameTypeValuesDescription
frequencyreal-25 GHz - 25 GHzThe current center frequency to set, in NR3 format.
real (Hz) - Returns the current center frequency in Hertz.

Specifies the maximum number of points the FFT detector decimates to, which is also the number of buckets used before detection-type reduction is applied. The minimum is 640 points and the maximum is 64K, the measurement record limit.

NameTypeValuesDescription
number_of_bucketsinteger640 - 64KMaximum number of FFT detector points to decimate to.
integer - Returns the FFT detector points setting.

Sets the FFT detector decimation type for function m. The detector type controls how sampled FFT points are reduced into detector points.

NameTypeValuesDescription
typeenumOFF | SAMPle | PPOSitive | PNEGative | NORMal | AVERageFFT detector type to use.

Sets the start frequency for the FFT math function's displayed range. The start frequency can also be set with the FFT center and span commands.

NameTypeValuesDescription
frequencyrealHzThe start frequency in NR3 format.

Sets the FFT math function's displayed stop frequency. The FFT displayed range can also be set with :FUNCtion<m>[:FFT]:CENTer and :FUNCtion<m>[:FFT]:SPAN.

NameTypeValuesDescription
frequencyrealHzThe stop frequency.
real (Hz) - Returns the current stop frequency in Hertz.

Specifies whether FFT is performed on the Main time base window or the ZOOM window when zoomed time base is displayed.

NameTypeValuesDescription
minteger1 - 4Function number in NR1 format.
gatingenumNONE | ZOOMSelects the time base window used for the FFT.
enum - Returns the gate setting.

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

NameTypeValuesDescription
ref_pointenumTRIGger | DISPlayReference point used for FFT Phase calculations.
enum - Returns the selected reference point.

Queries the Resolution Bandwidth setting for the FFT.

real (Hz) - The FFT resolution bandwidth setting.

Selects the FFT readout type for the specified function and readout number. The query returns the current readout selection.

NameTypeValuesDescription
readout_typeenumSRATe | BSIZe | RBWidthSelects which FFT readout type to display.
minteger1 - 4Function number in NR1 format.
ninteger1 - 2Readout number in NR1 format; 2 is valid only on oscilloscopes that have the dedicated FFT function.
enum - Returns the readout selection.

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

NameTypeValuesDescription
minteger1 - (# math functions)Math function index in NR1 format.
spanreal1 Hz - 100 GHzCurrent frequency span in NR3 format.
real (Hz) - The current frequency span in NR3 format, in Hertz.

Returns the Sample Rate setting for the FFT.

real (Hz) - Sample rate in Hz, returned in NR3 format.

Specifies the FFT vertical units for a math function. For FFT magnitude, DECibel corresponds to logarithmic display and VRMS to linear display; for FFT phase, DEGRees or RADians are available.

NameTypeValuesDescription
minteger1 - (# math functions)Math function index in NR1 format.
unitsenumDECibel | VRMS | DEGRees | RADiansFFT vertical units. DECibel and VRMS apply to FFT magnitude; DEGRees and RADians apply to FFT phase.

Selects the FFT windowing transform used for :FUNCtion<m>:FFT. The available windows are rectangular, Hanning, Flat top, Blackman-Harris, and Bartlett; HANNing is the default window.

NameTypeValuesDescription
minteger1 - # math functionsMath function index in NR1 format.
windowenumRECTangular | HANNing | FLATtop | BHARris | BARTlettFFT windowing transform to apply.

Sets the center frequency of the band-pass filter. The query returns the band-pass filter's center frequency setting.

NameTypeValuesDescription
center_freqreal-Center frequency of the band-pass filter in NR3 format.
real - The band-pass filter's center frequency setting.

Sets the frequency width of the band-pass filter. The width specifies the filter's -3 dB cutoff frequencies (center frequency minus half the width and center frequency plus half the width).

NameTypeValuesDescription
freq_widthreal-Frequency width of the band-pass filter in NR3 format.
real - Returns the band-pass filter's frequency width setting.

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

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

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

NameTypeValuesDescription
3dB_freqreal--3 dB cutoff frequency value in NR3 format.
real - Returns the low-pass filter's cutoff frequency.

Sets the Initial Condition of the Integrate math function waveform. ON vertically centers the waveform on the screen; OFF starts it at the zero-level reference on the left side of the screen.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONInitial Condition setting for the Integrate math function waveform.

Sets the DC offset correction factor for the integrate math waveform input signal. This correction lets you level a ramped waveform.

NameTypeValuesDescription
input_offsetreal-DC offset correction in NR3 format.

Specifies the 'A' value in the Ax + B operation for the selected math function. The query returns the gain value.

NameTypeValuesDescription
valuereal-The 'A' value in Ax + B, in NR3 format.
real - The gain value ('A' in Ax + B), in NR3 format.

Specifies the B value in the Ax + B operation for function m. The query returns the offset value.

NameTypeValuesDescription
minteger1 - (# math functions)Function index in NR1 format.
valuereal-B value in the Ax + B operation, in NR3 format.
real - Returns the offset value B in the Ax + B operation.

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

NameTypeValuesDescription
offsetreal-The value at center screen in NR3 format.
real - Returns the current offset value for the selected function.

Sets the desired waveform math operator, transform, filter, or visualization for function <m>. The query returns the current operation for the selected function.

NameTypeValuesDescription
operationenumADD | SUBTract | MULTiply | DIVide | DIFF | INTegrate | FFT | FFTPhase | SQRT | MAGNify | ABSolute | SQUare | LN | LOG | EXP | TEN | LOWPass | HIGHpass | BANDpass | AVERage | SMOoth | ENVelope | LINear | MAXimum | MINimum | PEAK | MAXHold | MINHold | TRENd | BTIMing | BSTate | SERChartDesired math operation or visualization to apply to function <m>.
enum - Returns the current operation for the selected function.

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

NameTypeValuesDescription
minteger1 - (# math functions)Selects the math function index in NR1 format.
rangereal-Full-scale vertical axis value in NR3 format.
real - Current full-scale range value for the selected function.

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

NameTypeValuesDescription
minteger1 - # math functionsSelects the math function number in NR1 format.
levelreal-Current reference level in NR3 format.

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

NameTypeValuesDescription
scale valuereal-Vertical units per division value in NR3 format.
suffixoptenumV | dBOptional unit suffix for the scale value.

Sets the serial bus source for the Chart Serial Signal math function. The query returns the current serial bus source.

NameTypeValuesDescription
serialbusenumSBUS<n>Serial bus source to select.
enum - Returns the serial bus source.

Sets the time mode for the Chart Serial Signal math function. MAIN plots signal data per acquisition on the normal time scale; ROLL plots data at the right side of the display and rolls it across the screen.

NameTypeValuesDescription
valueenumMAIN | ROLLTime mode to use for the Chart Serial Signal math function.
enum - Returns the current time mode setting.

Sets the full-scale time range for the Chart Serial Signal math function when ROLL serial chart time mode is selected. The time range controls the width across the display for the charted serial signal waveform.

NameTypeValuesDescription
minteger1 - (# math functions)Math function index in NR1 format.
range_valuereal-Time range value in NR3 format.
real - Returns the time range setting.

Sets the time offset for the Chart Serial Signal math function when ROLL serial chart time mode is selected. The query returns the current time offset setting.

NameTypeValuesDescription
minteger1 - (# math functions)Math function index in NR1 format.
offsetreal-Time offset value in NR3 format.
real - Returns the time offset setting.

Sets the number of smoothing points used when :FUNCtion<m>:OPERation is SMOoth. The number of points must be an odd integer, from 3 up to half of the measurement record or precision analysis record.

NameTypeValuesDescription
pointsinteger3 - half of the measurement record or precision analysis recordOdd integer number of smoothing points to use.

Selects the first source for the operator math functions, or the single source for transform, filter, or visualization functions. For TRENd, the command is invalid because TRENd operates on a measurement rather than a source waveform.

NameTypeValuesDescription
valueenumCHANnel<n> | FUNCtion<c> | MATH<c> | WMEMory<r> | BUS<b>Source to use for the function operation.

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

NameTypeValuesDescription
valueenumCHANnel<n> | WMEMory<r> | NONESecond source for the math operation.

Selects the measurement whose trend is shown in the math waveform. The query returns the selected installed measurement, or NONE if no measurements are installed.

NameTypeValuesDescription
MEAS<n>integer1 - 10Specifies the location of the installed measurement whose trend you want to analyze.
enum - Returns the selected measurement location as MEAS<n>, or NONE if no measurements are installed.

:HARDcopy:AREAset / query

Controls what part of the display area is printed. Currently, 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-Selects the active printer by list index or printer name.
string - Name of the active printer.

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

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

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

NameTypeValuesDescription
ffeedenumOFF | 0 | ON | 1Selects whether a formfeed is output between the screen image and factors of a 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 to set.
enum - Returns the 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.

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

Sets the Windows network domain name for hardcopy network printing. The domain name setting is common to both network printer slots.

NameTypeValuesDescription
domainstring-Quoted ASCII string specifying the Windows network domain name.
string - Returns the current Windows network domain name.

Sets the password for the specified Windows network domain and user name. The password setting is common 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 for both network printer slots.

NameTypeValuesDescription
usernamestring-Quoted ASCII string user name.
string - Returns the currently set user name.

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

NameTypeValuesDescription
paletteenumCOLor | GRAYscale | NONEHardcopy palette color to use.

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

string - A list of printer specifications in the form <index>,<active>,<name>; for each available printer.

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

NameTypeValuesDescription
destinationenumCENTronics | FLOPpySelects the hardcopy destination.

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

NameTypeValuesDescription
stringstring-Quoted ASCII string filename to use for hardcopy output.

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

NameTypeValuesDescription
grayenumOFF | 0 | ON | 1Selects whether grayscaling is enabled for the hardcopy dump.

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

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

Sets the hardcopy printer driver used for the selected printer. If the correct driver for the selected printer can be identified, it will be selected and cannot be changed.

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.

Reads and returns screen image data in the selected format. The query supports an optional format selector and returns the image as IEEE-488.2 # binary block data.

NameTypeValuesDescription
formatoptenumPNG | BMP | BMP8bitSelects the screen image data format to return.
block - Screen image data returned in IEEE-488.2 # binary block format.

Sets the screen image data format. The setting persists through power cycling but is reset to PNG by *RST.

NameTypeValuesDescription
formatenumPNG | BMP | BMP8bitSpecifies the screen image data format.

:HISTogram:AXISset / query

Sets the orientation of the histogram when :HISTogram:MODE is WAVeform. In MEASurement mode, histograms are always displayed horizontally.

NameTypeValuesDescription
axisenumVERTical | HORizontalSpecifies the histogram orientation.
:HISTogram:AXIS <axis>
:HISTogram:AXIS?

Turns the histogram display on or off.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns the histogram display on or off.
enum - Returns the current display setting for the histogram.

Selects which installed measurement slot is used for histogram analysis when :HISTogram:MODE is MEASurement. The query returns the currently selected measurement location.

NameTypeValuesDescription
MEAS<n>integer1 - 10Specifies the location of the installed measurement to analyze.
enum - Returns the selected measurement slot as MEAS<n>.
:HISTogram:MODEset / query

Selects the histogram mode or disables histogram analysis. The query returns the currently set histogram mode.

NameTypeValuesDescription
modeenumOFF | WAVeform | MEASurementSelects the histogram type or turns histogram analysis off.
enum - Returns the currently set histogram mode.
:HISTogram:SIZEset / query

Specifies the number of divisions the histogram bar graph should use. For horizontal histograms, whole and half divisions from 1 to 4 are allowed; for vertical histograms, whole and half divisions from 1 to 5 are allowed.

NameTypeValuesDescription
sizereal1.0 - 5.0Number of divisions for the histogram bar graph.
real - Returns the number of divisions currently used for the histogram bar graph.
:HISTogram:TYPEset / query

Selects either a waveform histogram (horizontal or vertical) or a measurement histogram. The query returns the currently selected histogram type.

NameTypeValuesDescription
typeenumVERTical | HORizontal | MEASurementHistogram type to select.
enum - Returns the currently selected histogram type.

Sets the histogram limits window's bottom boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's vertical units.

NameTypeValuesDescription
limitreal-Bottom value in NR3 format.

Sets the histogram limits window's left boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's horizontal units.

NameTypeValuesDescription
limitreal-Left value in NR3 format.

Sets the histogram limits window's right boundary when :HISTogram:MODE is WAVeform. The units are the same as the input waveform's horizontal units.

NameTypeValuesDescription
limitreal-Right value in NR3 format.
real - Returns the histogram limits window's right boundary.

Specifies the waveform used as the histogram source when :HISTogram:MODE is WAVeform. The query returns the currently specified waveform histogram source.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | CGRadeSelects the waveform source for the histogram window.
enum - The currently specified waveform histogram source.

Sets the top boundary of the histogram limits window when :HISTogram:MODE is WAVeform. The value uses the input waveform's vertical units.

NameTypeValuesDescription
limitreal-Top value in NR3 format.
real - Returns the histogram limits window's top boundary.

:LISTer:DATAset / query

Returns the lister data.

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

Configures which serial buses are displayed in the Lister, or turns the Lister display off. When set to ALL, decode information for different buses is interleaved in time.

NameTypeValuesDescription
valueenumOFF | 0 | SBUS1 | ON | 1 | SBUS2 | 2 | ALLSelects the Lister display setting.

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

:LTESt:COPYset / query

For the measurement selected by :LTESt:MEASurement, sets the upper and lower limits to the last measurement result plus or minus a percent margin.

:LTESt:COPY:ALLset / query

Sets the upper and lower limits for all measurements whose limits are being tested to the last measurement result plus or minus a percent margin. It performs the :LTESt:COPY operation on all measurements whose limits are being tested.

Sets the percent margin used when copying measurement results to upper and lower limits for the measurement selected by :LTESt:MEASurement. The query returns the current percent margin setting.

NameTypeValuesDescription
percentreal-Copy margin percent in NR1 format.
real - Returns the percent margin setting for the measurement selected by :LTESt:MEASurement.
:LTESt:ENABleset / query

Turns the measurement limit test feature on or off.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables the measurement limit test feature.
:LTESt:FAILset / query

Sets the fail condition for the active measurement currently selected by :LTESt:MEASurement. When a measurement failure is detected by the limit test, the specified fail action conditions are executed.

NameTypeValuesDescription
conditionenumINSide | OUTSideFail condition for the measurement; INSide fails when results are within the limit parameters, OUTSide fails when results exceed the limit parameters.
:LTESt:LLIMitset / query

Sets the lower test limit for the active measurement currently selected by :LTESt:MEASurement. The query returns the current lower limit setting.

NameTypeValuesDescription
lower_valuereal-Lower test limit value in NR3 format.
real - Current lower limit setting.

Selects the measurement source used by :LTESt:FAIL, :LTESt:LLIMit, :LTESt:ULIMit, and :LTESt:TEST. The selected source is one of the active measurements by number.

NameTypeValuesDescription
MEAS<n>integer1 - 10Number of the installed measurement to select.
:LTESt:RESultsset / query

Queries the measurement results for a selected installed measurement. When :LTESt:TEST is ON, it returns the failed minimum value, failed maximum value, and total number of measurements made; when :LTESt:TEST is OFF, it returns nothing.

NameTypeValuesDescription
MEAS<n>optinteger1 - 10Selects the installed measurement number.
numeric - Returns <fail_min>, <fail_max>, and <num_meas> as three real numbers: the number of measurements that failed the minimum limit, the number that failed the maximum limit, and the total number of measurements made.

Enables or disables the limit test "stop on failure" option. When ON, the oscilloscope acquisition system stops once a limit failure is detected.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the stop-on-failure state.
enum - Returns the current "stop on failure" setting.
:LTESt:TESTset / query

Enables or disables the limit test function for the active measurement selected by :LTESt:MEASurement. When any measurement has its limit test enabled, the overall Limit Test feature is enabled.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables the limit test function.
:LTESt:TEST {{0 | OFF} | {1 | ON}}
:LTESt:TEST?
:LTESt:ULIMitset / query

Sets the upper test limit for the active measurement selected by :LTESt:MEASurement. The query returns the current upper limit setting.

NameTypeValuesDescription
upper_valuereal-Upper test limit value in NR3 format.
real - Current upper limit setting.

:MARKer:DYDXset / query

Returns the cursor ∆Y/∆X value. X cursor units are set by :MARKer:XUNits; if the front-panel cursors are off, the marker position values are not defined.

real - Returns the cursor ∆Y/∆X value in NR3 format.
:MARKer:MODEset / query

Sets the cursors mode. OFF removes cursor information from the display; MANual, MEASurement, WAVeform, BINary, and HEX select the corresponding cursor behaviors.

NameTypeValuesDescription
modeenumOFF | MEASurement | MANual | WAVeform | BINary | HEXSelects the cursor mode.

Specifies whether the X1 cursor is displayed.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the X1 cursor display state.

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

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

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

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

Specifies whether the X2 cursor is displayed. The query returns the X2 cursor display setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns X2 cursor display off or on.
enum - Returns the X2 cursor display setting.

Sets the X2 cursor position to the specified value. The command sets :MARKer:MODE to MANual if it is not currently set to WAVeform.

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

Sets the source for the cursors. If the marker mode is not currently WAVeform, sending this command puts the cursors in MANual mode and sets both marker pairs to the same source.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | HISTogramSource for the cursors.
enum - Returns the current source for the cursors; returns NONE if all channels are off or if :MARKer:MODE is set to OFF. FUNC is returned if the source is FUNCtion or MATH.
:MARKer:XDELtaset / query

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

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

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

NameTypeValuesDescription
unitsenumSEConds | HERTz | DEGRees | PERCentX cursor units to use for time, frequency, phase, or ratio measurements.
enum - Returns the current X cursors units.

Sets the current X1 and X2 reference locations for marker X units when :MARKer:XUNits is DEGRees or PERCent. After the locations are set, :MARKer:X1Position, :MARKer:X2Position, and :MARKer:XDELta inputs and outputs are relative to those locations.

Specifies whether the Y1 cursor is displayed. The query returns the Y1 cursor display setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the Y1 cursor display state.
enum - Returns the Y1 cursor display setting.

Sets the Y1 cursor position in NR3 format. If :MARKer:MODE is not currently WAVeform, the command sets :MARKer:MODE to MANual and updates the cursor position; Y cursor units are set by :MARKer:YUNits.

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

Specifies whether the Y2 cursor is displayed. The query returns the Y2 cursor display setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONWhether the Y2 cursor is displayed.
enum - The Y2 cursor display setting.

Sets the Y2 cursor position in NR3 format and can optionally include a 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 when mode is WAVeform.

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

Returns the value difference between the current Y1 and Y2 cursor positions. Ydelta is calculated as the value at Y2 cursor minus the value at Y1 cursor.

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

Sets the Y cursors units. BASE uses the units associated with the cursor source; PERCent is for ratio measurements.

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

When :MARKer:YUNits is set to PERCent, this command sets the current Y1 location as 0 percent and the current Y2 location as 100 percent. Afterward, :MARKer:Y1Position, :MARKer:Y2Position, and :MARKer:YDELta use those locations as their reference.

:MEASure:ALLset / query

Installs a Snapshot All measurement on the screen.

:MEASure:AREaset / query

Installs an area measurement on screen. The optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval to use.
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source waveform.
real (V·s) - Returns the area value in volt-seconds.
:MEASure:BRATeset / query

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

NameTypeValuesDescription
sourceoptdiscrete-Selects the measurement source.
real (Hz) - The bit rate value in Hertz.
:MEASure:BWIDthset / query

Installs a burst width measurement on screen. If no source is specified, the current measurement source is used; the command is not available when the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to use for the burst width measurement.
:MEASure:CLEarset / query

Clears all selected measurements and markers from the screen.

:MEASure:COUNterset / query

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

NameTypeValuesDescription
sourceoptenumDIGital<d> | CHANnel<n> | EXTernalSource used for the counter measurement.
real (Hz) - Counter frequency of the specified source, in hertz.
:MEASure:DEFineset / query

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

NameTypeValuesDescription
meas_specenumDELay | THResholdsSelects whether the command defines delay measurement setup or threshold setup.
sourceoptchannel_list-Specifies the measurement source channel, function, math trace, or reference waveform.
:MEASure:DEFine DELay,<delay spec>[,<source>]
:MEASure:DEFine THResholds,<threshold spec>[,<source>]
:MEASure:DEFine? <meas_spec>[,<source>]
:MEASure:DELayset / query

Places the instrument in continuous measurement mode and starts a delay measurement between two sources. The delay is measured as the time difference between the selected edges, with edge selection controlled by <edge_select_mode> and :MEASure:DELay:DEFine settings.

NameTypeValuesDescription
edge_select_modeoptenumMANual | AUTOSelects how source edges are chosen for the delay measurement.
source1optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d>First measurement source.
source2optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d>Second measurement source.
real (s) - Floating-point number delay time in seconds.

Defines the slope directions, edge numbers, and edge position parameters used for delay measurements. The query returns the currently specified delay measurement parameter definitions.

NameTypeValuesDescription
source1_edge_slopeenumRISing | FALLingSlope direction for source 1.
source1_edge_numberinteger0 - 1000Edge number for source 1, in NR1 format.
source1_edge_thresholdenumLOWer | MIDDle | UPPerEdge threshold position for source 1.
source2_edge_slopeenumRISing | FALLingSlope direction for source 2.
source2_edge_numberinteger0 - 1000Edge number for source 2, in NR1 format.
source2_edge_thresholdenumLOWer | MIDDle | UPPerEdge threshold position for source 2.
string - Returns the specified delay measurement parameter definitions in the order source1 edge slope, source1 edge number, source1 edge threshold, source2 edge slope, source2 edge number, and source2 edge threshold.

Installs a dual charge measurement on screen. If optional source parameters are provided, the currently specified sources are modified; the interval defaults to DISPlay when omitted.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval: an integral number of cycles or the full screen.
source1optchannel_list-First measurement source, specified as CHANnel<n> with an N2820A probe connected.
source2optchannel_list-Second measurement source, specified as CHANnel<n> with an N2820A probe connected.

Installs a screen measurement and starts a vertical amplitude measurement for the selected waveform. If optional source parameters are specified, the currently specified source(s) are modified.

NameTypeValuesDescription
source1optchannel_list-First measurement source channel, requiring an N2820A probe connected.
source2optchannel_list-Second measurement source channel, requiring an N2820A probe connected.
real - Returns the vertical amplitude of the selected waveform in NR3 format.

Installs a screen measurement and starts an average value measurement using the specified interval and optional sources. If no interval is specified, DISPlay is implied.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlaySpecifies the measurement interval as either an integral number of cycles or the full screen.
source1optchannel_list-First source channel, using CHANnel<n> with an N2820A probe connected.
source2optchannel_list-Second source channel, using CHANnel<n> with an N2820A probe connected.
real - Returns the calculated average value measurement in NR3 format.

Installs a screen measurement and starts a waveform base value measurement. If optional source parameters are specified, the currently specified source(s) are modified.

NameTypeValuesDescription
source1optchannel_list-First source channel for the measurement.
source2optchannel_list-Second source channel for the measurement.
real - Returns the vertical value at the base of the waveform, in NR3 format.

Installs a screen measurement and starts a vertical peak-to-peak measurement. If optional source parameters are specified, the currently specified sources are modified.

NameTypeValuesDescription
source1optchannel_list-First measurement source, a CHANnel<n> input with an N2820A probe connected.
source2optchannel_list-Second measurement source, a CHANnel<n> input with an N2820A probe connected.

Installs a screen measurement and starts an RMS value measurement using the specified interval, type, and optional probe sources. On query, it measures and outputs the RMS value measurement.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlaySpecifies the measurement interval as either an integral number of cycles or the full screen.
typeoptenumAC | DCSelects AC RMS or DC RMS measurement.
source1optdiscrete-Optional first measurement source channel.
source2optdiscrete-Optional second measurement source channel.
real - Calculated dc RMS value in NR3 format.

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

NameTypeValuesDescription
sourceoptchannel_list-Selects the signal source for the duty cycle measurement. Valid sources include digital channels, analog channels, math functions, and reference waveforms.

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

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

Installs an FFT analysis Adjacent Channel Power Ratio (ACPR) measurement on screen. The query returns the measured ACPR value.

NameTypeValuesDescription
chan_widthrealHzWidth of the main range and sideband channels.
chan_spacingrealHzSpacing between the main range and sideband channels.
chanenumCENTer | HIGH<sb> | LOW<sb>Selects the sideband to measure.
sourceoptenumFUNCtion<m> | MATH<m> | FFTFFT waveform source used for the measurement.
real (dBV) - Adjacent channel power ratio (ACPR) value.

Installs an FFT analysis Channel Power measurement on screen. The FFT center frequency defines the measurement center, and the FFT span defines the frequency range.

NameTypeValuesDescription
sourceoptenumFUNCtion<m> | MATH<m> | FFTFFT waveform source used for the measurement.
real (dBV) - Measured Channel Power value in dBV, returned in NR3 format.
:MEASure:FFT:OBWset / query

Installs an FFT analysis Occupied Bandwidth measurement on screen. Occupied bandwidth measures the frequency range containing a specified percentage of the total spectral power.

NameTypeValuesDescription
percentagereal-Percent of spectral power occupied bandwidth is measured for, in NR3 format.
sourceoptenumFUNCtion<m> | MATH<m> | FFTFFT waveform source.
real (Hz) - Occupied bandwidth value in Hz, in NR3 format.
:MEASure:FFT:THDset / query

Installs an FFT analysis Total Harmonic Distortion measurement on screen. The measurement can track the fundamental frequency automatically or manually, and the source must be an FFT waveform.

NameTypeValuesDescription
trackingenumAUTO | MANualSelects automatic or manual tracking of the fundamental frequency and harmonics.
fundamental_freqoptreal-Fundamental frequency in NR3 format; required when tracking is MANual.
sourceoptenumFUNCtion<m> | MATH<m> | FFTSelects the FFT waveform source.

Installs a screen frequency measurement and starts measuring frequency. 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<m> | MATH<m> | WMEMory<r>Measurement source to use.

Returns the sum of all hits in all bins (buckets) in the histogram.

numeric - # of total hits in NR1 format

Returns the percentage of histogram hits that lie within ±1 standard deviation of the mean.

real (%) - Percentage of histogram hits within +/-1 standard deviation, in NR3 format.

Returns the percentage of histogram hits that lie within ±2 standard deviations of the mean.

real (%) - Percentage of hits within +/-2 std devs in NR3 format.

Returns the percentage of histogram hits that lie within ±3 standard deviations of the mean.

real (%) - % of hits within +/-3 std devs in NR3 format

Returns the value corresponding to the maximum bin that has any hits.

real - Value of max bin in NR3 format.

Returns the value corresponding to the minimum bin that has any hits.

real - Value of the minimum bin that has any hits, in NR3 format.

Returns the mode value of the histogram.

string - Mode of histogram in NR3 format.

Returns the maximum number of hits in any single bin.

integer - # of hits in max bin in NR1 format

Returns the delta between the Max and Min values from the histogram. The query returns the delta value between max bin and min bin in NR3 format.

real - Delta value between max bin and min bin in NR3 format.

Returns the standard deviation of the histogram values.

real - Standard deviation of histogram in NR3 format.
:MEASure:NDUTyset / query

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

NameTypeValuesDescription
sourceoptchannel_list-Specifies the measurement source; it may be a digital channel, analog channel, math function, or waveform memory.
real - Ratio of negative pulse width to period, returned in NR3 format.
:MEASure:NEDGesset / query

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

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

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

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | DIGital<d>Measurement source to use.
: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. The command is not available if the source is FFT.

NameTypeValuesDescription
sourceoptchannel_list-Measurement source: digital channels, one analog channel, one math function, or one reference waveform.

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

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Selects the measurement source.
real (%) - Returns the overshoot of the edge closest to the trigger reference, in percent, as an NR3 number.
:MEASure:PEDGesset / query

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

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source.
real - The query returns the on-screen rising edge count in NR3 format.
:MEASure:PERiodset / query

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

NameTypeValuesDescription
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to use for the period measurement.
:MEASure:PHASeset / query

Starts a continuous phase measurement using the specified source or sources. The query measures and returns the phase between the specified sources, calculated from delay and period measurements.

NameTypeValuesDescription
source1opt--First measurement source.
source2opt--Second measurement source.
real (deg) - The phase angle value in degrees.
:MEASure:PPULsesset / query

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

NameTypeValuesDescription
sourceopt--Measurement source: CHANnel<n>, FUNCtion<m>, MATH<m>, WMEMory<r>, or digital channels (DIGital<d> on MSO models).
numeric - Returns the on-screen rising pulse count in NR3 format.

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

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

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

NameTypeValuesDescription
sourceoptchannel_list-Measurement source to use for the pulse width measurement.
:MEASure:RESultsset / query

Returns the results of the continuously displayed measurements. The response is a comma-separated list of measurement results, with values duplicated for each continuous measurement in top-to-bottom display order when more than one is running.

string - Comma-separated list of continuously displayed measurement results. If no quick measurements are installed, returns an empty string.

Installs a screen rise-time measurement and starts measuring rise time. If an optional source is specified, the current source is modified. The command is not available when the source is FFT.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to use.
real (s) - Returns the rise time of the displayed rising edge closest to the timebase reference, in seconds.

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

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

Enables markers for tracking measurements on the display. The query returns the current marker state, and can return OFF when :MARKer:MODE selects a mode other than MEASurement.

NameTypeValuesDescription
on_offenum0 | OFF | 1 | ONTurns measurement markers off or on.
enum - Returns the current state of the markers.

Installs a slew rate measurement on the oscilloscope screen for the specified source and optional edge slope. If no source is given, the current :MEASure:SOURce setting is used; if no slope is given, a rising edge is measured.

NameTypeValuesDescription
sourceoptdiscrete-Measurement source waveform.
slopeoptenumRISing | FALLing | EITHerEdge slope to measure.
real (vertical units/second) - Measured slew rate of the specified edge closest to the timebase reference, in vertical units per second.
:MEASure:SOURceset / query

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

NameTypeValuesDescription
source1enumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Primary measurement source.
source2optenumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Secondary measurement source; used only for delay and phase measurements.
:MEASure:SOURce CHANnel1

Sets the statistics mode used by the :MEASure:RESults? query. ON means all statistics are on.

NameTypeValuesDescription
typeenumON | 1 | CURRent | MINimum | MAXimum | MEAN | STDDev | COUNtSelects the statistics type returned by :MEASure:RESults?.

Disables or enables the display of the measurement statistics.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONState of the measurement statistics display.

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

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

NameTypeValuesDescription
settingenumINFiniteMaximum number of values used when calculating measurement statistics, or infinite.
countinteger2 - 2000Maximum number of values used when calculating measurement statistics.
enum - Current measurement statistics max count setting. INF indicates infinite; otherwise a count value from 2 to 2000 is returned.

Resets the measurement statistics, zeroing the counts. The measurement statistics configuration is not deleted.

Disables or enables relative standard deviations (standard deviation/mean) in the measurement statistics.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns relative standard deviations off or on.
enum - Returns the current relative standard deviation setting.
:MEASure:TEDGeset / query

Installs a screen measurement for the time of the specified edge transition relative to the trigger edge. The optional slope selects rising, falling, or either edges, and the optional source selects the signal to search.

NameTypeValuesDescription
slopeoptenumRISing | FALLing | EITHerSpecifies whether to look for rising, falling, or either edges.
occurrenceinteger-Specifies the Nth edge to identify; 0 means the edge closest to the timebase reference.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Selects the signal source to search for the edge transition.
real (s) - Returns the time interval between the trigger event and the specified edge occurrence in seconds. If the crossing cannot be found, the oscilloscope returns +9.9E+37.
:MEASure:TEDGe? [<slope>,]<occurrence>[,<source>]
myScope.WriteString ":MEASURE:TEDGE? +1, CHAN1"
myScope.WriteString ":MEASURE:TEDGE? +2, CHAN1"
:MEASure:TVALueset / query

Searches the displayed signal for a specified vertical value crossing and returns the time interval from the trigger event to the requested occurrence. An optional source can be specified to modify the current source; the query is not available if the source is FFT.

NameTypeValuesDescription
valuereal-The vertical value that the waveform must cross.
slopeoptreal-Direction of the waveform crossing; plus sign for rising edge, minus sign for falling edge.
occurrenceinteger-The transition number to be reported.
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Source signal to use for the measurement.
real (s) - Time in seconds of the specified value crossing, returned in NR3 format. If the crossing cannot be found, the instrument returns +9.9E+37.

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<m> | MATH<m> | WMEMory<r>Selects the waveform source for the measurement.

Installs a screen measurement and starts an average value measurement. The optional interval selects either an integral number of cycles or the full screen; if omitted, DISPlay is implied. If a source is supplied, the current source is modified.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval to use.
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to modify.
real - Calculated average value in NR3 format.
: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<m> | MATH<m> | WMEMory<r>Selects the waveform source for the measurement.
: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<m> | MATH<m> | WMEMory<r>Selects the waveform source for the measurement.
: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
sourceoptdiscrete-Measurement source to use for the VMIN measurement.
real - Returns the minimum vertical value present on the selected waveform in NR3 format.
: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
sourceoptdiscrete-Selects the measurement source: channel, function, math, or memory waveform.
:MEASure:VRATioset / query

Installs a ratio measurement on screen using the AC RMS values of two specified sources, expressed in dB. If <interval> is omitted, DISPlay is implied; the command is not available if the source is FFT.

NameTypeValuesDescription
intervaloptenumCYCLe | DISPlayMeasurement interval: an integral number of cycles or the full screen.
source1optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>First measurement source.
source2optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Second measurement source.
real (dB) - Returns the ratio of AC RMS values of the specified sources, expressed in dB.
:MEASure:VRMSset / query

Installs a screen measurement and starts an RMS value measurement. Optional interval, type, and source can be specified; if omitted, DISPlay and DC are implied.

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

Installs a screen measurement and starts a waveform top value measurement. The source cannot be FFT.

NameTypeValuesDescription
sourceopt--Measurement source: CHANnel<n>, FUNCtion<m>, or MATH<m>.
real - Returns the vertical value at the top of the waveform.
:MEASure:WINDowset / query

Selects which display window is used for measurements: Main, Zoom, Auto, or Gate. The query returns the current measurement window setting.

NameTypeValuesDescription
typeenumMAIN | ZOOM | AUTO | GATEChooses the measurement window location.
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, the current source is modified. This command is an alias for :MEASure:TMAX.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Selects the measurement source.
real - Horizontal axis value of the maximum vertical value, returned in NR3 format.
: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.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Selects the measurement source; specifying it also modifies the current source.
real - Returns the horizontal axis value at which the minimum vertical value occurs.
:MEASure:YATXset / query

Installs a screen measurement of the vertical value at a specified horizontal value on the selected source. For FFT waveforms, the horizontal location is a frequency value instead of time.

NameTypeValuesDescription
horiz_locationrealsTime from trigger in seconds; for FFT waveforms, a frequency value instead of time.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to use.
real - Vertical value at the specified horizontal location, in NR3 format.
:MEASure:ANGLeset / query

Installs a power phase angle measurement on screen. The query returns the measured power phase angle in degrees.

NameTypeValuesDescription
source1optchannel_list-Channel probing voltage source.
source2optchannel_list-Channel probing current source.
real (degrees) - The power phase angle in degrees.

Installs an apparent power measurement on screen using the specified voltage and current sources. The query returns the measured apparent power.

NameTypeValuesDescription
source1optchannel_list-Channel probing voltage source.
source2optchannel_list-Channel probing current source.
real - The apparent power value.
:MEASure:CPLossset / query

Installs a power loss per cycle measurement on screen. The measurement operates in zoom mode and uses a counter measurement on the switching signal voltage.

NameTypeValuesDescription
source1optdiscreteFUNCtion<m> | MATH<m>Primary source waveform, typically a math multiply waveform or another waveform representing power (voltage * current).
source2optdiscreteCHANnel<n>Secondary source channel.
real (W) - The switching loss per cycle value in watts.
:MEASure:CREStset / query

Installs a crest factor measurement on screen. The optional source selects the channel or math function used for the measurement.

NameTypeValuesDescription
sourceoptchannel_list-Channel probing current or voltage source for the crest factor measurement.

Installs an efficiency measurement on screen. Before using it, the input voltage, input current, output voltage, and output current channels must be specified and automated signals setup must be performed.

real (%) - Returns the measured efficiency as a percent value in NR3 format.
:MEASure:ELOSsset / query

Installs an energy loss measurement on screen. The <source> parameter is typically a math multiply waveform or other waveform representing power, and can also be specified by :MEASure:SOURce.

NameTypeValuesDescription
sourceopt--Measurement source waveform.
real (J) - The energy loss value in joules, returned in NR3 format.
:MEASure:FACTorset / query

Installs a power factor measurement on the screen. The source1 parameter is the channel probing voltage and source2 is the channel probing current; these sources can also be set with :MEASure:SOURce.

NameTypeValuesDescription
source1optchannel_list-Channel probing voltage source.
source2optchannel_list-Channel probing current source.
:MEASure:IPOWerset / query

Installs an input power measurement on screen. Before using it, the input voltage, input current, output voltage, and output current channels must be specified and automated signals setup must be performed.

real - Returns the measured input power in NR3 format.
:MEASure:OFFTimeset / query

Installs an off time measurement on screen. Off time is the time from when the input AC voltage last falls to 10% of its maximum amplitude to when the output DC voltage last falls to 10% of its maximum amplitude.

NameTypeValuesDescription
source1optchannel_list-AC voltage source channel.
source2optchannel_list-DC voltage source channel.
numeric (s) - Returns the measured turn off time in seconds.
:MEASure:ONTimeset / query

Installs an "on time" measurement on the screen using one or two channel sources. The first source is the AC voltage and the second source is the DC voltage; these sources can also be specified by :MEASure:SOURce.

NameTypeValuesDescription
source1optchannel_list-AC Voltage source channel.
source2optchannel_list-DC Voltage source channel.
:MEASure:ONTime [<source1>][,<source2>]
:MEASure:ONTime? [<source1>][,<source2>]
:MEASure:OPOWerset / query

Installs an output power measurement on screen. Before using it, the required voltage/current signal sources must be specified and automated signals setup performed.

Installs a peak current measurement on screen. The source parameter selects the channel probing the current and may also be specified by :MEASure:SOURce.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Source probing the current.
real - Returns the measured peak current value in NR3 format.
:MEASure:PLOSsset / query

Installs a power loss measurement on screen. The source is typically a math multiply waveform or another waveform representing power, and can also be specified by :MEASure:SOURce.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source waveform.
real (W) - The power loss value in watts, returned in NR3 format.
:MEASure:RDSonset / query

Installs a power Rds(on) measurement on screen. The query returns the measured Rds(on) value.

NameTypeValuesDescription
source1optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>First measurement source.
source2optenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Second measurement source.
real - The measured Rds(on) value in NR3 format.

Installs a reactive power measurement on screen. The optional source arguments specify the channel probing voltage and current; they can also be set using :MEASure:SOURce.

NameTypeValuesDescription
source1optchannel_list-Channel probing voltage source.
source2optchannel_list-Channel probing current source.
:MEASure:REALset / query

Installs a real power measurement on screen. The optional <source> can be a channel, function, or math waveform and may also be set with :MEASure:SOURce.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m>Selects the waveform source used for the real power measurement.
:MEASure:RIPPleset / query

Installs an output ripple measurement on screen. The query returns the measured output ripple, defined as Vmax - Vmin.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Channel, function, math, or waveform memory source used for the ripple measurement.
real - The output ripple value in NR3 format.

Installs a transient response time measurement on screen. The source can also be specified by :MEASure:SOURce.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Channel, function, math, or waveform memory source used to probe the output voltage.
:MEASure:VCESatset / query

Installs a power Vce(sat) measurement on screen. The optional source selects the channel, function, math, or waveform memory used for the measurement.

NameTypeValuesDescription
sourceoptenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source to use.
real - Returns the measured Vce(sat) value in NR3 format.
:MEASure:LOWerset / query

Sets the lower measurement threshold value. The value and the upper threshold represent absolute values when thresholds are ABSolute and percentage when thresholds are PERCent, as defined by :MEASure:DEFine THResholds. This command is obsolete and provided for backward compatibility.

NameTypeValuesDescription
voltagerealVLower measurement threshold value.
: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 Tstart marker (X1 cursor) and the Tstop marker (X2 cursor). This obsolete command is provided for compatibility with previous oscilloscopes; use :MARKer:XDELta instead.

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

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

NameTypeValuesDescription
thresholdsenumT1090 | T2080 | VOLTageThreshold set to use for time measurements.
enum - Returns the current thresholds selected when making time measurements.
:MEASure:TMAXset / query

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

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

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

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

Moves the start marker (X1 cursor) to the specified time with respect to 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 | psOptional time unit suffix.
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 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 unit suffix for the time value.
real - Returns the time at the stop marker (X2 cursor) in NR3 format.
:MEASure:TVOLtset / query

Queries the time interval from the trigger event to the specified voltage crossing of the displayed waveform. The command is obsolete and provided for backward compatibility; if the crossing cannot be found, the oscilloscope returns +9.9E+37.

NameTypeValuesDescription
valuereal-The voltage level that the waveform must cross.
slopeoptinteger-Direction of the waveform; rising edge is indicated by + and falling edge by -.
occurrenceinteger-The transition number to be reported.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion | MATHSelects the source to be measured.
real (s) - Time in seconds of the specified voltage crossing, returned in NR3 format.
:MEASure:UPPerset / query

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

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

Returns the voltage difference between vertical marker 1 (Y1 cursor) and vertical marker 2 (Y2 cursor). It is an obsolete compatibility command; use :MARKer:YDELta instead.

real (V) - Delta V value in NR1 format, equal to marker 2 value minus marker 1 value.
: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 command is obsolete and provided for compatibility; use :MARKer:Y2Position instead.

NameTypeValuesDescription
vstop_argumentreal-Value for the Y2 cursor.
real - Returns the current value of the Y2 cursor in NR3 format.
:MEASure:VSTOp <vstop_argument>
:MEASure:VSTOp?
:MEASure:VTIMeset / query

Returns the vertical value at a specified horizontal location on the specified source. The horizontal value must be on screen; when it is a time value, it is referenced to the trigger event. If the source is an FFT waveform, the <vtime_argument> is a frequency value instead of a time value.

NameTypeValuesDescription
vtime_argumentrealsTime from trigger in seconds.
sourceoptenumDIGital<d> | CHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r>Measurement source; optional if the source is to be modified.
real - Vertical value at the specified horizontal location in NR3 format.

: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 only covers the portion of the waveform visible on the display.

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

NameTypeValuesDescription
sourcechannel_list-Channel source to use for mask parameter interpretation.

Alters how the mask test subsystem interprets tolerance parameters for automasking. The setting can be current channel units or screen divisions, and changing it does not convert existing XDELta and YDELta values.

NameTypeValuesDescription
unitsenumCURRent | DIVisionsSelects the measurement units used by the mask test subsystem.

Sets the X-direction tolerance used by the automasking feature. The absolute tolerance is added and subtracted from waveform horizontal values to determine mask boundaries, and its interpretation depends on :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
channeloptchannel_list-Optional channel number selecting which analog channel to use.
integer - Number of failed waveforms in NR1 format.

Returns the elapsed time in the current mask test run.

real (s) - Elapsed time in the current mask test run, in NR3 format.

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

numeric - Number of waveforms in NR1 format.
:MTESt:DATAset / query

Loads a mask from IEEE 488.2 binary block data. The query returns a mask in binary block data format using the IEEE 488.2 # format.

NameTypeValuesDescription
maskblock-Binary block data for the mask.
block - A mask in binary block data format.
:MTESt:ENABleset / query

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

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFSelects whether mask test features are enabled or disabled.
enum - Returns the current state of mask test features as 1 or 0.
: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 condition can be forever, Sigma level, time, or a fixed number of waveforms; related setting values are configured by the associated :MTESt:RMODe:SIGMa, :MTESt:RMODe:TIME, and :MTESt:RMODe:WAVeforms commands.

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 | OFFTurns mask-failure measurement mode on or off.

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

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFEnables or disables printing on mask failures.

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

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

Sets whether stopping on a mask failure is enabled or disabled. When ON and a mask violation is detected, the mask test and acquisition system are stopped.

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

Sets the test sigma level used when :MTESt:RMODe is set to SIGMa. The value indirectly specifies how many waveforms must be tested to reach the sigma level.

NameTypeValuesDescription
levelreal0.1 - 9.3Test sigma level.
real - Returns the current Sigma level setting.

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

NameTypeValuesDescription
secondsreal1 - 86400Number of seconds for a mask test to run, expressed 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 the Bind -1 & 0 Levels control for inverted masks. When enabled, the paired level controls track each other; when disabled, adjusting either control changes the mask height.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns the bind control on or off.
:MTESt:SCALe:X1set / query

Defines where X=0 in the base coordinate system used for mask testing. The query returns the current X1 coordinate setting.

NameTypeValuesDescription
x1_valuerealsX1 value in NR3 format.
real (s) - Current X1 coordinate setting.

Defines the position of the X2 marker with respect to the X1 marker in the mask test coordinate system. Changing ΔX also shifts normalized X vertices so they stay in the same locations relative to X1 and ΔX.

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.
:MTESt:SCALe:XDELta <xdelta_value>
:MTESt:SCALe:XDELta?
:MTESt:SCALe:Y1set / query

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

NameTypeValuesDescription
y1_valuerealVY1 value in NR3 format.
real (V) - Returns the current setting of the Y1 marker.
: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 as a Y2 value in NR3 format.
:MTESt:SOURceset / query

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

NameTypeValuesDescription
sourceenumCHANnel<n>Channel to select, where n is 1 to the number of analog channels in NR1 format.
enum - Returns the channel configured by the current mask file.
:MTESt:TITLeset / query

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

string - A string of up to 128 ASCII characters containing the mask title.
:MTESt:AVERageset / query

Enables or disables averaging for the oscilloscope. When ON, the instrument acquires multiple data values for each time bucket and averages them; when OFF, averaging is disabled.

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

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

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

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

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

Sets the mask test termination condition. Choices are FORever, TIME with a seconds value, or WAVeforms with a waveform count. This command is obsolete and provided for backward compatibility; use :MTESt:RMODe instead.

NameTypeValuesDescription
modeenumFORever | TIME | WAVeformsTermination condition for the mask test.
secondsoptreal1 - 86400Amount of time in seconds before the mask test terminates.
wfm_countoptinteger1 - 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 with seconds, or WAV with waveform count.

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

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

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

NameTypeValuesDescription
sourcechannel_list1 - # analog channelsChannel to use as the trigger.

:POD<n>:DISPlayset / query

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

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFControls whether the specified group of channels is displayed.
ninteger1 - 2Selects the channel group, where 1 corresponds to POD1 (D0-D7) and 2 corresponds to POD2 (D8-D15).
:POD<n>:SIZEset / query

Sets the digital channel size for the pods on the display. The setting applies to all pods; setting pod 1 also sets pod 2 to the same size. Valid only for MSO models.

NameTypeValuesDescription
valueenumSMALl | MEDium | LARGeSpecifies the pod digital channel size.

Sets the threshold for the specified POD channel group. The threshold is used for triggering and for displaying digital data as high or low.

NameTypeValuesDescription
typeenumCMOS | ECL | TTL | <user defined value>Threshold preset or user-defined threshold value.
suffixoptenumV | mV | uVUnit suffix for a user-defined threshold value.
real - Returns the threshold value for the specified group of channels.
myScope.WriteString ":POD1:THRESHOLD CMOS"
myScope.WriteString ":POD2:THRESHOLD 2.0"

Returns the Control Loop Response (Bode) power analysis settings.

string - <settings_string>
:POW:CLR:SOUR:INP CHAN1;OUTP CHAN2;:POW:CLR:FREQ:STAR +100E+00;
STOP +20.000000E+06;:POW:CLR:WGEN:VOLT +200.0E-03;LOAD FIFT

Performs the control loop response (Bode) analysis to help determine the margin of a control loop. The analysis sweeps an input sine wave from low to high frequency while measuring input and output RMS voltages using two oscilloscope channels.

Returns data from the Control Loop Response (Bode) power analysis. The optional SWEep or SINGle qualifier selects sweep or single-frequency analysis data; if omitted, sweep data is returned by default.

NameTypeValuesDescription
qualifieroptenumSWEep | SINGleSelects whether to get the data from sweep or single-frequency analysis.
block - Comma-separated data with newlines at the end of each row.

After Control Loop Response (Bode) power analysis has been performed, this query returns the gain margin in dB. It returns +9.9E+37 if the value cannot be calculated from the last sweep (for example, if there are no crossover points).

real (dB) - Gain margin in dB, returned in NR3 format. Returns +9.9E+37 if the value cannot be calculated from the last sweep.

Returns the 0° phase crossover frequency in Hz after Control Loop Response (Bode) power analysis has been performed. If the value cannot be calculated from the last sweep, the query returns +9.9E+37.

real (Hz) - 0 degrees phase crossover frequency in Hz in NR3 format.

Returns the phase margin in degrees after Control Loop Response (Bode) power analysis has been performed. It returns +9.9E+37 if the value cannot be calculated from the last sweep (for example, if there are no crossover points).

real (degrees) - Phase margin in degrees in NR3 format. Returns +9.9E+37 if the value cannot be calculated from the last sweep.

Returns the 0 dB gain crossover frequency in Hz after Control Loop Response (Bode) power analysis has been performed. If the value cannot be calculated from the last sweep, the query returns +9.9E+37.

real (Hz) - 0 dB gain crossover frequency in Hz in NR3 format; returns +9.9E+37 if the value cannot be calculated from the last sweep (no crossover points).

Sets whether the analysis is performed by sweeping through a range of frequencies or at a single frequency. The query returns the current frequency mode setting.

NameTypeValuesDescription
modeenumSWEep | SINGleSelects sweep or single-frequency analysis mode.
enum - Returns the current frequency mode setting.

Sets the single frequency value for control loop response analysis. The value is shown on a log-scale Bode plot and can be selected from listed decade values, with 20 Hz as the minimum frequency.

NameTypeValuesDescription
valueinteger20 - 10000000Single frequency value to set.
suffixoptenumHz | kHz | MHzOptional frequency unit suffix.
integer - Returns the single frequency setting.

Sets the frequency sweep start value for control loop response analysis. The sweep start can be selected from decade values in addition to the minimum frequency of 20 Hz.

NameTypeValuesDescription
valuereal20 - 10000000Frequency sweep start value.
real - Returns the frequency sweep start setting.

Sets the frequency sweep stop value for control loop response analysis. The stop value can be one of the listed decade values up to 20 MHz, with an optional Hz, kHz, or MHz suffix.

NameTypeValuesDescription
valueinteger100 - 20000000Frequency sweep stop value.
suffixoptenumHz | kHz | MHzOptional frequency unit suffix.
integer - Returns the frequency sweep stop setting.

Selects the number of frequency test points per decade in the logarithmic scale. The query returns the current points-per-decade setting.

NameTypeValuesDescription
ptsinteger10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100Points per decade setting.
integer - Returns the points-per-decade setting.

Selects the oscilloscope channel that is probing the power supply input.

NameTypeValuesDescription
sourcechannel_list-Channel selection in the form CHANnel<n>, where n is 1 to the number of analog channels.
channel_list - Returns the channel selection.

Selects the oscilloscope channel that is probing the power supply output. The query returns the current channel selection.

NameTypeValuesDescription
sourcestring-Channel to use for probing the power supply output.
string - Current channel selection.
:POWer:CLResponse:SOURce:OUTPut <source>
:POWer:CLResponse:SOURce:OUTPut?

Specifies whether to include gain, phase, both, or neither in the control loop response analysis results. The setting affects the front-panel GUI as well as saved analysis data.

NameTypeValuesDescription
selectionenumNONE | ALL | GAIN | PHASeSelects which control loop response data types are included; the optional second item restricts the selection list to gain or phase.

Sets the waveform generator expected output load impedance. The setting lets the waveform generator display correct amplitude and offset levels for the expected load.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.

Sets the waveform generator output amplitude. With an optional range, it sets the initial ramp amplitude for that frequency range when the amplitude profile is enabled; without the range, it sets the amplitude used when the profile is disabled.

NameTypeValuesDescription
amplituderealVAmplitude in volts in NR3 format.
rangeoptenumF20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZFrequency range for which to set the amplitude.

Enables or disables the ability to set initial waveform generator ramp amplitudes for each frequency range.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns amplitude profiling off or on.
enum - Returns the voltage profile setting.
:POWer:DESKewset / query

Launches the auto deskew process on the oscilloscope. The deskew values are saved until a factory default or secure erase is performed.

Applies the efficiency power analysis. Efficiency analysis tests the overall efficiency of the power supply by measuring output power over input power.

Specifies the type of power being converted from the input to the output, which affects how efficiency is measured.

NameTypeValuesDescription
typeenumDCDC | DCAC | ACDC | ACACSpecifies the power-conversion type.
enum - Returns the currently specified type setting.
:POWer:ENABleset / query

Enables or disables power analysis. The query returns whether power analysis is enabled or disabled.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the power analysis enable state.
enum - Returns 1 if power analysis is enabled and 0 if it is disabled.

Applies the current harmonics analysis. The command is used with Current Harmonics analysis to test a switching power supply's current harmonics against IEC61000-3-2 pre-compliance standards.

Returns the power harmonics results table data.

block - Power harmonics results table data in a comma-separated binary block with newlines at the end of each row.

Specifies how to display the current harmonics analysis results. The query returns the current display setting.

NameTypeValuesDescription
displayenumTABLe | BAR | OFFDisplay mode for harmonics analysis results.
enum - Returns the harmonics display setting.

Returns the current harmonics analysis fail count. Non spec values (harmonics values not specified by the selected standard) are not counted.

integer - The current harmonics analysis fail count.

Specifies the line frequency setting for the current harmonics analysis. The query returns the current line frequency setting.

NameTypeValuesDescription
frequencyenumF50 | F60 | F400 | AUTOLine frequency setting to use for harmonics analysis.
enum - Returns the line frequency setting.

Returns the power factor for IEC 61000-3-2 Standard Class C power factor value.

real - Class C power factor in NR3 format.

Specifies whether the Real Power value used for the current-per-watt measurement is measured by the oscilloscope or defined by the user when Class D harmonics analysis is selected. Use the related USER command to enter the user-defined value.

NameTypeValuesDescription
sourceenumMEASured | USERSelects the Real Power source.
enum - Returns the Real Power source setting.

Specifies the user-defined Real Power value used in the current-per-watt measurement when Class D is selected as the current harmonics analysis standard and a user-defined Real Power value is in use. The query returns that user-defined Real Power value.

NameTypeValuesDescription
valuereal1.0 - 600.0User-defined Real Power value.
real (W) - Returns the user-defined Real Power value.

Returns the current harmonics analysis run iteration count. Non-spec values (harmonics values not specified by the selected standard) are not counted.

integer - The current harmonics analysis run iteration count.

Selects the IEC 61000-3-2 standard used for current harmonics compliance testing. The query returns the currently set standard.

NameTypeValuesDescription
classenumA | B | C | DIEC 61000-3-2 standard class to use for harmonics compliance testing.
enum - Returns the currently set IEC 61000-3-2 standard.

Returns the overall pass/fail status of the current harmonics analysis.

enum - Overall pass/fail status of the current harmonics analysis.

Returns the Total Harmonics Distortion (THD) results of the current harmonics analysis.

real - Total Harmonics Distortion in NR3 format.

Applies the inrush current analysis. The analysis measures the peak inrush current of the power supply when the power supply is first turned on.

Exits (stops) the inrush current power analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.

Goes to the next step of the inrush current analysis. It is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.

:POWer:ITYPeset / query

Specifies the type of power being converted from the input. The setting affects how measurements are made and is used in the Inrush Current and Turn On/Turn Off tests.

NameTypeValuesDescription
typeenumDC | ACSelects the input power type.

Applies the selected modulation analysis type. The command is used for modulation analysis of a control pulse signal to a switching device and its trending characteristics.

Selects either the voltage source or the current source as the source for the modulation analysis. The query returns the selected source.

NameTypeValuesDescription
sourceenumV | ISelects the modulation analysis source.
enum - Returns the selected source for the modulation analysis.

Selects the type of measurement used in modulation analysis. The query returns the current modulation type setting.

NameTypeValuesDescription
modulationenumVAVerage | ACRMs | VRATio | PERiod | FREQuency | PWIDith | NWIDth | DUTYcycle | RISetime | FALLtimeModulation measurement type to use.
enum - Current modulation type setting.

Applies the selected turn on/off analysis test. It is associated with the :POWer:ONOFf:TEST setting.

Exits (stops) the turn on time/turn off time analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.

Advances the turn on/turn off analysis to the next step. It is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.

Selects whether turn-on or turn-off analysis is performed. ON measures the time taken for the output voltage to come up after the input voltage is applied; OFF measures the time taken for the output voltage to turn off after the input voltage is removed.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects the test type.

Specifies the input and output thresholds used in the Turn On/Turn Off analysis. The query returns the current input and output threshold settings for the selected analysis type.

NameTypeValuesDescription
typeenumON | OFFSelects the turn-on or turn-off analysis type.
input_thrreal0 - 100Input threshold as a percent from 0 to 100 in NR1 format.
output_thrreal0 - 100Output threshold as a percent from 0 to 100 in NR1 format.
real (%) - Returns the input and output threshold settings for the turn on/turn off analysis type, as <input_thr>,<output_thr>.
:POWer:PSRRset / query

Returns the Power Supply Rejection Ratio (PSRR) power analysis settings.

string - Returns the PSRR power analysis settings as a settings string terminated by a newline.
:POW:PSRR:SOUR:INP CHAN1;OUTP CHAN2;:POW:PSRR:FREQ:STAR +100E+00; STOP +20.000000E+06;:POW:PSRR:WGEN:VOLT +200.0E-03;LOAD FIFT

Applies the power supply rejection ratio (PSRR) analysis. The analysis uses the oscilloscope waveform generator to sweep frequency and measure the AC RMS ratio of input over output.

:POWer:PSRR:DATAset / query

Returns PSRR power analysis data as comma-separated values suitable for spreadsheet analysis. The optional SWEep or SINGle qualifier selects sweep or single-frequency analysis data; if omitted, sweep data is returned by default.

NameTypeValuesDescription
qualifieroptenumSWEep | SINGleSelects whether the data comes from a sweep or single-frequency analysis.
block - Comma-separated data in a binary block format with newlines at the end of each row.

Sets the end sweep frequency value for PSRR measurements. The value may be selected from decade values up to 20 MHz.

NameTypeValuesDescription
valuereal10 - 20000000End sweep frequency value.
suffixoptenumHz | kHz | MHzOptional frequency suffix.
real (Hz) - Returns the maximum sweep frequency setting.

Sets the start sweep frequency value for PSRR measurements. The measurement is displayed on a log scale, so only decade values are allowed.

NameTypeValuesDescription
valueinteger1 - 10000000Start sweep frequency value.
suffixoptenumHz | kHz | MHzOptional frequency suffix.
integer - Returns the minimum sweep frequency setting.

Specifies whether the PSRR frequency analysis is performed by sweeping through a range of frequencies or at a single frequency.

NameTypeValuesDescription
modeenumSWEep | SINGleSelects sweep mode or single-frequency mode.

Sets the single frequency value for PSRR measurements. The measurement is displayed on a log scale, so decade values can be selected.

NameTypeValuesDescription
valuereal1 - 10000000Single frequency value to set.

Selects the number of frequency test points per decade in the log scale.

NameTypeValuesDescription
ptsinteger10 | 20 | 30 | 40 | 50 | 60 | 70 | 80 | 90 | 100Points per decade setting.

Selects the oscilloscope channel used to probe the power supply input. The query returns the current channel selection.

NameTypeValuesDescription
sourcechannel_list-Channel to use as the power supply input probe.
channel_list - The current channel selection.

Selects the oscilloscope channel that is probing the power supply output.

NameTypeValuesDescription
sourcechannel_list1 - (# analog channels)Channel to use as the power supply output probe channel.
channel_list - Returns the channel selection.

Specifies whether gain (PSRR) data is included in the power supply rejection ratio analysis results. It affects the front-panel plot and table as well as saved analysis data.

NameTypeValuesDescription
selectionenumNONE | GAINSelects whether PSRR gain data is included.
enum - Returns the type of data currently included in the PSRR analysis results, or "NONE" if gain data is not included.

Sets the waveform generator expected output load impedance. The setting is used so the generator can display correct amplitude and offset levels for the expected load.

NameTypeValuesDescription
impedanceenumONEMeg | FIFTyExpected output load impedance.

Sets the waveform generator output amplitude(s). With the waveform generator amplitude profile enabled, you can set an initial ramp amplitude for each frequency range; without a <range> parameter, it sets the amplitude used when the profile is disabled.

NameTypeValuesDescription
amplituderealVAmplitude in volts in NR3 format.
rangeoptenumF20HZ | F100HZ | F1KHZ | F10KHZ | F100KHZ | F1MHZ | F10MHZ | F20MHZFrequency range for which to set the waveform generator amplitude.

Enables or disables the ability to set initial waveform generator ramp amplitudes for each frequency range. With amplitude profiling, lower amplitudes can be used where the DUT is sensitive to distortion and higher amplitudes where it is less sensitive.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables voltage profiling.
enum - Returns the voltage profile setting.

Applies the selected power quality analysis type. The command is used to view AC input line power quality measurements such as power factor, apparent power, true power, reactive power, crest factor, and phase angle.

Performs automated oscilloscope setup for the signals in the specified type of power analysis.

NameTypeValuesDescription
analysisenumHARMonics | EFFiciency | RIPPle | MODulation | QUALity | SLEW | SWITch | RDSVceSpecifies the type of power analysis to set up automatically.

Specifies the number of cycles to include in the current harmonics analysis.

NameTypeValuesDescription
countinteger1 - 100Number of cycles to include in the harmonics analysis.
integer - Returns the number of cycles currently set.

Specifies the number of cycles to include in the power quality analysis. The query returns the number of cycles currently set.

NameTypeValuesDescription
countinteger1 - 100Number of cycles to include in the power quality analysis.
integer - The number of cycles currently set.

Sets the duration of the efficiency analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-Duration value in NR3 format.
suffixoptenums | ms | us | nsOptional time suffix.
real - The set duration time value.

Sets the duration of the modulation analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-Duration value in NR3 format.
suffixoptenums | ms | us | nsOptional unit suffix for the duration value.
real - The set duration time value.

Specifies the duration of the turn off analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-Duration value in NR3 format.
suffixoptenums | ms | us | nsOptional time suffix.
real - Set duration time value.

Specifies the duration of the turn on analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-NR3-formatted duration value.
suffixoptenums | ms | us | nsOptional time suffix.
real - Set duration time value.

Specifies the duration of the output ripple analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-Duration value in NR3 format.
suffixoptenums | ms | us | nsOptional time unit suffix.
real - Set duration time value.

Specifies the duration of the transient response analysis. The query returns the set duration time value.

NameTypeValuesDescription
valuereal-Duration value in NR3 format.
suffixoptenums | ms | us | nsOptional time suffix.
real - Set duration time value in NR3 format.

Specifies the expected inrush current amplitude, which is used to set the vertical scale of the channel probing current.

NameTypeValuesDescription
valuereal-Expected current value in NR3 format.
suffixoptenumA | mAUnit suffix for the current value.

Specifies the percent overshoot of the output voltage. The value is used to determine the settling band for transient response and to adjust the oscilloscope vertical scale.

NameTypeValuesDescription
percentinteger-Percent of overshoot value in NR1 format.

Specifies the maximum expected input voltage used to set the vertical scale for inrush current analysis. For DC input, it defines the maximum DC input voltage amplitude and may be negative; for AC input, it defines the maximum peak-to-peak input voltage and must be positive.

NameTypeValuesDescription
valuerealVMaximum expected input voltage in NR3 format.
real (V) - Returns the expected maximum input voltage setting.

Sets the maximum expected input voltage used for turn-off analysis and vertical scaling. The value may be negative for DC, but only positive for AC, and a suffix of V or mV may be used.

NameTypeValuesDescription
valuerealVMaximum expected input voltage in NR3 format.
real (V) - Returns the expected maximum input voltage setting.

Specifies the maximum expected input voltage used to set the vertical scale of the channel probing voltage for turn-on analysis. For DC input, it defines the maximum DC input voltage amplitude and may be negative; for AC input, it defines the maximum peak-to-peak input voltage and must be positive.

NameTypeValuesDescription
valuerealVMaximum expected input voltage in NR3 format.
real (V) - Returns the expected maximum input voltage setting.

Specifies the expected steady-state output DC voltage of the power supply for turn-off analysis. The query returns the expected steady-state voltage setting.

NameTypeValuesDescription
valuerealVExpected steady-state output voltage value in NR3 format.
real (V) - Expected steady-state output voltage setting in NR3 format.

Specifies the expected steady-state output DC voltage of the power supply for turn-on analysis. The query returns the expected steady-state voltage setting.

NameTypeValuesDescription
valuerealVExpected steady state output voltage value in NR3 format.
real (V) - Expected steady state output voltage setting in NR3 format.
:POWer:SIGNals:VSTeady:ONOFf:ON <value>[suffix]
:POWer:SIGNals:VSTeady:ONOFf:ON?

Sets the expected steady-state output DC voltage of the power supply for transient response analysis. The value is used with overshoot percentage to define the settling band and adjust the oscilloscope vertical scale.

NameTypeValuesDescription
valuerealVExpected steady-state output voltage in NR3 format.
suffixoptenumV | mVVoltage unit suffix.
real (V) - Returns the expected steady-state voltage setting.

Specifies the first, and perhaps second, current source channel to be used in the power analysis. The query returns the current source channel setting.

NameTypeValuesDescription
sourcechannel_list-Current source channel to use for power analysis.
channel_list - The current source channel setting.

Specifies the first, and perhaps second, voltage source channel to be used in the power analysis. The query returns the current voltage source channel setting.

NameTypeValuesDescription
sourcechannel_list-Voltage source channel, specified as CHANnel<n> where n is in NR1 format from 1 to the number of analog channels.
channel_list - Returns the voltage source channel setting as CHANnel<n>.

Selects either the voltage source or the current source as the source for the slew rate analysis.

NameTypeValuesDescription
sourceenumV | ISelects the source used for slew rate analysis.

Applies the switching loss analysis using the current conduction calculation method, V reference, and I reference settings.

Specifies the conduction calculation method used for the Power waveform. The query returns the current conduction method.

NameTypeValuesDescription
conductionenumWAVeform | RDS | VCESelects the conduction calculation method.
enum - Returns the conduction calculation method.

Specifies the current switching level used for the start of switching edges. The value is set as a percentage of the maximum switch current and can be used to ignore noise floors or null offset.

NameTypeValuesDescription
percentreal%Percent value in NR1 format.
real (%) - Returns the current switching level percent value.

Sets the Rds(on) value used when the RDS conduction calculation method is selected. The query returns the Rds(on) value.

NameTypeValuesDescription
valuerealOHMRds(on) value in NR3 format.
real - Rds(on) value in NR3 format.

Specifies the Vce(sat) value used when the VCE conduction calculation method is chosen. The query returns the current Vce(sat) value.

NameTypeValuesDescription
valuerealVVce(sat) value in NR3 format.
suffixoptenumV | mVOptional unit suffix.
real - Vce(sat) value in NR3 format.

Specifies the voltage switching level for the switching edges as a percentage of the maximum switch voltage. You can adjust the value to ignore noise floors; it sets the threshold used to determine the switching edges.

NameTypeValuesDescription
percentreal%Percent value in NR1 format.

Applies the transient analysis using the initial current and new current settings.

Exits (stops) the transient analysis. It is equivalent to pressing the Exit softkey on the oscilloscope front panel during the analysis.

Specifies the initial load current value used as a reference and to trigger the oscilloscope. The query returns the initial load current value.

NameTypeValuesDescription
valuerealAInitial current value in NR3 format.
real (A) - Initial load current value in NR3 format.

Specifies the new load current value used as a reference and to trigger the oscilloscope. The query returns the new load current value.

NameTypeValuesDescription
valuereal-New current value in NR3 format.
suffixoptenumA | mAUnits for the current value.
real - New load current value in NR3 format.

Goes to the next step of the transient analysis. This is equivalent to pressing the Next softkey on the oscilloscope front panel when prompted during the analysis.

Recalls an arbitrary waveform from an internal location or a CSV file. The optional column selects which CSV column to load, and the optional wavegen ID chooses which waveform generator to load into.

NameTypeValuesDescription
file_specoptstring-File specification, either an internal location or a file name.
columnoptinteger1CSV column number to load; column numbering starts from 1.
wavegen_idoptenumWGEN1 | WGEN2Specifies which waveform generator to recall the arbitrary waveform into.

Loads a CAN DBC symbolic data file into the oscilloscope. If a file extension is provided in <file_name>, it must be ".dbc".

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII file name of the CAN DBC symbolic data file to load.
serialbusoptstring-Specifies which serial decode waveform the CAN symbolic data is loaded for.
:RECall:FILenameset / query

Specifies the source filename for RECall operations. The filename is stored as a base name only, without path information or an extension.

NameTypeValuesDescription
base_namestring-Quoted ASCII string specifying the file base name.
string - Returns the current RECall filename as a quoted ASCII string.

Loads a LIN description file (LDF) symbolic data file into the oscilloscope. If a file extension is provided, it must be ".ldf"; the optional serial bus selects which serial decode waveform the LIN symbolic data is loaded for.

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string naming the LDF file to load.
serialbusoptchannel_list-Specifies which serial decode waveform the LIN symbolic data will be loaded for.

Recalls a mask from a specified file or internal location. If a file name is used, any file extension must be ".msk".

NameTypeValuesDescription
file_specoptstring-File specification to recall, either an internal location or a quoted ASCII file name.
:RECall:PWDset / query

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

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

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

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

Recalls a reference waveform. The waveform can be recalled from a specified quoted ASCII file name or from binary block data in IEEE 488.2 # format; if a file name includes an extension, it must be ".h5".

NameTypeValuesDescription
rinteger1 - # ref waveformsReference waveform number in NR1 format.
file_nameoptstring-Quoted ASCII file name to recall from.
dataoptblock-Binary block data in IEEE 488.2 # format.

Saves the current arbitrary waveform to an internal location or to a file on a USB storage device. The <wavegen_id> parameter specifies which waveform generator to save the waveform from.

NameTypeValuesDescription
file_specoptstring-Internal location or file name to save to.
wavegen_idoptenumWGEN1 | WGEN2Specifies which waveform generator to save the arbitrary waveform from.

Saves USB 2.0 signal quality test results to a file. If a file extension is provided in <file_name>, it must be ".html".

NameTypeValuesDescription
<file_name>optstring-Quoted ASCII string naming the output file.
:SAVE:FILenameset / query

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

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

Saves an image to a file. Set :SAVE:IMAGe:FORMat before using this command; if a file extension is supplied and it does not match the expected format, the format may be changed to match a valid image extension.

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

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

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

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

NameTypeValuesDescription
formatenumBMP | BMP24bit | BMP8bit | PNGImage format to use for saved images.
enum - Returns the selected image format type.

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

NameTypeValuesDescription
valueenumOFF | 0 | ON | 1Sets whether the 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 - Returns the selected image palette color.

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

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string specifying the file name.

Saves a mask. An optional file specification can be a quoted ASCII file name or an internal location 0-3; if a file extension is provided, it must be ".msk".

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

Saves multi-channel waveform data to a file for use with the N8900A Infiniium Offline oscilloscope analysis software. If a file extension is included in <file_name>, it must be ".h5".

NameTypeValuesDescription
<file_name>optstring-Quoted ASCII string specifying the file name.

Saves the power measurement application's current harmonics analysis results to a file. If a file extension is provided in <file_name>, it must be ".csv".

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string specifying the file name to save to.
: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 path.
string - The currently set working directory for save operations.

Saves analysis results to a comma-separated values (*.csv) file on a USB storage device. Use the :SAVE:RESults:FORMat commands to specify which analysis types are saved; if multiple types are selected, their results are written to the same file separated by a blank line.

NameTypeValuesDescription
file_specoptstring-Destination file specification; the manual notes the file name is a quoted ASCII string.

Specifies whether cursor values will be included when analysis results are saved. The corresponding query returns whether cursor values will be included.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns cursor values saved with analysis results off or on.
enum - Returns whether cursor values will be included when analysis results are saved.

Specifies whether histogram statistics are included when analysis results are saved with :SAVE:RESults:[STARt]. The saved results are written to the same file as other selected analysis results, separated by a blank line.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONTurns histogram statistics saving off or on.
enum - Returns whether histogram statistics will be included when analysis results are saved.

Specifies whether mask statistics are included when analysis results are saved. The corresponding query returns whether mask statistics will be included.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables inclusion of mask statistics in saved analysis results.
enum - Returns whether mask statistics will be included when analysis results are saved.

Specifies whether measurement results are included when analysis results are saved. The setting applies to results saved with :SAVE:RESults:[STARt].

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether measurement results are saved with analysis results.
enum - Returns whether measurement results will be included when analysis results are saved.

Specifies whether segmented memory acquisition times will be included when analysis results are saved. Analysis results are saved using :SAVE:RESults:[STARt], and multiple result types are saved to the same file separated by a blank line.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnable or disable inclusion of segmented memory acquisition times when saving analysis results.
enum - Returns whether segmented memory acquisition times will be included when analysis results are saved.

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 file name.

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

NameTypeValuesDescription
file_nameoptstring-Quoted ASCII string naming the destination file.

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

NameTypeValuesDescription
formatenumASCiixy | CSV | BINarySelects the waveform data format type.
enum - Selected waveform data format type; returns ASC, CSV, BIN, or NONE. NONE indicates that an image file format is currently selected.

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

NameTypeValuesDescription
lengthinteger100 - max. lengthWaveform data length to save, in points.

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

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Controls whether maximum waveform length is saved.

Specifies which acquired segments are included when saving a waveform while segmented memory is used. ALL saves all acquired segments; CURRent saves only the currently selected segment.

NameTypeValuesDescription
optionenumALL | CURRentSelects which waveform 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.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | 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 as part of <file_name>, it must be ".h5".

NameTypeValuesDescription
<file_name>optstring-Quoted ASCII string naming the reference waveform file.
:SAVE:IMAGe:AREAset / query

Returns the selected image area. When saving images, the query returns SCR (screen); when saving setups or waveform data, it returns GRAT (graticule) even though graticule images are not saved.

enum - Selected image area.

:SBUS<n>:DISPlayset / query

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

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFDisplay setting for the serial decode bus.
enum - Returns the current display setting of the serial decode bus.
:SBUS<n>:MODEset / query

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

NameTypeValuesDescription
modeenumA429 | FLEXray | CAN | CXPI | I2S | IIC | LIN | M1553 | MANChester | NRZ | SENT | SPI | UART | USB | USBPdSets the serial bus decode mode.
enum - Returns the current serial bus decode mode setting.

Automatically sets several ARINC 429 decoding and triggering options. It configures trigger thresholds, noise reject, probe attenuation, vertical scale, serial decode, base, word format, trigger source, and trigger mode.

Selects between hexadecimal and binary display of the decoded ARINC 429 data. The setting does not affect the SDI and SSM fields, which are always displayed in binary, nor the Label field, which is always displayed in octal.

NameTypeValuesDescription
baseenumBINary | HEXSelects the display base.

Sets the user-defined A429 baud rate for :SBUS<n>:A429:SPEed USER. The baud rate can be set in 100 b/s increments between 10000 and 100000 and in 1000 b/s increments between 100000 and 1000000.

NameTypeValuesDescription
baudrateinteger10000 - 1000000User-defined baud rate.

Specifies the ARINC 429 word decode format for the selected bus. The query returns the current word decode format setting.

NameTypeValuesDescription
formatenumLDSDi | LDSSm | LDATaARINC 429 word decode format to use.
enum - Returns the current ARINC 429 word decode format setting.

Sets the ARINC 429 signal type for the selected :SBUS<n> path. The available choices are Line A, Line B, or Differential (A-B).

NameTypeValuesDescription
signalenumA | B | DIFFerentialSelects the signal type: A = Line A (non-inverted), B = Line B (inverted), or DIFFerential = Differential (A-B).

Sets the source of the ARINC 429 signal. The query returns the currently set source of the ARINC 429 signal.

NameTypeValuesDescription
sourceenumCHANnel<n>Source channel for the ARINC 429 signal.
enum - Currently set source of the ARINC 429 signal.

Sets the ARINC 429 signal speed. LOW selects 12.5 kb/s, HIGH selects 100 kb/s, and USER enables a user-defined baud rate via :SBUS<n>:A429:BAUDrate.

NameTypeValuesDescription
speedenumLOW | HIGH | USERARINC 429 signal speed setting.
enum - Returns the current ARINC 429 signal speed setting.

Sets the ARINC 429 trigger label value when labels are used in the selected trigger type. To set the label value to don't cares (0xXX), set the value to -1.

NameTypeValuesDescription
valueinteger0 - 2558-bit label value in decimal, hexadecimal, octal, or string form.
integer - Returns the current label value in decimal format.

Defines the ARINC 429 data pattern resource according to the specified binary string. If more bits are sent than specified by :SBUS<n>:A429:FORMat, the most significant bits are truncated.

NameTypeValuesDescription
stringstring-Binary pattern string, with characters 0, 1, or X.
string - Returns the current settings of the specified ARINC 429 data pattern resource in binary string format.

Defines the ARINC 429 two-bit SDI pattern resource according to the string parameter. The specified SDI is only used if :SBUS<n>:A429:FORMat includes the SDI field.

NameTypeValuesDescription
stringstring-Two-bit SDI pattern string, where n ::= {0 | 1 | X}; length is always 2 bits.

Defines the ARINC 429 two-bit SSM pattern resource from a binary string. The specified SSM is only used if the :SBUS<n>:A429:FORMat includes the SSM field.

NameTypeValuesDescription
stringstring-Binary string value for the two-bit SSM pattern, with n limited to {0, 1, X} and length always 2 bits.
string - Returns the current settings of the specified ARINC 429 two-bit SSM pattern resource in binary string format.

Defines a range of ARINC 429 label values used when the LRANge trigger type is selected.

NameTypeValuesDescription
mininteger0 - 255Lower label value of the trigger range.
maxinteger0 - 255Upper label value of the trigger range.

Sets the ARINC 429 trigger condition for the selected bus. The trigger can be set to word, label, parity, error, range, or bit-based conditions.

NameTypeValuesDescription
conditionenumWSTArt | WSTOp | LABel | LBITs | PERRor | WERRor | GERRor | WGERrors | ALLerrors | LRANge | ABITs | AOBits | AZBitsSelects the ARINC 429 trigger condition.

Returns the Spec error count, which is the sum of Ack, Form, Stuff, and CRC errors.

integer - The Spec error count in NR1 format.

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

real (%) - Percent utilization.

Specifies whether CAN symbolic data is displayed as symbolic values from the DBC file or as hexadecimal values in the decode waveform and Lister window. The query returns the CAN decode display type.

NameTypeValuesDescription
typeenumHEXadecimal | SYMBolicSelects the CAN display format used for decoded symbolic data.
enum - Returns the CAN decode display type.

Sets the CAN FD sample point, the point during the bit time where the bit level is sampled to determine whether the bit is dominant or recessive. The setting is expressed as an even numbered percentage from 30 to 90 in NR3 format.

NameTypeValuesDescription
valuereal30 - 90Even numbered percentage value for the CAN FD sample point.
real (%) - Returns the current CAN FD sample point setting as an even numbered percentage from 30 to 90 in NR3 format.

Selects the CAN FD frame decode standard used when decoding or triggering on FD frames. This setting has no effect on non-FD (classical) frames.

NameTypeValuesDescription
stdenumISO | NISOCAN FD frame decode standard.

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

NameTypeValuesDescription
percentreal30.0 - 90.0Percentage of the bit time at which the CAN bit level is sampled.

Sets the standard baud rate of the CAN signal. Values from 10 kb/s to 4 Mb/s must be entered in 100 b/s increments; 5 Mb/s is also allowed.

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

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

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

Sets the CAN FD baud rate for the selected serial bus channel. The value is rounded to the nearest 100 b/s if needed.

NameTypeValuesDescription
baudrateinteger10000 - 10000000CAN FD baud rate to set, in 100 b/s increments.

Sets the source for the CAN signal. The query returns the current source for the CAN signal.

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

Sets the CAN trigger condition for the selected :SBUS<n> bus. The available conditions include frame, error, overload, message, and symbolic message/signal trigger types.

NameTypeValuesDescription
conditionenumSOF | EOF | IDData | DATA | FDData | IDRemote | IDEither | ERRor | ACKerror | FORMerror | STUFferror | CRCerror | SPECerror | ALLerrors | BRSBit | CRCDbit | EBActive | EBPassive | OVERload | MESSage | MSIGnal | FDMSignalCAN trigger condition to set.

Specifies, in certain error and bit trigger modes, whether triggers are filtered by CAN IDs.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables CAN ID trigger filtering.

Defines the CAN data pattern resource from a string parameter. The string may be binary or hexadecimal with X and $ don't-care characters, and is used with the data length setting to control the data pattern searched for in CAN messages.

NameTypeValuesDescription
stringstring-Binary or hexadecimal pattern string; binary uses 0, 1, and X, while hexadecimal may start with 0x and uses hex digits plus X.
string - Returns the current CAN data pattern resource in binary string format.
:SBUS<n>:CAN:TRIGger:PATTern:DATA <string>
:SBUS<n>:CAN:TRIGger:PATTern:DATA?

Specifies the DLC value to be used in CAN FD data trigger mode. A valid FD value may be set, or -1 to indicate "don't care".

NameTypeValuesDescription
dlcinteger-1 - 64DLC value to use for the CAN FD data trigger mode.

Sets the number of 8-bit bytes in the CAN data string. The value can be from 1 to 8 bytes, and the data bytes 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.

Specifies the starting byte position for CAN FD data triggers. CAN FD frames can have up to 64 bytes of data, and the setting lets you trigger on data anywhere within the frame.

NameTypeValuesDescription
startinteger0 - 63Starting byte position.
integer - Returns the starting byte position setting.

Defines the CAN identifier pattern resource from a string parameter. The string may be binary using 0, 1, and X (or $) characters, or hexadecimal when prefixed with "0x"; the pattern is always 29 bits and longer strings are truncated.

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

Sets the CAN identifier mode. Standard selects the standard 11-bit identifier and Extended selects the extended 29-bit identifier.

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

Specifies the CAN symbolic message to trigger on when CAN symbolic data has been loaded into the oscilloscope and the CAN trigger mode is set to MESSage or MSIGnal.

NameTypeValuesDescription
namestring-Quoted ASCII string specifying the message.
string - Returns the specified message as a quoted ASCII string.

Specifies the CAN symbolic signal to trigger on after symbolic data has been loaded into the oscilloscope and the CAN trigger mode is set to MSIGnal.

NameTypeValuesDescription
namestring-Quoted ASCII string naming the signal to trigger on.
string - Returns the specified signal as a quoted ASCII string.

Specifies the signal value to trigger on when CAN symbolic data has been loaded into the oscilloscope and CAN trigger mode is set to MSIGnal. Encoded signal values are not supported in the remote interface.

NameTypeValuesDescription
datanumeric-Signal value in NR3 format.
numeric - Returns the specified signal value in NR3 format.

Sets or queries the CXPI baud rate for the selected bus. The baud rate can be set from 9600 b/s to 40000 b/s in 100 b/s increments; default is 20 kb/s.

NameTypeValuesDescription
baudrateinteger9600 - 40000Baud rate setting in 100 b/s increments.
integer (b/s) - Returns the baud rate setting.

Specifies whether the parity bit should be displayed in the identifier field. When OFF, the upper bit is masked; parity is still checked and only displayed if a parity error occurs.

NameTypeValuesDescription
ninteger-Subsystem number.
stateenum0 | OFF | 1 | ONSets parity display on or off.

Selects the oscilloscope channel connected to the CXPI signal line. The query returns the selected oscilloscope channel source.

NameTypeValuesDescription
sourceenumCHANnel<n>Oscilloscope channel to use as the CXPI signal line source.
enum - Returns the selected oscilloscope channel source.

Sets the tolerance as a percentage of the Tbit width. The query returns the current tolerance setting.

NameTypeValuesDescription
percentinteger1 - 30Tolerance percentage in NR1 format.
integer - Returns the tolerance setting as a percentage.

Selects the CXPI trigger type for the selected bus source. The query returns the current trigger type setting.

NameTypeValuesDescription
modeenumSOF | EOF | PTYPe | ID | DATA | LDATa | CRCerror | PARityerror | IBSerror | IFSerror | FRAMingerror | DLENgtherror | SAMPleerror | ALLerrors | SLEepframe | WAKeuppulseCXPI trigger type to select.
enum - Current CXPI trigger type setting.

Enables or disables modifying the CXPI trigger so it occurs only for a specified ID when triggering on certain error conditions.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether ID filtering is disabled or enabled.
enum - Returns the current ID filter setting.

Specifies whether CXPI trigger on data should occur when the special PTYPE byte is present or not present. Use ON to trigger when PTYPE is present, or OFF to trigger when it is not present.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether the trigger is set for PTYPE present or absent.
enum - Returns the PTYPE trigger setting as 0 or 1.

Specifies the CXPI trigger pattern data value for trigger types that support data triggering. The data value may be entered as a quoted binary string or as a quoted hexadecimal string.

NameTypeValuesDescription
stringstring-Data value to use in the trigger pattern.
string - Returns the specified data value as a quoted binary format string.

Sets the data length used for CXPI pattern trigger-on-data conditions. The value is limited by the DLC setting of :SBUS<n>:CXPI:TRIGger:PATTern:INFO:DLC.

NameTypeValuesDescription
lengthinteger0 - 12Data length to trigger on, in bytes.
integer - Returns the data length setting.

Sets the start byte location for a CXPI pattern trigger data value. Use it when triggering on long frames to specify where the data value should be found.

NameTypeValuesDescription
startinteger0 - 124Start byte location, in NR1 format.
integer - Returns the start byte setting, in NR1 format.

Sets the CXPI trigger pattern frame ID value for the selected bus. For trigger types that allow frame ID specification or filtering by frame ID, this command defines the frame ID used.

NameTypeValuesDescription
stringstring-Frame ID value, expressed as a quoted binary-format string or as a hexadecimal-format string with 0x prefix.
string - Returns the specified frame ID value as a quoted binary-format string.

Specifies the Count (CT) value of the CXPI frame to trigger on for trigger types that allow triggering on data, frame ID, and frame information bits. The value is a two-bit binary string.

NameTypeValuesDescription
stringstring-Two-bit binary CT value, written as "nn" where n is 0, 1, or X.
string - Returns the specified CT bits included in the trigger.

Sets the data length code used for CXPI trigger pattern matching on data-trigger types. The allowed range depends on trigger mode: DATA mode accepts -1 to 15, and LDATa mode accepts -1 to 255.

NameTypeValuesDescription
dlcinteger-1 - 15Data length code of the CXPI frame to trigger on.

Specifies the Network Management (NM) value of the CXPI frame to trigger on. This is a two-bit binary value.

NameTypeValuesDescription
stringstring-Two-bit binary NM value, printed as "nn" where n is 0, 1, or X.

Automatically configures oscilloscope settings to facilitate FlexRay triggering and serial decode. It sets the selected source channel impedance, probe attenuation, trigger level, Noise Reject, Serial Decode, and the trigger to the specified serial bus.

Sets the FLEXray baud rate. The allowed settings are 2.5 Mb/s, 5 Mb/s, or 10 Mb/s.

NameTypeValuesDescription
baudrateinteger2500000 - 10000000Baud rate to use for FLEXray.
integer - Returns the current baud rate setting.

Specifies the bus channel, A or B, of the FlexRay signal.

NameTypeValuesDescription
channelenumA | BSelects the FlexRay bus channel.
enum - Returns the current bus channel setting.

Specifies the input source for the FlexRay signal. The query returns the current source.

NameTypeValuesDescription
sourceenumCHANnel<n>Input source for the FlexRay signal.
enum - The current source for the FlexRay signal.

Sets the FLEXray trigger condition. The query returns the current FLEXray trigger condition.

NameTypeValuesDescription
conditionenumFRAMe | ERRor | EVENtSelects the FLEXray trigger condition: frames, error frames/unknown bus conditions, or FlexRay event/symbol.
enum - Returns the current FLEXray trigger condition.

Selects the FlexRay error type to trigger on. The setting is only valid when the FlexRay trigger mode is set to ERRor.

NameTypeValuesDescription
error_typeenumALL | HCRC | FCRCSelects which FlexRay error type to trigger on.
:SBUS<n>:FLEXray:TRIGger:ERRor:TYPE?

Sets the frame ID used by the Byte Start Sequence (BSS) event trigger. This setting is only valid if the trigger mode is EVENt and the EVENt:TYPE is BSS.

NameTypeValuesDescription
frame_idenumALLFrame ID used for the BSS event trigger setup.
enum - Returns the current frame ID setting for the Byte Start Sequence (BSS) event trigger setup.

Selects the FlexRay event to trigger on. The setting is only valid when the FlexRay trigger mode is set to EVENt.

NameTypeValuesDescription
eventenumWAKeup | TSS | FES | DTS | BSSFlexRay event to trigger on.
enum - Returns the currently selected FLEXray event.

Sets the base of the FlexRay cycle count in the frame header to trigger on. The setting is only valid when the FlexRay trigger mode is set to FRAME.

NameTypeValuesDescription
cycle_count_baseinteger0 - 63Base of the FlexRay cycle count to trigger on.

Sets the repetition number of the FlexRay cycle count in the frame header to trigger on. This setting is only valid when the FlexRay trigger mode is set to FRAME.

NameTypeValuesDescription
cycle_count_repetitionenumALL | 2 | 4 | 8 | 16 | 32 | 64Cycle count repetition to trigger on.

Sets the FlexRay frame ID to trigger on. The setting is only valid when the FlexRay trigger mode is set to FRAMe.

NameTypeValuesDescription
frame_idenumALLFlexRay frame ID to trigger on, or ALL.

Sets the FlexRay frame type to trigger on. This setting is only valid when the FlexRay trigger mode is set to FRAME.

NameTypeValuesDescription
frame_typeenumNORMal | STARtup | NULL | SYNC | NSTArtup | NNULl | NSYNc | ALLSelects which FlexRay frame type the trigger responds to.
:SBUS<n>:FLEXray:TRIGger:FRAMe:TYPE <frame_type>
:SBUS<n>:FLEXray:TRIGger:FRAMe:TYPE?

Selects the I2S bus data alignment for the serial decoder and/or trigger when in I2S mode. The word select (WS) polarity is specified separately with :SBUS<n>:I2S:WSLow.

NameTypeValuesDescription
settingenumI2S | LJ | RJSets the I2S data alignment to standard, left justified, or right justified.
enum - Returns the currently selected I2S data alignment.

Determines the base used for the I2S decode display. The query returns the current I2S display decode base.

NameTypeValuesDescription
baseenumDECimal | HEXSelects the I2S decode display base.
enum - Returns the current I2S display decode base.

Specifies which edge of the I2S serial clock signal clocks in data. NEGative selects the falling edge and POSitive selects the rising edge.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the I2S clock edge used to clock in data.
:SBUS<n>:I2S:CLOCk:SLOPe <slope>
:SBUS<n>:I2S:CLOCk:SLOPe?

Sets the width of the I2S receiver (decoded) data word. The width can be set from 4 to 32 bits.

NameTypeValuesDescription
receiverinteger4 - 32Receiver data word width in bits.

Controls which signal is used as the serial clock (SCLK) source by the serial decoder and/or trigger when in I2S mode.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the I2S serial clock source for DSO models.

Controls which signal is used as the I2S serial data (SDATA) source for the serial decoder and/or trigger when in I2S mode.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Selects the SDATA source.
enum - Returns the current source for the I2S serial data (SDATA).

Controls which signal is used as the word select (WS) source by the serial decoder and/or trigger when in I2S mode.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the WS source for DSO models.
enum - Returns the current source for I2S word select (WS).

Sets the I2S trigger operator for the selected :SBUS<n> bus. The query returns the current I2S trigger operator.

NameTypeValuesDescription
operatorenumEQUal | NOTequal | LESSthan | GREaterthan | INRange | OUTRange | INCReasing | DECReasingI2S trigger operator to use.
enum - Returns the current I2S trigger operator.

Specifies the audio channel used for I2S trigger selection. The query returns the current audio channel for the I2S trigger.

NameTypeValuesDescription
audio_chenumRIGHt | LEFT | EITHerAudio channel to trigger on.
enum - Current audio channel for the I2S trigger.

Sets the I2S trigger data pattern searched for in each I2S message. The pattern is specified as a string whose interpretation depends on the base selected by :SBUS<n>:I2S:TRIGger:PATTern:FORMat; queried values return the current pattern.

NameTypeValuesDescription
stringstring-I2S trigger data pattern string. Allowed characters depend on the selected base: decimal, binary, or hexadecimal.
string - Returns the currently specified I2S trigger data pattern.

Sets the entry number base used by :SBUS<n>:I2S:TRIGger:PATTern:DATA, and queries return the currently set number base for I2S pattern data. The default base is DECimal.

NameTypeValuesDescription
baseenumBINary | HEX | DECimalEntry number base to use.
enum - Returns the currently set number base for I2S pattern data.

Sets the lower and upper range boundaries used by the INRange, OUTRange, INCReasing, and DECReasing trigger conditions. The parameters may be entered in any order; the smaller value becomes the lower boundary and the larger value becomes the upper boundary.

NameTypeValuesDescription
lowerinteger-Lower range boundary.
upperinteger-Upper range boundary.

Sets the width of the transmitted I2S data word. The width can be set from 4 bits to 32 bits.

NameTypeValuesDescription
word_sizeinteger4 - 32I2S transmitted data word width in NR1 format.
integer - Returns the currently set I2S transmitted data word width.

Selects the polarity of the I2S word select (WS) signal for the specified serial bus. LEFT means WS low indicates left-channel data; RIGHt means WS low indicates right-channel data.

NameTypeValuesDescription
low_defenumLEFT | RIGHtSelects which channel is indicated when WS is low.

Determines whether the Read/Write bit is included as the LSB in the display of the IIC address field of the decode bus.

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

Sets the source for the IIC serial clock (SCL).

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Source for the IIC serial clock.
enum - Returns the current source for the IIC serial clock.

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

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Source for IIC serial data (SDA).
enum - The current source for IIC serial data.

Sets the IIC data address. The address may be given as an integer or as a hexadecimal string and can use a don't-care value to ignore the address.

NameTypeValuesDescription
valueinteger0x00 - 0x7FAddress value for IIC data.

Sets the IIC trigger pattern data. The value may be entered as an integer or as a hex string; use the don't care pattern (-1 or 0xFFFFFFFF) to ignore the data value.

NameTypeValuesDescription
valueinteger0x00 - 0x0FFIIC data value to set.
integer - Returns the current pattern for IIC data.

Sets IIC data 2 for the trigger pattern. The data value can range from 0x00 to 0x0FF, and the don't care data pattern (-1 or 0xFFFFFFFF) may be used to ignore the data value.

NameTypeValuesDescription
valuenumeric0x00 - 0x0FFData value for IIC data 2; may also be an integer or a hexadecimal string of the form "0xnn".
string - Returns the current pattern for IIC data 2.

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 query returns the current IIC trigger type value.

NameTypeValuesDescription
valueenumSTARt | STOP | RESTart | ADDRess | ANACk | DNACk | NACKnowledge | READEprom | READ7 | WRITe7 | R7Data2 | W7Data2 | WRITe10IIC trigger type to set.
enum - Current IIC trigger type value.

Specifies whether LIN symbolic data is displayed as symbolic values from the LDF file or as hexadecimal values in the decode waveform and Lister window. The query returns the LIN decode display type.

NameTypeValuesDescription
typeenumHEXadecimal | SYMBolicSelects the LIN display format.
enum - Returns the LIN decode display type.

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

NameTypeValuesDescription
displayenum1 | ON | 0 | OFFSets whether parity bits are shown as the MSB in the Frame Id display.

Sets the point during the bit time where the LIN bit level is sampled 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 baud rate.

NameTypeValuesDescription
valueenum60 | 62.5 | 68 | 70 | 75 | 80 | 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 in 100 b/s increments.

Sets the source for the LIN signal. The query returns the current source for the LIN signal.

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

Sets the LIN standard in effect for triggering and decoding. The setting selects LIN 1.3, LIN 1.3 with no length control, or LIN 2.X.

NameTypeValuesDescription
stdenumLIN13 | LIN13NLC | LIN20LIN standard to use.

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

NameTypeValuesDescription
valueinteger11 - 13Length of the LIN sync break in clock lengths.

Sets the LIN trigger condition for the selected bus. The query returns the current LIN trigger value.

NameTypeValuesDescription
conditionenumSYNCbreak | ID | DATA | PARityerror | CSUMerror | FRAMe | FSIGnalSelects 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 - 63LIN identifier value to store.

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

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

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

NameTypeValuesDescription
lengthinteger1 - 8Number of 8-bit bytes in the LIN data string.
:SBUS<n>:LIN:TRIGger:PATTern:DATA:LENGth <length>

Sets the entry number base used by :SBUS<n>:LIN:TRIGger:PATTern:DATA, and the same setting is available by query. The default base is BINary.

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

Specifies the LIN symbolic message to trigger on when symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FRAMe or FSIGnal.

NameTypeValuesDescription
namestring-Quoted ASCII string naming the message to trigger on.
string - Returns the specified message as a quoted ASCII string.

Specifies the signal to trigger on when LIN symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FSIGnal.

NameTypeValuesDescription
namestring-Quoted ASCII string identifying the signal to trigger on.
string - Returns the specified signal as a quoted ASCII string.
:SBUS<n>:LIN:TRIGger:SYMBolic:SIGNal <name>
:SBUS<n>:LIN:TRIGger:SYMBolic:SIGNal?

Specifies the signal value to trigger on when LIN symbolic data has been loaded into the oscilloscope and the LIN trigger mode is set to FSIGnal. Encoded signal values are not supported in the remote interface.

NameTypeValuesDescription
datanumeric-Signal value in NR3 format.
numeric - Returns the specified signal value in NR3 format.

Automatically sets MIL-STD-1553 decode and trigger options for the specified serial bus. It sets the trigger thresholds to ±1/3 division based on the source channel V/div, Noise Reject off, Probe Attenuation to 10.0, and Serial Decode on.

Determines the base used for the MIL-STD-1553 decode display. The query returns the current MIL-STD-1553 display decode base.

NameTypeValuesDescription
baseenumBINary | HEXSelects the decode display base.
enum - Current MIL-STD-1553 display decode base.

Sets the source of the MIL-STD 1553 signal. Use the trigger level commands to set threshold levels for the selected source.

NameTypeValuesDescription
sourceenumCHANnel<n>Source channel for the MIL-STD 1553 signal.

Sets the 11 bits to trigger on when the trigger type has been set to RTA11 (RTA + 11 Bits). The value is an 11-character string made up of 0, 1, or X.

NameTypeValuesDescription
stringstring-11-bit trigger pattern string.

Sets the Remote Terminal Address (RTA) to trigger on when the trigger type has been set to RTA or RTA11. To set the RTA value to don't cares (0xXX), set the value to -1.

NameTypeValuesDescription
valueinteger0 - 31Remote Terminal Address value to trigger on; may be entered as decimal, nondecimal (#Hnn), or string ("0xnn").

Specifies the MIL-STD-1553 trigger type to be used for :SBUS<n>:M1553 triggering. The query returns the currently set trigger type.

NameTypeValuesDescription
typeenumDSTArt | DSTOp | CSTArt | CSTOp | RTA | PERRor | SERRor | MERRor | RTA11MIL-STD-1553 trigger type.
enum - Currently set MIL-STD-1553 trigger type.

Sets the Manchester bus decode and Lister display base for :SBUS<n>:MANChester when the display format is WORD. When the display format is BIT, BINary is the only legal value.

NameTypeValuesDescription
baseenumHEX | DECimal | ASCii | BINaryBase for the Manchester bus decode and Lister display.

Specifies the baud rate of the Manchester signal.

NameTypeValuesDescription
baudrateinteger500 - 5000000Baud rate in 100 b/s increments.

Sets the Manchester bus bit order when the display format is WORD. The query returns the current bit order setting.

NameTypeValuesDescription
bitorderenumMSBFirst | LSBFirstSpecifies whether the most significant or least significant bit is transmitted first.
enum - Returns the bit order setting.

Specifies the format of the Manchester bus display. The query returns the bus display format setting.

NameTypeValuesDescription
formatenumBIT | WORDFormat of the Manchester bus display.
enum - The bus display format setting.

Sets the number of words in the data field of the Manchester protocol definition when the display format is WORD. AUTO is only available when the trailer field size is 0.

NameTypeValuesDescription
modeenumAUTOSelects automatic sizing.
wordsinteger1 - 255Number of words in the data field, in NR1 format.

Sets the number of bits in the header field of the Manchester protocol definition when the display format is WORD. The query returns the current header field bits setting.

NameTypeValuesDescription
<#bits>integer0 - 32Number of bits in the header field of the Manchester protocol definition.
integer - Returns the number of header field bits setting.

Specifies the minimum idle time or inter-frame gap time in terms of the number of bits. The value is set in NR3 format.

NameTypeValuesDescription
#bitsreal1.50 - 32.00Minimum idle time in bits.

Specifies the polarity of the Manchester signal. Falling edge encodes logic 1 and rising edge encodes logic 0, or vice versa depending on the selected setting.

NameTypeValuesDescription
logicenumFALLing | RISingSelects the Manchester signal polarity.

Selects the oscilloscope channel connected to the Manchester signal line. The query returns the currently selected channel source.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Channel source to use for the Manchester signal line.
enum - The selected oscilloscope channel source.

Specifies the number of sync bits for the Manchester signal. The query returns the current sync bits setting.

NameTypeValuesDescription
#bitsinteger0 - 255Number of sync bits.
integer - Returns the number of sync bits setting.

Specifies the starting edge of the Manchester signal. The query returns the current starting edge number setting.

NameTypeValuesDescription
edge#integer1 - 256Starting edge number in NR1 format.
integer - Starting edge number setting.

Specifies the tolerance for the Manchester signal in terms of the percentage of the bit period.

NameTypeValuesDescription
percentreal5 - 30Tolerance percentage in NR1 format.
real - Returns the tolerance setting as a percentage in NR1 format.

Specifies the Manchester trigger mode for the selected serial bus. The query returns the current trigger mode setting.

NameTypeValuesDescription
modeenumSOF | VALue | MERRorSets the Manchester trigger mode to start of frame, specified bit values, or Manchester error.
enum - Returns the current Manchester trigger mode setting.

Sets the trigger value used when the Manchester trigger mode is set to VALue. The value is specified as a binary string, optionally with an 0x prefix for hexadecimal, and its bit width is set by the WIDTH command.

NameTypeValuesDescription
stringstring-Trigger value to match; format is binary digits or 0x-prefixed hexadecimal digits with X and $ allowed.
string - Returns the specified trigger value as a string of binary digits.

Sets the bit width (length) of the value to trigger on when VALue trigger mode is selected. The actual trigger value is set with :SBUS<n>:MANChester:TRIGger:PATTern:VALue:DATA.

NameTypeValuesDescription
widthinteger4 - 128Bit width (length) of the value to trigger on.
integer - Returns the specified trigger value bit width (length).

Sets the number of bits in the trailer field of the Manchester protocol definition when the display format is WORD. The query returns the current trailer field bit setting.

NameTypeValuesDescription
#bitsinteger0 - 32Number of bits in the trailer field.
integer - Returns the number of trailer field bits setting.

Sets the number of bits per word in the Manchester protocol definition when the display format is WORD. The query returns the current number of bits per word setting.

NameTypeValuesDescription
#bitsinteger2 - 32Number of bits per word, in NR1 format.
integer - Returns the number of bits per word setting.

Sets the decode number base for the NRZ bus decode and Lister display when the display format is WORD. When the display format is BIT, BINary is the only legal value.

NameTypeValuesDescription
baseenumHEX | DECimal | ASCii | BINaryDecode number base to use for NRZ display.

Specifies the baud rate of the NRZ signal.

NameTypeValuesDescription
baudrateinteger5000 - 5000000Baud rate in 100 b/s increments.

Sets the bit order used for NRZ transmission when the display format is WORD. The query returns the current bit order setting.

NameTypeValuesDescription
bitorderenumMSBFirst | LSBFirstSpecifies the order of transmission on the NRZ bus.
enum - Returns the bit order setting.

Specifies the format of the NRZ bus display. The query returns the current bus display format setting.

NameTypeValuesDescription
formatenumBIT | WORDBus display format.
enum - Returns the bus display format setting.

Specifies the number of words in the data field of the NRZ protocol definition when the display format is WORD. AUTO is available only when the trailer field size is 0.

NameTypeValuesDescription
#wordsinteger1 - 255Number of words in the data field.
integer - Returns the number of data field words setting; returns 0 in AUTO mode.

Sets the total NRZ frame size when the NRZ bus display format is BIT. The specified frame size is equivalent to the sum of the header, data, and trailer field bit counts in WORD format.

NameTypeValuesDescription
#bitsinteger2 - 255Total frame size in bits, specified in NR1 format.
integer - Returns the specified total frame size.

Sets the number of bits in the header field of the NRZ protocol definition when the display format is WORD. The query returns the current header field bits setting.

NameTypeValuesDescription
#bitsinteger0 - 32Number of bits in the header field of the NRZ protocol definition.
integer - The number of header field bits setting.

Specifies the minimum idle time or inter-frame gap time in terms of the number of bits. The query returns the specified idle time in bits.

NameTypeValuesDescription
#bitsreal1.50 - 32.00Minimum idle time in NR3 format.
real - Returns the specified idle time in terms of the number of bits.

Specifies the idle state of the NRZ signal. The query returns the current idle state setting.

NameTypeValuesDescription
stateenumLOW | HIGHIdle state for the NRZ signal.

Specifies the polarity of the NRZ signal. HIGH uses a positive voltage for logic 1 and a negative voltage for logic 0; LOW uses a negative voltage for logic 1.

NameTypeValuesDescription
logicenumHIGH | LOWSets the NRZ signal polarity.

Selects the oscilloscope channel connected to the NRZ signal for the specified serial bus input.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Oscilloscope channel source to use.

Specifies the number of start bits for the NRZ signal.

NameTypeValuesDescription
#bitsinteger0 - 255Number of start bits, expressed in NR1 format.

Specifies the trigger mode for NRZ bus triggering. SOF triggers at the start of a frame; VALue triggers on specified bit values.

NameTypeValuesDescription
modeenumSOF | VALueTrigger mode setting.
enum - Returns the trigger mode setting.

Specifies the trigger value used when VALue trigger mode is selected. The value bit order is always interpreted as bits arrive (MSB first), regardless of the serial decode bit order setting, and the bit width is set by the WIDTh command.

NameTypeValuesDescription
stringstring-Trigger value to use, expressed as a binary string or as a hexadecimal string prefixed with 0x.
string - Returns the specified trigger value as a string of binary digits.

Sets the bit width (length) of the value to trigger on when VALue trigger mode is selected. The actual trigger value is set with :SBUS<n>:NRZ:TRIGger:PATTern:VALue:DATA.

NameTypeValuesDescription
widthinteger4 - 128Bit width (length) of the value to trigger on.
integer - Returns the specified trigger value bit width (length).

Sets the number of bits in the trailer field of the NRZ protocol definition when the display format is WORD. The query returns the current trailer field bit setting.

NameTypeValuesDescription
#bitsinteger0 - 32Number of bits in the trailer field, specified in NR1 format.
integer - Number of trailer field bits setting.

Specifies the number of bits per word in the data field of an NRZ protocol definition when the display format is WORD. The query returns the current bits-per-word setting.

NameTypeValuesDescription
#bitsinteger2 - 32Number of bits per word, entered in NR1 format.
integer - Number of bits per word setting.

Specifies the nominal SENT clock period (tick). The query returns the current clock period setting.

NameTypeValuesDescription
periodreal500 ns - 300 usNominal clock period (tick), in NR3 format.
real (s) - The current clock period setting.

Sets the CRC format used for SENT fast channel messages and short serial message CRCs. Enhanced Serial Message CRCs always use the 2010 format.

NameTypeValuesDescription
formatenumLEGacy | RECommendedSpecifies the CRC format.
enum - Returns the CRC format setting.

Sets the SENT decode number base used by the decoder for raw data nibbles, defined signals in other formats, and Serial Message data fields. When SYMBolic is selected, Fast Channel Signals are displayed as calculated physical values; CRC and Slow Channel information are displayed in hex.

NameTypeValuesDescription
baseenumHEX | DECimal | SYMBolicNumber base used by the decoder.

Sets the SENT message decode/triggering format for the selected bus. The choice affects both decoding and triggering.

NameTypeValuesDescription
decodeenumNIBBles | FSIGnal | FSSerial | FESerial | SSERial | ESERialSelects the message decode/triggering format.

Specifies the idle state of the SENT bus. The query returns the idle state setting.

NameTypeValuesDescription
stateenumLOW | HIGHSets the SENT bus idle state.
enum - The idle state setting.

Sets the number of nibbles in a SENT message. The query returns the current nibble setting.

NameTypeValuesDescription
#_nibblesinteger1 - 6Number of nibbles in the SENT message.
integer - Returns the number of nibbles setting.

Specifies whether there is a pause pulse between Fast Channel Messages on the SENT serial bus. The query returns the current pause mode setting.

NameTypeValuesDescription
modeenum0 | OFF | 1 | ON | SPCSelects the SENT pause pulse mode: no pause pulse, pause pulses enabled, or Short PWM Code (SPC).
enum - Returns the current pause mode setting.

Specifies whether the given signal is on or off. The query returns the signal on/off setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONOn/off state for the selected signal.
enum - Returns the signal on/off setting.

Specifies the bit length of the signal being defined. The query returns the current signal bit length setting.

NameTypeValuesDescription
sinteger1 - 6Signal index.
lengthinteger1 - 24Bit length of the signal being defined.
integer - Returns the signal bit length setting.

Sets the multiplier used to calculate a physical value displayed for a Fast Channel Signal when the display mode is SYMBolic. The query returns the current multiplier value.

NameTypeValuesDescription
<multiplier>real1 - 24Multiplier value in NR3 format.
real - Returns the multiplier value for the Fast Channel Signal.

Sets the offset value for the Fast Channel Signal. When the display mode is SYMBolic, this offset is used in calculating the physical value displayed for the Fast Channel Signal.

NameTypeValuesDescription
offsetreal1 - 24Offset value in NR3 format.

Specifies the nibble order of the signal being defined for fast signal decoding, either most-significant nibble first or least-significant nibble first.

NameTypeValuesDescription
orderenumMSNFirst | LSNFirstSets the nibble order to most-significant nibble first or least-significant nibble first.
:SBUS<n>:SENT:SIGNal<s>:ORDer <order>

Specifies the starting bit of the Fast Signal being defined. The query returns the Fast Signal starting bit setting.

NameTypeValuesDescription
positioninteger0 - 23Starting bit position of the Fast Signal.
integer - Returns the Fast Signal starting bit setting.

Specifies the input channel for SENT decode and triggering. The query returns the currently specified SENT input source.

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Input source for SENT decode and triggering.
enum - Returns the specified SENT input source.

Sets the tolerance used to determine whether the sync pulse is valid. The query returns the current tolerance setting.

NameTypeValuesDescription
percentreal3 - 30Tolerance percentage in NR1 format.
real (%) - Returns the tolerance setting.

Sets the SENT trigger mode. The query returns the current trigger mode setting.

NameTypeValuesDescription
modeenumSFCMessage | SSCMessage | FCData | SCMid | SCData | TOLerror | FCCerror | SCCerror | CRCerror | PPERror | SSPerrorSelects the SENT trigger condition.
enum - Returns the current trigger mode setting.

Specifies the status and data nibbles that are triggered on when FCData trigger mode is chosen. The query returns the fast channel data trigger setting.

NameTypeValuesDescription
stringstring-String specifying the fast channel data trigger setting.
string - Fast channel data trigger setting.

Specifies the data to trigger on for the Slow Channel Message ID and Data trigger mode. The query returns the current slow channel ID and data trigger data value setting.

NameTypeValuesDescription
datainteger-1 - 65535Data value to trigger on when ILENgth is SHORt.
integer - Returns the data value setting for the slow channel ID and data trigger.

Specifies the ID to trigger on for the "Slow Channel Message ID" and "Slow Channel Message ID & Data" trigger modes. The allowed range depends on the slow-channel message length setting.

NameTypeValuesDescription
idinteger-1 - 15ID to trigger on when ILENgth is SHORt.

Specifies the ID and data lengths for the Slow Message Enhanced messages. Use SHORt for the 4-bit ID, 16-bit data format or LONG for the 8-bit ID, 12-bit data format.

NameTypeValuesDescription
lengthenumSHORt | LONGSelects the ID and data length format.
:SBUS<n>:SENT:TRIGger:SLOW:ILENgth <length>
:SBUS<n>:SENT:TRIGger:SLOW:ILENgth?

Sets the trigger tolerance variation considered a violation for :SBUS<n> SENT triggering. The tolerance can be from 1 to 28 percent and must not exceed the associated :SBUS<n>:SENT:TOLerance setting minus two percent.

NameTypeValuesDescription
percentinteger1 - 28Tolerance variation percent setting in NR1 format.
integer - Returns the tolerance variation percent setting.

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

NameTypeValuesDescription
orderenumLSBFirst | MSBFirstSets the bit order, either least significant bit first or most significant bit first.

Sets the SPI clock source slope used to clock in the data. Use POSitive for the rising edge or NEGative for the falling edge.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSpecifies whether the SPI clock source uses the falling or rising edge.

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 time seconds in NR3 format.

Specifies the number of bits to ignore before decoding the MISO stream. The query returns the specified number of delay bits, or "OFF" if there are none.

NameTypeValuesDescription
valueenumOFF | 2-63Number of bits to ignore before decoding the MISO stream.
enum - Returns the specified number of delay bits, or "OFF" if there are none.

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

NameTypeValuesDescription
valueenumCHIPselect | NCHipselect | NOTC | TIMeoutSPI trigger framing value.

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 for DSO models.
enum - Current source for the SPI serial clock.

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

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalFrame source for DSO models.
sourceenumCHANnel<n> | DIGital<d>Frame source for MSO models.

Sets the source for the SPI serial MISO data. The allowed source keywords depend on the model family (DSO or MSO).

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | CHANnel<n> | DIGital<d>Selects the source used for SPI MISO data.
enum - Returns the current source for the SPI serial MISO data.

Sets the source for the SPI serial MOSI data. The valid source depends on the model family: DSO models use channel or external sources, while MSO models use channel or digital sources.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the SPI serial MOSI data on DSO models.

Defines the SPI data pattern resource from a string parameter. The string may be binary using 0, 1, and X, or hexadecimal if prefixed with "0x"; set :SBUS<n>:SPI:TRIGger:PATTern:MISO:WIDTh before using this command.

NameTypeValuesDescription
stringstring-Pattern string made up of 0, 1, and X, or a hexadecimal string beginning with "0x" and containing hexadecimal digits and X characters.
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 can be set from 4 to 64 bits and should be set before :SBUS<n>:SPI:TRIGger:PATTern:MISO:DATA.

NameTypeValuesDescription
widthinteger4 - 64SPI data pattern width in bits.

Defines the SPI MOSI data pattern resource from a string parameter. The string may be binary (0, 1, X, $) or hexadecimal if it starts with "0x"; set the MOSI width before using this command.

NameTypeValuesDescription
stringstring-Binary or hexadecimal pattern string used to define the SPI data pattern resource.
string - Returns the current settings of the specified SPI data pattern resource in binary string format.

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

NameTypeValuesDescription
widthinteger4 - 64Width of the SPI data pattern 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 whether the SPI trigger uses MOSI data or MISO data.
enum - Returns the current SPI trigger type setting.

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

NameTypeValuesDescription
word_widthinteger4 - 16Number of bits in a SPI word, specified as an NR1 integer from 4 to 16.
integer - Current SPI decode word width.

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

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

Sets 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, or to the specific values of 10 Mb/s or 12 Mb/s.

NameTypeValuesDescription
baudrateinteger100 - 8000000Bit rate in bps for the UART serial decoder and/or trigger.
:SBUS<n>:UART:BAUDrate <baudrate>

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

NameTypeValuesDescription
bitorderenumLSBFirst | MSBFirstBit order used for UART mode transmission.

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

NameTypeValuesDescription
valueenumOFFFraming control keyword or a byte value for UART decode framing.
enum - Returns the current UART decode base setting as OFF or an 8-bit decimal value.

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

NameTypeValuesDescription
parityenumEVEN | ODD | NONEParity setting to use.

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.
enum - Returns the current UART polarity setting.

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

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | DIGital<d>Selects the UART Rx source.
enum - Returns the current source for the UART Rx signal.

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

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSelects the Tx source for DSO models.

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

NameTypeValuesDescription
baseenumASCii | HEXSelects the UART trigger data base.
enum - Returns the current UART base setting.

Selects the UART trigger burst value, i.e. the Nth frame after the idle period, for UART trigger mode. The value may be set to OFF or a burst count from 1 to 4096.

NameTypeValuesDescription
valueenumOFF | 1 to 4096 in NR1 formatBurst value (Nth frame after idle period) for UART trigger mode.
enum - Current UART trigger burst value.

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

NameTypeValuesDescription
valueinteger0 - 2558-bit data byte value to use for the UART trigger qualifier; may be entered in decimal, hexadecimal, binary, or quoted-string form.

Sets the UART trigger idle period used for burst trigger operation in UART mode. The value must be between 1 us and 10 s in NR3 format.

NameTypeValuesDescription
time_valuereal1 us - 10 sIdle period time for UART burst trigger.
real (s) - Returns the current UART trigger idle period time.

Selects the data qualifier used for UART triggers 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 | LESSthanData qualifier for the UART trigger.
enum - Current UART trigger qualifier.

Selects the UART trigger type for the specified bus. 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 used by the serial decoder and/or trigger when in UART mode. The current setting can be queried with the corresponding ? form.

NameTypeValuesDescription
widthinteger5 - 9Number of bits per UART message byte.
:SBUS<n>:UART:WIDTh <width>
:SBUS<n>:UART:WIDTh?

Determines the base used for USB decode and Lister display, controlling how the data or payload field is displayed. All other fields are displayed in hex.

NameTypeValuesDescription
baseenumASCii | BINary | DECimal | HEXSpecifies the display base for USB decode and Lister display.

Specifies which signal is used as the USB D- source for the selected bus. The D- source is only used for Low and Full Speed USB.

NameTypeValuesDescription
sourceenumCHANnel<n>Selects the source signal for the USB D- input.

Specifies which signal is used as the USB D+ source for the selected bus. The D+ source is only used for Low and Full Speed USB.

NameTypeValuesDescription
sourceenumCHANnel<n>Selects the source signal for USB D+; for MSO models, digital channels are also allowed.

Specifies which signal is used as the differential source for the selected bus. Differential sources are only used for High Speed USB.

NameTypeValuesDescription
sourceenumCHANnel<n>Selects the differential source channel.
enum - Returns the specified differential source.

Specifies the USB interface speed for the selected bus. The query returns the current speed setting.

NameTypeValuesDescription
speedenumLOW | FULL | HIGHUSB interface speed setting.
enum - Returns the speed setting.

Specifies the USB trigger mode for the selected bus. The query returns the specified USB trigger mode.

NameTypeValuesDescription
conditionenumSOP | EOP | ENTersuspend | EXITsuspend | RESet | TOKen | DATA | HANDshake | SPECial | ALLerrors | PIDerror | CRC5error | CRC16error | GLITcherror | STUFFerror | SE1errorUSB trigger mode to set.
enum - Specified USB trigger mode.

Specifies the 7-bit Address portion of the USB trigger for the selected bus, in binary or hex.

NameTypeValuesDescription
stringstring-7-bit address value, entered as a binary string or hexadecimal string.

Specifies the CRC portion of the USB trigger for the selected bus, in binary or hex. The query returns the specified CRC portion.

NameTypeValuesDescription
stringstring-CRC value to set, formatted either as a binary string or as hexadecimal.
string - Returns the specified CRC portion of the trigger as a string.

Specifies the Data portion of the trigger for the selected bus, in binary or hex. See :SBUS<n>:USB:TRIGger:DATA:LENGth for setting the data value length.

NameTypeValuesDescription
stringstring-Data portion of the trigger value, formatted as binary or hex string.
:SBUS<n>:USB:TRIGger:DATA <string>
:SBUS<n>:USB:TRIGger:DATA?

Specifies the USB trigger data length in bytes. The query returns the specified data length.

NameTypeValuesDescription
lengthinteger1 - 20Data length in bytes.
integer - Specified data length.

Specifies the 4-bit Endpoint portion of the trigger for the selected bus, in binary or hex. The query returns the specified Endpoint portion.

NameTypeValuesDescription
stringstring-4-bit Endpoint value, expressed as binary or hex text.
string - The specified Endpoint portion of the trigger, returned as a string.

Specifies the 2-bit ET portion of the trigger for the selected bus, in binary or hex. The query returns the specified ET portion.

NameTypeValuesDescription
stringstring-ET value in binary "nn" or hex "0xn" format.
string - Returns the specified ET portion of the trigger as a string in "nn" format.

Specifies the 11-bit Frame portion of the USB trigger for the selected bus, in binary or hex. The query returns the specified Frame portion.

NameTypeValuesDescription
stringstring-11-bit frame value in binary or hexadecimal format.
string - Returns the specified Frame portion of the trigger.

Specifies the 7-bit Hub Address portion of the trigger for the selected bus, in binary or hex.

NameTypeValuesDescription
stringstring-Hub Address value, formatted as a 7-bit binary string or as a hexadecimal string.
string - Returns the specified Hub Address portion of the trigger.

Specifies the 4-bit PID check portion of the trigger for the selected bus, in binary or hex. See the PID commands for setting the PID.

NameTypeValuesDescription
stringstring-4-bit PID check portion of the trigger, expressed as either binary "nnnn" or hexadecimal "0xn".

Specifies the USB data PID to trigger on for the selected bus. The PID does not include the PID check value, which is set by :SBUS<n>:USB:TRIGger:PIDCheck.

NameTypeValuesDescription
pidenumDATA0 | DATA1 | DATA2 | MDATaSpecifies the USB data PID to trigger on.
enum - Returns the specified data PID.

Specifies the USB handshake PID to trigger on for the selected bus. The specified PID does not include the PID check value, which is set using :SBUS<n>:USB:TRIGger:PIDCheck.

NameTypeValuesDescription
pidenumACK | NAK | STALl | NYETUSB handshake PID to trigger on.
enum - Returns the specified handshake PID.

Specifies the USB special PID to trigger on for the selected bus. The specified PID does not include the PID check value, which is set using :SBUS<n>:USB:TRIGger:PIDCheck.

NameTypeValuesDescription
pidenumPING | PRE | ERR | SPLitUSB special PID to trigger on.
enum - Returns the specified special PID.

Specifies the USB token PID to trigger on for the selected bus. The query returns the specified token PID.

NameTypeValuesDescription
pidenumOUT | IN | SETup | SOFUSB token PID to trigger on.
enum - Returns the specified token PID.

Specifies the 7-bit Port portion of the trigger for the selected bus, in binary or hex. The query returns the specified Port portion of the trigger.

NameTypeValuesDescription
stringstring-7-bit port value encoded as either binary or hex.
string - Specified Port portion of the trigger.

Specifies the 1-bit SC portion of the trigger for the selected bus, in binary or hex.

NameTypeValuesDescription
stringstring-SC portion value in binary or hex, formatted as "n" or "0xn".

Specifies the 2-bit S and E or U portion of the trigger for the selected bus, in binary or hex. The query returns the specified S and E or U portion of the trigger.

NameTypeValuesDescription
stringstring-Binary or hex encoded trigger bits, using 0, 1, X, and in hex form 0-9, A-F, X, as shown in the syntax.
string - The specified S and E or U portion of the trigger.

Selects the USB PD waveform source. Analog channels can be used as the source.

NameTypeValuesDescription
sourceenumCHANnel<n>Selects the USB PD waveform source.
enum - Returns the selected analog input channel.

Selects the USB PD trigger mode. The query returns the selected USB PD trigger mode.

NameTypeValuesDescription
modeenumPSTart | EOP | SOP | SPPrime | SDPRime | SPDebug | SDPDebug | HRST | CRST | CRCerror | PERRor | HEADerUSB PD trigger mode to select.
enum - The selected USB PD trigger mode.

Selects the USB Power Delivery trigger header type when Header Content trigger mode is selected. The chosen header type determines which related subcommand is used to specify the message or value details.

NameTypeValuesDescription
typeenumCMESsage | DMESsage | EMESsage | VALueSelects the trigger header type.
enum - Returns the selected header type.

Selects the USB Power Delivery control message type when Header trigger mode and Control Message header type are selected. The query returns the selected control message type.

NameTypeValuesDescription
typeenumGOODcrc | GOTOmin | ACCept | REJect | PING | PSRDy | GSRCap | GSNCap | DRSWap | PRSWap | VCSWap | WAIT | SRST | GSCX | GSTatus | FRSWap | GPSTatus | GCCodesControl message type to select.
enum - Returns the selected control message type.

Selects the USB Power Delivery data message type used when Header Content trigger mode and Data Message header type are selected. The query returns the selected data message type.

NameTypeValuesDescription
typeenumSRCap | REQuest | BIST | SNCap | BSTatus | ALERt | GCINfo | VDEFinedData message type to select.
enum - Selected data message type.

Selects the USB Power Delivery extended message type used by Header Content trigger mode. The query returns the currently selected extended message type.

NameTypeValuesDescription
typeenumSCX | STATus | GBCap | GBSTatus | BCAP | GMINfo | MINFo | SREQuest | SRESponse | FREQuest | FRESponse | PSTatus | CINFo | CCODesSelects the extended message type.
enum - Returns the selected extended message type.

Sets the user-defined USB PD header value when Header Content trigger mode and user-defined Value type are selected. The value is specified as a quoted binary-format string.

NameTypeValuesDescription
stringstring-User-defined header value in binary-format string form.

Selects an additional qualifier for the Header Content trigger when Header Content trigger mode is selected. The query returns the currently selected header content trigger qualifier.

NameTypeValuesDescription
typeenumNONE | SOP | SPRIme | SDPRimeAdditional qualifier for the Header Content trigger.
enum - Returns the selected header content trigger qualifier.

Sets the LIN signal type for the specified serial bus. The only legal value is LIN, although the syntax lists LIN, RX, and TX.

NameTypeValuesDescription
valueenumLIN | RX | TXLIN signal type to use.

Sets the source for the SPI serial MOSI data. This command is the same as :SBUS<n>:SPI:SOURce:MOSI.

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernalSource for the SPI serial MOSI data on DSO models.
enum - Returns the current source for the SPI serial MOSI data.

:SYSTem:DATEset / query

Sets the instrument date. The command performs validity checking to ensure the date is valid.

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

Returns the oscilloscope's Host ID as part of a quoted ASCII string. The exact format is product-specific, and portable programs should not parse the contents; use *IDN? for a defined portable format instead.

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

Writes a quoted ASCII string to a text box on-screen. Use `:SYSTem:DSP ""` to remotely remove the message from the display.

NameTypeValuesDescription
stringstring-Quoted ASCII string displayed in the on-screen text box, up to 75 characters.
:SYSTem:DSP <string>
:SYSTem:DSP ""
:SYSTem:ERRorset / query

Returns the next error number and error text from the error queue. Repeated queries return errors in first-in, first-out order until the queue is empty, after which zero is returned until another error occurs.

string - Returns the next error as an error number and quoted ASCII error string in the form <error number>,<error string>.<NL>
:SYSTem:LOCKset / query

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

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns front panel lock on or off.

Sets the manufacturer string portion of the identification string returned by *IDN?. The query form returns the currently set manufacturer string.

NameTypeValuesDescription
manufacturer_stringstring-Quoted ASCII string identifying the manufacturer, up to 63 characters.
string - The currently set manufacturer string.
:SYSTem:PRESetset / query

Places the instrument in a known default state, the same as pressing the front-panel Default Setup key. It resets many acquisition, channel, display, time base, and trigger settings, but leaves some user preferences unchanged; use *RST to restore all user settings to factory defaults.

Disables or enables the 50 ohm impedance setting for all analog channels. Be careful when turning it on because there is no front-panel visual indication other than the disabled 50 Ω channel input impedance selection.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns analog channel protection lock on or off.
:SYSTem:RLOGgerset / query

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

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

Specifies whether remote command logging is written 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 their return values, if applicable.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets whether remote command logging is shown on the screen.
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 containing the remote command log file name.
string - Returns the remote command log file name.

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

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

Specifies whether the screen display background for remote command logging is transparent or solid. The query returns the current transparent screen display background setting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSets the transparent screen display background setting.
enum - Returns the current transparent screen display background setting.

Sets 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.
:SYSTem:SETupset / query

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

NameTypeValuesDescription
setup_datablock-Binary block data in IEEE 488.2 # format containing the instrument setup to restore.
:SYSTem:TIMEset / query

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

NameTypeValuesDescription
timestring-Hours, minutes, and seconds in NR1 format.
string - The current system time in hours, minutes, and seconds in NR1 format.
:SYSTem:TOUChset / query

Disables or enables the touchscreen. The query returns the touchscreen's on/off status.

NameTypeValuesDescription
on_offenum1 | ON | 0 | OFFTurns the touchscreen on or off.
enum - Returns the touchscreen's on/off status.
:SYSTem:MENUset / query

Changes the front panel softkey menu.

NameTypeValuesDescription
menuenumMASK | MEASure | SEGMented | LISTer | POWerSelects the front panel softkey menu.

:TIMebase:MODEset / query

Sets the current time base mode. The available modes are MAIN, WINDow, XY, and ROLL.

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. 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.

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

Enables or disables the 10 MHz REF BNC on the rear panel. ON sets the reference signal mode to IN; OFF disables the BNC and is equivalent to setting the mode to OFF.

NameTypeValuesDescription
valueenum1 | ON | 0 | OFFEnables or disables the 10 MHz REF BNC.
:TIMebase:REFClock ON
:TIMebase:REFClock OFF

Sets the time reference for the main window display. The reference can be placed at the left, center, right, or a custom location via the related location command.

NameTypeValuesDescription
referenceenumLEFT | CENTer | RIGHt | CUSTomSelects the time reference position.
myScope.WriteString ":TIMebase:REFerence CENTer" ' Set reference to center.

Sets the time reference location as a percent of the graticule width. This command is used when :TIMebase:REFerence is set to CUSTom.

NameTypeValuesDescription
locreal0.0 - 1.0Percent of the graticule width where the time reference location is placed.
real - Returns the time base reference custom location setting.
: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_valuereals/divTime per division for the main window, expressed in NR3 format.
real (s/div) - Current horizontal scale setting in seconds per division for the main window.

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

NameTypeValuesDescription
vernier valueenum1 | ON | 0 | OFFSets the 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 maximum value is one half of the :TIMebase:RANGe value.

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

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

NameTypeValuesDescription
scale_valuerealone half of the :TIMebase:SCALe valueScale value in seconds, in NR3 format.
real (s) - Returns the current zoomed window scale setting in seconds per division.
: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 components from the trigger waveform.

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

Defines the trigger holdoff time in seconds. Holdoff prevents additional triggers until a specified time has passed since the last trigger.

NameTypeValuesDescription
holdoff_timereal40 ns - 10 sHoldoff time value in NR3 format.

Specifies the maximum trigger holdoff time when random trigger holdoff mode is enabled. The query returns the maximum random trigger holdoff time setting.

NameTypeValuesDescription
max_holdoffrealsMaximum holdoff time in seconds, in NR3 format.
real (s) - The maximum random trigger holdoff time setting.

Specifies the minimum trigger holdoff time when random trigger holdoff mode is enabled. The query returns the minimum random trigger holdoff time setting.

NameTypeValuesDescription
min_holdoffrealsMinimum holdoff time in seconds, in NR3 format.
real (s) - The minimum random trigger holdoff time setting.

Enables or disables random trigger holdoff mode. When enabled, the holdoff time is randomized from one acquisition to the next between the values set by :TRIGger:HOLDoff:MINimum and :TRIGger:HOLDoff:MAXimum.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables random trigger holdoff mode.

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

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
levelrealVHigh trigger voltage level; for internal triggers, the manual states it as 0.75 x full-scale voltage from center screen in NR3 format.
sourceenumCHANnel<n>Trigger source channel number, with n from 1 to the number of analog channels.

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
levelrealVLow trigger voltage level, specified as 0.75 x full-scale voltage from center screen 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 | SBUS{1 | 2}Trigger 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 noise reject filter off and on. When the filter is on, the trigger circuitry is less sensitive to noise but may require a greater amplitude waveform to trigger the 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 | NORMalTrigger sweep mode.
enum - Current trigger sweep mode.

Sets the arming edge slope for the Edge Then Edge trigger to rising or falling. The query returns the current arming edge slope setting.

NameTypeValuesDescription
slopeenumNEGative | POSitiveArming edge slope for the trigger.
enum - Current arming edge slope setting.

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

NameTypeValuesDescription
sourcechannel_list-Input source for the arming edge, either an analog channel or a digital channel.
channel_list - Current arming edge source.

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.
real (s) - Returns the current delay time setting.

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 format.
integer - Current Nth trigger edge setting in NR1 format.

Specifies the trigger edge slope for the Edge Then Edge trigger. Use NEGative for a falling edge or POSitive for a rising edge.

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

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

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

Sets the Nth edge at the burst edge counter resource, which is used in the trigger stage to determine which edge in a burst generates a trigger.

NameTypeValuesDescription
countinteger-Nth edge setting for the burst edge counter.

Sets the Nth edge in a burst idle resource in seconds. The timer is used to set the minimum time before the next burst.

NameTypeValuesDescription
time_valuereal10 ns - 10 sTime in seconds in NR3 format.
real (s) - Returns the current Nth edge in a burst idle setting.

Sets whether the rising edge or falling edge of the Nth edge in a burst generates a trigger. The query returns the current burst-edge slope setting.

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the burst-edge slope 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; if all channels are off, it returns "NONE".

NameTypeValuesDescription
sourceenumCHANnel<n> | DIGital<d>Input source for the Nth edge burst trigger.

Sets the input coupling for the selected trigger sources. The coupling can be AC, DC, or LFReject; the corresponding 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, only that source's level is affected and the active source is not changed.

NameTypeValuesDescription
levelrealVTrigger level voltage, specified in NR3 format; the manual states 0.75 times full-scale from center screen for internal triggers, ±(external range setting) for external triggers, and ±8 V for digital channels on MSO models.
sourceoptenumCHANnel<n> | EXTernal | DIGital<d>Optional trigger source to which the level applies.
real - Returns the trigger level of the current trigger source.

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

NameTypeValuesDescription
rejectenumOFF | LFReject | HFRejectSelects the reject filter state.

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

NameTypeValuesDescription
slopeenumNEGative | POSitive | EITHer | ALTernateSelects the trigger edge slope.
enum - Returns the current trigger slope as an abbreviated keyword.
myScope.WriteString ":TRIGGER:EDGE:SLOPE POSITIVE"

Selects the input source that produces the trigger. For the query, returns the current source; if all channels are off, it returns "NONE".

NameTypeValuesDescription
sourceenumCHANnel<n> | EXTernal | LINE | WGEN | WGEN1 | WGEN2 | WMODSelects the trigger input source for DSO models.
: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_timerealsMinimum pulse width duration in NR3 floating-point format.
real (s) - Minimum pulse width duration time for :TRIGger:GLITch:SOURce.

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

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

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

NameTypeValuesDescription
levelreal.75 x full-scale voltage from center screenTrigger level voltage.
sourceoptenumCHANnel<n> | EXTernal | DIGital<d>Trigger source channel or external input, depending on model.
real - Returns the trigger level of the current pulse width trigger mode; returns "NONE" if all channels are off.

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

NameTypeValuesDescription
polarityenumPOSitive | NEGativePolarity to use for the glitch pulse width trigger.
enum - Glitch pulse width trigger polarity.

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

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

Sets the pulse width duration range for the selected :TRIGger:GLITch:SOURce. The two time values may be entered in any order; the smaller value becomes <greater_than_time> and the larger 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, or "NONE" if all channels are off.

NameTypeValuesDescription
sourceenumDIGital<d> | CHANnel<n>Channel that produces 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, F, E, or X to define the edge selection.

NameTypeValuesDescription
stringstring-Edge-selection string in which each character corresponds to a channel.
:TRIGger:PATTernset / query

Specifies the channel values to be used in the pattern trigger. The optional edge source and edge parameters may be sent together with the pattern string when using HEX format, and take precedence if used.

NameTypeValuesDescription
patternstring-Pattern string defining channel values; format depends on :TRIGger:PATTern:FORMat (ASCII or HEX).
edge_sourceoptenumCHANnel<n> | DIGital<d> | NONEOptional source channel for the specified edge.
edgeoptenumPOSitive | NEGativeOptional edge polarity to use with the edge source.
string - Returns the pattern string, edge source, and edge.

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

NameTypeValuesDescription
baseenumASCii | HEXNumber base used for pattern trigger pattern entry and query.

Sets the minimum duration for the defined pattern when :TRIGger:PATTern:QUALifier is GREaterthan, and sets the timeout value when :TRIGger:PATTern:QUALifier is TIMeout.

NameTypeValuesDescription
greater_than_timerealsMinimum trigger duration in seconds, entered in NR3 format with an optional time suffix.
real (s) - Returns the minimum duration time for the defined pattern.

Sets the maximum duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to LESSthan. The query returns the duration time for the defined pattern.

NameTypeValuesDescription
less_than_timerealsMaximum trigger duration in NR3 format.
real (s) - Duration time for the defined pattern.

Qualifies when the trigger occurs for a pattern trigger. Use the query form to return the current trigger duration qualifier.

NameTypeValuesDescription
qualifierenumENTered | GREaterthan | LESSthan | INRange | OUTRange | TIMeoutSelects the trigger duration qualifier.
enum - Returns the trigger duration qualifier.

Sets the duration for the defined pattern when :TRIGger:PATTern:QUALifier is set to INRange or OUTRange. The two time parameters may be entered 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 time bound for the defined pattern duration.
greater_than_timereal10 ns - 9.99 secondsLower time bound for the defined pattern duration.

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

NameTypeValuesDescription
polarityenumPOSitive | NEGative | EITHerRunt trigger polarity to use.
enum - Current runt trigger polarity.

Selects the qualifier used for specifying runt pulse widths. For the query, returns the current runt trigger qualifier setting.

NameTypeValuesDescription
qualifierenumGREaterthan | LESSthan | NONESelects how runt pulse width is compared against :TRIGger:RUNT:TIME.
enum - The current runt trigger qualifier setting.

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 - Current runt trigger source.

Sets the runt pulse qualifier time used with :TRIGger:RUNT:QUALifier when triggering on runt pulses whose width is greater than or less than a certain value. The query returns the current runt pulse qualifier time setting.

NameTypeValuesDescription
timerealsTime value in floating-point NR3 format.
suffixoptenums | ms | us | ns | psOptional unit suffix for the time value.
real - Current runt pulse qualifier time setting.

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

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the edge 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.
enum - Returns the currently set clock signal source.

Selects the input channel probing the data signal.

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

Sets the trigger 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 - The currently specified hold time in NR3 floating-point format.

Sets the trigger hold time setup value. The query returns the currently specified setup time.

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

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

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

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

NameTypeValuesDescription
slopeenumNEGative | POSitiveSelects the trigger slope polarity.
enum - Current rise/fall time trigger slope setting.

Selects the channel used to produce the trigger.

NameTypeValuesDescription
sourcechannel_list-Channel used to produce the trigger.

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

NameTypeValuesDescription
timerealsTime value for the rise/fall time trigger.
suffixoptenums | ms | us | ns | psOptional unit suffix for the time value.
real - Returns the current rise/fall time trigger time value.
:TRIGger:TV:LINEset / query

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

NameTypeValuesDescription
line_numberinteger1 - 1024TV trigger line number in NR1 integer format.
:TRIGger:TV:LINE <line_number>
:TRIGger:TV:LINE?
:TRIGger:TV:MODEset / query

Selects the TV trigger mode and field. The LALTernate mode is not available when :TRIGger:TV:STANdard is GENeric.

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

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

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

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

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

Selects the TV trigger video standard. Supported standards include NTSC, PAL, PAL-M, SECAM, and, with the extended Video triggering license, additional EDTV/HDTV standards.

NameTypeValuesDescription
standardenumGENeric | NTSC | PALM | PAL | SECam | P480L60HZ | P480 | P720L60HZ | P720 | P1080L24HZ | P1080 | P1080L25HZ | P1080L50HZ | P1080L60HZ | I1080L50HZ | I1080Video standard to use for TV triggering.

Specifies the Generic video trigger's Nth edge to trigger on after synchronizing with the vertical sync.

NameTypeValuesDescription
countinteger-Edge number in NR1 format.
integer - Returns the edge count setting.

Enables or disables the horizontal sync control in the Generic video trigger. For interleaved or progressive video with tri-level sync, enabling HSYNc can help the ENUMber function count only lines instead of double-counting.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONEnables or disables the horizontal sync control.
enum - Returns the horizontal sync control setting.

Sets the minimum time the horizontal sync pulse must be present to be considered valid when Generic video trigger horizontal sync control is enabled. The query returns the horizontal sync time setting.

NameTypeValuesDescription
timerealsSeconds in NR3 format.
real (s) - The horizontal sync time setting, returned in seconds in NR3 format.

Specifies the "greater than the sync pulse width" time in the Generic video trigger, allowing oscilloscope synchronization to the vertical sync. The query returns the current setting.

NameTypeValuesDescription
min_timerealsSeconds value in NR3 format for the minimum time threshold.
real (s) - Returns the "greater than the sync pulse width" time setting in seconds in NR3 format.

Sets the analog source channel shared by all zones. The query returns the analog source channel specified for zone qualified triggers.

NameTypeValuesDescription
sourcechannel_list-Analog source channel to use for all zones.
channel_list - The analog source channel specified for zone qualified triggers.

Enables or disables the zone qualified trigger feature. When the feature is on, the zone(s) are actively used to qualify the trigger.

NameTypeValuesDescription
on_offenum0 | OFF | 1 | ONTurns zone qualified trigger on or off.
enum - Returns whether the zone qualified trigger feature is enabled or disabled.

Sets the zone qualifying condition for Zone 1 or Zone 2 as either "Must Intersect" or "Must Not Intersect".

NameTypeValuesDescription
modeenumINTersect | NOTintersectSelects the zone qualifying condition.

Sets the size and location of Zone 1 or Zone 2. The query returns the current size and location of the selected zone.

NameTypeValuesDescription
widthrealsWidth of the zone in seconds.
heightrealVHeight of the zone in volts.
x_centerrealsCenter of the zone in seconds.
y_centerrealVCenter of the zone in volts.

Queries the validity of Zone 1 or Zone 2. Zone 2 can return INValid if the zones overlap with opposing qualifying conditions, or OSCReen if the zone is off-screen.

NameTypeValuesDescription
ninteger1 - 2Zone number in NR1 format.
enum - Validity of the specified zone.

Sets the state for Zone 1 or Zone 2. When a zone's state is on and Zone Trigger is on, that zone is actively used to qualify the trigger.

NameTypeValuesDescription
on_offenum0 | OFF | 1 | ONTurns the specified zone on or off.

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

NameTypeValuesDescription
channel groupenumPOD1 | POD2Selects the pod whose threshold is being set.
threshold typeenumCMOS | ECL | TTL | USERdefSelects a predefined threshold or a user-defined threshold.
valueoptrealVoltVoltage for USERdef.

Sets the TV trigger mode and field. This obsolete command is provided for compatibility; use :TRIGger:TV:MODE instead.

NameTypeValuesDescription
modeenumFIEld1 | FIEld2 | AFIelds | ALINes | LINE | VERTical | LFIeld1 | LFIeld2 | LALTernate | LVERticalSelects the TV trigger mode and field.
enum - Returns the current TV trigger mode.

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

NameTypeValuesDescription
valueenumLSBFirst | MSBFirstSelects whether the least significant or most significant byte is transmitted first.
enum - Returns the current output sequence.
:WAVeform:BYTeorder <value>
:WAVeform:BYTeorder?
:WAVeform:COUNtset / query

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

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

Returns the binary block of sampled data points as IEEE 488.2 arbitrary block data. The data format follows the current :WAVeform:UNSigned, :WAVeform:BYTeorder, :WAVeform:FORMat, and :WAVeform:SOURce settings, and the number of points is controlled by :WAVeform:POINts.

block - Binary block of sampled waveform data points in IEEE 488.2 arbitrary block data format.
myScope.WriteString ":WAV:DATA?"
:WAVeform:FORMatset / query

Sets the data transmission mode for waveform data points. The format determines how waveform data are transferred; ASCii is required for serial decode bus sources, and ASCii or WORD are allowed for digital channel bus sources.

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

Sets the desired number of waveform points to be transferred with :WAVeform:DATA?. The command accepts either an integer point count or the deprecated points mode keywords NORMal, MAXimum, or RAW.

NameTypeValuesDescription
wfm_pointsnumeric100 - 10000000Requested number of waveform points, or a deprecated points mode keyword.
modeenumNORMal | MAXimum | RAWDeprecated waveform points mode option.
:WAVeform:POINTS 1000

Sets the waveform points mode used for data transferred by :WAVeform:DATA?. The mode selects the measurement record, raw acquisition record, or the record with the maximum number of points.

NameTypeValuesDescription
points_modeenumNORMal | MAXimum | RAWSelects which record is used for waveform data transfer.
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's data.

block - Returns a preamble block containing format, type, points, count, X increment, X origin, X reference, Y increment, Y origin, and Y reference.
:WAVeform:PREamble?

Enables or disables the waveform data for all segments setting. When ON, :WAVeform:DATA? returns data for all segments; when OFF, it returns data for the current segment.

NameTypeValuesDescription
stateenum0 | OFF | 1 | ONSelects whether waveform data for all segments is enabled or disabled.

Returns the number of memory segments in the acquired data. The query can be used while segments are being acquired.

integer - The number of memory segments in the acquired data, as set by :ACQuire:SEGMented:COUNt.

Returns the time tag of the currently selected segmented memory index. The index is selected using :ACQuire:SEGMented:INDex.

real - Time tag of the currently selected segmented memory index, returned in NR3 format.

Returns X (time) information for all waveform segments at once. The <xlist_type> option selects relative X-origin, absolute X-origin, or time tag information.

NameTypeValuesDescription
xlist_typeenumRELXorigin | ABSXorigin | TTAGSelects which X-information is returned for each segment.
block - Binary block data in IEEE 488.2 # format containing comma-separated X-info for all segments.
:WAVeform:SOURceset / query

Selects the analog channel, function, digital pod, digital bus, reference waveform, or serial decode bus used as the source for the :WAVeform commands. On MSO models, POD or BUS sources are available; when SBUS1 or SBUS2 is selected, only ASCII waveform format is allowed.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m> | WMEMory<r> | SBUS{1 | 2}Selects the waveform source.
:WAVEFORM:SOURCE CHAN1

Selects which serial-decode subsource is used for the current waveform source. For SBUS serial decode, it chooses among the available data sets; for non-SBUS sources, only SUB0 is valid.

NameTypeValuesDescription
subsourceenumSUB0 | RX | MOSI | FAST | SUB1 | TX | MISO | SLOWChooses the waveform subsource to use.
:WAVeform:TYPEset / query

Returns the acquisition mode associated with the currently selected waveform. The acquisition mode is set by the :ACQuire:TYPE command.

enum - The acquisition mode of the currently selected waveform.

Turns unsigned mode on or off for the currently selected waveform. It controls whether waveform data values are sent as unsigned or signed integers; it has no effect if the data format is ASCII.

NameTypeValuesDescription
unsignedenum0 | OFF | 1 | ONSelects unsigned mode on or off.
:WAVeform:VIEWset / query

Sets the view setting associated with the currently selected waveform. MAIN shows the data in the oscilloscope's main waveform display area; ALL shows all captured data and is available only when Digitizer mode is on.

NameTypeValuesDescription
viewenumMAIN | ALLView setting for the selected waveform.
enum - Returns the view setting associated with the currently selected waveform.

Returns the x-increment value for the currently specified source. This 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. XOrigin is the X-axis value of the data point specified by the :WAVeform:XREFerence value; in this product, it is always 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. The x-reference point is the first displayed point and is always 0 in this product.

integer - x-reference value = 0 in 32-bit NR1 format

Returns the y-increment value in volts for the currently specified source. The y-increment is the voltage difference between consecutive data values; for digital waveforms it is always "1".

real (V) - Y-increment value in the current preamble, expressed in 32-bit floating point NR3 format.

Returns the y-origin value for the currently specified source. This is the Y-axis value of the data value specified by :WAVeform:YREFerence; for this product, it is the Y-axis value of the center of the screen.

real - y-origin in the current preamble in 32-bit floating point NR3 format

Returns the y-reference value for the currently specified source. This value specifies the data point value where the y-origin occurs; it is undefined if the format is ASCii.

real - y-reference value in the current preamble in 32-bit NR1 format

Selects the byte order for binary transfers. The query returns the current byte order selection.

NameTypeValuesDescription
orderenumMSBFirst | LSBFirstByte order used for binary transfers.
enum - Current byte order selection.

Downloads an arbitrary waveform in floating-point values format. The command accepts either IEEE 488.2 binary block data or comma-separated floating-point values between -1.0 and +1.0.

NameTypeValuesDescription
binaryblock-IEEE 488.2 binary block of floating-point values between -1.0 and +1.0.
valuereal-1.0 - +1.0Comma-separated floating-point value between -1.0 and +1.0.
:WGEN1:ARBitrary:DATA 0.0, 0.5, 1.0, 0.5, 0.0, -0.5, -1.0, -0.5

Clears the arbitrary waveform memory and loads it with the default waveform.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output number in NR1 format.

Downloads an arbitrary waveform using 16-bit integer DAC values.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output selector in NR1 format.
binaryinteger-512 - +511Decimal 16-bit integer values in IEEE 488.2 binary block format.
valueinteger-512 - +511Decimal integer values in comma-separated NR1 format.

Enables or disables interpolation control for the arbitrary waveform on the selected WaveGen output. When ON, lines are drawn linearly between arbitrary waveform points; when OFF, line segments remain horizontal until the next point.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output index in NR1 format.
stateenum0 | OFF | 1 | ONTurns interpolation off or on.
enum - Returns the current interpolation setting.

Stores the selected source waveform into the arbitrary waveform memory.

NameTypeValuesDescription
sourceenumCHANnel<n> | WMEMory<r> | FUNCtion<m> | MATH<m>Source waveform to store.

Sets the waveform generator frequency for all waveforms except Noise and DC. You can also specify the frequency indirectly using :WGEN<w>:PERiod.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output number in NR1 format.
frequencyrealHzWaveform frequency in NR3 format.

Selects the waveform type for the specified WaveGen output. The query returns the currently selected signal type.

NameTypeValuesDescription
signalenumSINusoid | SQUare | RAMP | PULSe | DC | NOISe | SINC | EXPRise | EXPFall | CARDiac | GAUSsian | ARBitraryWaveform type to select.
enum - Currently selected signal type.

Sets the pulse width for Pulse waveforms. The pulse width can be adjusted from 20 ns to the period minus 20 ns.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output index in NR1 format.
widthreal20 ns - period minus 20 nsPulse width in seconds in NR3 format.

Sets the symmetry of the ramp waveform for the selected WaveGen output. Symmetry is the amount of time per cycle that the ramp waveform is rising.

NameTypeValuesDescription
percentreal0% - 100%Symmetry percentage for the ramp waveform.

Sets the square wave duty cycle for a WaveGen output. Duty cycle is specified as the percentage of the period that the waveform is high.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output number in NR1 format.
percentreal20 - 80Duty cycle percentage in NR1 format.
real (%) - Returns the currently set square wave duty cycle.

Sets the amount of amplitude modulation for the waveform generator. The depth is specified as a percentage of the amplitude range used by the modulation.

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

Specifies the frequency of the modulating signal.

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

Sets the frequency deviation for FM modulation of the selected waveform generator. The deviation is specified in Hz and cannot exceed the original carrier frequency; the carrier frequency plus deviation must also stay within the waveform generator's maximum frequency plus 100 kHz.

NameTypeValuesDescription
frequencyrealHzFrequency deviation from the original carrier signal frequency.

Specifies the frequency of the modulating signal.

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

Specifies the hop frequency for frequency-shift keying modulation. The output frequency shifts between the original carrier frequency and this hop frequency.

NameTypeValuesDescription
frequencyrealHzHop frequency.
real (Hz) - Returns the hop frequency setting.

Specifies the FSK modulation rate, which controls the rate at which the output frequency shifts. The rate is a digital square-wave modulating signal.

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

Specifies the shape of the modulating signal used for AM and FM modulation. For the RAMP shape, the ramp symmetry can be set with :WGEN<w>:MODulation:FUNCtion:RAMP:SYMMetry.

NameTypeValuesDescription
shapeenumSINusoid | SQUare | RAMPShape of the modulating signal.
enum - Returns the specified modulating signal shape.

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

NameTypeValuesDescription
percentreal0% - 100%Symmetry percentage.
real (%) - Returns the ramp symmetry percentage setting.

Adds noise to the currently selected waveform generator signal. The allowable percent range depends on the current amplitude because the total signal amplitude is limited by the regular amplitude limit.

NameTypeValuesDescription
percentreal0 - 100Percent of added noise.

Enables or disables modulated waveform generator output. Modulation can be enabled for all waveform generator function types except pulse, DC, and noise.

NameTypeValuesDescription
settingenumOFF | 0 | ON | 1Enables or disables modulated waveform generator output.
enum - Returns whether the modulated waveform generator output is enabled or disabled.

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

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

Sets whether the waveform generator signal output is ON or OFF.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output number in NR1 format.
on_offenum1 | ON | 0 | OFFTurns the waveform generator signal output on or off.

Selects the expected output load impedance for the specified waveform generator output. The query returns the current expected output load impedance.

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

Specifies whether the defined waveform is output continuously or as a single cycle. The query returns the current output mode setting.

NameTypeValuesDescription
modeenumNORMal | SINGleSelects continuous output or single-shot output.
enum - Current output mode setting.

Specifies whether the waveform generator output is inverted. The query returns the specified output polarity.

NameTypeValuesDescription
polarityenumNORMal | INVertedSets the output polarity.
enum - Returns the specified output polarity.

Causes a single cycle of the defined waveform to be output when single-shot output mode is selected. Sending the command multiple times interrupts a slow signal output before the cycle is completed.

:WGEN<w>:PERiodset / query

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

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output index in NR1 format.
periodrealsWaveform period in seconds, formatted as NR3.
:WGEN<w>:RSTset / query

Restores the waveform generator factory default settings: 1 kHz sine wave, 500 mVpp, 0 V offset.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output index in NR1 format.
:WGEN<w>:TRACkset / query

Enables or disables tracking of frequency, amplitude, offset, and duty-cycle adjustments for the specified waveform generator output. When tracking is enabled, the other generator's waveform selection must be in the same group, and tracked settings become unavailable for manual adjustment.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output number in NR1 format.
on_offenum1 | ON | 0 | OFFTurns tracking on or off.

Sets whether amplitude tracking is enabled for the specified waveform generator output. When tracking is enabled, amplitude and offset adjustments on this output are tracked by the other waveform generator output, and tracked settings on the other generator become unavailable.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output index in NR1 format.
on_offenum1 | ON | 0 | OFFEnables or disables amplitude tracking.

Sets the other waveform generator output to be identical to this waveform generator output, except that either output shape may be inverted. If the selected signal is ARB, the ARB waveform is copied as well.

Turns frequency tracking for the selected waveform generator output on or off. When enabled, frequency adjustments on this output are tracked by the other waveform generator output.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveform generator output number in NR1 format.
on_offenum1 | ON | 0 | OFFEnables or disables frequency tracking.

Sets the phase relationship of a frequency-tracked waveform generator output. The query returns the frequency-tracked waveform phase relationship setting.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output index in NR1 format.
phasereal-360 - +360Phase relationship value in NR1 format.
real - Returns the frequency-tracked waveform phase relationship setting.
:WGEN<w>:VOLTageset / query

Sets the waveform amplitude for a WaveGen output. For all waveforms except DC, this command specifies the waveform's amplitude; use :WGEN<w>:VOLTage:OFFSet for the offset voltage or DC level.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output number in NR1 format.
amplituderealVWaveform amplitude in volts, in NR3 format.

Sets the waveform high-level voltage for WaveGen output <w> for all waveforms except DC. The corresponding query returns the currently specified high-level voltage.

NameTypeValuesDescription
winteger1 - (# WaveGen outputs)WaveGen output number in NR1 format.
highrealVHigh-level voltage in volts, in NR3 format.
real (V) - Currently specified waveform high-level voltage.

Specifies the waveform's low-level voltage for all waveforms except DC. Use :WGEN<w>:VOLTage:HIGH to specify the high-level voltage, or :WGEN<w>:VOLTage and :WGEN<w>:VOLTage:OFFSet to set levels indirectly.

NameTypeValuesDescription
winteger1 - # WaveGen outputsWaveGen output number in NR1 format.
lowrealVLow-level voltage in volts, in NR3 format.

Specifies the waveform's offset voltage or DC level. The query returns the currently specified waveform offset voltage.

NameTypeValuesDescription
offsetrealVOffset voltage to set.
real (V) - The currently specified waveform offset voltage.

Clears the specified reference waveform location.

NameTypeValuesDescription
rinteger1 - # ref waveformsReference waveform location to clear.

Turns the display of the specified reference waveform on or off. Only one reference waveform can be displayed at a time; enabling one automatically turns the other off.

NameTypeValuesDescription
rinteger1 - # ref waveformsReference waveform location to control.
on_offenum1 | ON | 0 | OFFDisplay state to set for the reference waveform.

Sets the label for a reference waveform. The label is also added to the non-volatile label list, replacing the oldest label if necessary.

NameTypeValuesDescription
rinteger1 - (# ref waveforms)Reference waveform number, in NR1 format.
stringstring-Quoted ASCII label string, 10 characters or less.
string - Returns the label associated with the specified reference waveform.
:WMEMory<r>:SAVEset / query

Copies the analog channel or math function waveform to the specified reference waveform location. Math functions whose x-axis is not frequency can be saved as reference waveforms.

NameTypeValuesDescription
sourceenumCHANnel<n> | FUNCtion<m> | MATH<m>Waveform source to copy into the reference waveform location.
: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 - # ref waveformsReference waveform number, from 1 to the number of reference waveforms.
skewrealsSkew time in seconds in NR3 format.
real (s) - Current skew setting for the selected reference waveform.

Sets the value represented at center screen for the selected reference waveform. If the requested offset is outside the legal range, the instrument automatically adjusts it to the nearest legal value.

NameTypeValuesDescription
rinteger1 - # ref waveformsReference waveform index in NR1 format.
offsetreal-Vertical offset value in NR3 format.
suffixoptenumV | mVUnits for the offset value.
real - Returns the current offset value for the selected reference waveform.

Defines the full-scale vertical axis of the selected reference waveform. Legal values are copied from the original source waveform.

NameTypeValuesDescription
rinteger1 - # ref waveformsReference waveform number, from 1 to the number of stored reference waveforms.
rangereal-Vertical full-scale range value in NR3 format.

Sets the vertical scale, in units per division, of the selected reference waveform. Legal values are copied from the original source waveform that was saved as the reference waveform.

NameTypeValuesDescription
rinteger1 - # ref waveformsSelects the reference waveform number.
scalereal-Vertical units per division for the selected reference waveform.
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 compatibility command; use :ACTivity instead.

:CHANnel:LABelset / query

Sets the label text for an analog or digital channel source. This obsolete compatibility command also adds the name to the label list when a channel is set.

NameTypeValuesDescription
source_textenumCHANnel1 | CHANnel2 | DIGital<d>Channel source to label.
stringstring-Quoted ASCII label string.
string - Returns the label associated with a particular analog channel.

Sets the threshold for a group of channels to a predefined value or a user-defined voltage. The command is obsolete and provided for compatibility; use :POD<n>:THReshold or :DIGital<n>:THReshold instead.

NameTypeValuesDescription
channel groupenumPOD1 | POD2Channel group to apply the threshold setting to.
threshold typeenumCMOS | ECL | TTL | USERdefThreshold preset or user-defined threshold selection.
valueoptreal-6.0 - 6.0User-defined threshold voltage in NR3 format; ignored for predefined threshold types.

:CHANnel2:SKEWset / query

Sets the skew between channels 1 and 2. This is an obsolete compatibility command; use :CHANnel<n>:PROBe:SKEW instead.

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

:ERASeset / query

Erases the screen. This is an obsolete command provided for compatibility with previous oscilloscopes; use :DISplay:CLEar instead.

Sets the math operation for the g(t) source used as input to transform or filter functions, if available. Source1 and source2 are selected with :FUNCtion:GOFT:SOURce1 and :FUNCtion:GOFT:SOURce2.

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

Selects the first input channel for the g(t) source used as the input to transform or filter functions. The query returns the current selection.

NameTypeValuesDescription
valuestring-Channel selection in the form CHANnel<n>.
string - Current selection for the first input channel for the g(t) source, returned as CHAN<n>.

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

NameTypeValuesDescription
valuechannel_list-Second input channel selection.
channel_list - Returns the current selection for the second input channel for the g(t) source.
:FUNCtion:SOURceset / query

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

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

Turns the selected function on or off. This command is provided for backward compatibility; use :FUNCtion:DISPlay instead.

NameTypeValuesDescription
viewenum1 | ON | 0 | OFFSelects whether the function is turned on or off.